Étape Créer ou mettre à jour un enregistrement

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 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’étape 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’étape 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é en tant qu’identificateur unique, l’étape crée un enregistrement avec les valeurs de champ fournies.
    • Si plusieurs enregistrements correspondent à la valeur des identificateurs uniques, l’étape 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’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.

    Entrées

    Renseignez chaque entrée nécessaire pour votre action. 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.

    En cas d'échec de cette étape
    Type de données : Choice
    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Cette option n’a aucun effet sur la sortie État de l’étape. Les choix sont les suivants :
    • N’arrêtez pas l’action et passez à l’étape suivante : continue d’exécuter l’action à l’étape suivante.
    • Accéder à l’évaluation des erreurs : arrête d’exécuter l’action et accède à la section Évaluation des erreurs.

    Sorties

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

    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.

    Message d'erreur
    Type de données : String

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

    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.
    État de l'étape
    Type de données : Object

    Pastille de données d’objet contenant des détails d’exécution sur l’étape. Chaque étape d’une action renvoie un état d’étape.

    Code d’état de l’étape
    Type de données : Integer
    Pastille de données entière indiquant si l’étape a produit une erreur. Une étape renvoie la valeur 1 lorsqu’elle génère une erreur pour une raison quelconque. Par exemple, une étape peut générer une erreur s’il manque des données d’entrée obligatoires ou si elle renvoie une sortie dans un type de données incorrect. Une étape renvoie la valeur 0 lorsqu’elle s’exécute correctement. Vous ne pouvez pas personnaliser ces codes.
    • Réussite [0] : l’étape a réussi.
    • Erreur [1] : L’étape a produit une erreur.
    Message d’état de l’étape
    Type de données : String

    Pilule de données de chaîne contenant le message d’erreur produit par l’opération de l’étape ou du système. Vous ne pouvez pas personnaliser le message d’état de l’étape.

    Créer ou mettre à jour un enregistrement de problème

    Configuration de l’étape Créer ou mettre à jour un enregistrement

    Cette action a deux entrées. Il existe une entrée de chaîne pour une description et une entrée de référence pour un enregistrement utilisateur. L’étape Créer ou mettre à jour un enregistrement utilise ces entrées pour créer ou mettre à jour un enregistrement de problème. La description du problème et les champs Ouvert par déterminent l’unicité. Lorsque les valeurs d’entrée correspondent, l’étape effectue une opération de mise à jour au lieu d’une opération de création.