CreateFolderPath 操作
CreateFolderPath EWS 操作に関する情報を確認します。
CreateFolderPath 操作では、フォルダー階層が作成されます。
この操作は Exchange Server 2013 で導入されました。
CreateFolderPath 操作の使用
CreateFolderPath 操作要求は、フォルダーの配列と親フォルダー識別子を受け取り、配列内のフォルダーの順序に基づいてフォルダー階層を作成します。
CreateFolderPath 操作 SOAP ヘッダー
CreateFolderPath 操作では、次の表に示す SOAP ヘッダーを使用できます。
| ヘッダー名 | 要素 | 説明 |
|---|---|---|
| 偽装 |
ExchangeImpersonation |
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは要求に適用されます。 |
| MailboxCulture |
MailboxCulture |
RFC 3066 で定義されている "言語の識別用タグ" で定義されているカルチャを識別し、メールボックスにアクセスするために使用します。 このヘッダーは要求に適用されます。 |
| RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 このヘッダーは要求に適用されます。 |
| ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用できます。 |
| TimeZoneContext |
TimeZoneContext |
DateTime プロパティのタイム ゾーン スコープを識別します。 このヘッダーは要求に適用されます。 |
CreateFolderPath 操作要求の例: フォルダー階層を作成する
次の CreateFolderPath 操作要求の例は、既定の受信トレイ フォルダーの深い 3 つのフォルダーであるフォルダー階層を作成する方法を示しています。
注:
この記事のすべての項目識別子と変更キーは、読みやすくするために短縮されています。
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
<t:MailboxCulture>en-US</t:MailboxCulture>
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="GMT Standard Time"/>
</t:TimeZoneContext>
</soap:Header>
<soap:Body >
<m:CreateFolderPath>
<m:ParentFolderId>
<t:DistinguishedFolderId Id="inbox"/>
</m:ParentFolderId>
<m:RelativeFolderPath>
<t:Folder>
<t:DisplayName>MyFirstLevelFolder</t:DisplayName>
</t:Folder>
<t:Folder>
<t:DisplayName>MySecondLevelFolder</t:DisplayName>
</t:Folder>
<t:Folder>
<t:DisplayName>MyThirdLevelFolder</t:DisplayName>
</t:Folder>
</m:RelativeFolderPath>
</m:CreateFolderPath>
</soap:Body>
</soap:Envelope>
要求 SOAP 本文には、次の要素が含まれています。
CreateFolderPath 操作の応答が成功しました
次の例は、既定の受信トレイ フォルダーの深いフォルダー階層 3 つのフォルダーを作成するための CreateFolderPath 操作要求に対する正常な応答を示しています。
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:CreateFolderPathResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:CreateFolderPathResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AAMkADEzOTExYisXAAA=" ChangeKey="AQAAABYAABq6Wxb"/>
<t:DisplayName>MyFirstLevelFolder</t:DisplayName>
<t:TotalCount>0</t:TotalCount>
<t:ChildFolderCount>0</t:ChildFolderCount>
<t:UnreadCount>0</t:UnreadCount>
</t:Folder>
</m:Folders>
</m:CreateFolderPathResponseMessage>
<m:CreateFolderPathResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AAMkADEzOTExm4QrAABqxisYAAA=" ChangeKey="AQAAABYAAAm4QrAABq6Wxg"/>
<t:DisplayName>MySecondLevelFolder</t:DisplayName>
<t:TotalCount>0</t:TotalCount>
<t:ChildFolderCount>0</t:ChildFolderCount>
<t:UnreadCount>0</t:UnreadCount>
</t:Folder>
</m:Folders>
</m:CreateFolderPathResponseMessage>
<m:CreateFolderPathResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AAMkADEzOTAABqxisZAAA=" ChangeKey="AQAAABYAA6Wxl"/>
<t:DisplayName>MyThirdLevelFolder</t:DisplayName>
<t:TotalCount>0</t:TotalCount>
<t:ChildFolderCount>0</t:ChildFolderCount>
<t:UnreadCount>0</t:UnreadCount>
</t:Folder>
</m:Folders>
</m:CreateFolderPathResponseMessage>
</m:ResponseMessages>
</m:CreateFolderPathResponse>
</s:Body>
</s:Envelope>
応答 SOAP 本文には、次の要素が含まれています。
CreateFolderPath 操作エラー応答
次の例は、 CreateFolderPath 操作要求に対するエラー応答を示しています。 これは、2 つのフォルダーを作成する要求に対する応答であり、最初のフォルダーには表示名プロパティが設定されていません。 階層の最初のフォルダーは、表示名プロパティなしでは作成できません。また、階層内の親フォルダーが作成されていないため、2 つ目のフォルダーを作成できません。
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15" MinorVersion="0"
MajorBuildNumber="556"
MinorBuildNumber="14"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:CreateFolderPathResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:CreateFolderPathResponseMessage ResponseClass="Error">
<m:MessageText>The folder save operation failed due to invalid property values.</m:MessageText>
<m:ResponseCode>ErrorFolderSavePropertyError</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:FieldURI FieldURI="folder:DisplayName"/>
</m:MessageXml>
<m:Folders/>
</m:CreateFolderPathResponseMessage>
<m:CreateFolderPathResponseMessage ResponseClass="Error">
<m:MessageText>The specified parent folder could not be found.</m:MessageText>
<m:ResponseCode>ErrorParentFolderNotFound</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:Folders/>
</m:CreateFolderPathResponseMessage>
</m:ResponseMessages>
</m:CreateFolderPathResponse>
</s:Body>
</s:Envelope>
エラー応答 SOAP 本文には、次の要素が含まれています。
EWS に汎用であり、この操作に固有のその他のエラー コードについては、「 ResponseCode」を参照してください。