Liste. Type de données [Table]

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

    • Stocke une liste des ID système d’enregistrements associés à une table spécifique. Cette variable prend en charge ServiceNow AI Platform les options de champ de liste telles que les enregistrements par défaut et les qualificatifs de référence.

    Options de base

    Option Description
    Étiquette Affiche l’étiquette utilisée pour identifier la variable de données dans l’interface Studio de workflow . L’étiquette peut contenir n’importe quel texte.
    Nom Affiche le nom utilisé pour identifier la variable de données dans les appels de script. Le nom ne peut comporter que des caractères alphanumériques et de soulignement. Le système convertit automatiquement l’étiquette en un nom valide en supprimant ou en remplaçant les caractères spéciaux.
    Type Indique le type de données stockées par la variable de données.
    Obligatoire Indique si la variable de données doit contenir une valeur lorsqu’elle est configurée dans une action.

    Options avancées pour les variables de liste

    Option Description
    Conseil Fournit des conseils aux concepteurs de flux ou d’actions sur la façon de configurer les données.
    Valeur par défaut Spécifie la valeur utilisée lorsqu’un concepteur de flux ou d’action ne fournit pas de valeur.
    Ajouter [Étiquette de l’enregistrement] Sélectionnez un ou plusieurs enregistrements à inclure comme valeurs par défaut pour la liste. Si vous filtrez la liste avec un qualificatif de référence, vous ne pouvez sélectionner que les enregistrements qui correspondent aux conditions de qualificatif de référence.
    Conditions de qualificatifs de référence Sélectionnez les conditions de filtre appliquées à la liste des enregistrements. Les concepteurs de flux ne peuvent sélectionner que les enregistrements qui correspondent aux conditions de qualificatif de référence.

    Directives générales

    Ajouter un qualificatif de référence pour filtrer les enregistrements de liste
    Filtrez les enregistrements que la variable de liste affiche en tant qu’options valides en ajoutant un qualificatif de référence. Le qualificatif de référence agit comme un filtre de liste requis et fait en sorte que la variable de liste affiche uniquement les enregistrements qui correspondent aux conditions de qualificatif de référence. Par exemple, pour afficher uniquement les enregistrements d’incidents actifs, ajoutez la condition de qualificatif de référence [Active][is][true].
    Évitez de sélectionner des enregistrements par défaut pour les actions destinées à ServiceNow Store
    Évitez de sélectionner des enregistrements par défaut pour une liste, sauf si vous savez que toutes les instances ont accès aux enregistrements sélectionnés. Les développeurs de spokes n’ont généralement pas accès aux données des clients qui installent leur action personnalisée. Si vous souhaitez publier une action personnalisée sur le ServiceNow Store, vous devrez peut-être fournir des enregistrements par défaut comme données de démonstration.
    Utiliser des variables de liste dans la logique de flux For Each
    Vous pouvez utiliser une variable Liste pour spécifier les enregistrements à traiter dans la logique de flux For Each La logique de flux For Each ignore toute sys_id non enregistrée présente dans les données. Par exemple, si la variable Liste contient une adresse e-mail, la logique de flux l’ignore.