DAViCal
Créer des entités (Person, Resource, Group).
Sommaire : Monter son propre service de calendrier
Etape précédente : Vérification de l'installation
Dans cet article, je considère que l'interface web de DAViCal est en anglais, et que je suis logué avec l'utilisateur admin.
Présentation des entités
Dans DAViCal, une entité est soit un Principal, soit une Collection.
Il existe trois types d'objets Principal :
- Person : ce sont les utilisateurs;
- Resource : il s'agit de n'importe quoi qui puisse faire l'objet d'une réservation (salle, matériel, véhicule...);
- Group : ce sont des ensembles regroupant des utilisateurs.
N'importe quel Principal peut avoir un calendrier ou un carnet d'adresses, même si l'intérêt pour un Group est limité.
Création d'un Principal
Pour créer un Principal, je vais dans le menu User Functions puis Create Principal. J'arrive alors sur cette page :
Explication rapide :
- Username : de préférence sans espace (il apparaîtra dans l'URL à indiquer dans le logiciel client);
- Change Password & Confirm Password : le mot de passe du compte de ce Principal;
- Fullname : il s'agit de la dénomination de ce Principal vu depuis les logiciels clients;
- Email Address : elle est importante! Dès le moment où l'on souhaite envoyer des invitations et faire des recherches dans les calendriers de disponibilités (free-busy) des autres utilisateurs, chaque compte utilisateur DOIT posséder un email, même si l'adresse est factice. De plus, chaque adresse email doit être unique (i.e un compte <=> un email);
- Locale : la langue de l'interface web lorsque ce compte est connecté;
- Date Format Style : Je choisis le format de date parmi European (JJ-MM-AAAA), ISO Format (AAAA-MM-JJ) et US Format (MM-JJ-AAAA);
- Administrator : Je décide si cet utilisateur doit disposer ou non des droits d'administration;
- Active : permet d'activer l'utilisateur immédiatement. Selon les goûts, certains voudront sûrement désactiver un nouvel utilisateur, effectuer les paramétrages, puis enfin l'activer, afin d'éviter les failles de sécurité.
- Privileges granted to All Users : j'y retrouve les droits indiqués dans le fichier de configuration de DAViCal (Cf variable default_privileges). Je recommande de laisser les droits tels quels. Nous verrons plus tard des cas d'utilisation des Group.
Note : chaque Principal est doté d'un compte utilisateur avec lequel je peux me connecter sur la page d'accueil (grâce aux username/password ci-dessus).
Création d'un utilisateur (Person)
Pour créer un utilisateur, je crée un Principal comme spécifié dans l'étape ci-dessus, et je choisis la valeur Person pour la ligne Principal Type :
Puis je clique sur CREATE.
DAViCal crée alors les carnets d'adresses et les calendriers que j'ai spécifiés dans le fichier de configuration de DAViCal (Cf variable default_collections) :
Je peux vérifier que les noms et les droits des Collections sont bien ceux que j'ai prédéfinis, en allant en bas de page, à la section Principal Collections.
Création d'une ressource (Resource)
De le même façon, je crée un objet Resource en créant un Principal, et en choisissant la valeur Resource à la ligne Principal Type :
Puis je clique sur CREATE.
Comme pour une Person, DAViCal crée les carnets d'adresses et les calendriers spécifiés dans le fichier de configuration de DAViCal (Cf variable default_collections).
Création d'un groupe (Group)
La méthode est la même que précédemment, en choisissant la valeur Group à la ligne Principal Type :
Contrairement à la création d'un Principal de type Person ou Resource, la création d'un Group n'implique pas la création des carnets d'adresses et des calendriers. En effet, le Group sert avant tout à faciliter la gestion des droits utilisateurs, comme nous le verrons plus loin.
Etape suivante : Créer des entités (Calendar, Addressbook)