Zum Inhalt springen

Datei Freigabe Leseaktivität

Einführung

Eine Datei Freigabe Lese-Aktivität, die ihre Datei Freigabe Verbindung verwendet, liest Dateien in einem freigegebenen Netzwerk und ist dazu gedacht, als Quelle Daten für eine Operation bereitzustellen oder in einem Skript aufgerufen zu werden.

Erstellen einer Datei Freigabe Leseaktivität

Eine Instanz einer Datei Freigabe Lese-Aktivität wird aus einer Datei Freigabe Verbindung unter Verwendung des Lese-Aktivitätstyps erstellt.

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

Eine vorhandene Datei Freigabe Lese-Aktivität kann von diesen Orten bearbeitet werden:

Konfigurieren einer Datei Freigabe Leseaktivität

Befolgen Sie diese Schritte, um eine Datei Freigabe 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 Symbol für Variablen 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 Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • 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 einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Provide response schema: 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 usage). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe Schemas defined in an activity.

  • Get files: Geben Sie den Namen der Datei(en) ein, die Sie aus dem im File Share connection 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 Use regular expression. Wenn Daten im ZIP-Format angegeben werden, die automatisch dekomprimiert und gelesen werden sollen, siehe die unten beschriebenen Compression-Optionen.

    Wichtig

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

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

    • File Filter Options: Diese Optionen beeinflussen, wie die Eingabe im obenstehenden Feld Get files interpretiert wird:

      • Ignore Case: Aktivieren Sie dieses Kontrollkästchen, wenn Sie im obenstehenden Feld Get files eine Eingabe gemacht haben, die als nicht groß-/kleinschreibungsempfindlich interpretiert werden soll.

      • Use regular expression: Aktivieren Sie dieses Kontrollkästchen, wenn Sie im obenstehenden Feld Get files eine Eingabe gemacht haben, die als regulärer Ausdruck interpretiert werden soll. Diese Option ist unabhängig von der Verwendung von Platzhaltern, die oben in Get files 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.

  • Nach der Verarbeitung: Wenn Sie nach der Verarbeitung der Daten weitere Aktionen durchführen möchten, stehen Ihnen folgende 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 das Umbenennen einer Datei daher nicht zutrifft. Das Deaktivieren 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 beim Umschalten von Datei löschen oben jede Eingabe im Feld Datei umbenennen gelöscht.

  • Trigger-Datei: Nur für die Verwendung mit privaten Agenten verfügbar, bei denen lokale Dateien aktiviert sind, ist eine Trigger-Datei 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 ist, gelesen zu werden, und nicht mehr von einem vorherigen Vorgang geschrieben wird.

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

      • Der Vorgang fragt ab und sucht nach der Trigger-Datei. 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 abläuft.

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

      • Absoluter Dateipfad: Geben Sie den absoluten Dateipfad auf der privaten Agentenmaschine ein, 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

        Bei der Verwendung von Dateinamen-Schlüsselwörtern in diesem Feld 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 Überschriften 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 File Share 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.

        Hinweis

        Harmony unterstützt nur das Lesen 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.

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

  • Discard Changes: Nachdem Sie Änderungen vorgenommen haben, 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.

Schritt 2: Überprüfen Sie die Datenschemata

  • Data Schema: 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 Transformation Mapping-Prozesses 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.

  • Add plugin(s): 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 aller erforderlichen Variablen, die vom Plugin verwendet werden, siehe Plugins added to an activity.

  • Back: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Finished: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Discard Changes: Nachdem Sie Änderungen vorgenommen haben, 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.

Next steps

Nachdem Sie eine File Share Read-Aktivität konfiguriert haben, können Sie sie innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden.

Schließen Sie den Vorgang

Nach der Konfiguration einer File Share Read-Aktivität vervollständigen Sie die Konfiguration des Vorgangs, indem Sie weitere Aktivitäten oder Tools 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 das Aktivitätsaktionsmenü in Connector-Grundlagen.

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

Andere Muster sind mit File Share Read-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

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

Verwenden Sie File Share-Aktivitäten in Skripten

File Share 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 zum Referenzieren von Aktivitäten in Skripten siehe Endpoints in Jitterbit Script oder Endpoints in JavaScript.