Types de champs
Chaîne
Ce type de champ permet de saisir des chaines des caractères compris entre 1 et 255 caractères
Entier
Ce type de champ permet de collecter des entiers uniquement. La saisie se fait via un bouton + / -. Il n’est pas possible de saisir la valeur depuis le clavier
Entrepôt
Ce type de champ permet de sélectionner un entrepôt. Ce champ accepte des paramètres
Paramètres
Vous pouvez indiquer les paramètre suivants :
- status → indiquer 1 pour les entrepôts actif ou 0 pour les entrepôts fermés. Par défaut, et sans ce paramètre indiqué, seuls les entrepôts actifs sont sélectionnés
- selected → indique l’ID de l’entrepot à sélectionner par défaut
Indiquer un paramètre par ligne.
Le nom du paramètre est séparé de sa valeur par le signe =
Exemple :
selected=2
Fichier
Ce type de champ permet de joindre un ou plusieurs fichier au formulaire
Texte
Ce type de champ permet d’afficher une zone de texte qui accepte de grands textes
Numérique
Ce type de champ permet de collecter des valeurs numériques décimales. Il est possible de saisir une valeur directement via le clavier. Ce champ accepte des paramètres
Paramètres
Vous pouvez indiquer les paramètre suivants :
- max → indique la valeur maximale autorisée
- step → indique le pas utilisé pour chaque valeur. Un pas de 0.5 permet de saisir les valeur 0 / 0.5 / 1 / 1.5 / 2 etc…
- value → indique une valeur prédéfinie dans le champ. Cette valeur peut être modifiée par l’utilisateur qui utilise le formulaire
- readonly → indique si le champ doit être en lecture seule. Indiquer readonly=1 pour cela
- disabled → indique si le champ doit être désactivé. Indiquer disabled=1 pour cela. Les champs désactivés ne sont pas envoyés lors de la soumission du formulaire, contrairement aux champs readonly.
Indiquer un paramètre par ligne.
Le nom du paramètre est séparé de sa valeur par le signe =
Exemple :
max=10
step=0.5
value=5
Carte
Ce type de champ permet d’afficher une carte à l’aide d’open street map et permet à l’utilisateur de sélectionner une latitude et une longitude
Cases d’option
Commande
Date
Ce type de champ permet de collecter des dates
Date et heure
Ce type de champ permet de collecter des dates et une heure
Liste
Ce type de champ permet d’afficher une liste déroulante à choix unique.
Syntaxe
Indiquer un choix par ligne, sur le principe : valeur,Libellé
Vous pouvez utiliser des valeurs numériques ou des valeurs alphabétiques
Exemple :
choix1,Choix1
choix2,Choix2
choix3,Choix3
…
Liste issue d’un dictionnaire
Ce type de champ permet d’afficher sous forme de liste déroulante les données d’une table de la base de données. Ce champ accepte des paramètres et permet ainsi de faire par exemple des listes liées entre elle.
Syntaxe
Vous pouvez utiliser une syntaxe particulière pour charger d’autres tables que celles des dictionnaires. Indiquer en première ligne des paramètres du champ la table où récupérer les données, sans mettre le prefixe de tables de votre installation (llx_).
Vous pouvez indiquer
– en premier paramètre le champ rowid à utiliser
– en second paramètre (séparé par le signe : ) le champ à utiliser comme label
Indiquer un paramètre par ligne.
Le nom du paramètre est séparé de sa valeur par le signe =
Exemple :
resource:rowid:ref
Ou
c_size_clothes
active=1
show_color=1
Paramètres
Le paramètrage s’effectue de la même façon que pour les extrafields :
nom_de_la_table:rowid:libelle::filter
filter peut être une comparaison simple comme par exemple : fk_pays=1
c_forme_juridique:rowid:libelle::fk_pays=1 affichera uniquement les formes juridiques liées à la France
Vous pouvez indiquer les paramètre suivants :
- active → 1/0 affichera uniquement les valeurs actives de la table (si elle dispose d’un champ ‘active’, ce qui est le cas pour les dictionnaires
- color_only → 1 | n’affiche que les valeurs qui ont un champ ‘color’ rempli
- show_color → 1 | utilisera la couleur définie pour chaque champ en fond de choix, si la table utilisée dispose d’une champ ‘color’ rempli avec une valeur hexadécimal.
- autocomplete = x | le champ passera en liste déroulante avec autocompletion au delà de x. Sinon le champ sera présenté sous forme de cartes à sélectionner
Indiquer un paramètre par ligne.
Le nom du paramètre est séparé de sa valeur par le signe =
Exemple :
c_forme_juridique:rowid:libelle::fk_pays=1
active=1
show_color=1
Cases à cocher
Syntaxe
Indiquer un choix par ligne, sur le principe : valeur,Libellé
Vous pouvez utiliser des valeurs numériques ou des valeurs alphabétiques
Exemple :
choix1,Choix1
choix2,Choix2
choix3,Choix3
…
Signature
Ce type de champ permet d’afficher une zone de signature et d’enregistrer une image de la signature. Cette signature n’a pas de valeur probante et n’est pas certifiée. Elle est donc à réserver à un usage ou la valeur légale n’est pas exigée !
Société
Objets multiples
Ce type de champ permet d’afficher deux champs côte à côte.
Le premier champ est un champ de type select et peut accueillir des données issues de table de base de données.
Le second champ est un champ de type input type text
Paramètres
Vous pouvez indiquer les paramètre suivants :
- object=Dolresource:resource/class/dolresource.class.php:0:(fk_statut:=:0)
→ indiquer un chemin vers la classe à utiliser pour charger un objet dolibarr, comme vous le feriez pour le champ oject des extrafields. Il faut bien indiquer object= en début de ligne car il est possible de passer d’autres paramètres - autoscroll=.lead:2000
→ autoscroll permet de lancer un défilement vertical pour positionner la zone du formulaire à l’endroit voulu.
→ Vous pouvez indiquer l’élément à atteindre, ici la classe .lead
→ vous pouvez indiquer une durée en millisecondes après lequel le scroll se déclenche (pour laisser le temps à l’utilisateur de lire par exemple) - extrafield=resource:pointage_tp:1
→ extrafield permet de limiter la sélection de l’object par rapport à un extrafield
→ resource indique ici qu’il faut aller chercher dans la table llx_resource_extrafield
→ pointage_tp est le code de l’extrafield qu’on souhaite utiliser
→ 1 correspond à la valeur de l’extrafield désirée - usergroup=27
→ usergroup permet de limiter la sélection des utilisateurs par rapport à l’id d’un groupe. Evidemment, ce paramètre ne s’utilise que si vous avez en premier paramètre : object=User:user/class/user.class.php:0:(statut:=:1)
→ 27 indiquele rowid du groupe d’utilisateur à utiliser
Exemple :
object=User:user/class/user.class.php:0:(statut:=:1)
autoscroll=.lead:2000
usergroup=27
Affichera la liste des utilisateurs actifs et faisant partie du groupe d’utilisateur n°27
Un défilement vertical vers le haut se déclenchera 2 secondes après l’affichage de la page, jusque l’élément .lead (qui correspond à l’aide du champ dans le thème de base)
Projet
Utilisateur
Le champ de type utilisateur permet de sélectionner un ou plusieurs utilisateur de dolibarr. Ce champ accepte plusieurs paramètres
Paramètres
Vous pouvez indiquer les paramètre suivants :
- enableonly → contient un tableau avec la liste des id utilisateurs à utiliser. Les autres utilisateurs seront visibles dans la liste mais désactivés
- include → contient un tableau avec la liste des id utilisateurs à utiliser. vous pouvez également indiquer ‘hiérarchie’ pour n’avoir que des utilisateurs supervisés ou ‘hiérarchieme’ pour avoir supervisé + moi.
- selected → selectionne l’utilisateur courant par défaut. Pour cela indiquer -3 pour ce paramètre. Attention, si le paramètre include est passé et que l’utilisateur courant ne fait pas partie des utilisateus inclus, la sélection par défaut ne sera pas effetctive
Indiquer un paramètre par ligne. Le nom du paramètre est séparé de sa valeur par le signe =.
Exemple :
enableonly=array(1,2,5,10)
selected=5
Tâche
Produit
Le champ de type produit permet de rechercher un produit déjà existant dans le catalogue produit de dolibarr. Ce champ accepte plusieurs paramètres
Paramètres
Vous pouvez indiquer les paramètre suivants :
- filtertype où 0 restreint aux produits, 1 restreint aux services
- filterkey qui recherchera dans la référence et dans le libellé du produit ce que vous aurez indiqué comme valeur
Indiquer un paramètre par ligne. Le nom du paramètre est séparé de sa valeur par le signe =.
Exemple : filtertype=0
N° de Siret
Le champ de type numéro de siret interroge la base de données annuaire -entreprise.gouv.fr et récupère les informations publiques disponibles pour cette entreprise.
Les données récupérées peuvent servir à remplir d’autres champs du questionnaire en utilisant dans les champs de formulaire suivants en utilisant ‘valeurs déduites’.
