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:
- Un desencadenador SharePoint, como Cuando se crea o modifica un elemento.
- Una acción de Retransmisión de alertas, como Obtener cambios de elemento o archivo como HTML de alerta.
- 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:
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:
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 Share |
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. |