Office.Sensitivity interface
Fournit des méthodes pour obtenir et définir le niveau de confidentialité d’un rendez-vous. Pour en savoir plus sur les niveaux de confidentialité, consultez Marquer votre courrier comme normal, personnel, privé ou confidentiel.
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Composer
Méthodes
get |
Obtient le niveau de sensibilité d’un rendez-vous. |
get |
Obtient le niveau de sensibilité d’un rendez-vous. |
set |
Définit le niveau de sensibilité d’un rendez-vous. |
set |
Définit le niveau de sensibilité d’un rendez-vous. |
Détails de la méthode
getAsync(options, callback)
Obtient le niveau de sensibilité d’un rendez-vous.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;
Paramètres
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<Office.MailboxEnums.AppointmentSensitivityType>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . Le niveau de sensibilité du rendez-vous est retourné dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Composer
Important : Outlook sur le web, outlook sur Windows et Outlook sur Mac prennent uniquement en charge les niveaux de confidentialité Normal et Privé. Si vous appelez getAsync
sur un rendez-vous qui a un niveau de confidentialité Confidentiel ou Personnel de ces clients, le niveau de confidentialité Normal est retourné dans la asyncResult.value
propriété .
getAsync(callback)
Obtient le niveau de sensibilité d’un rendez-vous.
getAsync(callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;
Paramètres
- callback
-
(asyncResult: Office.AsyncResult<Office.MailboxEnums.AppointmentSensitivityType>) => void
Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet . Le niveau de sensibilité du rendez-vous est retourné dans la asyncResult.value
propriété .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Composer
Important : Outlook sur le web, outlook sur Windows et Outlook sur Mac prennent uniquement en charge les niveaux de confidentialité Normal et Privé. Si vous appelez getAsync
sur un rendez-vous qui a un niveau de confidentialité Confidentiel ou Personnel de ces clients, le niveau de confidentialité Normal est retourné dans la asyncResult.value
propriété .
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-sensitivity-level.yaml
Office.context.mailbox.item.sensitivity.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Sensitivity: " + asyncResult.value);
} else {
console.log("Failed to get sensitivity: " + JSON.stringify(asyncResult.error));
}
});
setAsync(sensitivity, options, callback)
Définit le niveau de sensibilité d’un rendez-vous.
setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Paramètres
- sensitivity
Niveau de sensibilité sous forme d’énumération ou de chaîne.
- options
- Office.AsyncContextOptions
Littéral d’objet qui contient une ou plusieurs des propriétés suivantes : les asyncContext
développeurs peuvent fournir n’importe quel objet auquel ils souhaitent accéder dans la fonction de rappel.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : Composer
Important : Outlook sur le web, outlook sur Windows et Outlook sur Mac prennent uniquement en charge les niveaux de confidentialité Normal et Privé.
Erreurs :
-
Unsupported API parameter
: la définition du niveau de confidentialité d’un rendez-vous n’est pas prise en charge.
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-sensitivity-level.yaml
Office.context.mailbox.item.sensitivity.setAsync(
Office.MailboxEnums.AppointmentSensitivityType.Private,
function callback(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log("Failed to set appointment sensitivity: " + JSON.stringify(asyncResult.error));
} else {
console.log("Successfully set appointment sensitivity.");
}
}
);
setAsync(sensitivity, callback)
Définit le niveau de sensibilité d’un rendez-vous.
setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Paramètres
- sensitivity
Niveau de sensibilité sous forme d’énumération ou de chaîne.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Une fois la méthode terminée, la fonction passée dans le callback
paramètre est appelée avec un seul paramètre, asyncResult
, qui est un Office.AsyncResult
objet .
Retours
void
Remarques
[ Ensemble d’API : Boîte aux lettres 1.14 ]
Niveau d’autorisation minimal : élément en lecture/écriture
Mode Outlook applicable : Composer
Important : Outlook sur le web, outlook sur Windows et Outlook sur Mac prennent uniquement en charge les niveaux de confidentialité Normal et Privé.
Erreurs :
-
Unsupported API parameter
: la définition du niveau de confidentialité d’un rendez-vous n’est pas prise en charge.