Four51 Connector-Update im Jitterbit Design Studio

Die Four51-Update-Aktivität, die im Four51 Connector verfügbar ist, ermöglicht es Ihnen, neue Daten zu erstellen oder vorhandene Daten in Four51 über die OrderCloud-API zu ersetzen. Eine eindeutige ID muss bereitgestellt werden.

Mit einer Four51-Update-Aktivität werden alle Felder für das zugehörige Objekt erstellt oder ersetzt. Wenn es Pflichtfelder gibt, müssen Sie für diese Felder einen Wert angeben, auch wenn bereits vorhandene Daten in den Pflichtfeldern vorhanden sind. Der Grund dafür ist, dass eine Four51-Update-Aktivität alle vorhandenen Daten für das Objekt vollständig aktualisiert oder ersetzt.

Das vollständige oder teilweise Aktualisieren von Objektfeldern ist ein wichtiger Unterschied zwischen den Four51-Update- und Four51-Patch-Update-Aktivitäten. Wenn Sie stattdessen nur bestimmte Felder für das zugehörige Objekt aktualisieren möchten, verweisen Sie auf das Four51 Connector-Patch-Update.

Diese Seite beschreibt, wie Sie neue Daten erstellen oder vorhandene Daten in Four51 ersetzen, indem ein Beispiel für den Ersatz einer vorhandenen Käuferadresse mit Jitterbit verwendet wird. Dieses Beispiel ersetzt die gleiche Käuferadresse, die als Beispiel im Four51 Connector-Erstellen erstellt wurde.

Die folgenden Abschnitte sind in den Beginn der Update-Aktivität, die Definition der Betriebsbestandteile sowie die Bereitstellung und Ausführung der Operation unterteilt.

Erstellen einer Four51 Update-Operation

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, eine neue Four51 Update-Aktivität zu beginnen. Jede der folgenden Optionen startet den Four51 Update Wizard, der Sie durch den Prozess führt.

   • Gehen Sie zu Datei > Neu > Connectoren > Neue Four51 Update.
   • Klicken Sie im Baum auf der linken Seite unter Connectoren mit der rechten Maustaste auf die Kategorie Four51 und wählen Sie Neue Four51 Update.
   • Klicken Sie im Baum auf der linken Seite unter Connectoren doppelt auf die Kategorie Four51, klicken Sie dann mit der rechten Maustaste auf Four51 Update-Aktivitäten und wählen Sie Neue Four51 Update.
   • Klicken Sie in der oberen Symbolleiste auf das Connector-Symbol (orangefarbener Puzzlestück) . Wählen Sie im Popup Four51 und dann Four51 Update.

2. Der Bildschirm Endpoint des Four51 Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, in dem Sie Daten erstellen oder ersetzen möchten. Sie sollten Ihren Endpunkt bereits in Four51 Connector Endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpunkt auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

   

3. Die nächsten Bildschirme im Four51 Update Wizard helfen Ihnen, das spezifische Objekt zu finden, in dem Sie Daten aktualisieren möchten. Der erste dieser Bildschirme, Abschnitt, fordert Sie auf, eine der aufgeführten Hauptkategorien innerhalb von Four51 auszuwählen: "Authentifizierung", "Käufer", "Bestellung", "Organisation" oder "Benutzerperspektive".

   Hinweis

   Sie können herausfinden, welche Auswahl Sie treffen müssen, indem Sie auf die OrderCloud API verweisen. Diese fünf Hauptkategorien entsprechen direkt denen, die auf der linken Seite der OrderCloud API-Konsole aufgeführt sind. Die verbleibenden Bildschirme zur Objektauswahl folgen ebenfalls der Organisation der OrderCloud API.

   Im Beispiel möchten wir eine bestehende Käuferadresse vollständig ersetzen, daher wählen wir den Abschnitt "Käufer" aus und klicken auf Weiter, um fortzufahren.

   

4. Der nächste Bildschirm im Four51 Update Wizard, genannt Ressource, zeigt die innerhalb des ausgewählten Abschnitts verfügbaren Ressourcen an. Im Beispiel, da wir eine bestehende Adresse ersetzen möchten, wählen wir "Adressen" aus und klicken auf Weiter, um fortzufahren.

   

5. Der letzte Auswahlbildschirm im Four51 Update Wizard, genannt Ressourcenendpunkt, zeigt die endgültigen Objekte an, die für die ausgewählte Ressource verfügbar sind. Im Beispiel, um eine bestehende Adresse zu ersetzen, wählen wir die Option "Adresse erstellen oder aktualisieren". Klicken Sie auf Fertigstellen, um fortzufahren.

   Hinweis

   Die für jede Abschnittsressource verfügbaren Ressourcenendpunkte hängen von der Art der für die Operation ausgewählten Four51-Aktivität ab (d.h. erstellen, lesen, aktualisieren, Patch-Aktualisierung oder löschen).

   

