Zum Inhalt springen

Lokale Speicher Leseaktivität

Einführung

Eine lokale Speicher Lese-Aktivität, die ihre Local Storage-Verbindung verwendet, liest Daten von einem Local Storage-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 lokalen Speicher Leseaktivität

Eine Instanz einer lokalen Speicher Lese-Aktivität wird aus einer Local Storage-Verbindung unter Verwendung ihres Lese-Aktivitätstyps erstellt.

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

Eine vorhandene lokale Speicher Lese-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer lokalen Speicher Leseaktivität

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

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

Local Storage Read activity 1

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 eine Liste der vorhandenen Variablen anzuzeigen.

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

  • Antwortschema bereitstellen: Das Antwortschema definiert die Struktur der Daten, die von der Local Storage Read-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 Schemas, die in einer Aktivität definiert sind.

  • Dateien abrufen: Geben Sie den Namen der Datei(en) ein, die Sie aus dem im Local Storage-Verbindung angegebenen Verzeichnis 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 unten beschriebenen Option Regulären Ausdruck verwenden. Wenn Daten im ZIP-Format angegeben werden, die automatisch dekomprimiert und gelesen werden sollen, siehe die unten beschriebenen Komprimierungs-Optionen.

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

    Local Storage Read activity 1 optional settings

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

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

      • Regulärer Ausdruck verwenden: Wählen Sie dieses Kontrollkästchen aus, wenn Sie eine Eingabe im Feld Dateien abrufen oben eingegeben haben, die als regulärer Ausdruck interpretiert werden soll. Diese Option ist unabhängig von der Verwendung von Platzhaltern, die im Abschnitt Dateien abrufen beschrieben sind.

    • 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.

    • 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 auf 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 aus, 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 dann 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 aus, 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 Lesen-Aktivität zurückzuführen ist. Eine Datei wird nicht geschrieben, wenn beispielsweise die Verbindung zum Local Storage erfolglos 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 Dateien abrufen 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. In ähnlicher Weise, wenn ein Fehlerordner angegeben ist, werden alle Dateien, die fehlschlagen, in eine Datei im Fehlerordner geschrieben.

    • 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: Aktivieren 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 somit das Umbenennen einer Datei nicht zutrifft. Das Deaktivieren von Datei löschen löscht auch das Feld Datei umbenennen.

      • Datei umbenennen: Geben Sie einen Namen ein, wenn Sie Dateien nach der Verarbeitung umbenennen möchten. Jedes der Dateinamen-Schlüsselwörter kann verwendet werden, 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.

    • Trigger-Datei: Eine Trigger-Datei ist 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: Wählen Sie dieses Kontrollkästchen aus, wenn das System nach einer Triggerdatei suchen soll, bevor es die Quelldateien verarbeitet. Beachten Sie, dass beim Verwenden einer Triggerdatei:

    • Der Vorgang pollt und sucht nach der Triggerdatei. Das Polling-Intervall ist auf eine Sekunde festgelegt.

    • Die Triggerdatei wird gelöscht, sobald die Verarbeitung beginnt.

    • Wenn die Triggerdatei nicht gefunden wird, versucht der Vorgang weiterhin, die Triggerdatei zu finden, bis der Vorgang abläuft.

    • Das Festlegen einer Triggerdatei blockiert jeden Vorgang oder jedes Skript, das die Quelle verwendet, bis entweder die Bedingung für die Triggerdatei erfüllt ist oder der Vorgang abläuft.

  • Absoluter Dateipfad: Geben Sie den absoluten Dateipfad auf der privaten Agentenmaschine an, auf der sich die Triggerdatei befindet. Wählen Sie eine Datei aus, die diese Kriterien erfüllt:

    • Die Datei kann jeden Typ haben und kann beliebige Inhalte enthalten; nur die Anwesenheit der Datei definiert das Verhalten der Triggerdatei.

    • Die Verwendung von Platzhaltern ist nicht gestattet.

    • Die Triggerdatei darf nicht dieselbe Datei wie eine verarbeitete Quelldatei sein.

    Hinweis

    Wenn Sie Dateinamen-Schlüsselwörter in diesem Feld 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 Local Storage Read-Aktivität aus einem Skript referenziert wird, das 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.

    !!! note "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 auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Ä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.

Schritt 2: Überprüfen der Datenschemas

Local Storage Read activity 2

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

Nächste Schritte

Nachdem Sie eine Read-Aktivität für den lokalen Speicher konfiguriert haben, können Sie diese innerhalb eines Vorgangs oder Skripts wie unten beschrieben verwenden.

Vorgang abschließen

Nachdem Sie eine Read-Aktivität für den lokalen Speicher konfiguriert haben, schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen eines Vorgangs konfigurieren, die die Möglichkeit umfassen, Vorgänge 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. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Read-Aktivitäten für den lokalen Speicher können als Quelle mit diesen Vorgangsmustern verwendet werden:

Andere Muster sind für die Verwendung von Local Storage Read-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite zur Betriebsgültigkeit.

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

Verwendung von Local Storage-Aktivitäten in Skripten

Local Storage Read-Aktivitäten 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.