Modules Google Calendar

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent le calendrier Google et les connecter à plusieurs applications et services tiers.

Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index d’article.

Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Formule Adobe Workfront*
Pro ou version supérieure
Licence Adobe Workfront*
Plan, Work
Licence Adobe Workfront Fusion **

Exigence de licence actuelle : aucune exigence de licence Workfront Fusion.

Ou

Exigence de licence héritée : Workfront Fusion for Work Automation and Integration

Produit

Configuration requise actuelle du produit : si vous disposez du plan Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le plan Workfront Ultimate.

Ou

Exigences de produit héritées : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre administrateur ou administratrice Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

Pour utiliser les modules Google Calendar, vous devez disposer d’un compte Google.

Informations sur l’API du calendrier Google

Le connecteur Calendrier Google utilise les éléments suivants :

URL de base
https://www.googleapis.com/calendar/v3
Version de l’API
v3
Balise API
v5.4.5

Modules Google Calendar et leurs champs

Lorsque vous configurez les modules Google Calendar, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Google Calendar supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.

Basculement de carte

Déclencheurs

Surveiller les événements

Ce module de déclenchement exécute un scénario lorsqu’un nouvel événement est ajouté, mis à jour, supprimé, démarré ou se termine dans le calendrier que vous indiquez. Le module renvoie tous les champs standard associés à l’enregistrement ou aux enregistrements, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Calendar
Sélectionnez le calendrier avec lequel vous souhaitez que le module fonctionne.
Watch
Choisissez de ne regarder que les nouveaux événements ou les nouveaux événements et toutes les modifications.
Show deleted events
Activez cette option pour inclure les événements qui ont été supprimés.
Query
Saisissez le texte pour lequel vous souhaitez renvoyer des résultats.
Nombre maximal d'événements
Définissez le nombre maximal d’événements avec lesquels Workfront Fusion fonctionne au cours d’un cycle (le nombre de répétitions par exécution de scénario). Si la valeur est définie sur une valeur trop élevée, la connexion peut être interrompue du côté du service tiers donné (délai d’expiration). Workfront Fusion n’a aucune influence sur ce point. Nous vous recommandons de définir une valeur inférieure et de définir une valeur supérieure pour le nombre maximal de cycles ou d’exécuter le scénario plus fréquemment.

Regarder les événements (instantané)

Ce module de déclenchement utilise un hook pour créer une adresse e-mail que vous pouvez utiliser comme invitation à des événements. Le module démarre un scénario basé sur des événements auxquels l’adresse e-mail est invitée.

Mailhook

Sélectionnez le mailhook que vous souhaitez utiliser pour ce module. Pour créer un nouveau mailhook, cliquez sur Ajouter et saisissez la connexion que vous souhaitez utiliser pour le mailhook.

Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base

Nombre maximal d'événements
Définissez le nombre maximal d’événements avec lesquels Workfront Fusion fonctionne au cours d’un cycle (le nombre de répétitions par exécution de scénario). Si la valeur est définie sur une valeur trop élevée, la connexion peut être interrompue du côté du service tiers donné (délai d’expiration). Workfront Fusion n’a aucune influence sur ce point. Nous vous recommandons de définir une valeur inférieure et de définir une valeur supérieure pour le nombre maximal de cycles ou d’exécuter le scénario plus fréquemment.

Actions

Créer un calendrier

Ce module d'action crée un calendrier associé au compte.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Color
Sélectionnez la couleur à associer au calendrier.
Calendar name
Saisissez ou mappez un nom pour le nouveau calendrier.

Créer un événement

Ce module d’action crée un événement.

Vous spécifiez le calendrier et les paramètres de l’événement.

Le module renvoie l’identifiant de l’événement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Calendar
Choisissez le calendrier dans lequel vous souhaitez que l’événement apparaisse.
Color
Sélectionnez la couleur que l’événement doit afficher dans le calendrier.
Event name

