Four51 Connector Patch-Update im Jitterbit Design Studio

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

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

Diese Seite beschreibt, wie mehrere vorhandene Objektfelder in Four51 aktualisiert werden, anhand eines Beispiels zur teilweisen Aktualisierung einer bestehenden Käuferadresse mit Jitterbit. Dieses Beispiel aktualisiert die gleiche Käuferadresse, die als Beispiel im Four51-Connector-Erstellen erstellt und im Four51-Connector-Update ersetzt wurde.

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

Erstellen einer 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 öffnet den Four51 Patch Update Wizard, der Sie durch den Prozess führt.

   • Gehen Sie zu Datei > Neu > Connectoren > Neues Four51 Patch Update.
   • Klicken Sie im Baum auf der linken Seite unter Connectoren mit der rechten Maustaste auf die Kategorie Four51 und wählen Sie dann Neues Four51 Patch 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 Patch Update Aktivitäten und wählen Sie Neues Four51 Patch Update.
   • Klicken Sie in der oberen Symbolleiste auf das Connector-Symbol (orangefarbener Puzzlestück) . Wählen Sie im Popup Four51 und dann Four51 Patch Update.

2. Der Bildschirm Endpoint des Four51 Patch Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, von dem Sie Patch-Update-Daten erhalten möchten. Sie sollten Ihren Endpunkt bereits im 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 Patch Update Wizard helfen Ihnen, das spezifische Objekt zu finden, für das Sie Patch-Update-Daten benötigen. 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 den auf der linken Seite der OrderCloud API-Konsole aufgeführten. Die verbleibenden Auswahlbildschirme für Objekte folgen ebenfalls der Organisation der OrderCloud API.

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

   

4. Der nächste Bildschirm im Four51 Patch Update Wizard, genannt Ressource, zeigt die innerhalb des ausgewählten Abschnitts verfügbaren Ressourcen an. Im Beispiel, da wir eine bestehende 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 Ressourcenendpunkt, zeigt die finalen Objekte an, die für die ausgewählte Ressource verfügbar sind. Im Beispiel, um eine bestehende Adresse teilweise zu aktualisieren, wählen wir die Option "Teilweise Adresse 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 aktualisieren. Ein neuer Tab sollte im Studio erscheinen, der Four51 Patch Update Activities heißt. Sie können Ihre Patch-Aktualisierungsaktivität hier umbenennen, wenn gewünscht; in unserem Beispiel heißt sie "Four51 Patch Update - Käufer > Adressen > Teilweise Adresse aktualisieren." Sie können auch die + - Tasten 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. Als Nächstes klicken Sie 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 festgelegten Felder zur Aktualisierung werden während des Transformationsschritts der Operation definiert, der im nächsten Abschnitt beschrieben wird.

8. Ein neuer Tab sollte in Studio mit dem Namen Operationen geöffnet werden, der eine grafische Darstellung der Patch-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 Mehrfach-Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf dem Tab Operationen und der Titel der Operation verschwinden, da Ihre neue Patch-Aktualisierungsaktivitä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 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 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, lesen Sie 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 Quelltypen ist in Jitterbit verfügbar. Siehe Quellen für weitere Informationen.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im 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. 'Patch 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 'Patch_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 Quelltyp. 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 Anforderungsstrukturen 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ü Quelle, um die Quelle für die Transformation auszuwählen. In diesem Beispiel ist unsere Quelle fest codiert, also 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. In 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 > PartiallyUpdateAddress > Parameter	Skript
     buyerID	<trans> "TestBuyerID0001" </trans>
     addressID	<trans> "TestAddressID0000" </trans>

     Hinweis

     Die oben angegebene buyerID ist die bestehende ID der Käuferorganisation, zu der die Adresse gehört, und die oben angegebene addressID ist die bestehende ID der neuen Adresse, die während des Beispiels Four51 connector create erstellt wurde.

     ZIEL: EINGABE > PartiallyUpdateAddress > RequestParameters	Skript
     Vorname	<trans> "Aktualisierter Vorname" </trans>
     Nachname	<trans> "Aktualisierter Nachname" </trans>

     Hinweis

     Die oben aufgeführten Felder, die ursprünglich während des Beispiels Four51 connector create erstellt und während des Beispiels Four51 connector update ersetzt wurden, werden mit den neuen bereitgestellten Werten aktualisiert. Die verbleibenden Felder für das Objekt werden nicht aktualisiert.

     Nachdem Sie die Quelle fest codiert haben, 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 Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder lassen Sie ihn als Standard. 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, für die Sie die Antwort verwenden möchten. In diesem Fall möchten wir die Antwort von der Patch-Update-Aktivität verwenden, die wir gerade eingerichtet haben, also wählen Sie "Patch_update." 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 Patch-Update-Aktivität, die Sie gerade eingerichtet haben. Die Anforderungs- und Antwortstrukturen, die mit der ausgewählten Patch-Update-Aktivität verbunden sind, 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 wie unten aussehen.

     

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

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Four51-Patch-Update-Aktivitä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 Ihre Operation erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Status-Symbol doppelklicken, um alle Protokollnachrichten anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabereaktion 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 von '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">
       <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. Darüber hinaus sollten Sie, wenn Sie die OrderCloud API-Konsole unter Käufer > Adressen überprüfen, die Käuferadresse mit den neuen Informationen aktualisiert finden.