Studio Online de SelfHelp - Description d'un fichier Excel de métadonnées

Modifié le 16/09/2022 11:18

Les métadonnées, ou attributs, sont des propriétés d'un projet Self Help qui s'appliquent à l'ensemble des procédures de celui-ci.

Elles peuvent être modifiées en masse via un fichier Excel.

Caractéristiques du fichier Excel

  • Fichier au format .csv 
  • Nom du fichier : <Project ID>_metadata.csv
  • Le fichier comporte :
    • pour chaque procédure, une ligne par langue d’édition du projet Self Help ;
    • une colonne pour chaque métadonnée de procédure (propriétés générales et spécifiques). Les valeurs localisées sont affichées dans chaque langue d’édition.

          Excel file.png

Attention

  • Ne modifiez pas les colonnes Locale, ID, ScenarioId, Path nécessaires à la reconnaissance des procédures, sous peine que le contenu du fichier Excel soit caduc. Elles sont mentionnées en rouge dans la description du fichier Excel.
  • N'ajoutez aucune ligne dans le fichier Excel. Ne supprimez aucune ligne. Ne modifiez pas la ligne d'entête.
NonLocatedMetadata_Caution
  • Pour les métadonnées non localisées, la valeur présente dans la case de la dernière ligne de la procédure est prise en compte.

    exemple  2 lignes sont présentes dans le fichier pour la procédure rédigée en français et en anglais

    • La métadonnée dialogFriendly n’est pas localisable.
    • La valeur true présente sur la dernière ligne est prise en compte, et non la valeur false présente sur la première ligne.
      Excel file - Metadata not translated.png
EndNonLocatedMetadata_Caution

Description du fichier Excel

Note : Les colonnes sur fond rouge ne doivent pas être modifiées.

Colonne Métadonnée Description
A Locale Langue de rédaction

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

Note : Si le projet Self Help n’est pas localisé, la valeur de la langue est value.

B Name Titre de la procédure, sous forme d'une chaîne de caractères
C Description Description de la procédure, sous forme d'une chaîne de caractères
D Status Statut de la procédure dans le workflow de validation des contenus

Liste des valeurs autorisées :

  • DRAFT (brouillon)
  • TO_BE_APPROVED (à approuver)
  • REWORK (à refaire)
  • APPROVED (approuvée)
  • PUBLISHED (publiée)
E Alias Alias attribué à la procédure

Notes :

  • Le nom de l’alias doit être unique.
  • Il ne doit pas commencer par on.
  • Il ne doit pas contenir d’espaces ni les caractères + ; : . % \.
F Id Identifiant unique (GUID) de la version de la procédure
G ScenarioId Identifiant unique (GUID) de la procédure
H Path Emplacement de la procédure dans l'arborescence du projet Self Help
I 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 (toute autre valeur - valeur false par défaut)

exemple

  • Procédure Quels sont mes biens ? : exécutable ==> valeur 1
  • Sous-procédure Recherche des biens : non exécutable ==> valeur 0
J ProcedureCategoryDescription Description de la catégorie à laquelle appartient la procédure, sous forme d'une chaîne de caractères localisée
K ProcedureSubCategory Sous-catégorie à laquelle appartient la procédure, sous forme d'une chaîne de caractères localisée
L agentFlag Mode d'exécution de la procédure - Open url.png voir Description

Liste des valeurs autorisées :

  • WELCOME
  • MISUNDERSTANDING
  • REPHRASE
  • HIDDEN
  • BYE
M dialogFriendly Indique si la procédure doit s'ouvrir dans le panneau conversationnel de l'agent virtuel (valeur true) ou dans le panneau latéral (toute autre valeur - valeur false par défaut) - Open url.png voir Description
N ProcedureViewable Indique que la procédure doit être indexée par le moteur de recherche (valeur true), ou non (toute autre valeur - valeur false par défaut)
O ProcedureMetaDescription Balises méta Html associées à la procédure, sous forme de chaînes de caractères localisées
P ProcedureSubCategoryDescription Description de la sous-catégorie à laquelle appartient la procédure, sous forme d'une chaîne de caractères localisée
Q ProcedureCategory Catégorie à laquelle appartient la procédure, sous forme d'une chaîne de caractères localisée
R 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), sous forme de chaînes de caractères localisées - Open url.png voir Description

Note : Les tags doivent être séparés par le caractère ;

S intentAlt Liste des formulations de la demande à l'agent virtuel qui permettent d'ouvrir la procédure, sous forme de chaînes de caractères localisées - 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 ?

Note : Les formulations doivent être séparées par les caractères . ! ou ?.

Colonnes suivantes Liste de toutes les métadonnées spécifiques associées au projet Self Help
Tags :
Powered by XWiki © EasyVista 2022