Office.AppointmentRead interface

Referencia

Paquete:: outlook

Modo de asistente de cita de Office.context.mailbox.item.

Importante: se trata de un objeto interno de Outlook, no expuesto directamente a través de interfaces existentes. Debe tratar esto como un modo de Office.context.mailbox.item. Para obtener más información, consulte la página Modelo de objetos.

Interfaces primarias:

Extends: Office.Appointment

Propiedades

attachments	Obtiene los datos adjuntos del elemento como una matriz.
body	Obtiene un objeto que proporciona métodos para manipular el cuerpo de un elemento.
dateTimeCreated	Obtiene la fecha y hora de creación de un elemento.
dateTimeModified	Obtiene la fecha y hora en que se modificó por última vez un elemento.
end	Obtiene la fecha y hora de finalización de la cita. La `end` propiedad es un `Date` objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el `convertToLocalClientTime` método para convertir el valor de propiedad `end` en la fecha y hora locales del cliente. Si usa el método `Time.setAsync` para establecer la hora de finalización, use el método `convertToUtcClientTime` para convertir la hora local del cliente en un valor UTC para el servidor.
itemClass	Obtiene la clase de elemento servicios web de Exchange de la cita seleccionada. Devuelve `IPM.Appointment` para citas no periódicas y `IPM.Appointment.Occurrence` para citas periódicas.
itemId	Obtiene el identificador de elemento de Exchange Web Services (EWS) del elemento actual.
itemType	Obtiene el tipo de elemento que representa una instancia. La `itemType` propiedad devuelve uno de los `ItemType` valores de enumeración, que indica si la instancia del objeto item es un mensaje o una cita.
location	Obtiene la ubicación de una cita. La propiedad `location` devuelve una cadena que contiene la ubicación de la cita.
normalizedSubject	Obtiene el asunto de un elemento, con todos los prefijos quitados (incluidos RE: y FWD:). La `normalizedSubject` propiedad obtiene el asunto del elemento, con los prefijos estándar (como RE: y FW:) que se agregan mediante los programas de correo electrónico. Para obtener el asunto del elemento con los prefijos intactos, use la propiedad `subject`.
optionalAttendees	Proporciona acceso a los asistentes opcionales de un evento. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual. La `optionalAttendees` propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada asistente opcional a la reunión. El número máximo de asistentes devueltos varía según el cliente de Outlook. Windows: 500 asistentes Android, interfaz de usuario clásica de Mac, iOS: 100 asistentes Nueva interfaz de usuario de Mac, explorador web: sin límite
organizer	Obtiene las propiedades de correo electrónico del organizador de la reunión.
requiredAttendees	Proporciona acceso a los asistentes necesarios de un evento. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual. La `requiredAttendees` propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada asistente necesario a la reunión. El número máximo de asistentes devueltos varía según el cliente de Outlook. Windows: 500 asistentes Android, interfaz de usuario clásica de Mac, iOS: 100 asistentes Nueva interfaz de usuario de Mac, explorador web: sin límite
start	Obtiene la fecha y hora en que se va a comenzar la cita. La `start` propiedad es un `Date` objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el `convertToLocalClientTime` método para convertir el valor en la fecha y hora locales del cliente.
subject	Obtiene la descripción que aparece en el campo asunto de un elemento. La propiedad `subject` obtiene o establece el asunto completo del elemento, como lo ha enviado el servidor de correo electrónico. La propiedad `subject` devuelve una cadena. Use la `normalizedSubject` propiedad para obtener el asunto menos los prefijos iniciales, como RE: y FW:.

Métodos

