Studio Online de Self Help - Le menu Analytique


Ce menu regroupe des fonctions d'analyse et de suivi des projets Self Help sur une période donnée.

À partir de la génération de rapports statistiques, il permet, par exemple :

  • d'analyser finement certaines données, comme la fréquence d'utilisation des procédures, afin d’optimiser le fonctionnement du projet Self Help ;
  • d'analyser les recherches et réponses retournées, afin d’optimiser les mots-clés associés aux procédures et les suggestions de recherche proposées à l'utilisateur par l'agent virtuel.

Principes de fonctionnement

  • Les rapports statistiques sont générés à partir d'un ensemble de critères paramétrés dans des profils d’extraction. Ces profils permettent de :
    • définir le périmètre d'extraction des données de chaque rapport, via la sélection de domaines et projets Self Help (par défaut, tous les domaines et projets du serveur d'administration Self Help sont traités) ;
    • sélectionner le type de données à inclure dans le rapport : données d'exécution des procédures, historique des recherches, ....
  • L'extraction des données est réalisée en exécutant un profil d'extraction, de façon immédiate ou planifiée  - Open url.png voir Principes de planification
  • Des fichiers de statistiques sont générés sous la forme d'un classeur Excel. Ils peuvent envoyés par e-mail aux utilisateurs concernés et être incorporés dans un rapport au format Tableau.

Remarques

  • Les administrateurs serveurs ont accès uniquement aux données concernant les serveurs dont ils sont responsables.
  • Les administrateurs domaines ont accès uniquement aux données concernant leurs domaines Self Help.
  • Les rédacteurs ont accès uniquement aux données concernant les domaines Self Help sur lesquels ils disposent des droits en consultation.
  • Plusieurs profils d'extraction peuvent être paramétrés, chacun identifiant des critères différents.
  • Un lien de téléchargement des rapports statistiques est toujours présent dans l'e-mail adressé aux utlisateurs concernés.
    • L'utilisateur peut les télécharger via le Studio Online, sous réserve de disposer des droits en consultation sur les domaines analysés.
    • Le fichier Excel est automatiquement mis en pièce jointe de l'e-mail si sa taille est inférieure à 3 Mo. Cela permet à un utilisateur de pouvoir consulter les rapports s'il n'a pas les droits d'accès au Studio Online.
       

Quels sont les éléments pris en compte lors de l'exécution d'un profil d'extraction ?

  • Les exécutions de procédures réalisées en mode Test dans le Studio Desktop ne sont pas prises en compte dans les rapports statistiques.
  • Lorsque les éléments Historique de Recherches ou Exécutions sont sélectionnés, seules les procédures ayant été exécutées au moins une fois sont extraites avec les dossiers associés.
  • Lorsque l’élément Procédures est le seul élément sélectionné, toutes les procédures et tous les dossiers associés sont extraits.

Attention

Bonnes pratiques

  • Si vous souhaitez lancer régulièrement une extraction de données, planifiez le profil d'extraction correspondant  - Open url.png voir Procédure
  • Afin de ne pas ralentir les activités des utilisateurs sur le serveur Self Help, différez l'exécution immédiate des profils d'extraction lorsque le nombre de données à extraire est important. Les paramètres vous permettent de renseigner une date / heure de lancement pour décaler l'exécution.

Description des écrans

Sous-menu Extractions

Affiche la liste des rapports générés, avec le nom du profil d'extraction et la date d'extraction.
Note : Le nom du fichier reprend ces 2 informations.
         Analytics menu - Extraction.png

  • La liste peut être triée en cliquant sur l'entête de chaque colonne.
  • Le nombre de tâches en cours est affiché en haut de la liste.
  • Les rapports peuvent être regroupés selon un critère donné, en cliquant sur le lien dédié en haut de la liste.
  • Un filtre sur le nom des rapports peut être appliqué, en cliquant sur le lien dédié en haut de la liste.
  • Le détail d'un rapport est affiché en cliquant sur son nom.
    • Cliquez sur le lien Voir en regard du champ Nom du profil pour afficher le détail du profil d'extraction dans le sous-menu Profils d'extraction.
    • Cliquez sur le lien Voir en regard du champ Nom de la tâche pour afficher le détail de la tâche dans le sous-menu Planification.
               Analytics menu - Extraction - Details.png

Fonctions disponibles via la barre d'outils

  • Envoi d'un rapport par e-mail à un destinataire
  • Suppression d'un ou plusieurs rapports
  • Téléchargement d'un ou plusieurs rapports

Sous-menu Profils d'extraction

Affiche la liste des profils d'extraction. Chaque profil permet de définir les caractéristiques des rapports qu'il va générer : le périmètre d'extraction des données, la langue utilisée et le type de données à inclure.
        Analytics menu - Extraction profiles.png

  • La liste peut être triée en cliquant sur l'entête de chaque colonne.
  • Les profils d'extraction peuvent être regroupés selon un critère donné, en cliquant sur le lien dédié en haut de la liste.
  • Un filtre sur le nom des profils d'extraction peut être appliqué, en cliquant sur le lien dédié en haut de la liste.
  • Le détail d'un profil d'extraction est affiché en cliquant sur son nom.
            Analytics menu - Extraction profiles - Details.png

Fonctions disponibles via la barre d'outils

  • Création d'un nouveau profil d'extraction  - Open url.png voir Procédure
  • Suppression d'un ou plusieurs profils d'extraction : plus aucune extraction de données ne peut alors être réalisée à partir de ces profils.
    Notes :
    • Toutes les tâches associées à ces profils sont supprimées dans le sous-menu Planification.
    • Les rapports générés précédemment à partir de ces profils restent disponibles dans le sous-menu Extractions.
  • Exécution immédiate d'un profil d'extraction  - Open url.png voir Principes de planification et Procédure
    Note : L'extraction immédiate peut être différée en renseignant une date / heure de lancement.
  • Planification de l'exécution d'un profil d'extraction  - Open url.png voir Principes de planification et Procédure
    Note : La date de début de planification peut être redéfinie ultérieurement, via le sous-menu Planification.
  • Modification d'un profil d'extraction (domaines, projets Self Help, type de données à inclure, ...)
    Note : Les changements sont pris en compte pour les nouveaux rapports générés à partir du profil d'extraction.

Sous-menu Planification

Affiche la liste des tâches planifiées, avec le nom du profil d'extraction et la période d'extraction des données.
Note : Dès qu'une tâche planifiée est exécutée, elle apparaît dans le sous-menu Extractions. Le nom du fichier généré indique la date d'exécution.
        Analytics menu - Extraction scheduling.png

  • La liste peut être triée en cliquant sur l'entête de chaque colonne.
  • Les tâches peuvent être regroupées selon un critère donné, en cliquant sur le lien dédié en haut de la liste.
  • Un filtre sur le nom des tâches peut être appliqué, en cliquant sur le lien dédié en haut de la liste.
  • Le nom de la tâche indique sa fréquence et sa date de début d'exécution.

    exemple

    • MyProfile.Quotidien.now ==> tâche associée au profil d'extraction MyProfile, planifiée quotidiennement avec une première exécution immédiate
    • MyProfile.Hebdomadaire.2019-10-29 ==> tâche associée au profil d'extraction MyProfile, planifiée hebdomadairement avec une première exécution le 29.10.2019
  • Les tâches exécutées immédiatement sont identifiées avec le libellé immediate-exec.
  • Le détail d'une tâche est affichée en cliquant sur son nom.
    • Cliquez sur le lien Voir en regard du champ Nom du profil pour afficher le détail du profil d'extraction dans le sous-menu Profils d'extraction.
               Analytics menu - Extraction scheduling - Details.png

Fonctions disponibles via la barre d'outils

  • Replanification d'une tâche d'extraction
    Note : Seule la date de début de planification est réinitialisée. Les autres critères (fréquence d'exécution, envoi d'un e-mail) doivent être modifiés au niveau du profil d'extraction de la tâche (sous-menu Profils d'extraction > option Planification).
  • Suppression d'une ou plusieurs tâches d'extraction
    Note : Les rapports générés précédemment à partir d'une tâche d'extraction supprimée restent disponibles dans le sous-menu Extractions.

Sous-menu API Dashboard

Affiche la liste des exécutions de procédures réalisées depuis l’API Contenu.

Le sous-menu permet ainsi de connaître le nombre de fois où les procédures d’un projet Self Help ont été exécutées via l’API, selon l’environnement tiers qui les ont appelées.

  • Chaque ligne correspond à une procédure et à un environnement d’exécution donnés.

Principes de planification des profils d'extraction

Exécution immédiate

  • L'exécution immédiate est réalisée via le sous-menu Profils d'extraction > option Exécuter.
  • Elle donne lieu à une tâche unique visible dans le sous-menu Planification.
    • Son nom est composé du libellé immediate-exec et de la date d'exécution.

      exemple  immediate-exec.20191029_14:40:57 ==> rapport généré le 29.10.2019 à 14h40mn57sec

  • Dès que l'extraction des données est réalisée, le rapport généré est visible dans le sous-menu Extractions.
    • Le nom du fichier est composé du nom du profil d'extraction et de la date d'exécution.

      exemple  MyProfile.20191029_14:40:57 ==> rapport généré à partir du profil d'extraction MyProfile, et généré le 29.10.2019 à 14h40mn57sec

    • La tâche reste visible dans le menu Planification.

Planification

  • La planification est réalisée via le sous-menu Profils d'extraction > option Planifier.
  • Plusieurs planifications peuvent être paramétrées pour un même profil d'extraction, correspondant à des critères différents.
    • Chaque planification donne lieu à une tâche différente visible dans le sous-menu Planification.
    • Le nom de chaque tâche est composée du nom du profil d'extraction, de la fréquence d'exécution et de la date de début de planification.

      exemple

      • MyProfile.Quotidien.now ==> tâche associée au profil d'extraction MyProfile, planifiée quotidiennement avec une première exécution immédiate
      • MyProfile.Hebdomadaire.2019-10-29 ==> tâche associée au profil d'extraction MyProfile, planifiée hebdomadairement avec une première exécution le 29.10.2019
  • Dès qu'une tâche planifiée est exécutée, le rapport correspondant est visible dans le sous-menu Extractions.
    • Le nom du fichier est composé du nom du profil d'extraction et de la date de génération du rapport.

      exemple  MyProfile.20191029_13:50:43 ==> rapport généré à partir du profil d'extraction MyProfile, et généré le 29.10.2019 à 13h50mn43sec

    • La tâche planifiée reste visible dans le menu Planification.
  • La date de début de planification peut être redéfinie via le sous-menu Planification.

Procédures

Comment créer un profil d'extraction

Étape 1 : Création d'un nouveau profil d'extraction

1. Ouvrez le Studio Online.

2. Allez sur le menu Analytique > Profils d'extraction.

3. Cliquez sur + Nouveau profil.
La fenêtre de propriétés du profil est affichée.
         Analytics menu - Extraction profile creation.png

Étape 2 : Saisie des informations du nouveau profil d'extraction

1. Saisissez le nom du profil. Note : Le nom doit être unique.

2. Sélectionnez le format de génération des rapports.

3. Sélectionnez la langue d'édition des rapports.

4. Sélectionnez le format d’exécution, indiquant le niveau de granularité des résultats remontés.

  • Steps : Remonte un enregistrement à chaque étape visible parcourue par l’utilisateur.
  • Executions : Remonte un enregistrement à chaque exécution d’un point d’entrée par l’utilisateur.
  • Stepsdebug : Format réservé au Support pour le débogage, permettant de remonter des enregistrements supplémentaires.

5. Cochez les éléments à intégrer dans les rapports : informations sur les exécutions des procédures, l'historique des recherches, les sessions, les procédures.

  • Si vous cochez l'élément Historique de Recherches, les éléments Exécutions et Procédures sont automatiquement cochés. Vous ne pouvez pas les décocher.
  • Si vous cochez l'élément Exécutions, l’élément Procédures est automatiquement coché. Vous ne pouvez pas les décocher.

6. (optionnel) Sélectionnez les domaine et les projets Self Help sur lesquels les données doivent être filtrées, via Add icon.png puis Ajouter en regard de chaque liste.
Note : Par défaut, les données sont extraites pour tous les domaines et projets Self Help du serveur d'administration Self Help.

7. (optionnel) Indiquez les variables à extraire, via Add icon.png puis Ajouter.

8. Cliquez sur Sauvegarder.
Le profil d'extraction est créé.

Comment exécuter un profil d'extraction immédiatement

Étape 1 : Sélection du profil d'extraction

1. Ouvrez le Studio Online.

2. Allez sur le menu Analytique > Profils d'extraction.

3. Cochez le profil d'extraction à exécuter immédiatement.

Étape 2 : Exécution du profil d'extraction

1. Cliquez sur Exécuter.

2. Renseignez la période d'extraction des données.

3. (optionnel) Cochez la case Décaler l'exécution pour différer l'exécution du profil d'extraction à une date / heure précises.

4. (optionnel) Cochez la case Envoyer un e-mail après l'exécution pour envoyer le rapport généré par le profil d'exécution à un destinataire, puis renseignez l'e-mail à envoyer.
Un lien de téléchargement du fichier est inséré dans l'e-mail.

5. Cliquez sur Oui.

  • Le profil d'extraction est exécuté immédiatement ou en différé.
  • Le rapport généré est visible dans le sous-menu Extractions. Son nom indique l'heure de génération.

Comment planifier un profil d'extraction

Étape 1 : Sélection du profil d'extraction

1. Ouvrez le Studio Online.

2. Allez sur le menu Analytique > Profils d'extraction.

3. Cochez le profil d'extraction à planifier.

Étape 2 : Planification du profil d'extraction

1. Cliquez sur Planifier.

2. Donnez un nom à la nouvelle tâche planifiée.
Note : Le nom doit être unique. Par défaut, il est composé du nom du profil d'extraction, de la fréquence d'exécution et du libellé now.

exemple  MyProfile.Quotidien.now ; MyProfile.Hebdomadaire.now

2. Sélectionnez la fréquence d'exécution.

  • Options Quotidien, Hebdomadaire, Mensuel :
    • Renseignez la date de début de planification via le calendrier, ou manuellement au format JJ/MM/AAAA.
  • Option Personnalisé :
    • Renseignez la date de début de planification via le calendrier, ou manuellement au format JJ/MM/AAAA.
    • Indiquez l'heure de début et l'heure de fin souhaitées.

3. (optionnel) Cochez la case Envoyer un e-mail après l'exécution pour envoyer le rapport généré par le profil d'exécution à un destinataire, puis renseignez l'e-mail à envoyer.
Un lien de téléchargement du fichier est inséré dans l'e-mail.

4. Cliquez sur Planifier.

  • Une tâche associée au profil d'extraction planifié est affichée dans le sous-menu Planification
  • Son nom indique sa fréquence d'exécution et sa date de début de planification.

Comment générer le tableau de bord Modèle par défaut

  Open url.png voir Procédure

Tags:
Modifié par Utilisateur inconnu le 2021/10/25 14:25
Créé par Administrator XWiki le 2020/12/07 11:17

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021