Connector SDK-Tutorial-Szenario 5: Datei abrufen

Einführung

Dieses Szenario demonstriert die Verwendung einer Dropbox Datei abrufen-Aktivität.

In diesem Szenario wird eine Datei von Dropbox abgerufen und dann auf einen FTP-Server geschrieben.

Hinweis

Ähnlich wie im Szenario 4: Datei verarbeiten wird die Datei während der Konfiguration der Aktivität im Integration Studio dynamisch festgelegt, indem der Verzeichnisinhalt des Dropbox-Ordners gelesen wird.

Hier ist der abgeschlossene Vorgang:

Wichtig

Um diesen Vorgang und das Szenario abzuschließen, führen Sie die erforderlichen Vorbereitungen im Dropbox-Connector-Tutorial durch.

Sie sollten Folgendes haben:

Zugriff auf ein Dropbox-Konto und einen FTP-Server.
Konfigurierte Dropbox- und FTP-Connectoren.
Zugriff auf das assets/sample-data directory des Dropbox-Connector-Repositorys.

1. Beispiel-Datei in Dropbox kopieren

Kopieren Sie die Beispiel-Datei (account.json) aus dem assets/sample-data directory des Dropbox-Connectors in das Stammverzeichnis Ihres Dropbox-Kontos.

2. Eine Dropbox Datei abrufen-Aktivität zu einem Vorgang hinzufügen

Ziehen Sie eine Dropbox Datei abrufen-Aktivität aus der Design-Komponentenpalette in die Komponentenablage auf der Entwurfsfläche, um eine Instanz einer Dropbox Datei abrufen-Aktivität in einem neuen Vorgang zu erstellen. Doppelklicken Sie auf die Aktivität, um sie zu öffnen.

Geben Sie einen Namen und einen Ordnerpfad (z. B. /) ein.

Klicken Sie auf Weiter, um zum nächsten Schritt zu gelangen.

Mit der Dropbox Datei abrufen-Aktivität demonstrieren wir die Fähigkeit eines Connectors, das Schema basierend auf einer Benutzerauswahl dynamisch zu konfigurieren.

Die verfügbaren Schemata sind zur Build-Zeit im Connector enthalten, aber ein Connector könnte die Liste und die verfügbaren Connectoren dynamisch aktualisieren.

Wählen Sie die Zeile account.json, da diese das mit der Account-JSON-Datei verbundene XSD verwenden wird:

Klicken Sie auf Weiter, um das Datenschema zu überprüfen, das zeigt, dass die Antwort von Dropbox ein JSON-Objekt sein wird und dessen Felder anzeigt.

An diesem Punkt können Sie zum vorherigen Bildschirm zurückkehren und versuchen, die anderen Dateitypen auszuwählen, um zu sehen, wie sich das Datenschema ändert, um die gewählte Datei widerzuspiegeln.

Notieren Sie sich, welche Datei Sie ausgewählt haben; wir werden das Tutorial mit der Datei account.json zeigen:

Klicken Sie auf Fertig, um die Aktivitätskonfiguration zu schließen.

3. Fügen Sie eine FTP-Schreibaktivität zur Operation hinzu

Ziehen Sie eine FTP Schreib-Aktivität aus der Design-Komponentenpalette in die Komponentenablagezone auf der Design-Leinwand, um eine Instanz einer FTP Schreib-Aktivität in einer neuen Operation zu erstellen. Doppelklicken Sie auf die Aktivität, um sie zu öffnen.

Konfigurieren Sie sie mit einem Namen, einem Pfad (zum Beispiel /) und einem geeigneten Dateinamensmuster (zum Beispiel dropbox_process_results_[date]_[time].json).

Die FTP Schreib-Aktivität wird so aussehen:

Klicken Sie auf Weiter und dann auf Fertig, um zum Workflow zurückzukehren.

4. Fügen Sie eine Transformation zur Operation hinzu

Fügen Sie eine Transformation zwischen den beiden Aktivitäten hinzu.

Wenn es geöffnet wird, geben Sie der Transformation einen Namen und klicken Sie dann auf Automap Exact Matches, um die Transformationszuordnung zu erstellen.

Klicken Sie auf das Schließen-Symbol, um die Transformationskonfiguration zu speichern und zum Workflow zurückzukehren:

5. Führen Sie die Operation aus

Deployen und führen Sie die Operation aus. Die ausgewählte Datei sollte von Dropbox abgerufen und mit einem Namen, der auf dem Muster basiert, auf den FTP-Server geschrieben werden.

Im Operationsprotokoll sollten Sie eine Protokollnachricht sehen, dass die Operation erfolgreich abgeschlossen wurde:

Variationen

Sie können nun die Operation überarbeiten und andere Beispieldateien (JSON oder XML) ausprobieren und sehen, dass sie auf ähnliche Weise verarbeitet werden.