Utilisation de l'activité Marketo Extraire tous les objets

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

Pourquoi et quand exécuter cette tâche

Cette tâche permet d'extraire dans l'instance Marketo les détails de tous les objets. 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é Extraire tous les objets sur l'orchestration. Sélectionnez l'activité. La liste de contrôle de l'activité Marketo Extraire tous les 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.

    Les deux paragraphes ci-dessous (étapes 13 et 14) ne sont pas applicables pour l'objet Activity Type dans la mesure où aucune entrée n'est requise pour cette activité.

  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é Extraire tous les 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.
    Tableau 1. Zones obligatoires
    Nom d'objet Zone Description
    Folder Content FolderId Obligatoire
    Lead Object
    • retrieveBy
    • id
    • Valeurs possibles de retrieveBy : ListId et ProgramId
    • La valeur de l'ID correspond à l'ID de la liste ou du logiciel dont les détails d'opportunités commerciales sont requis
    Lead Activity
    • ActivityTypeId
    • nextPageToken
    • L'activité atomique Extraire jeton de pagination permet d'obtenir la valeur de nextPageToken.
    • Plusieurs activityTypeId peuvent être fournis dans une seule demande dans la mesure où ce paramètre est sans limite.
    Segments SegmentationId Obligatoire
    Tableau 2. Paramètres communs
    Nom d'objet Zone
    offset Point de départ lors de l'extraction d'entrées. Peut être utilisé conjointement avec le paramètre maxReturn pour effectuer une pagination dans des ensembles de résultats volumineux. Valeur par défaut : 0
    maxReturn Nombre maximal d'entités à renvoyer. Valeur par défaut : 20. Valeur maximale : 200.
    batchSize Nombre d'enregistrements à renvoyer dans un appel unique (la valeur par défaut et maximale est fonction de l'API Marketo. Valeur actuelle : 300)
    nextPageToken Permet la pagination dans des ensembles de résultats volumineux

Résultats

Vous venez de configurer l'activité Marketo Extraire tous les objets.