Introduction aux sorties dynamiques

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 12 minutes de lecture

    • Créez un exemple d’action qui génère des objets dynamiques à utiliser dans un flux.

    Avant de commencer

    Rôle requis : action_designer ou admin

    Pourquoi et quand exécuter cette tâche

    Dans cette tâche, vous allez créer deux actions de collecte de données : l’une qui collecte le schéma d’un enregistrement sur votre instance et l’autre qui collecte le schéma de plusieurs enregistrements dans la même table sur votre instance. L’objectif est de créer à la fois un objet complexe et un tableau d’objets complexes à utiliser comme sorties dynamiques. Chaque action de collecte de données comprendra les éléments suivants :
    • Une étape REST pour collecter des données de schéma de table à partir de votre instance.
    • Une étape de script pour construire la charge utile à partir du corps de réponse de l’étape REST.
    • Variable de sortie nommée sortie de type JSON.
    Ces actions de collecte de données vous permettent de créer deux objets dynamiques. Ensuite, vous créez une action personnalisée qui appelle les actions de collecte de données pendant la conception du flux.
    Remarque :
    Cette tâche recrée les actions de démonstration qui sont installées lorsque vous Demander un Hub d'intégration module d'extension pour votre instance.

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Cliquez sur Nouveau et sélectionnez Nouvelle action.
      1. Sur l’écran Propriétés de l’action, dans le champ Nom, entrez Obtenir le schéma d’objet ServiceNow (dynamique).
      2. Cliquez sur Envoyer.
    3. Dans Plan d’action, cliquez sur Entrées.
      1. Dans l’en-tête Entrée d’action, cliquez sur Créer une entrée.
      2. Dans les champs Étiquette et Nom , entrez Table.
      3. Dans le champ Type, sélectionnez Chaîne.
      4. Pour rendre cette entrée obligatoire, basculez le curseur Obligatoire afin qu’il soit actif.
    4. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) sous Entrées et sélectionnez Étape REST.
    5. Sous l’en-tête de l’étape REST, renseignez les champs suivants.
      Champ Valeur
      Connexion Laissez l’option Utiliser l’alias de connexion sélectionnée.
      Alias de connexion Cliquez sur l’icône Créer un enregistrement (icône Créer un enregistrement) pour créer une nouvelle connexion HTTP(s) ou utilisez une connexion existante pour votre instance. Les informations d’identification de la connexion HTTP(s) doivent utiliser des informations d’identification d’authentification de base. En outre, l’URL de connexion doit être l’URL de base pour votre instance, y compris la barre oblique à la fin. Pour plus d’informations sur les connexions et les informations d’identification, consultez Démarrer avec les connexions et Démarrer avec les informations d’identification.
      Demande de version Laissez l’option Manuellement sélectionnée.
      Chemin d'accès à la ressource Entrez api/now/processflow/table/ , puis cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données). Sélectionner Entrées > Table. Ensuite, entrez /schema.
      Méthode HTTP Entrez GET
      Paramètres de requêtes Cliquez sur l’icône Plus ( icône Plus pour ajouter un nouveau paramètre de requête. Ensuite, dans le champ Nom , saisissez get_choices et vrai dans le champ Valeur .
    6. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Ajouter une nouvelle étape) sous votre étape REST et sélectionnez l’étape Script .
      1. Dans la section Variables d’entrée, cliquez sur Créer une variable.
      2. Dans le champ Nom , entrez la charge utile.
      3. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape REST > Corps de la réponse.
      4. Dans le champ Script, entrez le code suivant. 
        
