FTP Write-Aktivität

Einführung

Eine FTP Write-Aktivität, die ihre FTP-Verbindung verwendet, schreibt Daten an einen FTP-Endpunkt und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einer Operation verwendet zu werden oder in einem Skript aufgerufen zu werden.

Erstellen einer FTP Write-Aktivität

Eine Instanz einer FTP Write-Aktivität wird aus einer FTP-Verbindung unter Verwendung des Aktivitätstyps Write erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

• Der Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).

• Der Komponenten-Registerkarte im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Registerkarte).

Konfigurieren einer FTP Write-Aktivität

Befolgen Sie diese Schritte, um eine FTP Write-Aktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Anforderungsschema bereit und spezifizieren Sie Einstellungen

• Schritt 2: Überprüfen Sie die Datenschemas

Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Anforderungsschema bereit und spezifizieren Sie Einstellungen

• Name: Geben Sie einen Namen ein, um die FTP Write-Aktivität zu identifizieren. Der Name muss für jede FTP Write-Aktivität einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• Provide request schema: Das Anforderungsschema definiert die Struktur der Daten, die von der FTP Write-Aktivität verwendet werden. Ob ein Anforderungsschema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird (siehe Schema usage). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe Schemas defined in an activity.

• Path: Geben Sie einen oder mehrere gültige Pfade ein. Ein Pfad sollte auf ein vorhandenes Verzeichnis auf dem FTP-Server zeigen. Zum Beispiel könnte ein einzelner Pfad /outbound sein. Mehrere Pfade können durch Komma-getrennte Werte angegeben werden. Wenn mehrere Pfade angegeben werden, wird dieselbe Datei an mehreren Standorten geschrieben. Ein Beispiel für mehrere Pfade könnte user1\path, user2\path sein.

  Vorsicht

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

• Filename(s): Geben Sie den Namen der Datei(en) ein, die Sie innerhalb der oben eingegebenen Pfade schreiben möchten. Alle Dateinamen-Schlüsselwörter stehen zur Verfügung, um eindeutige Dateinamen zu generieren (zum Beispiel result[date][time].[ext]). Wenn Daten im ZIP-Format angegeben werden, siehe die unten beschriebenen Komprimierungs-Optionen.

• Use FTP Rename: Standardmäßig ausgewählt, ist diese Option für Dateien gedacht, die zunächst einen temporären Dateinamen verwenden, der dann in den endgültigen Namen umbenannt wird. Deaktivieren Sie das Kontrollkästchen, wenn diese Option Probleme verursacht.

