PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Propriétés spécifiques à la description des variables de type gglEvénement
  • Gestion des dates et de leur fuseau horaire
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
gglEvénement (Type de variable)
En anglais : gglEvent (Type of variable)
Le type gglEvénement permet de décrire et de modifier un événement d'un agenda. L'agenda est décrit grâce au type gglAgenda. Cet agenda est utilisé par le service Agenda Google Calendar.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Attention : l'accès aux Agendas Google change à partir du 17 Novembre 2014
A partir du 17 Novembre 2014, Google utilise uniquement l'API Google version 3 (l'API Google version 2 est abandonnée). Ce changement de version a modifié le format d'échange des données utilisé par les fonctions d'accès aux Agendas Google.
Il est désormais nécessaire d'utiliser une authentification "OAuth 2.0" pour accéder à ce service. Ce mode d'authentification nécessite :
  • la déclaration de l'application dans la console Google. Pour utiliser les Agendas Google, l'application doit utiliser le service "Calendar API".
  • l'utilisation de nouvelles propriétés dans la variable de type gglConnexion.
Pour plus de détails, consultez l'aide de la fonction GglConnecte.
Attention : Les types de variables gglAgenda, gglEvénement et gglLieu sont également modifiés. Certaines propriétés deviennent obsolètes avec l'API Google version 3 : elles ne doivent plus être spécifiées.
Exemple
// Connexion à Google
Cnx est un gglConnexion
Cnx..Email = "balthazar@gmail.com"
Cnx..MotDePasse = "azerty"
Cnx..NomApplication = "MonAppli-01"
SI GglConnecte(Cnx) = Faux ALORS
        Erreur(ErreurInfo())
FIN
...
// Récupération du tableau des agendas disponibles
tabAgendas est un tableau de gglAgenda
tabAgendas = GglListeAgenda(Cnx)
// Récupération de tous les événements du premier agenda
GglRemplitAgenda(Cnx, tabAgendas[1])
// Parcours des événements
Evt est un gglEvénement
POUR TOUT Evt DE tabAgendas[1]
        Trace(Evt..Titre)
FIN
Remarques

Propriétés spécifiques à la description des variables de type gglEvénement

Les propriétés suivantes peuvent être utilisées pour manipuler un événement d'un agenda grâce au type gglEvénement :
NomType manipuléEffet
AuteurgglAuteurAuteur de l'agenda. Cette propriété est accessible en lecture uniquement.
ContenuChaîne de caractères UnicodeDescription de l'événement.
DateDébutDateHeureDate de début de l'événement.
Remarques :
  • Dans l'interface Google, si l'événement correspond à une journée entière, la date de début de l'événement est celle du jour à 0h00.
  • La date est celle du fuseau horaire de l'agenda.La date est celle du fuseau horaire de la machine locale.
DateFinDateHeureDate de fin de l'événement.
Remarques :
  • Dans l'interface Google, si l'événement correspond à une journée entière, la date de fin de l'événement est celle du jour suivant à 0h00.
  • La date est celle du fuseau horaire de l'agenda.La date est celle du fuseau horaire de la machine locale.
DateMiseAJourDateHeureDate de mise à jour de l'événement. Cette propriété est accessible en lecture uniquement.
Remarque : La date est celle du fuseau horaire de l'agenda.La date est celle du fuseau horaire de la machine locale.
DatePublicationDateHeureDate de dernier accès à l'événement. Cette propriété est accessible en lecture uniquement.
Remarque : La date est celle du fuseau horaire de l'agenda.La date est celle du fuseau horaire de la machine locale.
Avertissement
A partir de la version 20, suite au passage en version 3 de l'API Google, cette propriété n'est plus supportée.
Versions 15 et supérieures
Identifiant
Nouveauté 15
Identifiant
Identifiant
Chaîne de caractères UnicodeIdentifiant Google de l'événement.
Versions 18 et supérieures
JournéeEntière
Nouveauté 18
JournéeEntière
JournéeEntière
  • Vrai si l'événement correspond à des journées entières,
  • Faux dans le cas contraire.
Invité[n]Tableau de gglPersonneListe des participants à l'événement.
Attention : Lors de la modification d'un événement, les participants ne sont pas prévenus automatiquement des modifications effectuées. Il est nécessaire de programmer cette fonctionnalité si nécessaire.
LieuListe des lieux associés à l'événement.
TitreChaîne de caractères UnicodeTitre de l'événement.

Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>
Versions 20 et supérieures

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.
Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.
Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété ..FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.
Nouveauté 20

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.
Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.
Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété ..FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.

Gestion des dates et de leur fuseau horaire

Suite à l'utilisation de l'authentification "OAuth 2.0", la gestion des dates a été modifiée. Toutes les dates renvoyées par les fonctions GglRécupèreAgenda, GglListeAgenda, ... dans les variables de type gglEvénement utilisent le fuseau horaire de la machine locale. Elles sont donc utilisables directement dans un champ Calendrier avec le fuseau horaire en cours.
Pour les convertir dans un fuseau horaire particulier, il est possible d'utiliser les fonctions DateHeureLocaleVersFuseau ou DateHeureLocaleVersUTC.
Il est possible de récupérer le fuseau horaire de l'agenda accédé via la propriété ..FuseauHoraire des variables de type gglAgenda. La valeur renvoyée correspond au nom du fuseau, issu de la base de données "tz" (ou base de données Olson). Ce nom est directement utilisable avec la fonction DateHeureLocaleVersFuseau.
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire