PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Creating a custom telemetry
  • Creating the custom telemetry
  • Creating the widgets of the custom telemetry and the associated sensors
  • Include in the code the calls required to manage the sensors
  • Deploying the custom telemetry
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
From WINDEV 21 Update 2, you have the ability to create custom telemetries.
A custom telemetry is used to define the elements that will be taken into account in the telemetry. These elements are defined via sensors.
  • These sensors are defined in the telemetry editor.
  • The value of sensors can be modified in the code of the application via several WLanguage functions.
The results of this custom telemetry will be displayed in specific widgets.
To use custom data in the telemetry, you must:
  • Create a custom telemetry.
  • Create the widgets displayed by the telemetry.
  • Configure the widgets by defining the displayed information via sensors.
  • Include in the code the calls required to manage the sensors.
  • Deploy the application and its custom telemetry.
Versions 22 and later
WINDEVWINDEV Mobile The telemetry is now available in:
  • the applications in Universal Windows 10 App mode.
  • the iPhone/iPad applications.
  • the Android applications.
New in version 22
WINDEVWINDEV Mobile The telemetry is now available in:
  • the applications in Universal Windows 10 App mode.
  • the iPhone/iPad applications.
  • the Android applications.
WINDEVWINDEV Mobile The telemetry is now available in:
  • the applications in Universal Windows 10 App mode.
  • the iPhone/iPad applications.
  • the Android applications.
Creating a custom telemetry

Creating the custom telemetry

A custom telemetry can be created:
  • via the project explorer:
    1. In the project explorer, select the "Custom telemetry" folder.
    2. In the popup menu of the folder (right mouse click), select "New custom telemetry".
    3. The "Custom telemetry" pane appears in the editor ribbon.
    4. Create the different widgets corresponding to the custom telemetry.
    5. Save the custom telemetry (CTRL S or among the quick access buttons).
  • via the telemetry editor:
    1. On the "Telemetry" pane, in the "Custom telemetry" group, click "New".
    2. The "Custom telemetry" pane appears in the editor ribbon.
    3. Create the different widgets corresponding to the custom telemetry.
    4. Save the custom telemetry (CTRL S or among the quick access buttons).

Creating the widgets of the custom telemetry and the associated sensors

To create a widget in a custom telemetry:
  1. On the "Custom telemetry" pane, in the "Creation" group, select the type of widget to create:
    • Values: Used to create a widget presenting the evolution of the sensor in table format.
    • Line: Used to create a line presenting the evolution of the sensor.
    • Column: Used to create a column chart presenting the evolution of the sensor.
  2. The screen for configuring the widget is displayed:
    This screen is used to specify:
    • The value to display: Number, Time, Number of passages, Number of users, Percentage of users.
      • Measurement sensors are used for the "Number" and "Time" values.
      • Passage sensors are used for the "Number of passages", "Number of users" and "Percentage of users" values.
    • The name of the sensor to use.
  3. Several values can be displayed in the same widget. Click the "+" button to add a new value to display.
  4. Validate the window for widget configuration.
  5. Modify the widget appearance if necessary:
    • Click its title to modify it.
    • For a chart widget, use the popup menu of the chart to modify its characteristics.
  6. Modify (if necessary) the size and organization of widgets:
    • Display the popup menu of custom telemetry (right mouse click).
    • Select "Modification mode".
    • Modify the size and position of widgets.
    • When all the modifications are performed, display the popup menu again and select "Modification mode".

Include in the code the calls required to manage the sensors

When creating the widget, one or more sensors have been created.
To save the data regarding these sensors, they must be managed in the application processes. Two WLangage functions are available:
Versions 21 and later
TelemetryAddMeasure
New in version 21
TelemetryAddMeasure
TelemetryAddMeasure
Adds a measure for a value sensor or for a time sensor.
Versions 21 and later
TelemetryAddPassage
New in version 21
TelemetryAddPassage
TelemetryAddPassage
Signals the code execution for a passage sensor.
For example:
  • Measurement sensor:
    // A "NumberProducts" sensor was defined in the editor
    // Whenever an order is validated, the number of products found in the order is added
    TelemetryAddMeasure(NumberProducts, ProductTable..Occurrence)
  • Passage sensor:
    // An "OrderCancelation" sensor was defined in the editor.
    // Whenever an order is canceled, we identify the use of the feature
    // by the user
    TelemetryAddPassage(OrderCancelation)

Deploying the custom telemetry

In order for a custom telemetry to be taken into account, you must:
  1. Deploy the custom telemetry on the server.
  2. Generate and deploy the application containing the calls to the different sensors.
To deploy the custom telemetry, click the "Deploy" option found in the "Custom telemetry" pane.
Minimum required version
  • Version 21
This page is also available for…
Comments
Click [Add] to post a comment