SMB-Aktivität „Ordner aktualisieren" in Jitterbit Studio
Einführung
Eine SMB-Aktivität Ordner aktualisieren aktualisiert mit ihrer SMB-Verbindung Ordner auf einem SMB-Server und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
Erstellen einer SMB-Aktivität „Ordner aktualisieren"
Eine Instanz einer SMB-Aktivität Ordner aktualisieren wird aus einer SMB-Verbindung mit dem Aktivitätstyp Ordner aktualisieren erstellt.
Um eine Aktivitätsinstanz 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. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene SMB-Aktivität Ordner aktualisieren kann von diesen Orten aus bearbeitet werden:
- Der Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
- Der Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Registerkarte „Komponenten" des Projektbereichs).
Konfigurieren einer SMB-Aktivität „Ordner aktualisieren"
Führen Sie diese Schritte aus, um eine SMB-Aktivität Ordner aktualisieren zu konfigurieren:
-
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie einen Namen für die Aktivität ein und legen Sie Einstellungen fest. -
Schritt 2: Datenschemas überprüfen
Alle Request- oder Response-Schemas werden angezeigt.
Schritt 1: Namen eingeben und Einstellungen festlegen
Geben Sie in diesem Schritt einen Namen für die Aktivität ein und legen Sie Einstellungen fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
Die in diesem Konfigurationsschritt einer SMB-Aktivität Ordner aktualisieren verwendete Benutzeroberfläche hängt von der ausgewählten Option Ordner auswählen ab:
-
Vorhandenen Ordner auswählen: Diese Option füllt eine Liste vorhandener Ordner zum Auswählen. Um diese Option zu verwenden, muss die Domäne (angegeben während der Verbindungskonfiguration) Zugriff auf die Ordner haben.
-
Ordnernamen manuell eingeben: Bei dieser Option geben Sie den Ordnerpfad manuell ein.
Vorhandenen Ordner auswählen
Wenn Vorhandenen Ordner auswählen für Ordner auswählen ausgewählt ist, wird die nachfolgend beschriebene Benutzeroberfläche angezeigt.
-
Endpunktmenü: 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 Aktivität zu identifizieren. Der Name muss für jede SMB-Aktivität Ordner aktualisieren eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. -
Operationstyp: Wählen Sie einen Operationstyp aus dem Menü aus: Mit Schema definieren, Ordner verschieben oder Ordner umbenennen:
-
Mit Schema definieren: Wenn ausgewählt, wird der Operationstyp im Request-Schema bereitgestellt.
-
Ordner verschieben: Verschiebt den Ordner an einen anderen Ort.
-
Ordner umbenennen: Benennt den Ordner um.
-
-
Ordner auswählen: Geben Sie die Methode zum Bereitstellen des Ordnerpfads an: Vorhandenen Ordner auswählen oder Ordnernamen manuell eingeben:
-
Vorhandenen Ordner auswählen: Wählen Sie diese Option, um aus einer gefüllten Liste von Ordnern auszuwählen. Um diese Option zu verwenden, muss die Domäne (angegeben während der Verbindungskonfiguration) Zugriff auf die Ordner haben.
- Ordnernamen manuell eingeben: Wählen Sie diese Option, um den Pfad des Ordners manuell einzugeben.
-
Ordner auswählen: Dieser Bereich zeigt die im SMB-Ordner verfügbaren Ordner an, der in der Verbindung angegeben ist.
- Ausgewählter Ordner: Nach der Auswahl eines Ordners wird dieser hier aufgelistet.
-
Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Ordner 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 Aktualisierungssymbol oder auf das Wort Stammelemente aktualisieren, um die 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 den Ordnernamen, um den Ordner auszuwählen. Es kann nur ein Ordner ausgewählt werden.
- Aktualisieren: Wenn Sie den Mauszeiger über einen Ordnernamen bewegen, können Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren klicken, um die Unterordner dieses Ordners zu laden. Sobald Unterordner gefüllt sind, können diese zur Verwendung in der Aktivität ausgewählt werden.
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.
-
Speichern und beenden: Klicken Sie, falls aktiviert, 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 eingeben
Wenn Ordnernamen manuell eingeben für Ordner auswählen ausgewählt ist, 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 auswählen können.
-
Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts 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 Namen des aktuellen Endpunkts 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 Ordner aktualisieren eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. -
Operationstyp: Wählen Sie einen Operationstyp aus dem Menü aus, entweder Mit Schema definieren, Ordner verschieben oder Ordner umbenennen:
-
Mit Schema definieren: Wenn diese Option ausgewählt ist, wird der Operationstyp im Anforderungsschema bereitgestellt.
-
Ordner verschieben: Verschiebt den Ordner an einen anderen Speicherort.
-
-
Ordner umbenennen: Benennt den Ordner um.
-
Ordner auswählen: Geben Sie die Methode zum Bereitstellen des Ordners an, entweder Vorhandenen Ordner auswählen oder Ordnernamen manuell eingeben:
-
Vorhandenen Ordner auswählen: Wählen Sie diese Option, um aus einer gefüllten Liste von Ordnern auszuwählen.
-
Ordnernamen manuell eingeben: Wählen Sie diese Option, um den Pfad des Ordners manuell einzugeben.
-
-
Pfadadresse: Geben Sie den Pfad des zu durchsuchenden Ordners ein. Der Pfad muss in diesem Format eingegeben werden:
example-folder-1/example-sub-folder-13. -
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 an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Datenschemas überprüfen
Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
-
Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Datenzuordnung von Transformationen erneut angezeigt.
Hinweis
Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.
Die Anfrage- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:
Anfrageschema-Knoten/Feld Beschreibung rootKnoten, der das Root-Element darstellt itemKnoten, der den zu aktualisierenden Ordner darstellt newNameZeichenkette mit dem umbenannten Ordnernamen nameZeichenkette mit dem Namen des zu aktualisierenden Ordners destinationFolderPathZeichenkette mit dem Zielordnerpfad operationZeichenkette mit dem Operationstyp, entweder Move,RenameoderUpdate FileAntwortschema-Knoten/Feld Beschreibung rootKnoten, der das Root-Element darstellt itemKnoten, der den Ordner darstellt error_messageZeichenkette mit der Fehlermeldung, falls zutreffend responseZeichenkette mit der Antwort indexZeichenkette mit dem Index des verwendeten Dialekts -
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf 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 das gleiche Schema verwiesen wird, z. B. in einer angrenzenden Transformation.
-
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 dem Vornehmen von Änderungen, 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 Ordner aktualisieren 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.
SMB-Aktivitäten zum Aktualisieren von Ordnern können mit diesen Operationsmustern als Ziel verwendet werden:
- Transformationsmuster
- Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.
Wenn Sie bereit sind, stellen Sie die Operation bereit und führen Sie sie aus, und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.