Schreibaktivität im temporären Speicher

Einführung

Eine Temporary Storage Write-Aktivität schreibt Daten in einen Temporary Storage-Endpoint und soll als Ziel für die Datennutzung in einem Operation oder zum Aufruf in einem Script verwendet werden. Nachdem Sie eine Temporary Storage-Verbindung konfiguriert haben, können Sie für jede Temporary Storage-Verbindung beliebig viele Temporary Storage-Aktivitäten konfigurieren.

Erstellen einer temporären Speicheraktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität 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 Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer Schreibaktivität für den temporären Speicher

Führen Sie die folgenden Schritte aus, um eine Schreibaktivität für den temporären Speicher zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Schema bereit und legen Sie die Einstellungen fest
• Schritt 2: Überprüfen Sie die Datenschemata

Schritt 1: Geben Sie einen Namen ein, geben Sie ein Schema an und legen Sie die Einstellungen fest

• Name: Geben Sie einen Namen ein, der zur Identifizierung der temporären Speicherschreibaktivität verwendet werden soll. Der Name muss für jede temporäre Speicherschreibaktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

• Anforderungsschema bereitstellen: Das Schema definiert die Struktur der Daten, die von der Aktivität „Temporärer Speicher schreiben“ verwendet werden. 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.

• Pfad (optional): Geben Sie den Ordnerpfad ein, in den Sie im temporären Speicherverzeichnis schreiben möchten, oder geben Sie mehrere Pfade durch Kommas getrennt ein (z. B. folder1, folder2). Wenn kein Pfad eingegeben wird, werden die Dateien direkt in den standardmäßigen temporären Speicherordner geschrieben. Um in ein neues oder vorhandenes Unterverzeichnis des temporären Speichers zu schreiben, geben Sie den/die vorhandenen Ordnerpfad(e) im temporären Speicherverzeichnis ein.

  Warnung

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

  Allerdings sind einige Sonderzeichen erlaubt: !, @, #, ^, &, *, (, ), [, ], ', ;. Außerdem entweder ein Schrägstrich / oder ein Backslash \ kann als Pfadtrenner verwendet werden.

  Notiz

  Das von Harmony verwendete temporäre Standardspeicherverzeichnis ist das temporäre Verzeichnis des Operationssystems des Agenten. Normalerweise:

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

  Bei privaten Agenten kann das standardmäßige temporäre Speicherverzeichnis über die Konfigurationsdatei des privaten Agenten geändert werden. Hierzu können Sie unter [OperationEngine] Abschnitt, Satz TemporaryStorageRootDirectory zu einem absoluten Pfad zu einem vorhandenen Verzeichnis.

  Auf Cloud-Agenten kann das standardmäßige temporäre Speicherverzeichnis nicht geändert werden. Da der Pfad jedoch relativ ist, kann dieselbe Datei, wenn sie mit einem bestimmten Pfad in den temporären Speicher geschrieben wurde, unter demselben Pfad aus dem temporären Speicher abgerufen werden, sofern sie innerhalb derselben Operation erstellt wurde. Weitere Erläuterungen finden Sie unter 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 Dateinamen-Schlüsselwörter stehen zur Verfügung, 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, um zusätzliche optionale Einstellungen zu erweitern:

  

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

  • An Datei anhängen Aktivieren Sie dieses Kontrollkästchen, um an eine vorhandene Zieldatei anzuhängen, anstatt sie zu überschreiben.

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

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

    • Standard: Standardzeilenendezeichen 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 den unter Unterstützte Zeichenkodierungen aufgeführten Kodierungstypen wählen.

  • Komprimierung: Aktivieren Sie das Kontrollkästchen für Zieldateien komprimieren, wenn die Zieldaten komprimiert werden sollen. Diese Optionen werden verfügbar:

    • Format: Wählen Sie über das Dropdown-Menü das gewünschte Komprimierungsformat aus. 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. Ein beliebiges der Dateinamen-Schlüsselwörter stehen zur Verfügung, um eindeutige Dateinamen zu generieren. Dateien werden automatisch auf Stammebene in das Archiv geschrieben.

      Tipp

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

    • 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 dem vorhandenen Archiv hinzugefügt. Das Anhängen an eine verschlüsselte ZIP-Datei wird nicht unterstützt.

    • 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

• Datenschema: Falls während der Aktivitätskonfiguration angegeben, wird das Anforderungsdatenschema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Schema später 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 auch Schemata direkt in einer Transformation definieren.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder vom Benutzer 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 aller erforderlichen Variablen, die vom Plugin verwendet werden, finden Sie unter Zu einer Aktivität hinzugefügte Plugins.

• 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 an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Aktivität zum Schreiben in den temporären Speicher konfiguriert haben, können Sie sie wie unten beschrieben in einem Operation oder Script verwenden.

Schließen Sie den Operation ab

Nachdem Sie eine Aktivität zum Schreiben in den temporären Speicher konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine Aktivität „Schreiben in temporären Speicher“ erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

Temporäre Speicherschreibaktivitäten können mit diesen Operation 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 der Verwendung von temporären Speicherschreibaktivitäten nicht gültig. Siehe die Validierungsmuster unter Operationsgültigkeit Seite.

Ein allgemeines Designmuster für die Verwendung von temporärem Speicher finden Sie unter Persistieren von Daten für die spätere Verarbeitung mithilfe von temporärem Speicher (Dieses Muster verwendet Design Studio als Beispiel, aber die gleichen Konzepte können angewendet werden in Integration Studio).

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

Verwenden von temporären Speicheraktivitäten in Scripts

Auf temporäre Speicherschreibaktivitä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.