Codeunit "Outlook Event UTCAP"

ID 70344819

Namespace: CapVision.Core.Graph

Événement Outlook (ressource Graph « event »), à passer à "Outlook Calendar UTCAP".

Remarks

L'objet distingue l'état connu côté Outlook (dernière lecture ou écriture) des propriétés modifiées depuis : seules ces dernières sont envoyées à la mise à jour. Une propriété non modifiée n'est donc jamais écrasée, et les réponses des participants, les rappels ou le lien Teams existants sont préservés. Toutes les dates sont échangées en UTC : un DateTime AL est absolu, il n'y a pas de fuseau à deviner. Les propriétés Graph non exposées ici (importance, sensibilité, récurrence...) restent accessibles via et .

Properties

Name	Value
Access	Public

Methods

GetId

Identifiant Outlook de l'événement, à conserver côté BC pour le mettre à jour ou le supprimer.

procedure GetId(): Text

Returns

Type	Description
Text

SetId

Désigne un événement existant par son identifiant, pour le mettre à jour sans le relire au préalable.

procedure SetId(NewId: Text)

Parameters

Name	Type	Description
NewId	Text

GetWebLink

Lien d'ouverture de l'événement dans Outlook sur le web.

procedure GetWebLink(): Text

Returns

Type	Description
Text

GetOrganizerEmail

Adresse e-mail de l'organisateur.

procedure GetOrganizerEmail(): Text

Returns

Type	Description
Text

GetOnlineMeetingJoinUrl

Lien pour rejoindre la réunion Teams associée, si elle existe.

procedure GetOnlineMeetingJoinUrl(): Text

Returns

Type	Description
Text

SetSubject

procedure SetSubject(NewSubject: Text)

Parameters

Name	Type	Description
NewSubject	Text

GetSubject

procedure GetSubject(): Text

Returns

Type	Description
Text

SetBody

Définit le corps de l'événement (texte de l'invitation).

procedure SetBody(Content: Text; IsHtml: Boolean)

Parameters

Name	Type	Description
Content	Text	Contenu du corps.
IsHtml	Boolean	true si le contenu est du HTML, false pour du texte brut.

GetBody

procedure GetBody(): Text

Returns

Type	Description
Text

IsBodyHtml

procedure IsBodyHtml(): Boolean

Returns

Type	Description
Boolean

SetLocation

Définit le lieu de l'événement. Une valeur vide retire le lieu existant.

procedure SetLocation(NewLocation: Text)

Parameters

Name	Type	Description
NewLocation	Text

GetLocation

procedure GetLocation(): Text

Returns

Type	Description
Text

SetShowAs

Définit la disponibilité affichée pendant l'événement. La valeur vide laisse Graph appliquer sa valeur par défaut.

procedure SetShowAs(NewShowAs: Enum "Outlook Event Show As UTCAP")

Parameters

Name	Type	Description
NewShowAs	Enum CapVision.Core.Graph."Outlook Event Show As UTCAP"

GetShowAs

procedure GetShowAs(): Enum "Outlook Event Show As UTCAP"

Returns

Type	Description
Enum CapVision.Core.Graph."Outlook Event Show As UTCAP"

SetReminder

Active le rappel, déclenché le nombre de minutes spécifié avant le début.

procedure SetReminder(MinutesBeforeStart: Integer)

Parameters

Name	Type	Description
MinutesBeforeStart	Integer

DisableReminder

procedure DisableReminder()

IsReminderOn

procedure IsReminderOn(): Boolean

Returns

Type	Description
Boolean

GetReminderMinutesBeforeStart

procedure GetReminderMinutesBeforeStart(): Integer

Returns

Type	Description
Integer

SetTeamsMeeting

Associe (ou non) une réunion Microsoft Teams à l'événement. Le lien est disponible après enregistrement via .

procedure SetTeamsMeeting(Enabled: Boolean)

Parameters

Name	Type	Description
Enabled	Boolean

IsTeamsMeeting

procedure IsTeamsMeeting(): Boolean

Returns

Type	Description
Boolean

SetCategories

Définit les catégories Outlook de l'événement (elles doivent exister dans la boîte aux lettres pour être colorées).

procedure SetCategories(NewCategories: List of [Text])

Parameters

Name	Type	Description
NewCategories	List of [Text]

GetCategories

procedure GetCategories(): List of [Text]

Returns

Type	Description
List of [Text]

SetTransactionId

Identifiant fourni par l'appelant, pris en compte uniquement à la création : si une création est relancée (délai dépassé, tâche rejouée...) avec le même identifiant, Outlook ne crée pas de doublon.

procedure SetTransactionId(NewTransactionId: Text)

Parameters

Name	Type	Description
NewTransactionId	Text	Valeur unique et stable pour l'enregistrement BC d'origine (ex. un GUID stocké).

SetProperty

Définit une propriété Graph de l'événement non exposée par ce codeunit (ex. « importance », « sensitivity »).

