Complete identifier of texts from the language switcher
VisiWin contains various options for accessing texts from the language switch. This is specified,
- from which project file in the client or (multi-)server project the text is to be read,
- from which text category (user texts or system texts) the text is to be read,
- in which text group the text is located (as text groups can be nested within each other, the complete group hierarchy is expected),
- what name the text has.
The full identifier, which is expected in some functions of the system, contains all these components.
Syntax of the complete identifier
@[ServerAlias:][TextType].TextGroups.TextName
with:
@
|
Fixed prefix for specifying a text from the language switch. If no @ is specified at the beginning, the language switching functions return the complete identifier themselves. |
ServerAlias:
|
Alias of a project on another computer from the project configuration. The alias must end with a colon (:). If no server alias is specified, the current project is used by default. Note: Specifying a server alias only makes sense in projects that have been configured for a multi-server architecture.
|
TextType
|
Optional specification of one of the following values (enclosed in square brackets):
|
TextGroups
|
Specification of the text group hierarchy. The text groups below each other are specified one after the other from top to bottom, separated by a dot (.). |
TextName
|
Name of the localizable text, separated from the text group hierarchy specification by a dot (.). |
Examples:
@View1.txtOkor
@[ClientApplication].View1.txtOkReturns the text txtOk from the
UserText.View1group in the current project language. The text type[ClientApplication]is optional.@[ClientSystem].Components.AlarmList.FileNameReturns the text
FileNamefrom theComponents.AlarmListgroup in the current project language.@[ServerSystem].AlarmSystem.Groups.AlarmGroup1.AlaOverflowReturns the text of the
Overflowalarm from theAlarmGroup1alarm group in the current project language.Remark:The fixed prefix
AlainAlaOverflowresults from the automatic assignment of a name for an alarm text when the alarm is created via the editors.The fixed group prefix
AlarmSystem.Groupsis system-specific and specifies the group hierarchyAlarms.Alarmgroups.@RedundancyServer:[ServerApplication].CommonErrorTexts.MissingConnectionReturns the text MissingConnection from the text group
UserText.CommonErrorTextsfrom the project specified via the server aliasRedundancyServerin the current project language.Note: When specifying a server alias, the text types[ClientApplication]and[ClientSystem]cannot be used because, as the term server aliassuggests, this is access to a server project file.