Zum Inhalt springen

Temporäre Speicher Leseaktivität in Jitterbit Studio

Einführung

Eine Temporäre Speicher Lese-Aktivität, die ihre Temporäre Speicherverbindung verwendet, liest Daten von einem Temporären Speicher-Endpunkt und ist dazu gedacht, als Quelle zu dienen, um Daten für eine Operation bereitzustellen oder in einem Skript aufgerufen zu werden.

Erstellen einer Temporären Speicher Leseaktivität

Eine Instanz einer Temporären Speicher Lese-Aktivität wird aus einer Temporären Speicherverbindung unter Verwendung ihres Lese-Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfskanvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfskanvas ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Temporäre Speicher Lese-Aktivität kann von diesen Orten bearbeitet werden:

Konfigurieren einer Temporären Speicher Leseaktivität

Befolgen Sie diese Schritte, um eine Temporäre Speicher Lese-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Antwortschema 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 öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunkt-Namen 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: Wird angezeigt, wenn Sie über den aktuellen Endpunkt-Namen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Temporäre Speicherung Lesen-Aktivität zu identifizieren. Der Name muss für jede Temporäre Speicherung Lesen-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Antwortschema bereitstellen: Das Antwortschema definiert die Struktur der Daten, die von der Temporären Speicherung Lesen-Aktivität verwendet werden. Ob ein Antwortschema erforderlich ist, hängt davon ab, ob die Aktivität als Quelle 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.

  • Pfad (optional): Geben Sie den Ordnerpfad(e) innerhalb des temporären Speicherverzeichnisses an, die die Dateien enthalten, die Sie lesen möchten. Wenn kein Pfad eingegeben wird, werden die Dateien aus dem Standard-Ordner für temporäre Speicherung gelesen. Um aus einem vorhandenen Unterverzeichnis der temporären Speicherung zu lesen, geben Sie den Ordnerpfad an, der im temporären Speicherverzeichnis enthalten ist. Mehrere Pfade können durch Komma-getrennte Werte angegeben werden.

    Warnung

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

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

    Hinweis

    Das standardmäßige temporäre Speicherverzeichnis, 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 standardmäßige temporäre Speicherverzeichnis mithilfe der Konfigurationsdatei für private Agents geändert werden. Dazu setzen Sie im Abschnitt [OperationEngine] TemporaryStorageRootDirectory auf einen absoluten Pfad zu einem vorhandenen Verzeichnis.

    Bei Cloud-Agents kann das standardmäßige temporäre Speicherverzeichnis 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 Operation Chain erstellt wurde. Für zusätzliche Erklärungen siehe Wichtige Hinweise unter Temporärer Speicher.

  • Dateien abrufen: Geben Sie den Namen der Datei(en) ein, die Sie aus dem oben eingegebenen Pfad lesen möchten. Dieses Feld kann auch ein Sternchen (*) enthalten, das als Platzhalter verwendet wird (zum Beispiel *.dat oder *.*) oder ein Fragezeichen (?), um genau ein Zeichen zu entsprechen (zum Beispiel file?.txt). Die Verwendung von Platzhaltern ist unabhängig von der Option Regulärer Ausdruck verwenden, die weiter unten beschrieben wird. Wenn Daten im ZIP-Format angegeben werden, die automatisch dekomprimiert und gelesen werden sollen, siehe die unten beschriebenen Komprimierungs-Optionen.

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

    • Dateifilteroptionen: Diese Optionen beeinflussen, wie die Eingabe im Feld Dateien abrufen oben interpretiert wird:

      • Groß-/Kleinschreibung ignorieren: Wählen Sie dieses Kontrollkästchen, wenn Sie eine Eingabe im Feld Dateien abrufen oben eingegeben haben, die als groß-/kleinschreibungsempfindlich interpretiert werden soll.

      • Regulärer Ausdruck verwenden: Wählen Sie dieses Kontrollkästchen, wenn Sie eine Eingabe im Feld Dateien abrufen oben eingegeben haben, die als regulärer Ausdruck interpretiert werden soll.

    • Dateiverarbeitungsreihenfolge: Wählen Sie die Reihenfolge aus, in der die Dateien verarbeitet werden sollen, entweder Dateiname (standardmäßige alphabetische Reihenfolge) oder Älteste zuerst (basierend auf den letzten Änderungszeitstempeln der Dateien).

      Hinweis

      Die Sortierung Älteste zuerst erfordert Agenten Version 12.7 oder höher.

    • Zeichencodierung: Geben Sie die Zeichencodierung an, um eine spezifische Zeichencodierung für die Quelldatei 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.

    • Nach der Verarbeitung: Wenn Sie nach der Verarbeitung der Daten weitere Aktionen durchführen möchten, stehen diese Optionen zur Verfügung:

      • Datei löschen: Wählen Sie dieses Kontrollkästchen, wenn Sie möchten, dass erfolgreich verarbeitete Dateien gelöscht werden. Wenn diese Option ausgewählt ist, wird die Option Datei umbenennen unten automatisch mit /\delete/\ ausgefüllt, um anzuzeigen, dass verarbeitete Dateien gelöscht werden und das Umbenennen einer Datei daher nicht zutrifft. Das Leeren von Datei löschen leert auch das Feld Datei umbenennen.

      • Datei umbenennen: Geben Sie einen Namen ein, wenn Sie Dateien nach der Verarbeitung umbenennen möchten. Alle Dateinamen-Schlüsselwörter stehen zur Verfügung, um eindeutige Dateinamen für die Quelldaten nach der Verarbeitung zu generieren. Beachten Sie, dass das Feld Datei umbenennen nicht verfügbar ist, wenn Datei löschen oben ausgewählt ist. Darüber hinaus wird das Umschalten von Datei löschen oben alle Eingaben im Feld Datei umbenennen löschen.

        Tipp

        Wenn Sie die Quelldatei an einem separaten Ort auf einem privaten Agenten archivieren möchten, sehen Sie sich auch die Option Erfolgsordner/Fehlerordner in der Konfiguration der Temporären Speicher-Schreibaktivität an.

    • Trigger-Datei: Nur verfügbar für die Verwendung mit privaten Agenten, bei denen lokale Dateien aktiviert sind, ist eine Trigger-Datei eine Datei, die vorhanden sein muss, bevor eine Quelldatei von einem Vorgang zum Verarbeiten abgerufen wird. Das Vorhandensein einer Trigger-Datei zeigt an, dass eine Quelldatei bereit ist, gelesen zu werden, und nicht mehr von einem vorherigen Vorgang geschrieben wird.

      • Trigger verwenden: Aktivieren Sie dieses Kontrollkästchen, wenn das System nach einer Trigger-Datei suchen soll, bevor es Quelldateien verarbeitet. Beachten Sie, dass beim Verwenden einer Trigger-Datei:

        • Der Vorgang abfragt, um nach der Trigger-Datei zu suchen. Das Abfrageintervall beträgt fest eine Sekunde.

        • Die Trigger-Datei wird gelöscht, sobald die Verarbeitung beginnt.

        • Wenn die Trigger-Datei nicht gefunden wird, versucht der Vorgang weiterhin, die Trigger-Datei zu finden, bis der Vorgang zeitlich begrenzt ist.

        • Das Festlegen einer Trigger-Datei blockiert jeden Vorgang oder jedes Skript, das die Quelle verwendet, bis entweder die Bedingung für die Trigger-Datei erfüllt ist oder der Vorgang zeitlich begrenzt ist.

      • Absoluter Dateipfad: Geben Sie den absoluten Dateipfad auf dem privaten Agenten-Computer an, auf dem sich die Trigger-Datei befindet. Wählen Sie eine Datei, die diese Kriterien erfüllt:

        • Die Datei kann jeden Typ haben und kann beliebige Inhalte enthalten; nur das Vorhandensein der Datei definiert das Verhalten der Trigger-Datei.

        • Die Verwendung von Platzhaltern ist nicht gestattet.

        • Die Trigger-Datei darf nicht die gleiche Datei wie eine Quelldatei sein, die verarbeitet wird.

        Hinweis

        Wenn Sie in diesem Feld Dateinamen-Schlüsselwörter verwenden, werden die Schlüsselwörter nicht aufgelöst. Für eine Umgehungslösung siehe Einschränkung und Umgehung unter Dateinamen-Schlüsselwörter.

    • Zeilen ignorieren: Wenn es Kopf- und/oder Fußzeilen in den Quelldaten gibt, geben Sie die Anzahl der zu ignorierenden Zeilen in den Feldern Erste und Letzte ein.

      Hinweis

      Diese Einstellung hat keine Wirkung, wenn eine Temporäre Speicherleseaktivität aus einem Skript referenziert wird, die die Funktionen ReadFile oder WriteFile verwendet.

    • Kompression: Wenn die Quelldaten in einem komprimierten Format vorliegen, wählen Sie Die Quelldaten sind komprimiert. Diese Optionen werden verfügbar:

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

      • Passwort: Wenn das Archiv verschlüsselt ist, geben Sie das Passwort ein.

        Hinweis

        Harmony unterstützt das Lesen nur aus dem Stammverzeichnis eines verschlüsselten Archivs.

  • 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 fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

  • Datenschema: Wenn während der Aktivitätskonfiguration bereitgestellt, wird das Antwortdatenschema 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 von erforderlichen 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 fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Temporäre Speicher Lesen-Aktivität konfiguriert haben, können Sie diese innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden.