Saisissez ou mappez un nom pour l’événement.

Remarque : si vous avez sélectionné Quick add dans le champ Create an event, vous pouvez inclure la date et l’heure de l’événement, et Workfront Fusion crée l’événement pour cette date et cette heure. Exemple : Appointment at Capitol Hill on June 3rd 10am-10:25am. Si vous avez sélectionné Quick add sans inclure de date et d’heure dans le nom de l’événement, l’événement est créé à partir de l’heure actuelle et dure une heure.

All day event
Activez cette option si l’événement est un événement qui dure toute la journée (il n’a alors pas besoin d’heure de début ni de fin).
Start date

Saisissez ou mappez la date et l’heure de début de l’événement.

Pour obtenir la liste des formats de date pris en charge, voir Type coercition.

End date

Saisissez ou mappez la date et l’heure de fin de l’événement.

Pour obtenir la liste des formats de date pris en charge, voir Type coercition.

Description
Saisissez ou mappez une description pour l’événement. Ce champ prend en charge le format HTML.
Location
Saisissez l’emplacement de l’événement dans le formulaire texte.
Use the default reminder settings for this event
Activez cette option pour utiliser les paramètres de rappel par défaut. Si vous définissez un rappel personnalisé dans le champ Reminder, cette valeur est définie sur Non.
Reminder
Ajoutez un rappel pour l’événement. Pour chaque rappel à ajouter, cliquez sur Ajouter un élément, puis sélectionnez la méthode avec laquelle vous souhaitez recevoir un rappel et définissez la durée (en minutes) avant l’événement pour lequel vous souhaitez recevoir un rappel.
Attendees
Ajoutez les personnes participant à l’événement. Pour chaque participant, cliquez sur Ajouter un participant, puis saisissez ou mappez son nom et son adresse e-mail.
Show me as
Définissez votre statut sur « Occupé » ou « Disponible » à afficher pour les personnes qui ont accès à votre calendrier lors de cet événement.
Visibility

Sélectionnez la visibilité de cet événement.

  • Default

    La visibilité de l’événement est définie dans les paramètres du calendrier.

  • Public

    Toutes les personnes avec qui le calendrier est partagé peuvent voir cet événement.

  • Private

    Seules les personnes inscrites peuvent voir cet événement.

Send notification about the event creation

Choisissez d’envoyer des notifications sur la création d’un nouvel événement à toutes les personnes invitées, à celles qui ne sont pas invitées dans Google Calendar, ou à personne.

Conseil : nous vous recommandons d’utiliser l’option None uniquement pour les cas de migration.

Guests can modify the event
Activez cette option si vous souhaitez que les personnes invitées puissent modifier cet événement.
Recurrence
Ajoutez des règles de périodicité à cet événement. Chaque règle nécessite une liste de lignes RRULE, EXRULE, RDATE et EXDATE pour un événement récurrent. Notez que les lignes DTSTART et DTEND ne sont pas autorisées dans ce champ ; les heures de début et de fin de l’événement sont spécifiées dans les champs de début et de fin. Ce champ est omis pour les événements uniques ou les instances d’événements récurrents. Pour plus d’informations, consultez la section RFC5545.

Supprimer un événement

Ce module d’action supprime un événement.

Spécifiez le calendrier et l’identifiant d’événement.

Le module renvoie l’identifiant de l’événement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Calendar
Sélectionnez le calendrier qui contient l’événement que vous souhaitez supprimer.
Event ID
Saisissez l’identifiant d’événement de l’événement Google Calendar précédemment créé que vous souhaitez supprimer.

Obtenir des événements

Ce module récupère des informations sur les événements du calendrier sélectionné en fonction des critères que vous spécifiez.

Vous indiquez le calendrier et les paramètres de la recherche.

Le module renvoie l’identifiant des événements et des champs associés, ainsi que des champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Calendar
Sélectionnez le calendrier pour lequel vous souhaitez récupérer les événements.
Start date

