8.2 Client Web
Dans le client Web, vous pouvez personnaliser les propriétés d'objet, les formulaires d'automatisation de workflow et l'image de marque de l'interface utilisateur. Si elles sont implémentées correctement, les personnalisations de propriétés et de workflows permettent d'automatiser les tâches des assistants administrateur, dans le cadre de la gestion d'objets et de soumissions de workflow automatisé.
8.2.1 Personnalisation de pages de propriétés
Vous pouvez personnaliser les formulaires de propriété d'objet que vos assistants administrateur utilisent dans leurs rôles de gestion Active Directory par type d'objet. Cela inclut la création et la personnalisation de nouvelles pages d'objet basées sur les types d'objet intégrés à DRA. Vous pouvez également modifier les propriétés des types d'objet intégrés.
Les objets étant clairement définis dans la liste Pages de propriétés de la console Web, vous pouvez facilement identifier les pages d'objet qui sont intégrées, les pages intégrées qui sont personnalisées et les pages qui ne sont pas intégrées et ont été créées par un administrateur.
Personnalisation d'une page de propriétés d'objet
Pour personnaliser les formulaires de propriétés d'objet, vous pouvez ajouter ou supprimer des pages, modifier des pages et des champs existants et créer des gestionnaires personnalisés pour les attributs de propriété. Lorsque vous créez des gestionnaires personnalisés, ils s'exécutent automatiquement lorsqu'un champ de propriété est modifié ou lorsqu'un administrateur répond à une invite pour exécuter une requête, en fonction de leur configuration.
La liste d'objets dans les pages de propriétés propose deux types d'opération pour chaque type d'objet : Créer un objet et Modifier les propriétés. Ce sont les principales opérations que vos assistants administrateur exécutent dans le client Web. Vos personnalisations permettent aux administrateurs d'être plus efficaces et expérimentés lorsqu'ils gèrent des objets Active Directory dans DRA.
Pour personnaliser une page de propriétés d'objet au niveau de la console Web :
-
Connectez-vous à la console Web en tant qu'administrateur DRA.
-
Accédez à .
-
Sélectionnez un objet et un type d'opération (créer ou modifier) dans la liste des pages de propriétés.
-
Cliquez sur le bouton
.
-
Personnalisez le formulaire de propriétés d'objet en effectuant une ou plusieurs des opérations suivantes, puis appliquez vos modifications :
-
Ajouter une nouvelle page de propriétés :
-
Sélectionner une page de propriétés et la personnaliser :
-
Réorganiser les champs de configuration sur la page :
-
Modifier les champs ou les sous-champs :
-
Ajouter un ou plusieurs champs :
ou
-
Supprimer un ou plusieurs champs :
-
-
Créer des gestionnaires personnalisés pour les propriétés à l'aide de scripts, de zones Message ou de requêtes (LDAP, DRA ou REST)
Pour plus d'informations sur l'utilisation des gestionnaires personnalisés, reportez-vous à la section Ajout de gestionnaires personnalisés.
-
Création d'une page de propriétés d'objet
Pour créer une page de propriétés d'objet :
-
Connectez-vous à la console Web en tant qu'administrateur DRA.
-
Accédez à .
-
Sous tâches, cliquez sur .
-
Créez le formulaire initial des propriétés d'objet en définissant son nom, son icône, le type d'objet et la configuration de l'opération.
-
Personnalisez le nouveau formulaire en fonction de vos besoins. Reportez-vous à la Personnalisation d'une page de propriétés d'objet.
8.2.2 Personnalisation des formulaires de workflow
Lorsqu'ils sont créés ou modifiés, les formulaires de workflow sont enregistrés sur le serveur Web et accessibles au niveau de la console Web sur la page > . Ces formulaires sont utilisés pour soumettre les workflows automatisés qui sont créés sur le serveur d'automatisation de workflow. Vous pouvez personnaliser les formulaires pour encore améliorer et automatiser leur utilisation par les assistants administrateur afin d'effectuer des tâches de gestion d'objets.
Vous pouvez ajouter et modifier des propriétés de formulaire et des gestionnaires personnalisés. Le comportement de l'interface lors de l'ajout et de la personnalisation de propriétés est identique dans un formulaire d'automatisation de workflow que lors de la personnalisation de propriétés d'objet. Consultez les rubriques ci-dessous pour plus d'informations sur l'ajout et la modification de propriétés, l'ajout de gestionnaires personnalisés et l'automatisation de workflow.
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.
Les gestionnaires personnalisés de propriété permettent, notamment, d'interroger la valeur d'autres champs, de mettre à jour des valeurs, d'activer/de désactiver l'état en lecture seule d'un champ et d'afficher/de masquer des champs en fonction des variables configurées.
Les gestionnaires de chargement de formulaire permettent aux utilisateurs de personnaliser les formulaires en effectuant généralement une initialisation des contrôles. Les gestionnaires de soumission de formulaire permettent aux utilisateurs d'effectuer une validation et éventuellement d'annuler la soumission en cas d'erreur.
DRA permet également de simplifier la création de gestionnaires personnalisés avec plusieurs macros JavaScript (JS) que vous pouvez sélectionner dans le cadre du processus de création et de validation du gestionnaire personnalisé.
Procédure de base pour créer un gestionnaire personnalisé :
Les étapes ci-dessous commencent à partir d'une page d'un gestionnaire personnalisé présélectionné. Pour y arriver, accédez aux gestionnaires personnalisés des propriétés d'objet via le bouton Modifier dans un champ de propriété. Pour accéder aux gestionnaires de chargement et de soumission de formulaire, sélectionnez Propriétés du formulaire sur un formulaire de workflow ou sur une page de création d'objet.
-
Cliquez sur l'onglet Gestionnaires personnalisés applicable et activez la page
.
-
Gestionnaires personnalisés
-
Gestionnaires de chargement de formulaire
-
Gestionnaires de soumission de formulaire
-
-
Sélectionnez un gestionnaire personnalisé dans le menu déroulant, puis choisissez 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.
REMARQUE :vous n'aurez généralement besoin que d'un seul gestionnaire personnalisé, mais vous pouvez en utiliser plusieurs en configurant des contrôles de flux dans le script pour relier les gestionnaires.
-
Vous devrez configurer
chaque gestionnaire personnalisé que vous ajoutez à la page. Les options de configuration varient en fonction du type de gestionnaire, mais l'ensemble des gestionnaires s'exécutent à partir de JavaScript.
Vous pouvez créer vos propres entrées Vanilla JavaScript ou utiliser des macros intégrées.
-
Gestionnaires de requête LDAP ou REST :
-
Si vous souhaitez que votre requête repose sur des valeurs statiques, définissez et .
Pour que votre requête soit dynamique, entrez un texte de marque de réservation dans les champs obligatoires. Cette opération est obligatoire pour permettre l'exécution du script. Le script remplace les valeurs fictives.
REMARQUE :Vous pouvez également configurer des en-têtes et des cookies pour la requête REST.
-
Dans l'action avant la requête, sélectionnez un type de macro : , ou .
-
Sélectionnez une macro dans la liste déroulante et insérez-la ().
-
Insérez d'autres macros selon vos besoins, puis indiquez les valeurs souhaitées pour effectuer le script.
Par exemple, dans l'action avant la requête, nous allons utiliser un script pour vérifier que le nom de groupe entré par un utilisateur n'existait pas encore dans Active Directory au moment de la soumission du formulaire.
Nous devons créer une requête LDAP à l'aide du nom entré par l'utilisateur. Nous utilisons la macro Field() pour accéder à la valeur du champ Nom et créer la chaîne de requête que nous définissons ensuite en tant que filtre de requête à l'aide de la macro Filter().
Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';
-
En suivant l'exemple ci-dessus, nous allons vérifier les résultats renvoyés par la requête dans l'action après la requête. Les résultats sont renvoyés sous forme de tableau d'objets correspondant à la requête. Il nous suffit dès lors de vérifier si la longueur du tableau est supérieure à 0.
Lorsqu'un groupe correspondant est trouvé, nous utilisons la macro Cancel() pour annuler la soumission du formulaire, en transmettant à la macro un message facultatif à afficher pour l'utilisateur.
if (QueryResults().length > 0) { Cancel('Un groupe portant le même nom existe déjà, entrez un nom unique.');}
-
-
Script : insérez un code JavaScript personnalisé ou utilisez les macros pour générer le script.
-
Requête DRA : pour les paramètres de la requête, définissez une charge utile au format JSON. Utilisez ensuite les macros conformément à la description ci-dessus pour les requêtes LDAP et REST.
-
Gestionnaires de zones Message : après avoir défini les propriétés de la zone Message proprement dite, utilisez les macros de la même façon que décrit ci-dessus pour les requêtes LDAP et REST, mais au lieu des actions avant et après la requête, vous composez les scripts de macro des actions avant affichage et après fermeture.
-
-
Cliquez sur pour valider votre script avant l'enregistrement du formulaire.
Cette opération génère un résumé des résultats de test qui vous permet d'afficher les résultats de l'exécution.
REMARQUE :Si le gestionnaire dépend de l'état actuel du formulaire (par exemple, le champ contient une valeur), il ne s'exécute pas correctement, car aucune donnée n'est chargée lors de la modification d'un formulaire. Dans ces cas, le gestionnaire devra être testé en dehors de l'éditeur de formulaires en enregistrant la personnalisation, en accédant au formulaire approprié et en complétant les données requises.