Créez et gérez des pages de formulaire pour n'importe quel modèle. Tous les formulaires disponibles pour l'utilisateur actuel sont listés ici.

Le champ « Filtre » permet d'affiner les informations affichées en appliquant des critères spécifiques. La recherche s'applique à toutes les colonnes de données. Par exemple, la saisie de « Incident » affichera tous les formulaires ayant le modèle cible « Incident », ainsi que tous les formulaires dont le nom contient le mot « Incident ».

Les informations des formulaires sont affichées dans les colonnes suivantes :

Création de nouveaux formulaires

1. Pour commencer la création d'un nouveau formulaire, cliquez sur le bouton « Nouveau formulaire » : 
   
2. Cela ouvrira la fenêtre « Nouveau formulaire » : 
   
3. Pour démarrer le processus de création, sélectionnez le modèle cible dans la liste ci-dessous. Le champ de recherche permet d'affiner la liste des modèles.
4. Une fois le modèle sélectionné, cliquez sur le bouton Terminé pour continuer. Le menu de création du formulaire s'ouvrira alors : 
   
5. Les champs suivants sont disponibles :
   • Icône - L'icône par défaut peut être modifiée en cliquant dessus et en sélectionnant une nouvelle icône dans le menu de sélection.
   • Nom (obligatoire) - Nom du formulaire. Limite : 60 caractères.
   • Signaleur (obligatoire) : Nom de la personne ou de l’entité ayant signalé le problème traité par le formulaire. Dans la plupart des cas, il s’agit de l’utilisateur final qui s’est connecté au portail.
   • Pièce jointe : indique si l’ajout de fichiers au formulaire est possible ou non. Cela nécessite l’activation du gestionnaire FileUpload sur le modèle sélectionné.
   • Discussion - Indique si les échanges bidirectionnels par commentaires sont possibles. Cela nécessite l'activation du gestionnaire de commentaires sur le modèle sélectionné.
   • Publication - Une fois le formulaire publié, il peut être inséré dans des panneaux, des listes et des groupes de panneaux.
6. Pour ajouter des champs au formulaire, cliquez sur le bouton Nouveau champ .
7. Pour ajouter des éléments au formulaire, cliquez sur le bouton « Nouvel élément » . Les administrateurs peuvent inclure des titres de section et des blocs de texte afin de uid l'utilisateur final lors de la saisie du formulaire. L'ordre des titres et des blocs de texte est modifiable par l'administrateur. Ces éléments ne sont visibles que lors de la création d'un incident, et non dans la vue détaillée d'un incident existant.
   1. Lorsque vous cliquez sur le bouton Nouvel élément , un menu déroulant apparaît en dessous, proposant les options Titre de la section et Bloc de texte. Cette opération est similaire à l'ajout d'un nouveau champ.
      1. Titre de la section - Ceci ajoute un titre de section d'une longueur maximale de 450 caractères
      2. Bloc de texte : ajoute un bloc de texte d’une longueur maximale de 2 000 caractères. Le contenu de ce bloc peut être du texte enrichi, y compris des URL. Remarque : les images ne sont pas prises en charge dans les blocs de texte enrichi.
8. Pour tous les champs, le processus de création de champ comporte deux étapes :
   1. Sélectionnez l'attribut de la première étape cible dans le champ « Attribut cible ».
   2. Finalisez le champ sur le deuxième écran Apparence où le nom d'affichage peut être sélectionné (par défaut, il affiche le nom de l'attribut cible, sélectionné précédemment).
