File-Empfänger-Adapter konfigurieren

Verwendung

Legen Sie einen File-Empfänger-Adapter an, um damit XML-Messages vom Integration Server/PCK in Dateien abzulegen.

Vorgehensweise

Damit das Dokument, das vom Integration Server/PCK geschickt wird, direkt in eine Datei abgelegt wird, wählen Sie das Message-Protokoll Datei .
Falls ein XML-Dokument in eine Textdatei konvertiert werden soll, wählen Sie Konvertierung des Dateiinhalts und machen Sie unter Parameter zur Inhaltskonvertierung die notwendigen Angaben zur Konvertierung (siehe unten).
Wählen Sie die Adapter Engine auf dem Integration Server oder eine dezentral installierte Adapter Engine aus.
Diese Auswahl ist im PCK nicht möglich.

Dateizugriffsparameter definieren

Wählen Sie die Registerkarte Ziel aus.
Geben Sie das Zielverzeichnis an, in dem die Dokumente abgelegt werden sollen.
Sie können Variablen in der Angabe für das Zielverzeichnis verwenden.

Weitere Informationen: Variablenersetzung für Zielverzeichnis und Dateinamen definieren
Falls noch kein Zielverzeichnis vorhanden ist und Sie es mithilfe des Adapters angelegen möchten, wählen Sie Zielverzeichnisanlegen.
Ist das Kennzeichen nicht gesetzt und das Zielverzeichnis existiert nicht, dann meldet der Adapter einen Fehler.
Geben Sie das Dateinamenschema an, unter dem das erste eingehende Dokument abgelegt werden soll.
Sie können Variablen für das Dateinamenschema eingeben.

Weitere Informationen: Variablenersetzung für Zielverzeichnis und Dateinamen definieren

Verarbeitungsparameter definieren

Wählen Sie die Registerkarte Verarbeitung.
Wählen Sie den Dateierzeugungsmodus.
- Anlegen
  Die Datei wird erstellt. Das jeweils zuletzt erhaltene Dokument wird gesichert.
  
  Wenn die angelegte Datei überschrieben werden soll, setzen Sie das Kennzeichen Bestehende Datei überschreiben. Setzen Sie das Kennzeichen nicht, dann stoppt die Verarbeitung, bis die erstellte Datei verarbeitet ist.
- Anhängen
  Die Datei wird durch Anhängen der eingehenden Dokumente fortgeschrieben.
- Zeitstempel hinzufügen
  Für jedes Dokument wird eine neue Datei angelegt. Der Dateiname wird mit einem Zeitstempel im Format yyyyMMdd-HHmmss-SSS versehen. Der Zeitstempel wird als letzter Bestandteil des Namens vor der Erweiterung eingefügt.
  
  Dieser Modus garantiert, dass keine Datei überschrieben wird. Dateien, die aus der gleichen Adapterkonfiguration stammen, können so sortiert werden.
- Message-ID hinzufügen
  Für jedes Dokument wird eine neue Datei angelegt. Der Dateiname wird um die vom Integration Server/vom PCK erzeugte Message-ID erweitert. Die ID hat folgendes Format: xxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  
  Die Message-ID wird als letzter Bestandteil des Namens vor der Erweiterung eingefügt. Dieser Modus garantiert, dass keine Datei überschrieben wird.
- Zähler hinzufügen
  Für jedes Dokument wird eine neue Datei angelegt. Der Dateiname wird um einen Zähler erweitert, der vor der Erweiterung des Dateinamens eingefügt wird (beispielsweise default002.file).
  
  Machen Sie unten Angaben zur Zählerdefinition:
  - Präfix
    Geben Sie ein oder mehrere Zeichen an, die vor dem Zähler in den Dateinamen eingefügt werden.
  - Format
    Geben Sie den ersten Zähler an, der verwendet werden soll. Es muss sich um eine gültige Integer-Zahl handeln. Führende Nullen sind erlaubt.
  - Schritt
    Geben Sie die Schrittweite des Zählers an.
  - Modus
    Geben Sie an, wann der Zähler eingefügt werden soll.
    
    Wählen Sie Nach der ersten Datei , wird der Zähler angefügt, wenn der Dateiname erstmals unverändert verwendet wurde.
    
    Wählen Sie Sofort , wird der Zähler beim ersten eingehenden Dokument angefügt.
    
    Hinweis
    Diese Option ist nur verfügbar, wenn Sie für das Transportprotokoll File System ( NFS )wählen
Geben Sie unter Schreibmodus an, ob die Zieldatei Direkt in das angegebene Verzeichnis geschrieben werden soll.
- Wenn ein zusätzlicher Schritt über eine temporäre Datei eingefügt werden soll, wählen Sie Temporäre Datei verwenden .
- Sie können für die temporäre Datei unter Temporäres Dateinamenschema ein Namensschema angeben.
  Aus diesem Schema werden das Präfix und die Erweiterung der Temporärdatei ermittelt, die bei der Verarbeitung noch um einen Zeitstempel ergänzt werden, um einen eindeutigen Dateinamen zu garantieren.
  
  Tipp
  Aus dem Schema xitemp.tmp wird dann der Dateiname xitemp<zeitstempel>.tmp.
