2009-03-17 20:21:10 +01:00
|
|
|
<sect2 id="config-LSobject-LSrelation">
|
|
|
|
<title>LSrelation</title>
|
|
|
|
<para>Cette section décrit la manière de configurer les relations entre les
|
|
|
|
&LSobjects; appelées &LSrelation;.</para>
|
2017-04-28 02:13:05 +02:00
|
|
|
<para>Dans le cadre d'une liaison dîte <emphasis>simple</emphasis>, c'est à
|
|
|
|
dire une liaison au travers la valeur d'un attribut qui fera directement
|
|
|
|
référence à un autre objet (<emphasis>DN</emphasis> ou la première valeur
|
|
|
|
d'un attribut de référence), pourra être configurée simplement en spécifiant
|
|
|
|
l'attribut de liaison et le type de valeur qu'il contient. Dans le cas d'une
|
|
|
|
liaison plus complexe, il sera possible de développer vous même des méthodes
|
|
|
|
de mise en relation.</para>
|
2021-06-21 12:31:49 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<programlisting>
|
|
|
|
<citetitle>Structure</citetitle>
|
|
|
|
<![CDATA[$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSrelation'] = array (
|
|
|
|
'relation1' => array(
|
2009-04-07 17:29:10 +02:00
|
|
|
'label' => '[label de la relation]',
|
2021-06-21 12:31:49 +02:00
|
|
|
'emptyText' => "[texte affiché si aucune relation avec d'autres objets
|
2009-04-07 17:29:10 +02:00
|
|
|
n'existe pour l'objet courant]",
|
2009-03-17 20:21:10 +01:00
|
|
|
'LSobject' => '[le type d'LSobjet en relation]',
|
2021-06-21 12:31:49 +02:00
|
|
|
'display_name_format' => '[LSformat du nom d'affichage des LSobjet en relation]',
|
2021-06-21 12:32:38 +02:00
|
|
|
'canEdit_attribute' => '[nom d'attribut]',
|
2017-04-28 02:13:05 +02:00
|
|
|
|
|
|
|
// Liaison simple
|
|
|
|
'linkAttribute' => '[attribut de liaison]',
|
2017-04-28 17:04:55 +02:00
|
|
|
'linkAttributeValue' => '[valeur de l'attribut de liaison]',
|
|
|
|
'linkAttributeOtherValues' => array('[autres valeurs possible de l'attribut de liaison]', [...]),
|
2017-04-28 02:13:05 +02:00
|
|
|
|
|
|
|
// Liaison complexe
|
2009-03-17 20:21:10 +01:00
|
|
|
'list_function' => '[méthode1]',
|
|
|
|
'getkeyvalue_function' => '[methode2]',
|
|
|
|
'update_function' => '[methode3]',
|
|
|
|
'remove_function' => '[methode4]',
|
|
|
|
'rename_function' => '[methode5]',
|
2009-11-11 21:02:00 +01:00
|
|
|
'canEdit_function' => '[methode6]',
|
2017-04-28 02:13:05 +02:00
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
'rights' => array(
|
|
|
|
'LSprofile1' => 'r',
|
|
|
|
'LSprofile2' => 'w',
|
|
|
|
...
|
|
|
|
)
|
|
|
|
)
|
|
|
|
);]]>
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
<title>Paramètres de configuration</title>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>label</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Le label de la relation.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>emptyText</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Le texte à afficher pour décrire le fait que l'objet courant n'a
|
|
|
|
aucune relation d'établie avec d'autres &LSobjects;. Exemple (au sujet d'un
|
|
|
|
utilisateur) : <emphasis>N'appartient à aucun groupe.</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>LSobject</term>
|
|
|
|
<listitem>
|
2017-04-28 02:13:05 +02:00
|
|
|
<simpara>Le type d'&LSobject; en relation avec le type courant.
|
|
|
|
<emphasis>(Facultatif en cas de liaison complexe)</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2021-06-21 12:31:49 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>display_name_format</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>&LSformat; du nom d'affichage des objets en relation.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2021-06-21 12:32:38 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>canEdit_attribute</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Le nom de l'attibut du type d'&LSobject; en relation devant être
|
|
|
|
éditable par l'utilisateur pour que celui-ci puisse modifier la relation.
|
|
|
|
Dans le cadre d'une relation simple, celui-ci peut, si nécessaire, être
|
|
|
|
différent du paramètre <literal>linkAttribute</literal>.</simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2017-04-28 02:13:05 +02:00
|
|
|
<varlistentry>
|
|
|
|
<term>linkAttribute</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Dans le cadre d'une relation simple, il s'agit de l'attribut de
|
|
|
|
liaison du type d'&LSobject; en relation avec le type courant, c'est à dire
|
|
|
|
l'attribut dans lequel on retrouve une valeur en relation avec l'objet
|
|
|
|
courant. <emphasis>(Facultatif en cas de liaison complexe)</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>linkAttributeValue</term>
|
|
|
|
<listitem>
|
2017-04-28 17:04:55 +02:00
|
|
|
<simpara>Dans le cadre d'une relation simple, il s'agit du type de valeur prisent
|
2017-04-28 02:13:05 +02:00
|
|
|
par l'attribut de liaison du type d'&LSobject; en relation avec le type courant.
|
|
|
|
Il peut s'agir du mot clé <literal>dn</literal> si l'attribut de liaison contient
|
|
|
|
le <emphasis>DN</emphasis> de l'objet courant ou bien le nom d'un attribut du type
|
|
|
|
d'objet courant dont la première valeur sera stockée par l'attribut de liaison.
|
2017-04-28 17:04:55 +02:00
|
|
|
<emphasis>(Facultatif en cas de liaison complexe)</emphasis></simpara>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>linkAttributeOtherValues</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Dans le cadre d'une relation simple, il s'agit d'autres types de valeur
|
|
|
|
possiblement prisent par l'attribut en plus de celui défini par le paramètre
|
|
|
|
<literal>linkAttributeValue</literal>. Ce paramètre ne sert qu'a détecter des
|
|
|
|
liaisons établies à l'aide de valeurs autres que celle relative au paramètre
|
|
|
|
<literal>linkAttributeValue</literal> : en cas de nouvelle liaison, c'est la
|
|
|
|
valeur associée à ce dernier qui sera utilisée pour établir la liaison.
|
|
|
|
<emphasis>(Facultatif en cas de liaison complexe)</emphasis></simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>list_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation, permettant
|
2017-04-28 02:13:05 +02:00
|
|
|
de lister les objets de ce type en relation avec l'objet courant.
|
|
|
|
<emphasis>(Facultatif en cas de liaison simple)</emphasis></simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>getkeyvalue_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation, permettant
|
|
|
|
d'obtenir la valeur clé à stocker pour établir la relation entre l'objet
|
2017-04-28 02:13:05 +02:00
|
|
|
courant et d'autres objets du type concerné. <emphasis>(Facultatif en cas de
|
|
|
|
liaison simple)</emphasis></simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>update_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation, permettant
|
|
|
|
de mettre à jour les relations existantes entre l'objet courant et les objets
|
|
|
|
du type concerné. Cette liste d'objets en relation est établie par
|
2017-04-28 02:13:05 +02:00
|
|
|
l'utilisateur à travers l'interface. <emphasis>(Facultatif en cas de liaison
|
|
|
|
simple)</emphasis></simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>remove_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation permettant
|
2021-06-21 12:31:49 +02:00
|
|
|
de supprimer une relation existante entre l'objet courant et un objet du
|
2017-04-28 02:13:05 +02:00
|
|
|
type concerné. <emphasis>(Facultatif en cas de liaison simple)</emphasis>
|
|
|
|
</simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>rename_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation permettant
|
|
|
|
d'effectuer les actions nécessaires lorsque l'objet courant est renommé dans
|
|
|
|
le but de maintenir les valeurs clés permettant d'établir les relations entre
|
2017-04-28 02:13:05 +02:00
|
|
|
l'objet courant et les objets en relation avec lui. <emphasis>(Facultatif en
|
|
|
|
cas de liaison simple)</emphasis></simpara>
|
2009-03-17 20:21:10 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-11-11 21:02:00 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>canEdit_function</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>La méthode de la classe du type d'&LSobject; en relation permettant
|
|
|
|
de vérifier que l'utilisateur à le droit de modifier la relation avec un objet
|
2017-04-28 02:13:05 +02:00
|
|
|
en particulier. <emphasis>(Facultatif en cas de liaison simple)</emphasis>
|
|
|
|
</simpara>
|
2009-11-11 21:02:00 +01:00
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2009-03-17 20:21:10 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term>rights</term>
|
|
|
|
<listitem>
|
|
|
|
<simpara>Tableau associatif dont les clés sont les noms des &LSprofiles; ayant
|
|
|
|
des droits sur cette relation et dont 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>
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
|
|
|
|
</sect2>
|