displayReplyAllForm(formData)	Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.
displayReplyForm(formData)	Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.
getEntities()	Obtiene las entidades que obtenidas en el cuerpo del elemento seleccionado. Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.
getEntitiesByType(entityType)	Obtiene una matriz de todas las entidades del tipo de entidad especificado encontrado en el cuerpo del elemento seleccionado. Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.
getFilteredEntitiesByName(name)	Devuelve entidades conocidas en el elemento seleccionado que pasan el filtro con nombre definido en un archivo de manifiesto de solo complemento. Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.
getRegExMatches()	Devuelve los valores de cadena del elemento seleccionado que coinciden con las expresiones regulares definidas en un archivo de manifiesto de solo complemento.
getRegExMatchesByName(name)	Devuelve los valores de cadena del elemento seleccionado que coinciden con la expresión regular con nombre definida en un archivo de manifiesto de solo complemento.
loadCustomPropertiesAsync(callback, userContext)	Carga de forma asincrónica las propiedades personalizadas de este complemento en el elemento seleccionado. Las propiedades personalizadas se almacenan como pares clave-valor por aplicación y por elemento. Este método devuelve un objeto CustomProperties en la devolución de llamada, que proporciona métodos para acceder a las propiedades personalizadas específicas del elemento actual y del complemento actual. Las propiedades personalizadas no se cifran en el elemento, por lo que no se debe usar como almacenamiento seguro. Las propiedades personalizadas se proporcionan como un objeto `CustomProperties` en la propiedad `asyncResult.value`. Este objeto se puede usar para obtener, establecer, guardar y quitar propiedades personalizadas del elemento de correo.

Detalles de las propiedades

attachments

Obtiene los datos adjuntos del elemento como una matriz.

attachments: AttachmentDetails[];

Valor de propiedad

Office.AttachmentDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Nota: Outlook bloquea determinados tipos de archivos debido a posibles problemas de seguridad y, por lo tanto, no se devuelven. Para obtener más información, vea Archivos adjuntos bloqueados en Outlook.

Ejemplos

// The following code builds an HTML string with details of all attachments on the current item.
const item = Office.context.mailbox.item;
let outputString = "";

if (item.attachments.length > 0) {
    for (let i = 0 ; i < item.attachments.length ; i++) {
        const attachment = item.attachments[i];
        outputString += "<BR>" + i + ". Name: ";
        outputString += attachment.name;
        outputString += "<BR>ID: " + attachment.id;
        outputString += "<BR>contentType: " + attachment.contentType;
        outputString += "<BR>size: " + attachment.size;
        outputString += "<BR>attachmentType: " + attachment.attachmentType;
        outputString += "<BR>isInline: " + attachment.isInline;
    }
}

console.log(outputString);

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/get-attachments-read.yaml

const attachments = Office.context.mailbox.item.attachments;
console.log(attachments);

body

Obtiene un objeto que proporciona métodos para manipular el cuerpo de un elemento.

body: Body;

Valor de propiedad

Office.Body

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// This example gets the body of the item as plain text.
Office.context.mailbox.item.body.getAsync(
    Office.CoercionType.Text,
    { asyncContext: "This is passed to the callback" },
    (result) => {
        // Do something with the result.
    }
);

// The following is an example of the result parameter passed to the callback function.
{
    "value": "TEXT of whole body (including message threads that appear below the current body)",
    "status": "succeeded",
    "asyncContext": "This is passed to the callback"
}

dateTimeCreated

Obtiene la fecha y hora de creación de un elemento.

dateTimeCreated: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-date-time-created-read.yaml

console.log(`Creation date and time: ${Office.context.mailbox.item.dateTimeCreated}`);

dateTimeModified

Obtiene la fecha y hora en que se modificó por última vez un elemento.

dateTimeModified: Date;

Valor de propiedad

Date

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante: Esta propiedad no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-date-time-modified-read.yaml

console.log(`Date and time item last modified: ${Office.context.mailbox.item.dateTimeModified}`);

end

Obtiene la fecha y hora de finalización de la cita.

La end propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor de propiedad end en la fecha y hora locales del cliente.

Si usa el método Time.setAsync para establecer la hora de finalización, use el método convertToUtcClientTime para convertir la hora local del cliente en un valor UTC para el servidor.

end: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-end-read.yaml

console.log(`Appointment ends: ${Office.context.mailbox.item.end}`);

itemClass

Obtiene la clase de elemento servicios web de Exchange de la cita seleccionada.

Devuelve IPM.Appointment para citas no periódicas y IPM.Appointment.Occurrence para citas periódicas.

itemClass: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante: Puede crear clases personalizadas que amplíen una clase de elemento predeterminada. Por ejemplo, IPM.Appointment.Contoso.

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-item-class-read.yaml

console.log(`Item class: ${Office.context.mailbox.item.itemClass}`);

itemId

Obtiene el identificador de elemento de Exchange Web Services (EWS) del elemento actual.

itemId: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

La itemId propiedad no está disponible en modo de redacción. Si se requiere un identificador de elemento, el método Office.context.mailbox.item.saveAsync puede usarse para guardar el elemento en el servidor, que devolverá el identificador de elemento en el parámetro asyncResult.value de la función de devolución de llamada. Si el elemento ya está guardado, puede llamar al Office.context.mailbox.item.getItemIdAsync método en su lugar.
El identificador de elemento devuelto no es idéntico al identificador de entrada de Outlook o al identificador que usa la API REST de Outlook. Antes de realizar llamadas a la API REST con este valor, debe convertirse mediante Office.context.mailbox.convertToRestId.

Ejemplos

// The following code checks for the presence of an item
// identifier. If the `itemId` property returns `null` or
// `undefined`, it saves the item to the store and gets the
// item identifier from the asynchronous result.
// **Important**: `saveAsync` was introduced with requirement set 1.3
// so you can't get the `itemId` in Compose mode in earlier sets.
let itemId = Office.context.mailbox.item.itemId;
if (itemId === null || itemId == undefined) {
    Office.context.mailbox.item.saveAsync(function(result) {
        itemId = result.value;
    });
}

itemType

Obtiene el tipo de elemento que representa una instancia.

La itemType propiedad devuelve uno de los ItemType valores de enumeración, que indica si la instancia del objeto item es un mensaje o una cita.

itemType: MailboxEnums.ItemType | string;

Valor de propiedad

Office.MailboxEnums.ItemType | string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-item-type.yaml

const itemType = Office.context.mailbox.item.itemType;
switch (itemType) {
    case Office.MailboxEnums.ItemType.Appointment:
        console.log(`Current item is an ${itemType}.`);
        break;
    case Office.MailboxEnums.ItemType.Message:
        console.log(`Current item is a ${itemType}. A message could be an email, meeting request, meeting response, or meeting cancellation.`);
        break;
}

location

Obtiene la ubicación de una cita.

La propiedad location devuelve una cadena que contiene la ubicación de la cita.

location: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

const location = Office.context.mailbox.item.location;
console.log("location: " + location);

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-location-read.yaml

console.log(`Appointment location: ${Office.context.mailbox.item.location}`);

normalizedSubject

Obtiene el asunto de un elemento, con todos los prefijos quitados (incluidos RE: y FWD:).

La normalizedSubject propiedad obtiene el asunto del elemento, con los prefijos estándar (como RE: y FW:) que se agregan mediante los programas de correo electrónico. Para obtener el asunto del elemento con los prefijos intactos, use la propiedad subject.

normalizedSubject: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-normalized-subject-read.yaml

console.log(`Normalized subject: ${Office.context.mailbox.item.normalizedSubject}`);

optionalAttendees

Proporciona acceso a los asistentes opcionales de un evento. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual.

La optionalAttendees propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada asistente opcional a la reunión. El número máximo de asistentes devueltos varía según el cliente de Outlook.

Windows: 500 asistentes
Android, interfaz de usuario clásica de Mac, iOS: 100 asistentes
Nueva interfaz de usuario de Mac, explorador web: sin límite

optionalAttendees: EmailAddressDetails[];

Valor de propiedad

Office.EmailAddressDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-optional-attendees-appointment-attendee.yaml

const apptOptionalAttendees = Office.context.mailbox.item.optionalAttendees;
console.log("Optional attendees:");
for (let i = 0; i < apptOptionalAttendees.length; i++) {
  console.log(
    apptOptionalAttendees[i].displayName +
      " (" +
      apptOptionalAttendees[i].emailAddress +
      ") - response: " +
      apptOptionalAttendees[i].appointmentResponse
  );
}

organizer

Obtiene las propiedades de correo electrónico del organizador de la reunión.

organizer: EmailAddressDetails;

Valor de propiedad

Office.EmailAddressDetails

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-organizer-appointment-attendee.yaml

const apptOrganizer = Office.context.mailbox.item.organizer;
console.log("Organizer: " + apptOrganizer.displayName + " (" + apptOrganizer.emailAddress + ")");

requiredAttendees

Proporciona acceso a los asistentes necesarios de un evento. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual.

La requiredAttendees propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada asistente necesario a la reunión. El número máximo de asistentes devueltos varía según el cliente de Outlook.

Windows: 500 asistentes
Android, interfaz de usuario clásica de Mac, iOS: 100 asistentes
Nueva interfaz de usuario de Mac, explorador web: sin límite

requiredAttendees: EmailAddressDetails[];

Valor de propiedad

Office.EmailAddressDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante: en Outlook en la Web y en Windows (nuevo y clásico), el organizador de citas se incluye en el objeto devuelto por la requiredAttendees propiedad .

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-required-attendees-appointment-attendee.yaml

const apptRequiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("Required attendees:");
for (let i = 0; i < apptRequiredAttendees.length; i++) {
  console.log(
    apptRequiredAttendees[i].displayName +
      " (" +
      apptRequiredAttendees[i].emailAddress +
      ") - response: " +
      apptRequiredAttendees[i].appointmentResponse
  );
}

start

Obtiene la fecha y hora en que se va a comenzar la cita.

La start propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor en la fecha y hora locales del cliente.

start: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-start-read.yaml

console.log(`Appointment starts: ${Office.context.mailbox.item.start}`);

subject

Obtiene la descripción que aparece en el campo asunto de un elemento.

La propiedad subject obtiene o establece el asunto completo del elemento, como lo ha enviado el servidor de correo electrónico.

La propiedad subject devuelve una cadena. Use la normalizedSubject propiedad para obtener el asunto menos los prefijos iniciales, como RE: y FW:.

subject: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-subject-read.yaml

console.log(`Subject: ${Office.context.mailbox.item.subject}`);

Detalles del método

displayReplyAllForm(formData)

Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.

displayReplyAllForm(formData: string | ReplyFormData): void;

Parámetros

formData: string | Office.ReplyFormData

Una cadena que contiene texto y HTML y que representa el cuerpo del formulario de respuestas. La cadena está limitada a 32 KB o a un objeto ReplyFormData que contiene datos de cuerpo o datos adjuntos y una función de devolución de llamada.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

En Outlook en la Web, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o de 1 columna.
Si cualquiera de los parámetros de cadena supera sus límites, displayReplyForm produce una excepción.
Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.
Este método no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Ejemplos

// The following code passes a string to the `displayReplyAllForm` method.
Office.context.mailbox.item.displayReplyAllForm('hello there');
Office.context.mailbox.item.displayReplyAllForm('<b>hello there</b>');

// Reply with an empty body.
Office.context.mailbox.item.displayReplyAllForm({});

// Reply with just a body.
Office.context.mailbox.item.displayReplyAllForm(
{
'htmlBody' : 'hi'
});

// Reply with a body and a file attachment.
Office.context.mailbox.item.displayReplyAllForm(
{
    'htmlBody' : 'hi',
    'attachments' :
    [
        {
        'type' : Office.MailboxEnums.AttachmentType.File,
        'name' : 'squirrel.png',
        'url' : 'http://i.imgur.com/sRgTlGR.jpg'
        }
    ]
});

// Reply with a body and an item attachment.
Office.context.mailbox.item.displayReplyAllForm(
{
    'htmlBody' : 'hi',
    'attachments' :
    [
        {
        'type' : 'item',
        'name' : 'rand',
        'itemId' : Office.context.mailbox.item.itemId
        }
    ]
});

// Reply with a body, file attachment, item attachment, and a callback.
Office.context.mailbox.item.displayReplyAllForm(
{
    'htmlBody' : 'hi',
    'attachments' :
    [
        {
            'type' : Office.MailboxEnums.AttachmentType.File,
            'name' : 'squirrel.png',
            'url' : 'http://i.imgur.com/sRgTlGR.jpg'
        },
        {
            'type' : 'item',
            'name' : 'rand',
            'itemId' : Office.context.mailbox.item.itemId
        }
    ],
    'callback' : function(asyncResult)
    {
        console.log(asyncResult.value);
    }
});

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/55-display-items/display-reply-forms.yaml

Office.context.mailbox.item.displayReplyAllForm("This is a reply ALL with <b>some bold text</b>.");

displayReplyForm(formData)

Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.

displayReplyForm(formData: string | ReplyFormData): void;

Parámetros

formData: string | Office.ReplyFormData

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

En Outlook en la Web y nueva Outlook en Windows, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o 1 columna.
Si cualquiera de los parámetros de cadena supera sus límites, displayReplyForm produce una excepción.
Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.
Este método no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/55-display-items/display-reply-forms.yaml

Office.context.mailbox.item.displayReplyForm("This is a reply with <i>some text in italics</i>.");

...

Office.context.mailbox.item.displayReplyForm({
  htmlBody: "This is a reply with an inline image and an item attachment.<br><img src='cid:dog.jpg'>",
  attachments: [
    { type: "file", url: "https://i.imgur.com/9S36xvA.jpg", name: "dog.jpg", inLine: true },
    { type: "item", itemId: Office.context.mailbox.item.itemId, name: "test_email.msg" }
  ],
  callback: (result) => {
    if (result.status === Office.AsyncResultStatus.Failed) {
      console.error(`Action failed with message ${result.error.message}`);
      return;
    }

    console.log("Created reply with attachments.");
  }
});

getEntities()

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

Obtiene las entidades que obtenidas en el cuerpo del elemento seleccionado.

Advertencia: Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.

getEntities(): Entities;

Devoluciones

Office.Entities

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

getEntitiesByType(entityType)

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

Obtiene una matriz de todas las entidades del tipo de entidad especificado encontrado en el cuerpo del elemento seleccionado.

getEntitiesByType(entityType: MailboxEnums.EntityType | string): Array<string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion>;

Parámetros

entityType: Office.MailboxEnums.EntityType | string

Uno de los EntityType valores de enumeración.

Devoluciones

Array<string | Office.Contact | Office.MeetingSuggestion | Office.PhoneNumber | Office.TaskSuggestion>

Si el valor que se pasa a entityType no es un miembro válido de la enumeración de EntityType, el método devuelve un valor NULL. Si no hay presente ninguna entidad del tipo especificado en el cuerpo del elemento, el método devuelve una matriz vacía. De lo contrario, el tipo de los objetos en la matriz devuelta depende del tipo de entidad solicitada en el parámetro entityType.

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: restringido

Modo de Outlook aplicable: Asistente de cita

getFilteredEntitiesByName(name)

Advertencia

Esta API ya está en desuso.

Use regular expression rules instead.

Devuelve entidades conocidas en el elemento seleccionado que pasan el filtro con nombre definido en un archivo de manifiesto de solo complemento.

getFilteredEntitiesByName(name: string): Array<string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion>;

Parámetros

name: string

El nombre del elemento de regla ItemHasKnownEntity que define el filtro para que coincidan.

Devoluciones

Array<string | Office.Contact | Office.MeetingSuggestion | Office.PhoneNumber | Office.TaskSuggestion>

Entidades que coinciden con la expresión regular definida en el ItemHasKnownEntity elemento rule del archivo de manifiesto del complemento con el valor de elemento especificado FilterName . Si no hay ningún ItemHasKnownEntity elemento en el manifiesto con un FilterName valor de elemento que coincida con el name parámetro , el método devuelve null. Si el name parámetro coincide con un ItemHasKnownEntity elemento del manifiesto, pero no hay ninguna entidad en el elemento actual que coincida, el método devuelve una matriz vacía.

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

