ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Telemetry functions
  • Présentation
  • Activer la télémétrie
  • Activation de la télémétrie dans la description du projet
  • Activation de la télémétrie dans la description d'une configuration
  • Activation de la télémétrie lors de la création de l'exécutable
  • Installation de l'application
  • Installation d'une application gérant la télémétrie
  • Installation d'une application gérant la télémétrie
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
Pour utiliser la télémétrie dans une application WINDEV ou WINDEV Mobile, il est nécessaire de :
  1. Activer la télémétrie dans l'application. Cette activation peut être faite :
    • dans la description du projet. Dans ce cas, cette activation est réalisée pour toutes les configurations de projet existantes.
    • dans la description de la plateforme.
    • WINDEV lors de la création de l'exécutable.
  2. Déployer l'application :
Remarque : Par défaut, les données de la télémétrie sont anonymes. Il est possible d'identifier l'utilisateur en utilisant la fonction TélémétrieIdentifieUtilisateur.
Activer la télémétrie
L'activation de la télémétrie peut être réalisée :
  • dans la description du projet. Dans ce cas, cette activation est réalisée pour toutes les configurations de projet existantes.
  • dans la description de la plateforme.
  • WINDEV lors de la création de l'exécutable.

Activation de la télémétrie dans la description du projet

Pour activer la télémétrie dans la description du projet :
  1. Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans la fenêtre qui s'affiche, sélectionnez l'onglet "Télémétrie".
  3. Cochez l'option "Activez la télémétrie pour le projet" et renseignez les différents paramètres demandés :
    Description du projet, onglet
    • Localisation du serveur :
      • Serveur local, réseau ou Internet : Dans ce cas, vous pouvez préciser le protocole utilisé : HTPP ou HTTPS.
        Remarque : Dans le cas d'un protocole HTTPS, il est nécessaire d'installer un certificat sur votre serveur Web (IIS ou Apache).
      • Plateforme CLOUD. Dans ce cas, il suffit de préciser le compte CLOUD à utiliser.
        Remarque : Une plateforme de type Télémétrie est nécessaire.
    • Adresse : Testez la connexion au serveur de télémétrie pour vérifier que les données sont exactes.
    • Télémétrie de l'application :
      • Nom de l'application. Ce nom sera proposé dans le tableau de bord de la télémétrie.
      • Le mode de déclenchement de la collecte des informations. Par défaut, la collecte des données est activée automatiquement mais il est possible de l'activer par programmation grâce à la fonction TélémétrieActive.
  4. Validez.
Ces paramètres sont définis pour le projet en cours et toutes ses configurations. Il est possible au niveau de chaque configuration de projet de personnaliser ou de désactiver la télémétrie.

Activation de la télémétrie dans la description d'une configuration

Pour paramétrer la télémétrie pour la configuration courante :
  1. Sous le volet "Projet", dans le groupe "Configuration de projet", cliquez sur "Configuration courante".
  2. Sélectionnez l'onglet "Télémétrie" pour configurer la télémétrie.
  3. Différentes options sont disponibles :
    Options disponibles
    • Utiliser les paramètres de télémétrie du projet : Cette option permet d'utiliser les paramètres de télémétrie spécifiés dans la description du projet.
      Attention : Si la télémétrie n'est pas activée dans le projet, la configuration courante n'utilisera pas la télémétrie.
    • Utiliser des paramètres de télémétrie spécifiques : Cette option permet de définir des paramètres de télémétrie spécifiques pour la configuration en cours. Il est par exemple possible de ne pas activer la télémétrie sur le projet et de l'activer uniquement sur une configuration. Il est également possible d'utiliser des paramètres spécifiques pour un type de configuration (par exemple les configurations Windows et mobile n'utilisent pas le même serveur).
    • Désactiver la télémétrie pour cette configuration : Cette option permet de ne pas utiliser la télémétrie pour la configuration courante.
Remarque : Si vous sélectionnez l'option "Utiliser des paramètres de télémétrie spécifiques", il est nécessaire de définir tous les paramètres de la télémétrie.
Personnalisation des options de télémétrie
  1. Renseignez la localisation du serveur de télémétrie :
    • Serveur local, réseau ou Internet : Dans ce cas, vous pouvez préciser le protocole utilisé : HTPP ou HTTPS.
      Remarque : Dans le cas d'un protocole HTTPS, il est nécessaire d'installer un certificat sur votre serveur Web (IIS ou Apache).
    • Plateforme CLOUD. Dans ce cas, il suffit de préciser le compte CLOUD à utiliser.
  2. Renseignez l'adresse du serveur de télémétrie à utiliser :
  3. Testez la connexion au serveur de télémétrie pour vérifier que les données sont exactes.
  4. L'option "Télémétrie de l'application" permet de paramétrer :
    • Le nom de l'application. Ce nom sera proposé dans le tableau de bord de la télémétrie.
    • Le mode de déclenchement de la collecte des informations. Par défaut, la collecte des données est activée automatiquement mais il est possible de l'activer par programmation grâce à la fonction TélémétrieActive.
WINDEV

Activation de la télémétrie lors de la création de l'exécutable

Lors de la création d'un exécutable Windows, il est possible d'activer et de configurer la télémétrie.
Les différentes étapes sont les suivantes :
  1. Sélectionnez si nécessaire la configuration correspondant à l'exécutable.
  2. Créez l'exécutable : sous le volet "Projet", dans le groupe "Génération", cliquez sur "Générer".
  3. Dans les différentes étapes concernant la "Définition de l'EXE", l'étape "Télémétrie" permet de renseigner les options de la télémétrie.
  4. Plusieurs options sont disponibles :
    Création de l'exécutable : configuration de la télémétrie
    • Utiliser les paramètres de télémétrie du projet : Cette option permet d'utiliser les paramètres de télémétrie spécifiés dans la description du projet. Si la télémétrie n'est pas activée dans le projet, il n'est pas possible d'utiliser cette option.
      Création de l'exécutable : télémétrie indisponible dans le projet
    • Désactiver la télémétrie pour cette configuration : Cette option permet de ne pas utiliser la télémétrie pour la configuration liée à l'exécutable en cours de génération.
    • Utiliser des paramètres de télémétrie spécifiques : Cette option permet de définir des paramètres de télémétrie spécifiques pour la configuration liée à l'exécutable en cours de création. Lorsque cette option est sélectionnée, il est nécessaire de définir tous les paramètres de la télémétrie.
      Personnalisation des options de télémétrie
      1. Renseignez la localisation du serveur de télémétrie :
        • Serveur local, réseau ou Internet : Dans ce cas, vous pouvez préciser le protocole utilisé : HTPP ou HTTPS.
          Remarque : Dans le cas d'un protocole HTTPS, il est nécessaire d'installer un certificat sur votre serveur Web (IIS ou Apache).
        • Plateforme CLOUD. Dans ce cas, il suffit de préciser le compte CLOUD à utiliser.
      2. Renseignez l'adresse du serveur de télémétrie à utiliser :
      3. Testez la connexion au serveur de télémétrie pour vérifier que les données sont exactes.
Suivez les différentes étapes de l'assistant pour créer votre exécutable.
Remarque : Les données de télémétrie envoyées au serveur sont traitées toutes les deux heures. Elles ne seront donc pas visibles immédiatement dans le tableau de bord de la télémétrie.
Installation de l'application
WINDEV

Installation d'une application gérant la télémétrie

La procédure pour créer l'installation d'une application utilisant la télémétrie est identique à la procédure d'installation classique, avec une étape supplémentaire.
  1. Lancez la procédure d'installation de l'application : sous le volet "Projet", dans le groupe "Génération", cliquez sur "Procédure d'installation".
  2. Créez si nécessaire l'exécutable.
  3. Dans la partie gauche de l'assistant, sélectionnez "Gabarit de l'installeur".
  4. Suivez les différentes étapes jusqu'à l'étape "Activation de la télémétrie".
    Dans cet écran, il est possible de :
    • Afficher un message d'information à l'utilisateur pendant l'installation. Ce message d'information avertit l'utilisateur final de l'utilisation de la télémétrie sur son application.
      Remarque importante : Que ce message soit affiché ou non, la télémétrie sera activée dans l'application.
      Si la fonction TélémétrieIdentifieUtilisateur a été utilisée dans le code de l'application, le message proposé par défaut n'indique pas que les données transmises sont anonymes.
    • Autoriser l'utilisateur à désactiver la télémétrie lors de l'installation.
      Dans ce cas, l'utilisateur final peut cocher ou non l'option "J'accepte de participer à l'amélioration de XXXX". Si l'utilisateur final refuse, aucune donnée ne sera collectée.
      Remarque : Si l'option "Lors d'une mise à jour, la télémétrie sera automatiquement proposée à l'utilisateur même s'il l'a désactivée" est cochée, la question sera posée à l'utilisateur final à chaque nouvelle mise à jour.
La procédure de création d'installation est ensuite classique.
Rappel : Par défaut, le programme d'installation est fourni en Français et Anglais. Pour traduire le programme d'installation dans d'autres langues, il est nécessaire de créer un programme d'installation personnalisé.
Lorsque l'application est installée, les données sont envoyées régulièrement au serveur :
  • toutes les heures. Cette fréquence peut être modifiée grâce à la fonction TélémétrieParamètre.
  • à la fermeture de l'application.
WINDEV Mobile

Installation d'une application gérant la télémétrie

La procédure pour créer l'installation d'une application utilisant la télémétrie est identique à la procédure d'installation classique.
La télémétrie est automatiquement activée au lancement de l'application (ou via la fonction TélémétrieActive).
Les données de télémétrie sont envoyées dans la mesure du possible :
  • au lancement de l'application,
  • à la fermeture de l'application,
  • toutes les heures,
  • lors de la mise en arrière-plan.
Remarques :
  • Pour que les données de la télémétrie soient envoyées, une connexion au serveur de télémétrie doit être possible.
  • L'utilisation de la télémétrie dans l'application mobile consomme peu de données.
  • Il est possible de régler la fréquence de collecte des informations avec la fonction TélémétrieParamètre. En effet, la fréquence par défaut d'une heure peut être diminuée dans une application mobile (l'utilisation d'une application mobile est bien souvent inférieure à 1 heure et la fréquence de collecte peut par exemple être ramenée à 5 minutes).
  • Les événements spécifiques d'un service Windows ne collectent pas de données pour la télémétrie, et ne peuvent pas utiliser de fonctions de télémétrie.
Minimum version required
  • Version 21
Comments
Click [Add] to post a comment

Last update: 06/02/2023

Send a report | Local help