AddNewTelUriContactToGroup 操作
AddNewTelUriContactToGroup EWS 操作の使用方法について説明します。
AddNewTelUriContactToGroup 操作は、連絡先の電話番号に基づいて新しい連絡先をグループに追加します。
この操作は Exchange Server 2013 で導入されました。
AddNewTelUriContactToGroup 操作の使用
AddNewTelUriContactToGroup 操作要求は、連絡先の TEL URI、SIP URI、電話番号、連絡先を追加するグループを送信します。 AddNewTelUriContactToGroup 操作応答により、新しい連絡先のペルソナが作成されます。 この操作により、連絡先に名前がない場合でも、クライアントは新しい連絡先を追加できます。
AddNewTelUriContactToGroup 操作 SOAP ヘッダー
AddNewTelUriContactToGroup 操作では、次の表に示す SOAP ヘッダーを使用できます。
| ヘッダー名 | 要素 | 説明 |
|---|---|---|
| 偽装 |
ExchangeImpersonation |
クライアント アプリケーションが偽装しているユーザーを識別します。 このヘッダーは要求に適用されます。 |
| MailboxCulture |
MailboxCulture |
RFC 3066 で定義されている "言語の識別用タグ" で定義されているカルチャを識別し、メールボックスにアクセスするために使用します。 このヘッダーは要求に適用されます。 |
| RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 このヘッダーは要求に適用されます。 |
| ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 このヘッダーは、応答に適用できます。 |
AddNewTelUriContactToGroup 操作要求の例: 新しい連絡先をグループに追加する
次の AddNewTelUriContactToGroup 操作要求の例は、連絡先の TEL と SIP URI を使用して、新しい連絡先を作成し、インスタント メッセージング (IM) グループに新しい連絡先を追加する方法を示しています。
注:
この記事のすべての項目識別子と変更キーは、読みやすくするために短縮されています。
<?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>
</soap:Header>
<soap:Body >
<m:AddNewTelUriContactToGroup>
<m:TelUriAddress>tel:5625550100</m:TelUriAddress>
<m:ImContactSipUriAddress>sip:john@contoso.com</m:ImContactSipUriAddress>
<m:ImTelephoneNumber>5625550100</m:ImTelephoneNumber>
<m:GroupId Id="AAMkADEzOTm4QrAABY7+0GAAA="/>
</m:AddNewTelUriContactToGroup>
</soap:Body>
</soap:Envelope>
要求 SOAP 本文には、次の要素が含まれています。
AddNewTelUriContactToGroup 操作の応答が成功しました
次の例は、連絡先を作成するための AddNewTelUriContactToGroup 操作要求に対する正常な応答を示しています。 応答には、連絡先の関連付けられたペルソナ識別子、ペルソナの表示名が含まれます。この場合は連絡先の電話番号に基づいており、連絡先のアイテム識別子はソース識別子属性の一部として表示されます。
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="545"
MinorBuildNumber="11"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types" />
</s:Header>
<s:Body>
<AddNewTelUriContactToGroupResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<Persona>
<t:PersonaId Id="AAQkADE686dX3s="/>
<t:PersonaType>Person</t:PersonaType>
<t:CreationTime>2012-10-29T23:10:13Z</t:CreationTime>
<t:DisplayName/>
<t:DisplayNameFirstLast>5625550100</t:DisplayNameFirstLast>
<t:DisplayNameLastFirst>5625550100</t:DisplayNameLastFirst>
<t:FileAs/>
<t:FileAsId >None</t:FileAsId>
<t:RelevanceScore >2147483647</t:RelevanceScore>
<t:Attributions>
<t:Attribution>
<t:Id>0</t:Id>
<t:SourceId Id="ABhHuhCAAA=" ChangeKey="EQAAABxFU"/>
<t:DisplayName>Lync Contacts</t:DisplayName>
<t:IsWritable>false</t:IsWritable>
<t:IsQuickContact>true</t:IsQuickContact>
<t:IsHidden>false</t:IsHidden>
</t:Attribution>
</t:Attributions>
<t:FileAsIds>
<t:StringAttributedValue>
<t:Value>None</t:Value>
<t:Attributions>
<t:Attribution>0</t:Attribution>
</t:Attributions>
</t:StringAttributedValue>
</t:FileAsIds>
<t:OtherTelephones>
<t:PhoneNumberAttributedValue>
<t:Value>
<t:Number>5625550100</t:Number>
<t:Type>Other</t:Type>
</t:Value>
<t:Attributions>
<t:Attribution>0</t:Attribution>
</t:Attributions>
</t:PhoneNumberAttributedValue>
</t:OtherTelephones>
</Persona>
</AddNewTelUriContactToGroupResponse>
</s:Body>
</s:Envelope>
応答 SOAP 本文には、次の要素が含まれています。
AddNewTelUriContactToGroup 操作エラー応答の例
次の例は、グループ識別子にメールボックス内のグループを識別しない整形式の値が含まれている場合の AddNewTelUriContactToGroup 操作要求に対するエラー応答を示しています。
<?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="545"
MinorBuildNumber="11"
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">
<AddNewTelUriContactToGroupResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>The specified object was not found in the store.</MessageText>
<ResponseCode>ErrorItemNotFound</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</AddNewTelUriContactToGroupResponse>
</s:Body>
</s:Envelope>
エラー応答 SOAP 本文には、次の要素が含まれています。