Übung zur Einführung in universelle Connectoren
Erfahren Sie mehr über die Arbeit mit universellen REST-Connectoren und mit den zurückgegebenen Daten.
Übungsübersicht
Rufen Sie mithilfe eines Pokemon-Charakters in einer Tabelle die Poke-API über einen HTTP-Connector auf, um weitere Informationen über diesen Charakter zu sammeln und zu veröffentlichen.
Zu befolgende Schritte
Laden Sie die CSV-Datei aus Workfront herunter.
-
Wählen Sie im Workfront-Ordner „Fusion-Übungsdateien“ die Datei „_Fusion2020_Shipping Manifest.csv“ aus und klicken Sie auf „Dokumentdetails“.
-
Kopieren Sie die erste ID-Nummer aus der URL-Adresse.
-
Erstellen Sie ein neues Szenario in Workfront Fusion. Nennen Sie es „Universelle Connectoren verwenden“.
-
Beginnen Sie mit dem Modul „Dokument herunterladen“ in der Workfront-App.
-
Richten Sie Ihre Workfront-Verbindung ein und fügen Sie die Dokument-ID ein, die Sie aus der Workfront-URL kopiert haben.
-
Benennen Sie dieses Modul in „Versandmanifest herunterladen“ um.
Analysieren Sie die Versandmanifestdaten.
-
Fügen Sie ein weiteres Modul hinzu und wählen Sie „CSV-Analyse“.
-
Richten Sie die CSV-Analyse für 11 Spalten ein. Markieren Sie das Kontrollkästchen „CSV enthält Kopfzeilen“. Wählen Sie als Trennzeichen „Komma“ aus und fügen Sie Daten aus dem Modul „Dokument herunterladen“ in das CSV-Feld ein.
-
Benennen Sie dieses Modul in „Versandmanifest analysieren“ um.
-
Speichern Sie das Szenario und klicken Sie auf „Einmal ausführen“, damit Sie in den nächsten Schritten Daten aus der CSV-Datei sehen können.
Rufen Sie die Pokemon-Daten über den universellen Connector ab.
-
Fügen Sie ein HTTP-Anfragemodul hinzu.
-
Verwenden Sie im URL-Feld
https://pokeapi.co/api/v2/pokemon/[Character]
, wobei [Zeichen] der Spalte 3 des Moduls „CSV-Analyse“ zugewiesen ist. -
Aktivieren Sie das Kontrollkästchen „Antwort analysieren“.
-
Wählen Sie „Erweiterte Einstellungen anzeigen“ und aktivieren Sie dann das Kontrollkästchen neben „Alle Status als Fehler auswerten“.
-
Klicken Sie auf „OK“ und benennen Sie das Modul in „Pokemon-Informationen abrufen“ um.
Ihr Zuordnungsfenster sollte wie folgt aussehen:
In diesem Teil der Übung werden Sie nur mit Zeile 1 in der CSV-Datei arbeiten.
-
Fügen Sie vor Ihrem Pokemon-Infomodul einen Filter ein. Nennen Sie ihn „Nur Zeile 1“.
-
Legen Sie die Bedingung so fest, dass nur ID-Nummer 1 zugelassen wird. ID-Nummer 1 befindet sich in Zeile 1 und das ID-Feld in Spalte 1 der CSV-Datei.
-
Speichern Sie das Szenario.
-
Klicken Sie auf „Einmal ausführen“ und beobachten Sie die Fehlermeldung, die Sie im HTTP-Anfragemodul erhalten.
note important IMPORTANT Beachten Sie, dass im URL-Feld für die Eingabedaten der Zeichenname großgeschrieben wird. Dies funktioniert nicht für diesen API-Aufruf, da Zeichennamen in Kleinbuchstaben geschrieben werden müssen. -
Verwenden Sie das Zuordnungsfenster des HTTP-Felds „URL anfordern“, um für das Feld [Zeichen] mithilfe der Funktion Kleinschreibung nur Kleinbuchstaben zuzulassen.
Geben Sie Informationszuordnungen mithilfe des Moduls „Mehrere Variablen festlegen“ von der API zurück.
-
Fügen Sie das Modul „Mehrere Variablen festlegen“ hinter „Pokemon-Info abrufen“ hinzu. Ordnen Sie Name, Größe, Gewicht und Fähigkeiten zu.
-
Da das Feld „Fähigkeiten“ ein Array ist, sollten Sie die Funktion „zuordnen“ verwenden, um auf den Namen jeder Fähigkeit im Array zuzugreifen.
Führen Sie das Szenario ohne Filter aus, um einen weiteren Fehler zu erkennen.
-
Um alle Zeilen in der CSV-Datei zu verarbeiten, löschen Sie den Filter mit der Bezeichnung „Nur Zeile 1“:
- Klicken Sie auf das Filtersymbol, um den Filter zu bearbeiten.
- Löschen Sie die Filterbeschriftung.
- Löschen Sie die Bedingung.
- Klicken Sie auf „OK“.
-
Speichern Sie das Szenario und klicken Sie auf „Einmal ausführen“.
-
Im Modul „Pokemon-Informationen abrufen“ tritt ein Fehler auf. Sie sehen, dass ein Superhelden-Charakter an die Pokemon-API übergeben wurde.
note note NOTE In der Anleitung zu Routern erfahren Sie, wie Sie diesen Fehler beheben können, indem Sie einen separaten Pfad zum Verarbeiten von Superhelden erstellen.