[en] The term help page gives you basic information about a term. You'll find a term help page for each term in the Terminology section of the Acrolinx Dashboard.
[en] To open the term help page, do of the following actions:
-
[en] Select a term from the autocomplete dropdown.
-
[en] Click a term in the search results.
[en] You'll then find the term help page for the term or terms under Terms.
[en] It's possible to fully customize the layout and information in the term help page to meet the requirements of your organization. For example, you can adjust the term help template to add fields, images, and company branding.
[en] The Acrolinx Term Browser displays different search tools with the term help page depending on whether you are in the standard view or the translation view.
Tipp
[en] If you're on an Acrolinx Cloud instance and are interested in these configurations, contact us and we'll set them for you!
[en] A term help template defines the appearance of the term help file. The term help file displays key information about a term when users click a help link in the Acrolinx Integration shortcut menu or open a term in the Term Browser. You can preview the appearance of the Term Help page in the Term Browser.
[en] The Terminology Manager comes installed with a default term help template, which uses Acrolinx branding and displays some sample information. If you want to change your existing templates or create new templates, create overlay files for the templates in your configuration directory.
[en] To create your template overlay files in the follow these steps:
[en] We recommend saving a copy of the default template to the location <config directory>/data/common
.
[en] Open your command line and enter the following command:
kubectl cp -n acrolinx acrolinx-core-server-0:/opt/guidance/<path> /home/acrolinx/config/<path>
[en] For example, your command might look like this:
kubectl cp -n acrolinx acrolinx-core-server-0:/opt/guidance/data/common/term_help_template.vm <config directory>/data/common
[en] If you use the Term Browser, you can also configure separate term help templates for the standard and translation views. Because the Term Browser displays term help a frame, you might use separate templates to adapt the appearance of the term help file when it’s viewed in the Term Browser.
[en] You can create separate term help template files by making copies of the default term template with the following names:
standardview_term_help_template.vm translationview_term_help_template.vm
[en] If these files aren’t present, the default term help template is used for the standard and translation views.
[en] By default, all template files are stored in the directory:
[en] <config directory>/data/common
[en] If you want to change your existing templates or create new templates, create overlay files for the templates in your configuration directory. You create your template overlay files in the following location:
[en] <config directory>/data/common
[en] The term help templates are based on a Java-based template engine called Velocity. You can find more information about Velocity templates on the Apache Website.
[en] If you create multiple templates and are comfortable with the Velocity template language, you can use velocity directives #include
and #parse
to minimize the amount of code duplication in your template structure.
[en] When customizing term help templates it’s good practice to ensure that any paths to images or style sheets are relative and can adapt to changes in your server environment. For example, the paths to some files might break if you configure your server to redirect requests to another base URL.
[en] You can display the contents of term fields in your term help file by adding the following variables to the term help template:
[en] Field Name and Variable |
[en] Description |
---|---|
[en] Term Entry ID [en] |
[en] Displays the term entry ID. |
[en] Term Entry UUD [en] |
[en] Displays the Universally Unique Identifier for the term entry. |
[en] Term Entry [en] [en] |
[en] Displays information related to the whole term entry by referring to the attributes of the head term. Use in combination with other variables. [en] Example: Anmerkung[en] Always use the variable |
[en] Head Term [en] |
[en] Indicates if the term is a head term, by display a |
[en] Term Name [en] |
[en] Displays the term name. |
[en] Language [en] |
[en] Displays the language of the term. |
[en] Domains [en] |
[en] Displays the domains that the term belongs to. |
[en] Status [en] |
[en] Displays the term status. |
[en] Creation Date [en] |
[en] Displays the creation date of the term. |
[en] Creator Username [en] |
[en] Displays the name of the user who created the term. |
[en] Last Modification Date [en] |
[en] Displays the date that the term was last modified. |
[en] Last Modifier Username [en] |
[en] Displays the name of the user who last modified the term. |
[en] Term UUID [en] |
[en] Displays the Universally Unique Identifier for the term. |
[en] Term ID [en] |
[en] Displays the term ID. |
[en] Frequency [en] |
[en] Displays the frequency of the terms that were imported from an Acrolinx Term Discovery report. |
[en] Linked Terms #foreach($link in $links) $link.surface ($link.status) <br/> #end |
[en] Displays a list of linked terms with the term status in parentheses. |
[en] Custom Fields: Basic Display [en] |
[en] Displays the contents of any custom field, and can be used multiple times in the term help template. [en] Use the Field Manager to find the correct field name. [en] Example: |
[en] Custom Fields: Multiple-value <table> #foreach($value in $customFields.get('<FIELD_NAME>').getValue()) <tr><td>$value</td></tr> #end </table> |
[en] Displays all the values for a multiple-choice field in a table with a row for each value. Example: <table> #foreach($value in $customFields.get('products').getValue()) <tr><td>$value</td></tr> #end </table> |
[en] Test if a custom field has multiple values [en] |
[en] Returns [en] Use this variable in combination with an |
[en] Comment on this Term #if ($comments) <a href="/termcontribution.html#addComment/ termDatabaseId/$id" target="blank">Comment on this Term</a> #end |
[en] Displays a link to add a comment to the term. |
[en] Comments #foreach($comment in $comments) <span style= "font-weight: bold;">$comment.userName on $comment.date</span> <p/> $comment.text <p/> #end |
[en] Displays the comments created for a term. |
[en] You add variables to term help templates to change the content that is displayed to users in the term help file. For example, you might update the term help template so that users can see the source of the term when they review the help information.
[en] To add a variable to a term help template, follow these steps:
-
[en] Open your overlay of the following file:
term_help_template.vm
Warnung
[en] Don’t edit the installed version of the file. Instead, always edit your overlay copy in the configuration directory.
-
[en] Edit the relevant XHTML code and add your desired variable.
[en] For example, to update the default template with another table row that displays the term context, add the following line:
<tr><td class="left">Context:</td><td class="right">$customFields.context</td></tr>
[en] above the table closing tag:
</table>
-
[en] Save your changes.
[en] To see your changes, open the Term Help Page for a term.
[en] Expand the Help Panel, and click the Refresh button.
[en] Your new field is displayed in the help file.
[en] If you plan to make advanced customization to your term help templates, you might want to configure the server to load the templates from a location that is easier for other teams or systems to access.
[en] To change the location of the term help templates, follow these steps:
-
[en] Open your overlay of the following file:
termbrowser.properties
Warnung
[en] Don’t edit the installed version of the file. Instead, always edit your overlay copy in the configuration directory.
-
[en] Add the following property:
termhelp.template.root=<DIRECTORY_PATH>
[en] This property defines the root directory for all template files.
[en] The file path can be a relative path or absolute path.
[en] Example:
termhelp.template.root=P:/resources/shared
[en] Relative paths are relative to the directory:
<config directory>/data/
[en] The default value is
termhelp.template.root=./common
-
[en] Save your changes and restart the core server.
-
[en] Reload the term help in your web browser.
[en] The changes take effect immediately.
[en] As well as contributing terms, users can also contribute comments to existing terms. Before users can add comments, you must first update your term help template with an Add Comment link.
[en] To display an Add Comment link in your term help file:
-
[en] Add the following lines to your term help template:
#if ($comments) <a href="/termcontribution.html#addComment/termDatabaseId/$id" target="blank">Add Comment</a> #end
[en] To display a list of previous comments in your term help file:
-
[en] Add the following lines to your term help template:
#foreach ($comment in $comments) <span style="font-weight: bold;">$comment.userName on $comment.date</span> <p/>$comment.text <p/> #end