Fonctions communes:API - SELECT - GRID CONFIG : Différence entre versions

De Logilys
Aller à : navigation, rechercher
(Informations retournées)
 
(14 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Entete_TOC}}
 
{{Entete_TOC}}
== Récupération de la configuration d'une grille  ==
+
== Récupérer la configuration d'une grille  ==
 
Cette opération permet de récupérer la liste des vues, des filtres et des boutons de filtre rapide pour une grille précise.
 
Cette opération permet de récupérer la liste des vues, des filtres et des boutons de filtre rapide pour une grille précise.
 
<br><br>
 
<br><br>
Ligne 8 : Ligne 8 :
 
* GridCode : Code pour identifier la grille. Voir la [[Fonctions_communes:API_-_GridCode|liste des codes de grille]]
 
* GridCode : Code pour identifier la grille. Voir la [[Fonctions_communes:API_-_GridCode|liste des codes de grille]]
 
* 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.
* LngUID : Langue d'affichage (0 = Français, 1 = Anglais)
+
* SearchValue : Filtre de la barre de recherche. Pour chercher le texte « abc » sur toutes les colonnes, il faut inscrire ceci <Search Field="" Value="abc">. Pour chercher sur une colonne en particulier, il faut documenter l'attribut Field avec le nom du champ sur lequel on souhaite chercher. Il est aussi possible de chercher sur plusieurs champs à la fois en ajoutant plusieurs node <Search>. Il n'est pas possible de combiner la recherche sur toutes les colonnes et sur des colonnes en particulier.
<br><br>
+
* RangeStart : Indique la plage d'élément à sélectionner. Par exemple, pour retourner uniquement les 25 premières lignes, saisir 1.
Informations retournées :
+
* RangeEnd : Indique la plage d'élément à sélectionner. Par exemple, pour retourner uniquement les 25 premières lignes, saisir 25.
 +
* Params : XML contenant une liste de paramètres nécessaire pour l'exécution de la requête. (Ex: <Param Name="CliNo" Value="123">)
 +
 
 +
== Informations retournées ==
 
<pre>
 
<pre>
 
{   
 
{   
 +
  "Options":[
 +
    {
 +
      "ShowView":"1",
 +
      "ShowFilter":"1",
 +
      "ShowSearchBar":"1",
 +
      "ShowFooter":"1"
 +
    }
 +
  ],
 
   "View":[   
 
   "View":[   
 
     {   
 
     {   
 
       "ViewUID":"382",
 
       "ViewUID":"382",
 
       "ViewName":"Ma vue",
 
       "ViewName":"Ma vue",
 +
      "ViewDesc":"[«Cie?» est \"vrai\"]",
 
       "ViewSelected":"1"
 
       "ViewSelected":"1"
 
     },
 
     },
Ligne 22 : Ligne 34 :
 
       "ViewUID":"5468",
 
       "ViewUID":"5468",
 
       "ViewName":"Multi-trans",
 
       "ViewName":"Multi-trans",
 +
      "ViewDesc":"",
 
       "ViewSelected":"0"
 
       "ViewSelected":"0"
 
     },
 
     },
Ligne 27 : Ligne 40 :
 
       "ViewUID":"4253",
 
       "ViewUID":"4253",
 
       "ViewName":"Pr\u00E9nom / Nom",
 
       "ViewName":"Pr\u00E9nom / Nom",
 +
      "ViewDesc":"",
 
       "ViewSelected":"0"
 
       "ViewSelected":"0"
 
     },
 
     },
Ligne 32 : Ligne 46 :
 
       "ViewUID":"5411",
 
       "ViewUID":"5411",
 
       "ViewName":"Toutes les colonnes de Pr\u00E9nom / Nom",
 
       "ViewName":"Toutes les colonnes de Pr\u00E9nom / Nom",
 +
      "ViewDesc":"",
 
       "ViewSelected":"0"
 
       "ViewSelected":"0"
 
     },
 
     },
Ligne 37 : Ligne 52 :
 
       "ViewUID":"5524",
 
       "ViewUID":"5524",
 
       "ViewName":"Vue largeurs colonnes",
 
       "ViewName":"Vue largeurs colonnes",
 +
      "ViewDesc":"",
 
       "ViewSelected":"0"
 
       "ViewSelected":"0"
 
     }
 
     }
Ligne 44 : Ligne 60 :
 
       "FilterUID":"372",
 
       "FilterUID":"372",
 
       "FilterName":"Clients anglophones",
 
       "FilterName":"Clients anglophones",
 +
      "FilterDesc":"[«Langue code» est égal à \"AN\"]",
 
       "FilterSelected":"0"
 
       "FilterSelected":"0"
 
     },
 
     },
