Using #LD-Notation
#LD notation is used for displaying language-dependent information. #LD notation is mainly used in process tracking and processing notification, but it can also be used in scripts that are stored in the script library.
Syntax
Value=#LD[<language>|<language code>](<key>,{<Parameter>}*)#
where:
|
<language>|<language code> |
(Optional) Language or language variant for the output |
|
<Key> |
Basis string with place holder. The place holder syntax corresponds to a format place holder in VB.Net ({0} to {9}) |
|
<Parameter> |
Parameter for replacing the place holder (comma delimited) |
| Context | Table.column |
Remarks |
|---|---|---|
| Process tracking | Job.ProcessDisplay |
Mapped to DialogProcessStep.DisplayName |
| JobChain.ProcessDisplay |
Mapped to DialogProcessChain.DisplayName | |
| JobEventgen.ProcessDisplay |
Mapped to DialogProcess.DisplayName | |
| Process handling notification | Job.NotifyAddress |
|
|
Job.NotifyAddressSuccess |
| |
| Job.NotifyBody |
| |
|
Job.NotifyBodySuccess |
| |
| Job.NotifySender |
| |
|
Job.NotifySenderSuccess |
| |
| Job.NotifySubject |
| |
|
Job.NotifySubjectSuccess |
| |
| JobRunParameter.ValueTemplate |
On in the MailComponent process component | |
| Templates
|
DialogColumn.Template |
|
|
DialogColumn.CustomTemplate |
| |
| Formats
|
DialogColumn.FormatScript |
|
|
DialogColumn.CustomFormatScript |
| |
| Task definitions | DialogMethod.MethodScript |
|
| Insert values
|
DialogObject.InsertValues |
|
|
DialogTable.InsertValues |
| |
|
DialogTree.ListInsertValues |
| |
|
DialogSheet.InsertValues |
| |
| Selection scripts
|
DialogTable.SelectScript |
|
|
DialogObject.SelectScript |
| |
| Process generating scripts | Job.GenCondition |
|
|
Job.PreCode |
| |
| Job.ServerDetectScript |
| |
|
JobChain.GenCondition |
||
| JobChain.PreCode |
|
Related Topics
Using #LD notation in process tracking
For language-dependent representation of process information, a relevant template must be defined to display the captions in the active languages.
The captions for language-dependent text are entered in DialogMultiLanguage when the script is compiled. The key (column Entrykey), the language (column Ident_Language) and the language-dependent replacement (column EntryValue) are entered in this table. The key should be in the corresponding default language. If a language caption has not been entered, the key is used as the display text. Use the Language Editor to add translations for the captions in other languages.
Example
A change is made to an employee. The language-dependent process information could be formulated as follows:
-
Value template for the process information on the Update event
Value = #LD("Change of properties of person {0}.", $InternalName$)#
-
Templates for the display texts in the DialogMultiLanguage table
Key
Language
Value
Changed properties of employee {0}.
English - United States [en-US]
Changed properties of employee {0}.
Changed properties of employee {0}.
German - Germany [de-DE]
Änderung der Daten der Person {0}.
With InternalName = JBasset, the following display texts are produced in the process view.
|
Current user's language |
Display text in the process view |
|---|---|
|
English - United States [en-US] |
Change of properties of person JBasset. |
|
German - Germany [de-DE] |
Änderung der Daten der Person JBasset. |
Related Topics
Example of specifying the language or language variant
#LD notation supports the specification of a language or language variant. This is particularly useful in cases where users need to receive system messages in their preferred language.
Example
-
Output in the default language:
Value = #LD("Test: {0}", <parameter>)#
Value = #LD[""]("Test: {0}", <parameter>)#
-
Output always in English
Value = #LD["en-US"]("Test: {0}", <parameter>)#
Value = #LD["english"]("Test: {0}", <parameter>)#
-
Using a variable:
Dim lang As String = "en-US"
Value = #LD[lang]("Test: {0}", <parameter>)#
You do not need to enter the language in square brackets, it is optional. However, it is important that the language statement is a String expression. If the language is not specified or the resulting String expression is empty or Nothing, the language currently set for the application is used for translation.
Scripts in the script library
The script library contains source code for all the scripts used in One Identity Manager. The default scripts that we supply cannot be edited. These scripts are overwritten during schema installation even if they are used in custom scripts.
|
|
NOTE: You can find detailed examples for syntax and usage of scripts on the installation medium in the directory QBM\dvd\AddOn\SDK\ScriptSamples. |
Scripts are displayed under Script Library in Designer. You can gather all the information about usage, for example, in column definitions, processes or other scripts, in the script overview.
Use the Script Editor to create, edit and test scripts. You can edit and test the scripts in the System Debugger to avail of the more extensive Visual Studio debug and edit options.
Detailed information about managing permissions and executing scripts via program functions can be found in the One Identity Manager Authorization and Authentication Guide.
Detailed information about this topic
- Support for processing of scripts in Script Editor
- Creating and editing scripts with the Script Editor
- Copying scripts in the Script Editor
- Testing script compilation in the Script Editor
- Testing a script in the Script Editor
- Overriding scripts
- Editing and testing script code with the System Debugger