Operação PerformReminderAction

Artigo
03/29/2023

Encontre informações sobre a operação PerformReminderAction EWS.

A operação EWS ( PerformReminderAction Exchange Web Services) inicia uma ação de descarte ou soneca em um lembrete.

This operation was introduced in Exchange Server 2013.

Usando a operação PerformReminderAction

Você pode usar a operação PerformReminderAction para descartar ou sonegar lembretes (atraso) retornados pela operação GetReminders . Para cochirar um lembrete, defina o ActionType como Snooze e defina o valor NewReminderTime como um tempo mais tarde do que o ReminderTime atual, caso contrário, o NewReminderTime é ignorado pelo servidor. Se o lembrete for para uma ocorrência de uma reunião recorrente, e a ação Snooze for tomada no lembrete com um NewReminderTime que passou do lembrete da próxima ocorrência, o lembrete será efetivamente descartado.

Para descartar um lembrete, defina o ActionType como Dismiss. Quando o servidor processa a solicitação, o servidor altera o valor IsReminderSet para o item de True para False.

Executar cabeçalhos SOAP da operação PerformReminderAction

A operação PerformReminderAction pode usar os cabeçalhos SOAP listados na tabela a seguir.

Nome de cabeçalho	Elemento	Descrição
Representação	ExchangeImpersonation	Identifica o usuário que o aplicativo cliente está representando. Esse cabeçalho é aplicável a uma solicitação.
MailboxCulture	MailboxCulture	Identifica a cultura, conforme definido no RFC 3066, "Marcas para a Identificação de Idiomas", a ser usada para acessar a caixa de correio. Esse cabeçalho é aplicável a uma solicitação.
RequestVersion	RequestServerVersion	Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação.
Serverversion	ServerVersionInfo	Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta.

Exemplo de solicitação de operação PerformReminderAction

O exemplo a seguir de uma solicitação de operação PerformReminderAction mostra como cochirar um lembrete atual e definir um novo tempo de lembrete. Observe que você precisa incluir o ChangeKey para o ItemId e o NewReminderTime deve ser definido como um tempo mais tarde do que o ReminderTime retornado pela operação 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>

Observação

O valor ItemId foi encurtado para preservar a legibilidade.

O corpo SOAP de solicitação contém os seguintes elementos:

Resposta bem-sucedida da operação PerformReminderAction

O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação PerformReminderAction . O elemento UpdatedItemIds contém os ItemIds do item de calendário atualizado.

<?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>

O corpo SOAP de resposta contém os seguintes elementos:

Exemplo de resposta de erro da operação PerformReminderAction

O exemplo a seguir mostra uma resposta a uma solicitação de operação PerformReminderAction quando nenhuma alteração foi feita no servidor. Essa é uma resposta na qual uma solicitação foi enviada, mas nenhum UpdatedItemIds foi retornado, o que significa que nenhum lembrete foi alterado.

<?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>

O corpo SOAP de resposta de erro contém os seguintes elementos:

Para obter códigos de erro adicionais que são genéricos para o EWS, consulte ResponseCode.

Confira também

Operação GetReminders

Compartilhar via