Operación UpdateFolderUpdateFolder operation

La operación UpdateFolder se usa para modificar las propiedades de un elemento existente en el almacén de Exchange.The UpdateFolder operation is used to modify properties of an existing item in the Exchange store. Cada operación UpdateFolder consta de lo siguiente:Each UpdateFolder operation consists of the following:

  • Un elemento FolderId que especifica la carpeta que se va a actualizar.A FolderId element that specifies a folder to update.

  • Ruta de acceso interna de un elemento de la carpeta, como se especifica en la forma Folder, que especifica los datos que se van a actualizar.An internal path of an element in the folder, as specified by the folder shape, which specifies the data to update.

  • Una carpeta que contiene el nuevo valor del campo actualizado, si la actualización no es una eliminación.A folder that contains the new value of the updated field, if the update is not a deletion.

ComentariosRemarks

Se pueden realizar tres acciones de actualización básicas en un elemento.Three basic update actions can be performed on an item. Estas acciones se enumeran en la tabla siguiente.These actions are listed in the following table.

ActionAction DescripciónDescription
AnexarAppend
La acción Append agrega datos a una propiedad existente.The append action adds data to an existing property. Conserva los datos que hay actualmente.It preserves the data that is currently there. Append no es aplicable a todas las propiedades.Append is not applicable to all properties.
SetSet
La acción Set reemplaza los datos de una propiedad si contiene datos o crea la propiedad y establece su valor si no existe.The set action replaces data for a property if it contains data, or creates the property and sets its value if it does not exist. La acción Set solo es aplicable a las propiedades modificables.The set action is only applicable to writable properties.
EliminarDelete
La acción eliminar quita una propiedad de una carpeta.The delete action removes a property from a folder. No es lo mismo que establecerlo en un valor vacío.This is different than setting it to an empty value. Una vez completada, la propiedad no existe para la carpeta.When complete, the property does not exist for the folder. Delete solo se aplica a propiedades modificables.Delete is only applicable to writable properties.

Ejemplo de solicitud UpdateFolderUpdateFolder request example

DescriptionDescription

El siguiente ejemplo de una solicitud UpdateFolder muestra cómo actualizar un nombre para mostrar de la carpeta.The following example of an UpdateFolder request shows how to update a folder display name.

CódigoCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <UpdateFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
                  xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <FolderChanges>
        <t:FolderChange>
          <t:FolderId Id="AScA" ChangeKey="GO3u/"/>
          <t:Updates>
            <t:SetFolderField>
              <t:FieldURI FieldURI="folder:DisplayName"/>
              <t:Folder>
                <t:DisplayName>NewFolderName</t:DisplayName>
              </t:Folder>
            </t:SetFolderField>
          </t:Updates>
        </t:FolderChange>
      </FolderChanges>
    </UpdateFolder>
  </soap:Body>
</soap:Envelope>

ComentariosComments

En este ejemplo se cambia el nombre para mostrar de la carpeta a NewFolderName.This example changes the display name of the folder to NewFolderName.

Nota

Los valores de los atributos ID y changekey del elemento FolderId se han abreviado para facilitar su lectura.The values of the Id and ChangeKey attributes of the FolderId element have been shortened for readability.

Elementos de solicitudRequest elements

Los siguientes elementos se usan en la solicitud:The following elements are used in the request:

Vea el esquema para ver los elementos adicionales que puede usar para formar una solicitud de UpdateFolder.See the schema for additional elements that you can use to form an UpdateFolder request.

Nota

La ubicación predeterminada del esquema está en el directorio virtual de EWS en el equipo que tiene instalado el rol de servidor acceso de clientes.The default location of the schema is in the EWS virtual directory on the computer that has the Client Access server role installed.

Ejemplo de respuesta UpdateFolderUpdateFolder response example

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud UpdateFolder.The following example shows a successful response to the UpdateFolder request. En este ejemplo, se devuelve la nueva clave de cambio para reflejar el estado actualizado de la carpeta.In this example, the new change key is returned to reflect the updated status of the folder.

CódigoCode

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UpdateFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:UpdateFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AAAlAFVz" ChangeKey="AQAAAB" />
            </t:Folder>
          </m:Folders>
        </m:UpdateFolderResponseMessage>
      </m:ResponseMessages>
    </UpdateFolderResponse>
  </soap:Body>
</soap:Envelope>

ComentariosComments

Nota

El identificador de la carpeta y la clave de cambio se han abreviado para preservar la legibilidad.The folder ID and the change key have been shortened to preserve readability.

El identificador de carpeta que se devuelve en la respuesta representa la carpeta actualizada.The folder ID that is returned in the response represents the updated folder.

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Ejemplo de respuesta de error UpdateFolderUpdateFolder Error response example

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta de error a una solicitud UpdateFolder.The following example shows an error response to an UpdateFolder request.

CódigoCode

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UpdateFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:UpdateFolderResponseMessage ResponseClass="Error">
          <m:MessageText>The change key is invalid.</m:MessageText>
          <m:ResponseCode>ErrorInvalidChangeKey</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:UpdateFolderResponseMessage>
      </m:ResponseMessages>
    </UpdateFolderResponse>
  </soap:Body>
</soap:Envelope>

ComentariosComments

En este ejemplo se muestra una respuesta de error causada por un atributo changekey no válido en la solicitud.This example shows an error response that is caused by an invalid ChangeKey attribute in the request.

Elementos de respuesta de errorError response elements

Los siguientes elementos se usan en la respuesta de error:The following elements are used in the error response:

Vea tambiénSee also