Operación ConvertIdConvertId operation

Buscar información sobre la operación de EWS de ConvertId .Find information about the ConvertId EWS operation.

La ConvertId de servicios web Exchange (EWS) convierte los identificadores de elementos y carpetas entre formatos aceptados por Exchange Online, Exchange online como parte de Office 365 y las versiones locales de Exchange a partir de exchange Server 2013.The ConvertId Exchange Web Services (EWS) operation converts item and folder identifiers between formats that are accepted by Exchange Online, Exchange Online as part of Office 365, and on-premises versions of Exchange starting with Exchange Server 2013.

Uso de la operación ConvertIdUsing the ConvertId operation

Puede convertir los siguientes identificadores mediante la operación ConvertId :You can convert the following identifiers by using the ConvertId operation:

  • El formato de identificador de EWS en la versión de lanzamiento inicial de Exchange 2007.The identifier format for EWS in the initial release version of Exchange 2007. Esto se representa mediante el EwsLegacyId valor de enumeración en la enumeración IdFormat .This is represented by the EwsLegacyId enumeration value in the IdFormat enumeration.

  • El formato de identificador de EWS en Exchange 2007 SP1 o Exchange 2010.The identifier format for EWS in Exchange 2007 SP1 or Exchange 2010. Esto se representa mediante el EwsId valor de enumeración en IdFormat.This is represented by the EwsId enumeration value in IdFormat.

  • Identificador de MAPI, como en la propiedad PR_ENTRYID .The MAPI identifier, as in the PR_ENTRYID property. Esto se representa mediante el EntryId valor de enumeración en la enumeración IdFormat .This is represented by the EntryId enumeration value in the IdFormat enumeration.

  • Identificador de evento del calendario de disponibilidad.The availability calendar event identifier. Se trata de una representación codificada en hexadecimal de la propiedad PR_ENTRYID .This is a hexadecimal-encoded representation of the PR_ENTRYID property. Esto se representa mediante el HexEntryId valor de enumeración en IdFormat.This is represented by the HexEntryId enumeration value in IdFormat.

  • El identificador del almacén de Exchange.The Exchange store identifier. Esto se representa mediante el StoreId valor de enumeración en IdFormat.This is represented by the StoreId enumeration value in IdFormat. La operación ConvertId no convierte los identificadores de la carpeta pública del identificador EWS al identificador del almacén.The ConvertId operation does not convert public folder identifiers from the EWS identifier to the store identifier.

  • Identificador de Outlook Web App.The Outlook Web App identifier. Esto se representa mediante el OwaId valor de enumeración en IdFormatThis is represented by the OwaId enumeration value in IdFormat

    No se admite el paso de direcciones URL creadas desde este identificador a Outlook Web App.The passing of URLs that are created from this identifier to Outlook Web App is not supported. El identificador de Outlook Web App se aplica a Exchange 2007 y a Exchange 2010.The Outlook Web App identifier is applicable to Exchange 2007 and Exchange 2010. Outlook Web App para Exchange Online y versiones de Exchange a partir de Exchange Server 2013 usan identificadores EWS.Outlook Web App for Exchange Online and versions of Exchange starting with Exchange Server 2013 uses EWS identifiers.

La operación ConvertId no funciona según lo esperado al convertir los identificadores de carpeta pública del identificador EWS al identificador de almacén en Exchange Online y Exchange 2013.The ConvertId operation does not work as expected when converting public folder identifiers from the EWS identifier to the store identifier in Exchange Online and Exchange 2013. Puede actualizar manualmente el identificador que se devuelve como solución alternativa.You can manually update the identifier that is returned as a workaround. Para actualizar manualmente el identificador:To manually update the identifier:

  1. En el código de la aplicación, determine si el elemento o carpeta de destino está en una carpeta pública.In your application code, determine whether the target item/folder is in a public folder.

  2. Descodifique la cadena identificadora codificada en Base64.Decode the Base64-encoded identifier string.

  3. Compruebe que el tipo byte (XXI byte) tiene un valor de 7.Verify that the type byte (21st byte) has a value of 7. Un valor de 7 indica que el identificador no tiene el formato correcto.A value of 7 indicates that the identifier is in the incorrect format.

  4. Omitir los primeros cuatro bytes.Skip the first four bytes. Deben establecerse en cero.They must be set to zero.

  5. Actualice los siguientes 16 bytes con el siguiente GUID: 1A447390AA6611CD9BC800AA002FC45AUpdate the next 16 bytes with the following GUID: 1A447390AA6611CD9BC800AA002FC45A

  6. Actualice el siguiente byte (tipo byte) con un valor de 9.Update the next byte (type byte) with a value of 9.

  7. Cambie el identificador a una cadena codificada en Base64.Change the identifier to a Base64-encoded string.

