Leer en inglés

Compartir a través de

Operación AddEntityFeedback

  • Artículo

La operación AddEntityFeedback devuelve información de error correspondiente a problemas del lado servidor.

Esta operación se basa en el tipo de evento que se registra. Uno de los eventos más importantes es EntityAdded, que corresponde a una entidad que se está seleccionando. Esta operación es por lotes, por lo que se puede usar para registrar lotes de entradas en una sola solicitud.

Ejemplos de solicitud FindPeople

La operación AddEntityFeedback proporciona una manera para que los clientes registren detalles de la interacción con las entidades devueltas por el servicio. Esto se puede usar como una señal para mejorar la relevancia en segundo plano para cada cliente. Por ejemplo, los clientes pueden usar esta operación para proporcionar comentarios sobre las entidades de personas devueltas por FindPeople.

XML 
<?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" />
   </soap:Header>
   <soap:Body >
      <m:AddEntityFeedback>
            <m:EntityFeedbackEntries>
                  <t:EntityFeedbackEntry>
                        <t:ClientEventTimeUTC> 2015-07-05T22:16:18+00:00</t:ClientEventTimeUTC>
                        <t:ClientEventTimeLocal> 2015-07-05T22:16:18+00:00</t:ClientEventTimeLocal>
                        <t:ClientSessionId>00000000-0000-0000-0000-000000000012</t:ClientSessionId>
                        <t:ClientVersion>15.01.0101.01</t:ClientVersion>
                        <t:ClientId>Web</t:ClientId>
                        <t:TransactionId>123456789</t:TransactionId>
                        <t:EventType>EntityAdded</t:EventType>
                        <t:TargetEntityList>["a","b","c"]</t:TargetEntityList>
                        <t:SourceOfEntityAdded></t:SourceOfEntityAdded>
                        <t:JSONPropertyBag></t:JSONPropertyBag>
                  </t:EntityFeedbackEntry>
                  <t:EntityFeedbackEntry>
                  …
                  </t:EntityFeedbackEntry>
            </m:EntityFeedbackEntries>
      </m:AddEntityFeedback>
   </soap:Body>
</soap:Envelope>

El contenido del cuerpo soap de la solicitud

La solicitud soap contiene un único elemento EntityFeedbackEntries. A su vez, contiene una matriz de objetos EntityFeedbackEntry . Cada entrada de la matriz puede contener los siguientes elementos.

Parámetros de solicitud Required Descripción Tipo
ClientEventTimeUtc
Sí
 Hora UTC en la que se produjo el evento en el lado cliente.
DateTime
ClientEventTimeLocal
Sí
 Hora local en la que se produjo el evento en el lado cliente.
DateTime
ClientId
Yes
 Tipo de cliente (por ejemplo, Outlook, OWA, etc.).
ClientIDType (enumeración)
ClientSessionId
Sí
 GUID Identificación del identificador de sesión. Se genera en el cliente.
GUID
ClientVersion
Sí
 Versión del cliente (por ejemplo, 15.01.0101.000).
Cadena
EntityAddSource
No
 Origen de EntityAded (por ejemplo, EntityRelevanceAPI, tipos, pegado).
EntityAddSource (enumeración)
EntrySequenceNumber
Yes
 Entero incremental por sesión de cliente. Se usa para detectar la pérdida de datos.
Int
EventType
Yes
 Tipo de evento (por ejemplo, Entity Added, Entity Removed).
Cadena
JSONPropertyBag
No
 Propiedades adicionales asociadas al evento (blob JSON de pares clave-valor).
JSON Blob
TargetEntityList
No
 Lista de entidades asociadas al evento.
Cadena JSON
TransactionId
No
 Identificador (GUID) que correlaciona el identificador en los registros de consulta.
Cadena

Respuesta correcta de la operación AddEntityFeedback

XML 
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ServerVersionInfo MajorVersion="15" 
                                MinorVersion="1" 
                                MajorBuildNumber="228" 
                                MinorBuildNumber="0" 
                                Version="V2_49" 
                                xmlns:h="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>
        <AddEntityFeedbackResponse ResponseClass="Success" 
                                                              xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
                                                              xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                                                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ResponseCode>NoError</ResponseCode>
            <ErrorCount>0</ErrorCount>
            <ErrorDetails />
        </AddEntityFeedbackResponse>
    </s:Body>
</s:Envelope>

