Creación, actualización y eliminación de elementos agregados por la aplicación al índice del servicio Búsqueda de MicrosoftCreate, update, and delete items added by your application in the Microsoft Search service index

Los elementos agregados por la aplicación al servicio Búsqueda de Microsoft se representan mediante el recurso externalItem de Microsoft Graph.Items added by your application to the Microsoft Search service are represented by the externalItem resource in Microsoft Graph.

Importante

Los conectores de Microsoft Graph están actualmente en estado de versión preliminar pública.Microsoft Graph connectors are currently in public preview status. Para tener acceso a la funcionalidad de los conectores, debe activar la opción de liberación dirigida en su espacio empresarial.To gain access to connectors functionality, you must turn on the Targeted release option in your tenant. Obtenga más información sobre el programa de versión preliminar de conectores.See more details on the connectors preview program.

Agregar una elementoAdd an item

Puede agregar un elemento al índice si crea un elemento externalItem.You can add an item to the index by creating an externalItem. Al crear un elemento, asigne un identificador único en la dirección URL.When you create an item, you assign a unique identifier in the URL.

Por ejemplo, es posible que la aplicación indexe las incidencias de soporte técnico mediante el número de incidencia.For example, your application may index helpdesk tickets using the ticket number. Si el caso tiene el número de caso SR00145, la solicitud puede tener el aspecto siguiente.If a ticket has the ticket number SR00145, the request may look like the following.

PUT /external/connections/contosohelpdesk/items/SR00145
Content-Type: application/json

{
  "title": "WiFi outage in Conference Room A",
  "status": "New",
  "assignee": "meganb@contoso.com"
}

![NOTA] Antes de que los elementos indexados se puedan buscar en la interfaz de usuario de Búsqueda de Microsoft, un administrador debe personalizar la página de resultados de búsqueda para la conexión correspondiente.![NOTE] Before indexed items can be found in the Microsoft Search UI, an administrator must customize the search results page for the corresponding connection.

Actualizar un elementoUpdate an item

Cuando se actualiza un elemento en el servicio externo (se vuelve a asignar una incidencia de soporte técnico o se actualiza una descripción de producto), puede actualizar su entrada en el índice si actualiza el elemento externalItem con el identificador único asignado al elemento al crearlo.When an item is updated in the external service (helpdesk ticket is reassigned, or a product description is updated), you can update its entry in the index by updating the externalItem, using the unique identifier assigned to the item when you created it.

PATCH /external/connections/contosohelpdesk/items/SR00145
Content-Type: application/json

{
  "assignee": "alexw@contoso.com"
}

Eliminar un elementoDelete an item

Puede eliminar elemento del índice si elimina el elemento externalItem con el identificador único asignado al elemento al crearlo.You can remove items from the index by deleting the externalItem, using the unique identifier assigned to the item when you created it.

DELETE /external/connections/contosohelpdesk/items/SR00145

Siguientes pasosNext steps