Fr:Free Busy

From Davical
Revision as of 20:59, 22 February 2011 by Tikismoke (talk) (Le moyen 'standard')
Jump to navigationJump to search
Help
Available languages
Besoin de traduction Cet article ou cette section nécessitent d'être traduits depuis l'article Free Busy.

Si vous connaissez bien l'anglais, n'hésitez pas ! Merci pour 'DAViCal'.

DAViCal fournis trois moyen d'obtenir les informations Libre/occupé:

  • Au travers de l'extension planification de CalDAV
  • Au travers du rapport de la requête free-busy-query de CalDAV
  • Au travers d'un Url spécial .../freebusy.php/...

Extension planification de CalDAV

Si votre logiciel client supporte ceci (Mozilla Sunbird/Lightning 0.8+ et Apple iCal le supporte, Evolution et Korganiser non. D'autres???) alors vous pouvez essayer de programmer une réunion, le logiciel enverra une requête à DAViCal pour extraire la possibilité de réunir les participants pour une période donnée.

Cette recherche est basée sur l'adresse e-mail du participant, il est donc important que tous les utilisateurs DAViCal aient leurs adresses e-mail renseigner correctement.

C'est la méthode dont nous espérerons voir la plupart des clients utiliser automatiquement à l'avenir, mais ce n'est pas si bon pour les demandes freebusy inter-domaines.

Rapport de la requête free-busy-query de CalDAV

CalDAV spécifie un type de requête particulière pour récupérer l'information de disponibilité, et depuis la version 0.6.0 celle-ci est supportée. Malheureusement aucun client connue n'utilise cette méthode, malgrès son implémentation dans DAViCal.

Url spécial .../freebusy.php/...

L'accès à l'URL freebusy nécessite habituellement de s'authentifié avec DAViCal, les droits appropriés accordés (ex: free/busy access) pour l'utilisateur authentifié dans le respect des règles du calendrier (ou utilisateur) auxquels ils accèdent à l'information libre/occupé.

Un paramètres de configuration public_freebusy_url peut être activer pour rendre publique l'URL freebusy. Dans ce cas DAViCal peut fournir les informations de disponibilités à un seveur Kerio par exemple ou à d'autres sevices capable de fédérer ces informations.

Utilisation de freebusy.php

Par défaut freebusy.php montrera les informations free/busy débutant la veille et jusqu'à 44 jours après. Ceci peut être modifié en changeant les paramètres de l'URL, comme ceci: http://davical.example.com/freebusy.php/username/home?start=20100104T213119Z&end=20110216T213353Z

Les paramètres suivant sont reconnus:

  • start: Une date de départ dans un format de date reconnu par PHP.
  • end: Une date de fin dans un format de date reconnu par PHP.
  • period: Une période de temps dans un (en)format défini dans la RFC2445. Exemple: P1DT5H30M signifie 1 jour, 5 heures et 30 minutes.
  • format: Format de sortie, pour l'instant seul acceptable text/calendar.
  • user: L'utilisateur propriétaire du calendrier montré.
  • token: Le jeton d'accès utilisateur (calendrier) à montrer.
  • ticket: Un jeton spéciale donnant des permissions spécifiques pour voir les informations libre/occupé.

Utilisateur et jeton peuvent être définis comme ceci: freebusy.php?user=username&token=home ou freebusy.php/username/home. User and token can be set as freebusy.php?user=username&token=home or freebusy.php/username/home.

Le moyen 'standard'

Comme encore aucun client n'a été observer comme effectuant des requêtes via free-busy-query, mais Evolution (au moins) utilise une alternative basée sur l'utilisation d'adresse mail, l'information de disponibilité est aussi disponible sur un requête directe.

Since no clients have yet been observed to make CalDAV free-busy-query requests, but Evolution (at least) provides an alternative based around using e-mail addresses, the free/busy information is also available on a direct request. The URL may follow the form identical to the structure for the 'caldav.php' URL (with 'caldav' replaced by 'freebusy' of course), and will return freebusy information to a suitably authorised user.

This format is accepted by a Mozilla Lightning extension from Inverse.

For example:

http://calendar.example.net/freebusy.php/user1/home/

Utilisation de l'adresse e-mail

Evolution provides a way of specifying the search for freebusy information which can do a lookup using an e-mail address. In order to support calendars where users may have e-mail addresses in different domains, while sharing the same calendar server, you can specify the freebusy URL using the e-mail address, as:

http://calendar.example.net/freebusy.php/username@domain.tld

In this case the e-mail address searched for must be unique, and the freebusy information retrieved will be merged from all of their calendars (excluding PRIVATE events).

The user accessing this URL will still need to authenticate against DAViCal, of course.

Configuration for Korganiser / Kontact

The appropriate section to configure the free/busy retrieval is Settings -> Configure Calendar -> Configure Korganiser (Configure Calendar when using Kontact) -> Free/Busy -> Retrieve -> Server URL. The format of this URL should be:

http:// ... davical server etc ... /freebusy.php/%EMAIL%

If you configure free/busy retrieval through the appropriate settings tab, it will perform a check to determine if the server's parent domain matches the email domain. If it does not, the free/busy times are not retrieved. See this e-mail message for more information:

You can either create a contact and specify the server in the free/busy section, or ensure the parent domain of the server matches the email domain.

Permissions for Free/Busy

If a user has read permission to a calendar, they will quite naturally have the ability to read free/busy information. If you want to bestow permission for Free/Busy without full Read permission you should grant the 'read-free-busy' permission.

If you want to give a particular person access to your freebusy URL without logging into DAViCal to retrieve it you can create a 'ticket' granting the 'read-free-busy' permission and they can use this with the freebusy.php URL to request the information without logging in.


Besoin de relécture Cet article ou cette section nécessitent d'être 'relu'. Si vous connaissez bien le français, n'hésitez pas! Merci pour DAViCal.