Operación CreateAttachment
La operación CreateAttachment crea un elemento o datos adjuntos de archivo y lo adjunta al elemento especificado.
Ejemplo de solicitud de File CreateAttachment
En el ejemplo siguiente de una solicitud CreateAttachment se muestra cómo crear datos adjuntos de un archivo.
<?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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateAttachment xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
Se debe proporcionar un nombre para los datos adjuntos.
Nota:
El identificador del elemento primario y la clave de cambio se han acortado para conservar la legibilidad.
Elementos de solicitud File CreateAttachment
En la solicitud se usan los siguientes elementos:
Ejemplo de respuesta de CreateAttachment del archivo correcto
En el ejemplo siguiente se muestra una respuesta correcta a la solicitud 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="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
La respuesta contiene el identificador del archivo adjunto. También contiene el identificador y la clave de cambio del elemento raíz. Los identificadores de elemento y la clave de cambio se han acortado para conservar la legibilidad.
Elementos de respuesta CreateAttachment de archivo correctos
Los siguientes elementos se usan en la respuesta:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- Adjuntos
- FileAttachment
- AttachmentId
Ejemplo de solicitud Desasociación de elementos
En el ejemplo siguiente de una solicitud CreateAttachment se muestra cómo crear datos adjuntos de un elemento.
<?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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateAttachment xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
Se debe proporcionar un nombre para los datos adjuntos. El identificador del elemento primario y la clave de cambio se han acortado para conservar la legibilidad.
Elementos de solicitud CreateAttachement de elementos
En la solicitud se usan los siguientes elementos:
Ejemplo de respuesta de CreateAttachment del elemento correcto
En el ejemplo siguiente se muestra una respuesta correcta a la solicitud 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="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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>
La respuesta contiene el identificador de los nuevos datos adjuntos. También contiene el identificador y la clave de cambio del elemento raíz. El elemento raíz es el elemento que contiene los datos adjuntos. Los identificadores de elemento y la clave de cambio se han acortado para conservar la legibilidad.
Elementos de respuesta CreateAttachment correctos
Los siguientes elementos se usan en la respuesta:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- Adjuntos
- ItemAttachment
- AttachmentId
Ejemplo de respuesta de error createAttachment
En el ejemplo siguiente se muestra una respuesta de error a la solicitud CreateAttachment. El error se debe al hecho de que no se especificó el nombre de los datos adjuntos.
<?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="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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 respuesta de error CreateAttachment
Los siguientes elementos se usan en la respuesta de error:
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- MessageText
- ResponseCode
- DescriptiveLinkKey
- MessageXml
- ExceptionFieldURI
- Adjuntos
Comentarios
Si se adjuntan varios datos adjuntos a un elemento en un único recorrido de ida y vuelta, RootItemChangeKey en el último mensaje de respuesta es el que representa la nueva clave de cambio del elemento que tiene los datos adjuntos.