Ligne 49 : Ligne 66 :
 
       "FilterUID":"374",
 
       "FilterUID":"374",
 
       "FilterName":"Clients avec le lien Conjoint/Conjointe",
 
       "FilterName":"Clients avec le lien Conjoint/Conjointe",
 +
      "FilterDesc":"",
 
       "FilterSelected":"0"
 
       "FilterSelected":"0"
 
     },
 
     },
Ligne 54 : Ligne 72 :
 
       "FilterUID":"375",
 
       "FilterUID":"375",
 
       "FilterName":"Clients avec le lien Employ\u00E9/Employeur",
 
       "FilterName":"Clients avec le lien Employ\u00E9/Employeur",
 +
      "FilterDesc":"",
 
       "FilterSelected":"0"
 
       "FilterSelected":"0"
 
     },
 
     },
Ligne 59 : Ligne 78 :
 
       "FilterUID":"376",
 
       "FilterUID":"376",
 
       "FilterName":"Clients francophones",
 
       "FilterName":"Clients francophones",
 +
      "FilterDesc":"[«Langue code» est égal à \"FR\"]",
 
       "FilterSelected":"0"
 
       "FilterSelected":"0"
 
     }
 
     }
Ligne 80 : Ligne 100 :
 
}
 
}
 
</pre>
 
</pre>
 +
'''Options''' : Options concernant la grille.
 +
* ShowView : À 0, la liste des vues est cachée.
 +
* ShowFilter : À 0, la liste des filtres sauvegardés est cachée.
 +
* ShowSearchBar : À 0, la barre de recherche est cachée.
 +
* ShowFooter : À 0, le pied de page affichant le nombre d'enregistrement est cachée.
 
'''View''' : Liste des vues pour cette grille et visibles par l'utilisateur.
 
'''View''' : Liste des vues pour cette grille et visibles par l'utilisateur.
 
* ViewUID : ID de la vue. Utilisé dans le [[Fonctions_communes:API_-_BROWSE_-_DATA|BROWSE_DATA]].
 
* ViewUID : ID de la vue. Utilisé dans le [[Fonctions_communes:API_-_BROWSE_-_DATA|BROWSE_DATA]].
 
* ViewName : Nom de la vue.
 
* ViewName : Nom de la vue.
 +
* ViewDesc : Description du filtre dans la vue.
 
* ViewSelected : Vue sélectionnée par défaut.
 
* ViewSelected : Vue sélectionnée par défaut.
 
'''Filter''' : Liste des filtres sauvegardés pour cette grille et visibles par l'utilisateur.
 
'''Filter''' : Liste des filtres sauvegardés pour cette grille et visibles par l'utilisateur.
 
* FilterUID : ID du filtre. Utilisé dans le [[Fonctions_communes:API_-_BROWSE_-_DATA|BROWSE_DATA]].
 
* FilterUID : ID du filtre. Utilisé dans le [[Fonctions_communes:API_-_BROWSE_-_DATA|BROWSE_DATA]].
 
* FilterName : Nom du filtre.
 
* FilterName : Nom du filtre.
 +
* FilterDesc : Description du filtre sauvegardé.
 
* FilterSelected : Filtre sauvegardé par défaut.
 
* FilterSelected : Filtre sauvegardé par défaut.
 
'''PushButton''' : Liste des boutons de filtre rapide.
 
'''PushButton''' : Liste des boutons de filtre rapide.
Ligne 94 : Ligne 121 :
 
* ButtonIndex : Ordre des boutons à l'intérieur d'un groupe.
 
* ButtonIndex : Ordre des boutons à l'intérieur d'un groupe.
 
* Down : 0 = Bouton inactif, 1 = Bouton actif
 
* Down : 0 = Bouton inactif, 1 = Bouton actif
 +
<br>
 +
Le SELECT / GRID_CONFIG lance automatiquement un [[Fonctions_communes:API_-_BROWSE_-_DATA|BROWSE / DATA]] pour la grille demandée avec la vue, le filtre et les boutons de filtre rapide par défaut.
 
{{BasPage_Fonctions_communes}}
 
{{BasPage_Fonctions_communes}}

Version actuelle datée du 6 mars 2019 à 12:07

API - SELECT - GRID CONFIG

Récupérer la configuration d'une grille

Cette opération permet de récupérer la liste des vues, des filtres et des boutons de filtre rapide pour une grille précise.

DemAction : SELECT
DemCat : GRID_CONFIG
DemOptions :

  • GridCode : Code pour identifier la grille. Voir la liste des codes de grille
  • NomSession : Même nom de session utilisé lors de l'envoi d'une requête sous forme de JSON.
  • SearchValue : Filtre de la barre de recherche. Pour chercher le texte « abc » sur toutes les colonnes, il faut inscrire ceci <Search Field="" Value="abc">. Pour chercher sur une colonne en particulier, il faut documenter l'attribut Field avec le nom du champ sur lequel on souhaite chercher. Il est aussi possible de chercher sur plusieurs champs à la fois en ajoutant plusieurs node <Search>. Il n'est pas possible de combiner la recherche sur toutes les colonnes et sur des colonnes en particulier.
  • RangeStart : Indique la plage d'élément à sélectionner. Par exemple, pour retourner uniquement les 25 premières lignes, saisir 1.
  • RangeEnd : Indique la plage d'élément à sélectionner. Par exemple, pour retourner uniquement les 25 premières lignes, saisir 25.
  • Params : XML contenant une liste de paramètres nécessaire pour l'exécution de la requête. (Ex: <Param Name="CliNo" Value="123">)

Informations retournées

{  
  "Options":[
    {
      "ShowView":"1",
      "ShowFilter":"1",
      "ShowSearchBar":"1",
      "ShowFooter":"1"
    }
  ],
  "View":[  
    {  
      "ViewUID":"382",
      "ViewName":"Ma vue",
      "ViewDesc":"[«Cie?» est \"vrai\"]",
      "ViewSelected":"1"
    },
    {  
      "ViewUID":"5468",
      "ViewName":"Multi-trans",
      "ViewDesc":"",
      "ViewSelected":"0"
    },
    {  
      "ViewUID":"4253",
      "ViewName":"Pr\u00E9nom / Nom",
      "ViewDesc":"",
      "ViewSelected":"0"
    },
    {  
      "ViewUID":"5411",
      "ViewName":"Toutes les colonnes de Pr\u00E9nom / Nom",
      "ViewDesc":"",
      "ViewSelected":"0"
    },
    {  
      "ViewUID":"5524",
      "ViewName":"Vue largeurs colonnes",
      "ViewDesc":"",
      "ViewSelected":"0"
    }
  ],
  "Filter":[  
    {  
      "FilterUID":"372",
      "FilterName":"Clients anglophones",
      "FilterDesc":"[«Langue code» est égal à \"AN\"]",
      "FilterSelected":"0"
    },
    {  
      "FilterUID":"374",
      "FilterName":"Clients avec le lien Conjoint/Conjointe",
      "FilterDesc":"",
      "FilterSelected":"0"
    },
    {  
      "FilterUID":"375",
      "FilterName":"Clients avec le lien Employ\u00E9/Employeur",
      "FilterDesc":"",
      "FilterSelected":"0"
    },
    {  
      "FilterUID":"376",
      "FilterName":"Clients francophones",
      "FilterDesc":"[«Langue code» est égal à \"FR\"]",
      "FilterSelected":"0"
    }
  ],
  "PushButton":[  
    {  
      "Name":"pbActif",
      "Label":"Actif",
      "GroupIndex":"1",
      "ButtonIndex":"1",
      "Down":"1"
    },
    {  
      "Name":"pbInactif",
      "Label":"Inactif",
      "GroupIndex":"1",
      "ButtonIndex":"2",
      "Down":"0"
    }
  ]
}

Options : Options concernant la grille.

  • ShowView : À 0, la liste des vues est cachée.
  • ShowFilter : À 0, la liste des filtres sauvegardés est cachée.
  • ShowSearchBar : À 0, la barre de recherche est cachée.
  • ShowFooter : À 0, le pied de page affichant le nombre d'enregistrement est cachée.

View : Liste des vues pour cette grille et visibles par l'utilisateur.

  • ViewUID : ID de la vue. Utilisé dans le BROWSE_DATA.
  • ViewName : Nom de la vue.
  • ViewDesc : Description du filtre dans la vue.
  • ViewSelected : Vue sélectionnée par défaut.

Filter : Liste des filtres sauvegardés pour cette grille et visibles par l'utilisateur.

  • FilterUID : ID du filtre. Utilisé dans le BROWSE_DATA.
  • FilterName : Nom du filtre.
  • FilterDesc : Description du filtre sauvegardé.
  • FilterSelected : Filtre sauvegardé par défaut.

PushButton : Liste des boutons de filtre rapide.

  • Name : Nom du bouton. Utilisé dans le BROWSE_DATA.
  • Label : Libellé affiché sur le bouton.
  • GroupIndex : ID du groupe. Les boutons d'un même groupe sont collés les uns sur les autres. Les différents groupes sont séparés par un espace.
  • ButtonIndex : Ordre des boutons à l'intérieur d'un groupe.
  • Down : 0 = Bouton inactif, 1 = Bouton actif


Le SELECT / GRID_CONFIG lance automatiquement un BROWSE / DATA pour la grille demandée avec la vue, le filtre et les boutons de filtre rapide par défaut.


Nom du document : Fonctions communes:API - SELECT - GRID CONFIG