Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Lokale Speicherleseaktivität

Einführung

Eine lokale Speicheraktivität Lesen unter Verwendung ihrer lokalen Speicherverbindung, liest Daten von einem lokalen Endpoint und ist als Quelle zum Bereitstellen von Daten für eine Operation oder zum Aufrufen in einem Script vorgesehen.

Erstellen einer Aktivität „Lokaler Speicher lesen“

Eine Instanz einer Local Storage Read-Aktivität wird aus einer Local Storage-Verbindung erstellt mithilfe des Aktivitätstyps Lesen.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie ihn und fügen Sie ihn dort ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Local Storage Read-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Aktivität „Lokaler Speicher lesen“

Führen Sie die folgenden Schritte aus, um eine Lese-Aktivität im lokalen Speicher zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein, stellen Sie ein Schema bereit und legen Sie die Einstellungen fest

Lokaler Speicher: Leseaktivität 1

Tipp

Felder mit einem variablen Symbol Unterstützung bei der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ Geben Sie in das Feld ein oder klicken Sie auf das Variablensymbol, um eine Liste der verfügbaren Variablen anzuzeigen.

  • Name: Geben Sie einen Namen zur Identifizierung der Local Storage Read-Aktivität ein. Der Name muss für jede Local Storage Read-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Schema bereitstellen: Das Schema definiert die Datenstruktur, die von der Aktivität „Lokaler Speicher lesen“ verwendet wird. Ob ein Schema erforderlich ist, hängt davon ab, ob die Aktivität als Quelle einer Transformation verwendet wird (siehe Schemaverwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemata.

  • Dateien abrufen: Geben Sie den Namen der Datei(en) ein, die Sie aus dem unter [Lokale Speicherverbindung(/de/integration-studio/design/connectors/local-storage/local-storage-connection/) angegebenen Verzeichnis lesen möchten. Dieses Feld kann auch ein Sternchen (*), um es als Platzhalter zu verwenden (zum Beispiel *.dat oder *.*) oder ein Fragezeichen (?) um genau ein Zeichen zu finden (zum Beispiel file?.txt). Die Verwendung von Platzhaltern ist unabhängig von der unten beschriebenen Option Regulären Ausdruck verwenden. Wenn Sie Daten im ZIP-Format angeben, die automatisch dekomprimiert und gelesen werden sollen, beachten Sie die unten beschriebenen Komprimierungsoptionen.

  • Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen anzuzeigen:

    Optionale Einstellungen für Leseaktivität 1 im lokalen Speicher

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

      • Groß-/Kleinschreibung ignorieren: Aktivieren Sie dieses Kontrollkästchen, wenn Sie im obigen Feld Dateien abrufen Eingaben gemacht haben, bei denen die Groß-/Kleinschreibung nicht berücksichtigt werden soll.

      • Regulären Ausdruck verwenden Aktivieren Sie dieses Kontrollkästchen, wenn Sie im obigen Feld Dateien abrufen Eingaben gemacht haben, die als regulärer Ausdruck interpretiert werden sollen. Diese Option ist unabhängig von der Verwendung von Platzhaltern, die oben unter Dateien abrufen beschrieben wird.

    • Zeichenkodierung: Geben Sie die Zeichenkodierung an, um eine bestimmte Zeichenkodierung für die Quelldatei festzulegen. Wenn Sie das Feld leer lassen, versucht Harmony, die Kodierung zu erkennen. Wenn Sie die Standardeinstellung überschreiben möchten, können Sie einen der unter Unterstützte Zeichenkodierungen aufgeführten Kodierungstypen auswählen..

    • Erfolgs-/Fehlerordner: Diese Optionen dienen zum Archivieren einer Kopie aller verarbeiteten Dateien. Sie können diese Option anstelle der Option Nach der Verarbeitung zum Umbenennen der Datei in der Dateiquelle verwenden, um das Schreiben an einen separaten Speicherort statt in einen Unterordner am selben Speicherort zu ermöglichen.

      • Erfolgsordner verwenden: Aktivieren Sie dieses Kontrollkästchen, um eine Datei nach erfolgreicher Verarbeitung im primären Zielpfad in den angegebenen Ordner zu schreiben. Beim Schreiben einer Datei in mehrere Pfade ist der Operation nur erfolgreich, wenn alle Pfade erfolgreich sind. Wenn dieses Kontrollkästchen aktiviert ist, geben Sie auch den Erfolgsordner im absoluten Pfad auf dem privaten Agentencomputer an.

      • Fehlerordner verwenden: Aktivieren Sie dieses Kontrollkästchen, um nach erfolgloser Verarbeitung eine Datei in den angegebenen Ordner zu schreiben. Wenn mindestens ein Pfad fehlschlägt, wird die Datei in diesen Ordner geschrieben. Wenn dieses Kontrollkästchen aktiviert ist, geben Sie auch den Fehlerordner im absoluten Pfad auf dem privaten Agentencomputer an.

        Vorsicht

        Eine Datei wird nur geschrieben, wenn der Fehler auf Fehler bei der Verarbeitung der Aktivität „Lokaler Speicher lesen“ zurückzuführen ist. Eine Datei wird nicht geschrieben, wenn beispielsweise die Verbindung zum lokalen Speicher fehlschlägt und dadurch der gesamte Operation fehlschlägt.

        Hinweis

        Bei Verwendung von Dateinamen-Schlüsselwörtern in diesen Feldern werden diese nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkungen und Problemumgehung unter Dateinamen-Schlüsselwörter.

      Die Datei(en) erhalten den Namen wie im Feld Dateien abrufen oben angegeben, mit einem abschließenden Unterstrich und einem Zeitstempel. Befindet sich in diesem Ordner bereits eine Datei mit demselben Namen, werden ein zusätzlicher Unterstrich und ein Zähler hinzugefügt.

      Beispiel: Wenn eine Datei mit dem Namen data.csv erfolgreich verarbeitet wurde, wird eine Kopie mit dem Namen data.csv_2018-01-01_12-00-00-000 konnte in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits aus einem vorherigen Lauf existiert, wird eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt. Analog dazu werden bei Angabe eines Fehlerordners alle fehlgeschlagenen Dateien in diesen Ordner geschrieben.

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

      • Datei löschen: Aktivieren Sie dieses Kontrollkästchen, wenn erfolgreich verarbeitete Dateien gelöscht werden sollen. Wenn diese Option aktiviert ist, wird die Option Datei umbenennen unten automatisch mit /\delete/\ Um anzuzeigen, dass verarbeitete Dateien gelöscht werden und daher das Umbenennen einer Datei nicht erforderlich ist. Durch das Löschen von Datei löschen wird auch das Feld Datei umbenennen gelöscht.

      • 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 nach der Verarbeitung eindeutige Dateinamen für die Quelldaten zu generieren. Beachten Sie, dass das Feld Datei umbenennen nicht verfügbar ist, wenn oben Datei löschen ausgewählt ist. Darüber hinaus werden durch das Aktivieren von Datei löschen alle Eingaben im Feld Datei umbenennen gelöscht.

    • Triggerdatei: Eine Triggerdatei muss vorhanden sein, bevor eine Quelldatei zur Verarbeitung abgerufen wird. Das Vorhandensein einer Triggerdatei zeigt an, dass die Quelldatei lesbar ist und sich Operation Operation.

      • Trigger verwenden: Aktivieren Sie dieses Kontrollkästchen, wenn das System vor der Verarbeitung der Quelldateien nach einer Triggerdatei suchen soll. Beachten Sie bei der Verwendung einer Triggerdatei:

        • Der Operation führt eine Abfrage durch und sucht nach der Triggerdatei. Das Abfrageintervall ist auf eine Sekunde festgelegt.

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

        • Wenn die Triggerdatei nicht gefunden wird, versucht der Operation so lange, die Triggerdatei zu finden, bis eine Operation eintritt.

        • Durch das Festlegen einer Triggerdatei werden alle Operation oder Script blockiert, die die Quelle verwenden, bis entweder die Bedingung der Triggerdatei erfüllt ist oder der Operation abläuft.

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

        • Die Datei kann von beliebigem Typ sein und beliebige Inhalte enthalten; nur das Vorhandensein der Datei definiert das Verhalten der Auslösedatei.

        • Die Verwendung von Platzhaltern ist nicht zulässig.

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

        Hinweis

        Bei Verwendung von Dateinamen-Schlüsselwörtern in diesem Feld werden diese nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkung und Problemumgehung unter Dateinamen-Schlüsselwörter.

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

      Notiz

      Diese Einstellung wird nicht wirksam, wenn eine Local Storage Read-Aktivität von einem Script referenziert wird mit der Taste ReadFile oder WriteFile Funktionen.

    • Komprimierung: Wenn die Quelldaten komprimiert sind, wählen Sie Die Quelldaten sind komprimiert. Folgende Optionen stehen zur Verfügung:

      • Format: Wählen Sie über die Dropdown-Liste das Format der komprimierten Daten aus. Derzeit wird nur das ZIP-Format unterstützt.

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

        Notiz

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

  • 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 auf, um die Konfiguration zu schließen, ohne die Änderungen in einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Schritt 2: Überprüfen der Datenschemata

Lokaler Speicher: Leseaktivität 2

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

  • Plugin(s) hinzufügen: Plugins sind Jitterbit- oder benutzerdefiniert bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie auf diesen Abschnitt, um ihn 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 vom Plugin verwendeten Variablen, finden Sie unter Plugins, die einer Aktivität hinzugefügt werden.

  • 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 Änderungen an den Schritten zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

Nächste Schritte

Nachdem Sie eine Lese-Aktivität im lokalen Speicher konfiguriert haben, können Sie diese wie unten beschrieben innerhalb einer Operation oder eines Script verwenden.

Schließen Sie den Operation

Nachdem Sie eine Local Storage Read-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge im selben oder in verschiedenen Workflows miteinander zu verketten.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Lese-Aktivitäten im lokalen Speicher können mit diesen Operation als Quelle verwendet werden:

Andere Muster sind bei lokalen Speicher-Lese-Aktivitäten nicht gültig. Die Validierungsmuster finden Sie unter Operation Validity Seite.

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

Verwenden von Local Storage-Aktivitäten in Scripts

Auf Lese-Aktivitäten im lokalen Speicher kann auch in einem Script verwiesen werden zur Verwendung mit Script, die eine sourceId als Parameter, einschließlich dieser:

Jitterbit Script Skriptfunktionen

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

JavaScript-Jitterbit-Funktionen

  • Jitterbit.ReadFile

Weitere Einzelheiten zum Referenzieren von Aktivitäten in Scripts finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.