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

Modifié le 08/08/2022 16:18

Les profils d’extraction permettent de générer des rapports statistiques à partir des projets Self Help.

Les données remontées du serveur sont sauvegardées dans un fichier Excel

Attention

  • N'ajoutez aucune ligne dans le fichier Excel. De même, ne supprimez aucune ligne.
  • Ne modifiez pas la ligne d'entête.

Glossaire

  • 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.

Caractéristiques du fichier Excel

  • Fichier au format .csv 
  • Le fichier se présente sous la forme d'un classeur Excel comportant 6 feuilles.
        Statistics file - Excel sheets.png

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 à Q : 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 Locale Langue des contenus
G à I Entrypoint UID ; Entypoint ID ; Entrypoint name Identifiant unique / Identifiant / Titre du point d'entrée de l'exécution
J à L Procedure UID ; Procedure ID ; Procedure name Identifiant unique / Identifiant (versionné) / Titre de la procédure
M à O Project Id ; Project name ; Project version Identifiant / Titre / Numéro de version du projet Self Help
P ; Q Domain ID ; Domain name Identifiant / Titre du domaine

Colonnes R à T : Informations sur l'utilisateur auquel se rapporte l'exécution

R User Id Identifiant de l'utilisateur
S User name Prénom et nom de l'utilisateur

Note : Les informations sont concaténées.

T Groups Groupes auxquels appartient l'utilisateur

Note : Renseignez les groupes sous la forme [GRP1, GRP2, ...].

Colonnes U à Y : Informations sur la session

U Session ID ID de la session de l'utilisateur connecté
V ; W Execution start time ; Execution stop time Heure de début / fin de l'exécution
X ; Y Page enter time ; Page leave time Heure de début / fin de l'affichage de l'étape visible

Colonnes Z à AE

Z Post-Its Nombre de commentaires apportés par les utilisateurs sur l'étape visible
AA 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)
AB SearchUid Identifiant de la recherche utilisateur ayant éventuellement entraînée l'exécution

Note : Permet de faire le lien avec la feuille searchEngine.

AC 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)
AD 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
AE Agent Référence de l'agent virtuel

Colonnes AF 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 ID ; Procedure UID Identifiant / Identifiant unique 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 Session ID ID de la session de l'utilisateur connecté
J Locale Langue utilisée pour la recherche
k Pattern Saisie de l'utilisateur dans le moteur de recherche
L DomainId Identifiant du domaine
M SearchUid Identifiant unique de la recherche

Note : Permet de rapprocher l'éventuelle recherche de l’exécution dans la feuille executions.

N CreationDate Date / heure à laquelle la recherche a été effectuée
O CategoriesCount Nombre de catégories différentes remontées par la recherche
P 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.

Q SearchEngineCountResult Nombre de résultats trouvés via l’outil de recherche
R DecisionCountResult Nombre de résultats retenus après analyse selon les critères de pertinence
S 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
T Lemmas Liste des lemmes ou termes retenus comme significatifs dans la requête de l’utilisateur
U 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
V Agent Référence de l'agent virtuel
W ScenariosCount Nombre de procédures différentes remontées par la recherche
X ; Y ScenarioUid ; ScenarioId Identifiant unique / Identifiant (versionné) de la procédure remontée par le moteur de recherche
Z 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 :
Powered by XWiki © EasyVista 2022