Operación MarkAllItemsAsRead

  • Artículo

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

La operación MarkAllItemsAsRead establece la propiedad IsRead en todos los elementos, en una o más carpetas, para indicar que todos los elementos están leídos o no leídos.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación MarkAllItemsAsRead

La operación MarkAllItemsAsRead puede establecer la propiedad IsRead en todos los elementos de las carpetas identificadas por el identificador de carpeta de Exchange Web Services (EWS) o el nombre de carpeta de Exchange predeterminado. La operación MarkAllItemsAsRead también puede suprimir el envío de recibos de lectura para los elementos marcados como leídos.

Encabezados SOAP de la operación MarkAllItemsAsRead

La operación MarkAllItemsAsRead puede usar los encabezados SOAP que se enumeran 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 MarkAllItemsAsRead: marcar todos los elementos de una carpeta como leídos

En el ejemplo siguiente de una solicitud de operación MarkAllItemsAsRead se muestra cómo establecer la propiedad IsRead , que también se denomina marca de lectura, en true en todos los elementos de una carpeta. En este ejemplo también se muestra que los recibos de lectura no se envían en respuesta a ninguna solicitud de recibo de lectura.

Nota:

Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad. Las claves de cambio no son necesarias para esta operación.

<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:MarkAllItemsAsRead>
         <m:ReadFlag>true</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta correcta de la operación MarkAllItemsAsRead

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación MarkAllItemsAsRead para marcar todos los elementos de una carpeta como leídos.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           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">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Success">
               <m:ResponseCode>NoError</m:ResponseCode>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

El cuerpo soap de respuesta contiene los siguientes elementos:

Ejemplo de solicitud de operación MarkAllItemsAsRead: marcar todos los elementos de una carpeta como no leídos

En el ejemplo siguiente de una solicitud de operación MarkAllItemsAsRead se muestra cómo establecer la propiedad IsRead en false en todos los elementos de una carpeta. En este ejemplo también se muestra que los recibos de lectura no se envían en respuesta a ninguna solicitud de recibo de lectura.

<?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:MarkAllItemsAsRead>
         <m:ReadFlag>false</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

Una respuesta correcta a una solicitud para marcar todos los elementos como leídos es la misma que la respuesta a una solicitud para marcar todos los elementos como no leídos.

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta de error de la operación MarkAllItemsAsRead

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación MarkAllItemsAsRead para marcar todos los elementos de una carpeta como leídos o no leídos cuando la carpeta no existe en el buzón.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           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">
      <m:MarkAllItemsAsReadResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Error">
               <m:MessageText>The specified object was not found in the store.</m:MessageText>
               <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
               <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:

Vea también