6. Jitterbit wird dann mit der Erstellung einer API-Anforderungs- und -Antwortstruktur fortfahren, die es ermöglicht, Daten über die OrderCloud API zu erstellen oder zu ersetzen. Ein neuer Tab sollte im Studio erscheinen, der Four51 Update Activities heißt. Sie können Ihre Aktualisierungsaktivität hier umbenennen, wenn gewünscht; in unserem Beispiel heißt sie "Four51 Update - Käufer > Adressen > Adresse erstellen oder aktualisieren." Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

   Hinweis

   Das "xp" in der obigen Struktur steht für "Erweiterte Eigenschaften" und ist Teil der OrderCloud API. Diese Eigenschaft ermöglicht es Ihnen, benutzerdefinierte Felder zu den meisten Objekten hinzuzufügen. Um mehr darüber zu erfahren, wie Sie die XP-Eigenschaft verwenden, siehe Four51 connector advanced.

7. Klicken Sie als Nächstes auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dies erstellt die Jitterbit-Operation, die eine neue Käuferadresse in Four51 erstellt oder eine bestehende ersetzt.

8. Ein neuer Tab sollte in Studio geöffnet werden, der Operationen heißt und eine grafische Darstellung der Aktualisierungsaktivität enthält.

   

   Hinweis

   Die Symbole für Quelle, Anfrage, Antwort und Ziel im obigen Bild sind Platzhalter für die Komponenten der Operation, die wir im nächsten Abschnitt definieren werden.

   Speichern Sie Ihre Operation, indem Sie entweder auf das einzelne Diskettensymbol klicken, um nur diese Operation zu speichern, oder auf das mehrfache Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf dem Operationen-Tab und der Titel der Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert wurde.

Definieren der Komponenten der Operation

Als Nächstes müssen wir die anderen Komponenten der Operation definieren, die in der grafischen Darstellung erscheinen, einschließlich Quelle, Anfrage, Antwort und Ziel.

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um jede Komponente zu konfigurieren, oder Sie können die Quelle, Anfrage, Antwort und Ziel separat erstellen und sie dann aus dem Baum auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen und ablegen.

Für jede Komponente der Operation können viele verschiedene Datentypen verwendet werden. Um mehr über zusätzliche Anpassungsoptionen zu erfahren, siehe den Abschnitt Design Studio unserer Dokumentation.

• Quelle: Um dieses Beispiel zu vereinfachen, wird die Quelle fest codiert. Daher entfernen wir die Quelle, indem wir mit der rechten Maustaste auf das Quellensymbol im Operationsdiagramm klicken und Aus Diagramm Entfernen auswählen.

  Hinweis

  Eine Vielzahl von Quellentypen ist in Jitterbit verfügbar. Siehe Quellen für weitere Informationen.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. In diesem Beispiel werden wir die Antwort von der OrderCloud-API in eine temporäre Textdatei aufzeichnen, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. 'Update-Ziel'). Als Nächstes möchten wir in diesem Beispiel in den standardmäßigen temporären Speicherort auf unserem privaten Agenten schreiben, also wählen wir einen Typ von "Temporärer Speicher" und geben einen Dateinamen von 'Update_File.txt' für das Beispiel ein.

  Hinweis

  Sie können auch an eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp übereinstimmen. Siehe Ziele für Optionen.

• Anfrage: Doppelklicken Sie auf das Anfrage-Symbol und wählen Sie Neue Transformation erstellen. Dies öffnet den Transformationsassistenten, der Sie durch die Erstellung der Anfrage führt.

  Hinweis

  Zusätzliche Informationen zu Anfrage-Strukturen finden Sie unter Transformationen.

  1. Geben Sie auf dem ersten Bildschirm unter Name einen Namen für Ihre Transformation ein oder lassen Sie den Standardnamen. Verwenden Sie dann das Dropdown-Menü Quelle, um die Quelle für die Transformation auszuwählen. In diesem Beispiel ist unsere Quelle fest codiert, daher wählen wir "Keine". Klicken Sie auf Fertigstellen, um fortzufahren.

  2. Der Tab Transformationen sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Elemente im Zielbaum auf der rechten Seite zu erweitern. Bei einer Standardtransformation würden Sie jedes Feld, das Sie zuordnen möchten, von einem Baum in den anderen ziehen und ablegen. In diesem Beispiel, um die Quelle fest zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden Werte, die im Beispiel verwendet werden, in das Skript ein:

     ZIEL: EINGABE > CreateorUpdateAddress > Parameter	Skript
     buyerID	<trans> "TestBuyerID0001" </trans>
     addressID	<trans> "TestAddressID0000" </trans>

     Hinweis

     Der oben genannte buyerID ist die bestehende ID der Käuferorganisation, in der sich die Adresse befindet, und die oben genannte addressID ist die bestehende ID der neuen Adresse, die während des Beispiels Four51-Connector erstellen erstellt wurde.

     ZIEL: EINGABE > CreateorUpdateAddress > Anfrageparameter	Skript
     ID	<trans> "TestAddressID0000" </trans>
     Firmenname	<trans> "Test 2 Company" </trans>
     Vorname	<trans> "Replaced First" </trans>
     Nachname	<trans> "Replaced Last" </trans>
     Straße1	<trans> "1234 Main Street" </trans>
     Stadt	<trans> "Los Angeles" </trans>
     Bundesstaat	<trans> "CA" </trans>
     Postleitzahl	<trans> "654321" </trans>
     Land	<trans> "US" </trans>
     Telefon	<trans> "987654321" </trans>
     Adressname	<trans> "Test_2_Address" </trans>

     Hinweis

     Die oben aufgeführten Werte ersetzen die während des Four51-Connector-Erstellens Beispiels erstellten Werte.

     Nachdem die Quelle fest codiert wurde, sollte Ihre Transformationszuordnung ähnlich aussehen wie unten gezeigt.

     

