Alert Relay (versión preliminar)

Alert Relay ayuda a reemplazar la retirada de alertas de SharePoint con notificaciones modernas más enriquecidas. Devuelve cambios detallados de nivel de campo, así como HTML de alerta listo para usar, por lo que puede mostrar exactamente lo que cambió en lugar de las notificaciones modificadas genéricas. También puede usar la información de cambios y versiones en las decisiones y condiciones del flujo.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - regiones de Azure Government
     - Azure regiones de China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Name compatibilidad con independNET
URL https://independnet.com.au/alert-relay/support
Correo Electrónico support@alertbridge.com.au
Metadatos del conector
Publicador independNET Software
Sitio web https://independnet.com.au/alert-relay/
Directiva de privacidad https://independnet.com.au/alert-relay/privacy
Categorías Colaboración; Productividad

Retransmisión de alertas

Alert Relay para Power Platform y Microsoft 365 Copilot

Alert Relay ayuda a las organizaciones a reemplazar las alertas clásicas de SharePoint por soluciones modernas de Power Automate y Copilot Studio. Compara SharePoint elementos, archivos y páginas con versiones anteriores y devuelve información de cambio estructurada, historial de versiones y contenido de notificación listo para usar sin necesidad de que los creadores compilen una lógica compleja de comparación de versiones SharePoint.

Overview

SharePoint desencadenadores pueden identificar que un elemento, archivo o página ha cambiado, pero no proporcionan una comparación completa de los valores anteriores y actuales.

La creación de esa comparación a menudo requiere que los creadores recuperen versiones, interpreten tokens de cambio, comparen campos y dar formato a los resultados para las notificaciones o el procesamiento de bajada.

Alert Relay centraliza que funcionan mediante acciones reutilizables para Power Automate y Copilot Studio.

Características clave

Alert Relay centraliza que funcionan mediante acciones reutilizables que pueden:

  • identificar cambios detallados en el nivel de campo
  • devolver valores de campo anteriores y actuales
  • generar HTML listo para usar para SharePoint correos electrónicos de alerta
  • recuperar historial de versiones de elementos, archivos y páginas
  • comparar desde un token de desencadenador, cambiar token, etiqueta de versión o fecha
  • dar formato a tipos de campo de SharePoint complejos admitidos
  • devolver información estructurada para Power Automate y Microsoft 365 Copilot

Alert Relay admite listas de SharePoint, bibliotecas de documentos y bibliotecas de páginas de sitio.

Introducción

Un flujo de alertas de SharePoint típico incluye:

  1. Un desencadenador SharePoint, como Cuando se crea o modifica un elemento.
  2. Una acción de Retransmisión de alertas, como Obtener cambios de elemento o archivo como HTML de alerta.
  3. Un correo electrónico u otra acción de notificación que usa el asunto devuelto y el cuerpo HTML.

Para las condiciones, el formato personalizado o los escenarios del agente de Microsoft Copilot Studio, use Obtener cambios detallados de elementos o archivos y trabaje con la información de cambio estructurada que devuelve.

Para las versiones de SharePoint históricas, use Obtener historial de versiones de archivo o elemento.

Documentation

La documentación, la información de referencia de acciones, los ejemplos y las instrucciones de introducción están disponibles en:

Documentación de Alert Relay

Tutoriales en vídeo

Los tutoriales, ejemplos y vídeos de procedimientos paso a paso están disponibles en el canal de YouTube de Alert Relay:

Alert Relay en YouTube

Licencias y evaluación

Las licencias de Alert Relay son en todo el inquilino. Una sola versión de prueba o suscripción se aplica en el inquilino de Microsoft Entra, y sus unidades de uso se comparten mediante flujos y usuarios de Alert Relay en ese inquilino.

La prueba de 90 días se inicia automáticamente cuando cualquier acción de Alert Relay se ejecuta por primera vez en el inquilino e incluye 300 unidades de uso compartidas en la prueba. Para obtener más detalles y planes actuales, consulte Precios y licencias de Alert Relay.

Acciones

Obtener cambios detallados de elementos o archivos

Devuelve cambios detallados de nivel de campo entre la versión actual de un elemento, archivo o página de SharePoint y una versión anterior.

La acción devuelve información estructurada, incluidos los valores anteriores y actuales, los valores con formato y los metadatos de comparación. Úselo cuando un flujo o Microsoft Copilot Studio agente necesite inspeccionar, resumir o actuar sobre cambios individuales.

