Zum Inhalt springen

Lokale Speicher Schreibaktivität in Jitterbit Studio

Einführung

Eine lokale Speicher Schreib-Aktivität, die ihre Local Storage-Verbindung verwendet, schreibt Daten an einen Local Storage-Endpunkt und ist dafür gedacht, als Ziel in einer Operation verwendet oder in einem Skript aufgerufen zu werden.

Erstellen einer lokalen Speicher Schreibaktivität

Eine Instanz einer lokalen Speicher Schreib-Aktivität wird aus einer Local Storage-Verbindung unter Verwendung des Aktivitätstyps Schreiben 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 lokale Speicher Schreib-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer lokalen Speicher Schreibaktivität

Befolgen Sie diese Schritte, um eine lokale Speicher Schreib-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Anfrage-Schema 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 offene 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 desselben Connector-Typs 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 Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Erscheint, 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 Local Storage Write-Aktivität zu identifizieren. Der Name muss für jede Local Storage 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 Local Storage 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 Local Storage-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.

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

    • An Datei anhängen: Wählen Sie dieses Kontrollkästchen, um an die vorhandene Zieldatei anzuhängen, anstatt sie zu überschreiben.

    • Kopfzeilen schreiben: Wählen Sie dieses Kontrollkästchen, wenn Sie ein flaches Textziel verwenden und Kopfzeilen (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 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.

    • Erfolgs-/Fehlerordner: Diese Optionen werden verwendet, um eine Kopie aller verarbeiteten Dateien zu archivieren. Dies kann anstelle der Option Nach der Verarbeitung zum Datei umbenennen an der Dateiquelle verwendet werden, um zu ermöglichen, dass Sie an einen separaten Speicherort schreiben, anstatt in einen Unterordner im selben Speicherort.

      • Erfolgsordner verwenden: Wählen Sie dieses Kontrollkästchen, um eine Datei nach erfolgreicher Verarbeitung im primären Zielpfad in den angegebenen Ordner zu schreiben. Wenn eine Datei in mehrere Pfade geschrieben wird, ist die Operation nur 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, um eine Datei nach erfolgloser Verarbeitung in den angegebenen Ordner zu schreiben. Wenn mindestens ein Pfad erfolglos 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 Local Storage Write-Aktivität zurückzuführen ist. Eine Datei wird nicht geschrieben, wenn beispielsweise die Verbindung zum Local Storage nicht erfolgreich ist, was dazu führt, dass die gesamte Operation fehlschlägt.

        Hinweis

        Bei der Verwendung von Dateinamen-Schlüsselwörtern in diesen Feldern werden die Schlüsselwörter nicht aufgelöst. Für eine Lösung siehe Einschränkung und Lösung unter Dateinamen-Schlüsselwörter.

      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 eine Datei im Fehlerordner geschrieben.

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

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

      • Dateinamen im Archiv: Geben Sie den Namen der Ziel-Datei(en) an, die innerhalb des Archivs komprimiert werden sollen. Jedes der Dateinamen-Schlüsselwörter kann verwendet werden, um eindeutige Dateinamen zu generieren. Die Datei(en) werden automatisch auf der Root-Ebene in das Archiv geschrieben.

        Tipp

        Um die Dateinamen im Archiv gleich den im Ziel definierten Dateinamen zu halten, geben Sie [file].[ext] ein.

      • Modus: Verwenden Sie das Dropdown-Menü, um aus diesen Modi auszuwählen:

        • Überschreiben: Dieser Modus überschreibt das vorhandene Archiv.

        • Anhängen: Wenn das Archiv nicht verschlüsselt ist, fügt dieser Modus komprimierte Dateien zum vorhandenen Archiv hinzu. Das Anhängen an eine verschlüsselte ZIP-Datei wird nicht unterstützt.

      • 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 beiden verfügbaren Verschlüsselungsmodi: AES und Standard-ZIP auszuwählen.

  • 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 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 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 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 erforderlicher 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Write-Aktivität für den lokalen Speicher konfiguriert haben, können Sie diese in einer Operation oder einem Skript wie unten beschrieben verwenden.

Operation abschließen

Nachdem Sie eine Write-Aktivität für den lokalen Speicher konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Werkzeuge als Schritte der Operation hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen, die sich in denselben oder unterschiedlichen Workflows befinden, miteinander zu verketten.

Sobald eine Write-Aktivität für den lokalen Speicher 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ü für Aktivitäten für Details.

Write-Aktivitäten für den lokalen Speicher können als Ziel mit diesen Betriebsmustern verwendet werden:

Andere Muster sind bei der Verwendung von Write-Aktivitäten für den lokalen Speicher nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

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

Verwendung von Local Storage-Aktivitäten in Skripten

Local Storage Write-Aktivitäten können auch in einem Skript für die Verwendung mit Skriptfunktionen referenziert 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.