Office.AppointmentForm interface
L’objet AppointmentForm est utilisé pour accéder au rendez-vous actuellement sélectionné.
Remarques
Niveau d’autorisation minimal : restreint
Mode Outlook applicable : Rédiger ou Lire
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/55-display-items/display-new-appointment.yaml
const start = new Date();
const end = new Date();
end.setHours(start.getHours() + 1);
// The async version is only available starting with requirement set 1.9,
// and provides a callback when the new appointment form has been created.
Office.context.mailbox.displayNewAppointmentFormAsync(
{
requiredAttendees: ["bob@contoso.com"],
optionalAttendees: ["sam@contoso.com"],
start: start,
end: end,
location: "Home",
subject: "meeting",
resources: ["projector@contoso.com"],
body: "Hello World!"
},
function(asyncResult) {
console.log(JSON.stringify(asyncResult));
}
);
Propriétés
| body | Obtient un objet qui fournit des méthodes permettant de manipuler le corps d’un élément. |
| end | Obtient ou définit la date et l’heure de fin du rendez-vous. La propriété Mode lecture La propriété Mode composition La propriété Quand vous utilisez la méthode |
| location | Obtient ou définit le lieu d’un rendez-vous. Mode lecture La propriété Mode composition La propriété |
| optional |
Permet d’accéder aux participants facultatifs d’un événement. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif. Mode lecture La
Mode composition La propriété |
| required |
Permet d’accéder aux participants requis à un événement. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif. Mode lecture La
Mode composition La propriété |
| resources | Fournit l’accès aux ressources d’un événement. Retourne un tableau de chaînes contenant les ressources requises pour le rendez-vous. |
| start | Obtient ou définit la date et l’heure de début du rendez-vous. La propriété Mode lecture La propriété Mode composition La propriété Quand vous utilisez la méthode |
| subject | Obtient ou définit la description qui apparaît dans le champ d’objet d’un élément. La propriété Mode lecture La propriété Mode composition La propriété |
Détails de la propriété
body
Obtient un objet qui fournit des méthodes permettant de manipuler le corps d’un élément.
body: Body | string;Valeur de propriété
Office.Body | string
Remarques
[ Ensemble d’API : Boîte aux lettres 1.1 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
end
Obtient ou définit la date et l’heure de fin du rendez-vous.
La propriété end est exprimée en date et heure UTC (temps universel coordonné). Vous pouvez utiliser la convertToLocalClientTime méthode pour convertir la valeur de la end propriété en date et heure locales du client.
Mode lecture
La propriété end renvoie un objet Date.
Mode composition
La propriété end renvoie un objet Time.
Quand vous utilisez la méthode Time.setAsync pour définir l’heure de fin, nous vous recommandons d’utiliser la méthode convertToUtcClientTime pour convertir l’heure locale du client au format UTC pour le serveur.
end: Time | Date;Valeur de propriété
Office.Time | Date
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
location
Obtient ou définit le lieu d’un rendez-vous.
Mode lecture
La propriété location renvoie une chaîne contenant le lieu du rendez-vous.
Mode composition
La propriété location renvoie un objet Location qui fournit les méthodes utilisées pour obtenir et définir le lieu du rendez-vous.
location: Location | string;Valeur de propriété
Office.Location | string
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
optionalAttendees
Permet d’accéder aux participants facultatifs d’un événement. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif.
Mode lecture
La optionalAttendees propriété renvoie un tableau qui contient un objet EmailAddressDetails pour chaque participant facultatif à la réunion. Limites de taille de la collection :
Navigateur web, nouvelle interface utilisateur Mac, Android : aucune limite
Windows (nouveau et classique) : 500 membres
Windows (classique - en préversion à partir de la version 2511 (build 19426.20000)) : 1 000 membres
Interface utilisateur Mac classique : 100 membres
Mode composition
La propriété optionalAttendees renvoie un objet Recipients qui fournit des méthodes permettant d’obtenir ou de mettre à jour les participants facultatifs d’une réunion. Toutefois, en fonction du client/plateforme (par exemple, Windows, Mac, etc.), des limites peuvent s’appliquer au nombre de destinataires que vous pouvez obtenir ou mettre à jour. Pour plus d’informations, consultez l’objet Recipients .
optionalAttendees: Recipients[] | EmailAddressDetails[];Valeur de propriété
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
requiredAttendees
Permet d’accéder aux participants requis à un événement. Le type d’objet et le niveau d’accès dépendent du mode de l’élément actif.
Mode lecture
La requiredAttendees propriété renvoie un tableau qui contient un objet EmailAddressDetails pour chaque participant requis à la réunion. Limites de taille de la collection :
Navigateur web, nouvelle interface utilisateur Mac, Android : aucune limite
Windows : 500 membres
Windows (classique - en préversion à partir de la version 2511 (build 19426.20000)) : 1 000 membres
Interface utilisateur Mac classique : 100 membres
Mode composition
La propriété requiredAttendees renvoie un objet Recipients qui fournit des méthodes permettant d’obtenir ou de mettre à jour les participants requis à une réunion. Toutefois, en fonction du client/plateforme (par exemple, Windows, Mac, etc.), des limites peuvent s’appliquer au nombre de destinataires que vous pouvez obtenir ou mettre à jour. Pour plus d’informations, consultez l’objet Recipients .
requiredAttendees: Recipients[] | EmailAddressDetails[];Valeur de propriété
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
resources
Fournit l’accès aux ressources d’un événement. Retourne un tableau de chaînes contenant les ressources requises pour le rendez-vous.
resources: string[];Valeur de propriété
string[]
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
start
Obtient ou définit la date et l’heure de début du rendez-vous.
La propriété start est exprimée en date et heure UTC (temps universel coordonné). Vous pouvez utiliser la convertToLocalClientTime méthode pour convertir la valeur en date et heure locales du client.
Mode lecture
La propriété start renvoie un objet Date.
Mode composition
La propriété start renvoie un objet Time.
Quand vous utilisez la méthode Time.setAsync pour définir l’heure de début, nous vous recommandons d’utiliser la méthode convertToUtcClientTime pour convertir l’heure locale du client au format UTC pour le serveur.
start: Time | Date;Valeur de propriété
Office.Time | Date
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
subject
Obtient ou définit la description qui apparaît dans le champ d’objet d’un élément.
La propriété subject obtient ou définit l’intégralité de l’objet de l’élément, tel qu’il est envoyé par le serveur de messagerie.
Mode lecture
La propriété subject renvoie une chaîne. Utilisez la normalizedSubject propriété pour obtenir l’objet moins les préfixes de début tels que RE : et FW :.
Mode composition
La propriété subject renvoie un objet Subject qui fournit des méthodes pour obtenir et définir l’objet.
subject: Subject | string;Valeur de propriété
Office.Subject | string
Remarques
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire