Zum Inhalt springen

FTP -Schreibaktivität

Einführung

Eine FTP Schreib-Aktivität, die ihre FTP Verbindung verwendet, schreibt Daten an einen FTP Endpoint und ist als Ziel für die Nutzung von Daten in einer Operation oder zum Aufruf in einem Script vorgesehen.

Erstellen einer FTP -Schreibaktivität

Eine Instanz einer FTP Schreib-Aktivität wird aus einer FTP Verbindung erstellt mithilfe des Aktivitätstyps Schreiben.

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

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

Konfigurieren einer FTP -Schreibaktivität

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

Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Schema bereit und legen Sie die Einstellungen fest

FTP -Schreibaktivität 1

Tipp

Felder mit einem variablen Symbol Unterstützung bei der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

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

  • Schema bereitstellen: Das Schema definiert die Datenstruktur, die von der FTP -Schreibaktivität verwendet wird. Ob ein Schema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel 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 oder mehrere gültige Pfade ein. Ein Pfad sollte auf ein vorhandenes Verzeichnis auf dem FTP Server verweisen. Ein einzelner Pfad könnte beispielsweise sein: /outboundMehrere Pfade können durch Kommas getrennt angegeben werden. Wenn mehrere Pfade angegeben werden, wird dieselbe Datei an mehrere Speicherorte geschrieben. Ein Beispiel für mehrere Pfade könnte sein: user1\path, user2\path.

    Achtung

    Globale Variablen mit Standardwerten werden in diesem Feld nicht durch Agenten der Version 11.38 und früher ersetzt.

  • Dateiname(n): Geben Sie den Namen der Datei(en) ein, in die Sie innerhalb der oben angegebenen Pfade schreiben möchten. Alle der Dateinamen-Schlüsselwörter stehen zur Verfügung, um eindeutige Dateinamen zu generieren (z. B. result [date][Zeit].[ext]). Wenn Sie Daten im ZIP-Format angeben, beachten Sie die unten beschriebenen Komprimierungsoptionen.

  • FTP Umbenennung verwenden: Diese Option ist standardmäßig aktiviert. Sie ermöglicht es Dateien, zunächst einen temporären Dateinamen zu verwenden, der dann in den endgültigen Namen umbenannt wird. Deaktivieren Sie das Kontrollkästchen, falls diese Option Probleme verursacht.

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

    Optionale Einstellungen für FTP -Schreibaktivität 1

    • Verzeichnisse automatisch erstellen Aktivieren Sie dieses Kontrollkästchen, um alle Verzeichnisse, die im Zielpfad noch nicht vorhanden sind, automatisch zu erstellen.

      Warnung

      Es ist ein Bekanntes Problem, dass die automatische Erstellung von Verzeichnissen inkonsistent funktioniert. Je nach FTP Server kann es vorkommen, dass das Verzeichnis nicht erstellt wird. Wenn Sie diese Option verwenden, sollten Sie vor dem produktiven Einsatz sicherstellen, dass das Verzeichnis erstellt wurde.

    • Keine leeren Dateien erstellen: Aktivieren Sie dieses Kontrollkästchen, um das Erstellen der Zieldatei zu überspringen, wenn keine Zieldaten vorhanden sind.

    • An Datei anhängen Aktivieren Sie dieses Kontrollkästchen, um an eine vorhandene Zieldatei anzuhängen, anstatt sie zu überschreiben. Beachten Sie, dass SFTP-Verbindungen das Anhängen an Dateien nicht unterstützen. Dies stellt eine Einschränkung von SFTP dar.

    • Kopfzeilen schreiben: Aktivieren Sie dieses Kontrollkästchen, wenn Sie ein einfaches Textziel verwenden und Kopfzeilen (Spalten-/Feldnamen) in die erste Zeile schreiben möchten.

    • Zeilenendetyp: Geben Sie an, wie Zeilenumbrüche beim Schreiben in ein Ziel geschrieben werden sollen. Beachten Sie, dass Zeilenendezeichen in den Daten selbst nicht konvertiert werden. Folgende Optionen stehen zur Verfügung:

      • Standard: Standardmäßige Zeilenendezeichen für die Plattform, auf der der Agent ausgeführt wird.

      • Windows: CRLF (ASCII 13 und ASCII 10).

      • Unix: LF (ASCII 10).

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

    • Erfolgs-/Fehlerordner: Nur für die Verwendung mit privaten Agenten verfügbar, bei denen lokale Dateien aktiviert sind, werden diese Optionen 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, um das Schreiben an einen separaten Speicherort statt in einen Unterordner am selben Speicherort zu ermöglichen.

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

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

        Vorsicht

        Eine Datei wird nur geschrieben, wenn der Fehler auf Fehler bei der Verarbeitung der FTP Schreibaktivität zurückzuführen ist, z. B. auf unzureichende Schreibberechtigungen für die Aktivität. Eine Datei wird nicht geschrieben, wenn beispielsweise die FTP -Verbindung fehlschlägt und 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.

      Bei Verwendung von Dateinamen-Schlüsselwörtern in diesen Feldern werden die Schlüsselwörter nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkungen 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 Dateiname(n) oben angegeben benannt, mit einem abschließenden Unterstrich und einem Zeitstempel. Falls sich im 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 konnte in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits aus einem vorherigen Lauf existiert, wird eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt. Analog dazu werden alle fehlerhaften Dateien, wenn ein Fehlerordner angegeben ist, in eine Datei im Fehlerordner geschrieben.

    • Komprimierung: Aktivieren Sie das Kontrollkästchen Zieldateien komprimieren, wenn die Zieldaten komprimiert werden sollen. Folgende Optionen stehen zur Verfügung:

      • Format: Wählen Sie über die Dropdown-Liste das gewünschte Komprimierungsformat aus. Derzeit wird nur das ZIP-Format unterstützt.

      • Dateinamen in Archiv(en): Geben Sie den Namen der zu komprimierenden Zieldatei(en) im Archiv ein. Ein beliebiges der Dateinamen-Schlüsselwörter stehen zur Generierung eindeutiger Dateinamen zur Verfügung. Dateien werden automatisch im Stammverzeichnis des Archivs gespeichert.

        Tipp

        Um die Dateinamen im Archiv mit den im Ziel definierten Dateinamen identisch zu halten, geben Sie Folgendes ein: [file].[ext].

      • Modus: Standardmäßig überschreibt der Modus Überschreiben das vorhandene Archiv. Dies ist der einzige verfügbare Modus.

      • Passwort: Geben Sie zum verschlüsseln des Archivs das gewünschte Passwort ein.

      • Verschlüsselungsmodus: Wenn ein Passwort angegeben wird, verwenden Sie das Dropdown-Menü, um zwischen den beiden verfügbaren Verschlüsselung auszuwählen: AES und Standard-ZIP.

    • Übertragungstyp: Wenn die Dateien ASCII-basiert sind, wählen Sie das Optionsfeld ASCII. Für alle anderen Dateitypen wählen Sie den Übertragungstyp Binär. Binär ist die Standardeinstellung und funktioniert in der Regel 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 auf, um die Konfiguration zu schließen, ohne die Änderungen in einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Schritt 2: Überprüfen der Datenschemata

