Operação AddNewTelUriContactToGroup
Encontre informações sobre como usar a operação AddNewTelUriContactToGroup EWS.
A operação AddNewTelUriContactToGroup adiciona um novo contato a um grupo com base no número de telefone de um contato.
This operation was introduced in Exchange Server 2013.
Usando a operação AddNewTelUriContactToGroup
Uma solicitação de operação AddNewTelUriContactToGroup envia um URI TEL, URI SIP, número de telefone e o grupo ao qual adicionar o contato. Uma resposta de operação AddNewTelUriContactToGroup cria uma persona para o novo contato. Essa operação permite que os clientes adicionem um novo contato mesmo que o contato não tenha um nome.
Cabeçalhos SOAP da operação AddNewTelUriContactToGroup
A operação AddNewTelUriContactToGroup pode usar os cabeçalhos SOAP listados na tabela a seguir.
| Nome de cabeçalho | Elemento | Descrição |
|---|---|---|
| Representação |
ExchangeImpersonation |
Identifica o usuário que o aplicativo cliente está representando. Esse cabeçalho é aplicável a uma solicitação. |
| MailboxCulture |
MailboxCulture |
Identifica a cultura, conforme definido no RFC 3066, "Marcas para a Identificação de Idiomas", a ser usada para acessar a caixa de correio. Esse cabeçalho é aplicável a uma solicitação. |
| RequestVersion |
RequestServerVersion |
Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação. |
| Serverversion |
ServerVersionInfo |
Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta. |
Exemplo de solicitação de operação AddNewTelUriContactToGroup: Adicionar um novo contato a um grupo
O exemplo a seguir de uma solicitação de operação AddNewTelUriContactToGroup mostra como criar um novo contato e adicionar o novo contato a um grupo de mensagens instantâneas (IM) usando as URIs TEL e SIP do contato.
Observação
Todos os identificadores de item e chaves de alteração neste artigo foram encurtados para preservar a legibilidade.
<?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>
O corpo SOAP de solicitação contém os seguintes elementos:
Resposta bem-sucedida da operação AddNewTelUriContactToGroup
O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação AddNewTelUriContactToGroup para criar um contato. A resposta contém o identificador de persona associado para o contato, o nome de exibição da persona, que nesse caso se baseia no número de telefone do contato e no identificador de item do contato, que é exibido como parte da atribuição do identificador de origem.
<?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>
O corpo SOAP de resposta contém os seguintes elementos:
Exemplo de resposta de erro de operação AddNewTelUriContactToGroup
O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação AddNewTelUriContactToGroup quando o identificador de grupo contém um valor bem formado que não identifica um grupo na caixa de correio.
<?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>
O corpo SOAP de resposta de erro contém os seguintes elementos: