Zum Inhalt springen

SMB-Datei lesen-Aktivität in Jitterbit Studio

Einführung

Eine SMB-Aktivität Datei lesen ruft mit ihrer SMB-Verbindung den Inhalt einer textbasierten Datei von einem SMB-Server ab. Diese Aktivität ist als Quelle in Operationen vorgesehen und unterstützt JSON- und XML-Dateien.

SMB-Aktivität „Datei lesen" erstellen

Eine Instanz einer SMB-Aktivität Datei lesen wird aus einer SMB-Verbindung mit ihrem Aktivitätstyp Datei lesen 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 SMB-Aktivität Datei lesen kann von diesen Orten aus bearbeitet werden:

SMB-Aktivität „Datei lesen" konfigurieren

Führen Sie diese Schritte aus, um eine SMB-Aktivität Datei lesen zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie einen Ordnerpfad und eine Datei fest.

Die Benutzeroberfläche für diesen Schritt hängt davon ab, welche Option Ordner auswählen Sie wählen:

Vorhandenen Ordner auswählen

Wenn Sie Vorhandenen Ordner auswählen für Ordner auswählen wählen, wird die unten beschriebene Benutzeroberfläche angezeigt.

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, aus denen Sie wählen können.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. 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 Aktivität zu identifizieren. Der Name muss für jede SMB-Aktivität Datei lesen eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Ordner auswählen: Wählen Sie die Option Vorhandenen Ordner auswählen.

  • Ordner auswählen: In diesem Bereich werden die im SMB-Ordner verfügbaren Ordner angezeigt, der in der Verbindung angegeben ist.

    • Ausgewählter Ordner: Nach der Auswahl eines Ordners wird dieser hier aufgelistet.

  • Suche: Geben Sie einen beliebigen Ordnerwert in das Suchfeld ein, um die Ordnerliste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Ordner bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Ordner vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Stammelemente aktualisieren: Klicken Sie auf das Symbol oder auf die Wörter Stammelemente aktualisieren, um Ordner vom SMB-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Ordner zum SMB-Server hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Ordnertabelle verwendet werden.

  • Ordner auswählen: Klicken Sie in der Tabelle auf einen Ordnernamen, um ihn auszuwählen. Sie können nur einen Ordner auswählen.

    • Aktualisieren: Wenn Sie den Mauszeiger über einen Ordnernamen bewegen, klicken Sie auf das Symbol oder auf das Wort Aktualisieren, um die Unterordner zu laden. Sobald Unterordner angezeigt werden, können Sie diese für die Aktivität auswählen.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Ordnern gefüllt wird, ist die SMB-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Dateien abrufen: Geben Sie den Namen und die Erweiterung der zu lesenden Datei ein.

  • 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, 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 die Schaltfläche Fertig im letzten Schritt klicken.

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

Ordnernamen manuell angeben

Wenn Sie Ordnernamen manuell angeben für Ordner auswählen wählen, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Symbol 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 Symbol , um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. 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 Aktivität zu identifizieren. Der Name muss für jede SMB-Aktivität Datei lesen eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Ordner auswählen: Wählen Sie die Option Ordnernamen manuell angeben.

  • Pfadadresse: Geben Sie den Pfad des Ordners ein, der die zu lesende Datei enthält. Verwenden Sie dieses Format: example-folder-1/sub-folder-13.

  • Dateien abrufen: Geben Sie den Namen und die Erweiterung der zu lesenden Datei ein.

  • 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, 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 die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Antwortschema bereitstellen

In diesem Schritt können Sie ein benutzerdefiniertes Antwortschema bereitstellen.

Hinweis

Diese Aktivität hat keine Standard-Antwortschemas. Sie müssen ein Antwortschema entweder in diesem Schritt der Aktivitätskonfiguration bereitstellen oder es in einer Transformation definieren.

  • Antwortschema bereitstellen: Das Antwortschema definiert die Struktur der Antwortdaten, die von der Aktivität Datei lesen verwendet werden. Anweisungen zum Ausfüllen dieses Abschnitts finden Sie unter Schemas, die in einer Aktivität definiert sind.

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

  • Weiter: Klicken Sie hier, 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 die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemas überprüfen

Alle Antwortschemas werden in diesem Schritt angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschema: Ein von einem Benutzer bereitgestelltes Antwortschema wird von einer angrenzenden Transformation geerbt und wird während der Transformationszuordnung erneut angezeigt.

    Hinweis

    Diese Aktivität hat keine Standard-Antwortschemas. Wenn Sie in Schritt 2 der Aktivitätskonfiguration kein Antwortschema bereitgestellt haben, müssen Sie eines in einer Transformation definieren.

  • Aktualisieren: Klicken Sie auf das Symbol oder das Wort Aktualisieren, um Schemas vom SMB-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • 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: Nach dem Vornehmen von Änderungen klicken Sie hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer SMB-Aktivität Datei lesen 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 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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.

SMB-Aktivitäten Datei lesen können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

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