Code-Tabellen (CODE)

{"URL":["/*.*/awa/pa_view_CODE"],"heroDescriptionIdentifier":"ice_code_table_hero","customCards":[{"id":"ice_code_table_why_are_conversions_necessary","title":"Why Are Conversions Necessary?","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_code_tables_cd_vs_standard_character_conversion_sets","title":"Code Tables vs Standard Character Conversion Sets","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_code_tables_code_tables","title":"Code Tables","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_code_tables_standard_character_encoding_sets","title":"Standard Character Encoding Sets","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_jobs_character_conversion_during_job_execution","title":"Character Conversion During Job Execution","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job.htm","languages":["en-us"]},{"id":"ice_file_transfer_character_conversion_during_file_transfer","title":"Character Conversion During File Transfer","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_File_Transfer_Defining.htm","languages":["en-us"]},{"id":"ice_code_table_adding_a_code_table","title":"Adding a Code Table","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_code_table_how_to_define_a_code_table","title":"How to Define a Code Table","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_CodeTable.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_universal_language_support","title":"Universal Language Support (Unicode)","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Admin/admin_Unicode_UTF8_24.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

Einige Betriebssysteme und Anwendungen verwenden spezielle Zeichensätze. Wenn der Server, auf dem der Agent ausgeführt wird, eine andere Zeichencodierung als der Automation Engine-Server verwendet, ist es notwendig, eine Zeichenkonvertierung durchzuführen. Automic Automation verwendet dafür Code-Tabellen-Objekte und Standard-Zeichenkonvertierungssätze (z. B. <ISO-8859-15> usw). Ein Code-Tabellen-Objekt ist eine Matrix, die festlegt, wie Zeichen konvertiert werden. Code-Tabellen-Objekte und Standard-Zeichenkonvertierungssätze können Agenten und Objekten (Jobs und FileTransfers) zugeordnet werden. Funktionsweise:

Zeichenkonvertierung auf Agentenebene

Wenn Sie einen Agenten konfigurieren, legt Ihr Automic Automation-Administrator die Zeichencodierung des Agenten in dessen INI-Datei fest. Der Agent verwendet sie, um Zeichen wie erforderlich zu konvertieren, wenn der Rechner, auf dem ein Agent ausgeführt wird, eine andere Zeichencodierung als der Automation Engine-Server verwendet.

Die Code-Tabellen-Objekte, die in der INI-Datei des Agenten als Standard festgelegt sind, müssen in Mandant 0 gespeichert werden.
Zeichenkonvertierung auf Objektebene (Jobs und FileTransfers)

Wenn Sie ein Job-Objekt (JOBS) oder FileTransfer-Objekt (JOBF) konfigurieren, können Sie ihm auf seiner Seite Attribute einen bestimmten Zeichenkonvertierungssatz zuordnen. Der von Ihnen hier angegebene Zeichensatz überschreibt den in der INI-Datei des Agenten angegebenen. Im Falle von FileTransfer-Objekten können Sie auch separate Zeichencodierungssätze für den Quellagenten und den Zielagenten angeben, die an der Datenübertragung beteiligt sind.

Als Systemadministrator definieren Sie Code-Tabellen-Objekte. Sie ordnen diese Objekte und/oder Standard-Zeichencodierungssätze Agenten im Parameter UC_HOST_CODE im Abschnitt [VARIABLES] der INI-Datei des Agenten zu. Automation Engine liest die standardmäßige Code-Tabelle bzw. den Standard-Codierungssatz dann aus Systemmandant 0 aus und übernimmt die Übertragung an den Agenten, der die Tabelle bzw. den Codierungssatz dann auf alle Jobs und FileTransfers anwendet, die eine Zeichenkonvertierung erfordern.

Als Entwickler und Objektdesigner können Sie die als Standard festgelegte Code-Tabelle oder den Standard-Codierungssatz überschreiben, indem Sie eine bestimmte Tabelle oder einen bestimmten Satz in der Jobdefinition und der FileTransfer-Definition angeben.

Objektklasse: Passives Objekt

Objekttyp/Kurzform: CODE

Diese Seite beinhaltet Folgendes:

Wann sind Konvertierungen notwendig?

Automic Automation verwendet Code-Tabellen-Objekte und Standard-Konvertierungssätze für Folgendes:

Datenübertragung zwischen der Automation Engine und den Agenten.
Während des FileTransfers zwischen Agenten.
Während der Vorbereitung von Datensequenzen (Automation Engine Script).

Kommunikation mit Agenten, die UTF-8 NICHT unterstützen

Die Automation Engine verwendet bei der Kommunikation die Code-Tabelle UC_CODE, sowohl für den Datenverkehr zwischen sich selbst und den Agenten als auch für den Datenverkehr zwischen Agenten.

Kommunikation mit Agenten, die UTF-8 unterstützen

Die Automation Engine verwendet bei der Kommunikation UTF-8, sowohl für die Kommunikation zwischen sich selbst und den Agenten als auch für die Kommunikation zwischen Agenten.

Code-Tabellen und Standard-Zeichenkonvertierungssätze

Der einzige Unterschied zwischen Code-Tabellen und Standard-Zeichenkonvertierungssätzen ist, dass Code-Tabellen Automic Automation-Objekte sind, während Standard-Zeichenkonvertierungssätze dies nicht sind. In jeder anderen Hinsicht ist ihre Funktion die gleiche. In diesem Abschnitt werden beide erläutert.

Code-Tabellen

Automic Automation stellt standardmäßig die folgenden Code-Tabellen-Objekte zur Verfügung. Sie können sie bearbeiten und neue erstellen:

UC_CODE
- Zielsysteme
  
  NSK, Oracle-Anwendungen, PeopleSoft, SAP, UNIX, VMS, Windows
- Zeichensatz
  
  Basiszeichensatz der Automation Engine
ASCII_850
- Zielsysteme
  
  MS DOS
- Zeichensatz
  
  Beinhaltet deutsche Umlaute.
BS2000_DEUTSCH
- Zielsysteme
  
  BS2000
- Zeichensatz
  
  Beinhaltet deutsche Umlaute.
BS2000_EDF041
- Zielsysteme
  
  BS2000
- Zeichensatz
  
  Gemäß EDF041
BS2000_INTERNATIONAL
- Zielsysteme
  
  BS2000
- Zeichensatz
  
  Alphanumerisch mit Sonderzeichen
CODE
- Zielsysteme
  
  Beliebiger
- Zeichensatz
  
  Dies ist die standardmäßige Vorlage für Code-Tabellen-Objekte, die bei der Installation bereitgestellt wird. Sie verwenden sie, um Ihre eigenen Vorlagen zu erstellen.
EBCDIC_00237
- Zielsysteme
  
  Keine
- Zeichensatz
  
  USA
EBCDIC_00037
- Zielsysteme
  
  OS400
- Zeichensatz
  
  Deutschland und Österreich
EBCDIC_00500
- Zielsysteme
  
  Keine
- Zeichensatz
  
  International
EBCDIC_01141
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Deutschland und Österreich mit €-Zeichen
IBM_3270_DEUTSCH
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Beinhaltet deutsche Umlaute.
IBM_3270_INTERNATIONAL
- Zielsysteme
  
  z/OS
- Zeichensatz
  
  International

Standard-Zeichencodierungssätze

Standard-Zeichencodierungssätze sind KEINE Objekte. Es handelt sich um Konvertierungstabellen, die in den Code von Automic Automation eingebettet sind und die nicht geändert oder gelöscht werden können. Sie können sie leicht erkennen, weil sie immer in spitzen Klammern angezeigt werden, während das bei Code-Tabellen-Objekten nicht der Fall ist. Dies sind die verfügbaren Standard-Zeichencodierungssätze:

<ISO-8859-1>
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Latin1
<ISO-8859-15>
- Zielsysteme
  
  Keine
- Latin9
<UCS-2BE>

Nur für FileTransfer-Objekte verfügbar.
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Universal Coded Character Set, älterer fixer 2-Byte-Zeichensatz, Big Endian
<UCS-2LE>

Nur für FileTransfer-Objekte verfügbar.
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Universal Coded Character Set, älterer fixer 2-Byte-Zeichensatz, Little Endian
<UTF-8>
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Unicode UTF-8
<WINDOWS-1252>
- Zielsysteme
  
  Keine
- Zeichensatz
  
  Latin Western Europe

Zeichenkonvertierung während der Jobausführung

Weitere Informationen finden Sie unter Jobs (JOBS).

Zeichenkonvertierung während FileTransfers

Siehe FileTransfers (JOBF).

Code-Tabelle hinzufügen

In manchen Fällen benötigen Sie möglicherweise eine Code-Tabelle, die von den Standardeinstellungen abweicht. Die einfachste Methode besteht darin, eine vorhandene zu duplizieren und anzupassen.

Wenn die Code-Tabelle nur für einen bestimmten Mandanten Gültigkeit haben soll, duplizieren Sie eine ähnliche Code-Tabelle auf dem nummerierten, systemexternen Mandanten und passen Sie die Tabelle entsprechend an. Zu diesem Zweck benötigen Sie besondere Rechte. Die von Ihnen hinzugefügte Code-Tabelle finden Sie in den FileTransfers (JOBF).

Es können Code-Tabellen mit identischen Namen in verschiedenen Mandanten vorhanden sein. Die Namen der Code-Tabellen in Mandant 0 müssen jedoch eindeutig sein.

Sie müssen sich erneut anmelden, um Änderungen an den Code-Tabellen in Mandant 0 zu übernehmen.

Tipps:

Code-Tabellen, die den Agenten als Standard-Code-Tabelle in ihren INI-Dateien zugewiesen wurden, müssen immer in Mandant 0 gespeichert werden.
Das Speichern von Code-Tabellen in Mandant 0 gewährleistet, dass nur autorisierte Benutzer sie ändern können.

Code-Tabellenobjekte definieren

Eine Definition der Code-Tabellenobjekte besteht aus den folgenden Seiten:

Standardseiten, die unabhängig von dem von Ihnen definierten Objekttyp zu jeder Zeit verfügbar sind:

Definieren der Seite "Allgemein"

Definieren der Seite "Versionsmanagement"

Hinweis: Die Seite Versionsmanagement enthält nur dann gespeicherte Dokumentationsobjektversionen, wenn diese Funktion in der Variablen UC_CLIENT_SETTINGS aktiviert wurde.

Definieren der Seite "Dokumentation"

Die hier beschriebene, objektspezifische Seite.

Ein Code-Tabellenobjekt definieren

Geben Sie auf der Seite Code-Tabelle an, wie die Codes angezeigt werden sollen, die Sie zuordnen möchten. Sie haben zwei Möglichkeiten:
- ASCII:
  
  max. 1 Zeichen
  
  Zulässige Zeichen: 8 Bit-Codes.
- HEX:
  
  max. 2 Zeichen
  
  Zulässige Zeichen: 0-9 und/oder A-F in Großbuchstaben. Kleinbuchstaben werden automatisch in Großbuchstaben umgewandelt.
Die Zellen der Tabelle sind Eingabefelder und standardmäßig deaktiviert. Führen Sie folgende Schritte durch:
1. Um eine Zelle zu aktivieren: Klicken Sie darauf.
2. Um einer Zelle ein Zeichen zuzuordnen: Doppelklicken Sie auf die Zelle und geben Sie das Zeichen ein.
3. Um der Zelle ein alternatives Zeichen zuzuordnen: Klicken Sie mit der rechten Maustaste auf die Zelle und wählen Sie im Drop-down-Menü die Option Als Ersatzzeichen setzen aus. Alternative Zeichen werden für die Konvertierung verwendet, wenn das dieser Zelle zugeordnete Zeichen deaktiviert ist.
4. Um ein Zeichen zu aktivieren: Wählen Sie es aus und klicken Sie auf Zeichen aktivieren.
Das Entfernen eines Zeichens aus der Tabelle setzt die Zelle auf den Standardwert zurück.

Siehe auch:

Universelle Sprachunterstützung (Unicode)