Operação CreateAttachment
A operação CreateAttachment cria um item ou anexo de arquivo e o anexa ao item especificado.
Exemplo de solicitação CreateAttachment de arquivo
O exemplo a seguir de uma solicitação CreateAttachment mostra como criar um anexo de arquivo.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ParentItemId Id="AAAtAE..." ChangeKey="CQAAABYA..."/>
<Attachments>
<t:FileAttachment>
<t:Name>SomeFile</t:Name>
<t:Content>AQIDBAU=</t:Content>
</t:FileAttachment>
</Attachments>
</CreateAttachment>
</soap:Body>
</soap:Envelope>
Um nome para o anexo deve ser fornecido.
Observação
O identificador de item pai e a chave de alteração foram encurtados para preservar a legibilidade.
Elementos de solicitação CreateAttachment de Arquivo
Os seguintes elementos são usados na solicitação:
Exemplo de resposta CreateAttachment de arquivo bem-sucedido
O exemplo a seguir mostra uma resposta bem-sucedida à solicitação CreateAttachment.
<?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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Attachments>
<t:FileAttachment>
<t:AttachmentId Id="AAAtAE=" RootItemId="AAAtAEFk=" RootItemChangeKey="CQAAAB"/>
</t:FileAttachment>
</m:Attachments>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
A resposta contém o identificador do arquivo anexado. Ele também contém o identificador e a chave de alteração do item raiz. Os identificadores de item e a chave de alteração foram encurtados para preservar a legibilidade.
Elementos de resposta CreateAttachment de arquivo bem-sucedidos
Os seguintes elementos são usados na resposta:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- Anexos
- FileAttachment
- AttachmentId
Exemplo de solicitação CreateAttachment do Item
O exemplo a seguir de uma solicitação CreateAttachment mostra como criar um anexo de item.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ParentItemId Id="AAAtAE=" ChangeKey="CQAAABYA"/>
<Attachments>
<t:ItemAttachment>
<t:Name>An item attachment</t:Name>
<t:Message>
<t:Subject>A message to attach</t:Subject>
</t:Message>
</t:ItemAttachment>
</Attachments>
</CreateAttachment>
</soap:Body>
</soap:Envelope>
Um nome para o anexo deve ser fornecido. O identificador de item pai e a chave de alteração foram encurtados para preservar a legibilidade.
Elementos de solicitação CreateAttachement do Item
Os seguintes elementos são usados na solicitação:
Exemplo de resposta CreateAttachment de item bem-sucedido
O exemplo a seguir mostra uma resposta bem-sucedida à solicitação CreateAttachment.
<?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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Attachments>
<t:ItemAttachment>
<t:AttachmentId Id="AAAtAEFk=" RootItemId="AAAtAEFkb=" RootItemChangeKey="CQAAABYA"/>
</t:ItemAttachment>
</m:Attachments>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
A resposta contém o identificador do novo anexo. Ele também contém o identificador e a chave de alteração do item raiz. O item raiz é o item que contém o anexo. Os identificadores de item e a chave de alteração foram encurtados para preservar a legibilidade.
Elementos de resposta CreateAttachment de êxito
Os seguintes elementos são usados na resposta:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- Anexos
- ItemAttachment
- AttachmentId
Exemplo de resposta de erro CreateAttachment
O exemplo a seguir mostra uma resposta de erro à solicitação CreateAttachment. O erro se deve ao fato de que o nome do anexo não foi especificado.
<?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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Error">
<m:MessageText>Required property is missing.</m:MessageText>
<m:ResponseCode>ErrorRequiredPropertyMissing</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:ExceptionFieldURI FieldURI="attachment:Name"/>
</m:MessageXml>
<m:Attachments/>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
Elementos de resposta de erro CreateAttachment
Os seguintes elementos são usados na resposta de erro:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- MessageText
- ResponseCode
- DescriptiveLinkKey
- MessageXml
- ExceptionFieldURI
- Anexos
Comentários
Se vários anexos forem anexados a um item em uma única viagem de ida e volta, o RootItemChangeKey na última mensagem de resposta será aquele que representa a nova chave de alteração do item que tem os anexos.
Confira também
Operação DeleteAttachmentGetAttachment
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de