Obtener cambios de elemento o archivo como HTML de alerta

Genera HTML listo para usar que muestra lo que cambió en un elemento, archivo o página de SharePoint.

La acción también devuelve un asunto de correo electrónico sugerido, el título del elemento y el vínculo del elemento. Úselo para crear correos electrónicos de alertas SharePoint más enriquecidos sin crear expresiones complejas de comparación de HTML y versiones en cada flujo.

Obtener historial de versiones de elemento o archivo

Devuelve el historial de versiones enlazadas y paginables para un elemento, archivo o página de SharePoint.

La acción puede devolver campos SharePoint seleccionados y admite límites de versión, fecha y SharePoint desencadenador-token. Úselo para escenarios históricos de revisión, auditoría, informes, aprobación y flujo de trabajo compatible con versiones.

Análisis de la información de versión de SharePoint

Descodifica SharePoint información de la ventana del desencadenador y del token de cambio.

Use esta acción para recuperar la marca de tiempo del token, aplicar decisiones basadas en la fecha o la versión, y filtrar desencadenadores secundarios o borradores no deseados antes de llamar a una acción de cambio detallada.

Usos típicos

Alert Relay puede ayudarle a:

  • reemplazar alertas de SharePoint clásicas por flujos de Power Automate
  • enviar notificaciones con formato que muestran exactamente lo que cambió
  • comparar valores anteriores y actuales para campos empresariales importantes
  • realizar un seguimiento de los cambios en los metadatos del documento y las páginas de SharePoint
  • recuperar SharePoint historial de versiones de archivo y elemento
  • compilar flujos de trabajo de aprobación, revisión, gobernanza y auditoría
  • proporcionar información de cambio SharePoint estructurada a Microsoft 365 Copilot

Autenticación y acceso

Alert Relay usa Microsoft Entra ID autenticación delegada.

SharePoint acceso se realiza en el contexto del usuario que ha iniciado sesión. Alert Relay no concede a los usuarios permisos adicionales de SharePoint, por lo que los usuarios ya deben tener acceso al sitio, lista, biblioteca, elemento o archivo pertinentes de SharePoint.

Requisitos y ámbito admitido

  • Alert Relay admite SharePoint Online. no se admite SharePoint Server local.
  • Las acciones se ejecutan cuando Power Automate u otro cliente compatible. Para las notificaciones de cambio, use un desencadenador de SharePoint adecuado para iniciar el flujo.
  • Las comparaciones que usan tokens de desencadenador de SharePoint se basan en la ventana de desencadenador de SharePoint. La línea base resultante puede diferir de un límite de versión específico del elemento.
  • El formato detallado está disponible para los tipos de campo de SharePoint admitidos. Consulte la documentación de Alert Relay para obtener la referencia de tipo de campo actual.

Support

Sitio web: https://independnet.com.au/alert-relay/

Soporte técnico: https://independnet.com.au/alert-relay/support

Correo electrónico: support@alertrelay.com.au

Directiva de privacidad: https://independnet.com.au/alert-relay/privacy

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Análisis de la información de versión de SharePoint

Descodifica un token de SharePoint Comparar desde. Cuando también se proporciona el número de versión y la fecha de modificación, determina si el elemento o el archivo es una nueva versión. Use esta acción no facturable en condiciones de flujo antes de llamar a acciones facturables de Alert Relay.

Obtener cambios de elemento o archivo como HTML de alerta

Devuelve HTML de Alert Relay listo para usar para SharePoint cambios de elementos, diseñados principalmente para correos electrónicos de alertas, pero también se pueden usar en cualquier lugar que se admita HTML. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Obtener cambios detallados de elementos o archivos

Recupera cambios detallados y con formato de nivel de campo para un elemento o archivo de SharePoint list, comparando la versión actual con una versión anterior. Úselo cuando desee datos de cambios enriquecidos, no solo los indicadores de cambio verdaderos o falsos integrados SharePoint. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Obtener historial de versiones de elemento o archivo

Devuelve hasta el número solicitado de versiones para un SharePoint list elemento o archivo, más reciente primero. Cada versión incluye detalles de versión, valores de columna, valores de texto con formato e indicadores que muestran qué columnas cambiaron de la versión disponible anterior. Seleccione el sitio y la lista o biblioteca al configurar esta acción para que sus columnas estén disponibles como contenido dinámico. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Análisis de la información de versión de SharePoint