9. Le champ peut être l'un des suivants :
   • Case à cocher - L’attribut cible doit être une chaîne statique à valeurs multiples. Veuillez noter que si de nouvelles valeurs sont ajoutées à l’attribut, ce champ ne sera pas automatiquement mis à jour.
     • Comporte les options « Limiter les sélections » qui limitent le nombre maximal de sélections possibles et « Obligatoire » (nombre minimal de cases à cocher) sur l'écran Apparence.
   • Date - Cela inclut les attributs de type date.
   • Date et heure - Cela inclut les attributs de type date et date et heure. 
     • L'option « Obligatoire » (ce champ est-il obligatoire ?) est-elle activée sur l'écran d'apparence ?
   • Liste déroulante - L'attribut cible est une chaîne statique à valeur unique ou un attribut de référence provenant d'un modèle cible :
     • L'écran Apparence comporte les options « Obligatoire » et « Utiliser l'info-bulle ».
       • Option « Obligatoire » : si elle est activée, l'utilisateur doit remplir ce champ.
       • Option « Utiliser l’infobulle » : si elle est activée, une infobulle s’affiche lorsque l’utilisateur survole une valeur de menu. Cette infobulle présente les mêmes données que celles affichées dans l’interface utilisateur ESM pour une valeur de référence (attributs sélectionnés du modèle), à condition que l’utilisateur associé aux champs de référence (défini dans Paramètres généraux → « Utilisateur des autorisations de référence ») dispose des droits d’accès nécessaires pour consulter ces données.
     • Lorsqu'un attribut de référence est sélectionné, un aperçu des 25 premières fiches de données peut être affiché en appuyant sur le bouton « Aperçu des données ».
       • Si l'attribut de référence possède un filtre EQL défini, une notification apparaît dans le menu déroulant avec l'avertissement suivant : « Remarque : un filtre EQL est défini pour cet attribut. Veuillez vérifier le filtre exact dans l'éditeur de modèles. »
   • Liste déroulante à sélection multiple - L'attribut cible doit être une chaîne statique à valeurs multiples ou un attribut de référence provenant d'un modèle cible : Notez que si de nouvelles valeurs sont ajoutées à l'attribut, ce champ n'est pas automatiquement mis à jour avec ces valeurs.
     • Comporte les options « Limiter les sélections » qui limitent le nombre maximal de sélections possibles, « Obligatoire » et « Utiliser l'info-bulle » sur l'écran Apparence.
       • Option « Obligatoire » : si elle est activée, l'utilisateur doit remplir ce champ.
       • Option « Utiliser l’infobulle » : si elle est activée, une infobulle s’affiche lorsque l’utilisateur survole une valeur de menu. Cette infobulle présente les mêmes données que celles affichées dans l’interface utilisateur ESM pour une valeur de référence (attributs sélectionnés du modèle), à condition que l’utilisateur associé aux champs de référence (défini dans Paramètres généraux → « Utilisateur des autorisations de référence ») dispose des droits d’accès nécessaires pour consulter ces données.
       • Notez que pour les références, le nombre maximal de sélections est de 25 valeurs.
     • Lorsqu'un attribut de référence est sélectionné, un aperçu des 25 premières fiches de données peut être affiché en appuyant sur le bouton « Aperçu des données ».
       • Si l'attribut de référence possède un filtre EQL défini, une notification apparaît dans le menu déroulant avec l'avertissement suivant : « Remarque : un filtre EQL est défini pour cet attribut. Veuillez vérifier le filtre exact dans l'éditeur de modèles. »
   • Texte court - Une chaîne de caractères est une entrée sur une seule ligne pour des données alphanumériques courtes, telles que des noms ou des adresses électroniques.
     • L'option « Obligatoire » (ce champ est-il obligatoire ?) est-elle activée sur l'écran d'apparence ?
     • La validation des données par expression régulière peut être ajoutée si l'option « Validation des données » est activée.
       • Saisissez l'expression régulière dans le champ RegEx (limite de 1000 caractères).
         • Le format Regex pris en charge est un sous-ensemble de JS et de re2 .
       • Saisissez l'expression d'erreur de validation dans le champ « Message d'erreur de validation ». Ce message s'affiche à l'utilisateur si la validation des données échoue.
   • Zone de texte : permet aux utilisateurs de saisir plusieurs lignes de texte ou des paragraphes plus longs. Peut être utilisée pour recueillir des commentaires, des messages ou d’autres textes libres.
     • L'option « Obligatoire » (ce champ est-il obligatoire ?) est-elle activée sur l'écran d'apparence ?
