ETQ administrateur, j’ai accès au type de champ « Référentiel à configurer (avancé) »

[marleneklok]

No description provided.

[marleneklok]

Profil ADMINISTRATEUR

Choix du type de champ

L'administrateur sélectionne le type de champ Référentiel à configurer (avancé) dans la section "Référentiel externe" des types de champs :

Il doit maintenant le configurer (la configuration va se faire sur un écran dédié avec un process en 3 étapes) :

Vue globale du process de configuration

En cliquant sur le bouton "Configurer le champ" :

...l'administrateur accède à l'écran de la première étape du process de configuration et peut dérouler le process :

Étape 1/3 : Requête

Configuration par défaut :

Mode d'interrogation du référentiel (URL / CSV)

À partir d'une URL :
L'administrateur doit renseigner l'URL d'appel du référentiel :

À partir d'un fichier CSV :
L'administrateur peut télécharger le modèle de fichier (Modele_referentiel.csv) et doit ensuite charger son propre fichier :

Mode de remplissage du champ par l'usager

Correspondance exacte :
Exemple de cas d'utilisation : saisie d'une plaque d'immatriculation (= match exact, pas de proposition d'autosuggestions).
L'administrateur doit renseigner les indications qui seront fournies à l'usager concernant le format de saisie attendu, ainsi qu'un exemple de saisie valide (qui sera affiché à l'usager et qui sera aussi utilisé pour tester la requête et afficher la réponse récupérée à l'étape suivante 2/3 : Réponse et mapping) :

Autosuggestions au fur et à mesure de la saisie de l’usager :
Exemple de cas d'utilisation : saisie de la dénomination d'un médicament (ex. : DOLIPRANE 1000 mg, comprimé effervescent sécable).
L'administrateur doit renseigner les indications qui seront fournies à l'usager concernant le format de saisie attendu, ainsi qu'un exemple de saisie valide (qui ne sera pas affiché à l'usager mais uniquement utilisé pour tester la requête et afficher la réponse récupérée à l'étape suivante 2/3 : Réponse et mapping) :

Ajout d'une méthode d'authentification

L'administrateur peut choisir d'ajouter une méthode d'authentification :

...et doit ensuite renseigner le header d'authentification :

Étape 2/3 : Réponse et mapping

En arrivant sur l'écran de l'étape 2, l'administrateur peut afficher la réponse récupérée à partir de la requête configurée (présentée dans un accordéon) :

À cette étape, l'administrateur doit, pour chaque propriété du tableau :
• Définir le type de donnée (texte, nombre décimal, …)
• Choisir d’utiliser la donnée pour préremplir un champ du formulaire usager OU donner un libellé à cette donnée

Accompagnement utilisateur

Si l'administrateur a besoin d'explications, il peut cliquer sur l'icône "i" au niveau de l'en-tête de la colonne "Utiliser la donnée pour préremplir un champ du formulaire", une modale d'information s'affiche :

De la même manière, s'il a besoin d'explications, il peut cliquer sur l'icône "i" au niveau de l'en-tête de la colonne "Libellé de la donnée récupérée...", une modale d'information s'affiche :

Étape 3/3 : Pré remplissage des champs et/ou affichage des données récupérées

