Utilisez l'activité Zuora RatePlan pour interroger des objets tels que Product, Account, ou RatePlan dans l'application Zuora.
La chaîne de requête que vous spécifiez pour cette opération doit se conformer à la norme ZOQL (Zuora Object Query Language).
Pourquoi et quand exécuter cette tâche
Utilisez cette tâche pour interroger des objets de l'application Zuora.
L'appel de cette activité est un appel synchrone
lorsque les données entrées sont envoyées à l'activité pour traitement et que la réponse
est renvoyée à l'orchestration.
Pour configurer l'activité Zuora Demander objets, procédez comme suit :
Procédure
- Depuis une orchestration active, ouvrez l'onglet Activités et développez le contenu du dossier Zuora.
- Faites glisser l'icône de l'activité Demander objets sur
l'orchestration. La liste de contrôle Zuora Demander objets s'affiche.
- Dans la Liste de contrôle, sélectionnez
Récapitulatif.
- Vérifiez le contenu de la zone Nom d'activité et apportez éventuellement les modifications nécessaires.
- Dans la Liste de contrôle, cliquez sur Sélectionner le noeud final.
- Cliquez sur Parcourir et utilisez la boîte de dialogue de l'explorateur de projet pour sélectionner le noeud final Zuora pertinent.
- Facultatif : Vous pouvez créer le noeud final en cliquant sur Nouveau et en spécifiant
les détails de connexion requis. Cliquez sur Tester la connexion pour vérifier que la connexion à l'application
Zuora a abouti. Cliquez sur OK pour sauvegarder et utiliser le noeud final
pour cette configuration.
- Pour apporter des modifications à la configuration du noeud final sélectionné, cliquez sur Editer pour accéder aux options dans une fenêtre distincte. Les modifications que vous effectuez affectent globalement toutes les utilisations du noeud final dans les
orchestrations actives.
- Sélectionnez Mapper les entrées dans la Liste de contrôle.
Les schémas XML générés à partir de l'objet sélectionné de l'activité Demander objets s'affichent
sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
- Créez une mappe entre les variables d'orchestration et le paramètre d'entrée de l'activité.
Remarque : Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires de la structure d'entrée. Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en reliant l'élément avec un noeud d'entrée. A l'exécution, si aucune valeur n'a été spécifiée pour un élément obligatoire, l'activité s'achève et le
résultat de queryResponse est renseigné avec un message d'erreur. Vous pouvez déterminer si la demande a échoué ou abouti en examinant la réponse de l'activité.
- Sélectionnez Mapper les sorties dans la Liste de contrôle.
Le schéma XML généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds sous le paramètre de sortie de
réponse dans le panneau Depuis l'activité.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.
Remarque : La sortie de l'activité Demander objets est
queryResponse, dont la structure est générique.
Si la sortie de l'activité Demander objets doit être utilisée dans une activité
ultérieure, un mappage direct n'est pas possible. Les données doivent être
extraites de queryResponse à l'aide de
l'activité Appliquer une transformation XSL.
Exemple de transformation XSL utilisable pour extraire des
données spécifiques :
<?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>
Résultats
Vous venez de configurer l'activité Zuora Demander objets.