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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

    • Créez et configurez des actions déclaratives pour permettre aux administrateurs de configurer des boutons (actions de l’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’une boîte de dialogue ou l’ouverture d’un autre assistant de catalogue, etc.
    • Script client : utilisez un script client qui s’exécute d’un 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 de l’assistant de catalogue pour créer des actions déclaratives.

    Rôle requis : wizard_admin, admin

    Procédure

    1. Accédez à la Assistants de Catalogue de services > 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 action déclarative.
    3. Spécifiez 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 s’affichent dans l’onglet Champs du modèle d’action du formulaire Affectation d’action . Champs Modèle d’action
      Tableau 1. Onglet Champs du modèle d’action
      Champ Description
      Ordre des étapes actuelles 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 de l’assistant Sys_id de l’assistant.
      Activer l'enregistrement Valeur du champ Activer enregistrer 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 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 la commande et peut changer dynamiquement en fonction du script client ou des politiques d’interface utilisateur de l’assistant.
      Formulaire erroné La valeur est Vrai si l’assistant comporte des modifications non enregistrées.
      Soumission La valeur est Vrai si une soumission de l’assistant est en cours.
      Mode Mode dans lequel l’assistant fonctionne (mode Modèle ou Normal).
      Données de l’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 de l’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 Affichez l’étiquette du bouton dans l’assistant.
      Nom de l'action Identificateur de l’action.
      Implémenté en tant que Action du 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 appartient le bouton, pour l’option Grouper par . Les boutons groupés s’affichent 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 des actions de l’assistant afin de pouvoir utiliser l’action déclarative dans un assistant. Remplissez 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 des actions de l’assistant.
      Action déclarative Sélectionnez une action déclarative créée à l’aide du modèle de l’Assistant 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 forme de 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 afin de créer un enregistrement de mappage entre l’assistant et la configuration. L’enregistrement de mappage dispose également d’une option permettant de masquer une action spécifique.
      3. Basculez le champ Masquer l’action sur Vrai pour masquer une action spécifique.
        Conseil :
        Les boutons avec des configurations globales sont disponibles par défaut dans l’assistant. Pour masquer une action globale dans un assistant, mappez la configuration globale à l’assistant et définissez l’option Masquer l’action sur vrai.

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

    8. Utilisez l’action Configurer les mappages d’événements des actions déclaratives sous l’onglet Configuration du générateur d’IU.
      Configurer les mappages d’événements des 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 le générateur d’IU, voir Lier un événement à une action déclarative.