FTP -Schreibaktivität 2

  • Datenschema: Sofern 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 Schemata auch direkt in einer Transformation definieren.

  • Plugin(s) hinzufügen: Plugins sind Jitterbit- oder benutzerdefiniert bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie auf diesen Abschnitt, um ihn 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 vom Plugin verwendeten Variablen, finden Sie unter Plugins, die einer Aktivität hinzugefügt werden.

  • 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 Änderungen an den Schritten zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Nächste Schritte

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

Schließen Sie den Operation

Nachdem Sie eine FTP Schreib-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge im selben oder in verschiedenen Workflows miteinander zu verketten.

Sobald eine FTP Schreib-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich auf den Registerkarten Workflows oder Komponenten sowie auf der Design-Canvas zugänglich. Siehe Aktionsmenü“ für weitere Details.

FTP -Schreib-Aktivitäten können mit diesen Operation als Ziel verwendet werden:

Andere Muster sind bei FTP -Schreibaktivitäten nicht gültig. Die Validierungsmuster finden Sie unter Operation Validity 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 -Schreib-Aktivitäten kann auch in einem Script verwiesen werden zur Verwendung mit Script, die eine targetId als Parameter, einschließlich dieser:

Jitterbit Script Skriptfunktionen

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

JavaScript-Jitterbit-Funktionen

  • Jitterbit.WriteFile

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