Studio Online de Self Help - Description d'un fichier d'extraction Excel

Sommaire

Attention
Définitions
Description des feuilles Excel

Les fichiers de statistiques sont générés à partir de profils d’extraction. Ces profils permettent de filtrer les données à remonter du serveur Self Help :

le périmètre d'extraction des données est défini au travers des domaines et projets Self Help ;
les données à inclure dans le rapport peuvent être les données d'exécution des procédures, l'historique des recherches, ....

Chaque fichier de statistiques se présente sous la forme d'un classeur Excel comportant 6 feuilles.
Statistics file - Excel sheets.png

Attention

Le logiciel Tableau Reader permet de visualiser et manipuler le rapport gratuitement.
Une modification du modèle du rapport nécessite une version payante du logiciel Tableau.

Définitions

Point d’entrée : Première procédure exécutable par laquelle l’utilisateur démarre son exécution. En règle générale, le point d'entrée est identique à la procédure en cours, sauf quand l’utilisateur entre dans une sous-procédure.

Exécution : Parcours d’un utilisateur à partir d’une étape Début jusqu’à sa sortie de la procédure.

UID : Identifiant unique d’une procédure ou d’un projet Self Help, indépendamment de la version publiée.
Notes :
- L'UID est différent de l’ID qui change à chaque version publiée.
- En général, l'UID est l'ID de la première version.

Description des feuilles Excel

Feuille executions

Cette feuille présente les informations sur les exécutions des points d'entrée.
Selon la granularité choisie, une ligne peut correspondre à une procédure ou à une étape de procédure parcourue par un utilisateur.

Statistics file - Executions sheet.png

Colonne	Intitulé de la colonne	Description
Colonnes A à P : Informations sur l'étape, la procédure, le projet Self Help et le domaine auxquels se rapporte l'exécution
A	Step ID	Identifiant de l'étape
B	Execution ID	Identifiant de l'exécution
C	Step Order	Ordre d'apparition des étapes Note : Permet d'ordonner les étapes pour retracer le parcours de l'utilisateur
D ; E	Page ID ; Page name	Identifiant / Titre de l'étape visible
F à H	Entrypoint UID ; Entypoint ID ; Entrypoint name	Identifiant unique / Identifiant / Titre du point d'entrée de l'exécution
I à K	Procedure UID ; Procedure ID ; Procedure name	Identifiant unique / Identifiant (versionné) / Titre de la procédure
L à N	Project Id ; Project name ; Project version	Identifiant / Titre / Numéro de version du projet Self Help
O ; P	Domain ID ; Domain name	Identifiant / Titre du domaine
Colonnes Q, R et S : Informations sur l'utilisateur auquel se rapporte l'exécution
Q	User Id	Identifiant de l'utilisateur
R	User name	Prénom et nom de l'utilisateur Note : Les informations sont concaténées.
S	Groups	Groupes auxquels appartient l'utilisateur Note : Renseignez les groupes sous la forme [GRP1, GRP2, ...].
Colonnes T à W : Informations de temps
T ; U	Execution start time ; Execution stop time	Heure de début / fin de l'exécution
V ; W	Page enter time ; Page leave time	Heure de début / fin de l'affichage de l'étape visible
Colonnes X à AC
X	Post-Its	Nombre de commentaires apportés par les utilisateurs sur l'étape visible
Y	End Type	Information sur le type de sortie de l'exécution : Closed : la procédure a été fermée brusquement (ex. : fermeture du navigateur) Ended : la procédure a été suivie normalement jusqu'à la fin (étape Stop) Exited : l'utilisateur est sorti de la procédure en revenant au portail ou en utilisant le fil d'Ariane Pausedeleted : la procédure a été fermée volontairement alors qu'elle était en pause Sessionclosed : la session a été fermée volontairement alors que des procédures étaient en cours (les procédures sont alors mises sur pause et fermées 24 heures plus tard)
Z	SearchUid	Identifiant de la recherche utilisateur ayant éventuellement entraînée l'exécution Note : Permet de faire le lien avec la feuille searchEngine.
AA	Feedback	Réponse à l'enquête de satisfaction : Vide : aucune réponse Non vide : réponse correspondant à la valeur du champ du formulaire (en général 0 ou 1)
AB	Channel	Mode de visualisation de la procédure : PORTAL : procédure visualisée dans le portail APICONTENT : procédure appelée via l'API Contenu MSTEAMS : procédure visualisée via MS Teams SERVICEBOTS : procédure visualisée via un agent virtuel AUTOMATIC : procédure visualisée via l'API Portail PREVIEW : procédure visualisée en mode Test DEBUG : procédure visualisée en mode Debug
AC	Agent	Référence de l'agent virtuel
Colonnes AD et suivantes : Autres informations
	Une colonne est créée pour chaque autre variable associée au profil d'extraction.

Feuille procedures

Cette feuille présente des informations sur les procédures des domaines et projets Self Help sélectionnés lors de la création du profil d'extraction.
Une ligne correspond à une étape (visible ou invisible) d'une version de procédure.

Statistics file - Procedures sheet.png

Colonne	Intitulé de la colonne	Description
Colonnes A à E : Informations sur le domaine et le projet Self Help auxquels se rapporte la procédure
A ; B	Domain ID ; Domain name	Identifiant / Titre du domaine
C à E	Project Id ; Project name ; Project version	Identifiant / Titre / Numéro de version du projet Self Help
Colonnes F à I : Informations sur la procédure
F	Published	État de publication de la procédure : VRAI : la procédure est publiée FAUX : la procédure n'est pas publiée
G à I	Procedure UID ; Procedure ID ; Procedure name	Identifiant unique / Identifiant / Titre de la procédure
Colonnes J à N : Informations sur la rédaction de la procédure
J	Creation date	Date de création de la procédure
K	Creation writer	Prénom et nom du rédacteur ayant créé la procédure Note : Les informations sont concaténées.
L	Modification date	Date de dernière modification de la procédure
M	Modification user	Prénom et nom du rédacteur ayant effectué la dernière modification de la procédure Note : Les informations sont concaténées.
N	Entry point	Indique si la procédure est un point d'entrée et est exécutable par les utilisateurs : VRAI : la procédure est exécutable FAUX : la procédure n'est pas exécutable
Colonnes O à Q : Informations sur l'étape
O ; P	Page ID ; Page name	Identifiant / Titre de l'étape
Q	Node type	Nature de l'étape : CALL : appel d'une sous-procédure. Dans ce cas, la valeur de la colonne P Page name est vide. SWITCH : étape Page de choix TASK : étape Page

Feuille folders

Cette feuille présente des informations sur les dossiers des domaines et projets Self Help sélectionnés lors de la création du profil d'extraction.
Ces informations sont indispensables pour mettre en relation les informations sur les exécutions et la rédaction avec les différentes catégories du projet Self Help.
Chaque ligne correspond à une version de procédure présente dans un dossier ou l'un de ses sous-dossiers.
Une procédure présente dans le sous-dossier Démarrage du dossier Windows apparaît 2 fois pour chaque version de projet Self Help. Ceci est nécessaire pour calculer des indicateurs avec des regroupements sur les catégories (dossiers de niveau 0) ou sous-catégories (dossiers de niveau 1), ...

Statistics file - Folders sheet.png

Colonne	Intitulé de la colonne	Description
Colonnes A et B : Informations sur les procédures présentes dans chaque dossier / sous-dossier
A ; B	Procedure UID ; Procedure ID	Identifiant unique / Identifiant de la procédure
Colonnes C à E : Informations sur le dossier / sous-dossier
C ; D	Folder ID ; Folder name	Identifiant / Titre du dossier
E	depth	Niveau de hiérarchisation du dossier 1 : dossier de premier niveau 2, 3, ... : sous-dossier de second niveau / troisième niveau / ...

Feuille concurrents

Cette feuille présente des informations sur la chronologie des accès.
Une ligne correspond à un événement (début ou fin d'une exécution).
Les informations sont utiles pour ajuster l'usage d'une licence ou pour tester la charge possible du serveur.

Statistics file - Concurrents sheet.png

Colonne	Intitulé de la colonne		Description
A	Date		Date de l'événement (début ou fin de l'exécution)
B	Count		Nombre de sessions ouvertes pour l'événement

