Utilisation avancée (4)
Options dans les modèles de champs
Il faut intégrer le SMX : Langagev11.
Les options permettent de créer des modèles de champs qui ont un comportement identique à des modèles particuliers.
Par exemple, pour éviter de copier leur valeur pendant les transmissions ou les créer à partir de.
Les options sont à ajouter dans le champ Options, une par ligne. Elles sont de la forme :
<Nom option>
<Nom option> = <Valeur>
Sauf indication contraire, si la <Valeur> est omise alors elle est égale à 1 (ou Vrai).
Si l’option est gérée uniquement par le Client Windows alors la mention (Client Windows) est présente.
Important : pour certaines options les versions antérieures de SIMAX peuvent avoir un comportement inattendu.
Options pour Modèle classique
Voici les options pour les modèles classiques :
Code barre
CodeBarre : active la gestion code barre.
Apercu : active / désactive l'affichage de l'aperçu de code barre en mode fiche, si absent l'aperçu est actif à partir de la version 11. (Client Windows)
Image
Image : active la gestion du chemin de fichier vers une image.
Apercu : active / désactive l'affichage de l'aperçu en mode fiche. (Client Windows) ApercuListe : active / désactive l'affichage de l'aperçu en mode liste. (Client Windows)
Téléphone
NumeroTelephone : active la gestion du PABX / CTI. (Client Windows)
Fichier / répertoire
NomFichier : active la gestion de chemin de fichier.
Repertoire : active la gestion de chemin de répertoire (sans nom de fichier).
Correcteur Orthographique
VerifOrthographe : active / désactive le correcteur orthographique. (Client Windows)
Langue : spécifie la langue du correcteur orthographique, la <Valeur> est obligatoire et égale au choix : fr, en, es, de. (Client Windows)
Heure
AvecSeconde : active l'affichage des secondes.
Base de données
Index : active la gestion si possible d'un index.
Référence
Reference : action la gestion comme référence (identique au modèle prédéfini "référence").
Couleur
Couleur : active la gestion du nombre comme une couleur au format RVB.
Gantt
EtapeGantt : active la gestion comme un numéro d'étape Gantt. DureeGantt : action la gestion comme une durée Gantt.
Texte
Majuscule : la saisie est obligatoirement en majuscule. Minuscule : la saisie est obligatoirement en minuscule. Url : Le texte est une URL, active le bouton « voir ».
- Coloration
Pour les modèles classiques de type texte long, l'option Coloration permet de définir une coloration pour un format de texte spécifique.
Coloration = FORMULE ou XML ou HTML ou JAVASCRIPT ou JSON FORMULE est la mise en forme des formules SIMAX.
Par exemple pour HTML, au lieu d'afficher :
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC- html40/strict.dtd">
<html>
<head><meta name="qrichtext" content="1" />
<style type="text/css">
p, li { white-space: pre-wrap; }
</style></head>
<body style=" font-family:'Tahoma'; font-size:8pt; font-weight:400; font-style:normal;">
<p >Test</p>
</body>
</html> Cela affiche :
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC- html40/strict.dtd">
<html>
<head><meta name="qrichtext" content="1" />
<style type="text/css">
p, li { white-space: pre-wrap; }
</style></head>
<body style=" font-family:'Tahoma'; font-size:8pt; font-weight:400; font-style:normal;">
<p >Test</p>
</body>
</html>
Mot de passe
SaisieMotDePasse : gère la saisie en mode mot de passe (caché), la <Valeur> peut être :
0 : Affiche en clair
1 : Affiche un caractère générique (par défaut)
2 : Affiche brièvement le caractère saisi puis affiche un caractère générique
3 : N’affiche rien lors de la saisie
SymboleGroupement
Pour les modèles classiques de type Entier, Nombre à virgule et Monétaire, l'option SymboleGroupement permet de définir le symbole de groupe (ou de millier) à l'affichage :
SymboleGroupement : Caractère de séparation, peut être vide pour ne pas avoir de séparation
Options modèle classique pour réseaux sociaux
Pour les modèles classiques, de nouvelles options permettent de renseigner un compte d'un réseau social.
Dans un modèle classique de type texte, vous pouvez ajouter une des options afin de lier au réseau social correspondant:
FACEBOOK
TWITTER
LINKEDIN
INSTAGRAM
GOOGLEPLUS
YOUTUBE
WHATSAPP
Le bouton associé à la colonne permet l'ouverture du compte dans un navigateur.3.7.1.1.Nouvelles options pour les modèles classiques de type Texte Long (Multi ligne) NOMBRELIGNEVISIBLE=<nombre de lignes fixe affichées>
La colonne affichera toujours ce nombre de ligne NOMBRELIGNEVISIBLEMAX=<nombre de lignes maximums affichées>
La colonne affichera au maximum ce nombre de ligne (peux en afficher moins)
IMG_P00852
Options pour modèle classique HTML et URL
Options pour modèle classique de type HTML (cf NV18N000038 Type de donnée HTML) et modèle avec option URL (cf NV16N000037 Options dans les modèles de champs)
Option ZOOM
Permet de fixer le zoom initial:
Syntaxe :
ZOOM=<valeur % zoom>
où <valeur zoom> est le pourcentage d'affiche : 100 pour taille réelle. Exemples :
ZOOM=50
ZOOM=75.5
Option RAFRAICHIR
Permet de fixer l'intervalle de rafraîchissement automatique du HTML. Syntaxe :
RAFRAICHIR=<temps en seconde>
où <temps en seconde> est le nombre de seconde entre 2 rafraîchissements automatiques Exemple :
RAFRAICHIR=60
Utilisation :
Avec un html qui fait appel a un service en ligne (météo ?) permet de rafraîchir un tableau de bord
Option LISTEVALEUR dans modèle classique
L'option LISTEVALEUR permet de définir la liste des valeurs possibles pour la saisie dans une colonne. La colonne sera présentée comme une liste déroulante (combo).
Cela permet de limiter les valeurs que l'utilisateur peux saisir. L'objectif est d'améliorer l'expérience utilisateur.
Syntaxe, dans le champ Options du modèle classique :
LISTEVALEUR=<formule> ou
LISTEVALEUR=<chaîne au format csv>
La formule doit retourner soit un tableau de valeurs soit une chaîne au format csv.
Cela déterminera la liste de valeurs qui sera proposée dans la liste déroulante, l'ordre des valeurs sera conservé.
Si la formule utilise une ou plusieurs colonnes, la liste des valeurs sera évaluée à chaque modification de celles-ci.
Le format CSV attendu est :
point virgule (;) comme séparateur de valeur
retour chariot (RC) comme séparateur de ligne
guillemet (") comme délimiteur de chaîne
Si le tableau de valeurs a 2 dimensions alors la 1ère colonne est la valeur stockée, la 2ieme colonne est la valeur affichée. Cela permet de séparer la valeur de l'affichage.
1
Choisir 1
2
Choisir 2
3
Choisir 3
4
Choisir 4
Importants :
Les options dans les modèles ne doivent pas avoir de retour à la ligne.
La valeur affichée ne s'applique (pour l'instant) qu'en mode fiche, donc pas en mode liste ou si la colonne est reprise dans l'intitulé.
Attention au temps d'évaluation de la formule pour ne pas impacter les performances à l'ouverture, ou utilisez l'option LISTEVALEURDELAI.
Il n'y a pas de vérification de la valeur par rapport à cette liste lors de l'affectation par une opération sur colonne ou lors de la mise à jour par un calcul. (Comme les modèles éléments avec conditions)
Afin de simplifier la saisie et de tester la formule, il est conseillé de créer un calcul formule recalculé de test dans le formulaire, avec la formule à utiliser.
Si la valeur stockée n'est pas ou plus disponible dans la liste des valeurs alors elle n'est pas affichée, si elle est en modification l'enregistrement est modifié.
Exemples : (plusieurs possibilités d'initialisation sont possibles)
Avec un modèle de type entier, le nombre de la suite de Fibonacci
LISTEVALEUR=Tableau(0, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89)
Avec un modèle de type texte, les jours ouvrés de la semaine
LISTEVALEUR="Lundi";"Mardi";"Mercredi";"Jeudi";"Vendredi"
LISTEVALEUR=Tableau("Lundi", "Mardi", "Mercredi", "Jeudi", "Vendredi") Avec un modèle de type date, les jours ouvrés du mois courant
LISTEVALEUR=TableauDateOuvrée(DebutDeMois(), FinDeMois()) Avec un modèle de type date, les débuts de mois de l'année courante
LISTEVALEUR=TableauDateJourMois(DebutDAnnée(), FinDAnnée(), 1) Avec un modèle de type date, les fins de mois de l'année courante
LISTEVALEUR=TableauDateJourMois(DebutDAnnée(), FinDAnnée(), 31)
Avec un modèle de type entier, note sur 5 avec une valeur affichée de type "x/5"
LISTEVALEUR="1;""1/5"""+RC+"2;""2/5"""+RC+"3;""3/5"""+RC+"4;""4/5"""+RC+"5;""5/5"""
LISTEVALEUR=TransposeTableau(Tableau(Tableau(1, 2, 3, 4 ,5), Tableau("1/5", "2/5", "3/5", "4/5", "5/5")))
LISTEVALEUR=Tableau(Tableau(1, "1/5"), Tableau(2, "2/5"), Tableau(3, "3/5"), Tableau(4, "4/5"), Tableau(5, "5/5"))
Avec un modèle de type réel, taux de taxe
LISTEVALEUR=Tableau(Tableau(0.20, "20 %"), Tableau(0.10, "10 %"), Tableau(0.055, "5,5 %"), Tableau(0.021,
"2,1 %"), Tableau(0, "Exonéré"))
Avec un modèle de type entier, valeur entre une colonne minium et une colonne maximum
LISTEVALEUR=TableauNumérique([Colonne valeur min], [Colonne valeur max])
Avec un modèle de type entier, l'année de naissance (maximum 120 ans), à utiliser pour
LISTEVALEUR=TableauNumérique(Année(), Année()-120)
Avec un modèle de type texte, les code postaux d'une ville, ici il peut être bien d'utiliser LISTEVALEURDELAI
LISTEVALEUR=Tri(TableauJSON(HttpsGet("data.opendatasoft.com/api/records/1.0/search/", param : "dataset=laposte_hexasmal@datanova", param : "facet=code_postal", param : "refine.nom_de_la_commune="+Majuscule(RemplaceAccent([Colonne nom de ville]))), "/records/fields/code_postal"), 1)
Option LISTEVALEURDELAI dans modèle classique
L'option LISTEVALEURDELAI est à utiliser avec l'option LISTEVALEUR, elle permet de n'évaluer la formule de
LISTEVALEUR qu'à l'ouverture de la liste déroulante et non pas à chaque ouverture de la fiche. Syntaxe, dans le champ Options du modèle classique :
LISTEVALEURDELAI
ou
LISTEVALEURDELAI=< 0 ou 1 >
Important :
Comme la liste de valeur n'est disponible qu'à l'ouverture, la gestion des valeurs affichées et de la vérification de la valeur stockée est partielle.
Options pour Modèle fichier
Les options pour le modèle fichier sont les suivantes :
Image / Dessin (Client Windows) :
Editable : active l’édition de l'image. Largeur : largeur maximum en pixel. Hauteur : hauteur maximum en pixel.
Extension : extension de l'image générée, la <Valeur> est obligatoire au choix : PNG, JPG, GIF, BMP, TIF.
FiligraneTexte : Texte du filigrane automatiquement ajouté en fond du dessin. La <Valeur> est un texte quelconque ou une formule SIMAX.
FiligraneAngle : Angle en degré du filigrane. FiligraneCouleur : Couleur du filigrane.
Image : active la gestion du fichier vers une image.
Apercu
Apercu : active / désactive l'affichage de l'aperçu en fiche. (Client Windows) ApercuListe : active / désactive l'affichage de l'aperçu en mode liste. (Client Windows)
Image conversion
Convertit : conversion automatique de l'image avant stockage, la <Valeur> est obligatoire au choix: PNG, JPG, GIF, BMP, TIF.
Redimensionne : redimensionnement automatique de l'image avant stockage, la <Valeur> est obligatoire et de la forme <largeur>x<hauteur> en pixel.
Renommage
Renomme : active le renommage automatique avant stockage en combinant le préfixe / suffixe et identifiant de l'enregistrement.
Renomme_Prefixe : ajout préfixe au renommage automatique avant stockage, la <Valeur> est le préfixe.
Renomme_Suffixe : ajout suffixe au renommage automatique avant stockage, la <Valeur> est le sufixe.
NomFichier : renommage automatique du fichier avant stockage, la <Valeur> est la formule de renommage automatique.
FTP / Webdav / MySQL ...
Port : numéro du port pour le protocole.
Passif : active / désactive le mode passif pour le protocole FTP. Flags : flags pour le protocole.
Base : base de données pour le stockage MySQL, SQLite, ... ColonneID : nom de la colonne identifiant.
ColonneFichier : nom de la colonne de stockage du fichier.
Option modèle : renommage, conversion et redimensionnement pour les modèles de fichier FT (08.00.1340.02)
Uniquement pour les modèles fichier avec Type de stockage = Dossier windows
Dans le champs "options supplémentaires" vous pouvez ajouter les attributs suivants :
* Pour convertir l'image dans un autre type avant la copie dans le dossier windows CONVERTIT = (extension)
Les extensions disponibles sont : - jpg ou jpeg - bmp - png - gif - tiff
* Pour redimensionner l'image et qu'elle tienne dans un cadre de la dimension donnée avant la copie dans le
Dossier windows REDIMENSIONNE = (largeur) x (hauteur)
La largeur et la hauteur doivent être exprimées dans pixel La proportion de l'image est conservée, pas de déformation. Vous pouvez réduire ou agrandir l'image
Exemple :
Demander à ce que l'image soit convertit en GIF et tienne dans un cadre de 50 par 100
CONVERTIT = gif REDIMENSIONNE = 50 x 100
Options pour Modèle élément
Voici les options pour le modèle élément :
Base de données
Index : active la gestion si possible d'un index.
Ressource
RessourceReserve : active / désactive la réservation si l'élément lié est une ressource, par défaut la réservation est active en l'absence de cette option.
Lien
LienConteneur : force / désactive la colonne comme lien vers le conteneur.
Création
AvecCreation : autorise / interdit la création depuis la liste de suggestion d’une colonne élément.
Options pour Modèle liste d’élément
Voici les options pour le modèle liste d’élément :
Ressource
RessourceReserve : active / désactive la réservation si les éléments liés sont des ressources, par défaut la réservation est active en l'absence de cette option.
Lien
ListeGroupe : active le mode liste groupe (ajouter / enlever), évite la détection automatique du mode conteneur / contenu. Attention ne permet pas de désactiver le mode liste groupe.
Options modèle : liste déroulante
Pour qu'une colonne avec un modèle élément se comporte comme une liste déroulante : uniquement avec un bouton flèche vers le bas et pas les boutons rechercher, modifier, créer.
Dans la description du modèle élément, ajoutez dans la colonne Options : ListeDeroulante. Cela permet que les utilisateurs n’aient pas envie d'aller modifier, créer, supprimer, etc.
Remarque :
Le bouton favori et le bouton planning sont toujours affichés si pertinent.
Mis à jour