Difference between revisions of "Agendas Externes"

Latest revision as of 10:33, 2 December 2019

Bokeh permet de gérer un agenda d'évènements en définissant des articles ayant des dates ou une périodicité d'évènement, voir la documentation.

Bokeh vous permet aussi de moissonner des agendas provenants d'autres portails sous forme d'articles.

Les formats supportés à ce jour sont :

• ICalendar, largement utilisé dans les calendriers (Plus d'informations : Import ICalendar).
• OpenAgenda qui peut exposer des données au format JSON (Plus d'informations : Import OpenAgenda).

La gestion des agendas externes est réservée aux administrateurs du portail.

Voir la démonstration

Liste

Dans l'administration rendez-vous dans le menu "Gestionnaire de contenu" > "Agendas externes".

La liste des agendas externes présente un bouton pour ajouter un nouveau flux ainsi que la liste des fluxs existants. Pour chacun, la liste présente

• son libellé
• le nombre d'évènements actuellement présents en tant qu'article dans Bokeh suivi du lien vers la suppression de tous les événements de l'agenda
• l'adresse du flux
• les liens d'action : moissonnage, édition et suppression

Ajout et Modification

• Libellé : obligatoire, nom du flux
• Format : obligatoire (le type de flux)
• URL : obligatoire, adresse de moissonnage, Pour Openagenda, c'est ici que vous vollez toute l'url de votre agenda au format json, avec tous les paramètres.
• Catégorie racine : obligatoire, catégorie d'article dans laquelle importer les évènements de cet agenda. Si l'évènement définit une valeur pour son champ ical "CATEGORIES", une sous-catégorie est automatiquement créée.
• Moissonage automatique : optionnel, pour savoir si le moissonnage automatique de l'agenda doit se faire
• Supprimer les événements orphelins : optionnel, permet de supprimer les événements qui ont été créés automatiquement via cet agenda qui ne sont plus dans le flux exporté.
• Catégorie racine : obligatoire, catégorie de rattachement des articles automatiquement créés (Ce sera souvent la catégorie Portail > Agenda ).
• Lieu : optionnel, lieu de rattachement des articles (non géré et invisible dans le cas du format openagenda.
• Statut : optionnel, statut de validation adopté par les articles, n'apparait que si le workflow est activé dans votre Bokeh

Suppression

Suppression des événements

La suppression des événements va supprimer tous les articles qui ont été générés via l'import de l'agenda spécifié, ainsi que toutes les catégories ne contenant plus d'articles dans le répertoire dédié à l'import.

Suppression de l'agenda

La suppression de l'agenda ne va pas supprimer les articles qui ont pu être créés lors du moissonnage. Une fois l'agenda supprimé il sera impossible de supprimer ces articles.

Moissonnage

Format

ICalendar

ICalendar est un format souvent utilisé par exemple dans les calendrier gmail, outlook et Lightning (calendrier thunderbird)

La spécification est accessible et doit être strictement respectée.

NB : Vous pouvez le vérifier dans un validateur.

OpenAgenda

OpenAgenda est un site dans lequel vous pouvez créer et gérer vos agendas de façon collaborative.

Bokeh moissonne les données au format JSON exporté par openagenda.

Pour créer un agenda, il faut créer votre utilisateur et activer votre compte openagenda.

Là, vous pouvez créer des agenda et des événements.

La documentation utilisateur openagenda vous permet d'avoir davantage d'information.

Pour connaître l'url que vous devez insérer dans bokeh, il faut consulter l'agenda.

Cliquer sur exporter.

Puis aller sur le bouton JSON, faire un clic gauche dessus et sélectionner copier la localisation (l'url).

Et aller la coller dans l'interface d'administration des Agendas Externes.

Tips:

• Les événements futurs, tous les événements ou ceux mis en valeur peuvent être exportés dans des calendrier spécifiques.

Pour avoir plus d'information, plus de possibilité vous pouvez consulter la documentation openAgenda.

• pour la liaison avec les lieux, OpenAgenda gère des listes de lieux, et Bokeh aussi. L'information pour relier un lieu OpenAgenda à un lieu Bokeh est sa géolocalisation (Latitude / Longitude) dans openstreetmap (préférez utiliser openstreetmap à google pour éviter tout décalage entre Bokeh et OpenAgenda).

Moissonnage : test

Un clic sur le lien de moissonnage d'un agenda enclenche un moissonnage immédiat.
Bokeh présente un rapport de moissonnage listant les titres des évènements créés et mis à jour.
Chaque titre est cliquable et affiche le formulaire de modification de l'article.

Le moissonnage crée les nouveaux articles si nécessaires, et met à jour les articles qui ont déjà été importés si la Variable d'administration AGENDA KEEP LOCAL CONTENT est positionnée à 0.

Il supprime aussi les articles qui ne se trouvent plus dans le flux qui étaient précédemment importés si vous avez coché la case Supprimer les événements orphelins.

Moissonnage : automatisation

Démonstration vidéo:

Pour les agenda que l'on souhaite mettre à jour automatiquement il faut d'abord activer la mise à jour automatique en éditant l'agenda depuis la page des agendas externes.

Cocher la case 'Moissonnage automatique'.

Activer ensuite le moissonnage depuis l'écran des batchs.

Bloquer l'écrasement des articles

Par défaut, lors d'un moissonnage, les articles déjà importés sont systématiquement écrasés par la nouvelle mise à jour.

Si vous souhaitez modifier les articles importés et bloquer l'écrasement lors des prochains moissonnages, il faut aller dans les variables et activer "AGENDA KEEP LOCAL CONTENT"

Suppression

La suppression d'un agenda externe n'entraîne pas la suppression des évènements déjà importés à partir de cet agenda.

Démonstration de la fonctionnalité

Moissonage agenda OpenAgenda