Erstelle eine File-Share-Quelle in Jitterbit Design Studio

Einführung

Eine File-Share-Quelle bietet Zugriff auf Ressourcen (Dateien und Ordner) über Microsoft Windows File Share UNC-Pfade.

Voraussetzung

Bevor du die Trigger-Datei-Funktion einer File-Share-Quelle nutzen kannst (siehe Optionen unten), musst du Local File Location auf deinem privaten Jitterbit-Agent aktiviert haben. Weitere Informationen findest du unter Local File Location aktivieren.

Erstelle eine File-Share-Quelle

Du kannst eine neue File-Share-Quelle eigenständig oder innerhalb eines bestehenden Vorgangs erstellen. Weitere Informationen zur Funktionsweise von Quellen in Vorgängen findest du unter Erstelle einen Vorgang.

Erstelle eine neue File-Share-Quelle als eigenständige Quelle

Innerhalb deines Projekts in Jitterbit Design Studio erstellst du eine neue File-Share-Quelle auf eine der folgenden Arten:

• Gehe zu Datei > Neu > Neue Quelle; oder

• Klicke in der Baumstruktur auf der linken Seite mit der rechten Maustaste auf Quellen und wähle Neue Quelle; oder

• Klicke in der oberen Symbolleiste auf das grüne Quellensymbol .

Wähle im Popup File Share als Typ:

Deine neue Quelle wird in einem eigenen Neue Quelle-Tab im rechten Bereich des Fensters angezeigt.

Erstelle eine neue File-Share-Quelle in einem bestehenden Vorgang

Eine Quelle wird normalerweise standardmäßig erstellt, wenn du einen neuen Vorgang erstellst. (Die Ausnahme ist ein Vorgang, der nur aus einem Skript besteht.) Bei einem bestehenden Vorgang kannst du den Typ seiner Quelle wie folgt angeben:

• Doppelklick auf das Quellensymbol; wähle im Popup Neue Quelle erstellen; oder

• Klicke mit der rechten Maustaste auf das Quellensymbol und wähle Neue Quelle erstellen.

Verwende in dem angezeigten Konfigurationsbildschirm das Dropdown-Menü Typ, um File Share auszuwählen, wie oben gezeigt.

Verwende eine bestehende File-Share-Quelle in einem bestehenden Vorgang

Um eine bestehende File-Share-Quelle in einem bestehenden Vorgang mit einer Quelle zu nutzen, kannst du sie auf eine der folgenden Arten festlegen:

• Doppelklick auf das Quellensymbol innerhalb des Vorgangs und wähle im angezeigten Popup die gewünschte File-Share-Quelle aus der Liste; oder

• Klicke mit der rechten Maustaste auf das Quellensymbol innerhalb des Vorgangs, wähle Bestehende Quelle auswählen und wähle im angezeigten Popup die gewünschte File-Share-Quelle aus der Liste; oder

• Ziehe die gewünschte File-Share-Quelle aus der Baumstruktur auf der linken Seite und lege sie auf dem bestehenden Quellensymbol des Vorgangs ab.

Konfiguriere eine File-Share-Quelle

Nach der Erstellung einer File-Share-Quelle wird der Konfigurationsbildschirm in der Hauptansicht von Design Studio geöffnet. Du kannst jederzeit zum Konfigurationsbildschirm zurückkehren, indem du auf das Quellensymbol im Vorgang doppelklickst oder auf die Quelle in der Baumstruktur auf der linken Seite doppelklickst.

Grundkonfiguration

Der Konfigurationsbildschirm wird ähnlich wie in diesem Beispiel angezeigt:

• Name: Gib einen passenden, eindeutigen Namen für die Quelle ein.

• Typ: Verwende das Dropdown-Menü, um File Share auszuwählen, falls nicht bereits angegeben.

• Verbindungsparameter: Gib die Details für deine lokale Dateiverbindung an:

• Pfad(e): Geben Sie den UNC-Dateipfad (Universal Naming Convention) ein, aus dem gelesen werden soll, ohne Dateinamen. Verwenden Sie dieses Format: \\servername\sharename\path\. Beachten Sie außerdem: - UNC-Pfade müssen mit zwei Backslashes \\ beginnen, ein nachgestellter Backslash \ ist optional (z. B. \\dropserver\incoming\po). - Eine IP-Adresse kann anstelle des Servernamens verwendet werden (z. B. \\198.51.100.1\mydir). - Mehrere Pfade auf demselben Server können durch kommagetrennte Werte angegeben werden (z. B. \\myserver\mydir, \\myserver\mydir2). Dies erfordert Agent-Version 12.9 oder später. Dateien werden aus jedem Pfad aggregiert. Wenn derselbe Dateiname in mehreren Pfaden vorhanden ist, wird das Duplikat übersprungen und eine Warnung listet die übersprungenen Dateinamen auf. Wenn jede Datei über alle Pfade hinweg ein Duplikat ist, schlägt der Vorgang fehl.

  !!! important "Wichtig"
      Bei Verwendung einer Cloud-Agent-Gruppe funktionieren UNC-Pfade nur mit einer öffentlichen IP-Adresse anstelle des Servernamens.
  
      Alle Agent-Gruppen unterliegen den Einschränkungen, die durch die zugegriffene Dateifreigabe vorgegeben werden:
  
      -   Sie sind an die Sicherheit und Zugriffskontrolle gebunden, die für den im Quell- oder Ziel für diese bestimmte Dateifreigabe definierten Benutzer festgelegt sind.
      -   Wenn die Dateifreigabe nur eine bestimmte Anzahl von Verbindungen zulässt, ist die Agent-Gruppe an dieses Limit gebunden.
      -   Da die meisten Dateifreigaben nicht zulassen, dass mehrere Benutzer gleichzeitig eine bestimmte Datei ändern, kann die Agent-Gruppe eine Datei nicht ändern, wenn sie von einem anderen Benutzer oder Prozess verwendet wird.
  

  • Anmeldung: Wenn eine Anmeldung (in der Form DomainName\UserName) erforderlich ist, um auf ein freigegebenes Netzlaufwerk zuzugreifen, geben Sie einen gültigen Benutzernamen in das Feld Anmeldung ein.
  • Passwort: Geben Sie ein Passwort ein, das mit der Anmeldung verwendet werden soll, um auf das im Feld Pfad(e) referenzierte freigegebene Netzlaufwerk zuzugreifen.

  • Dateien abrufen: Geben Sie den Namen der Quelldatei(en) ein, die aus dem im Feld Pfad angegebenen Verzeichnis gelesen werden sollen. Dieses Feld kann auch ein Sternchen * als Platzhalter enthalten (z. B. *.txt oder *.*) oder ein Fragezeichen ?, um genau ein Zeichen zu entsprechen (z. B. file?.txt). In diesem Feld können auch Variablen verwendet werden. Wenn eine komprimierte Datei (ZIP) angegeben wird, siehe den Abschnitt „Komprimierung" der zusätzlichen Verbindungsparameter unter Optionen unten. Die komprimierte Datei kann automatisch dekomprimiert und gelesen werden.

    Wichtig

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

  • Filteroptionen: Ermöglicht die Angabe, ob die Dateinamengroßschreibung ignoriert werden soll oder ob die Informationen unter Dateien abrufen als regulärer Ausdruck behandelt werden sollen.

• Verbindung testen: Durch Klicken auf die Schaltfläche wird die Dateifreigabequelle getestet. Der Test schlägt fehl, wenn der Pfad kein gültiger UNC-Pfad ist, der Dateien auf dem Betriebssystem findet, auf dem der Jitterbit-Agent ausgeführt wird.

• Klicken Sie auf die Schaltfläche Speichern in der Hauptsymbolleiste oder der Symbolleiste des Ziels, um die Konfiguration zu speichern.

Optionen

Zusätzliche Verbindungsparameter können angegeben werden, indem Sie auf Optionen am unteren Rand des Abschnitts Verbindungsparameter klicken:

• Zeichenkodierung: Wird verwendet, um eine Zeichenkodierung für die Quelldatei(en) anzugeben. Wenn leer gelassen, versucht Jitterbit, die Kodierung zu erkennen. Um eine andere Kodierung als die Standardkodierung anzugeben, geben Sie eine der unterstützten Kodierungen ein, die unter Zeichenkodierung beschrieben sind.

• Triggerdatei: Verwenden Sie diese Option, um eine Triggerdatei anzugeben, die die Verarbeitung der Quelldatei(en) einleitet. Die Triggerdatei wird gelöscht, wenn die Verarbeitung beginnt.

  • Aktivieren Sie nach Auswahl des Kontrollkästchens Trigger verwenden ein Absoluter Dateipfad zu einer Datei, deren Vorhandensein die Verarbeitung auslöst.
  • Variablen (jedoch keine Platzhalter) können in diesem Feld verwendet werden.
  • Da die Triggerdatei beim Start der Verarbeitung gelöscht wird, kann die Triggerdatei nicht dieselbe Datei sein wie eine zu verarbeitende Quelldatei.
  • Sobald der Vorgang startet, wird der Vorgang abgefragt 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 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 Triggerdateibedingung erfüllt ist oder der Vorgang abläuft.

• Nach der Verarbeitung:

  • Wenn das Kontrollkästchen Datei löschen aktiviert ist, werden die Quelldatei(en) nach der Verarbeitung gelöscht.
  • Wenn ein Wert im Feld „Datei umbenennen" angegeben wird, wird die Datei nach dem bereitgestellten Muster umbenannt. In diesem Feld können Variablen verwendet werden.
  • Es ist nur eines von Löschen oder Umbenennen zulässig. Wenn das Kontrollkästchen Datei löschen aktiviert ist, wird Datei umbenennen deaktiviert und ignoriert. Wenn Datei umbenennen leer ist, wird es ignoriert. Wenn die Standardeinstellung beibehalten wird, findet keine Nachbearbeitung der Quelldateien statt.

• Zeilen ignorieren: Die angegebenen Nummern der ersten und letzten Zeilen, die für jede Datei ignoriert werden sollen. Wenn Kopf- oder Fußzeilen ignoriert werden sollen, geben Sie die Anzahl der Zeilen in die Felder Erste und Letzte ein.

  Hinweis

  Diese Einstellung wird nicht wirksam, wenn auf eine File-Share-Quelle aus einem Skript mit den Funktionen ReadFile oder WriteFile verwiesen wird.

• Komprimierung: Wenn das Kontrollkästchen Die Quelldaten sind komprimiert aktiviert ist, werden Quelldateien im ZIP-Format dekomprimiert. Ein Passwort (für verschlüsselte Archive) kann angegeben werden. Verschlüsselte Archive werden unterstützt, wenn ein Passwort angegeben wird. Es wird nur das Lesen aus dem Stammverzeichnis des Archivs unterstützt.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in folgendem Abschnitt im Design Studio-Leitfaden zur Fehlerbehebung:

• File-Share-Quelle: Einzelne Dateien größer als 2 GB können nicht abgerufen werden