Zum Inhalt springen

Datei Share Write-Aktivität in Jitterbit Studio

Einführung

Eine Datei Share Write-Aktivität, die ihre Datei Share-Verbindung verwendet, schreibt Daten in einem gemeinsamen Netzwerk und ist dazu gedacht, als Ziel verwendet zu werden, um Daten in einer Operation zu konsumieren oder in einem Skript aufgerufen zu werden.

Erstellen einer Datei Share Write-Aktivität

Eine Instanz einer Datei Share Write-Aktivität wird aus einer Datei Share-Verbindung unter Verwendung ihres Write-Aktivitätstyps 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 Datei Share Write-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Datei Share Write-Aktivität

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

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

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Endpunktmenü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Wechseln des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

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

  • Anforderungs-Schema bereitstellen: Das Anforderungs-Schema definiert die Struktur der Daten, die von der File Share Write-Aktivität verwendet werden. Ob ein Anforderungs-Schema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird (siehe Schema-Nutzung). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe In einer Aktivität definierte Schemata.

  • Dateiname(n): Geben Sie den Namen der Datei(en) ein, die Sie innerhalb der in der File Share-Verbindung angegebenen Pfade schreiben möchten. Jedes der Dateinamenschlüsselwörter kann verwendet werden, um eindeutige Dateinamen zu generieren (zum Beispiel result[date][time].[ext]). Wenn Daten im ZIP-Format angegeben werden, siehe die unten beschriebenen Komprimierungs-Optionen.

  • Optionale Einstellungen: 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.

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

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

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

      • Standard: Standard-Zeilenendzeichen 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 spezifische Zeichenkodierung für die Zieldatei zu definieren. Wenn Sie das Feld leer lassen, versucht Harmony, die Kodierung zu erkennen. Wenn Sie die Standardkodierung überschreiben möchten, können Sie aus den in Unterstützte Zeichenkodierungen aufgeführten Kodierungstypen wählen.

    • Kompression: Wenn Sie möchten, dass die Zieldaten komprimiert werden, wählen Sie Zieldateien komprimieren. Diese Optionen werden verfügbar:

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

      • Dateinamen im Archiv: Geben Sie den Namen der Zieldatei(en) an, die im Archiv komprimiert werden sollen. Alle Dateinamenschlüsselwörter sind verfügbar, um eindeutige Dateinamen zu generieren. Die Datei(en) werden automatisch im Archiv auf der Root-Ebene geschrieben.

        Tipp

        Um die Dateinamen im Archiv gleich den in der Zieldatei 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.

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

  • Next: 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.

  • Discard Changes: 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.

Schritt 2: Überprüfen der Datenschemas

  • Data Schema: Wenn während der Aktivitätskonfiguration bereitgestellt, wird das Anforderungsdaten-Schema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas während des Transformation Mapping Prozesses erneut angezeigt, wo Sie Ziel-Felder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können. Sie können auch Schemas direkt in einer Transformation definieren.

  • Add plugin(s): Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Fähigkeiten 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 added to an activity.

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

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

  • Discard Changes: 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 File Share Write-Aktivität konfiguriert haben, können Sie sie innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden.

Vorgang abschließen

Nach der Konfiguration einer File Share Write-Aktivität vervollständigen Sie die Konfiguration des Vorgangs, indem Sie weitere 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 zu verketten, die sich in denselben oder in unterschiedlichen Workflows befinden.

Sobald eine File Share 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. Weitere Informationen finden Sie im Aktivitätsaktionsmenü.

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

Andere Muster sind bei der Verwendung von File Share Write-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

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

Verwenden von File Share-Aktivitäten in Skripten

File Share 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.