10. Une fois un champ ajouté, il s'affiche dans la liste des champs ci-dessous.
    • Les champs affichés peuvent être filtrés en saisissant du texte dans le champ Filtre.
    • En utilisant les cases à cocher sur les lignes de champs, plusieurs champs peuvent être sélectionnés simultanément pour suppression ou déplacement.
11. S'il y a plusieurs champs, ils peuvent être réorganisés à l'aide de la poignée de glisser-déposer située à gauche de la case à cocher : 
    

Gestion des champs

Dans le menu du formulaire, le formulaire peut être supprimé ou dupliqué en cliquant sur les trois points et en sélectionnant l'option appropriée :

Sous le champ Gérer, les actions suivantes sont disponibles :

Le champ peut être supprimé en cliquant sur le bouton Supprimer :

Le champ peut être modifié en cliquant sur l'icône Modifier :

Conditions

Le champ peut avoir des conditions, qui sont gérées en cliquant sur l'icône Condition :

L'administrateur peut définir des conditions d'affichage d'un champ pour l'utilisateur final, en fonction des sélections effectuées dans d'autres champs du formulaire. Sur le formulaire ESS2 , le champ conditionnel n'est visible que si la saisie correspond exactement à la condition. Un champ peut comporter jusqu'à 10 conditions. Les conditions disponibles sont :

• est égal à (condition par défaut)
• n'est pas égal à
  • Si l'opérateur « est égal à » ou « n'est pas égal à » est sélectionné, l'administrateur doit également fournir une valeur pour la condition.
  • La condition ne peut pas être enregistrée si la valeur est manquante.
  • Les espaces blancs seuls (valeurs vides) ne sont pas autorisés.
  • La sauvegarde est activée lorsqu'un caractère autre qu'un espace est saisi.
  • La longueur maximale de la valeur est de 450 caractères.
  • Si l'opérateur est modifié en « existe » ou « n'existe pas », le champ de valeur disparaît. La saisie n'est pas conservée.
• Exister
• N'existe pas

Le champ Source de la condition peut être un champ texte court, une liste déroulante, une liste déroulante à sélection multiple ou une case à cocher. Si la Source est une référence, la valeur est sélectionnée dans une liste déroulante, le cas échéant. Cette liste déroulante affiche les valeurs de référence du champ Source sélectionné. En cliquant sur le champ Valeur, la liste des valeurs associées à cette liste déroulante s'affiche. Les utilisateurs peuvent rechercher des valeurs en saisissant une chaîne de caractères imprimables. Si tous les attributs de référence ne sont pas chargés à l'ouverture de la liste déroulante, d'autres valeurs s'affichent lorsque vous faites défiler vers le bas.

En cliquant sur l'icône d'ajout, l'administrateur peut configurer plusieurs conditions :

Lorsqu'un ou plusieurs champs sont soumis à plusieurs conditions, un connecteur de condition s'affiche. Il indique si toutes les conditions doivent être vraies (ET) ou si une seule d'entre elles suffit (OU). Le connecteur est soit ET, soit OU, pour l'ensemble des conditions. Par défaut, le connecteur est ET. Vous pouvez le modifier en cliquant dessus.

Si la condition n'est pas invalide, un texte d'avertissement s'affiche, la condition est mise en surbrillance et marquée d'une icône :

Pour supprimer la nouvelle condition, cliquez sur l'icône de suppression :

Attributs de mappage multiple

Normalement, l'attribut cible est identique à l'attribut source. Dans ce cas, une référence est établie entre ces deux attributs. S'ils sont différents, un mappage multiple est créé.

