Settings

Edit me

Ressource utilisée pour sauvegarder le contexte d’utilisation d’une autre ressource (paramétrage). Par exemple pour ré-afficher un listing avec son filtre, le système va chercher le filtre dans une ressource settings liée au listing et à l’utlisateur connecté.

image{width=”500px”}

Ressource settings utilisée pour afficher le filtre “Filtrer des patients” lié au listing “Liste démo”:

<?xml version="1.0"?> 
<settings>
      <filter id="60"/>
</settings>

Les ressources settings sont stockées dans le varset des ressources. Attention elles n’ont pas de type particulier, le type qui est utilisé est xml.

L’association entre une ressource settings et la ressource qu’elle concerne se fait via la table [project]_pj_resource_settings.

Champs de la table:

  • id_resource: identifiant de la ressource. Clé étrangère vers le champ id_data du varset resource.
  • id_user: identifiant du propriétaire des settings. Peut valoir null, dans ce cas il s’agit de settings globaux (voir plus bas).
  • id_settings: identifiant de la ressource settings. Clé étrangère vers le champ id_data du varset resource.

Il est possible d’avoir des settings globaux servant à définir un paramétrage par défaut pour une ressource. Ces settings sont identifiables dans la table [project]_pj_resource_settings lorsque le champ id_user vaut null.

La gestion des settings se fait via la class Core_Library_Settings_Manager.

Méthode Description
setResourceSettings Permet de sauvegarder des settings pour une res-source. Il est possible de créer des settings glo-baux si l’objet user attendu en paramètre vaut null.
getResourceSettings Récupération des settings pour une ressource. Comme pour la méthode précédente, si l’objet user vaut null, ce sont les settings globaux qui sont renvoyés. Renvoi un objet de type Core_Library_Settings, ou correspondant au paramètre sClassName. (renvoi null si aucun settings n’a été trouvé).
getListingSettings Equivalent à la méthode getResourceSettings, en re-vanche renvoi systématiquement une ressource set-tings de type Core_Library_Settings_Listing (ou null si pas de settings).

Les class settings existantes:

  • Core_Library_Resource_XML_Settings: class vide, doit être étendue.
  • Core_Library_Resource_XML_Settings_Listing: dédié aux listings, gestion de la colorisation des lignes, du groupement et du filtre.
  • Core_Library_Resource_XML_Settings_Export