• Optional settings: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  

  • Verzeichnisse automatisch erstellen: Lassen Sie dieses Kontrollkästchen aktiviert, um automatisch alle Verzeichnisse zu erstellen, die im Zielpfad noch nicht existieren.

    Warnung

    Es ist ein bekanntes Problem, dass die automatische Erstellung von Verzeichnissen inkonsistent funktioniert. Je nach dem spezifischen FTP-Server kann das Verzeichnis möglicherweise nicht erstellt werden. Wenn diese Option verwendet wird, sollten Sie bestätigen, dass das Verzeichnis vor der Produktion erstellt wurde.

  • Leere Dateien nicht erstellen: Wählen Sie dieses Kontrollkästchen aus, um die Erstellung der Zieldatei zu überspringen, wenn keine Zieldaten vorhanden sind.

  • An Datei anhängen: Wählen Sie dieses Kontrollkästchen aus, um an die vorhandene Zieldatei anzuhängen, anstatt sie zu überschreiben. Beachten Sie, dass SFTP-Verbindungen die Möglichkeit, an Dateien anzuhängen, nicht unterstützen, was eine Einschränkung von SFTP darstellt.

  • Header schreiben: Wählen Sie dieses Kontrollkästchen aus, wenn Sie ein flaches Textziel verwenden und Header (Spalten-/Feldnamen) in die erste Zeile schreiben möchten.

  • Zeilenende-Typ: Geben Sie an, wie Zeilenumbrüche beim Schreiben in ein Ziel geschrieben werden sollen. Beachten Sie, dass die Zeilenende-Zeichen in den Daten selbst nicht konvertiert werden. Die Optionen sind wie folgt:

    • Standard: Standard-Zeilenende-Zeichen für die Plattform, auf der der Agent ausgeführt wird.

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

    • Unix: LF (ASCII 10).

  • Zeichencodierung: Geben Sie die Zeichencodierung an, um eine spezifische Zeichencodierung für die Zieldatei zu definieren. Wenn Sie das Feld leer lassen, versucht Harmony, die Codierung zu erkennen. Wenn Sie die Standardcodierung überschreiben möchten, können Sie aus einer der in Unterstützte Zeichencodierungen aufgeführten Codierungen wä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 Verarbeitung verwendet werden, um die Datei umzubenennen und es Ihnen zu ermöglichen, an einem separaten Ort zu schreiben, anstatt in einen Unterordner am selben Ort.

    • Erfolgsordner verwenden: Wählen Sie dieses Kontrollkästchen aus, um eine Datei nach erfolgreicher Verarbeitung im angegebenen Ordner zu speichern. Wenn eine Datei in mehrere Pfade geschrieben wird, ist die Operation nur dann erfolgreich, wenn alle Pfade erfolgreich sind. Wenn dieses Kontrollkästchen ausgewählt ist, geben Sie auch den Erfolgsordner im absoluten Pfad auf der privaten Agentenmaschine an.

    • Fehlerordner verwenden: Wählen Sie dieses Kontrollkästchen aus, um eine Datei nach erfolgloser Verarbeitung im angegebenen Ordner zu speichern. Wenn mindestens ein Pfad fehlerhaft ist, wird die Datei in diesen Ordner geschrieben. Wenn dieses Kontrollkästchen ausgewählt ist, geben Sie auch den Fehlerordner im absoluten Pfad auf der privaten Agentenmaschine an.

      Vorsicht

      Eine Datei wird nur geschrieben, wenn der Fehler auf Fehler bei der Verarbeitung der FTP-Schreibaktivität zurückzuführen ist, wie z. B. unzureichende Schreibberechtigungen für die Aktivität. Eine Datei wird nicht geschrieben, wenn beispielsweise die FTP-Verbindung fehlschlägt, was dazu führt, dass die 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 der Verwendung von Dateinamen-Schlüsselwörtern in diesen Feldern werden die Schlüsselwörter nicht aufgelöst. Für eine Umgehung siehe Einschränkung und Umgehung unter Dateinamen-Schlüsselwörter. Die Verwendung von Sternchen (*) und anderen typischerweise nicht unterstützten Dateinamenzeichen führt dazu, dass die Operation fehlschlägt.

    Die Datei(en) werden wie im Feld Dateiname(n) oben angegeben benannt, wobei ein nachgestellter Unterstrich und ein Zeitstempel hinzugefügt werden. Wenn bereits eine Datei mit demselben Namen in diesem Ordner vorhanden ist, wird ein zusätzlicher Unterstrich und ein Zähler hinzugefügt.

    Zum Beispiel, wenn eine Datei mit dem Namen data.csv erfolgreich verarbeitet wird, könnte eine Kopie mit dem Namen data.csv_2018-01-01_12-00-00-000 in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits aus einem vorherigen Durchlauf existiert, würde eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt werden. In ähnlicher Weise, wenn ein Fehlerordner angegeben ist, werden alle Dateien, die fehlschlagen, in einer Datei im Fehlerordner geschrieben.

