Zum Inhalt springen

File Share Write-Aktivität in Jitterbit Studio

Einführung

Eine File Share Write-Aktivität schreibt mit ihrer File Share-Verbindung Daten in ein gemeinsames Netzwerk und ist dazu bestimmt, als Ziel zum Verarbeiten von Daten in einem Vorgang oder zum Aufrufen in einem Skript verwendet zu werden.

File Share Write-Aktivität erstellen

Eine Instanz einer File Share Write-Aktivität wird aus einer File Share-Verbindung mit dem Aktivitätstyp Write erstellt.

Um eine Aktivitätsinstanz 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 Aktivitäts- oder Tool-Instanz erstellen in Komponenten wiederverwenden.

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

File Share Write-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine File Share Write-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben, Anforderungsschema bereitstellen und Einstellungen festlegen

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration 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.

  • Anforderungsschema bereitstellen: Das Anforderungsschema definiert die Struktur der Daten, die von der File Share 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-Verwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemas.

  • Dateiname(n): Geben Sie den Namen der Datei(en) ein, in die Sie innerhalb der in der File Share-Verbindung angegebenen Pfade schreiben möchten. Es können beliebige Dateinamen-Schlüsselwörter verwendet werden, um eindeutige Dateinamen zu generieren (z. B. 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 alle Verzeichnisse, die im Zielpfad noch nicht vorhanden sind, automatisch zu erstellen.

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

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

    • Zeilenumbruchtyp: Geben Sie an, wie Zeilenumbrüche beim Schreiben in ein Ziel geschrieben werden. Beachten Sie, dass Zeilenumbruchzeichen in den Daten selbst nicht konvertiert werden. Die Optionen sind wie folgt:

      • Standard: Standardmäßige Zeilenumbruchzeichen 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 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 einer der unter Unterstützte Zeichenkodierungen aufgelisteten Kodierungstypen wählen.

    • Komprimierung: Wenn die Zieldaten komprimiert werden sollen, wählen Sie Zieldateien komprimieren. Diese Optionen werden verfügbar:

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

      • Dateinamen in Archiv(en): Geben Sie den Namen der Zieldatei(en) ein, die im Archiv komprimiert werden sollen. Alle Dateinamen-Schlüsselwörter sind verfügbar, um eindeutige Dateinamen zu generieren. Datei(en) werden automatisch auf der Stammebene in das Archiv geschrieben.

        Tipp

        Um die Dateinamen im Archiv gleich wie die im 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 ist, verwenden Sie das Dropdown-Menü, um zwischen den zwei verfügbaren Verschlüsselungsmodi zu wählen: AES und Standard ZIP.

  • 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, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

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

Schritt 2: Datenschemas überprüfen

  • Datenschema: Falls während der Aktivitätskonfiguration bereitgestellt, wird das Anforderungsdatenschema angezeigt. Wenn der Vorgang eine Transformation verwendet, werden die Datenschemas während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen 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 aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen erforderlicher Variablen, die vom Plugin verwendet werden, finden Sie unter 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer File Share Write-Aktivität können Sie diese wie nachfolgend beschrieben in einer Operation oder einem Skript verwenden.

Operation abschließen

Nach der Konfiguration einer File Share Write-Aktivität schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten oder Tools als Operationsschritte hinzufügen und konfigurieren. Sie können auch die Operationseinstellungen einer Operation konfigurieren, die die Möglichkeit bieten, Operationen zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Nach der Erstellung einer File Share Write-Aktivität sind Menüaktionen für diese Aktivität im Projektbereich auf den Registerkarten Workflows oder Komponenten sowie auf der Designoberfläche verfügbar. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü.

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

Andere Muster sind mit File Share Write-Aktivitäten nicht gültig. Weitere Informationen finden Sie unter den Validierungsmustern auf der Seite Operation validity.

Wenn Sie bereit sind, stellen Sie die Operation bereit, führen Sie sie aus und überprüfen Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.

File Share-Aktivitäten in Skripten verwenden

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

Jitterbit Script-Funktionen

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

JavaScript Jitterbit-Funktionen

  • Jitterbit.WriteFile

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