Créer ou mettre à jour une action d’enregistrement

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • Créer ou mettre à jour un enregistrement dans une table à l’aide d’une ServiceNow seule opération. Mettez à jour un enregistrement qui existe ou créez un enregistrement à l’aide des valeurs fournies.

    Identification des enregistrements existants

    L’action Créer ou mettre à jour un enregistrement identifie les enregistrements existants en recherchant des valeurs correspondantes dans les champs que vous sélectionnez comme identificateurs uniques. Par exemple, vous pouvez spécifier que les champs Description brève et Priorité identifient un incident de manière unique. Lorsque l’action détecte un incident dont la brève description et la priorité correspondent, elle met à jour l’enregistrement correspondant plutôt que d’en créer un nouveau.

    Remarque :
    • Si aucun champ n’est sélectionné comme identificateur unique, l’action crée un enregistrement avec les valeurs de champ fournies.
    • Si plusieurs enregistrements correspondent à la valeur des identificateurs uniques, l’action ne met à jour aucun enregistrement et affiche un message d’erreur dans les détails d’exécution du flux.

    Rôles et disponibilité

    Disponible en tant qu’action Studio de workflow ServiceNow principale. Les utilisateurs disposant du rôle flow_designer ou admin peuvent ajouter une action à un flux et définir les détails de la configuration.

    Entrées

    Fournissez une valeur pour chaque entrée dont votre flux a besoin. Pour ajouter des valeurs dynamiques, vous pouvez également glisser-déplacer les pilules du panneau de données ou les sélectionner dans le sélecteur de pilules.

    Table
    Type de données : Table Name

    Table dans laquelle créer ou mettre à jour un enregistrement.

    Champs
    Type de données : Template Values

    Valeurs de champ à définir ou à mettre à jour pour l’enregistrement. Par exemple, pour définir la description brève sur une certaine valeur, sélectionnez Description brève et définissez la valeur souhaitée.

    Important :
    Le système ne prend pas en charge la mise à jour de plusieurs champs de journal tels que les commentaires ou les notes de travail supplémentaires d’un enregistrement de tâche.

    Si vous ajoutez l’action à un flux secondaire, vous pouvez Créer une entrée de valeur de modèle. Les valeurs de champ définies dynamiquement peuvent déclencher des règles de validation côté serveur, mais ne peuvent pas déclencher de politiques d’interface utilisateur.

    Détermine l'unicité
    Type de données : True/False

    Option permettant de sélectionner le champ en tant qu’identificateur unique, qui détermine quand mettre à jour ou créer un enregistrement. Un enregistrement est mis à jour lorsque la valeur de champ entrant correspond à une valeur de champ d’enregistrement existante. Un enregistrement est créé lorsque la valeur du champ entrant ne correspond pas à une valeur de champ d’enregistrement existante. Cette option s’affiche lorsque le nom de table et les champs requis sont sélectionnés.

    Sorties

    Ces résultats apparaissent dans le panneau de données. Vous pouvez les utiliser comme entrées ailleurs dans votre flux.

    Enregistrement
    Type de données : Record

    Référence à l’enregistrement créé ou mis à jour.

    Table
    Type de données : Table Name

    Table où l’enregistrement a été créé ou mis à jour.

    Statut
    Type de données : Choice

    État d’achèvement de l’action. La page des détails d’exécution du flux affiche l’une de ces valeurs.

    • Créé [created] : l’action a créé un enregistrement.
    • Mis à jour [updated] : l’action a mis à jour un enregistrement.
    • Erreur [error] : l’action a produit une erreur.
    Message d'erreur
    Type de données : String

    Message d’erreur produit lorsque l’opération d’enregistrement échoue.

    Mettre à jour l’enregistrement de problème à partir d’un e-mail entrant

    Figure 1. Entrées utilisées pour créer ou mettre à jour un enregistrement de problème
    Entrées utilisées pour créer ou mettre à jour un enregistrement de problème.