FTP Leseaktivität

Einführung

Eine FTP Leseaktivität liest Daten von einem FTP Endpoint und soll als Quelle verwendet werden, um Daten für einen Operation bereitzustellen oder in einem Script aufgerufen zu werden. Nachdem Sie eine FTP Verbindung konfiguriert haben, können Sie für jede FTP -Verbindung beliebig viele FTP -Aktivitäten konfigurieren.

Erstellen einer FTP Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer FTP Leseaktivität

Führen Sie die folgenden Schritte aus, um eine FTP Leseaktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Schema bereit und legen Sie die Einstellungen fest
• Schritt 2: Überprüfen Sie die Datenschemata

Schritt 1: Geben Sie einen Namen ein, geben Sie ein Schema an und legen Sie die Einstellungen fest

• Name: Geben Sie einen Namen ein, der zur Identifizierung der FTP Leseaktivität verwendet werden soll. Der Name muss für jede FTP Leseaktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

• Antwortschema bereitstellen: Das Schema definiert die Struktur der Daten, die von der FTP Leseaktivität verwendet werden. Ob ein Schema erforderlich ist, hängt davon ab, ob die Aktivität als Quelle einer Transformation verwendet wird (siehe Schemaverwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemata.

• Pfad: Geben Sie einen einzelnen gültigen Pfad ein. Ein Pfad sollte auf ein vorhandenes Verzeichnis auf dem FTP Server verweisen. Beispiel: /inbound.

• Dateien abrufen: Geben Sie den Namen der Datei(en) ein, die Sie aus dem oben eingegebenen Pfad lesen möchten. Dieses Feld kann auch ein Sternchen (*), um es als Platzhalter zu verwenden (z. B. *.dat oder *.*) oder ein Fragezeichen (?) auf genau ein Zeichen passen (zum Beispiel file?.txt). Die Verwendung von Platzhaltern ist unabhängig von der unten beschriebenen Option Regulären Ausdruck verwenden. Wenn Sie Daten im ZIP-Format angeben, die automatisch dekomprimiert und gelesen werden sollen, beachten Sie die unten beschriebenen Komprimierungsoptionen.

  Tipp

  Wenn Ihnen bekannte Dateien fehlen oder wenn den Namen von Dateien nach dem Abrufen vom Endpoint zusätzliche Informationen angehängt sind, setzen Sie Jitterbit.source.FTP.enable_regex_parser Zu true davorlegende einer FTP Leseaktivität.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • Dateifilteroptionen: Diese Optionen beeinflussen, wie die oben im Feld Dateien abrufen eingegebene Eingabe interpretiert wird:

    • Groß-/Kleinschreibung ignorieren Aktivieren Sie dieses Kontrollkästchen, wenn Sie im Feld Dateien abrufen oben Eingaben gemacht haben, bei denen die Groß-/Kleinschreibung nicht berücksichtigt werden soll.

    • Regulären Ausdruck verwenden: Aktivieren Sie dieses Kontrollkästchen, wenn Sie im Feld Dateien abrufen oben eine Eingabe gemacht haben, die als regulärer Ausdruck interpretiert werden soll. Diese Option ist unabhängig von der Verwendung von Platzhaltern, die oben unter Dateien abrufen beschrieben wird.

  • Nur Dateinamen auflisten: Aktivieren Sie dieses Kontrollkästchen, wenn Sie nur Dateinamen auflisten möchten (mit dem FTP Befehl NLST statt LIST). Versuchen Sie dies, wenn Harmony die vom FTP Server zurückgesendete FTP Verzeichnisliste nicht analysieren kann.

    Tipp

    Wenn Ihnen bekannte Dateien fehlen oder wenn den Namen von Dateien nach dem Abrufen vom Endpoint zusätzliche Informationen angehängt sind, setzen Sie Jitterbit.source.FTP.enable_regex_parser Zu true davorlegende einer FTP Leseaktivität.

  • Zeichenkodierung: Geben Sie die Zeichenkodierung an, um eine bestimmte Zeichenkodierung für die Quelldatei zu definieren. Wenn Sie das Feld leer lassen, versucht Harmony, die Kodierung zu erkennen. Wenn Sie die Standardeinstellung überschreiben möchten, können Sie aus den unter Unterstützte Zeichenkodierungen aufgeführten Kodierungstypen wählen.

  • Erfolgs-/Fehlerordner: Diese Optionen werden verwendet, um eine Kopie aller verarbeiteten Dateien zu archivieren. Dies kann anstelle der Option Nach der Verarbeitung zum Umbenennen der Datei in der Dateiquelle verwendet werden, damit Sie an einen separaten Speicherort schreiben können, anstatt in einen Unterordner am selben Speicherort.

    • Erfolgsordner verwenden: Aktivieren Sie dieses Kontrollkästchen, um nach erfolgreicher Verarbeitung auf dem primären Zielpfad eine Datei in den angegebenen Ordner zu schreiben. Wenn eine Datei in mehrere Pfade geschrieben wird, ist der Operation nur dann erfolgreich, wenn alle Pfade erfolgreich sind. Wenn dieses Kontrollkästchen aktiviert ist, geben Sie auch den Erfolgsordner im absoluten Pfad auf dem privaten Agent-Computer an.

    • Fehlerordner verwenden: Aktivieren Sie dieses Kontrollkästchen, um nach erfolgloser Verarbeitung eine Datei in den angegebenen Ordner zu schreiben. Wenn mindestens ein Pfad erfolglos ist, wird die Datei in diesen Ordner geschrieben. Wenn dieses Kontrollkästchen aktiviert ist, geben Sie auch den Fehlerordner im absoluten Pfad auf dem privaten Agent-Computer an.

      Vorsicht

      Eine Datei wird nur geschrieben, wenn der Fehler auf Fehler bei der Verarbeitung der FTP Leseaktivität zurückzuführen ist. Eine Datei wird nicht geschrieben, wenn beispielsweise die FTP -Verbindung nicht erfolgreich ist und dadurch der gesamte Operation fehlschlägt.

    Wichtig

    Absolute Pfade für die Erfolgs- und Fehlerordner befinden sich auf dem privaten Agenten, nicht auf dem FTP Server.

    Wenn Sie in diesen Feldern Dateinamen-Schlüsselwörter verwenden, werden die Schlüsselwörter nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkung und Problemumgehung unter Dateinamen-Schlüsselwörter. Mit Sternchen](*) und andere normalerweise nicht unterstützte Dateinamenzeichen führen zum Fehlschlagen des Operation.

    Die Datei(en) werden wie im Feld Dateien abrufen oben angegeben benannt, mit einem abschließenden Unterstrich und einem Zeitstempel. Wenn sich in diesem Ordner bereits eine Datei mit demselben Namen befindet, werden ein zusätzlicher Unterstrich und ein Zähler hinzugefügt.

    Wenn beispielsweise eine Datei mit dem Namen data.csv erfolgreich verarbeitet wurde, wird eine Kopie mit dem Namen data.csv_2018-01-01_12-00-00-000 könnte in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits von einem vorherigen Lauf existiert, wird eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt werden. Wenn ein Fehlerordner angegeben wird, werden alle fehlgeschlagenen Dateien in eine Datei im Fehlerordner geschrieben.

  • Nach der Verarbeitung: Wenn Sie nach der Verarbeitung der Daten weitere Aktionen ausführen möchten, stehen Ihnen diese Optionen zur Verfügung:

    • Datei löschen: Aktivieren Sie dieses Kontrollkästchen, wenn erfolgreich verarbeitete Dateien gelöscht werden sollen. Wenn diese Option ausgewählt ist, wird die Option Datei umbenennen unten automatisch mit /\delete/\ um anzugeben, dass verarbeitete Dateien gelöscht werden und daher das Umbenennen einer Datei nicht zutrifft. Durch das Löschen von Datei löschen wird auch das Feld Datei umbenennen gelöscht.

    • Datei umbenennen: Geben Sie einen Namen ein, wenn Sie Dateien nach der Verarbeitung umbenennen möchten. Alle Dateinamen-Schlüsselwörter sind verfügbar, um nach der Verarbeitung eindeutige Dateinamen für die Quelldaten zu generieren. Beachten Sie, dass das Feld Datei umbenennen nicht verfügbar ist, wenn oben Datei löschen ausgewählt ist. Darüber hinaus werden durch Umschalten von Datei löschen oben alle im Feld Datei umbenennen eingegebenen Daten gelöscht.

      !!! tip "Tipp" Wenn Sie die Dateiquelle an einem separaten Speicherort auf einem privaten Agenten archivieren möchten, beachten Sie auch die Option Erfolgs-/Fehlerordner bei der FTP Schreibaktivität Konfiguration.

  • Triggerdatei: Nur für die Verwendung mit privaten Agenten verfügbar, bei denen lokale Dateien aktiviert sind, ist eine Triggerdatei eine Datei, die vorhanden sein muss, bevor eine Quelldatei von einer Operation zur Verarbeitung abgerufen wird. Das Vorhandensein einer Triggerdatei zeigt an, dass eine Quelldatei zum Lesen bereit ist und nicht noch von einer vorherigen Operation geschrieben wird.

    • Trigger verwenden: Aktivieren Sie dieses Kontrollkästchen, wenn das System vor der Verarbeitung der Quelldateien nach einer Triggerdatei suchen soll. Beachten Sie bei der Verwendung einer Triggerdatei Folgendes:

      • Der Operation führt eine Abfrage durch und sucht nach der Triggerdatei. Das Abfragezeitintervall ist auf eine Sekunde festgelegt.

      • Die Triggerdatei wird gelöscht, wenn die Verarbeitung beginnt.

      • Wenn die Triggerdatei nicht gefunden wird, versucht der Operation weiter, die Triggerdatei zu finden, bis die Zeit für den Operation abläuft.

      • Durch das Festlegen einer Triggerdatei werden alle Operation oder Script blockiert, die die Quelle verwenden, bis entweder die Bedingung der Triggerdatei erfüllt ist oder der Operation ein Timeout aufweist.

    • Absoluter Dateipfad: Geben Sie den absoluten Dateipfad auf dem privaten Agent-Computer ein, auf dem sich die Triggerdatei befindet. Wählen Sie eine Datei aus, die diese Kriterien erfüllt:

      • Der Dateityp kann beliebig sein und beliebige Inhalte haben; nur das Vorhandensein der Datei definiert das Verhalten der Auslösedatei.

      • Die Verwendung von Platzhaltern ist nicht zulässig.

      • Die Triggerdatei darf nicht dieselbe Datei sein wie eine verarbeitete Quelldatei.

      Hinweis

      Wenn Sie in diesem Feld Dateinamen-Schlüsselwörter verwenden, werden die Schlüsselwörter nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkung und Problemumgehung unter Dateinamen-Schlüsselwörter.

  • Zeilen ignorieren: Wenn die Quelldaten Kopf- und/oder Fußzeilen enthalten, geben Sie in den Feldern Erste und Letzte die Anzahl der zu ignorierenden Zeilen ein.

    Notiz

    Diese Einstellung wird nicht wirksam, wenn eine FTP Leseaktivität von einem Script aus referenziert wird mit der Taste ReadFile oder WriteFile Funktionen.

  • Komprimierung: Wenn die Quelldaten in einem komprimierten Format vorliegen, wählen Sie Die Quelldaten sind komprimiert. Diese Optionen werden verfügbar:

    • Format: Verwenden Sie das Dropdown-Menü, um das Format der komprimierten Daten auszuwählen. Derzeit wird nur das ZIP-Format unterstützt.

    • Passwort: Wenn das Archiv verschlüsselt ist, geben Sie das Passwort ein.

      Notiz

      Harmony unterstützt nur das Lesen aus dem Stammverzeichnis eines verschlüsselten Archivs.

  • Übertragungstyp: Wenn die Dateien ASCII-basiert sind, wählen Sie den Übertragungstyp ASCII. Wählen Sie für alle anderen Dateitypen Binär. Binär ist die Standardeinstellung und funktioniert normalerweise am besten.

• Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

• Datenschema: Falls während der Aktivitätskonfiguration angegeben, wird das Schema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können. Sie können auch Schemata direkt in einer Transformation definieren.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder vom Benutzer bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen aller erforderlichen Variablen, die vom Plugin verwendet werden, finden Sie unter Zu einer Aktivität hinzugefügte Plugins.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie hier, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine FTP Leseaktivität konfiguriert haben, können Sie sie wie unten beschrieben innerhalb eines Operation oder Script verwenden.

Schließen Sie den Operation ab

Nachdem Sie eine FTP Leseaktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine FTP Leseaktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

FTP Leseaktivitäten können mit diesen Operation als Quelle verwendet werden:

• Archivmuster
• Transformation
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle)
• Zwei-Transformationsmuster (nur als erste Quelle)
• Salesforce Massenzielmuster

Andere Muster sind bei FTP Leseaktivitäten nicht gültig. Siehe die Validierungsmuster auf der Operationsgültigkeit Seite.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.

Verwenden von FTP Aktivitäten in Scripts

Auf FTP Leseaktivitäten kann auch in einem Script verwiesen werden zur Verwendung mit Script, die eine sourceId als Parameter, einschließlich dieser:

Jitterbit Script Skriptfunktionen

• ArchiveFile- Base64EncodeFile- DeleteFile- DeleteFiles- DirList- FileList- ReadFile

JavaScript-Jitterbit-Funktionen

• Jitterbit.ReadFile

Weitere Einzelheiten zum Referenzieren von Aktivitäten in Scripts finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.