Four51 -Anschluss-Update im Jitterbit Design Studio

Die Four51 Update-Aktivität ist im Four51 -Connector verfügbar ermöglicht Ihnen, über die OrderCloud API neue Daten in Four51 anzulegen oder bestehende zu ersetzen. Dabei muss eine eindeutige ID angegeben werden.

Bei einer Four51 Aktualisierungsaktivität werden alle Felder für das zugehörige Objekt erstellt oder ersetzt. Wenn Pflichtfelder vorhanden sind, müssen Sie für diese Felder einen Wert angeben, auch wenn in den Pflichtfeldern bereits Daten vorhanden sind. Der Grund dafür ist, dass eine Four51 Aktualisierungsaktivitä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 Aktivitäten Four51 Update und Four51 -Patch-Update. Wenn Sie stattdessen nur bestimmte Felder für das zugehörige Objekt aktualisieren möchten, lesen Sie Four51 Connector Patch-Update.

Auf dieser Seite wird beschrieben, wie Sie in Four51 neue Daten erstellen oder vorhandene Daten ersetzen. Dabei wird das Ersetzen einer vorhandenen Käuferadresse mithilfe von Jitterbit als Beispiel verwendet. In diesem Beispiel wird dieselbe Käuferadresse ersetzt, die als Beispiel in Four51 Connector erstellen erstellt wurde.

Die folgenden Abschnitte gliedern sich in die Schritte „Starten der Aktualisierungsaktivität“, „Definieren der Operation “ und „Ausführen und Ausführen des Operation“.

Erstellen eines Four51 Operation

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

   • Gehen Sie zu Datei > Neu > Anschlüsse > Neues Four51 Update.
   • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie Four51 und wählen Sie dann Neues Four51 Update.
   • Doppelklicken Sie im Baum links unter Konnektoren auf die Kategorie Four51, klicken Sie dann mit der rechten Maustaste auf Four51 -Update-Aktivitäten und wählen Sie Neues Four51 Update.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup Four51 und dann Four51 Update aus.

2. Der Endpoint-Bildschirm des Four51 Update-Assistenten sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie Daten erstellen oder ersetzen möchten. Sie sollten Ihren Endpoint bereits in 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 Update Wizard helfen Ihnen dabei, zu dem spezifischen Objekt zu gelangen, in dem Sie Daten aktualisieren möchten. Der erste dieser Bildschirme, Abschnitt, fordert Sie auf, eine der aufgelisteten Kategorien der obersten Ebene in Four51 auszuwählen: „Authentifizierung“, „Käufer“, „Bestellung“, „Organisation“ oder „Benutzerperspektive“.

   Notiz

   Sie können herausfinden, welche Auswahl Sie treffen müssen, indem Sie auf die OrderCloud API verweisen. Beispielsweise entsprechen diese fünf Kategorien der obersten Ebene direkt denen, die auf der linken Seite der OrderCloud API Konsole aufgeführt sind. Auch die restlichen Objektauswahlbildschirme folgen der Organisation der OrderCloud API.

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

   

4. Der nächste Bildschirm im Four51 Update Wizard, genannt Ressource, zeigt die Ressourcen an, die im ausgewählten Abschnitt verfügbar sind. Da wir im Beispiel eine vorhandene Adresse ersetzen möchten, wählen wir „Adressen“ aus und klicken auf Weiter, um fortzufahren.

   

5. Der letzte Auswahlbildschirm im Four51 Update Wizard, genannt Resource Endpoint, zeigt die letzten Objekte an, die für die ausgewählte Ressource verfügbar sind. Im Beispiel wählen wir zum Ersetzen einer vorhandenen Adresse die Option „Adresse erstellen oder aktualisieren“ aus. Klicken Sie auf Fertig, um fortzufahren.

   Notiz

   Die für jede Abschnittsressource verfügbaren Endpoints hängen von der Art der für den Operation ausgewählten Four51 Aktivität ab (d. h. Erstellungs-, Lese-, Aktualisierungs-, Patch-Update- oder Löschaktivität).

   

6. Jitterbit erstellt dann eine API Anforderungs- und Antwortstruktur, die das Erstellen oder Ersetzen von Daten über die OrderCloud-API ermöglicht. In Studio sollte eine neue Tab mit dem Namen Four51 Update Activities angezeigt werden. Sie können Ihre Update-Aktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „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.

   

   Notiz

   Das „xp“ in der obigen Struktur steht für „Extended Properties“ und ist Teil der OrderCloud API. Mit dieser Eigenschaft können Sie den meisten Objekten benutzerdefinierte Felder hinzufügen. Weitere Informationen zur Verwendung der XP-Eigenschaft finden Sie unter Four51 Connector Advanced.

7. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dadurch wird die Jitterbit Operation erstellt, die eine neue Käuferadresse in Four51 erstellt oder eine vorhandene ersetzt.

8. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Aktualisierungsaktivität enthält.

   

   Notiz

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

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diesen Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Vorgänge und der Titel des Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Operation

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

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um die einzelnen Komponenten zu konfigurieren, oder Sie können Quelle, Anforderung, Antwort und Ziel separat erstellen und diese dann per Drag & Drop aus der Baumstruktur 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. Weitere Informationen zu zusätzlichen Anpassungsoptionen finden Sie im Design Studio Abschnitt 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 Operation klicken und Aus Diagramm entfernen auswählen.

  Hinweis

  In Jitterbit sind verschiedene Quelltypen verfügbar. Siehe Quellen für mehr.

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

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

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

  Notiz

  Weitere Informationen zu Anfragestrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Quelle, um die Quelle für die Transformation auszuwählen. Im Beispiel ist unsere Quelle fest codiert, daher wählen wir „Keine“ aus. Klicken Sie auf Fertig, um fortzufahren.

  2. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Elemente im Zielbaum rechts zu erweitern. Bei einer Transformation würden Sie jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen ziehen. Um in diesem Beispiel die Quelle hart zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden im Beispiel verwendeten Werte in das Script ein:

     ZIEL: INPUT > CreateorUpdateAddress > Parameter	Script
     Käufer-ID	<trans> "TestBuyerID0001" </trans>
     Adress-ID	<trans> "TestAddressID0000" </trans>

     Notiz

     Die obige Käufer-ID ist die vorhandene ID der Käuferorganisation, zu der sich die Adresse gehört, und die obige Adress-ID ist die vorhandene ID der neuen Adresse, die während der Erstellung des Four51 -Connectors erstellt wurde Beispiel.

     ZIEL: INPUT > CreateorUpdateAddress > RequestParameters	Script
     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>
     Staat	<trans> "CA" </trans>
     Postleitzahl	<trans> "654321" </trans>
     Land	<trans> "US" </trans>
     Telefon	<trans> "987654321" </trans>
     Adressname	<trans> "Test_2_Address" </trans>

     Notiz

     Die oben aufgeführten Werte ersetzen die während der Erstellung des Four51 Connectors erstellten Werte Beispiel.

     Nach dem Festcodieren der Quelle sollte Ihre Transformation ungefähr wie unten gezeigt aussehen.

     

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie ihn beim Standard. Verwenden Sie dann das Dropdown-Menü Ziel, um das Ziel für die Transformation auszuwählen. Im Beispiel möchten wir die Antwort der OrderCloud-API verwenden, also wählen wir „Four51 -Funktionsantwort“ aus. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel das Optionsfeld für den Aktivitätstyp aus, dessen Antwort Sie verwenden möchten. In diesem Fall möchten wir die Antwort der gerade eingerichteten Update-Aktivität verwenden, also wählen Sie „Update“. Klicken Sie auf Weiter, um fortzufahren.

  3. Der Ziel-Bildschirm zeigt nun ein Dropdown-Menü zur Auswahl der Aktivität an. Wählen Sie die Update-Aktivität aus, die Sie gerade eingerichtet haben. Die mit der ausgewählten Update-Aktivität verknüpften Anforderungs- und Antwortstrukturen sollten nun angezeigt werden. Klicken Sie auf Fertig, um fortzufahren.

  4. Die Tab Transformations sollte sich öffnen, wo Sie Ihr Mapping abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. Klicken Sie auf den Ordner „OUTPUT“ und ziehen Sie ihn von der linken Seite (Quellseite) in den Ordner „OUTPUT“ auf der rechten Seite (Zielseite). Ihr Mapping-Bildschirm sollte nun ungefähr wie unten aussehen.

     

Ihr konfigurierter Operation sollte dem unten gezeigten Beispiel ähneln.

Bereitstellen und Ausführen der Operation

Nachdem die Four51 Update-Aktivität vollständig konfiguriert ist, können wir den Operation einsetzen und ausführen.

1. Klicken Sie auf der Tab Operationen auf die einsetzen -Symbol.

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

3. Im unteren Teil des Bildschirms sollte der Operationsmonitor anzeigen, dass Ihr Operation erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Symbol Status doppelklicken, um alle Protokollmeldungen anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabeantwort sehen, die Ihrer Zieldatei „Update_File.txt“ zugeordnet wurde. Im 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 Operation 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. Wenn Sie außerdem die OrderCloud API Console unter Käufer > Adressen sollten Sie die Käuferadresse durch die neuen Informationen ersetzt vorfinden.