• Kompression: Wählen Sie das Kontrollkästchen für Zieldateien komprimieren aus, wenn die Zieldaten komprimiert werden sollen. Diese Optionen werden verfügbar:

  -   **Format:** Verwenden Sie das Dropdown-Menü, um das gewünschte Komprimierungsformat auszuwählen. Derzeit wird nur das **ZIP**-Format unterstützt.
  
  -   **Dateinamen im Archiv:** Geben Sie den Namen der Zieldatei(en) ein, die im Archiv komprimiert werden sollen. Alle [Dateinamenschlüsselwörter](/de/integration-studio/design/variables/filename-keywords) stehen zur Verfügung, um eindeutige Dateinamen zu generieren. Die Datei(en) werden automatisch im Archiv auf der Root-Ebene geschrieben.
  
      !!! tip "Hinweis"
          Um die Dateinamen im Archiv gleich den in der Ziel definierten Dateinamen zu halten, geben Sie `[file].[ext]` ein.
  
  -   **Modus:** Standardmäßig überschreibt der Modus **Überschreiben** das vorhandene Archiv. Dies ist der einzige verfügbare Modus.
  
  -   **Passwort:** Um das Archiv zu verschlüsseln, geben Sie das gewünschte Passwort ein.
  
  -   **Verschlüsselungsmodus:** Wenn ein Passwort angegeben wird, verwenden Sie das Dropdown-Menü, um zwischen den beiden verfügbaren Verschlüsselungsmodi zu wählen: **AES** und **Standard ZIP**.
  

• Übertragungsart: Wenn die Dateien ASCII-basiert sind, wählen Sie die Radio-Schaltfläche für die Übertragungsart ASCII. Für alle anderen Dateitypen wählen Sie die Übertragungsart Binär. Binär ist die Standardeinstellung und funktioniert normalerweise am besten.

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

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

• Datenschema: Wenn während der Aktivitätskonfiguration bereitgestellt, wird das Anforderungsdatenschema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformations-Mappings erneut angezeigt, wo Sie auf Zielfelder mit Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr abbilden können. Sie können auch Schemas direkt in einer Transformation definieren.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern 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 wählen Sie das Kontrollkästchen neben dem zu verwendenden Plugin aus. Für zusätzliche Anweisungen zur Verwendung von Plugins, einschließlich Details zur Festlegung aller erforderlichen Variablen, die vom Plugin verwendet werden, siehe Plugins, die zu einer Aktivität hinzugefügt wurden.

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

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

• Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine FTP Write-Aktivität konfiguriert haben, können Sie sie innerhalb eines Vorgangs oder Skripts wie unten beschrieben verwenden.

Vorgang abschließen

Nachdem Sie eine FTP Write-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen eines Vorgangs konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Sobald eine FTP Write-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder in den Registerkarten Workflows oder Komponenten sowie auf der Entwurfsgrafik zugänglich. Siehe Aktionsmenü der Aktivität für Details.

FTP Write-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

• Archivmuster
• Skriptmuster
• Transformationsmuster
• Zwei-Ziel-Archivmuster (nur als zweites Ziel)
• Zwei-Ziel-HTTP-Archivmuster (nur als zweites Ziel)
• Zwei-Transformationsmuster (nur als zweites Ziel)
• Salesforce-Bulk-Quellmuster

Andere Muster sind mit FTP Write-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite zur Betriebsgültigkeit.

Wenn Sie bereit sind, implementieren Sie die Operation und führen Sie sie aus, um das Verhalten zu validieren, indem Sie die Betriebsprotokolle überprüfen.

FTP-Aktivitäten in Skripten verwenden

FTP Write-Aktivitäten können auch in einem Skript referenziert werden, um mit Skriptfunktionen verwendet zu werden, die eine targetId als Parameter verwenden, einschließlich dieser:

Jitterbit-Skriptfunktionen

• ArchiveFile
• FlushAllFiles
• FlushFile
• WriteFile

JavaScript Jitterbit-Funktionen

• Jitterbit.WriteFile

Für weitere Details zur Referenzierung von Aktivitäten in Skripten siehe Endpoints in Jitterbit Script oder Endpoints in JavaScript.