Telemetry: Configuring the WINDEV and WINDEV Mobile applications

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
Enabling the telemetry
Enabling the telemetry in the project description
Enabling the telemetry in the description of a configuration
Installing the application
Installing an application that support the telemetry

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Telemetry: Configuring the WINDEV and WINDEV Mobile applications

Overview

To use the telemetry in a WINDEV or WINDEV Mobile application, you must:

Enable the telemetry in the application. This activation can be done:
- Versions 22 and later
  in the project description. In this case, this activation is performed for all the existing project configurations.
  New in version 22
  in the project description. In this case, this activation is performed for all the existing project configurations.
  in the project description. In this case, this activation is performed for all the existing project configurations.
- in the platform description.
Deploy the application:
- Install the application.

Remark: The telemetry data is anonymous data by default. You have the ability to identify the user by using TelemetryIdentifyUser.

Versions 22 and later

The telemetry is now available in the applications in Universal Windows 10 App mode.

The telemetry is now available in the iPhone/iPad applications.

The telemetry is now available in the Android applications.

New in version 22

The telemetry is now available in the applications in Universal Windows 10 App mode.

The telemetry is now available in the iPhone/iPad applications.

The telemetry is now available in the Android applications.

The telemetry is now available in the applications in Universal Windows 10 App mode.

The telemetry is now available in the iPhone/iPad applications.

The telemetry is now available in the Android applications.

Enabling the telemetry

The telemetry can be enabled:

Versions 22 and later
in the project description. In this case, this activation is performed for all the existing project configurations.
New in version 22
in the project description. In this case, this activation is performed for all the existing project configurations.
in the project description. In this case, this activation is performed for all the existing project configurations.
in the platform description.

Versions 22 and later

Enabling the telemetry in the project description

To enable the telemetry in the project description:

Open the project description window: on the "Project" pane, in the "Project" group, click "Description".
In the window that is displayed, select the "Telemetry" tab.
Check "Enable the telemetry for the project" and specify the requested parameters:
- Server location:
  - Local, network or Internet network: In this case, you have the ability to specify the protocol used: HTPP or HTTPS.
    Remark: For an HTTPS protocol, a certificate must be installed on your Web server (IIS or Apache).
  - CLOUD platform. In this case, all you have to do is specify the CLOUD account to use.
    Remark: A Telemetry platform is required.
- Address:
  - Address of server or address of PCCloud platform.
  - User name and associated password. This data was given at the end of setup of telemetry server.
  Check the connection to the telemetry server to make sure that the data is correct.
- Telemetry of application:
  - Name of application. This name will be proposed in the telemetry dashboard.
  - The mode for triggering the collection of information. The data collection is automatically enabled by default but it can be enabled by programming with TelemetryEnable.
Validate.

These parameters are defined for the current project and for all its configurations. The telemetry can be customized or disabled for each project configuration.

New in version 22

Enabling the telemetry in the project description

To enable the telemetry in the project description:

Open the project description window: on the "Project" pane, in the "Project" group, click "Description".
In the window that is displayed, select the "Telemetry" tab.
Check "Enable the telemetry for the project" and specify the requested parameters:
- Server location:
  - Local, network or Internet network: In this case, you have the ability to specify the protocol used: HTPP or HTTPS.
    Remark: For an HTTPS protocol, a certificate must be installed on your Web server (IIS or Apache).
  - CLOUD platform. In this case, all you have to do is specify the CLOUD account to use.
    Remark: A Telemetry platform is required.
- Address:
  - Address of server or address of PCCloud platform.
  - User name and associated password. This data was given at the end of setup of telemetry server.
  Check the connection to the telemetry server to make sure that the data is correct.
- Telemetry of application:
  - Name of application. This name will be proposed in the telemetry dashboard.
  - The mode for triggering the collection of information. The data collection is automatically enabled by default but it can be enabled by programming with TelemetryEnable.
Validate.

These parameters are defined for the current project and for all its configurations. The telemetry can be customized or disabled for each project configuration.

Enabling the telemetry in the project description

To enable the telemetry in the project description:

Open the project description window: on the "Project" pane, in the "Project" group, click "Description".
In the window that is displayed, select the "Telemetry" tab.
Check "Enable the telemetry for the project" and specify the requested parameters:
- Server location:
  - Local, network or Internet network: In this case, you have the ability to specify the protocol used: HTPP or HTTPS.
    Remark: For an HTTPS protocol, a certificate must be installed on your Web server (IIS or Apache).
  - CLOUD platform. In this case, all you have to do is specify the CLOUD account to use.
    Remark: A Telemetry platform is required.
- Address:
  - Address of server or address of PCCloud platform.
  - User name and associated password. This data was given at the end of setup of telemetry server.
  Check the connection to the telemetry server to make sure that the data is correct.
- Telemetry of application:
  - Name of application. This name will be proposed in the telemetry dashboard.
  - The mode for triggering the collection of information. The data collection is automatically enabled by default but it can be enabled by programming with TelemetryEnable.
Validate.

These parameters are defined for the current project and for all its configurations. The telemetry can be customized or disabled for each project configuration.

Enabling the telemetry in the description of a configuration

To configure the telemetry for the current configuration:

On the "Project" pane, in the "Project configuration" group, click "Current configuration".
Select the "Telemetry" tab to configure the telemetry.
Versions 22 and later
Several options are available:
- Use the telemetry parameters of project: This option allows you to use the telemetry parameters specified in the project description.
  Caution: If the telemetry is not enabled in the project, the current configuration will not use the telemetry.
- Use specific telemetry parameters: This option is used to define specific telemetry parameters for the current configuration. You can for example disable the telemetry on the project and enable it on a configuration only. You also have the ability to use specific parameters for a type of configuration (for example, the Windows and mobile configurations do not use the same server).
- Disable the telemetry for this configuration: This option allows you to disable the telemetry for the current configuration.
New in version 22
Several options are available:
- Use the telemetry parameters of project: This option allows you to use the telemetry parameters specified in the project description.
  Caution: If the telemetry is not enabled in the project, the current configuration will not use the telemetry.
- Use specific telemetry parameters: This option is used to define specific telemetry parameters for the current configuration. You can for example disable the telemetry on the project and enable it on a configuration only. You also have the ability to use specific parameters for a type of configuration (for example, the Windows and mobile configurations do not use the same server).
- Disable the telemetry for this configuration: This option allows you to disable the telemetry for the current configuration.
Several options are available:
- Use the telemetry parameters of project: This option allows you to use the telemetry parameters specified in the project description.
  Caution: If the telemetry is not enabled in the project, the current configuration will not use the telemetry.
- Use specific telemetry parameters: This option is used to define specific telemetry parameters for the current configuration. You can for example disable the telemetry on the project and enable it on a configuration only. You also have the ability to use specific parameters for a type of configuration (for example, the Windows and mobile configurations do not use the same server).
- Disable the telemetry for this configuration: This option allows you to disable the telemetry for the current configuration.

Remark: If you select "Use specific telemetry parameters", all the telemetry parameters must be defined.

Specify the location of telemetry server:
- Local, network or Internet network: In this case, you have the ability to specify the protocol used: HTPP or HTTPS.
  Remark: For an HTTPS protocol, a certificate must be installed on your Web server (IIS or Apache).
- CLOUD platform. In this case, all you have to do is specify the CLOUD account to use.
Specify the address of the telemetry server to use:
- Server address,
- User name and associated password. This data was given at the end of setup of telemetry server.
Check the connection to the telemetry server to make sure that the data is correct.
The option "Telemetry of the application" is used to configure:
- The application name. This name will be proposed in the telemetry dashboard.
- The mode for triggering the collection of information. The data collection is automatically enabled by default but it can be enabled by programming with TelemetryEnable.

Installing the application

Installing an application that support the telemetry

The procedure for creating the setup of an application that supports the telemetry is identical to the procedure for creating a standard setup.

The telemetry is automatically enabled when starting the application (or via TelemetryEnable).

The telemetry data is sent whenever possible:

when the starting application,
when closing the application,
every hour,
when moving to the background.

Remarks:

In order for the telemetry data to be sent, a connection to the telemetry server is required.
Using the telemetry in the mobile application does not consume a lot of data.
The frequency for collecting information can be defined by TelemetryConfigure. Indeed, the default frequency of one hour can be reduced in a mobile application (a mobile application is often used for less than 1 hour and the collection frequency can be reduced to 5 minutes, for example).