getRegExMatches()

Devuelve los valores de cadena del elemento seleccionado que coinciden con las expresiones regulares definidas en un archivo de manifiesto de solo complemento.

getRegExMatches(): any;

Devoluciones

any

Objeto que contiene matrices de cadenas que coinciden con las expresiones regulares definidas en el archivo de manifiesto del complemento. El nombre de cada matriz es igual al valor correspondiente del atributo RegExName de la regla coincidente ItemHasRegularExpressionMatch . Para una ItemHasRegularExpressionMatch regla, debe producirse una cadena coincidente en la propiedad del elemento especificado por esa regla. El tipo simple PropertyName define las propiedades admitidas.

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.
Este método se usa con la característica de reglas de activación para complementos de Outlook, que no es compatible con el manifiesto unificado para Microsoft 365.
Si especifica una ItemHasRegularExpressionMatch regla en la propiedad body de un elemento, la expresión regular debe filtrar aún más el cuerpo y no debe intentar devolver todo el cuerpo del elemento. El uso de una expresión regular como .* para obtener todo el cuerpo de un elemento no siempre devuelve los resultados esperados. En su lugar, use el método Body.getAsync para recuperar todo el cuerpo.
Este método no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Ejemplos

// Consider an add-in manifest has the following `Rule` element:
//<Rule xsi:type="RuleCollection" Mode="And">
//  <Rule xsi:type="ItemIs" FormType="Read" ItemType="Message" />
//  <Rule xsi:type="RuleCollection" Mode="Or">
//    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="fruits" RegExValue="apple|banana|coconut" PropertyName="BodyAsPlaintext" IgnoreCase="true" />
//    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="veggies" RegExValue="tomato|onion|spinach|broccoli" PropertyName="BodyAsPlaintext" IgnoreCase="true" />
//  </Rule>
//</Rule>

// The object returned from `getRegExMatches` would have two properties: `fruits` and `veggies`.
//{
//'fruits': ['apple','banana','Banana','coconut'],
//'veggies': ['tomato','onion','spinach','broccoli']
//}

// The following example shows how to access the array of
// matches for the regular expression rule elements `fruits`
// and `veggies`, which are specified in the manifest.
const allMatches = Office.context.mailbox.item.getRegExMatches();
const fruits = allMatches.fruits;
const veggies = allMatches.veggies;

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/75-regex-matches/contextual.yaml

// This API only works when you click on the highlighted word "ScriptLab".
console.log(Office.context.mailbox.item.getRegExMatches());

getRegExMatchesByName(name)

Devuelve los valores de cadena del elemento seleccionado que coinciden con la expresión regular con nombre definida en un archivo de manifiesto de solo complemento.

getRegExMatchesByName(name: string): string[];

Parámetros

name: string

El nombre del elemento de regla ItemHasRegularExpressionMatch que define el filtro para que coincidan.

Devoluciones

string[]

Matriz que contiene las cadenas que coinciden con la expresión regular definida en el ItemHasRegularExpressionMatch elemento rule del archivo de manifiesto del complemento, con el valor de elemento especificado RegExName .

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.
Este método se usa con la característica de reglas de activación para complementos de Outlook, que no es compatible con el manifiesto unificado para Microsoft 365.
Si especifica una ItemHasRegularExpressionMatch regla en la propiedad body de un elemento, la expresión regular debe filtrar aún más el cuerpo y no debe intentar devolver todo el cuerpo del elemento. El uso de una expresión regular como .* para obtener todo el cuerpo de un elemento no siempre devuelve los resultados esperados. En su lugar, use el método Body.getAsync para recuperar todo el cuerpo.
Este método no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Ejemplos