Descodifica un token de SharePoint Comparar desde. Cuando también se proporciona el número de versión y la fecha de modificación, determina si el elemento o el archivo es una nueva versión. Use esta acción no facturable en condiciones de flujo antes de llamar a acciones facturables de Alert Relay.

Parámetros

Nombre Clave Requerido Tipo Description
Comparar desde
compareFrom True string

TriggerWindowStartToken o token de cambio de SharePoint sin procesar para descodificar. Esta acción no admite etiquetas de versión ni valores de fecha y hora ISO.

Número de versión
versionNumber string

Número de versión del desencadenador o acción de SharePoint, como 0.1, 1.0 o 1.5. Se usa para identificar versiones secundarias o borradores.

Fecha de modificación
modifiedDate date-time

Fecha de modificación del desencadenador o acción de SharePoint. Se usa para detectar si la versión visible SharePoint ha cambiado durante la ventana del desencadenador.

Incluir versiones secundarias
includeMinorVersions boolean

Si los números de versión secundaria o borrador deben contarse como nuevas versiones. El valor predeterminado es False.

Timezone
timezone string

Zona horaria opcional para los valores de comparación local, como "America/New_York", "Europe/London" o "Australia/Sydney" (id. de zona horaria de IANA). Si se omite, solo se devuelve el valor UTC.

Devoluciones

Nombre Ruta de acceso Tipo Description
Success
success boolean

True cuando la información de versión se ha analizado correctamente; false cuando se produce un error de validación o procesamiento.

Message
message string

Mensaje orientado al usuario que describe el resultado de la operación. Los agentes y copilotos deben mostrar este mensaje al usuario cuando contiene información de prueba, suscripción, uso, advertencia o procesamiento de versiones.

Hora UTC de fecha y hora del token
tokenDateTimeUTC date-time

Fecha y hora del token Comparar desde, devuelto en UTC.

Fecha y hora del token local
tokenDateTimeLocal date-time

Fecha y hora del token Comparar desde, convertido en la zona horaria seleccionada.

Token descodificado
decodedToken string

Sin procesar SharePoint cambiar token después de la descodificación. Si Compare From ya era un token sin formato, coincide con el valor proporcionado.

Is Base64 Token
isBase64Token boolean

True cuando el token entrante estaba codificado en base64.

Sequence
sequence integer

Valor de secuencia de cambios de SharePoint incrustado en el token.

GUID de lista
listGuid uuid

GUID de lista o biblioteca insertado en el token.

Versión del token
tokenVersion integer

Número de versión del token.

Tipo de token
tokenType integer

Número de tipo de token de SharePoint.

Se detectó una nueva versión
isNewVersionDetected boolean

True cuando los metadatos de desencadenador o acción proporcionados muestran una nueva versión visible SharePoint debe procesarse. False cuando se debe omitir la versión. Null cuando no hay suficientes metadatos para determinar.

Es la versión secundaria
isMinorVersion boolean

True cuando el número de versión proporcionado es una versión secundaria o de borrador. Null cuando no se proporcionó el número de versión.

Es la primera versión secundaria
isFirstMinorVersion boolean

True cuando el número de versión proporcionado es la primera versión secundaria o borrador, normalmente 0.1. Null cuando no se proporcionó el número de versión.

Es la primera versión principal
isFirstMajorVersion boolean

True cuando el número de versión proporcionado es la primera versión principal o publicada, normalmente 1.0. Null cuando no se proporcionó el número de versión.

Fecha de modificación UTC
modifiedDateUtc date-time

Fecha de modificación proporcionada normalizada a UTC. Null cuando no se proporcionó fecha de modificación.

Fecha de modificación local
modifiedDateLocal date-time

Fecha de modificación proporcionada convertida en la zona horaria seleccionada. Null cuando no se proporcionó fecha o zona horaria modificadas.

Error
error string

Detalles del error si se ha realizado correctamente es false.

Obtener cambios de elemento o archivo como HTML de alerta

Devuelve HTML de Alert Relay listo para usar para SharePoint cambios de elementos, diseñados principalmente para correos electrónicos de alertas, pero también se pueden usar en cualquier lugar que se admita HTML. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Dirección URL del sitio
siteUrl True string