Les administrateurs souhaitent souvent définir plus de questions que ne le permet le modèle cible en termes d'attributs. Dans ce cas, ils associent plusieurs champs de formulaire à un seul attribut de texte intitulé « Informations complémentaires ».

Lorsque le mappage multiple est utilisé, aucune référence n'est créée entre les attributs et les valeurs de chaîne des options sélectionnées sont écrites sous forme de lignes de texte dans la valeur de l'attribut de texte ciblé.

Le type de données cible sera toujours « Texte » et son format est le suivant :

Multiple selections:<field name>:<selected value 1> <selected value 2>,... Single selections:<field name>:<selected value 1>

Lors de l'ajout d'un champ de formulaire, l'administrateur peut sélectionner un attribut de type « Texte » comme cible.

La source peut provenir de :

• Toute chaîne de caractères statique provenant d'un modèle accessible.
• Date (au format : jj.mm.aaaa).
• Date et heure (au format jj.mm.aaaa hh:mm).
• Attribut de référence d'un modèle cible :
  
  • Lorsqu'un attribut de référence est sélectionné, un aperçu des 25 premières fiches de données peut être affiché en appuyant sur le bouton « Aperçu des données ».

Exemple de multimapping

Exemple de création d'un champ à cartes multiples :

1. Cliquez sur « Nouveau champ ».
2. Sélectionnez « Liste déroulante à sélection multiple ».
3. Sous Attribut, sélectionnez Modèle « Ticket ».
   1. Lors de la sélection d'un modèle, l'attribut Source n'affichera que les attributs valides (certains modèles n'en ont aucun !).
4. Sélectionnez l'attribut source « Tâches » et cliquez sur « Suivant ».
5. Sous « Attribut cible », sélectionnez « Détails ».
   1. Étant donné que les attributs Cible et Source sont différents, un mappage multiple est créé et le format de texte est affiché ci-dessous : 
      
6. Définissez le nom d'affichage, choisissez si les options « Limiter les sélections » et/ou « Obligatoire » sont activées.
7. Une fois que tout est prêt, appuyez sur « Terminé » pour créer le champ.

La source peut également contenir des valeurs personnalisées qui sont toujours des données textuelles pures (définies dans le champ du formulaire) :

Filtrage des valeurs de référence pour les formulaires avec les filtres EQL

Cette fonctionnalité permet d'afficher, dans une liste déroulante d'un formulaire du portail, différentes options selon les utilisateurs ou de filtrer les résultats en fonction de certaines valeurs de données.

Un administrateur peut configurer des filtres EQL spécifiques à ESS2 pour tout attribut de référence de n'importe quel modèle. Ces filtres se trouveront dans la section « Autres propriétés » de l'attribut de référence. Voici un exemple d'ajout d'un filtre ESS2 à cette section.

À gauche, le filtre EQL doit être préfixé par « ess2_filter_ » pour le distinguer des filtres EQL ESM . L'administrateur peut saisir n'importe quel EQL dans le champ de métadonnées. Après le préfixe, des informations indiquent quel code de modèle source est référencé vers quel code de modèle cible, par exemple : « ticket->service ». À droite, collez l'instruction EQL telle quelle. Le filtre EQL ESS2 s'appliquera à tous les champs de formulaire référencés utilisant cet attribut de modèle comme attribut source.

Le filtre EQL est disponible dans les champs de liste déroulante et de liste déroulante à sélection multiple.

EQL est enregistrée dans l'attribut source du champ de référence. Il est également possible d'ajouter plusieurs filtres ESS2 à un même attribut, chacun faisant référence à un modèle différent, si le champ de référence possède un filtre EQL .

Pour l'utilisation des macros utilisateur, veuillez noter que le format est différent dans le cas d'utilisation ESS2 . Dans ESS2 les macros utilisateur prises en charge sont :

• #ess2UserName#
• #ess2UserId#
• #ess2User#

Les macros doivent faire référence à l'utilisateur réel et non à un utilisateur de référence.

Exemples de cas d'utilisation des macros utilisateur ci-dessous

