Business Application Programming Interface und Application Programming Interface

Die im EH&S verwendeten Business Application Programming Interfaces und Application Programming Interfaces (BAPIs und APIs) können Daten im Unicode-Format sowie in den Formaten der SAP(ISO)-Codepages und der Microsoft-Codepage lesen und verarbeiten. Die BAPI- und API-Aufrufe enthalten einen Parameter, der die Konvertierung entsprechend dem Umgebungsparameter MULTI_CODEPAGE_SUPPORT steuert. Bei gesetztem Parameter wird die Konvertierung während des BAPI- oder API-Aufrufs eingeschaltet und am Ende des Aufrufs wieder ausgeschaltet.

Datenerfassung und -ausgabe im SAP-System

Die Erfassung und Ausgabe von EH&S-Daten im SAP-System und damit auch die Konvertierungen erfolgen gemäß dem SAP-Standard während der Kommunikation zwischen dem SAP GUI und dem Applikationsserver. Eine zusätzliche Konvertierung durch den EH&S NLS ist daher nicht nötig.

Datenausgabe im Spezifikationsinformationssystem mit Microsoft Excel

Bei der Ausgabe von Daten mit Microsoft Excel im Spezifikationsinformationssystem werden Daten über den Funktionsbaustein GUI_DOWNLOAD an das Windows-Frontend gesendet und in einem nach folgenden Kriteriengemäß dem SAP-Standardkonvertiert:

Daten der Excelvorlage

Die Daten der Excelvorlage werden im Hexadezimalformat übertragen und müssen daher nicht konvertiert werden.

Datendatei

Die Datendatei enthält sprachabhängige Daten zur Anmeldesprache und sprachunabhängige Daten. Beim Herunterladen der Datei werden die Daten gemäß dem SAP-Standard während der Kommunikation zwischen dem SAP GUI und dem Applikationsserver vom Format derSAP-Codepage in das Format der Microsoft-Codepage konvertiert.

Eine zusätzliche Konvertierung durch den EH&S NLS ist daher nicht nötig.

Import und Export

Sie können sprachabhängige EH&S-Daten zu Phrasen, Spezifikationen und Literaturquellen sowohl im Format der im SAP-System verwendeten Codepages als auch im Format der Microsoft-Codepages importieren und exportieren. Konvertierungsprogramme in den API-Bausteinen sorgen dafür, dass die Daten beim Import korrekt im Format der SAP(ISO)-Codepages (Nicht-Unicode-System) oder im Unicode-Format (Unicode-System) in der Datenbank abgelegt werden und im gewünschten Format exportiert werden.

Beim Import enthält der Parameter +SC im Verwaltungsteil der Austauschdatei die Formatinformation:

+SC:ISO-R/3oderUTF-8

Die Daten der Austauschdatei liegen im Format der SAP(ISO)-Codepage (Parameterwert ISO-R/3, Nicht-Unicode-System) oder im Unicode-Format (Parameterwert UTF-8, Unicode-System) vor und werden unkonvertiert in den Applikationsserver eingelesen und über die API-Bausteine unkonvertiert in die Datenbank geschrieben.

+SC:MS-NT

Die Daten der Austauschdatei liegen im Format der Microsoft-Codepages vor. Die Daten werden zunächst unkonvertiert in den Applikationsserver eingelesen. DieAPI-Bausteine konvertieren die Daten vom Format der Microsoft-Codepage in das Format derSAP(ISO)-Codepage (Nicht-Unicode-System) oder ins Unicode-Format (Unicode-System). Dabei werden sprachabhängige Daten entsprechend der zugeordneten Sprache konvertiert. Sprachunabhängige Daten werden nicht konvertiert und sollten daher nur aus Zeichen des synt aktischen Zeichensatzes bestehen.

Sie dürfen auf keinen Fall Daten im Unicode-Format in ein Nicht-Unicode-System importieren. Folgende Datenformate sind möglich:

Beim Export steuert der Umgebungsparameter EXPORT_CHARACTER_NORM in welchem Format die Daten exportiert werden. Den Parameter bewerten Sie im Customizing der Grunddaten und Werkzeuge unter Umgebungsparameter festlegen . Der Wert dieses Parameters wird an die API-Bausteine zum Lesen der Daten weitergegeben:

EXPORT_CHARACTER_NORM:ISO-R/3oderUTF-8

Die Daten werden unkonvertiert in die Austauschdatei geschrieben.

EXPORT_CHARACTER_NORM:MS-NT

DieAPI-Bausteine konvertieren die Daten vom Format derSAP(ISO)-Codepage oder vom Unicode-Format in das Format der Microsoft-Codepages. Dabei werden sprachabhängige Daten entsprechend der zugeordneten Sprache konvertiert. Sprachunabhängige Daten werden nicht konvertiert und sollten daher nur aus Zeichen des syntaktischen Zeichensatzes bestehen.

Im Verwaltungsteil der Export-Austauschdatei wird der Parameter +SC automatisch entsprechend dem ermittelten Wert des Parameters EXPORT_CHARACTER_NORM gesetzt, damit bei einem späteren Import dieser Datei richtig konvertiert wird.

Sie können Eigenschaftsbäume und Berichtsvorlagen nur unkonvertiert, d.h. im Format der SAP(ISO)-Codepages (Nicht-Unicode-System) oder im Unicode-Format (Unicode-System) importieren und exportieren. Eine Konvertierung in das Format der Microsoft-Codepages ist nicht nötig, da Eigenschaftsbäume und Berichtsvorlagen nur zwischen SAP-Systemen ausgetauscht werden.

Application Link Enabling

Bei der Verteilung per Application Link Enabling (ALE) werden über eine RFC-Kommunikation Daten im Format der im SAP-System verwendeten Codepages von einem SAP-System auf weitere SAP-Systeme übertragen. Das System wird so eingerichtet, dass dabei nicht konvertiert wird.

Werden Daten perALEzwischen Nicht-Unicode-Systemen übertragen, kann es vorkommen, dass diese Daten über verschiedeneSAP(ISO)-Codepages abgebildet werden müssen. Eine Konvertierung muss dann sogar unterbunden werden, da sprachabhängige Daten, die über mehrere Codepages abgebildet werden müssen, in der RFC-Kommunikation nicht datensatzweise konvertiert werden und dadurch bei der Übertragung zerstört werden können (siehe Konvertierungen gemäß dem SAP-Standard ).

Sie dürfen auf keinen Fall Daten per ALE zwischen einem Nicht-Unicode- und einem Unicode-System verteilen.

Generell wird bei einer RFC-Kommunikation nicht konvertiert, wenn die aktiven Codepages im Empfänger- und Sendersystem gleich sind. Dies wird folgendermaßen erreicht:

Innerhalb eines ALE-Verteilungsmodells muss eine Codepage als Codepage für die Übertragung ausgewählt werden (z. B. SAP(ISO)-Codepage 1100). Diese Codepage muss auf allen am Verteilungskonzept beteiligten SAP-Systemen eingerichtet sein.

Sie müssen im Sendersystem im Customizing der Grunddaten und Werkzeuge unter Umgebungsparameter festlegen im Parameter ALE_TRANSFER_LANGUAGE eine Sprache dieser Codepage als Transfersprache angeben. Diese Sprache steuert, welche Codepage bei der Datenübertragung im Sendersystem aktiv ist.

Sie müssen die RFC-Destinationen der Empfängersysteme mit der Anmeldesprache definieren, die Sie im Customizing der Grunddaten und Werkzeuge im Parameter ALE_TRANSFER_LANGUAGE angegeben haben.

Wenn Daten übertragen werden sollen, die über verschiedene SAP(ISO)-Codepages abgebildet werden müssen, dann müssen die Betriebssysteme des Sender- und Empfängersystems ASCII-Zeichensätze nutzen.

Beachten Sie auch die generelle Einschränkung für EBCDIC-Systeme, die im Einführungsleitfaden (IMG) der Grunddaten und Werkzeuge unter EH&S Native Language Support einrichten beschrieben wird.

Bearbeitung von Berichtsvorlagen

Bei der Bearbeitung von Berichtsvorlagen werden aus dem SAP-System Daten über den Funktionsbaustein GUI_DOWNLOAD an das Windows-Frontend geladen und nach folgenden Kriteriengemäß dem SAP-Standardkonvertiert:

Word-Dokument (enthält die Berichtsvorlage)

Das Word-Dokument wird im Hexadezimalformat übertragen und wird daher nicht konvertiert.

Strukturdatei (enthält die Symbole und Wiederholungsgruppen)

Die Strukturdatei besteht nur aus Zeichen des syntaktischen Zeichensatzes . Die Datei wird im Textformat übertragen und dadurch falls nötig konvertiert.

Sprachabhängige Daten wie Symbolbezeichnungen und Phrasentexte zur Anzeige in den Dialogfenstern des WWI

Diese Daten werden über eine RFC-Kommunikation in der Anmeldesprache gelesen und dabei korrekt vom Format der SAP(ISO)-Codepage (Nicht-Unicode-System) oder vom Unicode-Format (Unicode-System) in das Format der Microsoft-Codepage konvertiert.

Eine zusätzliche Konvertierung durch den EH&S NLS ist nicht nötig.

WWI-Generierungsserver

Beim Generieren eines Berichts werden Daten der SAP-Komponente EH&S und anderer SAP-Komponenten abgemischt. Dabei werden vom WWI-Workprozess Daten über eine RFC-Kommunikation an den Generierungsserver geschickt und zuvor nach folgenden Kriterien durch Konvertierungsprogramme des EH&S NLS konvertiert:

Word-Dokument (enthält die Berichtsvorlage oder den Bericht)

Das Word-Dokument wird im Hexadezimalformat übertragen und wird daher nicht konvertiert.

Strukturdatei (enthält die Symbole und Wiederholungsgruppen)

Die Strukturdatei besteht nur aus Zeichen des syntaktischen Zeichensatzes . Die Datei wird im Textformat übertragen und dadurch falls nötig (im Unicode-System) konvertiert.

Wertedatei (Value-File)

Die Daten werden imSAP-System anhand ihres Sprachenschlüssels durch den EH&S NLS vom Format derSAP(ISO)-Codepage (Nicht-Unicode-System) oder vom Unicode-Format (Unicode-System) ins Format der Microsoft-Codepage konvertiert. Eine weitere Konvertierung beim Übertragen der Wertedatei ans Frontend könnte Daten zerstören. Sie wird vermieden, indem bei der RFC-Kommunikation die Datei im Hexadezimalformat übertragen wird (siehe Abschnitt Kommunikation über Remote Function Calls unter Konvertierungen gemäß dem SAP-Standard ).

Bei der Berichtsgenerierung können auch Symbole vom Typ Parameter durch sprachabhängige Daten ersetzt werden. Auch diese Daten werden konvertiert, d.h. Sie müssen bei der Definition dieser Symbole nicht mehr darauf achten, dass durch die Funktionsbausteine, die Sie in der Auflösungsart Funktionsbaustein angeben, die entsprechenden Konvertierungsroutinen aufgerufen werden.

Layoutkontrolle

Bei der Layoutkontrolle von Berichten werden aus dem SAP-System Daten über den Funktionsbaustein GUI_DOWNLOAD an das Windows-Frontend geladen und zuvor nach folgenden Kriterien durch Konvertierungsprogramme des EH&S NLS konvertiert:

Word-Dokument (enthält die Berichtsvorlage)

Das Word-Dokument wird im Hexadezimalformat übertragen und wird daher nicht konvertiert.

Wertedatei (Value-File)

Die Daten werden im SAP-System anhand ihres Sprachenschlüssels durch den EH&S NLS vom Format der SAP(ISO)-Codepage (Nicht-Unicode-System) oder vom Unicode-Format (Unicode-System) ins Format der Microsoft-Codepage konvertiert. Eine weitere Konvertierung beim Übertragen der Wertedatei ans Frontend könnte Daten zerstören. Sie wird vermieden, indem die Daten durch den Funktionsbaustein im BINÄR-Modus übertragen werden.

EH&S Expert

Bei der Sekundärdatenermittlung durch den EH&S Expert werden EH&S-Daten gelesen, auf dem Expert-Server verarbeitet und die Ergebnisse in die Datenbank geschrieben. Der Expert-Server ist ein selbstregistrierender Server mit einem Microsoft-Windows-Betriebssystem. Das Programm des EH&S Expert basiert auf ASCII-Zeichensätzen. Daten müssen daher beim Lesen vom Format der im SAP-System verwendeten Codepages in das Format der Microsoft-Codepages und beim Schreiben zurück in das Format der SAP-Codepages konvertiert werden.

