Four51-Connector Erstellung im Jitterbit Design Studio

Die Four51-Erstellungsaktivität, die im Four51-Connector verfügbar ist, ermöglicht es Ihnen, neue Daten in Four51 über die OrderCloud-API mithilfe von Jitterbit zu erstellen.

Diese Seite beschreibt, wie Sie neue Daten in Four51 erstellen, indem Sie ein Beispiel für die Erstellung einer neuen Käuferadresse mit Jitterbit verwenden.

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

Erstellung einer Four51-Erstellungsoperation

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

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

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

   

3. Die nächsten Bildschirme im Four51 Create Wizard helfen Ihnen, das spezifische Objekt zu finden, in dem Sie Daten erstellen möchten. Der erste dieser Bildschirme, Section, fordert Sie auf, eine der aufgeführten Hauptkategorien innerhalb von Four51 auszuwählen: "Authentication", "Buyer", "Ordering", "Organization" oder "UserPerspective".

   Hinweis

   Sie können herausfinden, welche Auswahl zu treffen ist, indem Sie auf die OrderCloud API verweisen. Zum Beispiel entsprechen diese fünf Hauptkategorien direkt den auf der linken Seite der OrderCloud API Console aufgeführten. Die verbleibenden Auswahlbildschirme für Objekte folgen ebenfalls der Organisation der OrderCloud API.

   Im Beispiel möchten wir eine neue Käuferadresse erstellen, also wählen wir den Abschnitt "Buyer" aus und klicken auf Weiter, um fortzufahren.

   

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

   

5. Der letzte Auswahlbildschirm im Four51 Create Wizard, genannt Resource Endpoint, zeigt die endgültigen Objekte an, die für die ausgewählte Ressource verfügbar sind. Im Beispiel, um eine neue Adresse zu erstellen, wählen wir die Option "Create New Address" aus. 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. Ein neuer Tab sollte in Studio erscheinen, der Four51 Create Activities heißt. Sie können Ihre Erstellungsaktivität hier nach Belieben umbenennen; in unserem Beispiel heißt sie "Four51 Create - Buyer > Addresses > Create New Address." 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 "Extended Properties" und ist Teil der OrderCloud API. Dieses Attribut ermöglicht es Ihnen, benutzerdefinierte Felder zu den meisten Objekten hinzuzufügen. Um mehr darüber zu erfahren, wie Sie das XP-Attribut verwenden, siehe Four51 connector advanced.

7. Als Nächstes klicken Sie auf demselben Bildschirm auf die Schaltfläche Create Operation, die sich unter Use in an Integration in der oberen rechten Ecke befindet. Dies wird die Jitterbit-Operation erstellen, die eine neue Käuferadresse in Four51 erstellt.

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

   

   Hinweis

   Die Symbole für Source, Request, Response und Target 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 Mehrfach-Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf dem Operations-Tab und der Titel der Operation verschwinden, da Ihre neue Erstellungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

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 Source, Request, Response und Target.

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 Source, Request, Response und Target separat erstellen und sie dann per Drag & Drop aus dem Baum auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

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

• Source: 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 Remove From Graph auswählen.

  Hinweis

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

• Target: Doppelklicken Sie auf das Target-Symbol. In diesem Beispiel werden wir die Antwort von der OrderCloud-API in einer temporären Textdatei aufzeichnen, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Create New Target, geben Sie Ihrem Ziel einen Name (z. B. 'Create Target'). 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 Type von "Temporary Storage" und geben einen Filename von 'Create_File.txt' für das Beispiel ein.

  Hinweis

  Sie können auch in eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht derselbe sein wie der Quellentyp. Siehe Targets für Optionen.

• Request: Doppelklicken Sie auf das Request-Symbol und wählen Sie Create New Transformation. Dies öffnet den Transformation Wizard, der Sie durch die Erstellung der Anfrage führt.

  Hinweis

  Zusätzliche Informationen zu Anforderungsstrukturen finden Sie unter Transformations.

  1. Auf dem ersten Bildschirm, Name, geben Sie einen Namen für Ihre Transformation ein oder lassen Sie den Standardwert. Wählen Sie dann im Dropdown-Menü Quelle die Quelle für die Transformation aus. 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 > CreateNewAddress > Parameter	Skript
     buyerID	<trans> "TestBuyerID0001" </trans>

     Hinweis

     Der oben genannte buyerID stammt von der ID der bestehenden Käuferorganisation, innerhalb derer wir die neue Adresse erstellen möchten. Die Beispiel buyerID von TestBuyerID0001 wurde bereits in der OrderCloud-Instanz für dieses Beispiel erstellt. Weitere Informationen finden Sie unter Käuferorganisation in den Voraussetzungen für den Four51-Connector.

     ZIEL: EINGABE > CreateNewAddress > RequestParameters	Skript
     ID	<trans> "TestAddressID0000" </trans>
     CompanyName	<trans> "Test Company" </trans>
     FirstName	<trans> "First" </trans>
     LastName	<trans> "Last" </trans>
     Street1	<trans> "Main Street" </trans>
     City	<trans> "San Francisco" </trans>
     State	<trans> "CA" </trans>
     Zip	<trans> "123456" </trans>
     Country	<trans> "US" </trans>
     Phone	<trans> "123456789" </trans>
     AddressName	<trans> "Test_Address" </trans>

     Hinweis

     Alle oben bereitgestellten Informationen sind neue Daten, die bereits nicht innerhalb der Beispiel-OrderCloud-Instanz existieren.

     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 Antwortstrukturen finden Sie unter Transformationen.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder lassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um das Ziel für die Transformation auszuwählen. Im 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 Erstellungsaktivität verwenden, die wir gerade eingerichtet haben, also wählen Sie "Erstellen." 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 Erstellungsaktivität aus, die Sie gerade eingerichtet haben. Die zugehörigen Anforderungs- und Antwortstrukturen der ausgewählten Erstellungsaktivität sollten jetzt angezeigt werden. Klicken Sie auf Fertigstellen, um fortzufahren.

  4. Der Tab Transformationen 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 aussehen wie unten gezeigt.

     

Ihre konfigurierte Operation sollte ähnlich aussehen wie das unten gezeigte Beispiel.

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Four51-Erstellungsaktivitä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 Operationsmonitor anzeigen, dass Ihre Operation erfolgreich ausgeführt wurde. Andernfalls können Sie auf das Status-Symbol doppelklicken, um alle Protokollnachrichten anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabereaktion sehen, die Ihrer Zieldatei 'Create_File.txt' zugeordnet wurde. Im Beispiel wurde 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 die Operation erfolgreich war.

   <?xml version="1.0" encoding="UTF-8"?>
   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <CreateNewAddress>
           <Status>1</Status>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test Company</CompanyName>
                   <FirstName>First</FirstName>
                   <LastName>Last</LastName>
                   <Street1>Main Street</Street1>
                   <City>San Francisco</City>
                   <State>CA</State>
                   <Zip>123456</Zip>
                   <Country>US</Country>
                   <Phone>123456789</Phone>
                   <AddressName>Test_Address</AddressName>
               </Item>
           </Items>
       </CreateNewAddress>
   </ns:OUTPUT>
   

5. Darüber hinaus sollten Sie, wenn Sie die OrderCloud API-Konsole unter Käufer > Adressen überprüfen, die neu erstellte Käuferadresse finden.