Remplacer les valeurs par défaut

Un administrateur ESS2 peut définir des valeurs par défaut de remplacement qui seront attribuées à la carte de données lors de sa création via ESS2 .

L'administrateur peut définir des « valeurs de remplacement » pour chaque formulaire en procédant comme suit :

1. Accédez à son onglet de configuration sur la page d'administration en libre-service.
2. Appuyer sur « Nouvelle modification » dans la zone de configuration du tableau.
3. Ajout d'une nouvelle valeur de remplacement.

Les types de données pris en charge sont :

• Chaîne
• Corde statique
• Champs de texte
• Champs de référence

Lorsque des valeurs sont définies dans le configurateur, toutes les fiches de données créées utiliseront les valeurs de remplacement spécifiées dans le formulaire. Si l'administrateur définit un champ de formulaire et une valeur de remplacement pour le même attribut cible, la valeur saisie par l'utilisateur dans ce champ remplacera la valeur de remplacement spécifique au formulaire.

Cette fonctionnalité étend les possibilités des valeurs de remplacement pour inclure la prise en charge des types d'attributs de référence.

Un administrateur peut également définir une valeur de référence pour les valeurs de remplacement, afin de pouvoir par exemple définir des groupes de support par défaut pour chaque formulaire.

Pour remplacer les valeurs par défaut, l'administrateur peut sélectionner un type d'attribut de référence à valeur unique. Notez que dans la zone de configuration de remplacement des valeurs par défaut, l'administrateur peut sélectionner n'importe quelle fiche de données à laquelle il a accès, sans restriction liée aux autorisations de l'utilisateur.

Administrateur :

• L'administrateur peut sélectionner un type d'attribut de référence (non multivalué).
• Après la sélection, l'administrateur peut ouvrir une liste déroulante pour afficher la liste des noms de fiches de données disponibles (ou attribut principal).
  • L'administrateur peut sélectionner n'importe quelle carte de données à laquelle il a accès, sans restriction quant aux autorisations de l'utilisateur.
  • Les fiches techniques sont paginées
• L'administrateur peut sélectionner l'une des options du menu déroulant.
• Une fois le formulaire soumis dans l'interface utilisateur du portail, la fiche de données générée contiendra la valeur enregistrée dans l'attribut associé.

Utilisateur final :

• L'utilisateur final ne devrait voir que les valeurs auxquelles l'utilisateur autorisé a accès.
  • Dans le cas où : 1.) l'administrateur a configuré une valeur de remplacement à laquelle l'« utilisateur disposant de l'autorisation de référence » n'a pas accès, et 2.) l'attribut a été configuré pour être visible dans les détails de la requête (via le formulaire ou la vue de présentation) → L'utilisateur final ne verra pas la valeur dans les détails de la requête .
• Si la fiche de données référencée est supprimée, les fiches de données créées recevront une valeur vide pour l'attribut ciblé.

Remplacer les valeurs des champs de référence

Pour remplacer les valeurs par défaut, l'administrateur peut sélectionner un type d'attribut de référence à valeur unique. Notez que dans la zone de configuration de remplacement des valeurs par défaut, l'administrateur peut sélectionner n'importe quelle fiche de données à laquelle il a accès, sans restriction liée aux autorisations de l'utilisateur.

Administrateur :

• L'administrateur peut sélectionner un type d'attribut de référence (non multivalué).
• Après la sélection, l'administrateur peut ouvrir une liste déroulante pour afficher la liste des noms de fiches de données disponibles (ou attribut principal).
  • L'administrateur peut sélectionner n'importe quelle carte de données à laquelle il a accès, sans restriction quant aux autorisations de l'utilisateur.
  • Les fiches techniques sont paginées
• L'administrateur peut sélectionner l'une des options du menu déroulant.
• Une fois le formulaire soumis dans l'interface utilisateur du portail, la fiche de données générée contiendra la valeur enregistrée dans l'attribut associé.