// Consider an add-in manifest has the following `Rule` element:
//<Rule xsi:type="RuleCollection" Mode="And">
//  <Rule xsi:type="ItemIs" FormType="Read" ItemType="Message" />
//  <Rule xsi:type="RuleCollection" Mode="Or">
//    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="fruits" RegExValue="apple|banana|coconut" PropertyName="BodyAsPlaintext" IgnoreCase="true" />
//    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="veggies" RegExValue="tomato|onion|spinach|broccoli" PropertyName="BodyAsPlaintext" IgnoreCase="true" />
//  </Rule>
//</Rule>

// The object returned from `getRegExMatches` would have two properties: `fruits` and `veggies`.
//{
//'fruits': ['apple','banana','Banana','coconut'],
//'veggies': ['tomato','onion','spinach','broccoli']
//}

const fruits = Office.context.mailbox.item.getRegExMatchesByName("fruits");
const veggies = Office.context.mailbox.item.getRegExMatchesByName("veggies");

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/75-regex-matches/contextual.yaml

// This API only works when you click on the highlighted word "ScriptLab".
console.log(Office.context.mailbox.item.getRegExMatchesByName("sampleRegexName"));

loadCustomPropertiesAsync(callback, userContext)

Carga de forma asincrónica las propiedades personalizadas de este complemento en el elemento seleccionado.

Las propiedades personalizadas se almacenan como pares clave-valor por aplicación y por elemento. Este método devuelve un objeto CustomProperties en la devolución de llamada, que proporciona métodos para acceder a las propiedades personalizadas específicas del elemento actual y del complemento actual. Las propiedades personalizadas no se cifran en el elemento, por lo que no se debe usar como almacenamiento seguro.

Las propiedades personalizadas se proporcionan como un objeto CustomProperties en la propiedad asyncResult.value. Este objeto se puede usar para obtener, establecer, guardar y quitar propiedades personalizadas del elemento de correo.

loadCustomPropertiesAsync(callback: (asyncResult: Office.AsyncResult<CustomProperties>) => void, userContext?: any): void;

Parámetros

callback: (asyncResult: Office.AsyncResult<Office.CustomProperties>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult.

userContext: any

Opcional. Los desarrolladores pueden proporcionar cualquier objeto al que quieran obtener acceso en la función de devolución de llamada. A este objeto se puede acceder mediante la propiedad asyncResult.asyncContext en la función de devolución de llamada.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Para obtener más información sobre las propiedades personalizadas, vea Obtener y establecer metadatos de complemento para un complemento de Outlook.

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/15-item-custom-properties/load-set-get-save.yaml

Office.context.mailbox.item.loadCustomPropertiesAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.error(`loadCustomPropertiesAsync failed with message ${result.error.message}`);
    return;
  }

  customProps = result.value;
  console.log("Loaded the CustomProperties object.");
});

Compartir a través de

Office.AppointmentRead interface

Propiedades

Métodos

Detalles de las propiedades

attachments

Valor de propiedad

Comentarios

Ejemplos

body

Valor de propiedad

Comentarios

Ejemplos

dateTimeCreated

Valor de propiedad

Comentarios

Ejemplos

dateTimeModified

Valor de propiedad

Comentarios

Ejemplos

end

Valor de propiedad

Comentarios

Ejemplos

itemClass

Valor de propiedad

Comentarios

Ejemplos

itemId

Valor de propiedad

Comentarios

Ejemplos

itemType

Valor de propiedad

Comentarios

Ejemplos

location

Valor de propiedad

Comentarios

Ejemplos

normalizedSubject

Valor de propiedad

Comentarios

Ejemplos

optionalAttendees

Valor de propiedad

Comentarios

Ejemplos

organizer

Valor de propiedad

Comentarios

Ejemplos

requiredAttendees

Valor de propiedad

Comentarios

Ejemplos

start

Valor de propiedad

Comentarios

Ejemplos

subject

Valor de propiedad

Comentarios

Ejemplos

Detalles del método

displayReplyAllForm(formData)

Parámetros

Devoluciones

Comentarios

Ejemplos

displayReplyForm(formData)

Parámetros

Devoluciones

Comentarios

Ejemplos

getEntities()

Devoluciones

Comentarios

getEntitiesByType(entityType)