Seleccione un sitio SharePoint o escriba la dirección URL del sitio.

Lista o biblioteca
listId True string

Seleccione una lista o biblioteca, o escriba su título o GUID.

Id. de elemento
itemId True integer

Id. del elemento o archivo de SharePoint para analizar los cambios.

Comparar desde
triggerWindowStartToken string

Punto de partida para la comparación. Use el desencadenador de SharePoint TriggerWindowStartToken cuando esté disponible. También puede escribir una etiqueta de versión, un token de cambio sin procesar o una fecha y hora de línea base. Los valores de solo fecha usan medianoche en la zona horaria seleccionada o UTC si no se selecciona ninguna zona horaria. Deje en blanco para comparar con la versión anterior.

Incluir versiones secundarias
includeMinorVersions boolean

Si se deben incluir versiones secundarias o de borrador al comparar los cambios. El valor predeterminado es false, por lo que solo se comparan las versiones principales.

Incluir campos sin cambios
includeUnchangedFields boolean

Si los campos no modificados deben incluirse en el CÓDIGO HTML generado. El valor predeterminado es true.

Formato de fecha
dateFormat string

Formato usado para los campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa"). El valor predeterminado es "aaaa-MM-dd".

Formato de hora
timeFormat string

Formato usado para la parte de hora de los campos DateTime (por ejemplo, HH:mm:ss, HH:mm, hh:mm tt). El valor predeterminado es HH:mm:ss.

Timezone
timezone string

Zona horaria usada al dar formato a fechas y horas (por ejemplo, Estados Unidos/New_York, Europa/Londres, Australia/Sídney). El valor predeterminado es UTC.

Devoluciones

Nombre Ruta de acceso Tipo Description
Success
success boolean

True cuando la acción se completó correctamente; false cuando se produce un error de validación o procesamiento.

Message
message string

Mensaje orientado al usuario que describe el resultado de la operación. Los agentes y copilotos deben mostrar este mensaje al usuario cuando contiene información de prueba, suscripción, uso, advertencia o procesamiento de versiones.

Mostrar aviso de usuario
shouldDisplayUserNotice boolean

Indica si Alert Relay devolvió una evaluación, suscripción o aviso de uso importante para el usuario.

Código de aviso de usuario
userNoticeCode string

Motivo estable de lectura automática para el aviso del usuario.

Gravedad del aviso del usuario
userNoticeSeverity string

Gravedad de presentación para el aviso del usuario: información, advertencia o crítica.

Aviso del usuario
userNotice string

Información importante sobre la versión de prueba, la suscripción o el uso de Alert Relay.

Llamada a la acción de aviso de usuario
userNoticeCallToAction string

Lo que el usuario puede hacer a continuación, incluido el sitio web de Alert Relay y el correo electrónico de soporte técnico.

Cuerpo HTML
htmlBody string

Se admite el cuerpo HTML del mensaje de alerta, listo para usarse en el correo electrónico o en cualquier lugar en el que se admita HTML.

Sujeto de alerta generado
subject string

Línea de asunto sugerida para la alerta

Nombre de elemento o archivo
itemTitle string

Título o nombre de archivo del elemento o archivo modificados.

Dirección URL de elemento o archivo
itemUrl string

Vínculo directo al elemento o archivo modificados SharePoint.

Es nuevo elemento
isNewItem boolean

Determina si la alerta generada describe el elemento o archivo tal como se ha agregado o cambiado.

Error
error string

Detalles del error si el valor correcto es false

Obtener cambios detallados de elementos o archivos

Recupera cambios detallados y con formato de nivel de campo para un elemento o archivo de SharePoint list, comparando la versión actual con una versión anterior. Úselo cuando desee datos de cambios enriquecidos, no solo los indicadores de cambio verdaderos o falsos integrados SharePoint. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Dirección URL del sitio
siteUrl True string

Seleccione un sitio SharePoint o escriba la dirección URL del sitio.

Lista o biblioteca
listId True string

Seleccione una lista o biblioteca, o escriba su título o GUID.

Id. de elemento
itemId True integer

Id. del elemento o archivo de SharePoint para analizar los cambios.

Comparar desde
triggerWindowStartToken string

Punto de partida para la comparación. Use el desencadenador de SharePoint TriggerWindowStartToken cuando esté disponible. También puede escribir una etiqueta de versión, un token de cambio sin procesar o una fecha y hora de línea base. Los valores de solo fecha usan medianoche en la zona horaria seleccionada o UTC si no se selecciona ninguna zona horaria. Deje en blanco para comparar con la versión anterior.

Incluir versiones secundarias
includeMinorVersions boolean

Si se deben incluir versiones secundarias o de borrador al comparar los cambios. El valor predeterminado es false, por lo que solo se comparan las versiones principales.

Incluir campos sin cambios
includeUnchangedFields boolean

Si los campos no modificados deben incluirse en la respuesta. El valor predeterminado es true.

Formato de fecha
dateFormat string

Formato usado para campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa", "MM/dd/aaaa", "MM/dd/aaaa"). El valor predeterminado es "aaaa-MM-dd".

Formato de hora
timeFormat string

Formato usado para la parte de hora de los campos DateTime (por ejemplo, HH:mm:ss, HH:mm, hh:mm tt). El valor predeterminado es HH:mm:ss.

Timezone
timezone string

Zona horaria usada al dar formato a fechas y horas (por ejemplo, Estados Unidos/New_York, Europa/Londres, Australia/Sídney). El valor predeterminado es UTC.

Devoluciones

Nombre Ruta de acceso Tipo Description
Success
success boolean

True cuando la acción se completó correctamente; false cuando se produce un error de validación o procesamiento.

Message
message string

Mensaje orientado al usuario que describe el resultado de la operación. Los agentes y copilotos deben mostrar este mensaje al usuario cuando contiene información de prueba, suscripción, uso, advertencia o procesamiento de versiones.

Mostrar aviso de usuario
shouldDisplayUserNotice boolean

Indica si Alert Relay devolvió una evaluación, suscripción o aviso de uso importante para el usuario.

Código de aviso de usuario
userNoticeCode string

Motivo estable de lectura automática para el aviso del usuario.

Gravedad del aviso del usuario
userNoticeSeverity string

Gravedad de presentación para el aviso del usuario: información, advertencia o crítica.

Aviso del usuario
userNotice string

Información importante sobre la versión de prueba, la suscripción o el uso de Alert Relay.

Llamada a la acción de aviso de usuario
userNoticeCallToAction string

Lo que el usuario puede hacer a continuación, incluido el sitio web de Alert Relay y el correo electrónico de soporte técnico.

Campos modificados
changedFields array of object

Lista de campos de SharePoint comparados, incluido el nombre de cada campo, el valor anterior, el valor actual y si cambió.

El valor de columna ha cambiado
changedFields.hasChanged boolean

True si el valor de este campo ha cambiado entre la versión anterior y la actual

Valor de columna anterior (texto)
changedFields.previousAsString string

Valor anterior con formato como una cadena legible

Nombre interno del campo
changedFields.internalName string

Nombre interno del campo de SharePoint

Nombre del campo
changedFields.displayName string

Nombre para mostrar descriptivo para el campo

Valor de columna anterior (detallado)
changedFields.previous

Valor anterior sin formato. Esta propiedad es dinámica y puede ser una cadena, un número, un valor booleano, un objeto, una matriz o un valor NULL según el tipo de campo de SharePoint.

Valor de columna actual (texto)
changedFields.currentAsString string

Valor actual con formato como una cadena legible

Valor de columna actual (detallado)
changedFields.current

Valor actual sin formato. Esta propiedad es dinámica y puede ser una cadena, un número, un valor booleano, un objeto, una matriz o un valor NULL según el tipo de campo de SharePoint.

Tiene línea base de comparación
hasComparisonBaseline boolean

True si se resolvió una versión de línea base distinta para la comparación con la versión actual.

Es la primera versión de línea base
isBaselineFirstVersion boolean

True si la versión de línea base resuelta es la primera versión registrada para el elemento o archivo.

Es nuevo elemento
isNewItem boolean

True cuando el elemento o archivo debe tratarse como nuevo para la ventana de comparación resuelta en lugar de como una actualización.

Etiqueta de versión actual
currentVersionLabel string

Etiqueta de versión de la versión actual (por ejemplo, "2.0", "5.0")

Etiqueta de versión anterior
previousVersionLabel string

Etiqueta de versión usada para la comparación (por ejemplo, "1.0", "4.0")