Utilisateur final :

• L'utilisateur final ne devrait voir que les valeurs auxquelles l'utilisateur autorisé a accès.
  • Dans le cas où : 1.) l'administrateur a configuré une valeur de remplacement à laquelle l'« utilisateur disposant de l'autorisation de référence » n'a pas accès, et 2.) l'attribut a été configuré pour être visible dans les détails de la requête (via le formulaire ou la vue de présentation) → L'utilisateur final ne verra pas la valeur dans les détails de la requête .
• Si la fiche de données référencée est supprimée, les fiches de données créées recevront une valeur vide pour l'attribut ciblé.

Comment ajouter de nouvelles valeurs de remplacement pour les champs de référence

Ouvrez « Formulaires généraux → Formulaire → Remplacer les valeurs par défaut » :

Cliquez sur le bouton + Nouvelle dérogation . L'assistant de création de nouvelle dérogation s'ouvre alors.

1. Sélectionnez l'attribut cible.
2. Une fois sélectionné, le champ Valeur affiche la valeur par défaut actuelle du modèle. 
   
3. Dans le champ Valeur , choisissez maintenant la nouvelle valeur pour remplacer la valeur par défaut : 
   
4. Cliquez sur Enregistrer pour sauvegarder toutes les modifications.
5. La nouvelle valeur de remplacement s'affichera désormais dans la colonne Valeur de la vue Valeurs par défaut de remplacement : 
   

Détails du gestionnaire de commentaires

Le gestionnaire de commentaires est un nouveau gestionnaire dont l'interface utilisateur est basée sur celle du gestionnaire de journal de travail. Lorsqu'un utilisateur ESM ou ESS2 ajoute un commentaire, celui-ci est ajouté comme fiche de données enfant à la fiche de données parent (la fiche de données principale à laquelle les commentaires et leurs fiches enfants sont liés). Le modèle de commentaire se trouve dans les modèles système, mais il est verrouillé et sa modification est désactivée pour les administrateurs ESM . Si la fiche de données parent est supprimée, toutes les fiches de commentaires associées le sont également. De plus, le commentaire étant considéré comme faisant partie de la fiche de données principale, la recherche globale renvoie la fiche de données parent si la valeur de la chaîne de recherche est trouvée dans le commentaire.

Le gestionnaire de commentaires assure également le suivi des nouveaux commentaires non marqués comme lus. ESS2 traite automatiquement ces nouveaux commentaires et les marque comme lus. Côté ESM ESM l'utilisateur doit marquer manuellement les nouveaux commentaires comme lus.

Les commentaires non lus seront marqués « Nouveau » sur les interfaces utilisateur ESS2 et ESM . Sur l'interface utilisateur ESM , l'agent devra mettre à jour manuellement les commentaires lus sur la fiche de données. Pour identifier les problèmes liés aux commentaires non lus, les utilisateurs ESM peuvent utiliser l'outil de reporting de Matrix42 afin d'affiner les résultats.

Un commentaire est ajouté lorsque l'utilisateur ajoute un ou plusieurs fichiers au problème. Ce commentaire inclut le nom du fichier et son extension. Aucun commentaire n'est ajouté si l'agent ESM ajoute un fichier au problème via l'interface utilisateur ESM .

Pour plus d'informations sur la gestion des commentaires via l' API Python, consultez cet article .

Balises d'attribut

Lors de la sélection d'un attribut, la liste des attributs affiche le type de l'attribut sous forme d'étiquette à côté de celui-ci : 

Ces listes et étiquettes s'affichent lorsque :

• Sélection de l'attribut Source pour un champ de formulaire.
• Sélection de l'attribut Cible pour un champ de formulaire.
• Sélection des attributs de remplacement pour un formulaire.
• Sélection des attributs à afficher dans la section Détails de la présentation du cas.
• Sélection des attributs à afficher dans la vue d'ensemble de la présentation du cas.