Créer des actions déclaratives pour Catalogue de services les assistants

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

    • Créez et configurez des actions déclaratives pour permettre aux administrateurs de configurer des boutons (actions d’assistant) dans Catalogue de services les assistants.

    Avant de commencer

    Il existe deux types d’actions déclaratives pour les assistants de catalogue :

    • Action du client UXF : créez des actions déclaratives et mappez une action à un gestionnaire d’événements au niveau de la page UIB. Utilisez cette option si vous devez gérer des événements au niveau UIB tels que l’ouverture d’un modal ou l’ouverture d’un autre assistant de catalogue, etc.
    • Script client : utilisez un script client qui s’exécute d’un simple clic sur un bouton. Utilisez cette option si vous devez manipuler g_form champs du créateur d’enregistrement composite qui sont liés à l’assistant de catalogue.

    Le modèle d’assistant de catalogue est le modèle d’action déclarative de l’assistant de catalogue qui possède les champs de modèle qui définissent les propriétés de l’assistant. Utilisez ces champs pour définir ce que la charge utile peut contenir (pour le type d’action du client UXF) ou définir des conditions pour l’affichage des boutons dans l’assistant. Chaque assistant doit utiliser le modèle d’assistant de catalogue pour créer des actions déclaratives.

    Rôle requis : wizard_admin, admin

    Procédure

    1. Accédez à la Assistants de Service Catalog > Actions déclaratives de l’assistant de catalogue.
      Important :
      Utilisez ce chemin de navigation uniquement pour créer des actions déclaratives. Ce chemin d’accès définit correctement les champs lorsque le formulaire d’action déclarative est chargé.
    2. Cliquez sur Nouveau pour créer une nouvelle action déclarative.
    3. Spécifier les champs du modèle d’action de l’assistant de catalogue pour créer des charges utiles.
      Les champs de modèle d’action sont disponibles par défaut pour les actions déclaratives de l’assistant de catalogue et apparaissent dans l’onglet Champs du modèle d’action du formulaire Affectation d’action . Champs Modèle d’action
      Tableau 1. Onglet Champs des modèles d’actions
      Champ Description
      Ordre de l’étape actuelle Ordre de l’étape sélectionnée actuelle.
      Table cible Table cible du créateur d’enregistrement ou du créateur d’enregistrement composite utilisé par l’assistant.
      Créateur d'enregistrement Sys_id du créateur d’enregistrement ou du créateur d’enregistrement composite utilisé par l’assistant.
      ID d’assistant Sys_id de l’assistant.
      Activer l'enregistrement Valeur du champ Activer l’enregistrement sur l’enregistrement de l’assistant.
      Variables Objet contenant le nom et la valeur des variables de créateur d’enregistrement composite associées à l’assistant.
      Est un nouvel enregistrement La valeur est définie sur Vrai lors de la création d’un nouvel enregistrement à l’aide de l’assistant.
      ID de modèle Sys_id du modèle appliqué à l’assistant.
      A une étape de révision La valeur du champ A une étape de révision sur l’enregistrement de l’assistant.
      Est la dernière étape Indique s’il s’agit de la dernière étape de l’assistant. La dernière étape ne dépend pas de l’ordre et peut changer de façon dynamique en fonction du script client ou des politiques d’interface utilisateur de l’assistant.
      Formulaire erroné La valeur est True si l’assistant a des modifications non enregistrées.
      Soumettre La valeur est True si une soumission de l’assistant est en cours.
      Mode Mode de fonctionnement de l’assistant (mode modèle ou normal).
      Données d’enregistrement cible Non applicable (ce champ n’est pas utilisé).
      ID d'enregistrement Sys_id de l’enregistrement en cours de création ou de modification par l’assistant.
    4. Cliquez sur le lien Étiquette d’action d’une action (par exemple, Insérer ou Supprimer). Création d’une action déclarative
      Tableau 2. Formulaire Affectation d’action
      Champ Description
      Étiquette de l'action Étiquette d’affichage du bouton dans l’assistant.
      Nom de l’action Identificateur de l’action.
      Implémenté en tant que Action client UXF ou script client pour les actions déclaratives de l’assistant.
      Spécifier l'action du client La définition de la charge utile si elle est implémentée, tout comme l’action du client UXF.
      Script client Si la valeur du champ Implémenté en tant queest Script client, cette valeur doit être spécifiée.
      Important :
      Vous ne pouvez utiliser que les variables du CRP qui sont liées à l’assistant.
      Info-bulle Info-bulle du bouton.
      Type de bouton Les valeurs possibles sont Primaire ou Secondaire.
      Ordre Séquence dans laquelle le bouton apparaît.
      Grouper par Option qui doit être sélectionnée si le bouton fait partie d’un groupe.
      Groupe Groupe auquel le bouton appartient, pour l’option Grouper par . Les boutons groupés sont affichés sous la forme d’un bouton fractionné dans l’assistant.
      Conditions du client scriptées Conditions à évaluer lors de l’affichage des boutons. Par exemple : mode=='template'&&variables.var=='xxxx'.
      Remarque :
      Ce champ n'apparaît pas sur le formulaire par défaut.
    5. Cliquez sur Envoyer pour créer l’action de l’assistant.
    6. Accédez à la Assistants de Catalogue de services > Configurations des actions de l'assistant de catalogue et cliquez sur Nouveau.
      Créez un enregistrement de configuration d’action d’assistant afin de pouvoir utiliser l’action déclarative dans un assistant. Renseignez les champs suivants dans le formulaire.
      Tableau 3. Enregistrement de configuration des actions de l’assistant
      Champ Description
      Nom Identificateur de l’enregistrement de configuration de l’action de l’assistant.
      Action déclarative Sélectionnez une action déclarative qui a été créée à l’aide du modèle de l’assistant de catalogue.
      S'applique à Mode assistant dans lequel cette action doit apparaître. Les valeurs sont Mode normal, Mode modèle ou Tous (les deux modes).
      Global Cette configuration d’action s’applique à tous les assistants, qu’ils soient mappés à un assistant particulier ou non.
      Remarque :
      Les actions globales Enregistrer et Soumettre sont disponibles par défaut.
      Débordement Le bouton s’affiche dans le cadre du menu de débordement.
      Forcer enregistrer Enregistre l’assistant si des valeurs de champ ont été mises à jour dans l’assistant avant de déclencher l’action.
      Remplacement de l'étiquette Entrez une étiquette pour remplacer l’étiquette spécifiée dans l’action déclarative.
      Remplacement du type de bouton Le type de bouton spécifié par l’action déclarative est remplacé.
    7. Accédez à la Assistant de catalogue > Conserver les assistants.

      Pour afficher une action déclarative sous la forme d’un bouton dans l’assistant, mappez la configuration des actions de l’assistant avec l’assistant de catalogue.

      Ouvrez l’assistant auquel vous souhaitez ajouter l’action déclarative. Utilisez la liste connexe Configurations des actions de l’assistant pour créer un enregistrement de mappage entre l’assistant et la configuration des actions de l’assistant.
      1. Cliquez sur Nouveau pour créer directement une nouvelle configuration.
      2. Cliquez sur Modifier pour joindre une configuration existante et créer un enregistrement de mappage entre l’assistant et la configuration. L’enregistrement de mappage dispose également d’un commutateur permettant de masquer une action spécifique.
      3. Faites passer le champ Masquer l’action sur Vrai pour masquer une action spécifique.
        Conseil :
        Les boutons avec des configurations globales sont disponibles sur l’assistant par défaut. Pour masquer une action globale dans un assistant, mappez la configuration globale à l’assistant et définissez l’action de masquage sur vrai.

      Pour plus d’informations sur les assistants de catalogue, reportez-vous à Création d’un Catalogue de services assistant.

    8. Utilisez l’action Configurer les mappages d’événements d’actions déclaratives dans l’onglet Configuration de l’UI Builder.
      Configurer les mappages d’événements d’actions déclaratives ne s’applique qu’au type d’action déclarative Action du client UXF. Créez un gestionnaire d’événements au niveau de la page, puis mappez l’action déclarative au gestionnaire d’événements au niveau de la page et spécifiez la charge utile. Pour plus d’informations sur la liaison d’événements à des actions déclaratives dans UI Builder, consultez Lier un événement à une action déclarative.