Operação convertidConvertId operation

Encontre informações sobre a operação convertid do EWS.Find information about the ConvertId EWS operation.

A operação convertid de serviços Web do Exchange (EWS) converte os identificadores de item e pasta entre os formatos aceitos pelo Exchange Online, o Exchange Online como parte do Office 365 e as versões locais do Exchange a partir do 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.

Usando a operação convertidUsing the ConvertId operation

Você pode converter os seguintes identificadores usando a operação convertid :You can convert the following identifiers by using the ConvertId operation:

  • O formato do identificador para EWS na versão inicial do Exchange 2007.The identifier format for EWS in the initial release version of Exchange 2007. Isso é representado pelo EwsLegacyId valor de enumeração na enumeração IdFormat .This is represented by the EwsLegacyId enumeration value in the IdFormat enumeration.

  • O formato do identificador para EWS no Exchange 2007 SP1 ou no Exchange 2010.The identifier format for EWS in Exchange 2007 SP1 or Exchange 2010. Isso é representado pelo EwsId valor de enumeração no IdFormat.This is represented by the EwsId enumeration value in IdFormat.

  • O identificador MAPI, como na propriedade PR_ENTRYID .The MAPI identifier, as in the PR_ENTRYID property. Isso é representado pelo EntryId valor de enumeração na enumeração IdFormat .This is represented by the EntryId enumeration value in the IdFormat enumeration.

  • O identificador de eventos do calendário de disponibilidade.The availability calendar event identifier. Esta é uma representação codificada em hexadecimal da propriedade PR_ENTRYID .This is a hexadecimal-encoded representation of the PR_ENTRYID property. Isso é representado pelo HexEntryId valor de enumeração no IdFormat.This is represented by the HexEntryId enumeration value in IdFormat.

  • O identificador do repositório do Exchange.The Exchange store identifier. Isso é representado pelo StoreId valor de enumeração no IdFormat.This is represented by the StoreId enumeration value in IdFormat. A operação convertid não converte identificadores de pasta pública do identificador EWS no identificador de repositório.The ConvertId operation does not convert public folder identifiers from the EWS identifier to the store identifier.

  • O identificador do Outlook Web App.The Outlook Web App identifier. Isso é representado pelo OwaId valor de enumeração no IdFormatThis is represented by the OwaId enumeration value in IdFormat

    Não há suporte para a passagem de URLs criadas a partir deste identificador para o Outlook Web App.The passing of URLs that are created from this identifier to Outlook Web App is not supported. O identificador do Outlook Web App é aplicável ao Exchange 2007 e ao Exchange 2010.The Outlook Web App identifier is applicable to Exchange 2007 and Exchange 2010. Outlook Web App para Exchange Online e versões do Exchange a partir do Exchange Server 2013 usa identificadores EWS.Outlook Web App for Exchange Online and versions of Exchange starting with Exchange Server 2013 uses EWS identifiers.

A operação convertid não funciona como esperado ao converter identificadores de pasta pública do identificador EWS para o identificador de repositório no Exchange Online e no 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. Você pode atualizar manualmente o identificador que é retornado como uma solução alternativa.You can manually update the identifier that is returned as a workaround. Para atualizar manualmente o identificador:To manually update the identifier:

  1. No código do aplicativo, determine se o item/pasta de destino está em uma pasta pública.In your application code, determine whether the target item/folder is in a public folder.

  2. Decodifique a cadeia de caracteres do identificador codificado em base64.Decode the Base64-encoded identifier string.

  3. Verifique se o byte de tipo (21 byte) tem um valor de 7.Verify that the type byte (21st byte) has a value of 7. O valor 7 indica que o identificador está no formato incorreto.A value of 7 indicates that the identifier is in the incorrect format.

  4. Pule os primeiros quatro bytes.Skip the first four bytes. Eles devem ser definidos como zero.They must be set to zero.

  5. Atualize os próximos 16 bytes com o seguinte GUID: 1A447390AA6611CD9BC800AA002FC45AUpdate the next 16 bytes with the following GUID: 1A447390AA6611CD9BC800AA002FC45A

  6. Atualize o próximo byte (tipo Byte) com um valor de 9.Update the next byte (type byte) with a value of 9.

  7. Altere o identificador para uma cadeia de caracteres codificada em base64.Change the identifier to a Base64-encoded string.

Observação

A operação convertid valida que um determinado endereço SMTP tem um formato válido.The ConvertId operation validates that a given SMTP address has a valid format. A operação não determina se um endereço SMTP representa uma caixa de correio válida.The operation does not determine whether an SMTP address represents a valid mailbox.

A operação convertid pode usar os cabeçalhos SOAP listados na tabela a seguir.The ConvertId operation can use the SOAP headers that are listed in the following table.

Tabela 1. Cabeçalhos SOAP da operação convertidTable 1. ConvertId operation SOAP headers

HeaderHeader ElementoElement DescriçãoDescription
RepresentaçãoImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando.Identifies the user whom the client application is impersonating. Isso se aplica a uma solicitação.This is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica a versão do esquema para a solicitação de operação isso se aplica a uma solicitação.Identifies the schema version for the operation request This is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.Identifies the version of the server that responded to the request. Isso se aplica a uma resposta.This is applicable to a response.

Exemplo de solicitação de operação convertidConvertId operation request example

O exemplo a seguir de uma solicitação convertid mostra como converter de um identificador EWS para um identificador do Outlook Web App.The following example of a ConvertId request shows how to convert from an EWS identifier to an Outlook Web App identifier.

O elemento RequestServerVersion no cabeçalho SOAP deve ser definido como Exchange2007_SP1 ou posterior para que essa operação funcione.The RequestServerVersion element in the SOAP header must be set to Exchange2007_SP1 or later for this operation to work.

Observação

O identificador de item foi reduzido para preservar a legibilidade.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>

Exemplo de resposta de convertidConvertId operation response example

O exemplo a seguir mostra uma resposta bem-sucedida para uma solicitação convertid .The following example shows a successful response to a ConvertId request. Este exemplo de resposta contém um identificador do Outlook Web App.This response example contains an Outlook Web App identifier.

Observação

O identificador do Outlook Web App foi reduzido para preservar a legibilidade.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>

Exemplo de resposta de erro de operação convertidConvertId operation error response example

O exemplo a seguir mostra a resposta a uma solicitação que contém o tipo incorreto de formato de identificador.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>

Diferenças de versãoVersion differences

O formato do identificador EWS foi alterado entre a versão inicial do Exchange 2007 e do 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). O Exchange Online como parte do Office 365, do Exchange Online e das versões locais do Exchange a partir do Exchange 2010 usam o mesmo formato de identificador que o Exchange 2007 SP1 usa.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.

A operação convertid converte identificadores de pasta pública do identificador do EWS para o identificador de repositório no Exchange 2007 e no Exchange 2010.The ConvertId operation converts public folder identifiers from the EWS identifier to the store identifier in Exchange 2007 and Exchange 2010.

Confira tambémSee also