Edit me

Hérite de WidgetBase.

Fonction

Rendu

Ce widget sert à lancer un plan d’analyse du module stat et afficher le résultat.

Utilisation

Exemple complexe

Dans l’exemple ci-dessous, on a :

  • Un bouton qui lance un évènement stat:exec186.
  • Un widget Stat qui peut être lu ainsi :
    • id_amap="186" : c’est le plan d’analyse n°186 du module de stats qui va être appelé
    • dataset_filter="filter" : on transmet aussi les données du dataset appelé filter comme paramètre (voir plus bas)
    • option_name="exec_event" value="stat:exec186" : on appelle le module de stats en réponse à l’évènement stat:exec186 donc, ici, lorsqu’on clique sur le bouton
    • option_name="update_disabled" value="true" : on ne souhaite pas lancer des appels au module de stats autrement qu’en cliquant sur le bouton
    • option_name="use_current_user" value="true" : on souhaite utiliser les droits de l’utilisateur courant pour obtenir les données (donc l’utilisateur courant est sur le même projet et a accès aux bonnes données), c’est une alternative à l’utilisation d’un compte de service
<form_row>
    <button action="stat:exec186" class="btn btn-primary" label="Plan d'analyse n° 186"/>
</form_row>

<stat id_amap="186" dataset_filter="filter">
 <option output="html" option_name="exec_event" value="stat:exec186"/>
 <option output="html" option_name="update_disabled" value="true"/>
 <option output="html" option_name="use_current_user" value="true" />
</stat>

Exemple simple

On aurait aussi pu se limiter à ceci si l’on ne souhaitait pas envoyer de paramètres et qu’on ne souhaite pas de boutons pour lancer les appels.

<stat id_amap="186" />

Le dataset_filter et l’envoi de paramètres

Si l’attribut dataset_filter est utilisé :

  • Voozanoo va trouver le dataset signalé et s’en servir pour envoyer des paramètres au module de stats
  • On peut ensuite les utiliser :
    1. Dans le script R pour les afficher ou s’en servir pour faire des traitements ou des filtres sur les données
    2. Dans les dataqueries qui servent de source de données au plan d’analyse (pour des conditions par exemple)

Ceci est souvent utilisé pour permettre à l’utilisateur de rendre ses analyses statistiques dynamiques : il fait des choix dans un court formulaire avant de lancer l’analyse.

Utilisation des paramètres dans les script R

Le code ci-dessous permet de récupérer les paramètres passés sous la forme d’une liste :

JSON$params

Utilisation des paramètres dans les dataqueries

L’exemple ci-dessous attend des paramètres username et date_max pour les utiliser comme conditions dans un dataquery qui sert de source de données. L’attribut optional='true' sert à ignorer ces conditions si les attributs ne sont pas transmis. Si l’attribut dataset_filter du widget Stat est utilisé, les paramètres que le dataset signalé contient seront transmis au dataquery automatiquement.

<dataquery id="user_dataquery" table_name="{pj}_user_data" varset_name="user" table_alias="u">
  
  <column_simple table_name="u" field_name="id_data"/>
  <column_simple table_name="u" field_name="username"/>
  <column_simple table_name="u" field_name="firstname"/>
  <column_simple table_name="u" field_name="lastname"/>
  <column_simple table_name="u" field_name="creation_date"/>
  
  <condition sql="{username} = {param_username}" optional="true">
    <field field_name="username" table_name="u" alias="username"/>
    <variable alias="param_username" default="NULL">
      <entry type="param" name="username"/>
    </variable>
  </condition>
  
  <condition sql="{creation_date} &lt; {param_date_max}" optional="true">
    <field field_name="creation_date" table_name="u" alias="creation_date"/>
    <variable alias="param_date_max" default="NULL">
      <entry type="param" name="date_max"/>
    </variable>
  </condition>
  
</dataquery>

Exemple illustré

exemple_illustré

Attributs

Les attributs nécessaires au bon fonctionnement du widget sont signalés par un astérisque.

Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetBase pour vérifier si d’autres attributs sont disponibles.

Options

Les options nécessaires au bon fonctionnement du widget sont signalées par un astérisque.

Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetBase pour vérifier si d’autres options sont disponibles.

use_current_user

Permet de garder le contexte de l’utilisateur courant lors de l’appel à statmodule. Cette option ne fonctionne que si l’application appelante est l’application contenant les données.

  • Version : >=2.26

  • Valeurs possibles : Boolean

<option output="html" option_name="use_current_user" value="false" />