Aller au contenu

Configuration des attributs

Cette section décrit les options de configuration des attributs des LSobjects. Les attributs sont définis dans le tableau associatif attrs de la configuration des LSobjects. Dans ce tableau, les clé les noms des attributs et les valeurs liés sont la configuration des attributs.

Warning

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 Net_LDAP2

'attrs' => array (
  /* ----------- start -----------*/
  'attr1' => array (
    'label' => '[label de l'attr1',
    'displayAttrName' => '[booleen]',
    'help_info' => '[Message d'aide sur l'attribut attr1]',
    'help_info_in_view' => '[booleen]',
    '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
    ),
    'no_value_label' => '[No set value label]',
    'multiple' => 0,
    'required' => 1,
    'generate_function' => 'fonction1',
    'generate_value_format' => '[LSformat]',
    'default_value' => 'valeur1',
    'set_default_value_on_creation_if_empty' => [booleen],
    'force_generation_if_empty' => [booleen],
    '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
    ),
    'onDisplay' => 'fonction2'

    'before_modify' => 'function1',
    'after_modify' => 'function2'
  ),
  /* ----------- end -----------*/
  ...
);
...

  • label

    Le label de l'attribut.

  • displayAttrName

    Booléen définissant si le nom de l'attribut doit être affiché en préfixe du message d'aide (paramètre help_info).

  • help_info

    Message d'aide qui sera affiché dans une bulle d'aide à côté du nom de l'attribut dans les formulaires.

  • help_info_in_view

    Booléen définissant si le message d'aide doit être affiché sur la vue de visualisation de l'objet.

    Valeurs possibles : 0 ou 1

    Valeur par défaut : 0

  • no_value_label

    Label affiché lorsque l'attribut n'a pas de valeur (facultatif).

  • multiple

    Booléen définissant si cet attribut peut stocker plusieurs valeurs.

    Valeurs possibles : 0 ou 1

    Valeur par défaut : 0

  • required

    Booléen définissant si cet attribut doit obligatoirement être défini.

    Valeurs possibles : 0 ou 1

    Valeur par défaut : 0

  • generate_function

    Nom de la fonction permettant de générer la valeur de l'attribut. Cette fonction sera éxecutée, en passant en premier paramètre, l'objet LSobject courant.

  • generate_value_format

    LSformat permettant la génération de l'attribut.

    Note

    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 generate_function).

  • default_value

    Valeur par défaut de l'attribut.

    Warning

    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 yes ou no.

    Note

    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).

  • set_default_value_on_creation_if_empty

    Booléen permettant de définir si la valeur de l'attribut doit être initialisée avec sa valeur par défaut à la création de l'objet si aucune autre valeur n'as été fournie dans le contexte de création (par défaut : 1).

  • force_generation_if_empty

    Booléen permettant de définir si la valeur de l'attribut doit être générée si elle est vide, que ce soit à la création ou la modification de l'objet (par défaut : 0).

    Warning

    Si la génération échoue, cela bloquera l'action. Par ailleurs, cette génération est prioritaire sur l'utilisation de la valeur par défaut de l'attribut induit par le paramètre set_default_value_on_creation_if_empty.

  • check_data

    Tableau associatif contenant les règles de vérification syntaxique des données de l'attribut. Voir la section concernée.

  • validation

    Tableau associatif contenant les règles de vérification d'intégrité des données de l'attribut. Voir la section concernée.

  • rights

    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 r pour le droit de lecture ou w pour le droit de lecture-écriture. Par défaut, un LSprofile n'a aucun droit.

  • view

    Booléen définissant si l'attribut est, ou non, affiché lors de la visualisation des objets du type courant.

    Valeurs possibles : 0 ou 1

    Valeur par défaut : 0

  • form

    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 0, alors l'attribut sera lecture-seule et si cette valeur vaut 1, cet attribut sera affiché en lecture-écriture.

  • dependAttrs

    Tableau associatif listant les attributs dépendants de celui-ci. Les attributs listés ici seront regénérés lors de chaque modification de l'attribut courant. Cette génération sera effectuée avec la fonction définie dans le paramètre generate_function de l'attribut.

  • onDisplay

    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.

  • before_modify

    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 la valeur de l'attribut. Voir la section concernée

  • after_modify

    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 la valeur de l'attribut. Voir la section concernée