Nota

La operación ConvertId valida que una dirección SMTP determinada tiene un formato válido.The ConvertId operation validates that a given SMTP address has a valid format. La operación no determina si una dirección SMTP representa un buzón válido.The operation does not determine whether an SMTP address represents a valid mailbox.

La operación ConvertId puede usar los encabezados SOAP que se enumeran en la tabla siguiente.The ConvertId operation can use the SOAP headers that are listed in the following table.

Tabla 1. Encabezados SOAP de operación ConvertIdTable 1. ConvertId operation SOAP headers

HeaderHeader ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating. Esto es aplicable a una solicitud.This is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación esto es aplicable a una solicitud.Identifies the schema version for the operation request This is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request. Esto es aplicable a una respuesta.This is applicable to a response.

Ejemplo de solicitud de operación ConvertIdConvertId operation request example

El siguiente ejemplo de una solicitud ConvertId muestra cómo convertir un identificador EWS a un identificador de Outlook Web App.The following example of a ConvertId request shows how to convert from an EWS identifier to an Outlook Web App identifier.

El elemento RequestServerVersion del encabezado SOAP debe establecerse en Exchange2007_SP1 o posterior para que funcione esta operación.The RequestServerVersion element in the SOAP header must be set to Exchange2007_SP1 or later for this operation to work.

Nota

El identificador de elemento se ha abreviado para preservar la legibilidad.The item identifier has been shortened to preserve readability.

<?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:Header>
    <t:RequestServerVersion Version="Exchange2010"/>
  </soap:Header>
  <soap:Body>
    <ConvertId xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               DestinationFormat="OwaId">
      <SourceIds>
        <t:AlternateId Format="EwsId" Id="AAMkAGZhN2IxYTA0LWNiNzItN="
                       Mailbox="user1@example.com"/>
      </SourceIds>
    </ConvertId>
  </soap:Body>
</soap:Envelope>

Ejemplo de respuesta de operación ConvertIdConvertId operation response example

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud ConvertId .The following example shows a successful response to a ConvertId request. Este ejemplo de respuesta contiene un identificador de Outlook Web App.This response example contains an Outlook Web App identifier.

Nota

El identificador de Outlook Web App se ha abreviado para preservar la legibilidad.The Outlook Web App identifier has been shortened to preserve readability.

<?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="1" 
                         MajorBuildNumber="191" MinorBuildNumber="0" 
                         Version="Exchange2010" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ConvertIdResponse xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessages>
        <ConvertIdResponseMessage ResponseClass="Success">
          <ResponseCode>NoError</ResponseCode>
          <AlternateId xsi:type="t:AlternateIdType" Format="OwaId" Id="RgAAAAAS2%2" 
                         Mailbox="user@example.com" />
        </ConvertIdResponseMessage>
      </ResponseMessages>
    </ConvertIdResponse>
  </soap:Body>
</soap:Envelope>

Ejemplo de respuesta de error de operación ConvertIdConvertId operation error response example

En el ejemplo siguiente se muestra la respuesta a una solicitud que contiene el tipo de formato de identificador incorrecto.The following example shows the response to a request that contains the wrong type of identifier format.

<?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>
    <ServerVersionInfo MajorVersion="8" MinorVersion="1" 
                       MajorBuildNumber="206" MinorBuildNumber="0"
                       Version="Exchange2010" 
                       xmlns="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <ConvertIdResponse xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessages>
        <ConvertIdResponseMessage ResponseClass="Error">
          <MessageText>Id is malformed.</MessageText>
          <ResponseCode>ErrorInvalidIdMalformed</ResponseCode>
          <DescriptiveLinkKey>0</DescriptiveLinkKey>
        </ConvertIdResponseMessage>
      </ResponseMessages>
    </ConvertIdResponse>
  </soap:Body>
</soap:Envelope>

Diferencias de versiónVersion differences

El formato de identificador de EWS ha cambiado entre la versión de lanzamiento inicial de Exchange 2007 y Exchange 2007 Service Pack 1 (SP1).The EWS identifier format changed between the initial release version of Exchange 2007 and Exchange 2007 Service Pack 1 (SP1). Exchange online como parte de Office 365, Exchange Online y las versiones locales de Exchange a partir de Exchange 2010 usan el mismo formato de identificador que usa Exchange 2007 SP1.Exchange Online as part of Office 365, Exchange Online, and on-premises versions of Exchange starting with Exchange 2010 use the same identifier format that Exchange 2007 SP1 uses.

La operación ConvertId convierte los identificadores de carpeta pública del identificador EWS al identificador de almacén en Exchange 2007 y Exchange 2010.The ConvertId operation converts public folder identifiers from the EWS identifier to the store identifier in Exchange 2007 and Exchange 2010.

Vea tambiénSee also