À cette étape, l'administrateur doit :
• [1er tableau] (s'il a choisi d'utiliser des données pour préremplir des champs du formulaire usager) Indiquer pour chaque donnée le champ qui doit être prérempli
• [2ème tableau] Indiquer quelles données doivent être affichées à l’USAGER (dans le formulaire) et à l’INSTRUCTEUR (dans l'onglet "Demande")

Pré remplissage des champs

(Si à l'étape précédente, l'administrateur a choisi de n’utiliser aucune donnée pour préremplir les champs du formulaire usager)
Un message explicite est affiché à la place du premier tableau :

(Si l'administrateur a sélectionné des données pour préremplir des champs)
Il doit maintenant sélectionner le champ concerné en face de chaque propriété / donnée :

Affichage des données récupérées (à l'usager et/ou l'instructeur)

L'administrateur doit cocher les données qu'il souhaite voir affichées à l'usager et/ou à l'instructeur. Ces données seront présentées via le libellé de la donnée (qui a été renseigné à l'étape précédente).
Par défaut, les cases de la colonne "Afficher à l'instructeur" sont cochées pour toutes les propriétés pour lesquelles un « Libellé de la donnée » a été renseigné à l’étape précédente.
Si l'administrateur n'a pas renseigné un « Libellé de la donnée » pour certaines propriétés, elles sont quand même affichées dans ce tableau (avec une mention explicite "vous n'avez pas nommé cette donnée") et avec comme libellé celui de la propriété (exemple : "id", "source", "created_at", "source_version").

Accompagnement utilisateur

Si l'administrateur a besoin d'explications, il peut cliquer sur l'icône "i" au niveau de l'en-tête de la colonne "Champ du formulaire usager à préremplir", une modale d'information s'affiche :

De la même manière, s'il a besoin d'explications, il peut cliquer sur l'icône "i" au niveau de l'en-tête de la colonne "Libellé de la donnée récupérée", une modale d'information s'affiche :

Validation de la configuration (fin du process)

En cliquant sur "Valider" en bas de la dernière étape 3/3 :

...l'administrateur retourne à la liste des champs :
• Le badge "À CONFIGURER" est remplacé par un badge "CONFIGURÉ"
• Le bouton "Configurer le champ" est remplacé par un bouton "Modifier la configuration"

Cas « L’administrateur modifie le référentiel sur une démarche déjà publiée / avec des dossiers déjà déposés »

Si l’administrateur a modifié la configuration du référentiel sur une démarche déjà publiée / avec des dossiers déjà déposés, le bandeau d’avertissement invitant à « Publier les modifications » est affiché (comme pour n’importe quelle modification de champ)

Cas « L’administrateur supprime un champ du formulaire qui devait être prérempli par une donnée issue du référentiel »

[écran "Liste des champs"]
Si l’administrateur veut supprimer un champ qui doit être prérempli à partir du référentiel, une demande de confirmation est affichée :

[écran de l'étape 3/3 - 1er tableau de sélection des champs du formulaire usager qui doivent être préremplis]
Si l’administrateur a supprimé un champ qui devait être prérempli à partir du référentiel, un avertissement est affiché au niveau de la cellule concernée (avec possibilité de sélectionner un autre champ, le cas échéant) :

[marleneklok]

Profil USAGER / Prévisualisation ADMINISTRATEUR

Comportement du champ référentiel - Cas "Correspondance exacte"

Feedback ok (comme pour le champ RNF...) :

Message d'erreur automatique :

Message d'erreur automatique - VARIANTE avec alternative de saisie hors référentiel :

Comportement du champ référentiel - Cas "Avec autosuggestions"

Sélection correcte d'une autosuggestion :

Message d'erreur automatique (donnée qui n'existe pas) :

Message d'erreur automatique (donnée qui n'existe pas) - VARIANTE avec alternative de saisie hors référentiel :

Message d'erreur automatique (autosuggestion non sélectionnée) :

Affichage des données et pré remplissage

Dans l'exemple ci-dessous, le champ référentiel est le champ "Identifiant RNB (Référentiel National des Bâtiments)" :

L'administrateur a configuré ce champ référentiel de sorte que, une fois qu'il a été correctement renseigné par l'usager :
• On lui affiche la donnée "Statut actuel du bâtiment" issue du référentiel
• Les champs du bloc répétable "Adresses du bâtiment" et du champ "Coordonnées GPS du bâtiment" soient préremplis

Lorsque l'administrateur a choisi d'afficher des données issues du référentiel suite au remplissage correct du champ référentiel, l'usager peut afficher ces données via un système d'accordéon :

Autre exemple avec davantage de données restituées :

Cas "L'usager supprime / modifie la donnée préremplie"

On lui donne la possibilité de revenir à l'état initial "prérempli" :

[emsnytech]

👍

[marleneklok]

Profil INSTRUCTEUR

Tableau de suivi des dossiers

L’instructeur peut personnaliser les colonnes du tableau et/ou filtrer les dossiers, via :

Page Dossier > Onglet "Demande"

Dans l'exemple ci-dessous, l'administrateur a configuré le champ référentiel de sorte que, une fois qu'il a été correctement renseigné par l'usager :
• On affiche à l'instructeur les données "Statut actuel du bâtiment" et "Bâtiment réel (oui/non)" issues du référentiel
• Les champs du bloc répétable "Adresses du bâtiment" et le champ "Coordonnées GPS du bâtiment" sont préremplis pour l'usager

Format de présentation des données :
A côté de chaque donnée issue du référentiel (donnée du champ référentiel, données récupérées automatiquement ou données préremplies pour l'usager), on affiche l'icône "verified-badge".
Dans le cas où l'usager a modifié un champ qui devait être prérempli à partir d'une donnée du référentiel, on affiche sous cette donnée l'avertissement "Donnée du référentiel modifiée par l'usager".

Lorsque l'instructeur survole l'icône "verified-badge", l'infobulle "Donnée vérifiée du référentiel" s'affiche :

Donnée du champ référentiel - VARIANTE avec alternative de saisie hors référentiel :
Rappel de la vue USAGER :

Si l'usager a saisi une valeur hors référentiel, on affiche sous le champ référentiel désactivé l'avertissement "Champ référentiel désactivé par l'usager" :