Entrées dynamiques

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

    • Générez une liste d’entrées d’action ou de valeurs d’entrée chaque fois que quelqu’un configure l’action dans un flux. Les entrées dynamiques peuvent afficher une liste des entrées d’actions connexes, une liste des champs d’un enregistrement ou une liste des options disponibles dans une liste de choix.

    Remarque :
    Les entrées dynamiques ne sont pas disponibles dans le système de base. Pour utiliser les entrées dynamiques dans Studio de workflow, vous devez Demander un Centre d'intégration module d'extension. Les entrées dynamiques font partie du module d’extension ServiceNow Flow Designer - Introspection [com.glide.hub.flow_designer_introspection].
    Pendant la conception du flux, les entrées dynamiques récupèrent les valeurs et les affichent dynamiquement sous forme d’entrées dans une action. Ces types d’entrées dynamiques sont disponibles pour les auteurs d’actions.
    Choix dynamique
    L’entrée de type Choix dynamique rassemble une liste de valeurs de choix à afficher. Pour plus d’informations sur la création d’un choix dynamique, consultez Créer une action de collecte de données pour un choix dynamique.
    Entrées dynamiques
    L’entrée Type d’entrées dynamiques rassemble une liste d’entrées d’action supplémentaires à afficher. Utilisez des entrées dynamiques pour ajouter des entrées arbitraires à une action. Pour plus d’informations sur la création d’entrées dynamiques, reportez-vous à la section Créer une action de collecte de données pour une entrée de type d’entrées dynamiques.
    Modèle dynamique
    L’entrée de type de modèle dynamique rassemble une liste de champs à partir d’un type d’enregistrement sélectionné dynamiquement. Les auteurs de flux peuvent ensuite sélectionner les champs à inclure dans leur flux. Étant donné que la liste des champs est générée dynamiquement, vous n’avez pas besoin de modifier l’action lorsque des champs sont ajoutés ou supprimés de la table source. Pour plus d’informations sur la création d’un modèle dynamique, consultez Créer une action de collecte de données pour un modèle dynamique.
    L’utilisation des entrées dynamiques comporte trois étapes générales.
    1. Un auteur d’action crée une action de collecte de données pour générer des données dynamiques.
    2. Un auteur d’action crée une action avec une entrée dynamique et configure l’entrée dynamique pour appeler l’action de collecte de données.
    3. Un auteur de flux ajoute l’action à un flux et configure l’action avec des données collectées dynamiquement.

    Actions de collecte de données

    Une action de collecte de données collecte des données qui seront utilisées par d’autres actions. Les actions de collecte de données sont destinées à être appelées à partir d’entrées dynamiques plutôt que d’être ajoutées directement à un flux. Les actions de collecte de données collectent généralement les données de systèmes tiers à l’aide d’un appel REST. Toutes les actions de collecte de données doivent répondre à ces exigences et contraintes.
    • L’action comporte une étape de script qui contient une variable de sortie de type JSON.
    • L’action possède une sortie nommée output de type JSON dont la valeur est dérivée de la variable de sortie JSON de l’étape Script.
      Remarque :
      L’action peut avoir plusieurs sorties, mais ne peut en avoir qu’une de type JSON.
    • L’étape Script formate la sortie JSON pour avoir une propriété nommée data.
    • La sortie JSON ne doit pas renvoyer plus de 5 000 options de choix, valeurs de modèle de champ ou éléments de tableau lorsque les données sont destinées à un choix dynamique ou à une entrée de modèle dynamique.
      Remarque :
      Les entrées Choix dynamique et Modèle dynamique ne peuvent afficher que 5 000 options de choix ou 5 000 valeurs de modèle à partir de la sortie JSON.
    • L’action attend jusqu’à 300 secondes (5 minutes) pour collecter des données avant d’expirer.
      Remarque :
      Pour modifier le délai d’expiration de toutes les actions, modifiez la valeur de la sn_flow_designer.sync_action_execution_timeout_in_seconds propriété système.

    Types de données d’entrée dynamique pris en charge

    Les entrées dynamiques prennent en charge un nombre limité de types de ServiceNow AI Platform données. Vous pouvez utiliser l’exemple JSON pour créer vos propres entrées dynamiques. Vous pouvez modifier les valeurs des propriétés d’étiquette et de nom pour répondre à vos besoins. La propriété type doit spécifier un nom de type de ServiceNow AI Platform données. Pour plus d’informations sur ServiceNow AI Platform les types de données de champ et leur configuration, reportez-vous à la section Field types reference.

    Tableau 1. Types de données d’entrée dynamique pris en charge
    Type de données d’entrée Exemple JSON
    Choix 
    { 
    data: [{
      label: 'Choice type input',
      name: 'choicetype',
      defaultValue: 'choice_1',
      type: 'choice',
      choices: [
          { label: 'Choice 1', value: 'choice_1' },
          { label: 'Choice 2', value: 'choice_2' }
      ]
    }]
  }
    Date/Heure 
    { 
    data: [{
      label: 'Datetime type input',
      name: 'datetimetype',
      type: 'datetime',
    }]
  }
    Décimal 
    { 
    data: [{
      label: 'Decimal type input',
      name: 'decimaltype',
      type: 'decimal',
    }]
  }
    E-mail 
    { 
    data: [{
      label: 'Email type input',
      name: 'emailtype',
      type: 'email',
    }]
  }
    HTML 
    { 
    data: [{
      label: 'HTML type input',
      name: 'htmltype',
      type: 'html',
    }]
  }
    Entier 
    { 
    data: [{
      label: 'Integer type input',
      name: 'integertype',
      type: 'integer',
    }]
  }
    Mot de passe 2 
    { 
    data: [{
      label: 'Password2 type input',
      name: 'password2type',
      type: 'password2',
    }]
  }
    Référence 
    { 
    data: [{
      label: 'Reference type input',
      name: 'referencetype',
      reference: 'sys_user',
      type: 'reference',
    }]
  }
    Chaîne 
    { 
    data: [{
      label: 'String type input',
      name: 'stringtype',
      defaultValue: 'abcdef',
      type: 'string',
      mandatory: true
    }]
  }

    Directives générales

    Prendre en compte les entrées dynamiques pour les intégrations tierces
    Les entrées dynamiques vous permettent de créer des flux qui extraient dynamiquement les données à partir de sources externes. Dans les intégrations tierces, les entrées dynamiques peuvent fournir des valeurs de données relatives à un point de terminaison particulier. Pour plus d’informations sur la configuration d’intégrations tierces avec Studio de workflow, consultez Centre d’intégration.
    Tenez compte du temps nécessaire pour récupérer de grandes quantités de données
    Par défaut, les entrées dynamiques disposent de 300 secondes pour collecter des données avant d’expirer. Si votre action de collecte de données nécessite plus de temps pour collecter des données, définissez la sn_flow_designer.sync_action_execution_timeout_in_seconds propriété système sur une valeur plus élevée. Toutefois, n’utilisez pas de valeurs de délai d’expiration longues pour les flux interactifs où un utilisateur final doit entrer ou sélectionner une valeur.
    Attention aux erreurs de script
    Étant donné que toutes les actions de collecte de données utilisent une étape de script, des erreurs potentielles peuvent se produire lors de l’écriture de scripts. Lorsque vous utilisez des scripts pour générer des variables JSON pour vos entrées dynamiques, vous pouvez rencontrer des erreurs qui empêchent les entrées de recevoir les valeurs JSON dont elles ont besoin. Lorsqu’une erreur de script d’entrée dynamique se produit, le message d’avertissement suivant peut s’afficher.
    Figure 1. Message affiché pour l’erreur de scripting
    Message d’erreur d’action dynamique
    Limiter les entrées de type d’entrées dynamiques à 40 valeurs d’entrée
    Une entrée de type entrées dynamiques ne peut afficher qu’un certain nombre d’entrées avant que l’objet JSON ne devienne trop volumineux pour être stocké en mémoire. Limiter vos entrées dynamiques à 40 valeurs d’entrée minimise les risques de manquer de mémoire et de rencontrer des comportements inattendus tels que des erreurs de rendu ou la troncature des données.
    Limiter la sortie JSON à 5 000 éléments de tableau pour les modèles dynamiques et les choix dynamiques
    Les entrées de choix dynamique et de modèle dynamiques ne peuvent afficher que jusqu’à 5 000 éléments de tableau. Un choix dynamique ne peut afficher que jusqu’à 5 000 options de liste de choix, et un modèle dynamique ne peut afficher que jusqu’à 5 000 valeurs de modèle de champ. Si votre action de collecte de données collecte des données pour un modèle dynamique ou un choix dynamique, limitez le nombre maximal d’éléments de tableau qu’il renvoie à 5 000. La limite de 5 000 éléments de tableau empêche l’instance d’avoir des problèmes de performances lors du rendu des choix ou des valeurs de champ.