Utilisation de l'activité Marketo Rechercher objets

Utilisez l'activité Rechercher objets pour extraire de Marketo les détails des objets.

Pourquoi et quand exécuter cette tâche

Cette tâche permet de rechercher dans l'instance Marketo des objets en fonction de la valeur de filtre indiquée. 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.

Procédure

  1. Dans une orchestration active, ouvrez l'onglet Activités et développez le contenu du dossier Marketo.
  2. Faites glisser l'icône de l'activité Rechercher objets sur l'orchestration. Sélectionnez l'activité. La liste de contrôle de l'activité Marketo Rechercher objets s'affiche.
  3. Dans la liste de contrôle, cliquez sur Récapitulatif.
  4. Vérifiez le contenu de la zone Nom d'activité et apportez les modifications nécessaires.
  5. Dans la liste de contrôle, cliquez sur Sélectionner le noeud final.
  6. Cliquez sur Parcourir et utilisez la boîte de dialogue Explorateur de projets pour sélectionner le noeud final Marketo approprié.
  7. Facultatif : vous pouvez créer le noeud final en cliquant sur Nouveau et en spécifiant les détails de connexion requis. Cliquez sur OK pour sauvegarder et utiliser le noeud final pour cette configuration.
  8. Pour apporter des modifications à la configuration du noeud final sélectionné, cliquez sur Editer pour accéder aux options dans une fenêtre distincte. Toute modification effectuée affecte globalement toutes les utilisations de ce noeud final dans les orchestrations actives.
  9. Dans la liste de contrôle, cliquez sur Configurer.
  10. Cliquez sur Parcourir pour sélectionner le type d'objet. La fenêtre Parcourir Marketo s'affiche.
  11. Dans la fenêtre Parcourir Marketo, vous pouvez sélectionner le type d'objet dans la liste des types d'objet. Cliquez sur OK.
  12. Dans la Liste de contrôle, sélectionnez Réessayer. Passez en revue les paramètres par défaut et procédez aux modifications requises.
  13. 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é Rechercher objets s'affichent sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
  14. 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'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web. Si aucune valeur n'est fournie au moment de l'exécution pour un paramètre d'entrée facultatif, aucune exception n'est émise lors de l'exécution.
  15. 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é.
  16. Créez une mappe entre les paramètres de sortie et les variables d'orchestration.

Résultats

Vous venez de configurer l'activité Marketo Rechercher objets.
Remarque :

Vous pouvez ajouter plusieurs objets en entrée à cette activité. Pour ce faire, cliquez avec le bouton droit sur la zone Id (par exemple, Campagne) dans le panneau Vers l'activité de Mapper les entrées, puis sélectionnez Développer les occurrences.

En outre, vous pouvez ajouter plusieurs valeurs de zones et de filtres en entrée de l'activité (par exemple : Opportunité commerciale). Pour ajouter plusieurs valeurs en entrée, cliquez avec le bouton droit sur les zones filterValues et fields dans le panneau Vers l'activité de Mapper les entrées, puis sélectionnez Développer les occurrences.

Tableau 1. Détails des zones d'entrée
Nom de zone Description
filterType La valeur de ce paramètre est fonction des types de filtre pris en charge pour l'objet.
filterValues Valeur utilisée pour l'opération de recherche ; l'utilisateur peut fournir plusieurs valeurs en développant ce noeud.
fields Liste des noms de zone à renvoyer dans la réponse. Si le paramètre fields n'est pas inclus dans cette demande, les zones par défaut correspondant aux objets seront renvoyées.
batchSize Nombre d'enregistrements à renvoyer dans un appel unique (la valeur par défaut est fonction de l'API Marketo. Valeur actuelle : 300)
nextPageToken Permet la pagination dans des ensembles de résultats volumineux