Entrez ou mappez la date de début de l’événement. Ce module récupère également les événements qui commencent avant cette date et qui se produisent toujours à la date de début saisie.

Pour obtenir la liste des formats de date et d’heure pris en charge, voir Type coercition.

End date

Saisissez ou mappez la date de fin de l’événement.

Pour obtenir la liste des formats de date et d’heure pris en charge, voir Type coercition.

Single events
Activez cette option pour traiter les événements récurrents comme des instances uniques. Par exemple, si vous disposez d’une réunion hebdomadaire et que cette option est activée, le module renvoie la réunion de chaque semaine sous la forme d’un événement distinct.
Query
Saisissez ou mappez le terme de recherche souhaité.
Order by

Sélectionnez l’ordre des événements renvoyés dans le résultat.

  • Start Time  : triez par date et heure de début (croissant). Cette option n’est disponible que lors de l’interrogation d’événements uniques.
  • Updated Time  : triez par heure de dernière modification (croissant).
Nombre maximal d'événements renvoyés
Définissez le nombre maximal d’événements renvoyés par Workfront Fusion au cours d’un cycle d’exécution.

Mettre à jour un événement

Ce module d’action modifie un événement existant.

Spécifiez le calendrier et l’identifiant d’événement.

Le module renvoie l’identifiant de l’événement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Calendar à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Calendar
Sélectionnez le calendrier que vous souhaitez utiliser.
Event ID
Saisissez l’identifiant d’événement de l’événement Google Calendar précédemment créé que vous souhaitez mettre à jour.
Event name

Saisissez ou mappez un nom pour l’événement.

Remarque : si vous avez sélectionné Quick add dans le champ Create an event, vous pouvez inclure la date et l’heure de l’événement, et Workfront Fusion crée l’événement pour cette date et cette heure. Exemple : Appointment at Capitol Hill on June 3rd 10am-10:25am. Si vous avez sélectionné Quick add sans inclure de date et d’heure dans le nom de l’événement, l’événement est créé à partir de l’heure actuelle et dure une heure.

All day event
Activez cette option si l’événement est un événement qui dure toute la journée (il n’a alors pas besoin d’heure de début ni de fin).
Start date

Saisissez ou mappez la date et l’heure de début de l’événement.

Pour obtenir la liste des formats de date pris en charge, voir Type coercition.

End date

Saisissez ou mappez la date et l’heure de fin de l’événement.

Pour obtenir la liste des formats de date pris en charge, voir Type coercition.

Description
Saisissez ou mappez une description pour l’événement. Ce champ prend en charge le format HTML.
Location
Saisissez l’emplacement de l’événement dans le formulaire texte.
Use the default reminder settings for this event
Activez cette option pour utiliser les paramètres de rappel par défaut. Si vous définissez un rappel personnalisé dans le champ Reminder, cette valeur est définie sur Non.
Reminder
Ajoutez un rappel pour l’événement. Pour chaque rappel à ajouter, cliquez sur Ajouter un élément, puis sélectionnez la méthode avec laquelle vous souhaitez recevoir un rappel et définissez la durée (en minutes) avant l’événement pour lequel vous souhaitez recevoir un rappel.
Attendees
Ajoutez les personnes participant à l’événement. Pour chaque participant, cliquez sur Ajouter un participant, puis saisissez ou mappez son nom et son adresse e-mail.
Show me as
Définissez votre statut sur « Occupé » ou « Disponible » à afficher pour les personnes qui ont accès à votre calendrier lors de cet événement.
Visibility

Sélectionnez la visibilité de cet événement.

  • Default

    La visibilité de l’événement est définie dans les paramètres du calendrier.

  • Public

    Toutes les personnes avec qui le calendrier est partagé peuvent voir cet événement.

  • Private

    Seules les personnes inscrites peuvent voir cet événement.

Send notification about the event creation