Feuille searchEngine

Cette feuille présente des informations sur l'utilisation du moteur de recherche du portail client Self Help.
Une ligne correspond à une procédure remontée par le moteur de recherche.
Seules les 5 premières procédures remontées par une recherche entrainent la création d’une ligne.
exemple
- Une recherche fait remonter 3 procédures différentes dans les résultats ==> 3 lignes sont affichées dans la feuille Excel
- Une recherche fait remonter 10 procédures différentes dans les résultats ==> 5 lignes sont affichées dans la feuille Excel

Statistics file - Search engine sheet.png

Colonne	Intitulé de la colonne	Description
A	RecordID	Identifiant de l’enregistrement Note : Identique à la recherche.
B	SearchTimeMs	Temps nécessaire à la recherche
C	DisplayTimeMs	Temps nécessaire à l’affichage des résultats
D ; E	BestRank ; WorstRank	Rang donné par le moteur de recherche pour le meilleur / plus mauvais résultat remonté
F	VersionId	Identifiant du moteur de recherche
G ; H	UserId ; UserLogin	Identifiant / Login de l’utilisateur ayant effectué la recherche
I	Locale	Langue utilisée pour la recherche
J	Pattern	Saisie de l'utilisateur dans le moteur de recherche
K	DomainId	Identifiant du domaine
L	SearchUid	Identifiant unique de la recherche Note : Permet de rapprocher l'éventuelle recherche de l’exécution dans la feuille executions.
M	CreationDate	Date / heure à laquelle la recherche a été effectuée
N	CategoriesCount	Nombre de catégories différentes remontées par la recherche
O	SpellCheck	Termes recherchés après application des corrections orthographiques par le moteur de NLP Note : Le champ est vide si aucune correction n’est faite.
P	SearchEngineCountResult	Nombre de résultats trouvés via l’outil de recherche
Q	DecisionCountResult	Nombre de résultats retenus après analyse selon les critères de pertinence
R	ResultType	Type de résultat retourné : WELCOME : procédure d’accueil MISUNDERSTANDING : aucun résultat trouvé par l’agent virtuel REPHRASE : plusieurs résultats trouvés par l’agent virtuel BYE : procédure de fin d’exécution TAGSEARCH : recherche d’un tag IDSEARCH : exécution de procédure via son ID
S	Lemmas	Liste des lemmes ou termes retenus comme significatifs dans la requête de l’utilisateur
T	Channel	Mode de visualisation de la procédure : PORTAL : via le portail APICONTENT : via l'API Contenu MSTEAMS : via MS Teams SERVICEBOTS : via un agent virtuel AUTOMATIC : via l'API Portail PREVIEW : via le mode Test DEBUG : via le mode Debug
U	Agent	Référence de l'agent virtuel
V	ScenariosCount	Nombre de procédures différentes remontées par la recherche
W ; X	ScenarioUid ; ScenarioId	Identifiant unique / Identifiant (versionné) de la procédure remontée par le moteur de recherche
Y	ScenarioRank	Rang donné à la procédure remontée par le moteur de recherche

Feuille skipped

Cette feuille présente les enregistrements de la base de données non pris en compte lors de l'extraction.
Pour chaque enregistrement, un message d'erreur indique le problème.

Statistics file - Skipped sheet.png

Colonne	Intitulé de la colonne	Description
Colonnes A à K : Informations sur l'exécution, le projet Self Help et le domaine auxquels se rapporte l'enregistrement
A	Execution ID	Identifiant de l'exécution
B ; C	Entrypoint ID ; Entrypoint name	Identifiant / Titre du point d'entrée de l'exécution
D à F	Project Id ; Project name ; Project version	Identifiant / Titre / Numéro de version du projet Self Help
G	Published	État de publication de la procédure : VRAI : la procédure est publiée FAUX : la procédure n'est pas publiée
H ; I	Domain ID ; Domain name	Identifiant / Titre du domaine
Colonnes J et K : Informations sur l'enregistrement
J	Date	Date de création de l'enregistrement
K	Error message	Message d'erreur explicitant le problème

Tags :