Aligning guide and application languages

Use this option if you want to the guide languages to match the application language. By enabling this, the language will be the same as the application regardless of the user’s browser language or their system settings.

1. Sign in to the Adopt Management Console with your credentials

2. Click on the name of the application you want to work on

3. Click Settings from the menu pane on the left

4. Click Language from the available Settings options

5. In the Read language from dropdown, select space settings

6. Click Apply to save and use the new settings

7. There are six localization options listed under the Localization is identified by the drop-down menu. You can define where Adopt should find your application language settings by selecting one of these options: Cookies, Local Storage, JavaScript Variable, CSS Selector, URL Query, URL Regex.

8. Paste the value into the corresponding area of the Adopt Console

9. Click Apply to apply the settings

From the six options listed above, there is just one you need to choose based on your application’s characteristics, then provide a path. Adopt will then read and learn your application’s language from that source and display the guides accordingly.

Cookies

If your application’s language is locally stored in its cookies, find its path, and copy the name of the cookie and paste it to the Adopt Console.

1. Select Cookie from the Localization is identified by dropdown

2. To find the cookie, press the F12 function key on the keyboard (or CTRL + Shift+ I key combination or right-click on the application window) and select Inspect

3. On the opened window, click the Application tab and expand the Cookies section

4. Click on the available cookie URLs and find the language cookie name from the table on the right

5. Copy the language cookie name

Local Storage

If your application’s language is stored in local storage, provide its name of the local storage property.

1. Select Local Storage from the Localization is identified by dropdown

2. To find the local storage key, press the F12 function key on the keyboard (or CTRL + Shift+ I key combination or right-click on the application window) and select Inspect

3. On the opened window, click the Application tab and expand the Local Storage section

4. Click on the available local storage URLs and find the language key from the table on the right

5. Copy the language key

6. Paste the value into the corresponding area of the Adopt Console

7. Click Apply to apply the settings

JavaScript Variable

Use this option if the application’s language parameter is stored as a JavaScript variable. For example:“window.Xrm._applicationContext.DataSource._userContext._userSettings._formatInfoCultureName” for Microsoft Dynamics 365 Customer service.

If you are not sure where to find it, you can contact your application manager.

1. Paste the value into the corresponding area of the Adopt Console

2. Click Apply to apply the settings

CSS Selector

In some cases, the language is displayed on the user interface of the application as an option that can be selected, either via choosing a country or language initials. In that case, you can define a CSS selector that selects that particular element and reads language from there. If your website or application has the same CSS language selector, you can find the language information in this way .

1. Paste the value into the corresponding area of the Adopt Console

2. Click Apply to apply the settings

URL Query

A query string specifies values for parameters in a Uniform Resource Locator (URL). If your application’s language is stored in an URL query, provide the name of the URL query parameter, which holds the language value.

1. Enter the value into the corresponding area of the Adopt Console

2. Click Apply to apply the settings

Note: Please note that the language value should be provided as a lower case with two digits country code. For example, sk - for Slovak language or en- for the English language. All other formats used would lead to Adopt not being able to read the language properly. Some invalid examples to avoid: en-US, English, ENG.

URL Regex

You can as well guide Adopt to read it from your application’s URL. by using regular expressions (regex). Read more here.

For example, <<app_domain>>/(.*) will match "en" language from <<app_domain>>/en URL"

That means, https://www.example.com/(.*) will determine language as a series of characters coming after https://www.example.com/

1. Enter the value into the corresponding area of the Adopt Console

2. Click Apply to apply the settings