Allgemeiner Aufruf

Basis

Diese Klasse kann in jedes Python-Skript eingebettet werden.

Ein Import von cenpylib import * muss durchgeführt werden.

Definieren Sie ein Mitglied der Klasse in der Methode nls = NLSUtility() und Sie haben nun Zugriff auf die Methoden und Funktionen der Klasse.

Initialisierung der NLS-Übersetzung

Um die NLS-Übersetzung in Ihrem Python-Skript verfügbar zu machen, müssen Sie verschiedene Einstellungen durch den Aufruf der defineNLS()-Methode festlegen.

Es stellt mehrere Parameter zur Verfügung, um die gewünschte Übersetzung zu erhalten.

defineNLS( Sprache, Projekt, alternativerPfad )

Parameter language: kann mit den üblichen E2 Sprachen Englisch “EN”, Deutsch “DE”, Französisch “FR”, Chinesisch “CN”, Japanisch “JP” eingestellt werden.

Wenn leer gelassen "", versucht die Klasse, die OSystem-Sprache zu ermitteln und diese Sprache zuzuordnen. Standard ist Englisch “EN”.

Parameter project: Ein gewünschter Name für die Übersetzungsdateien kann festgelegt werden. Wenn dieser leer gelassen wird "", wird standardmäßig “common” verwendet.

Bedeutet, dass die Klasse nach Übersetzungsdateien mit dem gewünschten Namen (oder “common”) sucht.

Die Dateibenennungskonvention lautet [name].[language].lng, z. B. report.fr.lng

Parameter alternativePath: Standardmäßig sucht die Klasse nach Sprachdateien im E2 Installationsordner cenpylib, Unterordner languages.

Falls angepasste Dateien benötigt werden, unabhängig davon, ob sie bereits im Ordner cenpylib vorhanden sind oder komplett neu erstellt werden, kann ein Pfad zu einem gewünschten PlugIn definiert werden.

defineNLS() : keine Argumente : Sprache vom Betriebssystem übernehmen, Projekt “common”, NLS in cenpylib\languages

defineNLS(language) : nur Sprachargument : gewünschte Sprache, Projekt “common”, NLS in cenpylib\languages

defineNLS(altpath=“yourpath”) : nur Pfad-Argument : Sprache vom Betriebssystem übernehmen, Projekt “common”, NLS in altpath & cenpylib\languages

defineNLS(language, altpath=“yourpath”) : Sprache & Pfad Argumente : gewünschte Sprache, Projekt “common”, NLS in altpath & cenpylib\languages

defineNLS(language, project) : Sprache & Projekt Argument : gewünschte Sprache oder leer ""=Betriebssystem, Projekt mit gewünschtem Namen, NLS in cenpylib\languages

defineNLS(language, project, altpath) : language & project Arg : gewünschte Sprache oder leer ""=Betriebssystem, Projekt mit gewünschtem Namen, NLS in altpath & cenpylib\languages

defineNLS(project=“IhrProjekt”, altpath=“IhrPfad”) : Sprache=BS, Projekt mit gewünschtem Namen, NLS im altpath & cenpylib\languages

Hinweis: Bitte beachten Sie, dass in einigen Fällen die Parameterbeschreibung (altpath=”…”) erforderlich sein kann.

Standard-Speicherort der Übersetzungsdateien:

Das übersetzte Element abrufen

Um das gewünschte Element als Zeichenkette zurückzubekommen, wird diese Methode verwendet:

def getNLS(name, default):

Parameter name : der gewünschte Elementname in der Übersetzungsdatei

Parameter default : ein Standardtext, der verwendet wird, wenn der Eintrag nicht gefunden wurde. Optional, wenn nicht gesetzt, wird der Parameter name als Standard verwendet.

Der aus der NLS-Datei gelesene String oder der Standardwert wird zurückgegeben.

Ersetzen Sie einen Platzhalter in einem String

Es ist möglich, Platzhalter in einen Übersetzungsstring einzufügen, die durch einen variablen Teil ersetzt werden sollen, z. B. ein Standarddateiname mit dem Programmnamen.

In diesem Fall können Sie eine eindeutige Zeichenfolge zur Übersetzung hinzufügen und diese eindeutige Zeichenfolge in der zurückgegebenen Übersetzung durch den gewünschten Programmnamen ersetzen lassen.

def replaceNLS(instring, searchstr, replacestr):

Parameter instring : die Zeichenkette, die den zu ersetzenden Platzhalter enthält

Parameter searchstr : die eindeutige Zeichenfolge, die ersetzt werden soll

Parameter replacestr : die Zeichenkette, die die searchstr ersetzt

Der String mit dem ersetzten Abschnitt wird zurückgegeben.

Beispiel: