Activité Mettre à jour et insérer des objets

Utilisez cette activité pour mettre à jour un ou plusieurs objets existants ou créer de nouveaux objets dans ServiceMax.

Pourquoi et quand exécuter cette tâche

Cette activité utilise un identificateur externe, généralement une clé externe, pour déterminer s'il faut mettre à jour un objet existant ou en créer un nouveau dans ServiceMax.

Alors que l'API Salesforce.com limite à 200 le nombre d'objets pouvant être convertis en un seul appel, le connecteur Cast Iron ServiceMax n'a pas de limite de ce type. Vous pouvez utiliser l'activité Mettre à jour et insérer des objets pour créer un nombre illimité d'objets.

Pour utiliser l'activité Mettre à jour et insérer des objets :

Procédure

  1. Dans l'onglet Activités, ouvrez le répertoire ServiceMax pour rechercher l'activité Mettre à jour et insérer des objets.
  2. Ajoutez l'activité à une orchestration. La liste de contrôle et le récapitulatif de l'activité sont affichés en dessous de l'orchestration.
  3. Sélectionnez un noeud final ServiceMax. Vous trouverez des instructions sur la création ou l'édition d'un noeud final ServiceMax dans la section Création ou édition d'un noeud final ServiceMax.
  4. Configurez l'activité en sélectionnant le type d'objet ServiceMax et des préférences de zone d'objet.
    Remarque : Vous pouvez uniquement sélectionner les types d'objet que le dispositif d'intégration peut mettre à jour ou créer et qui contiennent au moins une zone ID externe. Lorsque vous sélectionnez le type d'objet, Studio affiche les ID externes définis sur ce type d'objet dans la zone ID externe du panneau Configurer. Vous ne pouvez pas éditer les ID répertoriés dans la liste ID externe. L'ID externe que vous sélectionnez devient une zone obligatoire. Vous ne pouvez pas supprimer cette zone de la table Préférences de la zone d'objet. Si un seul ID externe est disponible, Studio sélectionne automatiquement cette zone dans la table Préférences de la zone d'objet.
  5. Spécifiez les paramètres Réessayer et Dépassement de délai pour l'activité.
  6. Mappez l'entrée de l'activité.
  7. Mappez la sortie de l'activité.

Résultats

Mapper l'entrée de l'activité Mettre à jour et insérer des objets :

  1. Dans la Liste de contrôle, sélectionnez Mapper les entrées. L'élément objects apparaît dans le panneau Vers l'activité.
  2. 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é :
    • AssignmentRuleHeader
    • MruHeader
    • EmailHeader
    • CallOptions
    • connection
    • sessionInfo
  3. Cliquez sur Sélectionner des entrées et sélectionnez la ou les variables d'entrée de la mappe. Vous trouverez des instructions sur la création de variables dans Créations de variables.
  4. Selon les cas, mappez les paramètres d'entrée sur la ou les variables. Vous trouverez des instructions sur le mappage dans Création d'une mappe.

L'activité prend en charge les paramètres d'entrée facultatifs suivants :

  • AssignmentRuleHeader
  • EmailHeader
  • MruHeader

Les éléments de zone facultative et nillable ont le comportement suivant :

  • Le dispositif d'intégration ne met pas à jour une zone optionnelle lorsque le serveur ServiceMax ne fournit pas de valeur pour cette zone.
  • Si vous affectez la valeur true à l'attribut xsi:nil sur une zone nillable, le dispositif d'intégration met cette zone à Null lors d'une mise à jour.
    Remarque : L'affectation d'une chaîne vide à une zone ne met pas celle-ci à Null.

Mapper la sortie l'activité Mettre à jour et insérer des objets

  1. Dans la Liste de contrôle, sélectionnez Mapper les sorties. L'élément upsertResults apparaît dans le panneau Depuis l'activité.
  2. 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éations de variables.
  3. Selon les cas, mappez les paramètres de sortie sur la ou les variables. Vous trouverez des instructions sur le mappage dans Création d'une mappe.