Utilisation de l'activité Eloqua Bulk API Mettre à jour la définition d'importation
Utilisez l'activité Mettre à jour la définition d'importation pour mettre à jour une définition d'importation dans Eloqua.
Cette tâche permet de mettre à jour une définition d'importation dans Eloqua. 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é Eloqua Bulk API Mettre à jour une définition d'importation, procédez comme suit :
- Dans une orchestration active, ouvrez l'onglet Activités et développez le contenu du dossier Eloqua Bulk API.
- Faites glisser l'activité Mettre à jour une définition d'importation dans l'orchestration. La liste de contrôle de l'activité Eloqua Bulk API Mettre à jour une définition d'importation s'affiche.
- Dans la liste de contrôle, cliquez sur Récapitulatif.
- Vérifiez le contenu de la zone Nom d'activité et apportez 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 Explorateur de projets pour sélectionner le noeud final Eloqua Bulk API approprié.
- 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.
- Dans la liste de contrôle, cliquez sur Configurer.
- Cliquez sur Parcourir pour sélectionner le type d'objet. La fenêtre Parcourir Eloqua Bulk API s'affiche.
- Dans cette fenêtre, vous pouvez filtrer le type d'objet en spécifiant le type d'objet dans la zone Rechercher un type d'objet ou sélectionnez le type d'objet dans la liste de type d'objet. Cliquez sur OK. Les préférences de zone d'objet s'affichent.
- Dans Préférences de la zone d'objet, sélectionnez les zones que vous aimeriez mapper en sélectionnant les cases des noms de zones correspondantes.
- Dans la liste de contrôle, cliquez sur Réessayer. Passez en revue les paramètres par défaut et procédez aux modifications requises.
- 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é Mettre à jour une définition d'importation 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é.
Zones obligatoires : l'activité comporte les zones obligatoires suivantes :
- id : ID de la définition d'importation existante.
- name : nom de la définition.
- identifierFieldName : indique quelle zone utiliser pour que les données importées correspondent aux données Eloqua existantes.
- fields : comporte les zones suivantes :
- sourceField : un des noms de colonne issus des données source.
- EloquaDestinationField : nom de colonne Eloqua vers lequel les données sourceField sont mappées.
Zones facultatives : l'activité comporte les zones facultatives suivantes :
- autoDeleteDuration : délai jusqu'à la suppression de la définition.
- dataRetentionDuration : délai jusqu'à la suppression des données transférées.
- isUpdatingMultipleMatchedRecords : indique si Eloqua doit mettre à jour plusieurs enregistrements si plusieurs enregistrements correspondent à la zone identifierFieldName.
- updateRule : les types de règle suivants sont disponibles :
- always : permet la mise à jour systématique.
- ifNewIsNotNull : permet la mise à jour si la nouvelle valeur n'est pas à blanc.
- ifExistingIsNull : permet la mise à jour si la valeur existante est à blanc.
- useFieldRule : permet d'utiliser la règle définie au niveau de la zone.
- syncActions : indique les opérations supplémentaires à effectuer pendant l'importation. Elle contient les zones suivantes :
- action : indique l'action à effectuer. Il peut s'agir de l'action add, remove ou setStatus.
- destination : indique l'emplacement dans lequel l'action doit avoir lieu. Pour les actions add ou remove, il s'agit de l'URI d'un groupe de listes ou d'e-mails. Pour setStatus, il peut s'agir de l'URI d'une action AppCloud ou d'un service de décision.
- status : indique la valeur à affecter à l'état pour une action setStatus. Les états suivants sont disponibles :
- abonné
- désabonné
- actif
- terminée
- en attente
- en erreur
- oui
- non
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.
- Sélectionnez Mapper les entrées 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.
Vous venez de configurer l'activité Eloqua Bulk API Mettre à jour une définition d'importation.