Verwenden Sie die Zuora-Aktivität 'Objekte abfragen', um Objekte wie z. B.
'Product', 'Account' oder 'RatePlan' aus der Zuora-Anwendung abzufragen.
Die Abfragezeichenfolge, die Sie für diese Operation angeben, muss dem
Object Query Language-Standard von Zuora entsprechen.
Informationen zu diesem Vorgang
Verwenden Sie diese Task, um Objekte aus der Zuora-Anwendung abzufragen.
Der Aufruf dieser Aktivität
ist ein synchroner Aufruf, bei dem die Eingabedaten zur Verarbeitung an die Aktivität
gesendet werden und die Antwort zurück an die Orchestrierung gesendet
wird.
Führen Sie folgende Schritte aus, um die Zuora-Aktivität
'Objekte abfragen' zu konfigurieren:
Vorgehensweise
- Öffnen Sie in einer aktiven Orchestrierung die Registerkarte Aktivitäten
und blenden Sie den Inhalt des Ordners Zuora ein.
- Ziehen Sie das Symbol für die Aktivität Objekte abfragen
auf die Orchestrierung. Die Prüfliste der Zuora-Aktivität
'Objekte abfragen' wird angezeigt.
- Klicken Sie in der Prüfliste auf Zusammenfassung.
- Prüfen Sie den Inhalt des Felds Aktivitätsname und nehmen Sie die erforderlichen
Änderungen vor.
- Klicken Sie in der Prüfliste auf Endpunkt auswählen.
- Klicken Sie auf Durchsuchen und verwenden Sie das Dialogfenster
Projektexplorer, um den relevanten Zuora-Endpunkt
auszuwählen.
- Optional: Sie können den Endpunkt erstellen, indem Sie auf Neu klicken
und die erforderlichen Verbindungsdetails angeben. Klicken Sie auf Verbindung testen,
um zu prüfen, ob eine erfolgreiche Verbindung zur Zuora-Anwendung hergestellt wurde. Klicken Sie auf OK,
um den Endpunkt zu speichern und für diese Konfiguration zu verwenden.
- Zum Ausführen erforderlicher Änderungen an der ausgewählten Endpunktkonfiguration klicken
Sie auf Bearbeiten, um auf die Optionen in einem separaten Fenster zuzugreifen. Alle Änderungen, die Sie global ausführen, haben Auswirkungen auf alle Verwendungen des Endpunkts in aktiven
Orchestrierungen.
- Wählen Sie Eingaben zuordnen in der
Prüfliste aus.
Die XML-Schemas, die aus dem ausgewählten Objekt der Aktivität
Objekte abfragen generiert wurden, werden als Knoten unter dem
Anforderungseingabeparameter im Fenster An Aktivität angezeigt.
- Erstellen Sie eine Zuordnung zwischen den Orchestrierungsvariablen und
dem Eingabeparameter der Aktivität.
Anmerkung: Während der Ausführung müssen Werte für obligatorische Elemente der Eingabestruktur angegeben werden. Ein Wert kann angegeben werden, indem ein Standardwert für ein Element eingegeben wird oder indem das Element
mit einem Eingabeknoten verknüpft wird. Wenn während der Ausführung kein Wert für ein obligatorisches Element
angegeben wird, wird die Aktivität abgeschlossen und das Ergebnis von queryResponse enthält eine
Fehlernachricht. Anhand der Antwort der Aktivität können Sie ersehen,
ob die Anforderung fehlgeschlagen ist oder erfolgreich ausgeführt wurde.
- Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus.
Das XML-Schema, das zur Aufnahme der Antwort der Aktivität generiert wurde, wird als Knoten unter dem
Antwortausgabeparameter im Fenster Von Aktivität angezeigt.
- Erstellen Sie eine Zuordnung zwischen den Ausgabeparametern und den
Orchestrierungsvariablen.
Anmerkung: Die Ausgabe der Aktivität 'Objekte abfragen' ist das Element queryResponse, das eine generische Struktur besitzt.
Wenn Die Ausgabe der Aktivität 'Objekte abfragen' in einer späteren Aktivität verwendet werden muss, kann keine
direkte Zuordnung ausgeführt werden. Die Daten müssen aus dem Element queryResponse mithilfe
der Aktivität 'XSLT anwenden' extrahiert werden.
Beispiel für XSLT, das zum Extrahieren bestimmter Daten verwendet werden kann:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:ns1="http://api.zuora.com/" xmlns:ns2="http://object.api.zuora.com/">
<xsl:template match="/ns1:queryResponse/ns1:result">
<xsl:element name="Products">
<xsl:apply-templates select="ns1:records" />
</xsl:element>
</xsl:template>
<xsl:template match="ns1:records">
<xsl:element name="Product">
<xsl:element name="Id">
<xsl:value-of select="ns2:Id"/>
</xsl:element >
<xsl:element name="Name">
<xsl:value-of select="ns2:Name"/>
</xsl:element >
<xsl:element name="SKU">
<xsl:value-of select="ns2:SKU"/>
</xsl:element >
<xsl:element name="EffectiveStartDate">
<xsl:value-of select="ns2:EffectiveStartDate"/>
</xsl:element >
<xsl:element name="EffectiveEndDate">
<xsl:value-of select="ns2:EffectiveEndDate"/>
</xsl:element >
<xsl:element name="Description">
<xsl:value-of select="ns2:Description"/>
</xsl:element >
</xsl:element>
</xsl:template>
</xsl:stylesheet>
Ergebnisse
Sie haben die Zuora-Aktivität 'Objekte abfragen' konfiguriert.