Der Schreibmodus steht für Dateierzeugungsmodus
```
Anhängen
```
nicht zur Verfügung.
Wählen Sie Behandlung leerer Messages:
- Leere Datei schreiben
  Es wird eine leere Datei (Länge 0 Byte) in das Zielverzeichnis gestellt.
- Ignorieren
  Es wird keine Datei in das Zielverzeichnis gestellt.
Geben Sie unter Maximale Parallelitätein, wie viele Messages der Adapter auf einem Cluster-Knoten gleichzeitig parallel verarbeiten soll.
Geben Sie den Dateityp des Dokuments an.
- Binär
- Text
  Geben Sie unter Dateikodierungeine Codepage an.
  
  Standardmäßig wird hier die System-Codepage verwendet, die von der Konfiguration des installierten Betriebssystems abhängig ist. Der Inhalt der Message wird dann vor dem Abspeichern als Datei in die entsprechende Codepage umgewandelt.
  
  Sie sollten diese Konvertierung nur bei reinen Textdateien und nicht bei XML-Dokumenten anwenden. Wenn Sie die Kodierung eines XML-Dokuments ändern möchten, wählen Sie den Dateityp Binär und wenden Sie im Register Modul als zusätzliches Modul XMLAnonymizerBean an.
  
  Erlaubte Werte für die Codepage sind die vorhandenen Zeichensätze der Java-Laufzeit. Nach der Spezifikation von SUN für die Java-Laufzeit müssen mindestens die folgenden Standardzeichensätze unterstützt werden:
  - US-ASCII
    Sieben-Bit ASCII, auch bekannt als ISO646-US, oder Basic-Latin-Block des Unicode-Zeichensatzes
  - ISO-8859-1
    ISO-Zeichensatz für westeuropäische Schriften (Latin Alphabet Nr. 1), auch bekannt als ISO-LATIN-1
  - UTF-8
  - UTF-16BE
    16-Bit Unicode-Zeichendarstellung, Big-Endian-Bytereihenfolge
  - UTF-16LE
    16-Bit Unicode-Zeichendarstellung, Little-Endian-Bytereihenfolge
  - UTF-16
  Überprüfen Sie in der Dokumentation für Ihre Java-Laufzeitimplementierung, welche weiteren Zeichensätze unterstützt werden.

Betriebssystembefehle definieren

Geben Sie Betriebssystembefehle an, die vor oder nach der Message-Verarbeitung ausgeführt werden sollen.
Weitere Informationen: Betriebssystembefehle vor/nach Message-Verarbeitung definieren

Parameter zur Inhaltskonvertierung definieren

Haben Sie das Message-Protokoll Umwandlung des Datei-Inhalts ausgewählt, dann können Sie ein XML-Dokument in eine Textdatei konvertieren.
Wählen Sie die Registerkarte Inhaltskonvertierung.

Weitere Informationen: XML im File-/FTP-Empfänger-Adapter in Textformat umwandeln

Variablenersetzung für Zielverzeichnis/Dateinamenschema definieren

Wählen Sie die Registerkarte Erweitert.
Weitere Informationen: Variablenersetzung für Zielverzeichnis und Dateinamen definieren

Adapterspezifische Message-Attribute definieren

Eine konfigurierte Variablenersetzung (siehe oben) wird nach der Übernahme der Attribute aus dem Message-Header durchgeführt.

Um Adapterattribute im Message-Header der PI-Message auszuwerten, setzen Sie das Kennzeichen Adapterspezifische Attribute verwenden.
Wenn das Fehlen von Message-Attributen zu Fehlermeldungen führen soll, wählen Sie Fehlerausgabe beim Fehlen adapterspezifischer Message-Attribute.
Ist das Kennzeichen gesetzt und in der Message fehlt der Header für adapterspezifische Message-Attribute oder eines der gesetzten Attribute, dann führt dies im asynchronen Fall zu einer Delivery Exception im Audit-Log der Message. Im synchronen Fall wird der Sender der Message benachrichtigt.

Setzen Sie das Kennzeichen nicht, und es fehlen Message-Attribute, greift der Adapter auf Informationen aus der Adapterkonfiguration zu.

Um die folgenden Attribute im PI-Message-Header auszuwerten, setzen Sie das jeweilige Kennzeichen:
- Dateiname (technischer Name: FileName )
- Directory (technischer Name: Directory )
- Dateityp(technischer Name: FileType )
- Zeichensatz (technischer Name: FileEncoding )
  Sie können das Kennzeichen nur setzen, wenn der Dateityp als Text angegeben ist und das Kennzeichen für Dateityp oben bereits gesetzt ist.
- Temporäres Namensschema für Name der Zieldatei (technischer Name: TargetTempFileName )
  Sie können das Kennzeichen nur setzen, wenn die Zieldatei über eine temporäre Datei geschrieben wird.
Der Attributnamensraum für den Adapter lautet: http://sap.com/xi/XI/System/File.

Adapterstatus definieren

Setzen Sie den Adapter auf Aktiv , um ihn für den Message-Austausch einzusetzen.

Zusätzliche Parameter im erweiterten Modus definieren

Um zusätzliche Parameter für die Adapterkonfiguration anzugeben, setzen Sie das Kennzeichen Erweiterter Modus.
Geben Sie die zusätzlichen Parameternamen und -werte in der Tabelle an.
Hinweis
Zusätzliche Parameter werden im SAP-Hinweis 801926 veröffentlicht.