CreateAttachment 操作
CreateAttachment 操作は、アイテムまたはファイルの添付ファイルを作成し、指定したアイテムに添付します。
File CreateAttachment 要求の例
CreateAttachment 要求の次の例は、添付ファイルを作成する方法を示しています。
<?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>
添付ファイルの名前を指定する必要があります。
注意
親アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。
File CreateAttachment 要求要素
要求では、次の要素が使用されます。
成功したファイル CreateAttachment 応答の例
次の例は、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>
応答には、添付ファイルの識別子が含まれる。 また、ルート アイテムの識別子と変更キーも含まれる。 アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。
成功したファイル CreateAttachment 応答要素
応答では、次の要素が使用されます。
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- 添付ファイル
- FileAttachment
- AttachmentId
Item CreateAttachment 要求の例
CreateAttachment 要求の次の例は、アイテム添付ファイルを作成する方法を示しています。
<?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>
添付ファイルの名前を指定する必要があります。 親アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。
Item CreateAttachement 要求要素
要求では、次の要素が使用されます。
成功したアイテムの CreateAttachment 応答の例
次の例は、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>
応答には、新しい添付ファイルの識別子が含まれる。 また、ルート アイテムの識別子と変更キーも含まれる。 ルート アイテムは、添付ファイルを含むアイテムです。 アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。
成功したアイテム CreateAttachment 応答要素
応答では、次の要素が使用されます。
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- ResponseCode
- 添付ファイル
- ItemAttachment
- AttachmentId
CreateAttachment エラー応答の例
次の例は、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="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>
CreateAttachment エラー応答要素
エラー応答では、次の要素が使用されます。
- ServerVersionInfo
- CreateAttachmentResponse
- ResponseMessages
- CreateAttachmentResponseMessage
- MessageText
- ResponseCode
- DescriptiveLinkKey
- MessageXml
- ExceptionFieldURI
- 添付ファイル
注釈
1 回のラウンド トリップで複数の添付ファイルがアイテムに添付されている場合、最後の応答メッセージの RootItemChangeKey は、添付ファイルを持つアイテムの新しい変更キーを表すファイルです。