Vollständiger Bezeichner von Texten aus der Sprachumschaltung

VisiWin beinhaltet verschiedene Möglichkeiten, auf Texte aus der Sprachumschaltung zuzugreifen. Dabei wird angegeben,

  • aus welcher Projektdatei im Client- oder (Multi-)Server-Projekt der Text zu lesen ist,
  • aus welcher Textkategorie (Benutzertexte oder Systemtexte) der Text gelesen werden soll,
  • in welcher Textgruppe sich der Text befindet (da Textgruppen ineinander verschachtelt werden können, wird die vollständige Gruppenhierarchie erwartet),
  • welchen Namen der Text hat.

Der Vollständige Bezeichner, der in einigen Funktionen des Systems erwartet wird, beinhaltet alle diese Bestandteile.

Syntax des vollständigen Bezeichners

@[ServerAlias:][TextType].TextGroups.TextName

mit:

@ Fester Präfix für die Angabe eines Textes aus der Sprachumschaltung. Wird kein @ am Anfang angegeben, geben die Funktionen der Sprachumschaltung den vollständigen Bezeichner selbst zurück.
ServerAlias:

Alias eines Projektes auf einem anderen Rechner aus der Projektkonfiguration. Der Alias muss mit einem Doppelpunkt (:) enden.

Wird kein Serveralias angegeben, wird standardmäßig das aktuelle Projekt verwendet.

Anmerkung: Die Angabe eines Serveralias macht nur in Projekten Sinn, die für eine Multiserver-Architektur konfiguriert wurden.
TextType

Optionale Angabe eines der folgenden (in eckige Klammern eingefassten) Werte:

  • [ClientApplication]: Ein Text aus dem Client-Projekt im Knoten Benutzertexte.
  • [ServerApplication]: Ein Text aus dem Server-Projekt im Knoten Benutzertexte.
  • [ClientSystem]: Ein Text aus dem Client-Projekt, der in einem der Knoten Komponenten/Dialoge oder einem der Systemzweige liegt.
  • [ServerSystem]: Ein Text aus dem Server-Projekt, der in einem der Knoten Komponenten/Dialoge oder einem der Systemzweige liegt.
TextGroups Angabe der Textgruppenhierarchie. Die untereinander liegenden Textgruppen werden nacheinander von oben nach unten, durch einen Punkt (.) getrennt angegeben.
TextName Name des lokalisierbaren Textes, durch einen Punkt (.) von der Angabe der Textgruppenhierarchie getrennt.

Beispiele:

  1. @View1.txtOk

    oder

    @[ClientApplication].View1.txtOk

    Gibt den Text txtOk aus der Gruppe Benutzertexte.View1 in der aktuellen Projektsprache zurück. Die Angabe des Texttypes [ClientApplication] ist optional.

  2. @[ClientSystem].Components.AlarmList.FileName

    Gibt den Text FileName aus der Gruppe Komponenten.AlarmList in der aktuellen Projektsprache zurück.

  3. @[ServerSystem].AlarmSystem.Groups.AlarmGroup1.AlaOverflow

    Gibt den Text des Alarms Overflow aus der Alarmgruppe AlarmGroup1 in der aktuellen Projektsprache zurück.

    Anmerkung:

    Der feste Präfix Ala in AlaOverflow ergibt sich aus der automatischen Vergabe eines Namens für einen Alarmtext, wenn der Alarm über die Editoren erzeugt wird.

    Der feste Gruppenpräfix AlarmSystem.Groups ist systemspezifisch und gibt hier die Gruppenhierarchie Alarme.Alarmgruppen an.

  4. @RedundancyServer:[ServerApplication].CommonErrorTexts.MissingConnection

    Gibt den Text MissingConnection aus der Textgruppe Benutzertexte.CommonErrorTexts vom über den Serveralias RedundancyServer spezifizierten Projekt in der aktuellen Projektsprache zurück.

    Anmerkung: Bei der Angabe eines Serveralias können die Texttypen [ClientApplication] und [ClientSystem] nicht verwendet werden, da es sich, wie der Begriff Serveralias schon sagt, um den Zugriff auf eine Server-Projektdatei handelt.