(function execute(inputs, outputs) {
  var payload = JSON.parse(inputs.payload);
  
  var columns = payload.result.data.columns;
  var schema = columns.map(function(column) {
    var value = {
      label: column.label,
      name: column.name,
      type: getCOType(column.definition.base_type),
    };
    if (column.definition.type === 'choice') {
      value.type = 'choice';
      value.choices = column.definition.choices;
    } 
    if (column.definition.base_type === 'GUID') {
      value.children = [
        { label: 'Link', name: 'link', type: 'string' },
        { label: 'Value', name: 'value', type: 'string' },
      ];
    }
    return value;
  });
  outputs.schema = { 
    data: {
      type: 'object',
      children: schema,
    },
  };
  
  function getCOType(type) {
    if (type === 'GUID') return 'reference';
    return type;
  }
})(inputs, outputs);
      5. Dans la section Variables de sortie, cliquez sur Créer une variable.
      6. Dans les champs Étiquette et Nom , entrez le schéma.
      7. Dans le champ Type, sélectionnez JSON.
    7. Dans Plan d’action, cliquez sur Sorties.
      1. Dans l’en-tête Sortie d’action, cliquez sur Créer une sortie.
      2. Dans les champs Étiquette et Nom , entrez une sortie.
      3. Dans le champ Type, sélectionnez JSON.
      4. Dans l’en-tête Sortie d’action, cliquez sur Quitter le mode de modification.
      5. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape Script > Schéma.
    8. Dans l’en-tête Action, cliquez sur Enregistrer , puis sur Tester pour tester l’action.
      1. Sur l’écran Action de test, entrez incident pour l’entrée Table .
      2. Cliquez sur Exécuter le test.
      3. Vérifiez les détails de l’exécution de l’action.
      Votre action de collecte de données s’exécute avec succès si la valeur d’exécution des champs est un objet complexe dans un format similaire à l’exemple abrégé suivant.
      {
       "data": {
           "type": "object",
           "children": [
               {
                   "name": "active",
                   "label": "Active",
                   "type": "boolean"
               },
               {
                   "name": "activity_due",
                   "label": "Activity due",
                   "type": "datetime"
               }, ...
    9. Dans l’en-tête Action, cliquez sur Publier pour rendre l’action disponible pour d’autres Get ServiceNow Object Schema (Dynamic) flux et actions dans le champ d’application global.

    Créer l’action Obtenir le schéma Array.Object ServiceNow (dynamique)

    Créez un exemple d’action de collecte de données pour générer un tableau d’objets.

    Avant de commencer

    Rôle requis : action_designer ou admin

    Procédure

    1. Dans l’en-tête principal, cliquez sur l’icône de création de flux, de flux secondaire ou d’action ( icône Créer un flux, un flux secondaire ou une action) et sélectionnez Action.
      1. Sur l’écran Propriétés de l’action, dans le champ Nom, entrez Obtenir le schéma Array.Object ServiceNow (dynamique).
      2. Cliquez sur Envoyer.
    2. Dans Plan d’action, cliquez sur Entrées.
      1. Dans l’en-tête Entrée d’action, cliquez sur Créer une entrée.
      2. Dans les champs Étiquette et Nom , entrez Table.
      3. Dans le champ Type, sélectionnez Chaîne.
      4. Pour rendre l’entrée obligatoire, basculez le curseur Obligatoire pour qu’il soit actif.
    3. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Nouvelle étape) sous Entrées et sélectionnez l’étape REST .
    4. Sous l’en-tête de l’étape REST, renseignez les champs suivants.
      Champ Valeur
      Connexion Laissez l’option Utiliser des alias de connexion sélectionnée.
      Alias de connexion Cliquez sur l’icône Créer un enregistrement (icône Créer un enregistrement) pour créer une nouvelle connexion HTTP(s) ou utilisez une connexion existante pour votre instance. Les informations d’identification de la connexion HTTP(s) doivent utiliser des informations d’identification d’authentification de base. En outre, l’URL de connexion doit être l’URL de base pour votre instance, y compris la barre oblique à la fin.
      Demande de version Laissez l’option Manuellement sélectionnée.
      Chemin d'accès à la ressource Entrez api/now/processflow/table/ , puis cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données). Sélectionner Entrées > Table. Enfin, entrez /schema
      Méthode HTTP Entrez GET
      Paramètres de requêtes Cliquez sur l’icône Plus ( icône Plus pour ajouter un nouveau paramètre de requête. Ensuite, dans le champ Nom , saisissez get_choices et truedans le champ Valeur .
    5. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Nouvelle étape) sous votre étape REST et sélectionnez l’étape Script .
      1. Dans la section Variables d’entrée, cliquez sur Créer une variable.
      2. Dans le champ Nom , entrez la charge utile.
      3. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape REST > Corps de la réponse.
      4. Dans le champ Script, entrez le code suivant. 
        
(function execute(inputs, outputs) {
  var payload = JSON.parse(inputs.payload);
  
  var columns = payload.result.data.columns;
  var schema = columns.map(function(column) {
    var value = {
      label: column.label,
      name: column.name,
      type: getCOType(column.definition.base_type),
    };
    if (column.definition.type === 'choice') {
      value.type = 'choice';
      value.choices = column.definition.choices;
    }
    return value;
  });
  outputs.schema = { 
    data: {
      type: 'array.object',
      attributes: {
        child_type: 'object',
      },
      children: schema,
    },
  };
  
  function getCOType(type) {
    if (type === 'GUID') return 'string';
    return type;
  }
})(inputs, outputs);
      5. Dans la section Variables de sortie, cliquez sur Créer une variable.
      6. Dans les champs Étiquette et Nom , entrez le schéma.
      7. Dans le champ Type, sélectionnez JSON.
    6. Dans Plan d’action, cliquez sur Sorties.
      1. Dans l’en-tête Sortie d’action, cliquez sur Créer une sortie.
      2. Entrez le résultat dans le champ Étiquette et le champ Nom .
      3. Sélectionnez JSON pour le champ Type .
      4. Cliquez sur Quitter le mode de modification.
      5. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape Script > Schéma.
    7. Dans l’en-tête Action, cliquez sur Enregistrer , puis sur Tester pour tester l’action.
      1. Sur l’écran Action de test, dans le champ Table , entrez incident.
      2. Cliquez sur Exécuter le test.
      3. Vérifiez les détails de l’exécution de l’action.
        Votre action de collecte de données s’exécute avec succès si la valeur d’exécution de la sortie des champs est un objet complexe qui contient un tableau de paires clé-valeur pour l’étiquette, le nom et la valeur , comme illustré dans l’exemple abrégé suivant.
        {
       "data": {
           "type": "array.object",
           "children": [
               {
                   "name": "active",
                   "label": "Active",
                   "type": "boolean"
               },
               {
                   "name": "activity_due",
                   "label": "Activity due",
                   "type": "datetime"
               }, ...
    8. Dans l’en-tête Action, cliquez sur Publier pour rendre l’action Get ServiceNow Array.Object Schema (Dynamic) disponible pour d’autres actions dans le champ d’application global.

    Créer l’action Obtenir les enregistrements ServiceNow (dynamique)

    Créez un exemple d’action pour générer dynamiquement deux sorties d’action, Enregistrement et Enregistrements , qui s’actualisent dynamiquement lorsque la valeur de l’entrée Table change.

    Avant de commencer

    Rôle requis : action_designer ou admin

    Procédure

    1. Dans l’en-tête principal, cliquez sur l’icône de création de flux, de flux secondaire ou d’action ( icône Créer un flux, un flux secondaire ou une action) et sélectionnez Action.
      1. Dans le modal Propriétés de l’action, dans le champ Nom, saisissez Obtenir les enregistrements ServiceNow (dynamiques).
      2. Cliquez sur Envoyer.
    2. Dans Plan d’action, cliquez sur Entrées.
      1. Dans l’en-tête Entrée d’action, cliquez sur Créer une entrée.
      2. Dans les champs Étiquette et Nom , entrez Table.
      3. Dans le champ Type , sélectionnez Choix dynamique.
      4. Pour rendre l’entrée obligatoire, basculez le curseur Obligatoire pour qu’il soit actif.
      5. Cliquez sur l’icône Activer/désactiver les entrées avancées ( Icône Activer/désactiver les entrées avancées pour afficher les options avancées de l’entrée Table .
      6. Dans le champ Valeur par défaut , entrez incident.
      7. Sous Options dynamiques, dans le champ Action , sélectionnez Obtenir les tables ServiceNow : dynamiques.
      8. Cliquez sur Créer une entrée pour créer une autre entrée d’action.
      9. Dans les champs Étiquette et Nom , entrez NumberOfRecords.
      10. Dans le champ Type , sélectionnez Entier.
      11. Pour rendre l’entrée obligatoire, basculez le curseur Obligatoire pour qu’il soit actif.
      12. Cliquez sur l’icône Activer/désactiver les entrées avancées ( Icône Activer/désactiver les entrées avancées pour afficher les options avancées de l’entrée Table .
      13. Dans le champ Valeur par défaut , saisissez 3.
    3. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Nouvelle étape) sous Entrées et sélectionnez l’étape REST .
    4. Sous l’en-tête de l’étape REST, renseignez les champs suivants.
      Champ Valeur
      Connexion Laissez l’option Utiliser des alias de connexion sélectionnée.
      Alias de connexion Cliquez sur l’icône Créer un enregistrement (icône Créer un enregistrement) pour créer une nouvelle connexion HTTP(s) ou utilisez une connexion existante pour votre instance. Les informations d’identification de la connexion HTTP(s) doivent utiliser des informations d’identification d’authentification de base. En outre, l’URL de connexion doit être l’URL de base pour votre instance, y compris la barre oblique à la fin.
      Demande de version Laisser l’option Sélectionné manuellement
      Chemin d'accès à la ressource Entrez api/now/table/ , puis cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données). Sélectionner Entrées > Table.
      Méthode HTTP Entrez GET
      Paramètres de requêtes Cliquez sur l’icône Plus ( icône Plus pour ajouter un nouveau paramètre de requête. Ensuite, saisissez sysparm_limit dans le champ Nom . En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( sélecteur de pastilles de données), puis sélectionnez Entrées > Nombre d'enregistrements.
    5. Dans Plan d’action, cliquez sur l’icône Ajouter une nouvelle étape ( icône Nouvelle étape) sous Entrées et sélectionnez l’étape Script .
      1. Dans la section Variables d’entrée, cliquez sur Créer une variable.
      2. Dans le champ Nom , entrez la charge utile.
      3. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape REST > Corps de la réponse.
      4. Dans le champ Script, entrez le code suivant. 
        
(function execute(inputs, outputs) {
  var response = JSON.parse(inputs.payload);
  var records = response.result;
  outputs.record = records[0];
  outputs.records = JSON.stringify(records);
})(inputs, outputs);
      5. Dans la section Variables de sortie, cliquez sur Créer une variable.
      6. Dans les champs Étiquette et Nom , entrez l’enregistrement.
      7. Sélectionnez JSON pour le champ Type .
      8. Basculez le curseur Obligatoire pour qu’il soit actif.
      9. Cliquez sur Créer une variable pour créer une autre variable de sortie pour l’étape de script.
      10. Dans les champs Étiquette et Nom , entrez les enregistrements.
      11. Dans le champ Type, sélectionnez JSON.
      12. Pour rendre l’entrée obligatoire, basculez le curseur Obligatoire pour qu’il soit actif.
    6. Dans Plan d’action, cliquez sur Sorties.
      1. Dans l’en-tête Sortie d’action, cliquez sur Créer une sortie.
      2. Dans les champs Étiquette et Nom , entrez Enregistrements.
      3. Dans le champ Type , sélectionnez Objet dynamique.
      4. Cliquez sur l’icône Activer/désactiver les entrées avancées ( Icône Activer/désactiver les entrées avancées pour afficher les options avancées pour la sortie Enregistrements .
      5. Sous Options dynamiques, sélectionnez Obtenir le schéma Array.Object ServiceNow (dynamique) comme action.
      6. Pour rendre l’entrée Table dépendante d’une autre entrée, désactivez le curseur Dépend d’une autre entrée pour l’activer.
      7. Dans le champ Tablee, sélectionnez Table.
      8. Dans l’en-tête Sortie d’action, cliquez sur Quitter le mode de modification.
      9. En regard du champ Valeur , cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape Script > Enregistrements.
      10. Dans l’en-tête Sortie d’action, cliquez sur Modifier les sorties > Créer une sortie pour créer une autre sortie d’action.
      11. Dans les champs Étiquette et Nom , entrez Enregistrement.
      12. Dans le champ Type , sélectionnez Objet dynamique.
      13. Cliquez sur l’icône Activer/désactiver les entrées avancées ( Icône Activer/désactiver les entrées avancées pour afficher les options avancées pour la sortie Enregistrement .
      14. Sous Options dynamiques, dans le champ Action, sélectionnez Obtenir le schéma d’objet ServiceNow (dynamique).
      15. Pour rendre l’entrée Table dépendante d’une autre entrée, désactivez le curseur Dépend d’une autre entrée pour l’activer.
      16. Dans le champ Table , sélectionnez Table.
      17. Dans l’en-tête Sortie d’action, cliquez sur Quitter le mode de modification.
      18. Pour la valeur, cliquez sur le sélecteur de pastilles de données ( Sélecteur de pastilles de données) et sélectionnez Étape Script > record.
    7. Dans l’en-tête Action, cliquez sur Enregistrer , puis sur Tester pour tester l’action.
      1. Sur l’écran Tester l’action, sélectionnez une valeur de choix générée dynamiquement pour l’entrée Table .
      2. Cliquez sur Exécuter le test.
      3. Vérifiez les détails de l’exécution de l’action.
        Votre action s’exécute avec succès si la valeur d’exécution de Enregistrement est un objet complexe correctement formaté et si la valeur d’exécution d’Enregistrements est un tableau d’objets complexes correctement formaté.
    8. Dans l’en-tête Action, cliquez sur Publier pour rendre l’action disponible pour les Get ServiceNow Records (Dynamic) flux dans le champ d’application global.

    Résultats

    Vous pouvez maintenant ajouter l’action Get ServiceNow Records (Dynamic) à un flux dans Concepteur de flux. Cet exemple d’action génère dynamiquement deux sorties d’action, Enregistrement et Enregistrements, accessibles sous forme de pastilles de données dans le panneau de données. Les pastilles de données s’actualisent dynamiquement lorsque la valeur de l’entrée Table change.Utilisez l’exemple d’action Obtenir les enregistrements ServiceNow (dynamiques) dans un flux.