Adding Hint Texts
For your users to know how to handle certain fields, e.g. in the edit mode, you can add hint texts (i.e. context-specific help) in certain places. After you have added the hint texts, you can localize them in other languages.
- To do so, proceed as follows:
- Open the Localization page in the administrator area of crossTerm Now.
- From the drop-down list, select the language of the JSON file that you would like to use as source language for the localization.
- Select the checkboxes crossTerm data categories, system attributes, and their values and Hint texts for data categories.
- Click Export and save the JSON file to your hard disk.Tip
If a new page or tab is opened in your browser instead of the save dialog, open the respective menu of your browser and select the entry Save Page As in order to open the save dialog manually. Normally, the file name and format are predefined.
- Open the JSON file with a text editor, e.g. with Notepad++.
- Search for the string IDDS_DATACATEGORY_HINT_TEXT. This string occurs 37 times in the file, numbered consecutively. Check the occurrences and enter a suitable hint text between the quotation marks.Tip
You do not need to fill all occurrences. Fill the occurrences of which you know that your users will need help in these places.
If you want to localize the file: Occurrences that are not filled will not be checked in to Across, i.e. they will be ignored in the translation process.
- Save the file.
- Translate the JSON file as usual via a project in Across and then check out the target files.
- Open the Localization page in the administrator area of crossTerm Now.
- From the drop-down list, select the language of the JSON file that you would like to import and click Import.
- Import each checked out, localized JSON file individually (per language).
- The hint texts are now integrated in the user interface. Click the
icon in order to display them in the form of tooltips.
Use of HTML Tags
With the help of HTML tags, you can use images, links, or formatting in the hint texts. For example, the following tags are supported: <p>, <br>, <img>, <a>.
Example Image: Icons to Display the Usage
- Store the icon images in the installation folder of crossTerm Now in the Images subfolder (by default: C:\Program Files (x86)\Across\crossTermNow\Content\Images).
- Insert the image paths in the JSON file as shown in the following code snippet (here for the Usage field).
"IDDS_DATACATEGORY_21": "Usage", "IDDS_DATACATEGORY_HINT_TEXT_21": "Select the appropriate usage type:<br><img src=\"Content/Images/recommended.png\"> recommended - Use of this term is recommended.<br><img src=\"Content/Images/dnu.png\"> do not use - This term should not be used.",
- Save the file and import it to crossTerm Now.
- The images will be displayed as follows:
Example Link
- Insert the URL in the JSON file as shown in the following code snippet (here for the Usage field).
"IDDS_DATACATEGORY_HINT_TEXT_21": "Select the appropriate usage type:<br><img src=\"Content/Images/recommended.png\"> recommended - Use of this term is recommended.<br><img src=\"Content/Images/dnu.png\"> do not use - This term should not be used.<br><a href=\"https://www.across.net/en/online-help/als/terminology-management\" target=\"__blank\">Click here for more information.</a>",
- Save the file and import it to crossTerm Now.
- The link will be displayed as follows: