DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions Télémétrie
  • 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
  • Installation de l'application
  • 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.
  2. Déployer l'application :
    • Installer 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.

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