2009-03-17 20:21:10 +01:00
|
|
|
<sect2 id="config-LSattribute">
|
|
|
|
<title>Configuration des attributs</title>
|
|
|
|
<para>Cette section décrit les options de configuration des attributs des
|
|
|
|
&LSobjects;. Les attributs sont définis dans le tableau associatif
|
|
|
|
<varname>attrs</varname> de la configuration des &LSobjects;. Dans ce tableau,
|
|
|
|
les clé les noms des attributs et les valeurs liés sont la configuration des
|
|
|
|
attributs.</para>
|
2020-08-26 17:06:24 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<warning><simpara>Contrairement à ce qui existe dans le standard LDAP, les
|
|
|
|
noms des attributs sont sensibles à la casse. Il faut que le nom des attributs
|
|
|
|
dans &LdapSaisie; soient scrupuleusement les mêmes que ceux retourné par
|
|
|
|
&netldap;</simpara></warning>
|
2020-08-26 17:06:24 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<programlisting linenumbering="unnumbered">
|
|
|
|
<citetitle>Structure</citetitle>...
|
|
|
|
<![CDATA['attrs' => array (
|
|
|
|
/* ----------- start -----------*/
|
|
|
|
'attr1' => array (
|
2009-04-07 17:29:10 +02:00
|
|
|
'label' => '[label de l'attr1',
|
2010-11-19 18:49:14 +01:00
|
|
|
'displayAttrName' => '[booleen]',
|
|
|
|
'help_info' => '[Message d'aide sur l'attribut attr1]',
|
2019-03-29 15:49:03 +01:00
|
|
|
'help_info_in_view' => '[booleen]',
|
2009-03-17 20:21:10 +01:00
|
|
|
'ldap_type' => 'ldaptype1',
|
|
|
|
'ldap_options' => array(
|
|
|
|
// Options LDAP liées au type LDAP de l'attribut
|
|
|
|
),
|
|
|
|
'html_type' => 'htmltype1',
|
|
|
|
'html_options' => array(
|
|
|
|
// Options HTML liées au type HTML de l'attribut
|
|
|
|
),
|
2014-10-15 10:58:20 +02:00
|
|
|
'no_value_label' => '[No set value label]',
|
2009-03-17 20:21:10 +01:00
|
|
|
'multiple' => 0,
|
|
|
|
'required' => 1,
|
2010-01-06 19:18:53 +01:00
|
|
|
'generate_function' => 'fonction1',
|
2009-12-31 17:26:06 +01:00
|
|
|
'generate_value_format' => '[LSformat]',
|
2010-01-06 19:18:53 +01:00
|
|
|
'default_value' => 'valeur1',
|
2009-03-17 20:21:10 +01:00
|
|
|
'check_data' => array (
|
|
|
|
// Régle de vérification syntaxique des données saisies
|
|
|
|
),
|
|
|
|
'validation' => array (
|
|
|
|
// Règle de vérification d'intégrité des données saisies
|
|
|
|
),
|
|
|
|
'rights' => array(
|
|
|
|
'LSprofile1' => 'droit1',
|
|
|
|
'LSprofile2' => 'droit2',
|
|
|
|
...
|
|
|
|
),
|
|
|
|
'view' => 1,
|
|
|
|
'form' => array (
|
|
|
|
'create' => 1,
|
|
|
|
'modify' => 0,
|
|
|
|
...
|
|
|
|
),
|
|
|
|
'dependAttrs' => array(
|
|
|
|
// Attributs en dépendance
|
|
|
|
),
|
2009-05-04 15:30:28 +02:00
|
|
|
'onDisplay' => 'fonction2'
|
2020-08-26 17:06:24 +02:00
|
|
|
|
2010-07-30 21:07:32 +02:00
|
|
|
'before_modify' => 'function1',
|
|
|
|
'after_modify' => 'function2'
|
2009-03-17 20:21:10 +01:00
|
|
|
),
|
|
|
|
/* ----------- end -----------*/
|
|
|
|
...
|
|
|
|
);]]>
|
|
|
|
...
|
2020-08-26 17:06:24 +02:00
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
<!-- Début Paramètres Configuration -->
|
2009-03-17 20:21:10 +01:00
|
|
|
<variablelist>
|
|
|
|
<title>Paramètres de configuration</title>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>label</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Le label de l'attribut.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2010-11-19 18:49:14 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>displayAttrName</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Booléen définissant si le nom de l'attribut doit être affiché en
|
|
|
|
préfixe du message d'aide (paramètre <parameter>help_info</parameter>).</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2009-03-17 20:21:10 +01:00
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>help_info</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Message d'aide qui sera affiché dans une bulle d'aide à côté du
|
|
|
|
nom de l'attribut dans les formulaires.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2019-03-29 15:49:03 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>help_info_in_view</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Booléen définissant si le message d'aide doit être affiché sur la vue
|
|
|
|
de visualisation de l'objet.</simpara>
|
|
|
|
<simpara>Valeurs possibles : <emphasis>0</emphasis> ou <emphasis>1</emphasis></simpara>
|
|
|
|
<simpara>Valeur par défaut : <emphasis>0</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>ldap_type</term>
|
|
|
|
<listitem>
|
2021-01-29 15:59:13 +01:00
|
|
|
<simpara>Le type LDAP de l'attribut (facultatif, par défaut: &LSattr_ldap_ascii;).
|
2009-03-17 20:21:10 +01:00
|
|
|
<link linkend='config-LSattr_ldap'>Voir la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>ldap_options</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif contenant les paramètres de configuration du
|
|
|
|
type LDAP de l'attribut.
|
|
|
|
<link linkend='config-LSattr_ldap'>Voir la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>html_type</term>
|
|
|
|
<listitem>
|
2021-01-29 15:59:13 +01:00
|
|
|
<simpara>Le type HTML de l'attribut (facultatif, par défaut: &LSattr_html_text;).
|
2009-03-17 20:21:10 +01:00
|
|
|
<link linkend='config-LSattr_html'>Voir la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>html_options</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif contenant les paramètres de configuration du
|
|
|
|
type HTML de l'attribut.
|
|
|
|
<link linkend='config-LSattr_html'>Voir la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2014-10-15 10:58:20 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>no_value_label</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Label affiché lorsque l'attribut n'a pas de valeur (facultatif).</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>multiple</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Booléen définissant si cet attribut peut stocker plusieurs valeurs.</simpara>
|
|
|
|
<simpara>Valeurs possibles : <emphasis>0</emphasis> ou <emphasis>1</emphasis></simpara>
|
|
|
|
<simpara>Valeur par défaut : <emphasis>0</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>required</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Booléen définissant si cet attribut doit obligatoirement être
|
|
|
|
défini.</simpara>
|
|
|
|
<simpara>Valeurs possibles : <emphasis>0</emphasis> ou <emphasis>1</emphasis></simpara>
|
|
|
|
<simpara>Valeur par défaut : <emphasis>0</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
2010-01-06 19:18:53 +01:00
|
|
|
<term>generate_function</term>
|
2009-03-17 20:21:10 +01:00
|
|
|
<listitem>
|
2010-01-06 19:18:53 +01:00
|
|
|
<simpara>Nom de la fonction permettant de générer la valeur de l'attribut.
|
2020-08-26 17:06:24 +02:00
|
|
|
Cette fonction sera éxecutée, en passant en premier paramètre, l'objet
|
2010-01-06 19:18:53 +01:00
|
|
|
&LSobject; courant.</simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-12-31 17:26:06 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>generate_value_format</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>&LSformat; permettant la génération de l'attribut.</simpara>
|
2010-01-06 19:18:53 +01:00
|
|
|
<note><simpara>Cette méthode de génération est utilisée uniquement si aucune fonction de génération
|
|
|
|
de la valeur n'est définie (paramètre <parameter>generate_function</parameter>).</simpara></note>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>default_value</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Valeur par défaut de l'attribut.</simpara>
|
2020-12-02 20:20:05 +01:00
|
|
|
<warning><simpara>Il doit s'agir de la valeur telque retournée par le formulaire web.
|
|
|
|
Ainsi, par exemple dans le cas d'un attribut booléen, les valeurs possibles sont <literal>yes</literal> ou
|
|
|
|
<literal>no</literal>.</simpara></warning>
|
2010-01-06 19:18:53 +01:00
|
|
|
<note><simpara>Cette valeur est également utilisée dans le cadre de la génération automatique
|
|
|
|
de la valeur de l'attribut si aucune autre méthode n'est disponible (via une fonction ou un &LSformat;).</simpara></note>
|
2009-12-31 17:26:06 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>check_data</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif contenant les règles de vérification syntaxique
|
|
|
|
des données de l'attribut.<link linkend='config-LSattribute-check-data'>Voir
|
|
|
|
la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>validation</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif contenant les règles de vérification d'intégrité
|
|
|
|
des données de l'attribut.<link linkend='config-LSattribute-validation'>Voir
|
|
|
|
la section concernée.</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>rights</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif dont les clés sont les noms des &LSprofiles; ayant
|
|
|
|
des droits sur cet attribut et les valeurs associées sont les droits
|
|
|
|
correspondants. La valeur des droits d'un &LSprofile; peut être
|
|
|
|
<literal>r</literal> pour le droit de lecture ou <literal>w</literal> pour
|
|
|
|
le droit de lecture-écriture. Par défaut, un &LSprofile; n'a aucun droit.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>view</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Booléen définissant si l'attribut est, ou non, affiché lors de la
|
|
|
|
visualisation des objets du type courant.</simpara>
|
|
|
|
<simpara>Valeurs possibles : <emphasis>0</emphasis> ou <emphasis>1</emphasis></simpara>
|
|
|
|
<simpara>Valeur par défaut : <emphasis>0</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>form</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif dont les clés sont les noms des &LSforms; et les
|
|
|
|
valeurs associées la définition de l'affichage dans ce &LSform;. Si cette
|
|
|
|
valeur vaut <emphasis>0</emphasis>, alors l'attribut sera lecture-seule et si
|
|
|
|
cette valeur vaut <emphasis>1</emphasis>, cet attribut sera affiché en
|
|
|
|
lecture-écriture.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>dependAttrs</term>
|
|
|
|
<listitem>
|
2020-08-26 17:06:24 +02:00
|
|
|
<simpara>Tableau associatif listant les attributs dépendants de celui-ci.
|
2009-03-17 20:21:10 +01:00
|
|
|
Les attributs listés ici seront regénérés lors de chaque modification
|
2021-05-04 18:56:24 +02:00
|
|
|
de l'attribut courant. Cette génération sera effectuée avec la fonction
|
2009-03-17 20:21:10 +01:00
|
|
|
définie dans le paramètre <varname>generate_function</varname> de
|
|
|
|
l'attribut.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-05-04 15:30:28 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>onDisplay</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Nom ou liste de nom des fonctions retournant les valeurs d'affichages
|
|
|
|
de l'attribut. Si c'est une liste, chacune des fonctions seront executée les
|
|
|
|
unes après les autres. Ces fonctions seront éxecutées, en passant en premier
|
|
|
|
paramètre, le tableau des valeurs de l'objet.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>before_modify</term>
|
|
|
|
<listitem>
|
2020-08-26 17:06:24 +02:00
|
|
|
<simpara>Chaîne de caractères (ou tableau de chaine de caractères) correspondant
|
|
|
|
au nom d'une ou plusieurs fonctions qui seront exécutées avant toutes modifications de
|
2009-03-17 20:21:10 +01:00
|
|
|
la valeur de l'attribut.<link linkend="config-LSattribute-triggers">Voir la
|
|
|
|
section concernée</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>after_modify</term>
|
|
|
|
<listitem>
|
2020-08-26 17:06:24 +02:00
|
|
|
<simpara>Chaîne de caractères (ou tableau de chaine de caractères) correspondant
|
|
|
|
au nom d'une ou plusieurs fonctions qui seront exécutées après toutes modifications de
|
2009-03-17 20:21:10 +01:00
|
|
|
la valeur de l'attribut.<link linkend="config-LSattribute-triggers">Voir la
|
|
|
|
section concernée</link></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2020-08-26 17:06:24 +02:00
|
|
|
</variablelist>
|
2009-03-17 20:21:10 +01:00
|
|
|
&conf-LSattribute-LSattr_ldap;
|
|
|
|
&conf-LSattribute-LSattr_html;
|
2020-08-26 17:06:24 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
&conf-LSattribute-check-data;
|
|
|
|
&conf-LSattribute-validation;
|
|
|
|
&conf-LSattribute-triggers;
|
2020-08-26 17:06:24 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
</sect2>
|