m
(Démonstration de la fonctionnalité)
 
(One intermediate revision by the same user not shown)
Line 26: Line 26:
  
 
[[Fichier:external agenda.png]]
 
[[Fichier:external agenda.png]]
 +
  
 
== Ajout et Modification ==
 
== Ajout et Modification ==
  
[[Fichier:Cms external agenda add.png]]
+
[[Fichier:CMS Agenda Add.png|Ajout d'agenda]]
  
 
* '''Libellé''' : '''obligatoire''', nom du flux
 
* '''Libellé''' : '''obligatoire''', nom du flux
Line 138: Line 139:
  
 
{{#ev:youtube|https://www.youtube.com/watch?v=qBCYnN6CA-o|||||start=326}}
 
{{#ev:youtube|https://www.youtube.com/watch?v=qBCYnN6CA-o|||||start=326}}
 +
 +
=== Moissonage agenda OpenAgenda ===
 +
 +
{{#ev:youtube|https://youtu.be/5leZZihcMKk|||||start=0}}
 +
 
  
 
[[Catégorie:Gestionnaire_de_contenu]]
 
[[Catégorie:Gestionnaire_de_contenu]]

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 :


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

Video.png Voir la démonstration

Liste

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

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

External agenda.png


Ajout et Modification

Ajout d'agenda

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

External agenda delete events.png

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.

Cms external agenda import.png

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. View external agendas.png

Cocher la case 'Moissonnage automatique'.

Harvest agenda activate.png

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

Batch select task.png

Harvest external agenda.png

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"

Agendakeep.png


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

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 :


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

Video.png Voir la démonstration

Liste[edit | edit source]

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

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

External agenda.png

Ajout et Modification[edit | edit source]

Cms external agenda add.png

Suppression[edit | edit source]

Suppression des événements[edit | edit source]

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.

External agenda delete events.png

Suppression de l'agenda[edit | edit source]

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[edit | edit source]

Format[edit | edit source]

ICalendar[edit | edit source]

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[edit | edit source]

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:

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

Moissonnage : test[edit | edit source]

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.

Cms external agenda import.png

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[edit | edit source]

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. View external agendas.png

Cocher la case 'Moissonnage automatique'.

Harvest agenda activate.png

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

Batch select task.png

Harvest external agenda.png

Bloquer l'écrasement des articles[edit | edit source]

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"

Agendakeep.png


Suppression[edit | edit source]

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é[edit | edit source]