Métadonnées d'un projet Self Help


Les projets Self Help possèdent des propriétés définies au travers de métadonnées. Ces propriétés s'appliquent à l'ensemble des procédures du projet Self Help, et peuvent être :

  • des métadonnées standard créées par EasyVista.

    exemple  Nom de la procédure ; Catégorie de la procédure

  • des métadonnées spécifiques créées par chaque client selon ses besoins.

    exemple  Mots clés associés à une procédure destinée à un agent virtuel

Les métadonnées peuvent être exportées dans un fichier .csv, afin de les retravailler plus facilement sous Excel. Une fois mis à jour, le fichier est importé dans le projet Self Help via le module d'administration : automatiquement, chaque métadonnée est réattribuée aux procédures concernées.

Elles peuvent être remontées lors d'une extraction de statistiques. Elles permettent ainsi de marquer un lot de procédures ayant besoin d'une analyse statistique particulière.

Métadonnées particulières

  • Métadonnées localisables en fonction de la langue d'un projet Self Help multilingue
  • Métadonnées propres au déploiement d'un agent virtuel  - Open url.png voir Description
  • Métadonnée gérant l'accès aux procédures du portail client selon les groupes auxquels l'utilisateur appartient  - Open url.png voir Exemple et Procédure

Remarques

  • Les métadonnées sont accessibles via la vue Propriétés du studio en mode Édition.
  • Les métadonnées standard définie par EasyVista ne peuvent pas être désactivées ni supprimées.
  • Les métadonnées désactivées d'un projet Self Help ne sont pas prises en compte au niveau des procédures, ni exportées.
  • Lors de la copie d'une procédure dans un autre projet Self Help, toutes les métadonnées du projet Self Help d'origine sont automatiquement copiées.
  • Pour supprimer une métadonnée ajoutée manuellement, il est nécessaire de la désactiver au préalable.
  • Les extractions de statistiques se font via les profils d'extraction.

Attention

  • Ne modifiez pas le projet Self Help pendant la phase de modification des métadonnées : l'ajout ou la suppression d’une procédure rendrait le fichier caduc.
  • N'ajoutez aucune ligne dans le fichier. De même, ne supprimez aucune ligne.
  • Ne modifiez pas la ligne d'entête.
  • Ne modifiez pas les colonnes A à I. Ces colonnes décrivent les informations générales de chaque procédure, et sont maintenues automatiquement par l'application Self Help.

Bonnes pratiques

  • Définissez des conventions d'écriture pour l'ensemble des métadonnées de votre projet Self Help et pour les valeurs qui ne sont pas localisables : noms écrits en minuscules, commençant par une majuscule, ...

    exemple  catégorie = ChangeCatalog ou change_catalog

  • Les champs Texte étant sensibles à la case, effectuez des copier / coller pour éviter les erreurs de frappe.
  • Effectuez l'export des métadonnées après avoir créé toutes les procédures du projet Self Help.
  • Pour créer rapidement et sans risque d'erreur de saisie les métadonnées dédiées à un agent virtuel, copiez dans votre projet Self Help une procédure d'un autre projet Self Help destinée à un agent virtuel. Automatiquement, les métadonnées dédiées à l'agent virtuel sont copiées dans votre projet Self Help.

Description des métadonnées

Métadonnées spécifiques

        Specific metadata.png

Accès

  • L'ajout d'une métadonnée s'effectue via Add metadata icon.png dans la barre d'outils de la vue Propriétés.
     

Clé : Identifiant unique de la métadonnée. Note : Lorsque la métadonnée est localisable, la clé est la même pour chaque langue.

Le nom et les valeurs par défaut doivent être localisés : Indique si un nom / valeur doit être saisi pour chaque langue (case cochée) ou si le même nom / valeur est appliqué quelle que soit la langue (case non cochée).

Nom : Nom de la métadonnée. Note : Une ligne est affichée pour chaque langue si la métadonnée est localisable.

S'applique à : Indique le type de composant auquel s'applique la métadonnée.

Type de données : Indique la nature de la métadonnée.

Valeur par défaut : Valeur par défaut de la métadonnée. Note : Une ligne est affichée pour chaque langue si la métadonnée est localisable.

Indexable : Indique si la métadonnée est indexable pour la recherche (valeur = 1), ou non (valeur = 0).

Save icon.png : Sauvegarde la métadonnée.

Activate metadata icon.png : Désactive la métadonnée. Celle-ci est automatiquement déplacée dans l'onglet Métadonnées désactivées.

Métadonnées standard

Ces métadonnées sont disponibles sur chaque procédure, quel que soit le projet Self Help.

    Open url.png voir Description
        Standard metadata.png

Export des métadonnées

Opération d'export

  • L'export s'effectue au niveau du projet Self Help.
    • Il peut être effectué par tout rédacteur ayant accès au domaine du projet Self Help.
    • Les métadonnées sont exportées dans la langue sélectionnée dans le volet Explorateur.
  • Nom du fichier exporté : <Nom_du_projet>_metadata_<langue>.csv

    exemple  Wiki_metadata_en_US.csv

  • Le fichier .csv comporte :
    • une ligne par procédure du projet Self Help ;
    • une colonne pour chaque métadonnée de procédure (propriétés générales et spécifiques), plus une colonne pour chaque métadonnée active du projet Self Help.

        CSV export file.png

Contenu du fichier d'export Excel

Les métadonnées sont regroupées suivant 3 types d'informations.

Métadonnée Description

Colonnes A à I : Informations sur les procédures

Attention : Ces colonnes ne doivent pas être modifiées dans le fichier.

Locale Langue de rédaction

exemple Anglais américain : en_US ; Français : fr_FR

Name Nom de la procédure
Description Texte descriptif de la procédure
Status Statut de la procédure dans le workflow de validation des contenus

exemple Brouillon, Approuvé

Alias Alias attribué à la procédure
Id Identifiant unique (GUID) de la procédure
ScenarioId Identifiant unique (GUID) du scénéria auquel appartient la procédure
Path Emplacement de la procédure dans l'arborescence du projet Self Help
EntryPoint Indique si la procédure est un point d'entrée, et donc exécutable par les utilisateurs (valeur 1), ou si elle n'est pas exécutable directement (valeur 0)

exemple

  • Procédure Quels sont mes biens ? : exécutable ==> valeur 1
  • Sous-procédure Recherche des biens : non exécutable ==> valeur 0

Colonnes J à O : Métadonnées générales des procédures

Note : Les valeurs de ces colonnes sont modifiables.

Category Catégorie à laquelle appartient la procédure
Category description Texte descriptif de la catégorie à laquelle appartient la procédure

Note : Donnée localisable par langue.

MetaDescription Balises méta Html associées à la procédure

Note : Donnée localisable par langue.

Sub Category Sous-catégorie à laquelle appartient la procédure
Sub Category description Description de la sous-catégorie

Note : Donnée localisable par langue.

Viewable Indique que la procédure doit être indexée ou non par le moteur de recherche

Colonnes P à S : Métadonnées spécifiques des procédures destinées à un agent virtuel

Note : Les valeurs de ces colonnes sont modifiables.

agentFlag Mode d'exécution de la procédure

Open url.png voir Description

exemple Welcome : Lancement de la procédure à l'ouverture du panneau conversationnel de l'agent virtuel

dialogFriendly Indique si la procédure doit s'ouvrir dans le panneau conversationnel de l'agent virtuel (valeur Vrai) ou dans le panneau latéral (valeur Faux)

Open url.png voir Description

intentAlt Liste des formulations de la demande à l'agent virtuel qui permettent d'ouvrir la procédure

Open url.png voir Description

exemple (demandes de l'utilisateur) Qu’est-ce que le logiciel X ? / A quoi sert le logiciel X ? / Que puis-je faire avec le logiciel X ?

tags Liste des mots clés associés à la procédure, affichés dans le nuage de tags (chaque mot clé renvoie vers une ou plusieurs nouvelles procédures Self Help de guidage ou d'aide)

Open url.png voir Description

Procédures

Comment exporter puis importer les métadonnées d'un projet Self Help

Étape 1 : Export des métadonnées

1. Affichez la vue Explorateur.

2. Cliquez droit sur le projet Self Help, dans l'arborescence.

3. Sélectionnez la langue de l'export, via Select language drop down.png dans le volet Explorateur.

4. Cliquez sur Exporter > Exporter les métadonnées.

5. Sauvegardez le fichier dans un répertoire.
Les métadonnées sont exportées dans un fichier au format .csv, dans la langue sélectionnée.

Étape 2 : Modification des métadonnées dans Excel

1. Ouvrez le fichier .csv dans Excel.

2. Effectuez les corrections et les ajouts d'informations souhaités.

3. Sauvegardez le fichier.

Étape 3 : Import des métadonnées

1. Allez sur le module d'administration.

2. Cliquez sur le menu Import > Attributs > + Importer des attributs.

3. Sélectionnez le fichier .csv et cliquez sur Importer.
Les métadonnées sont automatiquement réattribuées à l'ensemble des procédures du projet Self Help.

Comment travailler les métadonnées d'un projet Self Help multilingue

Étape 1 : Traitement des métadonnées non localisables

1. Sélectionnez la langue d'origine du projet Self Help, via Select language drop down.png dans le volet Explorateur.

2. Cliquez sur Exporter > Exporter les métadonnées.

3. Sauvegardez le fichier dans un répertoire.
Les métadonnées sont exportées dans un fichier au format .csv, dans la langue d'origine.

4. Ouvrez le fichier dans Excel, modifiez les données non localisables, puis sauvegardez le fichier.

5. Importez, dans le projet Self Help multilingue, le fichier contenant les données non localisables, via le module d'administration > menu Import > Attributs > + Importer des attributs
Les métadonnées non localisables sont automatiquement réattribuées à l'ensemble des procédures du projet Self Help, sans tenir compte de la langue.

Étape 2 : Traitement des métadonnées localisables par langue

1. Sélectionnez la première langue du projet Self Help, via Select language drop down.png dans le volet Explorateur.

2. Cliquez sur Exporter > Exporter les métadonnées.

3. Sauvegardez le fichier dans un répertoire.
Les métadonnées sont exportées dans un fichier au format .csv, dans la langue sélectionnée.

4. Ouvrez le fichier dans Excel, modifiez les données localisables, puis sauvegardez le fichier.

5. Importez, dans le projet Self Help multilingue, le fichier contenant les données localisables, via le module d'administration > menu Import > Attributs > + Importer des attributs
Les métadonnées localisables sont automatiquement réattribuées à l'ensemble des procédures du projet Self Help dans la langue sélectionnée.

6. Effectuez les mêmes opérations d'export / import pour chaque langue du projet Self Help multilingue.

Comment filtrer les procédures du portail client selon les groupes

FilterProceduresViaGroups

    Open url.png voir Exemple

Étape 1 : Ajout d'une métadonnée dédiée au niveau du projet Self Help associé au portail client

1. Sélectionnez le projet Self Help dans l'arborescence du volet Explorateur.

2. Cliquez sur la vue Propriétés.
Les propriétés du projet Self Help sont affichées.

3. Cliquez sur l'onglet Définition des métadonnées.

4. Cliquez sur Add metadata icon.png dans la barre d'outils pour créer une nouvelle métadonnée.

5. Renseignez la nouvelle métadonnée authorizedGroups.
         Add authorizedGroups metadata - To project.png

Étape 2 : Ajout des groupes d'utilisateurs autorisés au niveau de chaque procédure

1. Ouvrez l'arborescence du projet Self Help via Tree expand icon.png.

2. Sélectionnez la procédure à filtrer selon les groupes dans le volet Explorateur.

3. Cliquez sur la vue Propriétés.
Les propriétés de la procédure sont affichées. La nouvelle métadonnée authorizedGroups est affichée en bas de la liste.

4. Renseignez les groupes autorisés à accéder à la procédure dans la propriété authorizedGroups.
Notes

  • Séparez chaque groupe par l'un des caractères , ; | /.
  • Vous pouvez utiliser la fonction de gestion des attributs.

         Add authorizedGroups metadata - To procedure.png

5. Répétez les mêmes actions pour chaque procédure à filtrer selon les groupes.

Étape 3 : Test du filtrage des informations selon les groupes

    Open url.png voir Exemple : Filtrer les procédures du portail client

1. Allez sur le portail client.

2. Cochez l'un des groupes auxquels vous avez accès.
         Authorized groups list.png

3. Vérifiez que seules les procédures associées à ce groupe sont disponibles.

Tags:
Modifié par Utilisateur inconnu le 2020/03/24 13:37
Créé par Administrator XWiki le 2020/01/17 15:48

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020