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 y HTML de alerta listo para usar para que pueda mostrar exactamente lo que cambió en lugar de las notificaciones modificadas genéricas.
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 | productos independNET |
| 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 ayuda a reemplazar las alertas de SharePoint por notificaciones modernas más enriquecidas para entornos de Microsoft 365. Proporciona información detallada sobre los cambios de elementos y documentos de SharePoint, incluidas las comparaciones de nivel de campo con formato y la salida de alerta HTML lista para usar.
Overview
Alert Relay está diseñado para los creadores que desean notificaciones de SharePoint más útiles que la experiencia predeterminada de "elemento modificado".
Es compatible con:
- inspección detallada de cambios de nivel de campo
- Salida HTML lista para usar para correos electrónicos de alerta
- desencadenador del análisis de tokens para las decisiones de línea base y primera ejecución
- Listas de SharePoint
- bibliotecas de documentos
- Páginas de sitio/bibliotecas de páginas
Características clave
1. Seguimiento detallado de cambios
El conector puede comparar la versión actual de un elemento o documento de SharePoint con una versión anterior y devolver detalles de cambio estructurados.
2. Salida de alerta HTML lista para usar
El conector puede generar HTML con formato para que los flujos puedan enviar correos electrónicos de alerta útiles sin crear expresiones HTML complejas manualmente.
3. Desencadenamiento del análisis de tokens
La Parse Compare From acción descodifica tokens de cambio de SharePoint, como TriggerWindowStartToken y devuelve la marca de tiempo insertada y los detalles del token para la toma de decisiones en los flujos.
4. Menús desplegables dinámicos
El conector incluye compatibilidad con la lista desplegable dinámica para:
- Sitios
- listas y bibliotecas
- formatos de fecha
- formatos de hora
- zonas horarias
5. Línea de base de comparación flexible
El conector admite la comparación de:
- Tokens de desencadenador de SharePoint
- tokens de cambio de SharePoint sin procesar
- etiquetas de versión
- Líneas base de fecha y hora ISO 8601
Acciones soportadas
Obtener cambios detallados
Devuelve JSON estructurado que describe los campos modificados, incluidos los valores con formato anterior y actual.
Obtener cambios detallados como HTML de alerta
Devuelve la salida HTML lista para usar y los metadatos de alerta relacionados para el correo electrónico u otros destinos compatibles con HTML.
Análisis de comparación desde
Descodifica un token de cambio o desencadenador de SharePoint y devuelve los detalles de marca de tiempo y token incrustados.
Casos de uso típicos
- Enviar mejores correos electrónicos de alerta de SharePoint cuando cambia un elemento de lista
- Mostrar valores anteriores y actuales para campos empresariales importantes
- Seguimiento de los cambios en los metadatos de la biblioteca de documentos
- Flujos de notificación de aprobación, cumplimiento o auditoría de compilación
- Supresión de alertas ruidosas de primera ejecución mediante la evaluación de las fechas del token de desencadenador en una línea base elegida
Autenticación
Alert Relay usa la autenticación de id. de Microsoft Entra junto con una clave de suscripción de API.
Para usar el conector, un usuario necesita lo siguiente:
- acceso al sitio de SharePoint, la lista o la biblioteca pertinentes
- una conexión válida de Alert Relay
- una clave de suscripción válida de Alert Relay API
Cuando un inquilino usa primero Alert Relay, se coloca automáticamente en modo de prueba. Para salir del modo de prueba, póngase en contacto con support@alertbridge.com.au.
Introducción
Un flujo de validación típico usa:
- Un desencadenador de SharePoint, como
When an item is created or modified - Una acción de Retransmisión de alertas, como
Get Detailed Changes as Alert HTML - Un correo electrónico o un paso De redacción para usar el asunto devuelto y la salida HTML
Para el procesamiento de bajada estructurado, use Get Detailed Changes e itere en la matriz devuelta changedFields .
Problemas conocidos y limitaciones
- Se admite SharePoint Online; No se admite SharePoint Server local.
- El tiempo del desencadenador de SharePoint puede afectar a las comparaciones de primera ejecución porque los tokens de desencadenador reflejan la ventana de desencadenador de SharePoint en lugar de un historial de alertas por elemento.
Support
Sitio web:
Política de privacidad:
Soporte técnico:
Correo electrónico de soporte técnico:
- support@alertbridge.com.au
Notas adicionales
Alert Relay está diseñado para mejorar la facilidad de uso para escenarios de notificación basados en SharePoint al reducir la cantidad de trabajo de expresión personalizada necesaria en los flujos, especialmente para el formato de correo electrónico HTML y la inspección de cambios de nivel de campo.
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 comparación desde |
Descodifica un token de cambio triggerWindowStartToken o SharePoint sin procesar y devuelve la marca de tiempo incrustada para las condiciones de flujo y las decisiones de línea de base. Esta acción no llama a SharePoint. |
| Obtener cambios detallados de elementos |
Recupera cambios detallados y con formato de nivel de campo para un documento o elemento de lista de SharePoint, comparando la versión actual con la versión anterior. Úselo cuando desee datos de cambios enriquecidos en lugar de las marcas de campo true/false integradas de estilo sharePoint. |
| Obtener HTML de alerta de elemento detallado |
Devuelve html de Retransmisión de alertas listo para usar para los cambios de elementos de SharePoint, diseñados principalmente para correos electrónicos de alerta de estilo SharePoint, pero también se pueden usar en documentos u otros destinos compatibles con HTML. |
Análisis de comparación desde
Descodifica un token de cambio triggerWindowStartToken o SharePoint sin procesar y devuelve la marca de tiempo incrustada para las condiciones de flujo y las decisiones de línea de base. Esta acción no llama a SharePoint.
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. |
|
Timezone
|
timezone | string |
Identificador opcional de zona horaria de IANA para un valor de comparación local (por ejemplo, "America/New_York", "Europe/London", "Australia/Sydney"). Si se omite, solo se devuelve el valor UTC. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Hora UTC de fecha y hora del token
|
tokenDateTimeUTC | date-time |
Marca de tiempo del token en UTC. |
|
Fecha y hora del token local
|
tokenDateTimeLocal | date-time |
Marca de tiempo del token convertida en la zona horaria solicitada. |
|
Token descodificado
|
decodedToken | string |
Texto de token sin formato descodificado. Para la entrada de token sin procesar, coincide con el valor original. |
|
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. |
|
Error
|
error | string |
Detalles del error cuando se produce un error en el análisis. |
Obtener cambios detallados de elementos
Recupera cambios detallados y con formato de nivel de campo para un documento o elemento de lista de SharePoint, comparando la versión actual con la versión anterior. Úselo cuando desee datos de cambios enriquecidos en lugar de las marcas de campo true/false integradas de estilo sharePoint.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL del sitio
|
siteUrl | True | string |
Dirección URL completa del sitio de SharePoint que contiene la lista o biblioteca (por ejemplo, |
|
Lista o biblioteca
|
listId | True | string |
GUID o título exacto de la lista o biblioteca de SharePoint. La lista desplegable devuelve valores GUID, pero la entrada manual puede usar un GUID o el título exacto de la lista. |
|
Id. de elemento
|
itemId | True | integer |
Id. del elemento o archivo de SharePoint para analizar los cambios (disponibles en las salidas del desencadenador como identificador). |
|
Comparar desde
|
triggerWindowStartToken | string |
Define el punto de partida para la comparación de cambios. Acepta el desencadenador de SharePoint {TriggerWindowStartToken} (recomendado), una etiqueta de versión como "5.0", un token de cambio de SharePoint sin procesar o una fecha y hora de línea base ISO 8601, como "2026-03-30" o "2026-03-30T14:15:00Z". Los valores de solo fecha se interpretan como medianoche en la zona horaria seleccionada o UTC si timezone está en blanco. Omita comparar con la versión anterior inmediatamente. |
|
|
Incluir versiones secundarias
|
includeMinorVersions | boolean |
Si las versiones secundarias o de borrador deben participar en la comparación. El valor predeterminado es false, lo que significa que solo se usan 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 de fecha personalizado para los campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa", "MM/dd/aaaa"). El valor predeterminado es "aaaa-MM-dd" si no se especifica. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora anexado a la fecha de los campos DateTime con hora (por ejemplo, "HH:mm:ss", "HH:mm", "hh:mm tt"). El valor predeterminado es "HH:mm:ss" si no se especifica. |
|
|
Timezone
|
timezone | string |
Identificador de zona horaria de IANA para la conversión de fecha y hora (por ejemplo, "America/New_York", "Europa/Londres", "Australia/Sídney"). El valor predeterminado es UTC si no se especifica. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indica si la operación se completó correctamente. |
|
Message
|
message | string |
Mensaje legible que describe el resultado |
|
Campos modificados
|
changedFields | array of object |
Campos con seguimiento como una matriz. |
|
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. |
|
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") |
|
Título del elemento
|
itemTitle | string |
Título del elemento modificado |
|
Dirección URL del elemento
|
itemUrl | string |
Vínculo directo al elemento de SharePoint modificado |
|
Fecha de modificación
|
modifiedDate | date-time |
Marca de tiempo 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 HTML de alerta de elemento detallado
Devuelve html de Retransmisión de alertas listo para usar para los cambios de elementos de SharePoint, diseñados principalmente para correos electrónicos de alerta de estilo SharePoint, pero también se pueden usar en documentos u otros destinos compatibles con HTML.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL del sitio
|
siteUrl | True | string |
Dirección URL completa del sitio de SharePoint que contiene la lista o biblioteca. |
|
Lista o biblioteca
|
listId | True | string |
GUID o título exacto de la lista o biblioteca de SharePoint. La lista desplegable devuelve valores GUID, pero la entrada manual puede usar un GUID o el título exacto de la lista. |
|
Id. de elemento
|
itemId | True | integer |
Id. del elemento o archivo de SharePoint para analizar los cambios. |
|
Comparar desde
|
triggerWindowStartToken | string |
Define el punto de partida para la comparación de cambios. Acepta el desencadenador de SharePoint {TriggerWindowStartToken} (recomendado), una etiqueta de versión como "5.0", un token de cambio de SharePoint sin procesar o una fecha y hora de línea base ISO 8601, como "2026-03-30" o "2026-03-30T14:15:00Z". Los valores de solo fecha se interpretan como medianoche en la zona horaria seleccionada o UTC si timezone está en blanco. Omita comparar con la versión anterior inmediatamente. |
|
|
Incluir versiones secundarias
|
includeMinorVersions | boolean |
Si las versiones secundarias o de borrador deben participar en la comparación. El valor predeterminado es false, lo que significa que solo se usan 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 de fecha personalizado para los campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa"). El valor predeterminado es "aaaa-MM-dd" si no se especifica. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora anexado a la fecha de los campos DateTime con hora (por ejemplo, "HH:mm:ss", "HH:mm", "hh:mm tt"). |
|
|
Timezone
|
timezone | string |
Identificador de zona horaria de IANA para la conversión de fecha y hora (por ejemplo, "America/New_York", "Europa/Londres", "Australia/Sídney"). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indica si la operación se completó correctamente. |
|
Message
|
message | string |
Mensaje legible que describe el resultado |
|
Cuerpo HTML
|
htmlBody | string |
Cuerpo HTML completo listo para usarse en correos electrónicos de alerta u otros destinos compatibles con HTML |
|
Asunto sugerido
|
subject | string |
Línea de asunto sugerida para la alerta |
|
Título del elemento
|
itemTitle | string |
Título del elemento modificado |
|
Dirección URL del elemento
|
itemUrl | string |
Vínculo directo al elemento de SharePoint modificado |
|
Es nuevo elemento
|
isNewItem | boolean |
True si la alerta es para un nuevo elemento o archivo de SharePoint en lugar de una actualización a una existente. |
|
Error
|
error | string |
Detalles del error si el valor correcto es false |