Choisissez d’envoyer des notifications sur la création d’un nouvel événement à toutes les personnes invitées, à celles qui ne sont pas invitées dans Google Calendar, ou à personne.

Conseil : nous vous recommandons d’utiliser l’option None uniquement pour les cas de migration.

Guests can modify the event
Activez cette option si vous souhaitez que les personnes invitées puissent modifier cet événement.
Recurrence
Ajoutez des règles de périodicité à cet événement. Chaque règle nécessite une liste de lignes RRULE, EXRULE, RDATE et EXDATE pour un événement récurrent. Notez que les lignes DTSTART et DTEND ne sont pas autorisées dans ce champ ; les heures de début et de fin de l’événement sont spécifiées dans les champs de début et de fin. Ce champ est omis pour les événements uniques ou les instances d’événements récurrents. Pour plus d’informations, consultez la section RFC5545.

Itérateurs

Itérer les pièces jointes

Ce module d’action effectue une itération sur les pièces jointes d’un événement et génère chaque pièce jointe dans un lot distinct.

Source module
Dans ce scénario, sélectionnez le module qui génère l’événement contenant les pièces jointes à itérer.

Itérer les participants

Ce module d’action effectue une itération sur les participants d’un événement et génère chaque participant dans un lot distinct.

Source module
Sélectionnez le module dans ce scénario qui génère l’événement contenant les participants que vous souhaitez itérer.

Déclencher un scénario avant un événement

Pour déclencher un scénario à un moment précis avant un événement, utilisez les rappels par e-mails standard de Google Calendar et du module Webhooks > Mailhook personnalisé.

  1. Utilisez le module Calendrier Google > Mettre à jour un événement pour ajouter un rappel par e-mail à votre événement :

    Déclencher un scénario avant l’événement

  2. Créez un scénario à partir du module Webhooks >Mailhook personnalisé.

    1. Copiez l’adresse e-mail du mailhook.
    2. Enregistrez le scénario et exécutez-le.
  3. Dans Gmail, redirigez les rappels par e-mail de Google Calendar vers l’adresse e-mail du mailhook :

    1. Ouvrez vos paramètres Gmail.

    2. Ouvrez l’onglet Transfert et POP/IMAP.

    3. Cliquez sur Ajouter une adresse de transfert.

    4. Collez l’adresse e-mail copiée du mailhook, cliquez sur Suivant, confirmez en appuyant sur Continuer dans la fenêtre contextuelle, puis cliquez sur OK.

    5. Dans Workfront Fusion, passez au nouveau scénario qui doit terminer son exécution en recevant l’e-mail de confirmation.

    6. Cliquez sur la bulle au-dessus du module pour inspecter la sortie du module.

    7. Développez l’élément Text et copiez le code de confirmation :

      Code de confirmation

    8. Dans Gmail, collez le code de confirmation dans la boîte de dialogue de modification et cliquez sur Vérifier  :

      Coller le code

    9. Ouvrez l’onglet Filtres et adresses bloqués.

    10. Cliquez sur Créer un filtre.

    11. Configurez un filtre pour tous les e-mails provenant de calendar-notification@google.com et cliquez sur Créer un filtre  :

    12. Sélectionnez Transférer à et choisissez l’adresse e-mail du mailhook dans la liste.

    13. Cliquez sur Créer un filtre pour créer le filtre.

  4. (Facultatif) Dans Workfront Fusion, ajoutez le module Analyseur de texte > Modèle de correspondance après le module Webhooks >Custom mailhook pour analyser le code HTML de l’e-mail afin d’obtenir les informations dont vous avez besoin.

    Par exemple, vous pouvez configurer le module comme suit pour obtenir l’identifiant de l’événement :

    Motif  : <meta itemprop="eventId/googleCalendar" content="(?<evenitID>.*?)"/>

    Texte  : l’élément HTML content produit par le module Webhooks > Mailhook personnalisé.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3