Fonctions communes:API - RESULT - WIDGET : Différence entre versions

De Logilys
Aller à : navigation, rechercher
(Informations retournées)
 
(12 révisions intermédiaires par le même utilisateur non affichées)
Ligne 3 : Ligne 3 :
 
Retourne les informations nécessaire à l'affichage du widget.<br><br>DemAction : RESULT<br>DemCat : WIDGET<br>DemOptions :
 
Retourne les informations nécessaire à l'affichage du widget.<br><br>DemAction : RESULT<br>DemCat : WIDGET<br>DemOptions :
 
* NomSession : Même nom de session utilisé lors de l'envoi d'une requête sous forme de JSON.
 
* NomSession : Même nom de session utilisé lors de l'envoi d'une requête sous forme de JSON.
* OrgUID : Numéro de l'organisme auquel l'utilisateur accède en ce moment. Retourné par le [[Fonctions_communes:API_-_SELECT_-_LOGIN|SELECT / LOGIN]].
 
* LngUID : Langue d'affichage (0 = Français, 1 = Anglais)
 
 
* WidgetCode : Code du widget. Récupérer à partir de [[Fonctions_communes:API_-_LIST_-_WIDGET|LIST / WIDGET]].
 
* WidgetCode : Code du widget. Récupérer à partir de [[Fonctions_communes:API_-_LIST_-_WIDGET|LIST / WIDGET]].
 
* Params : XML listant les valeurs pour les différents paramètres. Le XML devra être formaté comme ceci :
 
* Params : XML listant les valeurs pour les différents paramètres. Le XML devra être formaté comme ceci :
 
<pre>
 
<pre>
<Param Name="OcaUID" Value="18">
+
<Param Name="OcaUID" Value="18" />
<Param Name="MinDate" Value="2017-01-01">
+
<Param Name="MinDate" Value="2017-01-01" />
<Param Name="MaxDate" Value="2017-12-31">
+
<Param Name="MaxDate" Value="2017-12-31" />
 
</pre>
 
</pre>
 
<br>
 
<br>
 +
 
== Informations retournées  ==
 
== Informations retournées  ==
 
Les informations retournées changeront d'un widget à l'autre. Voici un exemple pour le widget SOMTAC :
 
Les informations retournées changeront d'un widget à l'autre. Voici un exemple pour le widget SOMTAC :
 
<pre>
 
<pre>
 
{   
 
{   
   "Widget":[   
+
   "Column":[
 +
    {
 +
      "FieldName":"Label",
 +
      "TypeID":"2",
 +
      "SubTypeID":"",
 +
      "DisplayLabel":"Libellé",
 +
      "DisplayFormat":""
 +
    },
 +
    {
 +
      "FieldName":"Value",
 +
      "TypeID":"1",
 +
      "SubTypeID":"1",
 +
      "DisplayLabel":"Qté",
 +
      "DisplayFormat":"FQ"
 +
    },
 +
    {
 +
      "FieldName":"Color",
 +
      "TypeID":"2",
 +
      "SubTypeID":"",
 +
      "DisplayLabel":"Couleur",
 +
      "DisplayFormat":""
 +
    }
 +
  ],
 +
  "Data":[ 
 +
    {  
 +
      "Label":"En retard",
 +
      "Value":"10",
 +
      "Color":"FF0000"
 +
    },
 +
    { 
 +
      "Label":"Dans les délais",
 +
      "Value":"20",
 +
      "Color":"FFFF00"
 +
    },
 
     {   
 
     {   
       "Red":"10",
+
       "Label":"En avance",
       "Yellow":"2",
+
       "Value":"30",
       "Green":"5"
+
       "Color":"00FF00"
 +
    }
 +
  ],
 +
  Footer:[
 +
    {
 +
      "RecordCount":"3",
 +
      "Value_Aggregate":"SUM",
 +
      "Value_Value":"60"
 
     }
 
     }
 
   ]
 
   ]
 
}
 
}
 
</pre>
 