procedure SetProperty(Name: Text; Value: JsonToken)

Parameters

Name	Type	Description
Name	Text	Nom de la propriété Graph.
Value	JsonToken	Valeur JSON de la propriété.

GetProperty

Renvoie une propriété Graph de l'événement, telle que modifiée ou, à défaut, telle que lue.

procedure GetProperty(Name: Text; var Value: JsonToken): Boolean

Parameters

Name	Type	Description
Name	Text
Value	JsonToken

Returns

Type	Description
Boolean	false si la propriété est absente ou nulle.

SetPeriod

Définit un événement à heures fixes.

procedure SetPeriod(StartDateTime: DateTime; EndDateTime: DateTime)

Parameters

Name	Type	Description
StartDateTime	DateTime
EndDateTime	DateTime

SetAllDayPeriod

Définit un événement sur une ou plusieurs journées entières.

procedure SetAllDayPeriod(StartDate: Date; EndDate: Date; TimeZone: Text)

Parameters

Name	Type	Description
StartDate	Date	Premier jour.
EndDate	Date	Dernier jour inclus.
TimeZone	Text	Fuseau des journées, au format Windows (ex. « Romance Standard Time ») ou IANA (ex. « Europe/Paris »). Doit être celui des utilisateurs : une journée entière en UTC s'affiche à cheval sur deux jours en France.

IsAllDay

procedure IsAllDay(): Boolean

Returns

Type	Description
Boolean

GetStartDateTime

Début de l'événement. Pour un événement sur la journée, utiliser plutôt .

procedure GetStartDateTime(): DateTime

Returns

Type	Description
DateTime

GetEndDateTime

Fin de l'événement. Pour un événement sur la journée, utiliser plutôt .

procedure GetEndDateTime(): DateTime

Returns

Type	Description
DateTime

GetStartDate

Premier jour de l'événement (dans le fuseau de la session pour un événement à heures fixes).

procedure GetStartDate(): Date

Returns

Type	Description
Date

GetEndDate

Dernier jour inclus de l'événement (dans le fuseau de la session pour un événement à heures fixes).

procedure GetEndDate(): Date

Returns

Type	Description
Date

AddAttendee

Invite un participant obligatoire. L'invitation lui est envoyée à l'enregistrement de l'événement.

procedure AddAttendee(Email: Text): Boolean

Parameters

Name	Type	Description
Email	Text

Returns

Type	Description
Boolean	false si l'adresse était déjà invitée.

AddAttendee

Invite un participant. L'invitation lui est envoyée à l'enregistrement de l'événement.

procedure AddAttendee(Email: Text; DisplayName: Text; AttendeeType: Enum "Outlook Attendee Type UTCAP"): Boolean

Parameters

Name	Type	Description
Email	Text	Adresse e-mail du participant (ou de la boîte aux lettres d'une ressource).
DisplayName	Text	Nom affiché. Vide : résolu par Outlook.
AttendeeType	Enum CapVision.Core.Graph."Outlook Attendee Type UTCAP"	Type de participant.

Returns

Type	Description
Boolean	false si l'adresse était déjà invitée (son type n'est alors pas modifié).

RemoveAttendee

Retire un participant. Une annulation lui est envoyée à l'enregistrement de l'événement.

procedure RemoveAttendee(Email: Text): Boolean

Parameters

Name	Type	Description
Email	Text

Returns

Type	Description
Boolean	false si l'adresse n'était pas invitée.

ClearAttendees

Retire tous les participants.

procedure ClearAttendees()

HasAttendee

procedure HasAttendee(Email: Text): Boolean

Parameters

Name	Type	Description
Email	Text

Returns

Type	Description
Boolean

GetAttendeeCount

procedure GetAttendeeCount(): Integer

Returns

Type	Description
Integer

GetAttendee

Renvoie un participant.

procedure GetAttendee(Index: Integer; var Email: Text; var DisplayName: Text; var AttendeeType: Enum "Outlook Attendee Type UTCAP"; var ResponseStatus: Text)

Parameters

Name	Type	Description
Index	Integer	Position du participant, de 1 à .
Email	Text	Adresse e-mail du participant.
DisplayName	Text	Nom affiché.
AttendeeType	Enum CapVision.Core.Graph."Outlook Attendee Type UTCAP"	Type de participant.
ResponseStatus	Text	Réponse connue à la dernière lecture : none, organizer, tentativelyAccepted, accepted, declined, notResponded. Vide pour un participant ajouté depuis.

LoadFromJson

Charge un événement tel que renvoyé par Graph (ex. un élément de "Outlook Calendar UTCAP".GetEvents). Les modifications en attente sont abandonnées.

procedure LoadFromJson(EventJson: JsonObject)

Parameters

Name	Type	Description
EventJson	JsonObject

GetJson

Renvoie l'événement tel que connu côté Outlook à la dernière lecture ou écriture, sans les modifications en attente.

procedure GetJson(): JsonObject

Returns

Type	Description
JsonObject

See also

• Codeunit