Proveedor de id. de documento en el modelo de complemento de SharePoint

Importante

Los complementos de SharePoint alcanzaron la finalización de su vida útil en SharePoint Online el 2 de abril de 2026. Tanto los complementos hospedados por SharePoint como los hospedados por el proveedor se retiran y ya no funcionan en SharePoint Online, incluidas las nubes de administración pública. Las instrucciones de uso, implementación y desarrollo de complementos se conservan como referencia histórica y para escenarios de SharePoint Server aplicables, no para nuevas soluciones de SharePoint Online.

Los complementos de SharePoint Server implementados a través de un catálogo de aplicaciones local no se retiran por este cambio. La adquisición de complementos de SharePoint en el marketplace público finalizó el 2 de abril de 2026 para SharePoint Server.

Esta retirada no retira las API de REST DE SHAREPOINT, CSOM, JSOM o SharePoint Framework (SPFx). Para SharePoint Online, use SPFx para las extensiones de la interfaz de usuario y Microsoft Entra ID para la autenticación en aplicaciones externas. Consulte el anuncio de retirada y las instrucciones de migración de complementos.

El enfoque que adopte para establecer identificadores únicos para documentos en SharePoint es diferente en el nuevo modelo de complementos de SharePoint que con el código de plena confianza. En un escenario típico de código de plena confianza (FTC)/solución de granja de servidores, los controladores de eventos de elementos de lista que ejecutan código del modelo de objetos del lado servidor de SharePoint se usan para establecer identificadores únicos para los documentos y se implementan a través de soluciones de SharePoint.

En un escenario de modelo de complemento de SharePoint, el modelo de objetos del lado cliente (CSOM) de SharePoint o la API REST de SharePoint se usan para establecer identificadores únicos para los documentos.

Directrices importantes

Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para establecer identificadores únicos para documentos en el nuevo modelo de complementos de SharePoint.

  • Use el modelo de objetos del lado cliente (CSOM) de SharePoint o las API de REST de SharePoint para establecer identificadores únicos para los documentos.
  • Actualmente, no hay ningún mecanismo listo para usar compatible para asociar código procesado remoto para reemplazar el proveedor de id. de documento listo para usar, por lo que esta funcionalidad no se admite de forma nativa para modificarse con API remotas.
  • Sin embargo, como en muchos casos con el modelo de complementos, se están explorando rutas alternativas.

¿Cómo se establecen los identificadores únicos en los documentos?

Básicamente, establecer un identificador único para un documento significa establecer el valor de una columna en una lista o biblioteca de documentos de SharePoint.

Las API de SharePoint (CSOM) o REST se pueden usar para establecer valores de columna y, por lo tanto, se pueden usar para establecer identificadores únicos para documentos. Consulte los siguientes artículos para obtener más información sobre estas API y cómo establecer valores de columna con ellas.

Opciones para establecer identificadores únicos para documentos

Tiene varias opciones para establecer identificadores únicos para los documentos almacenados en SharePoint.

  • Usar receptores de eventos remotos
  • Usar un proceso en segundo plano

Usar receptores de eventos remotos

En este patrón, los receptores de eventos remotos se activan cuando se cargan nuevos documentos en las bibliotecas de SharePoint. Los receptores de eventos remotos realizan llamadas API de CSOM o REST para establecer identificadores únicos para los documentos.

  • Este patrón se ejecuta inmediatamente después de cargar un documento en SharePoint.
    • Siempre que el código del servicio asociado con el receptor de eventos remoto se ejecute de forma oportuna, los identificadores de documento se establecen rápidamente después de cargar un nuevo documento en SharePoint.
  • Este patrón solo funciona en documentos nuevos cargados en SharePoint, no establece identificadores únicos para los documentos que ya están almacenados en SharePoint.
  • Las operaciones de carga masiva desencadenarán varias llamadas al servicio asociado con el receptor de eventos remotos. Planifique en consecuencia para asegurarse de que las operaciones de carga masiva no sobrecargarán el servicio.
  • Un receptor de eventos remoto no puede notificar a SharePoint de ninguna manera si se produjera un error al establecer un identificador de documento único.

¿Cuándo es una buena opción?

Cuando necesite establecer identificadores únicos para documentos rápidamente después de cargarlos en SharePoint y no espere operaciones de carga masiva.

Introducción

Event Receivers and List Event Receivers (SharePoint Add-in Recipe) describe cómo implementar receptores de eventos en el modelo de complementos y proporciona vínculos a varios ejemplos y artículos.

Usar un proceso en segundo plano

En este patrón, un proceso en segundo plano comprueba los documentos en SharePoint para determinar si tienen un conjunto de identificador único. Si no se encuentra ningún identificador único para un documento, el proceso en segundo plano establece un identificador único para el documento. El proceso en segundo plano realiza llamadas a la API de CSOM o REST para establecer identificadores únicos para los documentos.

  • Este patrón se ejecuta según la programación que defina.
  • Este patrón funciona en todos los documentos en los que se escribe el código de rastreo.
  • Sugerimos usar el servicio de búsqueda de SharePoint para ejecutar consultas que incluyan filtros para devolver una lista de documentos que no tienen identificadores únicos establecidos.
    • Este patrón funciona más rápido y se escala mejor que cualquier otro patrón de consulta.
    • Este patrón elimina la lógica de consulta personalizada del servicio en segundo plano.
    • Este patrón requiere cierta configuración de búsqueda.
    • Para obtener más información sobre la configuración de búsqueda, vea Configuración de búsqueda (receta del complemento de SharePoint).
  • No se recomienda consultar y devolver metadatos recursivos sobre todos los documentos en un entorno de SharePoint mediante el bucle a través de objetos web y de lista.
    • Este patrón funciona más lento y se escala peor que cualquier otro patrón de consulta.
    • Puede encontrar límites de API cuando se utiliza este patrón.
    • Este patrón incluye lógica de consulta personalizada en el servicio en segundo plano.
    • Este patrón se puede implementar con un trabajo web de Azure.

¿Cuándo es una buena opción?

  • Cuando necesite establecer identificadores únicos para documentos y receptores de eventos remotos, no tiene a su disposición.
  • Cuando espera tener documentos cargados en masa.
  • Cuando necesite asegurarse de que se han establecido identificadores de documento únicos en los documentos.
    • Un receptor de eventos no puede notificar a SharePoint si no se pudo establecer un identificador de documento único.
  • Cuando necesite procesar documentos ya almacenados en SharePoint.

Introducción

En el documento Trabajos remotos de temporizador (receta del complemento de SharePoint) se describe cómo implementar trabajos de temporizador remotos en el modelo de complemento y se proporcionan vínculos a varios ejemplos y artículos.

Ejemplos de PnP

Se aplica a

  • Office 365 multiempresa (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local