</pre>
'''Widget''' :  
+
'''Column''' : Donne les informations sur les colonnes retournées par la paire Data.
* Red : Nombre de tâches en retard.
+
* FieldName : Nom de la paire
* Yellow : Nombre de tâches dans les délais.
+
* TypeID : Numéro indiquant si la valeur est du texte, un nombre, une date, etc. (voir [[Fonctions_communes:API_-_CONFIG_-_WIDGET#TypeID|CONFIG / WIDGET]])
* Green : Nombre de tâches en avance.
+
* SubTypeID : Apporte une précision sur l'affichage pour les nombres et les dates. (voir [[Fonctions_communes:API_-_CONFIG_-_WIDGET#SubTypeID|CONFIG / WIDGET]])
 +
* DisplayLabel : Texte affiché pour ce champ
 +
* DisplayFormat : Format d'affichage de la date ou du nombre
 +
'''Data''' : Informations propres au widget
 +
* Label : Statut de la tâche
 +
* Value : Nombre de tâches avec ce statut
 +
* Color : Couleur pour le graphique
 +
'''Footer''' : Totaux
 +
* RecordCount : Nombre d'item dans Data.
 +
* Value_Aggregate : Fonction d'aggrégat appliquée sur la colonne Value.
 +
* Value_Value : Résultat de l'aggrégat pour la colonne Value.
 
<br><br>
 
<br><br>
 
{{BasPage_Fonctions_communes}}
 
{{BasPage_Fonctions_communes}}

Version actuelle datée du 18 mars 2020 à 15:39

API - RESULT - WIDGET


Informations envoyées

Retourne les informations nécessaire à l'affichage du widget.

DemAction : RESULT
DemCat : WIDGET
DemOptions :

  • NomSession : Même nom de session utilisé lors de l'envoi d'une requête sous forme de JSON.
  • WidgetCode : Code du widget. Récupérer à partir de LIST / WIDGET.
  • Params : XML listant les valeurs pour les différents paramètres. Le XML devra être formaté comme ceci :
<Param Name="OcaUID" Value="18" />
<Param Name="MinDate" Value="2017-01-01" />
<Param Name="MaxDate" Value="2017-12-31" />


Informations retournées

Les informations retournées changeront d'un widget à l'autre. Voici un exemple pour le widget SOMTAC :

{  
  "Column":[
    {
      "FieldName":"Label",
      "TypeID":"2",
      "SubTypeID":"",
      "DisplayLabel":"Libellé",
      "DisplayFormat":""
    },
    {
      "FieldName":"Value",
      "TypeID":"1",
      "SubTypeID":"1",
      "DisplayLabel":"Qté",
      "DisplayFormat":"FQ"
    },
    {
      "FieldName":"Color",
      "TypeID":"2",
      "SubTypeID":"",
      "DisplayLabel":"Couleur",
      "DisplayFormat":""
    }
  ],
  "Data":[  
    {  
      "Label":"En retard",
      "Value":"10",
      "Color":"FF0000"
    },
    {  
      "Label":"Dans les délais",
      "Value":"20",
      "Color":"FFFF00"
    },
    {  
      "Label":"En avance",
      "Value":"30",
      "Color":"00FF00"
    }
  ],
  Footer:[
    {
      "RecordCount":"3",
      "Value_Aggregate":"SUM",
      "Value_Value":"60"
    }
  ]
}

Column : Donne les informations sur les colonnes retournées par la paire Data.

  • FieldName : Nom de la paire
  • TypeID : Numéro indiquant si la valeur est du texte, un nombre, une date, etc. (voir CONFIG / WIDGET)
  • SubTypeID : Apporte une précision sur l'affichage pour les nombres et les dates. (voir CONFIG / WIDGET)
  • DisplayLabel : Texte affiché pour ce champ
  • DisplayFormat : Format d'affichage de la date ou du nombre

Data : Informations propres au widget

  • Label : Statut de la tâche
  • Value : Nombre de tâches avec ce statut
  • Color : Couleur pour le graphique

Footer : Totaux

  • RecordCount : Nombre d'item dans Data.
  • Value_Aggregate : Fonction d'aggrégat appliquée sur la colonne Value.
  • Value_Value : Résultat de l'aggrégat pour la colonne Value.




Nom du document : Fonctions communes:API - RESULT - WIDGET