El cuerpo soap de respuesta contiene los siguientes elementos.

Errores

La API puede registrar un lote de entradas de comentarios, registramos todo lo que podemos. Este campo representa el número de entradas de error que no se registraron.

ErrorDetails

Los detalles relacionados con los errores anteriores se separan por ;.

Valores admitidos actualmente

ClientIdType (enumeración)
Escritorio
Exchange
IMAP4
Lync
MacMail
MacOutlook
Móvil
Otros
Outlook
OutlookService
POP3
Tablet
Web
EntityAddSource (enumeración)
ActiveDirectory
EntityRelevanceApi
EntityRelevanceApiCache
ExplicitTyping
LocalCache
LocalCacheAndEntityRelevanceAPI
Ninguno
Otros
Paste

Respuesta de error de la operación AddEntityFeedback

Para obtener códigos de error genéricos para EWS, vea ResponseCode.

Ejemplo de AddEntityFeedback junto con FindPeople

Solicitud FindPeople

XML 
<?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" />
  </soap:Header>
<soap:Body >
    <m:FindPeople>
      <m:IndexedPageItemView BasePoint="Beginning" MaxEntriesReturned="100" Offset="0"/>
      <m:QueryString>user1</m:QueryString>
      <m:SearchPeopleSuggestionIndex>true</m:SearchPeopleSuggestionIndex>
    </m:FindPeople>
  </soap:Body>
</soap:Envelope>

Respuesta findpeople

XML 
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ServerVersionInfo MajorVersion="15" MinorVersion="1" MajorBuildNumber="302" MinorBuildNumber="0" Version="V2_68" xmlns:h="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>
        <FindPeopleResponse ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ResponseCode>NoError</ResponseCode>
            <People>
                <Persona xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                    <PersonaId Id="AAUQAFjZ4UxX8SZCqSPFsmh0cSo=" />
                    <PersonaType>Person</PersonaType>
                    <CreationTime>2015-10-02T23:25:42</CreationTime>
                    <DisplayName>user2</DisplayName>
…
                  </Persona>
            </People>
            <TotalNumberOfPeopleInView>0</TotalNumberOfPeopleInView>
            <FirstMatchingRowIndex>0</FirstMatchingRowIndex>
            <FirstLoadedRowIndex>0</FirstLoadedRowIndex>
            <TransactionId>b56ad16e-5d5a-4574-90f8-b8dd57382be6</TransactionId>
        </FindPeopleResponse>
    </s:Body>
</s:Envelope>

Solicitud AddEntityFeedback

XML 
<?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" />
   </soap:Header>
   <soap:Body >
      <m:AddEntityFeedback>
<m:EntityFeedbackEntries>
<t:EntityFeedbackEntry>
         <t:ClientEventTimeUtc>2015-07-05T22:16:18+00:00</t:ClientEventTimeUtc>
         <t:ClientEventTimeLocal>2015-07-05T22:16:18+00:00</t:ClientEventTimeLocal>
         <t:ClientSessionId>00000000-0000-0000-0000-000000000012</t:ClientSessionId>
         <t:ClientVersion>15.01.0101.01</t:ClientVersion>
         <t:ClientId>Web</t:ClientId>
         <t:TransactionId>b56ad16e-5d5a-4574-90f8-b8dd57382be6</t:TransactionId>
         <t:EventType>EntityAdded</t:EventType>
         <t:TargetEntityList>["user1@ms7.com"]</t:TargetEntityList>
         <t:SourceOfEntityAdded>EntityRelevanceApi</t:SourceOfEntityAdded>
         <t:JSONPropertyBag></t:JSONPropertyBag>
</t:EntityFeedbackEntry>
</m:EntityFeedbackEntries>
      </m:AddEntityFeedback>
   </soap:Body>
</soap:Envelope>

Nota

Usar el identificador de transacción de respuesta FindPeople como identificador de transacción de solicitud AddEntityFeedback.

Respuesta addEntityFeedback

XML 
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ServerVersionInfo MajorVersion="15" MinorVersion="1" MajorBuildNumber="302" MinorBuildNumber="0" Version="V2_68" xmlns:h="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>
        <AddEntityFeedbackResponse ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <ResponseCode>NoError</ResponseCode>
            <ErrorCount>0</ErrorCount>
            <ErrorDetails />
        </AddEntityFeedbackResponse>
    </s:Body>
</s:Envelope>