Show TOC

File-Sender-Adapter konfigurierenLocate this document in the navigation structure

Verwendung

Legen Sie einen File-Sender-Adapter an, wenn Sie Inhalte von Dateien aus einem Dateisystem an den Integration Server oder das PCK versenden wollen. Dabei werden nur Dateien berücksichtigt, die nicht schreibgeschützt sind.

Voraussetzungen
  • Für den definierten Kommunikationskanal kann genau eine Sendervereinbarung existieren.
  • Wenn Sie ein Modul für den Adapter entwickeln und im Modul auf den Dateinamen zugreifen möchten, beachten Sie SAP-Hinweis 819761.
Vorgehensweise
  1. Das Transportprotokoll lautet File System (NFS).
  2. Damit der Inhalt der Datei unverändert zur Integration-Engine oder an das PCK geschickt wird, wählen Sie unter Message-Protokoll 
    Datei
    .

    Soll eine Textdatei mit komplexeren Datenstrukturen, die in ein XML-Dokument zu konvertieren sind, zur Integration-Engine oder an das PCK geschickt werden, wählen Sie Umwandlung des Datei-Inhalts und machen Sie unter Parameter zur Inhaltskonvertierung die notwendigen Angaben zur Konvertierung (siehe unten).

  3. 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
  1. Wählen Sie die Registerkarte Quelle.
  2. Geben Sie das Quellverzeichnis an, in dem sich die zu verarbeitenden Dateien befinden.

    Sie können den Namen absolut angeben oder relativ zum Arbeitsverzeichnis der Adapter Engine. Verwenden Sie auf allen Plattformen (einschließlich Windows) einen Schrägstrich (/), um Verzeichnisnamen gemäß der Java-Spezifikation zu trennen.

  3. Geben Sie den Dateinamen der Datei an, die verarbeitet werden soll.

    Wenn Sie mehrere Dateien angeben möchten, können Sie im Dateinamen Platzhalter verwenden und Dateinamenmasken angeben. Geben Sie Ausschlussmasken an, durch die Sie bestimmte Dateien von der Auswahl ausschließen. Die Dateien werden immer in aufsteigender alphabetischer Reihenfolge verarbeitet.

    Weitere Informationen: Platzhalter, Dateinamen- und Ausschlussmasken definieren

  4. Wenn Sie zusätzliche Dateien übertragen wollen, die als Attachments in die XI-Message aufgenommen werden, wählen Sie Zusätzliche Datei(en).

    Weitere Informationen: Zusätzliche Dateien im File-Sender-Adapter angeben

Verarbeitungsparameter definieren
  1. Wählen Sie die Registerkarte Verarbeitung.
  2. Geben Sie unter Quality-of-Servicean, wie eine Message durch die Integration Engine / das PCK verarbeitet werden soll:

    Für Quality of Service Exactly Once In Order geben Sie den Queue-Namen ein.

    Weitere Informationen: Quality-of-Service

  3. Machen Sie folgende Angaben zum Poll-Intervall:
    • Poll-Intervall (Sek.): Anzahl der Sekunden, die der Adapter warten soll, wenn keine Dateien zur Verarbeitung gefunden werden.
    • Poll-Intervall (mSek.): Anzahl der Millisekunden, die der Adapter warten soll, wenn keine Dateien zur Verarbeitung gefunden werden.

      Wenn Sie Poll-Intervall (Sek.) auf Null setzen, können Sie kurze, echtzeitnahe Verarbeitungszeiten erreichen.

      Wenn Sie Poll-Intervall (Sek.) und Poll-Intervall (mSek.) auf Null setzen, wird der Adapter einmal aufgerufen.

    • Wiederholungsintervall (Sek.): Anzahl der Sekunden, die der Adapter warten soll, bis eine fehlerhaft verarbeitete Datei erneut verarbeitet wird

      Wird der Wert auf Null gesetzt, so wird der Adapter im Fehlerfall beendet, auch wenn für Poll-Intervall (Sek.) ein Wert größer als Null angegeben ist.

      Wird kein Wert eingegeben, wird der Wert von Poll-Intervall (Sek.) verwendet.

  4. Geben Sie unter Verarbeitungsmodus an, was mit der erfolgreich verarbeiteten Dateien geschehen soll.
    • Archivieren
      • Um dem Dateinamen einen Zeitstempel hinzuzufügen, wählen Sie Zeitstempel hinzufügen.

        Der Zeitstempel hat das Format yyyyMMdd-hhMMss- SSS . Durch den Zeitstempel werden die archivierten Dateien nicht überschrieben und können nach ihrem zeitlichen Eingang sortiert werden.

      • Geben Sie den Namen des Archivverzeichnisses an.
    • Löschen
    • Testen

      Es werden keine Dateien verarbeitet.

      Dieser Modus eignet sich ausschließlich zum Testen von Konfigurationen des File/FTP-Adapters oder der Integration Engine/des PCK. Er ist für den Produktivbetrieb nicht geeignet.

    • Auf schreibgeschützt setzen

      Erfolgreich verarbeitete Dateien erhalten das Attribut schreibgeschützt. Es werden nur beschreibbare Dateien verarbeitet.

  5. Wählen Sie unter Behandlung leerer Dateien, wie leere Dateien (Länge 0 Bytes) behandelt werden sollen:
    • Keine Message erstellen

      Aus leeren Dateien werden keine XI-Messages erzeugt.

      Die Dateien werden der Auswahl unter Verarbeitungsmodus entsprechend verarbeitet.

      Ist der Verarbeitungsmodus beispielsweise Löschen, werden leere Dateien im Quellverzeichnis gelöscht.

    • Leere Dateien verarbeiten

      Es werden XI-Messages mit leerer Main-Payload erzeugt.

      Die Dateien werden der Auswahl unter Verarbeitungsmodus entsprechend verarbeitet.

    • Leere Dateien überspringen

      Aus leeren Dateien werden keine XI-Messages erzeugt.

      Leere Dateien werden übersprungen und bleiben im Quellverzeichnis stehen.

  6. Um Quelldateien, bei deren Verarbeitung es zu einem permanenten Fehler gekommen ist, zu archivieren, wählen Sie Fehlerhafte Quelldateien archivieren.

    Ein permanenter Fehler tritt entweder bei Konvertierung des Dateiinhalts oder in einem Modul im Modulprozessor auf.

    Weitere Informationen: MessageTransformBean im Modul-Prozessor einfügen

    • Geben Sie das Fehlerarchiv-Verzeichnis an.
    • Um der archivierten Datei einen Zeitstempel hinzuzufügen, wählen Sie Zeitstempel hinzufügen.
  7. Um auch Dateien zu übertragen, die durch andere Anwendungen gesperrt sind, wählen Sie Schreibgeschützte Dateien verarbeiten.

    Setzen Sie das Kennzeichen nur, wenn sichergestellt ist, dass dadurch keine Datenverluste auftreten. Das Kennzeichen steht für Verarbeitungsmodus Auf schreibgeschützt setzen nicht zur Verfügung.

  8. Wenn sie bei Angabe des Dateinamens Platzhalter verwendet haben, legen Sie die Verarbeitungsreihenfolge der Dateien fest:
    • Bei Nach Name erfolgt die Verarbeitung alphabetisch nach dem Dateinamen.
    • Bei Nach Datum werden die Dateien nach ihrem Zeitstempel im Dateisystem beginnend bei der ältesten Datei verarbeitet.
  9. Geben Sie den Dateityp des Dokuments als Binär oder Text an.
    Achtung

    XML-Textdokumente enthalten in der Regel ihre eigene Codepage-Beschreibung. Setzen Sie den Dateityp auf Binär.

    Bei Text geben Sie unter Datei-Codierung eine Codepage an. Standardmäßig wird hier die System-Codepage verwendet, die von der Konfiguration des installierten Betriebssystems abhängig ist. Der Dateiinhalt wird dann vor dem Versenden in die Codepage UTF-8 umgewandelt.

    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, Bytereihenfolge
      Hinweis

      Überprüfen Sie in der Dokumentation für Ihre Java-Laufzeitimplementierung, welche weiteren Zeichensätze unterstützt werden.

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

    Weitere Informationen: Betriebssystembefehle vor/nach Message-Verarbeitung definieren

