Étape Créer ou mettre à jour un enregistrement

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Créez ou mettez à jour un enregistrement dans une table à l’aide d’une ServiceNow seule opération. Mettez à jour un enregistrement existant 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 les 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 de manière unique un incident. Lorsque l’étape trouve un incident dont la description brève 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’é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 entrante correspond à une valeur de champ d’enregistrement existante. Un enregistrement est créé lorsque la valeur de champ entrante 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 l’exécution de l’action à l’étape suivante.
    • Accéder à l’évaluation de l’erreur : arrête l’exécution de l’action et accède à la section Évaluation de l’erreur.

    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 à un 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 généré en cas d’échec de l’opération d’enregistrement.

    Statut
    Type de données : Choice

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

    • Créé [créé] : l’action a créé un enregistrement.
    • Mis à jour [mis à jour] : l’action a mis à jour un enregistrement.
    • Erreur [erreur] : l’action a produit une erreur.
    Statut de l'étape
    Type de données : Object

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

    Code d’état d’é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 si des données d’entrée obligatoires sont manquantes ou si elle renvoie une sortie dans le mauvais type de données. Une étape renvoie la valeur 0 lorsqu’elle s’exécute avec succès. 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’étape ou l’opération 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 comporte 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. Les champs Énoncé du problème et 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.