Les paramètres permettent de configurer le fonctionnement du tenant et du serveur.
Il y a deux types de paramètres :
Les paramètres du serveur (TDOMPARAM) :
<aside> ⚠️
Attention - Il y a certains paramètres de domaine où même l’administrateur ne peut pas changer la valeur, il s’agit des paramètres système.
</aside>
Les paramètres fonctionnels (TGEDPARAM) :
La gestion de ces paramètres repose sur un principe de gestion de type SECTION et NAME (nom) pour mieux les catégoriser fonctionnellement de manière logique et pratique. Les sections permettent de regrouper les paramètres par emploi ou usage et les noms de les identifier formellement.
Ces règles sont communes aux deux types de paramètres (sauf mention contraire) :
Utilisés actuellement :
| Type | Valeur | Description |
|---|---|---|
| clParam_Alpha | 1 | Alpha numérique |
| clParam_Boolean | 2 | Booléen (Vrai ou faux) |
| clParam_Integer | 3 | Nombre entier |
| clParam_Float | 4 | Nombre décimal |
| clParam_Date | 5 | Date |
| clParam_DateTime | 6 | Date et heure |
| clParam_Choice | 7 | Liste de choix |
| clParam_Image | 8 | - Soit un BLOB contenant une image (la valeur correspond au nom de fichier source dans ce cas). |
| - Soit une représentation HTML d’une chaîne de couleur (le BLOB est vide dans ce cas). | ||
| clParam_idGroup | 9 | La valeur est de type entier et contient l’id d’un groupe geduser. |
| clParam_AlphaBlob | 10 | La valeur utile du paramètre doit être exploitée (et saisie) dans VALUEBLB (au lieu de VALUE traditionnellement). |
| clParam_BinaryBlob | 11 | Blob non éditable qui respecte l’encodage du flux binaire (exemple stockage des fichiers matrices ANSI Fr). |
<aside> ℹ️
Remarque - D’autres types de valeur pourront être ajoutés par la suite.
</aside>
Toutefois, afin que les applications clientes puissent exploiter ces valeurs correctement, les formats suivants doivent être respectés lors de l’enregistrement de ces valeurs :
| Type | Valeur | Description |
|---|---|---|
| clParam_Alpha | 1 | Aucun format. |
| clParam_Boolean | 2 | Un chiffre : 0 ou 1 |
| clParam_Integer | 3 | x chiffres (éventuellement préfixé du signe “-” si négatif) sans autre signe (ni ponctuation, ni espace, etc) |
| clParam_Float | 4 | x chiffres éventuellement préfixé du signe “-” si négatif) avec un séparateur décimal “.” (point) facultatif (aucun autre signe ne devrait être accepté) |
| clParam_Date | 5 | Une chaîne représentant une date au “format serveur d’application Visiativ Document” suivant : “YYYY-MM-DD” où toutes les positions doivent être remplies avec des chiffres ou des “-” |
| clParam_DateTime | 6 | Une chaîne représentant une date + heure au “format serveur d’application Visiativ Document” suivant : “YYYY-MM-DD HH:mm:SS” où toutes les positions doivent être remplies avec des chiffres ou des “-” ou un espace (séparateur date/heure) |
| clParam_Choice | 7 | - Aucun format (données hétérogènes). |
| - Les valeurs à présenter dans la liste doivent être saisies dans le BLOB (sous forme de liste dont les items sont séparés par des CR) | ||
| clParam_Image | 8 | - Si une image : aucun format (la valeur est stockée dans le BLOB correspondant) |
| - Si une chaîne de représentation de couleur HTML : format “#BB0E0E” par exemple | ||
| clParam_ValueBlob | 16 | Aucun format (la valeur est stockée dans le BLOB correspondant) |
Il appartient donc à l’application cliente d’administration de formater correctement ces valeurs avant de les soumettre au serveur d’application Visiativ Document. Ce dernier pourra rejeter ces valeurs s’il estime qu’elles ne correspondent pas à la forme/teneur attendue.
Lors de l’utilisation de ces paramètres, l’application cliente pourra décoder ces valeurs (en fonction de leur type, qu’elle devra connaître) et les présenter à l’utilisateur en fonction des formats définis ici.
Le champ PROTECTION présent dans les tables TDOMPARAM et TGEDPARAM peut prendre les trois valeurs suivantes :