Zuora-Aktivität 'Objekte abfragen' verwenden

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

  1. Öffnen Sie in einer aktiven Orchestrierung die Registerkarte Aktivitäten und blenden Sie den Inhalt des Ordners Zuora ein.
  2. 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.
  3. Klicken Sie in der Prüfliste auf Zusammenfassung.
  4. Prüfen Sie den Inhalt des Felds Aktivitätsname und nehmen Sie die erforderlichen Änderungen vor.
  5. Klicken Sie in der Prüfliste auf Endpunkt auswählen.
  6. Klicken Sie auf Durchsuchen und verwenden Sie das Dialogfenster Projektexplorer, um den relevanten Zuora-Endpunkt auszuwählen.
  7. 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.
    Anmerkung: Weitere Informationen finden Sie in Zuora-Endpunkt erstellen und bearbeiten.
  8. 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.
  9. 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.
  10. 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.
  11. 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.
  12. 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.