Operación GetReminders
Busque información sobre la operación EWS de GetReminders .
La operación GetReminders Exchange Web Services (EWS) recupera recordatorios para los elementos de calendario y tarea.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetReminders
La operación GetReminders obtiene recordatorios de los elementos de calendario y tareas actuales y futuros en el buzón del usuario, en función de los valores de elemento pasados en la solicitud. La operación puede recuperar todos los elementos de calendario actuales y futuros, así como las tareas que tienen un conjunto de recordatorios. Los elementos de calendario privados se incluyen en las respuestas. Las tareas sin recordatorios no se incluyen en las respuestas, ni los correos electrónicos con recordatorios o marcas de seguimiento.
Para recuperar todos los avisos actuales, se recomienda establecer ReminderType en All y EndTime en la hora actual.
Si los elementos BeginTime y EndTime se incluyen en la solicitud, la respuesta incluye recordatorios para los elementos de calendario y tarea que se producen entre tienen un aviso que se produce entre BeginTime y EndTime.
En la tabla siguiente se describe el comportamiento del elemento ReminderType cuando se incluyen los elementos BeginTime y EndTime .
| Valor del elemento ReminderType | Descripción |
|---|---|
| todas |
Recordatorios que se producen entre BeginTime y EndTime. |
| Current |
Recordatorios devueltos por Todos, además de recordatorios que son anteriores al período de tiempo solicitado si el evento sigue en curso, además de todas las citas independientemente de la edad. |
| Viejo |
Recordatorios devueltos por Todos, menos eventos que aún no se han completado, menos todas las citas. Los elementos BeginTime y EndTime deben establecerse para usar el valor Antiguo . |
Encabezados SOAP de la operación GetReminders
La operación GetReminders puede usar los encabezados SOAP que aparecen en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud. |
| MailboxCulture |
MailboxCulture |
Identifica la referencia cultural, tal como se define en RFC 3066, "Etiquetas para la identificación de idiomas", que se usará para acceder al buzón. Este encabezado es aplicable a una solicitud. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación getReminders
En el ejemplo siguiente de una solicitud de operación GetReminders se muestra cómo recuperar los cinco primeros elementos de calendario que se producen entre BeginTime y EndTime.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body>
<m:GetReminders>
<m:EndTime>2014-04-16T21:00:00Z</m:EndTime>
<m:ReminderType>All</m:ReminderType>
</m:GetReminders>
</soap:Body>
</soap:Envelope>
El cuerpo SOAP de la solicitud de ejemplo contiene los siguientes elementos:
El cuerpo SOAP también puede contener los siguientes elementos:
Respuesta correcta de la operación GetReminders
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación GetReminders . La respuesta contiene un recordatorio para el elemento de calendario "Reunión de equipo" y un recordatorio para la tarea "Tarea de enviar notas de reunión".
Nota:
Los identificadores se han acortado para conservar la legibilidad.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="918"
MinorBuildNumber="7"
Version="V2_10"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetRemindersResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<Reminders>
<Reminder xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Subject>Team meeting</Subject>
<Location />
<ReminderTime>2014-04-15T21:00:00Z</ReminderTime>
<StartDate>2014-04-15T21:00:00Z</StartDate>
<EndDate>2014-04-15T21:30:00Z</EndDate>
<ItemId Id="vQAAAA=="
ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV4" />
<RecurringMasterItemId Id="K7u5AAA=" ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV0" />
<ReminderGroup>Calendar</ReminderGroup>
<UID>6CF2FA62</UID>
</Reminder>
<Reminder xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Subject>Task to send meeting notes</Subject>
<Location />
<ReminderTime>2014-04-16T14:00:00Z</ReminderTime>
<StartDate>0001-01-02T00:00:00Z</StartDate>
<EndDate>0001-01-02T00:00:00Z</EndDate>
<ItemId Id="vAAAAA=="
ChangeKey="EwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAIDg==" />
<ReminderGroup>Task</ReminderGroup>
<UID>vAAAAA==</UID>
</Reminder>
</Reminders>
</GetRemindersResponse>
</s:Body>
</s:Envelope>
El cuerpo soap de respuesta contiene los siguientes elementos:
Ejemplo de respuesta de error de la operación GetReminders
En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación GetReminders . Se trata de una respuesta a una solicitud en la que la fecha de finalización era anterior a la fecha de inicio.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="918"
MinorBuildNumber="7"
Version="V2_10"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetRemindersResponse ResponseClass="Error"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>EndDate is earlier than StartDate</MessageText>
<ResponseCode>ErrorInvalidOperation</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</GetRemindersResponse>
</s:Body>
</s:Envelope>
El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:
Para obtener códigos de error adicionales que son genéricos para EWS y específicos de esta operación, vea ResponseCode.
Vea también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de