Einstellungen zur Behandlung von Duplikaten definieren
  1. Wenn Sie die Verarbeitung von Message-Duplikaten steuern möchten, wählen Sie Behandlung von Duplikaten aktivieren und führen die folgenden Schritte durch:
    1. Geben Sie in dem Textfeld Alert-Schwellenwert bei Message-Duplikaten einen Wert ein.

      Der Benutzer wird mit einer Alert-Meldung (Warnung) über das Auftreten des ersten Message-Duplikats benachrichtigt und die Verarbeitung solcher Messages wird gestoppt. Der Benutzer wird ebenfalls mit einer Alert-Meldung (Fehler) über das Auftreten von n+1 Message-Duplikaten benachrichtigt.

    2. Wenn Sie nach Überschreiten des Schwellenwerts den Kanal deaktivieren möchten, wählen Sie Kanal bei Schwellenwertüberschreitung deaktivieren.
    3. Das Message-Duplikat wird durch den jüngsten geänderten Zeitstempel der Datei identifiziert.
    4. Dieses Feature erhöht die Robustheit, da die Verarbeitung von Message-Duplikaten vermieden wird. Es ermöglicht eine flexible Schwellenwertkonfiguration und eine Deaktivierung des Kanals (falls der Schwellenwert überschritten wird).
Parameter zur Inhaltskonvertierung definieren
  1. Wählen Sie die Registerkarte Inhaltskonvertierung.
  2. Haben Sie das Message-ProtokollUmwandlung des Datei-Inhalts gewählt, können Sie eine Textdatei mit komplexeren Strukturen in ein XML-Ausgangsformat konvertieren.

    Weitere Informationen: Strukturen mit dem File-/FTP-Sender-Adapter in XML umwandeln

Adapterspezifische Message-Attribute definieren
  1. Wählen Sie die Registerkarte Erweitert.
  2. Um Adapterattribute im Message-Header der XI-Message abzulegen, wählen Sie Adapterspezifische Message-Attribute setzen.

    Um die folgenden Attribute im XI-Message-Header anzuwenden, setzen Sie das entsprechende 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 das Message-Attribut Dateityp oben bereits gesetzt ist.

    • Größe der Quelldatei (technischer Name: SourceFileSize)
    • Zeitstempel der Quelldatei (technischer Name: SourceFileTimeStamp)

    Der Attributnamensraum für den Adapter lautet: http://sap.com/xi/XI/System/File.

Adapterstatus definieren
  1. Setzen Sie den Adapter auf Aktiv, um ihn für den Message-Austausch einzusetzen.
Weitere Parameter definieren

Um zusätzliche Parameter für die Adapterkonfiguration anzugeben, wählen Sie Erweiterter Modus.

  1. Datei aufteilen (EOIO-Verarbeitung großer binärer Dateien)

    Um größere Dateien (beispielsweise mehr als 1 Gigabyte) zu übertragen, können Sie diese Einstellung wählen. Die Datei wird zunächst in kleinere Datenblöcke aufgeteilt. Die Datenblöcke werden dann zur Laufzeit einzeln verarbeitet.

    Sie können die Größe der Datenblöcke konfigurieren (in Megabytes).

    Hinweis

    Wenn Sie diese Option auswählen, können Sie kein Mapping oder andere Inhaltskonvertierungen durchführen.

    Achtung

    Damit Sie diese Funktion aktivieren können, muss der Quality-of-Service EOIO (in der Registerkarte Verarbeitung) eingestellt sein.

    Die Funktion arbeitet nur korrekt für Service-Interfaces mit dem XI 3.0-kompatiblen Interface-Pattern.

  2. Wartezeit vor Änderungsprüfung in mSek.

    Geben Sie die Anzahl der Millisekunden an, die der Adapter warten soll, bevor er überprüft, ob sich die Dateien geändert haben.

    Dieser Parameter steht nicht zur Verfügung, wenn Sie unter Message-Protokoll Konvertierung des Dateiinhalts gewählt haben und dann unter Recordsets pro Message eine Eingabe gemacht haben, die eine Eingabedatei in mehrere Messages aufteilt.

    Hinweis

    Diese Parameter ist nur für den File-Adapter anwendbar. Wenn Sie bei der Konfiguration des FTP-Adapters einen Wert in dieses Feld eingeben, bleibt dies wirkungslos.

  3. Geben Sie die maximale Dateigröße in Byte ein.

    Der Adapter verarbeitet nur Dateien, die kleiner als die angegebene Größe sind. Für Dateien, die größer sind, gibt er einen Fehler aus.

  4. Geben Sie die zusätzlichen Parameternamen und -werte in der Tabelle an.
    Hinweis

    Zusätzliche Parameter werden im SAP-Hinweis 801926 veröffentlicht.