Die Kommunikation zwischen demSAP-System und dem Expert-Server findet per RFC statt. Bei der Standard-Konvertierung von Daten in der RFC-Kommunikation bestimmt die aktive Codepage des Applikationsservers die Konvertierung. Zudem können Daten nicht datensatzweise konvertiert werden. Die Daten werden daher imSAP-System in den Bausteinen entsprechend des Sprachenschlüssels der Daten durch den EH&S NLS vom Format derSAP(ISO)-Codepages (Nicht-Unicode-System) oder vom Unicode-Format (Unicode-System) in das Format der Microsoft-Codepages (beim Lesen) und umgekehrt (beim Schreiben) konvertiert. Eine weitere Konvertierung bei der Datenübertragung in der RFC-Kommunikation könnte Daten zerstören. Sie wird vermieden, indem bei der RFC-Kommunikation die entsprechenden sprachabhängigen Daten (Identifikatoren, Freitexte, Phrasentexte) im Hexadezimalformat übertragen werden (siehe Abschnitt Kommunikation über Remote Function Calls unter Konvertierungen gemäß dem SAP-Standard ). Sprachunabhängige Daten (Spezifikations-, Material- und Phrasenschlüssel, sprachunabhängige Identifikatoren, etc.) werden im Textformat übertragen und dadurch wenn nötig durch die RFC-Kommunikation konvertiert. Diese Daten dürfen daher nur aus Zeichen bestehen, die über alle Codepages gleich abgebildet werden, die im SAP-System und in den Frontend-Betriebssystemen eingesetzt werden. Zur Sicherheit sollten Sie daher für sprachunabhängige Daten nur die Zeichen des syntaktischen Zeichensatzes verwenden.

Der Regeleditor wird derzeit nur in Englisch ausgeliefert. Wenn Sie sich in einer anderen Sprache anmelden, erhalten Sie den Eigenschaftsbaum und die Phrasenauswahlmengen in dieser Sprache angezeigt, sofern das Gebietsschema Ihres Frontends die Anzeige dieser sprachabhängigen Daten im Format derkorrekten Microsoft-Codepageermöglicht. Die Daten werden hierzu falls nötig durch die RFC-Kommunikation konvertiert.

Wenn Sie durch die Regelwerke sprachabhängige Daten (z. B. einen Identifikator oder Freitext in einer bestimmten Sprache) lesen oder schreiben wollen, dann müssen Sie bei der Erstellung des Regelwerks darauf achten, dass das Gebietsschema Ihres Frontends die Eingabe dieser sprachabhängigen Daten im Format derkorrekten Microsoft-Codepageermöglicht. Eine Konvertierung in das Format der im SAP-System verwendeten Codepages ist an dieser Stelle nicht nötig, da die Regelwerke nur auf dem Expert-Server genutzt werden.

Gefahrgutpapiere

Gefahrgutpapiere werden als SAPscript-Dokumente im Format der imSAP-System verwendeten Codepages generiert und anschließend über denSAP-Spool verarbeitet (z. B. gedruckt). Die Daten werden dabei gemäß demSAP-Standard konvertiert. Gefahrgutpapiere können sprachabhängige Daten in der Sprache des SAPscript-Dokuments und in weiteren Sprachen enthalten.

Electronic Data Interchange (EDI)

Sie können einem Partner (z. B. Spediteur oder Warenempfänger) zu einer Lieferung oder einem Transport Gefahrgutdaten in elektronischer Form über Electronic Data Interchange (EDI) zusenden (siehe EDI-Abwicklung für Gefahrgutdaten ). Die dabei verwendeten Intermediate Documents (IDocs) dürfen in einem Nicht-Unicode-System jedoch generell nur sprachabhängige Daten in Sprachen enthalten, die über eineSAP(ISO)-Codepage abgebildet werden können, da die Daten nicht datensatzweise konvertiert werden. Die aktive Codepage des Applikationsservers ist dabei die Codepage, von der aus konvertiert wird. Um ein IDoc mit sprachabhängigen Daten einer bestimmten Codepage zu erzeugen, müssen sie sich daher in einer Sprache dieser Codepage amSAP-System anmelden.