GetMessageText

Beschreibung:

Lädt Texte aus einer Messages.txt im Projektverzeichnis. Falls die Oberflächen-Sprache auf Englisch eingestellt ist, dann aus der "Messages.0009.lng.txt".

Hinweis: Der Inhalt der Text-Dateien hat folgenden Aufbau:

<Name des Eintrags>=<Rückgabewert>

Zum Beispiel, Messages.txt:

SalesOpportunitySuccessful=Die Verkaufschance {0} wurde erfolgreich vom Benutzer {1} abgeschlossen. Soll nun ein neuer Datensatz in der Ansicht [2} erstellt werden, um eine Auftragsbestätigung zu erstellen?

Messages.0009.lng.txt

SalesOpportunitySuccessful=The sales opportunity {0} was successfully completed by the user {1}. Should a new record be created in the view {2} to create an order confirmation?

Die Platzhalter {0} bis {4} können über die nachfolgenden Parameter (sParam1 bis sParam5) befüllt werden. Erfolgt eine leere Parameterübergabe, so wird der Platzhalter nicht entfernt.

Im genannten Beispiel sähe der Scriptcode für eine deutsche Meldung wie folgt aus: cRM.CurrentProject.GetMessageText("", "SalesOpportunitySuccessful", "combit Software GmbH", "LFrisch", "Belege")

Wenn die Anwendungssprache Englisch ist, würde man die Methode wie folgt aufrufen: cRM.CurrentProject.GetMessageText("", "SalesOpportunitySuccessful", "combit Software GmbH", "LFrisch", "SalesDocuments")

Der Rückgabewert wäre bei deutscher Anwendungssprache wie folgt: Die Verkaufschance combit Software GmbH wurde erfolgreich vom Benutzer LFrisch abgeschlossen. Soll nun ein neuer Datensatz in der Ansicht Belege erstellt werden, um eine Auftragsbestätigung zu erstellen?

Bei englischer Anwendungssprache ist der Rückgabewert wie folgt: The sales opportunity combit Software GmbH was successfully completed by the user LFrisch. Should a new record be created in the view SalesDocuments to create an order confirmation?

Platzhalter können auch rekursiv in aufsteigender Reihenfolge verwendet werden. Dies bedeutet, dass ein übergebener Parameter1 selbst wiederum einen Wert wie {1} oder {2} enthalten kann, welcher durch die übergebenen Parameter2 und Parameter3 befüllt wird.

Erweiterte Formatspezifizierer oder andere Datentypen als Zeichenketten werden nicht unterstützt.

Alle Einträge der Messages.txt (bzw. Messages.0009.lng.txt) werden solange zeilenweise geladen und in einem Cache im Hauptspeicher gespeichert, bis die gesuchte ID gefunden wurde. Das bedeutet, dass häufig benutzte Einträge zu Beginn der Dateien verwendet werden sollten, um eine gute Balance zwischen Hauptspeicherverbrauch und Performance zu erhalten.

Die Einträge sind projektspezifisch, dies bedeutet, dass Änderungen in den Dateien Messages.txt oder Messages.0009.lng.txt erst beim Neuladen des Projektes Auswirkungen haben.

Bitte beachten Sie, dass die Dateien Messages.txt und Messages.0009.lng.txt als Kodierung ANSI, UTF-8 mit Byte Order Mark (BOM) oder UTF-16 verwenden, um die falsche Darstellung von z. B. Umlauten zu vermeiden.

Parameter:

Parametername

Typ

Beschreibung

sResourceFile

String

Dieser Parameter ist reserviert und wird ignoriert. Aktuell kann eine leere Zeichenkette übergeben werden.

sID

String

Name des Eintrags aus der Messages.txt (bzw. Messages.0009.lng.txt).

sParam1

String

Optional. Erster Parameter, um Informationen für den Platzhalter {0} innerhalb der Messages.txt (bzw. Messages.0009.lng.txt) zu befüllen.

sParam2

String

Optional. Zweiter Parameter, um Informationen für den Platzhalter {1} innerhalb der Messages.txt (bzw. Messages.0009.lng.txt) zu befüllen.

sParam3

String

Optional. Dritter Parameter, um Informationen für den Platzhalter {2} innerhalb der Messages.txt (bzw. Messages.0009.lng.txt) zu befüllen.

sParam4

String

Optional. Vierter Parameter, um Informationen für den Platzhalter {3} innerhalb der Messages.txt (bzw. Messages.0009.lng.txt) zu befüllen.

sParam5

String

Optional. Fünfter Parameter, um Informationen für den Platzhalter {4} innerhalb der Messages.txt (bzw. Messages.0009.lng.txt) zu befüllen.

 

Rückgabewert:

String

Beispiel VBScript:

If (cRM.UILanguageID = 7) Then

    Call cRM.CurrentProject.GetMessageText("", "SalesOppertunitySuccessfull", "combit Software GmbH", "LFrisch", "Belege")

Else

    Call cRM.CurrentProject.GetMessageText("", "SalesOppertunitySuccessfull", "combit Software GmbH", "LFrisch", "SalesDocuments")

End If

Beispiel C#-Script:

if (cRM.UILanguageID == 7)

{

    cRM.CurrentProject.GetMessageText("", "SalesOppertunitySuccessfull", "combit Software GmbH", "LFrisch", "Belege");

}

else

{

    cRM.CurrentProject.GetMessageText("", "SalesOppertunitySuccessfull", "combit Software GmbH", "LFrisch", "SalesDocuments");

}