Operation abschließen

Nachdem Sie eine Temporäre Speicher Lesen-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Werkzeuge 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.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

Temporäre Speicher Lesen-Aktivitäten können als Quelle mit diesen Betriebsmustern verwendet werden:

Andere Muster sind mit den Read-Aktivitäten des Temporären Speichers nicht gültig. Siehe die Validierungsmuster auf der Seite zur Betriebsgültigkeit.

Wenn Sie bereit sind, implementieren Sie den Betrieb und führen Sie ihn aus, um das Verhalten zu validieren, indem Sie die Betriebsprotokolle überprüfen.

Verwendung von Aktivitäten des Temporären Speichers in Skripten

Die Read-Aktivitäten des Temporären Speichers können auch in einem Skript referenziert werden, um mit Skriptfunktionen verwendet zu werden, die eine sourceId als Parameter verwenden, einschließlich dieser:

Jitterbit-Skriptfunktionen

  • ArchiveFile
  • Base64EncodeFile
  • DeleteFile
  • DeleteFiles
  • DirList
  • FileList
  • ReadFile

JavaScript Jitterbit-Funktionen

  • Jitterbit.ReadFile

Für weitere Details zur Referenzierung von Aktivitäten in Skripten siehe Endpoints in Jitterbit Script oder Endpoints in JavaScript.