• Antwort: Doppelklicken Sie auf das Antwort-Symbol und wählen Sie Neue Transformation erstellen. Dies öffnet den Transformationsassistenten, der Sie durch die Erstellung der Antwort führt.

  Hinweis

  Zusätzliche Informationen zu den Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm, Name, einen Namen für Ihre Transformation ein oder lassen Sie den Standardwert. Wählen Sie dann im Dropdown-Menü Ziel das Ziel für die Transformation aus. In diesem Beispiel möchten wir die Antwort von der OrderCloud API verwenden, also wählen wir "Four51 Function Response." Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm, Ziel, die Optionsschaltfläche für die Art der Aktivität, von der Sie die Antwort verwenden möchten. In diesem Fall möchten wir die Antwort von der Aktualisierungsaktivität verwenden, die wir gerade eingerichtet haben, also wählen Sie "Aktualisieren." Klicken Sie auf Weiter, um fortzufahren.

  3. Der Bildschirm Ziel zeigt jetzt ein Dropdown-Menü zur Auswahl der Aktivität an. Wählen Sie die Aktualisierungsaktivität aus, die Sie gerade eingerichtet haben. Die zugehörigen Anforderungs- und Antwortstrukturen der ausgewählten Aktualisierungsaktivität sollten jetzt angezeigt werden. Klicken Sie auf Fertigstellen, um fortzufahren.

  4. Der Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. Klicken und ziehen Sie den "OUTPUT"-Ordner von der linken Seite (Quellseite) zum "OUTPUT"-Ordner auf der rechten Seite (Zielseite). Ihr Zuordnungsbildschirm sollte jetzt ähnlich wie unten aussehen.

     

Ihre konfigurierte Operation sollte ähnlich wie im folgenden Beispiel aussehen.

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Four51-Aktualisierungsaktivität sind wir bereit, die Operation bereitzustellen und auszuführen.

1. Klicken Sie im Tab Operationen auf das Bereitstellen Symbol.

2. Klicken Sie dann auf das Ausführen Symbol, um die Operation in die Warteschlange zur Ausführung zu stellen.

3. Im unteren Bereich des Bildschirms sollte der Betriebsmonitor anzeigen, dass Ihr Betrieb erfolgreich ausgeführt wurde. Andernfalls können Sie auf das Status-Symbol doppelklicken, um etwaige Protokollnachrichten anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabereaktion sehen, die auf Ihre Zieldatei 'Update_File.txt' abgebildet wurde. In diesem Beispiel wird die Datei jetzt im temporären Speicher auf dem privaten Agenten erstellt (d.h. standardmäßig '/tmp/jitterbit/TemporaryStorage' für Linux oder 'C:\Windows\Temp\Jitterbit\' für Windows). Der Status '1' zeigt an, dass der Betrieb erfolgreich war.

   <?xml version="1.0" encoding="UTF-8"?>
   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <CreateorUpdateAddress>
           <Status>1</Status>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test 2 Company</CompanyName>
                   <FirstName>Replaced First</FirstName>
                   <LastName>Replaced Last</LastName>
                   <Street1>1234 Main Street</Street1>
                   <City>Los Angeles</City>
                   <State>CA</State>
                   <Zip>654321</Zip>
                   <Country>US</Country>
                   <Phone>987654321</Phone>
                   <AddressName>Test_2_Address</AddressName>
               </Item>
           </Items>
       </CreateorUpdateAddress>
   </ns:OUTPUT>
   

5. Darüber hinaus sollten Sie, wenn Sie die OrderCloud API-Konsole unter Käufer > Adressen überprüfen, die Käuferadresse mit den neuen Informationen ersetzt finden.