DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions Télémétrie
  • Présentation
  • Créer une télémétrie personnalisée
  • Créer les capteurs de la télémétrie personnalisée et les widgets associés
  • Créer les capteurs de la télémétrie personnalisée
  • Créer les widgets associés aux capteurs sans catégorie
  • Créer les widgets associés aux capteurs avec catégorie
  • Placer dans le code les appels nécessaires à la gestion des capteurs
  • Déployer la télémétrie personnalisée
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Une télémétrie personnalisée permet de définir les éléments à prendre en compte dans la télémétrie. Ces éléments sont définis à l'aide de capteurs.
  • Ces capteurs sont définis sous l'éditeur de télémétrie.
  • La valeur des capteurs peut être modifiée dans le code de l'application grâce à plusieurs fonctions WLangage.
Les résultats de cette télémétrie personnalisée seront affichés dans des widgets spécifiques.
Pour utiliser des données personnalisées dans la télémétrie, il faut :
  • Créer une télémétrie personnalisée.
  • Créer les widgets affichés par la télémétrie.
  • Paramétrer les widgets en définissant les informations affichées à l'aide de capteurs.
  • Placer dans le code les appels nécessaires à la gestion des capteurs.
  • Déployer l'application et sa télémétrie personnalisée.
Créer une télémétrie personnalisée
Une télémétrie personnalisée peut être créée :
  • via le volet "Explorateur de projet" :
    1. Dans le volet "Explorateur de projet", sélectionnez le dossier "Télémétries personnalisées".
    2. Dans le menu contextuel du dossier (clic droit), sélectionnez l'option "Nouvelle télémétrie personnalisée".
    3. Le volet "Télémétrie personnalisée" apparaît dans le ruban de l'éditeur.
    4. Créez les différents capteurs et widgets correspondant à la télémétrie personnalisée.
    5. Enregistrez la télémétrie personnalisée (Ctrl + S ou parmi les boutons d'accès rapide).
  • via l'éditeur de télémétrie :
    1. Sous le volet "Télémétrie", dans le groupe "Télémétrie personnalisée", cliquez sur "Nouveau".
    2. Le volet "Télémétrie personnalisée" apparaît dans le ruban de l'éditeur.
    3. Créez les différents capteurs et widgets correspondant à la télémétrie personnalisée.
    4. Enregistrez la télémétrie personnalisée (Ctrl + S ou parmi les boutons d'accès rapide).
Créer les capteurs de la télémétrie personnalisée et les widgets associés

Créer les capteurs de la télémétrie personnalisée

Pour créer un capteur dans une télémétrie personnalisée :
  1. Sous le volet "Télémétrie personnalisée", dans le groupe "Capteurs", cliquez sur "Capteur".
  2. L'écran de paramétrage du capteur apparaît.
    Dans cet écran, indiquez :
    • Le type du capteur :
      • Point de passage : Ce type de capteur permet de compter les éléments pris en compte par la télémétrie. Par exemple, il est possible de compter le nombre de factures créées, le nombre de factures annulées, nombre d'utilisateurs ayant utilisé une fonctionnalité, ...
      • Mesure d'une valeur : Ce type de capteur permet de compter un élément. Par exemple, il est possible de compter le nombre de produits par facture, ...
      • Mesure du temps : Ce type de capteur permet de mesurer le temps d'une action. Par exemple, mesure du temps nécessaire à la préparation d'une commande.
    • Le mode d'agrégation utilisé par le capteur :
      • En fonction du temps uniquement : Les données seront regroupées uniquement en fonction du temps.
      • En fonction du temps et d'une catégorie : Les données seront regroupées en fonction du temps et de la catégorie spécifiée.
    • Le nom du capteur. Ce nom sera utilisé dans le code WLangage pour identifier le capteur.
    • Le code WLangage correspondant à l'appel du capteur est automatiquement généré. Ce code peut être copié pour être collé dans le code WLangage devant appeler le capteur.
  3. Validez. Le nouveau capteur apparaît dans le Widget "Liste des capteurs".

Créer les widgets associés aux capteurs sans catégorie

Si vous avez créé un capteur sans catégorie, plusieurs types de Widgets peuvent être créés pour afficher les données de ce type de capteur :
  • Widget de type Valeur :
    1. Sous le volet "Télémétrie personnalisée", dans le groupe "Widgets", cliquez sur "Valeurs".
    2. L'écran de paramétrage du widget apparaît :
      Cet écran permet de spécifier :
      • Le libellé du Widget.
      • Les informations à afficher :
        • Le nom du capteur à utiliser.
        • L'information à afficher : Nombre, Temps, Nombre de passages, Nombre d'utilisateurs, Pourcentage d'utilisateurs, ...
          L'information affichée est différente selon le type du capteur.
        • La légende
    3. Vous pouvez afficher plusieurs valeurs dans un même widget. Cliquez sur le bouton "+" pour ajouter une nouvelle valeur à afficher.
    4. Validez la fenêtre de paramétrage du widget.
  • Widget de type Graphe :
    1. Sous le volet "Télémétrie personnalisée", dans le groupe "Widgets", cliquez sur "Graphe".
    2. L'écran de paramétrage du widget apparaît :
      Cet écran permet de spécifier :
      • Le type de graphe à afficher : Histogramme, Histogramme empilé ou Courbe
      • Le libellé du Widget.
      • Les éléments à afficher :
        • Le nom du capteur à utiliser.
        • L'information à afficher : Nombre, Temps, Nombre de passages, Nombre d'utilisateurs, Pourcentage d'utilisateurs, ...
          L'information affichée est différente selon le type du capteur.
        • La légende
    3. Vous pouvez afficher plusieurs valeurs dans un même graphe. Cliquez sur le bouton "+" pour ajouter une nouvelle valeur à afficher.
    4. Validez la fenêtre de paramétrage du widget.

Créer les widgets associés aux capteurs avec catégorie

Si vous avez créé un capteur avec catégorie, plusieurs types de Widgets peuvent être créés pour afficher les données de ce type de capteur :
  • Widget de type Table :
    1. Sous le volet "Télémétrie personnalisée", dans le groupe "Widgets avec catégorie", cliquez sur "Table".
    2. L'écran de paramétrage du widget apparaît :
      Cet écran permet de spécifier :
      • Le libellé du Widget.
      • Le capteur à utiliser.
      • Les informations à afficher dans les différentes colonnes de la table :
        • la première colonne affiche la catégorie.
        • pour les autres colonnes, spécifiez le titre de la colonne et la valeur affichée.
  • Widget de type Temporel :
    1. Sous le volet "Télémétrie personnalisée", dans le groupe "Widget", cliquez sur "Temporel".
    2. L'écran de paramétrage du widget apparaît :
      Cet écran permet de spécifier :
      • Le libellé du Widget.
      • Le capteur à utiliser
      • Le type de graphe à afficher : Histogramme, Histogramme empilé ou Courbe
      • Les valeurs affichées par les axes du graphe.
  • Widget de type Répartition :
    1. Sous le volet "Télémétrie personnalisée", dans le groupe "Widget", cliquez sur "Répartition".
    2. L'écran de paramétrage du widget apparaît :
      Cet écran permet de spécifier :
      • Le libellé du Widget.
      • Le capteur à utiliser.
      • Le type de graphe à afficher : "Histogramme Valeur" ou "Camembert Valeur".
      • Les informations à afficher.
    3. Validez la fenêtre de paramétrage du widget.
Les différents Widgets créés peuvent être modifiés grâce à leur menu contextuel (bouton situé en bas à droite du Widget). Il est possible de :
  • Editer le Widget.
  • Dupliquer le Widget.
  • Supprimer le Widget.
Placer dans le code les appels nécessaires à la gestion des capteurs
Lors de la création du widget, un ou plusieurs capteurs ont été créés.
Pour enregistrer les données concernant ces capteurs, il est nécessaire de les gérer dans les traitements de l'application. Deux fonctions WLangage sont disponibles :
TélémétrieAjouteMesureAjoute une mesure pour un capteur de valeur ou de temps.
TélémétrieAjoutePassageSignale l'exécution du code au niveau d'un capteur de passage.
Par exemple :
  • Capteur de mesure :
    // Un capteur de valeur "NombreProduit" a été défini sous l'éditeur
    // A chaque validation d'une commande, le nombre de produits de la commande est ajouté
    TélémétrieAjouteMesure(NombreProduit, TableauProduit..Occurrence)
  • Capteur de passage :
    // Un capteur de passage "AnnulationCommande" a été défini dans l'éditeur.
    // A chaque annulation de commande, on enregistre l'utilisation de la fonctionnalité
    // par l'utilisateur
    TélémétrieAjoutePassage(AnnulationCommande)
Déployer la télémétrie personnalisée
Pour qu'une télémétrie personnalisée soit prise en compte, il est nécessaire de :
  1. Déployer la télémétrie personnalisée sur le serveur.
  2. Générer et déployer l'application contenant les appels aux différents capteurs.
Pour déployer la télémétrie personnalisée, cliquez sur l'option "Déployer" présente dans le volet "Télémétrie personnalisée".
Version minimum requise
  • Version 21
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 02/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale