Connector-Tutorial-Szenario 1: Datei abrufen¶
Holen Sie eine Textdatei von Dropbox und schreiben Sie sie auf einen FTP Server¶
Dieses Szenario demonstriert die Verwendung einer Dropbox-Aktivität „Datei abrufen“. In diesem Beispiel wird eine Textdatei abgerufen von Dropbox und dann auf einen FTP -Server geschrieben. Die resultierende Datei ist eine JSON-Datei, die sowohl den Inhalt von die Datei und die Metadaten über die Datei, die von Dropbox empfangen wurden. (Für ein Beispiel, bei dem nur der Inhalt der Datei wird zurückgegeben, ohne die Metadaten, siehe Szenario 2: Datei abrufen.)
Hier ist der abgeschlossene Operation:
Um diesen Operation und dieses Szenario abzuschließen, benötigen Sie eine Textdatei im Ordner Ihrer Dropbox-Anwendung. Eine Beispieldatei customers.csv
wird bereitgestellt in assets/sample-data directory
der Quelldateien des Dropbox-Connectors zu diesem Zweck.
Hier ist ein Beispiel für die Ausgabedatei, die erstellt wird. Dabei handelt es sich um eine JSON-Datei mit Metadaten und dem Dateiinhalt in einer einzigen Struktur:
{
"name": "customers.csv",
"clientModified": "2018-03-16T14:40:39-07:00",
"serverModified": "2018-04-10T14:10:52-07:00",
"rev": "49a708770",
"size": 2231,
"sharingInfo": {
"readOnly": null,
"parentSharedFolderId": null,
"modifiedBy": null
},
"content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
"link": null
}
1. Beispieldatei in Dropbox kopieren¶
Kopieren Sie die Beispieldatei (customers.csv
) aus dem assets/sample-data directory
des Dropbox-Connectors zu Ihrem Dropbox-Konto.
2. Fügen Sie einer Operation eine Dropbox-Aktivität „Datei abrufen“ hinzu¶
Ziehen Sie den Aktivitätstyp „Dropbox-Datei abrufen“ aus dem Design-Komponentenpalette zum Komponenten-Drop Zone auf der Design-Canvas, um eine Instanz einer Dropbox-Aktivität „Datei abrufen“ in einem neuen Operation zu erstellen. Doppelklicken Sie die Aktivität, um es zu öffnen.
Geben Sie in der Konfiguration einen Namen (z. B. „Datei abrufen“) und einen Ordnerpfad (Sie können den Standardpfad von /
) und den Namen der herunterzuladenden Datei (z. B. customer.csv
):
Wenn Sie auf die Schaltfläche Weiter klicken, gelangen Sie zu einem Bildschirm, auf dem Sie das Schema überprüfen können:
Hier wird angezeigt, was von Dropbox zurückgegeben wird (die Antwort). Es wird in einem XML-Format vorliegen und zeigt, dass die Metadaten über die Datei zusätzlich zu den content
Feld, welches den eigentlichen Inhalt enthält.
Klicken Sie auf Fertig, um zum Workflow zurückzukehren.
3. Fügen Sie der Operation eine FTP Schreibaktivität hinzu¶
Verwenden Sie den FTP Endpoint namens “FTP”, den Sie für dieses Tutorial konfiguriert haben (siehe Tutorial-Szenarien im Tutorial zum Dropbox-Connector), ziehen Sie einen FTP Schreibvorgang Fügen Sie den Aktivitätstyp zu einer Komponenten-Drop-Zone im Operation direkt nach der Aktivität „Dropbox-Datei abrufen“ hinzu.
Konfigurieren Sie es mit einem Namen (z. B. „Schreiben“), geben Sie ein JSON- Schema an (Sie können die Beispiel-JSON-Datei kopieren und einfügen siehe oben und setzen Sie den Schema auf customers.json
wie gezeigt) und ein Dateiname (wie dropbox_result_[date]_[time].json
). Dieser Dateiname erzeugt einen neuen zeitgestempelten Dateinamen jedes Mal, wenn der Operation ausgeführt wird.
Die Aktivität „FTP Schreiben“ sieht folgendermaßen aus:
Klicken Sie auf Weiter und dann auf Fertig, um die „FTP Schreib“-Konfiguration zu schließen.
4. Fügen Sie der Operation eine Transformation hinzu¶
Bewegen Sie den Mauszeiger über den Bereich zwischen den beiden Aktivitäten in der Operation und klicken Sie auf die Komponenten-Drop-Zone, um ein Menü zu öffnen wo Sie Neue Transformation auswählen können.
Konfigurieren Sie die Transformation mit einem Namen (z. B. “Fetch to FTP”). Wenn Sie das Schema im FTP Write Aktivität wie oben beschrieben, können Sie den Link Genaue Übereinstimmungen automatisch zuordnen verwenden, um alle Felder der “Dropbox Fetch File”-Antwort an das “FTP Write”-Ziel. Klicken Sie auf Zurück zum Workflow, um die Transformation zu speichern Konfiguration und kehren Sie zum Workflow zurück.
5. Benennen Sie die Operation¶
Geben Sie Ihrem Operation (und Workflow) entsprechende Namen, sofern Sie dies noch nicht getan haben.
6. Ausführen des Operation¶
Angenommen, Sie haben eine customers.csv
Datei im Ordner Ihrer Dropbox-Anwendung, können Sie jetzt einsetzen und führen Sie das Projekt (oder nur die Operation) aus.
Im Operation sollten Sie sehen, dass der Operation empfangen und anschließend erfolgreich abgeschlossen wurde:
7. Erfolg bestätigen¶
Um den Erfolg zu bestätigen, öffnen Sie Ihren FTP Server und prüfen Sie, ob die Datei hinzugefügt wurde. (Wenn Sie Jitterbit verwenden Trainings-FTP Server, ein Web-Viewer dafür befindet sich unter https://training2.jitterbit.com/WebInterface/login.html.)
Die neue Datei sollte sich im Stammverzeichnis befinden und einen ähnlichen Namen haben wie dropbox_result_[date]_[time].json
. Wenn Sie die Datei herunterladen und anzeigen, werden Sie feststellen, dass sie ungefähr so aussieht:
{
"name": "customers.csv",
"clientModified": "2018-03-16T14:40:39-07:00",
"serverModified": "2018-04-10T14:10:52-07:00",
"rev": "49a708770",
"size": 2231,
"sharingInfo": {
"readOnly": null,
"parentSharedFolderId": null,
"modifiedBy": null
},
"content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
"link": null
}
Die Datei ist eine JSON-Datei, wobei die Metadaten von Dropbox die ersten Felder sind. Die content
Das Feld wird als base64-codierte Zeichenfolge angezeigt.
In Szenario 2: Datei abrufen (im nächsten Szenario) werden wir sehen, wie wir mit der Antwort von Dropbox arbeiten, um auf die unverschlüsselte Form dieses Inhalts zuzugreifen.