K2 Language Pack

The K2 Language Pack is an add-on component to K2 that enables cultural adaptation and translation of non-configurable User Interface elements in K2. The Language Pack allows for the standard smartforms controls as well as the K2 View Flow report and elements of the K2 Designer to display correctly in different languages.

In a distributed environment the K2 Language Pack needs to be installed on the K2 Application Server(s), the server(s) hosting the K2 Design Time site and the server(s) hosting the K2 Runtime site.

How it works

The Language Pack adds resource files for selected language(s) in the same location as the English resource files. The Form designer will have to set configurable properties such as titles, watermarks and data labels for the Controls, Views and Forms in the language of choice. At runtime, the language resource files are used to render non-configurable properties such as titles of windows, pop-up controls and static labels in the Picker control in the appropriate language.

K2 determines the language from two settings:

  1. The languages defined in the browser’s Language Preference setting. Ensure the language you want the Form to display in is the first language in the list. (See the note below for information about language fall-back behavior).
  2. The specific language set in IIS for the Runtime Sites. If a specific language is configured in the UI Culture field in IIS for the specific site, it will override the browser’s Language Preference setting and all users accessing the Form on the site will be forced to use the configured Language.

Using the browser’s developer tools you can view the accept-language header to determine the language fall-back behavior. This is important when configuring the browser’s languages as the K2 Server will use the fall-back to determine which language the Form should be displayed in if the first language is not supported. If the fall-back does not contain any of the supported languages the Form will be displayed in English.
ComponentBehavior
SmartForms ControlsAt runtime, all static text (such as tooltips, watermarks and popups) displayed on the standard, out-of-the-box Controls will render in the determined language.
K2 View FlowAll static text and menus in K2 View Flow are displayed in the determined language.
K2 DesignerSome design time text is localized and will display in the determined language.

Download

The K2 Language Pack (Preview) can be downloaded from the Nintex Customer Central. See the Installation details below for more information and the compatibility matrix for the list of available languages.

The K2 Language Pack (Preview) is available as a separate installation package. The installer uses the current K2 installation settings and is dependent on the existing K2 components. If K2 is installed on a distributed environment, the K2 Language Pack (Preview) should be installed in the same locations and servers where K2 Site is installed. The Setup Manager will guide you through the install process.

Prerequisites

  • PowerShell 3.0 or higher
  • K2 Five

Installation Steps

  1. Open the Language Pack Setup.exe.
  2. Select the language(s) you wish to install.
  3. Click Next to review your selection, then click Next again to begin configuring the components. (Clicking the “Next” button performs both an Install and Uninstall depending on the language selection).
  4. Click Finished to close the Setup Manager.
In a distributed environment the K2 Language Pack (Preview) needs to be installed on the K2 Application Server(s), the server(s) hosting the K2 smartforms design time site and the server(s) hosting the K2 smartforms Runtime site.
  • Runtime exception messages originating from the K2 Server will still be displayed in English.
  • Localization support for the Design time is limited and areas of the Design time experience will still display in English after the K2 Language Pack has been installed.
  • If a multi-language Form is required, the Form and the Form Views must be designed in one language then copied and modified for each of the other languages you wish to support. Direct the user to the Form in the user’s language choice. During installation of the K2 Language Pack, select all the required languages to ensure that the required resource files are installed for the languages you wish to support.
  1. An error is displayed at design time when the Tab Index property of a control is reduced to a value less than 1. The Tab Index property starts reducing automatically in a loop.
    Workaround:
    Set the browsers language to English to configure the Tab Index property. Once configured set the browser back to the original language.