Zum Inhalt springen

File Share Read-Aktivität in Jitterbit Studio

Einführung

Eine File Share Read-Aktivität liest mit ihrer File Share-Verbindung Dateien in einem gemeinsamen Netzwerk und dient als Quelle zur Bereitstellung von Daten für einen Vorgang oder zum Aufrufen in einem Skript.

File Share Read-Aktivität erstellen

Eine Instanz einer File Share Read-Aktivität wird aus einer File Share-Verbindung mit ihrem Read-Aktivitätstyp erstellt.

Um eine Aktivitätsinstanz 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 Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene File Share Read-Aktivität kann von diesen Orten aus bearbeitet werden:

File Share Read-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine File Share Read-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben, Antwortschema bereitstellen und Einstellungen festlegen

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

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

  • Antwortschema bereitstellen: Das Antwortschema definiert die Struktur der Daten, die von der File Share 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-Verwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemas.

  • Dateien abrufen: Geben Sie den Namen der Datei(en) ein, die Sie aus dem in der File Share-Verbindung angegebenen Pfad(en) lesen möchten. Dieses Feld kann auch ein Sternchen (*) als Platzhalter enthalten (z. B. *.dat oder *.*) oder ein Fragezeichen (?) zum Abgleich genau eines Zeichens (z. B. 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, um automatisch dekomprimiert und gelesen zu werden, siehe die unten beschriebenen Komprimierungs-Optionen.

Wichtig

Der File Share Connector hat eine Einschränkung, bei der einzelne Dateien größer als 2 GB möglicherweise nicht abgerufen werden können.

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

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

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

      • Regulären Ausdruck verwenden: Aktivieren Sie dieses Kontrollkästchen, 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 unter Dateien abrufen oben beschrieben ist.

    • Dateiverarbeitungsreihenfolge: Wählen Sie die Reihenfolge für die Verarbeitung der Dateien aus, entweder Dateiname (standardmäßig alphabetische Reihenfolge) oder Älteste zuerst (basierend auf den Zeitstempeln der letzten Änderung der Dateien).

      Hinweis

      Die Sortierung Älteste zuerst erfordert Agent-Version 12.7 oder später.

    • Zeichenkodierung: Geben Sie die Zeichenkodierung an, um eine bestimmte Zeichenkodierung für die Quelldatei 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 aufgelisteten Kodierungstypen wählen.

    • Nach der Verarbeitung: Wenn Sie nach der Verarbeitung der Daten weitere Aktionen durchführen möchten, sind diese Optionen verfügbar:

      • Datei löschen: Aktivieren Sie dieses Kontrollkästchen, wenn erfolgreich verarbeitete Dateien gelöscht werden sollen. Wenn diese Option ausgewählt ist, wird das Feld Datei umbenennen unten automatisch mit /\delete/\ gefüllt, um anzuzeigen, dass verarbeitete Dateien gelöscht werden, und daher gilt das Umbenennen einer Datei nicht. Das Löschen 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. Alle Dateinamen-Schlüsselwörter sind verfügbar, 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 löscht das Umschalten von Datei löschen oben alle im Feld Datei umbenennen eingegebenen Eingaben.

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

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

        • Der Vorgang fragt ab und sucht nach der Trigger-Datei. Das Abfrageintervall ist auf eine Sekunde festgelegt.

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

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

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

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

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

        • Die Verwendung von Platzhaltern ist nicht zulässig.

        • Die Trigger-Datei kann nicht dieselbe Datei wie eine zu verarbeitende Quelldatei sein.

        Hinweis

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

  • Zeilen ignorieren: Falls die Quelldaten Header und/oder Footer enthalten, geben Sie die Anzahl der zu ignorierenden Zeilen in den Feldern Erste und Letzte ein.

    !!! note "Hinweis"
    Diese Einstellung hat keine Auswirkung, wenn eine File Share Read-Aktivität [aus einem Skript heraus referenziert wird](#use-file-share-activities-in-scripts) und die Funktionen [`ReadFile`](/de/integration-studio/design/functions/file-functions/#filefunctions-readfile) oder [`WriteFile`](/de/integration-studio/design/functions/file-functions/#filefunctions-writefile) verwendet werden.

    • Komprimierung: Falls die Quelldaten in einem komprimierten Format vorliegen, wählen Sie Die Quelldaten sind komprimiert. Folgende Optionen stehen dann zur Verfügung:

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

      • Passwort: Falls 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 und beenden: 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 zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

  • Datenschema: Falls während der Aktivitätskonfiguration bereitgestellt, wird das Antwortdatenschema angezeigt. Falls der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationsmapping-Prozesses erneut angezeigt. Dort können Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen. 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 Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Bereich zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen erforderlicher Variablen, finden Sie unter 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: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer File Share Read-Aktivität können Sie diese wie nachfolgend beschrieben in einem Vorgang oder Skript verwenden.

Vorgang abschließen

Nach der Konfiguration einer File Share Read-Aktivität schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen eines Vorgangs konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

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

File Share Read-Aktivitäten können mit diesen Vorgangsmustern als Quelle verwendet werden:

Andere Muster sind bei File Share Read-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Operation validity.

Wenn alles bereit ist, stellen Sie die Operation bereit, führen Sie sie aus und validieren Sie das Verhalten, indem Sie die operation logs überprüfen.

File Share-Aktivitäten in Skripten verwenden

File Share Read-Aktivitäten können auch in einem script referenziert werden, um sie mit script functions zu verwenden, die einen sourceId als Parameter verwenden, einschließlich dieser:

Jitterbit Script Functions

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

JavaScript Jitterbit Functions

  • Jitterbit.ReadFile

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