Zum Inhalt springen

Erweiterter Four51 -Anschluss im Jitterbit Design Studio

Die folgenden Elemente umfassen erweiterte Optionen, Tipps und Links zu anderen Referenzmaterialien, die für Four51 Integrationen nützlich sein können.

Erweiterte Eigenschaften

Die von der OrderCloud API bereitgestellte Eigenschaft „Erweiterte Eigenschaften“ (XP) ermöglicht das Hinzufügen benutzerdefinierter Felder zu den meisten Objekten.

Wenn ein Objekt in Jitterbit die OrderCloud XP-Eigenschaft unterstützt, generiert der Four51 Connector die XP-Eigenschaft in den Anforderungs- und Antwortschemata dieses Objekts. Die XP-Eigenschaft kann in create verwendet werden, aktualisieren, Patch-Update oder löschen Aktivitäten. Darüber hinaus steht die XP-Eigenschaft zum Filtern, Sortieren und Suchen in allen Leseaktivitäten für Endpoints mit mehreren Datensätzen (d. h. enthält eine Datensatzliste, aber keinen einzelnen Datensatz).

Wenn Sie beispielsweise die XP-Eigenschaft verwenden möchten, um ein benutzerdefiniertes Feld „Vorherige Adresse“ hinzuzufügen, doppelklicken Sie in Ihrer Transformation auf die XP-Eigenschaft und fügen Sie dem Script Folgendes hinzu:

<trans>
"<PreviousAddress>
     <Street1>451 First Street</Street1>
     <Street2>West Gravino Blvd</Street2>
     <City>Alameda</City>
    <State>CA</State>
</PreviousAddress>"
</trans>

Im obigen Beispiel verwenden wir XML innerhalb einer Zeichenfolge, die in Anführungszeichen in einem Standard-Jitterbit Script eingeschlossen ist. Nach dem Bereitstellen und Ausführen des Operation können Sie die OrderCloud API Konsole überprüfen und finden Sie die enthaltenen Daten.

Anhang

Notiz

Weitere Informationen zur XP-Eigenschaft finden Sie in der Four51 Dokumentation zu Erweiterten Eigenschaften.

Große Datenmengen

Seitennummerierung

Die Paginierung wird vom Jitterbit Four51 Connector unterstützt. Informationen zur Paginierung, die von der OrderCloud-API zurückgegeben werden, werden in Jitterbit innerhalb der Antwort-XML unter dem Meta-Tag bereitgestellt. Ein Beispiel finden Sie unten. Wenn viele Datensätze zurückgegeben werden und Sie die Paginierung anpassen möchten, können Sie dies mithilfe des Meta-Objekts tun.

<Meta>
<Page>1</Page>
<PageSize>20</PageSize>
<TotalCount>25</TotalCount>
<TotalPages>2</TotalPages>
<ItemRange>
<StartItem>1</StartItem>
<EndItem>20</EndItem>
</ItemRange>
</Meta>

Notiz

Weitere Informationen zur Verwendung von Meta-Tags finden Sie in der Four51 Dokumentation zur Paginierung.

Suche

Die Suche wird vom Jitterbit Four51 Connector unterstützt. Sie können innerhalb der CloudOrder API direkt nach großen Datensätzen suchen, indem Sie den Suchparameter angeben. Ein Beispiel für die Suche in allen Feldern finden Sie unten.

<Parameters>
<search>smith<search>
</Parameters>

Das folgende Beispiel beschränkt die Suche auf bestimmte Felder, die in der gesuchten Ressource verfügbar sind.

<Parameters>
<search>smith<search>
<searchOn>LastName,UserName<searchOn>
</Parameters>

Notiz

Weitere Informationen zum Suchen und Kombinieren von Abfragen finden Sie in der Four51 Dokumentation zum Thema Suchen.

Filtern

Das Filtern wird vom Jitterbit Four51 Connector unterstützt. Sie können große Listen von Elementen direkt innerhalb der CloudOrder API filtern, indem Sie einen Filter angeben.

<Filter>
    <key>lastname</key>
    <value>smith</value>
</Filter>

Filter unterstützen Platzhalter, logisches ODER, Negieren, logisches UND und Größer als / Kleiner als für Datums- und numerische Werte. Beispiele finden Sie unten.

Wildcard

<Filter>
    <key>lastname</key>
    <value>*smith</value>
</Filter>

LogischesODER

<Filter>
    <key>lastname</key>
    <value>Smith|Jo</value>
</Filter>

Negieren

<Filter>
    <key>lastname</key>
    <value>!Smith</value>
</Filter>

Notiz

Weitere Informationen zum Filtern, zu Leistungsaspekten und zum Kombinieren von Abfragen finden Sie in der Four51 Dokumentation zum Thema Filtern.

Sortierung

Das Sortieren wird vom Jitterbit Four51 Connector unterstützt. Sie können große Listen von Elementen direkt innerhalb der CloudOrder API sortieren, indem Sie die Sortierreihenfolge angeben. Ein Beispiel finden Sie unten.

<Parameters>
<soryBy>LastName<sortBy>
</Parameters>

Notiz

Weitere Informationen zum Sortieren und Kombinieren von Abfragen finden Sie in der Four51 Dokumentation zum Thema Sortieren.

Identitätswechsel beim Benutzer

Wenn Sie im Namen eines bestehenden Käuferbenutzers mit der CloudOrder API interagieren möchten, können Sie dies mit der Benutzer-„Identitätswechsel“-Funktion tun, die von der CloudOrder API bereitgestellt wird. Stellen Sie sicher, dass der Käuferbenutzer, dessen Identität Sie annehmen möchten, über eine Anwendung mit zugehöriger Client-ID und dem entsprechenden zugewiesenen Sicherheitsprofil verfügt. Danach sollten Sie in der Lage sein, Ihren Four51 Endpoint einzurichten wie gewohnt mit den Anmeldeinformationen für den imitierten Benutzer.

Notiz

Weitere Informationen zur Identitätsdiebstahl finden Sie in der Four51 Dokumentation zu Identitätsdiebstahl.

Entwurfsmuster

Die folgenden Entwurfsmuster können für Four51 Integrationen nützlich sein: