Dateifreigabe-Schreibaktivität
Einführung
Eine Dateifreigabe-Schreib-Aktivität unter Verwendung ihrer Dateifreigabe-Verbindung, schreibt Daten in ein gemeinsam genutztes Netzwerk und ist als Ziel zum Verbrauchen von Daten in einer Operation oder zum Aufrufen in einem Script vorgesehen.
Erstellen einer File Share Write-Aktivität
Eine Instanz der Dateifreigabe-Schreib-Aktivität wird aus einer Dateifreigabe-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 File Share-Schreib-Aktivität kann von diesen Orten aus bearbeitet werden:
-
Die Design-Canvas (siehe Aktionsmenü in Design-Leinwand).
-
Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Konfigurieren einer File Share-Schreibaktivität
Führen Sie die folgenden Schritte aus, um eine Schreib-Aktivität für die Dateifreigabe zu konfigurieren:
Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Schema bereit und legen Sie die Einstellungen fest
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 [
Geben Sie in das Feld ein oder klicken Sie auf das Variablensymbol, um eine Liste der verfügbaren Variablen anzuzeigen.
-
Name: Geben Sie einen Namen für die Dateifreigabe-Schreibaktivität ein. Der Name muss für jede Dateifreigabe-Schreibaktivität eindeutig sein und darf keine Schrägstriche enthalten (
/
) oder Doppelpunkte (:
). -
Schema bereitstellen: Das Schema definiert die Datenstruktur, die von der File Share Write-Aktivitä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.
-
Dateiname(n): Geben Sie den Namen der Datei(en) ein, in die Sie innerhalb der unter Dateifreigabeverbindung angegebenen Pfade schreiben möchten. Alle der Dateinamen-Schlüsselwörter können verwendet werden, um eindeutige Dateinamen zu generieren (z. B.
result [date][Zeit].[ext]
). Wenn Sie Daten im ZIP-Format angeben, beachten Sie die unten beschriebenen Komprimierungsoptionen. -
Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:
-
Verzeichnisse automatisch erstellen: Lassen Sie dieses Kontrollkästchen aktiviert, um alle Verzeichnisse automatisch zu erstellen, die im Zielpfad noch nicht vorhanden sind.
-
Keine leeren Dateien erstellen: Aktivieren Sie dieses Kontrollkästchen, um das Erstellen der Zieldatei zu überspringen, wenn keine Zieldaten vorhanden sind.
-
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..
-
Komprimierung: Wenn die Zieldaten komprimiert werden sollen, wählen Sie Zieldateien komprimieren. Folgende Optionen stehen zur Verfügung:
-
Format: Wählen Sie über die Dropdown-Liste das 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.
-
-
-
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
-
Datenschema: Sofern während der Aktivitätskonfiguration angegeben, wird das Schema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata 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 File Share-Schreib-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben innerhalb eines Operation oder Script verwenden.
Schließen Sie den Operation
Nachdem Sie eine File Share-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 Dateifreigabe-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.
Schreib-Aktivitäten für Operation können mit diesen Vorgangsmustern als Ziel verwendet werden:
- Archivmuster
- Script
- Transformation
- Zwei-Ziel-Archivmuster (nur als zweites Ziel)
- HTTP-Archivmuster mit zwei Zielen (nur als zweites Ziel)
- Zwei-Transformationsmuster (nur als zweites Ziel)
- Salesforce-Massenquellenmuster
Andere Muster sind bei File Share Schreib-Aktivitä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 File Share-Aktivitäten in Scripts
Auf File Share 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.