Utilisez SOQL (Sforce Object Query Language) pour exécuter une requête sur un ou plusieurs types d'objet Salesforce.com à partir de cette activité et renvoyer un ensemble de résultats. L'activité Demander objets exécute automatiquement une requête ou un appel queryAll suivi d'appels queryMore continus pour tous les enfants et objets renvoyés depuis Salesforce.com.
Remarque : L'exécution de l'activité Demander objets peut se traduire par l'ouverture d'un curseur par Salesforce.com pour effectuer le suivi des résultats de requête. Si l'activité atteint la limite de curseur allouée par Salesforce.com à chaque utilisateur ou si le curseur arrive à expiration, le dispositif d'intégration relance l'activité.
Utilisation de l'activité Demander objets
- Dans l'onglet Activités, ouvrez le répertoire Salesforce.com pour rechercher l'activité Demander objets.
- Ajoutez l'activité à votre
orchestration.
La liste de contrôle et le récapitulatif de l'activité sont affichés sous l'orchestration.
- Sélectionnez un noeud final Salesforce.com.
Vous trouverez des instructions sur la création et l'édition d'un noeud final Salesforce.com dans Création ou édition d'un noeud final Salesforce.com.
- Configurez
l'activité en spécifiant une requête et en définissant des options de requête.
- Spécifiez les paramètres Réessayer et Dépassement de délai pour l'activité.
- Mappez l'entrée de l'activité.
- Mappez la sortie de l'activité.
Mapper l'entrée de l'activité Demander objets
- Dans Liste de contrôle, sélectionnez Mapper les entrées.
L'élément paramètres s'affiche dans le panneau Vers l'activité. L'élément paramètres comporte un élément enfant pour chaque paramètre que vous avez spécifié dans la requête SOQL.
Le contexte pour le paramètre de la requête détermine le type de paramètre. Si vous n'avez pas indiqué de paramètre, aucun enfant ne s'affiche sous l'élément paramètres.
- Cliquez avec le bouton droit de la souris sur le noeud par défaut et choisissez Afficher les paramètres facultatifs pour afficher les paramètres d'entrée facultatifs pour cette activité :
- MruHeader
- CallOptions
- connection
- sessionInfo
- Cliquez sur Sélectionner des entrées et sélectionnez la ou les variable(s) d'entrée de la mappe.
Vous trouverez des instructions sur la création de variables dans Création de
variables.
- Selon les cas, mappez les paramètres d'entrée sur la ou les variable(s).
Vous trouverez des instructions sur le mappage dans Création d'une mappe.
Mapper la sortie de l'activité Demander objets
- Dans la Liste de contrôle, sélectionnez Mapper les sorties.
L'élément objets apparaît dans le panneau Depuis l'activité. Le paramètre obtenu comporte un élément unique appelé objets avec un élément unique répété nommé selon l'objet de démarrage de la requête.
L'objet de démarrage est le premier objet nommé dans la clause FROM de la requête. Par exemple, dans l'instruction SOQL suivante, Account est l'objet de démarrage :
Select Name from Account, Account.Contacts
L'objet de démarrage comporte des éléments enfant qui correspondent aux zones ou aux relations répertoriées dans la clause
SELECT d'une requête.
Le schéma est défini comme suit :
- Pour les zones, le type de zone correspond au type SOAP de la zone.
Le type de zone admet les valeurs NULL si le type SOAP admet les valeurs NULL
- Pour les relations des éléments parent, le nom de l'élément est le nom du parent. S'il n'y a pas de parent lorsque l'activité exécute la requête, l'élément est absent. Les zones ou les relations du parent s'affichent directement sous l'élément de relation.
- Pour les relations des éléments enfant, le nom de l'élément est le nom de l'enfant. L'élément de relation a un élément répété unique nommé selon le type d'objet de l'objet enfant. Les zones ou les
relations de l'enfant s'affichent directement sous l'élément de type d'objet. S'il n'y a pas d'enfant lorsque l'activité exécute la requête, l'élément est absent.
- Si vous n'avez pas sélectionné de zones ou de relations,
mais que vous indiquez count() dans la clause SELECT, la totalité de l'élément de type d'objet est remplacé par un élément appelé count de type unsignedInt.
- Cliquez sur Sélectionner des sorties et sélectionnez la ou les variables de sortie de la mappe.
Vous trouverez des instructions sur la création de variables dans Création de
variables.
- Selon les cas, mappez les paramètres de sortie sur la ou les variable(s).
Vous trouverez des instructions sur le mappage dans Création d'une mappe.