24.3 Ajout de gestionnaires personnalisés

Les gestionnaires personnalisés sont utilisés dans DRA pour permettre aux attributs de propriété d'interagir entre eux afin d'accomplir une tâche de workflow, ainsi que pour les personnalisations de chargement et de soumission dans un formulaire de workflow, de propriété ou de création.

Gestionnaires personnalisés de propriétés

Voici quelques exemples de gestionnaires personnalisés de propriétés :

Interrogation de la valeur d'autres champs
Mise à jour des valeurs de champs
Basculement de l'état de lecture seule d'un champ
Affichage ou masquage de champs en fonction de variables configurées

Gestionnaires de chargement de formulaire

Les gestionnaires de chargement de formulaire effectuent généralement des contrôles d'initialisation. Ils ne sont exécutés qu'une seule fois lors du chargement initial du formulaire. Dans le cas d'une page de propriétés, ils sont exécutés avant l'interrogation du serveur pour obtenir les propriétés de l'objet sélectionné.

Gestionnaires de soumission de formulaire

Les gestionnaires de soumission de formulaire permettent aux utilisateurs d'effectuer une validation et éventuellement d'annuler la soumission d'un formulaire en cas d'erreur.

Pour obtenir des exemples détaillés d'utilisation de gestionnaires personnalisés et de personnalisations dans la console Web, reportez-vous aux sections Web Console Customization (Personnalisation de la console Web) et Workflow Customization (Personnalisation du workflow) du manuel Product Customization Reference Guide (Guide de référence sur la personnalisation du produit) sur la page de documentation relative à DRA.

Activation du code JavaScript personnalisé

Pour des raisons de sécurité, le code JavaScript personnalisé est désactivé par défaut. L'activation du code JavaScript personnalisé permet aux administrateurs d'écrire des extraits de code JavaScript que la console Web exécute en l'état. N'activez cette exception que si vous comprenez et en acceptez les risques.

Pour permettre aux personnalisations d'inclure du code JavaScript personnalisé, procédez comme suit :

Accédez à l'emplacement C:\ProgramData\NetIQ\DRARESTProxy.
Ouvrez le fichier restProxy.config.
Ajoutez allowCustomJavaScript="true" à l'élément <consoleConfiguration>.

24.3.1 Procédure de base pour créer un gestionnaire personnalisé :

Les étapes ci-dessous commencent à partir d'une page présélectionnée d'un gestionnaire personnalisé. Pour y arriver, accédez aux gestionnaires personnalisés des propriétés d'objet via l'icône de propriétés dans un champ de propriété. Pour accéder aux gestionnaires Form Load (Chargement de formulaire) et Form Submit (Soumission de formulaire), cliquez sur le bouton Form Properties (Propriétés du formulaire) dans un formulaire de workflow sélectionné ou sur une page Create Object (Créer un objet) ou Edit Properties (Éditer les propriétés).

Sélectionnez l'onglet de gestionnaire correspondant en fonction de la propriété ou de la page personnalisée :
- Gestionnaires personnalisés
- Gestionnaires de chargement de formulaire
- Gestionnaires de soumission de formulaire
Activez la page de gestionnaire et effectuez l'une des opérations suivantes :
- Gestionnaire personnalisé de champ de propriété :
  1. Sélectionnez un moment d'exécution. En règle générale, vous utiliserez la deuxième ou troisième option comme moment d'exécution.
  2. Cliquez sur + Add (+ Ajouter), puis choisissez un gestionnaire personnalisé dans le menu Add Custom Handler (Ajouter un gestionnaire personnalisé).
- Gestionnaire de formulaire : cliquez sur + Add (+ Ajouter), puis choisissez un gestionnaire personnalisé dans le menu Add Custom Handler (Ajouter un gestionnaire personnalisé).
REMARQUE :en règle générale, vous n'aurez besoin que d'un seul gestionnaire personnalisé, mais vous pouvez en utiliser plusieurs. Les gestionnaires multiples sont exécutés de manière séquentielle dans l'ordre indiqué. Si vous souhaitez modifier l'ordre des gestionnaires ou ignorer un gestionnaire qui n'est pas nécessaire, vous pouvez ajouter des macros de contrôle de flux dans le script.
Vous devrez configurer chaque gestionnaire personnalisé que vous ajoutez à la page. Les options de configuration varient selon le type de gestionnaire.

Vous pouvez créer vos propres types de gestionnaire.
- Gestionnaires de requêtes LDAP ou REST :
  1. Si vous souhaitez que votre requête repose sur des valeurs statiques, définissez Informations de connexion et Paramètres de requête.
    
    Pour que votre requête soit dynamique, entrez des valeurs de marque de réservation dans les champs obligatoires. Cette opération est obligatoire pour permettre l'exécution du gestionnaire. Le script remplace les valeurs de marque de réservation.
    
    REMARQUE :vous pouvez également configurer des en-têtes et des cookies pour la requête REST.
  2. Pour l'opération antérieure à la requête, utilisez l'éditeur de script pour écrire un code JavaScript personnalisé à exécuter avant la soumission de la requête. Ce script a accès à toutes les informations de connexion et à tous les paramètres de requête, et peut modifier n'importe lequel de ces éléments pour personnaliser la requête. Par exemple, il peut définir les paramètres de requête en fonction des valeurs saisies par l'utilisateur dans le formulaire.
  3. Pour l'opération postérieure à la requête, incluez le script pour traiter les résultats de la requête. Les tâches courantes incluent la recherche d'erreurs éventuelles, la mise à jour des valeurs de formulaire en fonction des résultats renvoyés et la validation de l'unicité des objets en fonction du nombre d'objets renvoyés par la requête.
- Script : insérez du code JavaScript personnalisé pour créer le script.
- Requête DRA : spécifiez la charge utile JSON dans l'onglet Query Parameters (Paramètres de requête). Le format de charge utile doit correspondre aux paires de clés ou de valeurs VarSet envoyées au serveur DRA. Comme pour les requêtes REST et LDAP, vous pouvez spécifier une opération antérieure à la requête qui peut servir à modifier la charge utile avant qu'elle soit soumise au serveur, ainsi qu'une opération postérieure à la requête pour traiter les résultats.
- Gestionnaires de zones Message : après avoir défini les propriétés de la zone Message, vous pouvez écrire les segments JavaScript pour les opérations Beforce-Show Action (Opération d'avant affichage) et After-Close Action (Opération d'après fermeture).
  
  Ces opérations sont facultatives. L'opération d'avant affichage sert à personnaliser l'une des propriétés de la zone Message avant qu'elle ne soit affichée pour l'utilisateur, tandis que l'opération d'après fermeture sert à traiter la sélection de bouton de l'utilisateur et à effectuer la logique supplémentaire correspondante.
Cliquez sur OK pour enregistrer le gestionnaire.