Nombre de elemento o archivo
itemTitle string

Título o nombre de archivo del elemento o archivo modificados.

Dirección URL de elemento o archivo
itemUrl string

Vínculo directo al elemento o archivo modificados SharePoint.

Fecha de modificación
modifiedDate date-time

Fecha y hora de la última modificación.

Modificado por
modifiedBy string

Nombre para mostrar del usuario que modificó por última vez el elemento

Error
error string

Detalles del error si el valor correcto es false

Obtener historial de versiones de elemento o archivo

Devuelve hasta el número solicitado de versiones para un SharePoint list elemento o archivo, más reciente primero. Cada versión incluye detalles de versión, valores de columna, valores de texto con formato e indicadores que muestran qué columnas cambiaron de la versión disponible anterior. Seleccione el sitio y la lista o biblioteca al configurar esta acción para que sus columnas estén disponibles como contenido dinámico. Los resultados pueden incluir una importante evaluación, suscripción o aviso de uso de Alert Relay para el usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Dirección URL del sitio
siteUrl True string

Seleccione un sitio SharePoint o escriba la dirección URL del sitio.

Lista o biblioteca
listId True string

Seleccione la lista o biblioteca cuyas columnas de versión deben estar disponibles como contenido dinámico en el flujo.

Id. de elemento
itemId True integer

SharePoint list id. de elemento. Esto se puede proporcionar dinámicamente en tiempo de ejecución, por ejemplo, desde un desencadenador de SharePoint o una acción de flujo anterior.

Unidades de uso máximas
maximumUsageUnits True integer

Límite necesario seleccionado por el autor de la llamada en las unidades de uso que puede consumir esta llamada. De manera predeterminada, su valor es 1. Se trata de una protección de facturación, no un límite de recuento de versiones; una unidad de uso puede devolver varias versiones completas. Use Versiones máximas para limitar el número de filas de versión.

Versiones máximas
maximumVersions integer

Número total máximo de filas de versión completas que se devolverán en todas las páginas. Deje en blanco para continuar hasta que finalice el intervalo seleccionado, el historial disponible o el presupuesto de unidad de uso. Cada respuesta no contiene más de 100 versiones.

Campos que se van a devolver
fieldsToReturn array of string

SharePoint columnas que se van a incluir en cada versión. Agregue una columna por elemento. Deje Campos en Devolver vacío para devolver todas las columnas admitidas. La selección de menos columnas puede reducir el tamaño de respuesta y el trabajo de unidad de uso.

Comparar desde
fromVersion string

Punto de partida para el intervalo de historial de versiones. Use el desencadenador de SharePoint TriggerWindowStartToken cuando esté disponible. También puede escribir una etiqueta de versión, un token de cambio sin procesar o una fecha y hora de línea base. Los valores de solo fecha usan medianoche en la zona horaria seleccionada o UTC si no se selecciona ninguna zona horaria. Deje en blanco ningún límite anterior.

Comparar con
toVersion string

Punto final del intervalo de historial de versiones. Use el desencadenador de SharePoint TriggerWindowEndToken cuando esté disponible. También puede escribir una etiqueta de versión, un token de cambio sin procesar o una fecha y hora. Los valores de solo fecha usan medianoche en la zona horaria seleccionada o UTC si no se selecciona ninguna zona horaria. Deje en blanco ningún límite más reciente.

Token de paginación
continuationToken string

Token usado para recuperar la página siguiente del historial de versiones, si una se devolvió mediante una llamada anterior.

Incluir versiones secundarias
includeMinorVersions boolean

Si se deben incluir versiones secundarias o de borrador al recuperar el historial de versiones. El valor predeterminado es false, por lo que solo se devuelven las versiones principales.

Formato de fecha
dateFormat string

Formato usado para campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa", "MM/dd/aaaa", "MM/dd/aaaa"). El valor predeterminado es "aaaa-MM-dd".

Formato de hora
timeFormat string

Formato usado para la parte de hora de los campos DateTime (por ejemplo, HH:mm:ss, HH:mm, hh:mm tt). El valor predeterminado es HH:mm:ss.

Timezone
timezone string

Zona horaria usada al dar formato a fechas y horas (por ejemplo, Estados Unidos/New_York, Europa/Londres, Australia/Sídney). El valor predeterminado es UTC.

Devoluciones

Las salidas de esta operación son dinámicas.