Operación PerformReminderAction

Artículo
03/29/2023

Busque información sobre la operación EWS PerformReminderAction .

La operación PerformReminderAction Exchange Web Services (EWS) inicia una acción de descartar o posponer en un aviso.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación PerformReminderAction

Puede usar la operación PerformReminderAction para descartar o posponer (retrasar) los avisos devueltos por la operación GetReminders . Para posponer un recordatorio, establezca ActionType en Snooze y establezca el valor NewReminderTime en una hora posterior a la hora actual de ReminderTime; de lo contrario, el servidor omite NewReminderTime . Si el aviso es para una repetición de una reunión periódica y la acción de posponer se realiza en el aviso con un NewReminderTime que está más allá del aviso de la siguiente repetición, el aviso se descarta de forma eficaz.

Para descartar un aviso, establezca ActionType en Descartar. Cuando el servidor procesa la solicitud, el servidor cambia el valor IsReminderSet para el elemento de True a False.

Encabezados SOAP de la operación PerformReminderAction

La operación PerformReminderAction 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 PerformReminderAction

En el ejemplo siguiente de una solicitud de operación PerformReminderAction se muestra cómo posponer un aviso actual y establecer una nueva hora de recordatorio. Tenga en cuenta que debe incluir ChangeKey para ItemId y NewReminderTime debe establecerse en una hora posterior a la hora de ReminderTime devuelta por la operación GetReminders .

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="http://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:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>

Nota:

El valor ItemId se ha acortado para conservar la legibilidad.

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta correcta de la operación PerformReminderAction

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación PerformReminderAction . El elemento UpdatedItemIds contiene los ItemIds del elemento de calendario actualizado.

<?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="921"
                       MinorBuildNumber="20"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://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">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

El cuerpo soap de respuesta contiene los siguientes elementos:

Ejemplo de respuesta de error de la operación PerformReminderAction

En el ejemplo siguiente se muestra una respuesta a una solicitud de operación PerformReminderAction cuando no se ha realizado ningún cambio en el servidor. Se trata de una respuesta en la que se envió una solicitud, pero no se devolvieron updatedItemIds , lo que significa que no se cambiaron los recordatorios.

<?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="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://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">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </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, vea ResponseCode.

Vea también

Operación GetReminders

Compartir a través de