Patch-Update für Four51 -Anschluss im Jitterbit Design Studio

Die Four51 -Patch-Update-Aktivität ist im Four51 -Connector verfügbar ermöglicht Ihnen, vorhandene Daten in Four51 über die OrderCloud API zu aktualisieren. Im Gegensatz zur Four51 Aktualisierungsaktivität können Sie mit der Four51 -Patch-Aktualisierungsaktivität nur die Felder aktualisieren, die Sie aktualisieren möchten, und nicht alle Felder für das zugehörige Objekt.

Das teilweise oder vollständige Aktualisieren von Objektfeldern ist ein wichtiger Unterschied zwischen dem Four51 -Patch-Update und den Four51 -Update-Aktivitäten. Wenn Sie stattdessen alle Felder ersetzen oder einen neuen Datensatz erstellen möchten, falls keiner vorhanden ist, lesen Sie Four51 Connector-Update.

Auf dieser Seite wird beschrieben, wie Sie mehrere vorhandene Objektfelder in Four51 aktualisieren. Dabei wird ein Beispiel für die teilweise Aktualisierung einer vorhandenen Käuferadresse mit Jitterbit verwendet. In diesem Beispiel wird dieselbe Käuferadresse aktualisiert, die als Beispiel in Four51 Connector erstellen erstellt wurde und ersetzt innerhalb von Four51 Connector Update.

Die folgenden Abschnitte gliedern sich in das Beginnen der Patch-Aktualisierungsaktivität, das Definieren der Operation und das Bereitstellen und Ausführen des Operation.

Erstellen eines Four51 -Patch-Update Operation

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

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

2. Der Endpoint-Bildschirm des Four51 Patch Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in den Sie Patch-Update-Daten erhalten 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 Patch Update Wizard helfen Ihnen dabei, zu dem spezifischen Objekt zu gelangen, in dem Sie Daten patchen und 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 teilweise aktualisieren, daher wählen wir den Bereich „Käufer“ aus und klicken auf Weiter, um fortzufahren.

   

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

   

5. Der letzte Auswahlbildschirm im Four51 Patch Update Wizard, genannt Resource Endpoint, zeigt die letzten für die ausgewählte Ressource verfügbaren Objekte an. Im Beispiel wählen wir die Option „Adresse teilweise aktualisieren“, um eine vorhandene Adresse teilweise zu aktualisieren. 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 eine Datenaktualisierung über die OrderCloud API ermöglicht. In Studio sollte eine neue Tab mit dem Namen Four51 Patch Update Activities angezeigt werden. Sie können Ihre Patch-Update-Aktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Four51 Patch Update - Käufer > Adressen > Adresse teilweise 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 vorhandene Käuferadresse in Four51 teilweise aktualisiert. Die angegebenen zu aktualisierenden Felder werden während des Transformation der Operation definiert, der im nächsten Abschnitt unten beschrieben wird.

8. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Patch-Update-Aktivitä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 Patch-Update-Aktivitä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 angezeigt werden, 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. „Patch-Update-Ziel“). 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 „Patch_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 > PartiallyUpdateAddress > 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 > PartiallyUpdateAddress > RequestParameters	Script
     Vorname	<trans> "Updated First" </trans>
     Nachname	<trans> "Updated Last" </trans>

     Notiz

     Die oben aufgeführten Felder wurden ursprünglich während der Erstellung des Four51 Connectors erstellt Beispiel und während des Four51 Connector-Updates ersetzt wird beispielsweise mit den neuen bereitgestellten Werten aktualisiert. Die übrigen Felder für das Objekt werden nicht aktualisiert.

     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 Patch-Update-Aktivität verwenden, die wir gerade eingerichtet haben. Wählen Sie daher „Patch_update“. Klicken Sie auf Weiter, um fortzufahren.

  3. Auf dem Ziel-Bildschirm wird nun ein Dropdown-Menü zur Auswahl der Aktivität angezeigt. Wählen Sie die Patch-Update-Aktivität aus, die Sie gerade eingerichtet haben. Die mit der ausgewählten Patch-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 -Patch-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 „Patch_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">
       <PartiallyUpdateAddress>
           <Status>1</Status>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test 2 Company</CompanyName>
                   <FirstName>Updated First</FirstName>
                   <LastName>Updated 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>
       </PartiallyUpdateAddress>
   </ns:OUTPUT>
   

5. Wenn Sie außerdem die OrderCloud API Console unter Käufer > Adressen sollten Sie die Käuferadresse mit den neuen Informationen aktualisiert vorfinden.