Temporäre Speicher Schreibaktivität in Jitterbit Studio

Einführung

Eine Temporäre Speicher Schreibaktivität, die ihre Temporäre Speicherverbindung verwendet, schreibt Daten an einen Temporären Speicherendpunkt und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einer Operation oder zum Aufrufen in einem Skript verwendet zu werden.

Erstellen einer Temporären Speicher Schreibaktivität

Eine Instanz einer Temporären Speicher Schreibaktivität wird aus einer Temporären Speicherverbindung unter Verwendung des Schreibaktivitä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 Temporäre Speicher Schreibaktivitä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 Komponentenregisterkarte).

Konfigurieren einer Temporären Speicher Schreibaktivität

Befolgen Sie diese Schritte, um eine Temporäre Speicher Schreibaktivität zu konfigurieren:

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

• Schritt 2: Überprüfen der Datenschemas

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

• Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 Ä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 Temporary Storage Write-Aktivität zu identifizieren. Der Name muss für jede Temporary Storage Write-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• Anfrageschema bereitstellen: Das Anfrageschema definiert die Struktur der Daten, die von der Temporary Storage Write-Aktivität verwendet werden. Ob ein Anfrageschema 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 Schemas, die in einer Aktivität definiert sind.

• Pfad (optional): Geben Sie den Ordnerpfad ein, in den Sie innerhalb des temporären Speicherverzeichnisses schreiben möchten, oder geben Sie mehrere Pfade durch ein Komma getrennt ein (zum Beispiel folder1, folder2). Wenn kein Pfad eingegeben wird, werden die Dateien direkt im Standard-Temporärspeicherordner geschrieben. Um in ein neues oder vorhandenes temporäres Speicherunterverzeichnis zu schreiben, geben Sie die vorhandenen Ordnerpfad(e) an, die sich im temporären Speicherverzeichnis befinden.

  Warnung

  Diese Sonderzeichen dürfen in Dateipfaden nicht verwendet werden: ~, %, $, ", <, >, :, ?.

  Einige Sonderzeichen sind jedoch erlaubt: !, @, #, ^, &, *, (, ), [, ], ', ;. Darüber hinaus kann entweder ein Vorwärtsschrägstrich / oder ein Rückwärtsschrägstrich \ als Pfadtrennzeichen verwendet werden.

  Hinweis

  Das Standard-Temporärspeicherverzeichnis, das von Harmony verwendet wird, ist das temporäre Verzeichnis des Betriebssystems des Agents. Typischerweise:

  • Windows: C:\Windows\Temp\jitterbit\TemporaryStorage
  • Linux: /tmp/jitterbit/TemporaryStorage

  Bei privaten Agents kann das Standard-Temporärspeicherverzeichnis über die Konfigurationsdatei des privaten Agents geändert werden. Dazu setzen Sie im Abschnitt [OperationEngine] TemporaryStorageRootDirectory auf einen absoluten Pfad zu einem vorhandenen Verzeichnis.

  Bei Cloud-Agents kann das Standard-Temporärspeicherverzeichnis nicht geändert werden. Da der Pfad jedoch relativ ist, kann eine Datei, die mit einem bestimmten Pfad in den temporären Speicher geschrieben wurde, mit demselben Pfad abgerufen werden, wenn sie innerhalb derselben Operationenkette erstellt wurde. Für zusätzliche Erklärungen siehe Wichtige Hinweise unter Temporärer Speicher.

• Dateiname(n): Geben Sie den Namen der Datei(en) ein, in die Sie innerhalb der oben eingegebenen Pfade schreiben möchten. Alle Dateinamenschlü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 Komprimierungsoptionen.

• Optionale Einstellungen: Klicken Sie hier, um zusätzliche optionale Einstellungen zu erweitern.

  • Keine leeren Dateien 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.

  • Kopfzeilen schreiben: Wählen Sie dieses Kontrollkästchen aus, 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).

  • 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 den in Unterstützte Zeichencodierungen aufgeführten Codierungstypen wählen.

  • Kompression: Wählen Sie das Kontrollkästchen für Zieldateien komprimieren aus, wenn Sie möchten, dass die Zieldaten komprimiert werden. 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 in Archiv(en): Geben Sie den Namen der Zieldatei(en) an, die innerhalb des Archivs komprimiert werden sollen. Alle Dateinamen-Schlüsselwörter stehen zur Verfügung, 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 in der Zieldatei definierten Dateinamen zu halten, geben Sie [file].[ext] ein.

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

      • Überschreiben: Überschreibt das vorhandene Archiv.
      • Anhängen: Wenn das Archiv nicht verschlüsselt ist, werden komprimierte Dateien zum vorhandenen Archiv hinzugefügt. 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 an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Write-Aktivität für den temporären Speicher konfiguriert haben, können Sie diese innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden.

Operation abschließen

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

Sobald eine Write-Aktivität für den temporären Speicher erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder im Tab Workflows oder im Tab Komponenten sowie auf der Entwurfsgrafik zugänglich. Siehe Aktivitätsaktionsmenü für Details.

Write-Aktivitäten für den temporären Speicher können als Ziel mit diesen Betriebsmustern 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-Quellenmuster

Andere Muster sind mit den Write-Aktivitäten des temporären Speichers nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

Ein gängiges Entwurfsmuster zur Verwendung des temporären Speichers wird in Daten für die spätere Verarbeitung im temporären Speicher speichern bereitgestellt (Dieses Muster verwendet Design Studio als Beispiel, aber die gleichen Konzepte können im Studio angewendet werden).

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

Verwenden Sie Aktivitäten des temporären Speichers in Skripten

Die Write-Aktivitäten des temporären Speichers 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 Endpunkte in Jitterbit Script oder Endpunkte in JavaScript.