Retransmissão de Alerta (versão prévia)
A Retransmissão de Alertas ajuda a substituir a desativação de alertas do SharePoint por notificações mais avançadas e modernas. Ele retorna alterações detalhadas no nível do campo e HTML de alerta pronto para uso para que você possa mostrar exatamente o que foi alterado em vez de notificações modificadas genéricas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Government regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Suporte independNET |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadados do conector | |
|---|---|
| Publicador | Produtos independNET |
| Site da Web | https://independnet.com.au/alert-relay/ |
| Política de privacidade | https://independnet.com.au/alert-relay/privacy |
| Categorias | Colaboração; Produtividade |
Retransmissão de
A Retransmissão de Alertas ajuda a substituir a desativação de alertas do SharePoint por notificações mais avançadas e modernas para ambientes do Microsoft 365. Ele fornece informações detalhadas de alteração de item e documento do SharePoint, incluindo comparações formatadas no nível do campo e saída de alerta HTML pronta para uso.
Visão geral
A Retransmissão de Alerta foi projetada para criadores que desejam notificações mais úteis do Que a experiência padrão de "item foi modificado".
Suporta:
- inspeção detalhada de alteração no nível do campo
- saída HTML pronta para uso para emails de alerta
- disparar análise de token para decisões de linha de base e de primeira execução
- Listas do SharePoint
- bibliotecas de documentos
- Páginas do Site/bibliotecas de páginas
Principais características
1. Controle detalhado de alterações
O conector pode comparar a versão atual de um item ou documento do SharePoint com uma versão anterior e retornar detalhes de alteração estruturados.
2. Saída de alerta HTML pronta para uso
O conector pode gerar HTML formatado para que os fluxos possam enviar emails de alerta úteis sem criar expressões HTML complexas manualmente.
3. Disparar análise de token
A Parse Compare From ação decodifica tokens de alteração do SharePoint, como TriggerWindowStartToken e retorna o carimbo de data/hora inserido e os detalhes do token para tomada de decisão em fluxos.
4. Listas suspensas dinâmicas
O conector inclui suporte a menu suspenso dinâmico para:
- sites
- listas e bibliotecas
- formatos de data
- formatos de tempo
- fusos horários
5. Linha de base de comparação flexível
O conector dá suporte à comparação de:
- Tokens de gatilho do SharePoint
- tokens de alteração brutos do SharePoint
- rótulos de versão
- Linhas de base de data/data/hora iso 8601
Ações Suportadas
Obter alterações detalhadas
Retorna JSON estruturado descrevendo campos alterados, incluindo valores formatados anteriores e atuais.
Obter alterações detalhadas como HTML de alerta
Retorna saída HTML pronta para uso e metadados de alerta relacionados para email ou outros destinos compatíveis com HTML.
Analisar Comparação de
Decodifica um token de gatilho/alteração do SharePoint e retorna o carimbo de data/hora inserido e os detalhes do token.
Casos de uso típicos
- Enviar emails de alerta do SharePoint melhores quando um item de lista for alterado
- Mostrar valores anteriores e atuais para campos de negócios importantes
- Acompanhar alterações de metadados da biblioteca de documentos
- Criar fluxos de notificação de aprovação, conformidade ou auditoria
- Suprimir alertas barulhentos de primeira execução avaliando as datas do token de gatilho em relação a uma linha de base escolhida
Authentication
A Retransmissão de Alerta usa a autenticação da ID do Microsoft Entra junto com uma chave de assinatura de API.
Para usar o conector, um usuário precisa:
- acesso ao site, à lista ou à biblioteca relevantes do SharePoint
- uma conexão de Retransmissão de Alerta válida
- uma chave de assinatura válida da API de Retransmissão de Alerta
Quando um locatário usa a Retransmissão de Alerta pela primeira vez, ele é colocado no modo de avaliação automaticamente. Para sair do modo de avaliação, entre em contato support@alertbridge.com.au.
Introdução
Um fluxo de validação típico usa:
- Um gatilho do SharePoint, como
When an item is created or modified - Uma ação de Retransmissão de Alerta, como
Get Detailed Changes as Alert HTML - Uma etapa de composição ou email para usar o assunto retornado e a saída HTML
Para processamento downstream estruturado, use Get Detailed Changes e itere pela matriz retornada changedFields .
Problemas e limitações conhecidos
- Há suporte para o SharePoint Online; Não há suporte para o SharePoint Server local.
- O tempo de gatilho do SharePoint pode afetar comparações de primeira execução porque os tokens de gatilho refletem a janela de gatilho do SharePoint em vez de um histórico de alertas por item.
Suporte
Site:
Política de Privacidade:
Apoio:
Email de suporte:
- support@alertbridge.com.au
Notas adicionais
A Retransmissão de Alertas destina-se a melhorar a usabilidade para cenários de notificação baseados no SharePoint, reduzindo a quantidade de trabalho de expressão personalizada necessária em fluxos, especialmente para a formatação de email HTML e a inspeção de alterações no nível do campo.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Analisar Comparação de |
Decodifica um token de alteração TriggerWindowStartToken ou bruto do SharePoint e retorna o carimbo de data/hora inserido para condições de fluxo e decisões de linha de base. Essa ação não chama o SharePoint. |
| Obter alterações detalhadas de item |
Recupera alterações detalhadas no nível do campo formatadas para um item ou documento de lista do SharePoint, comparando a versão atual com a versão anterior. Use isso quando quiser dados de alteração avançada em vez dos sinalizadores de campo true/false no estilo interno do SharePoint. |
| Obter HTML de alerta de item detalhado |
Retorna HTML de Retransmissão de Alerta pronto para uso para alterações de item do SharePoint, projetado principalmente para emails de alerta no estilo do SharePoint, mas também utilizável em documentos ou outros destinos compatíveis com HTML. |
Analisar Comparação de
Decodifica um token de alteração TriggerWindowStartToken ou bruto do SharePoint e retorna o carimbo de data/hora inserido para condições de fluxo e decisões de linha de base. Essa ação não chama o SharePoint.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Comparar de
|
compareFrom | True | string |
TriggerWindowStartToken ou token de alteração bruto do SharePoint para decodificar. Os rótulos de versão e os valores de data/data e hora iso não são compatíveis com essa ação. |
|
Timezone
|
timezone | string |
ID de fuso horário IANA opcional para um valor de comparação local (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). Se omitido, somente o valor UTC será retornado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean | |
|
Message
|
message | string | |
|
Hora da data do token UTC
|
tokenDateTimeUTC | date-time |
Carimbo de data/hora do token em UTC. |
|
Hora da Data do Token Local
|
tokenDateTimeLocal | date-time |
Carimbo de data/hora do token convertido no fuso horário solicitado. |
|
Token decodificado
|
decodedToken | string |
Texto de token bruto decodificado. Para entrada de token bruto, isso corresponde ao valor original. |
|
É o token Base64
|
isBase64Token | boolean |
True quando o token de entrada foi codificado em base64. |
|
Sequence
|
sequence | integer |
Valor da sequência de alterações do SharePoint inserido no token. |
|
Guid de lista
|
listGuid | uuid |
Guid de lista ou biblioteca inserido no token. |
|
Versão do token
|
tokenVersion | integer |
Número da versão do token. |
|
Tipo de token
|
tokenType | integer |
Número do tipo de token do SharePoint. |
|
Erro
|
error | string |
Detalhes do erro ao analisar falha. |
Obter alterações detalhadas de item
Recupera alterações detalhadas no nível do campo formatadas para um item ou documento de lista do SharePoint, comparando a versão atual com a versão anterior. Use isso quando quiser dados de alteração avançada em vez dos sinalizadores de campo true/false no estilo interno do SharePoint.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
URL completa do site do SharePoint que contém a lista ou biblioteca (por exemplo, |
|
Lista ou biblioteca
|
listId | True | string |
GUID ou o título exato da lista ou biblioteca do SharePoint. A lista suspensa retorna valores GUID, mas a entrada manual pode usar um GUID ou o título exato da lista. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint para analisar as alterações (disponíveis em saídas de gatilho como ID). |
|
Comparar de
|
triggerWindowStartToken | string |
Define o ponto de partida para a comparação de alterações. Aceita {TriggerWindowStartToken} do gatilho do SharePoint (recomendado), um rótulo de versão como '5.0', um token de alteração bruto do SharePoint ou uma data de linha de base ISO 8601/date-time, como '2026-03-30' ou '2026-03-30T14:15:00Z'. Os valores somente data são interpretados como meia-noite no Fuso Horário selecionado ou UTC se o Fuso Horário estiver em branco. Omita para comparar com a versão imediatamente anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se as versões secundárias ou de rascunho devem participar da comparação. O padrão é false, o que significa que apenas as versões principais são usadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos na resposta. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato de data personalizado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy', 'MM/dd/yyyy'). O padrão será 'yyy-MM-dd' se não for especificado. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora acrescentado à data para campos DateTime com hora (por exemplo, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). O padrão será 'HH:mm:ss' se não for especificado. |
|
|
Timezone
|
timezone | string |
ID de fuso horário IANA para conversão de data/hora (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). O padrão será UTC se não for especificado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
Indica se a operação foi concluída com êxito |
|
Message
|
message | string |
Mensagem legível por humanos que descreve o resultado |
|
Campos alterados
|
changedFields | array of object |
Campos rastreados como uma matriz. |
|
O valor da coluna foi alterado
|
changedFields.hasChanged | boolean |
True se o valor desse campo foi alterado entre a versão anterior e a atual |
|
Valor da coluna anterior (texto)
|
changedFields.previousAsString | string |
Valor anterior formatado como uma cadeia de caracteres legível por humanos |
|
Nome interno do campo
|
changedFields.internalName | string |
Nome do campo interno do SharePoint |
|
Nome do campo
|
changedFields.displayName | string |
Nome de exibição amigável para o campo |
|
Valor da coluna anterior (detalhado)
|
changedFields.previous |
Valor anterior bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Valor da coluna atual (texto)
|
changedFields.currentAsString | string |
Valor atual formatado como uma cadeia de caracteres legível por humanos |
|
Valor da coluna atual (detalhado)
|
changedFields.current |
Valor atual bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Tem linha de base de comparação
|
hasComparisonBaseline | boolean |
True se uma versão de linha de base distinta foi resolvida para comparação com a versão atual. |
|
É a primeira versão da linha de base
|
isBaselineFirstVersion | boolean |
True se a versão de linha de base resolvida for a primeira versão já registrada para o item ou arquivo. |
|
Rótulo de versão atual
|
currentVersionLabel | string |
Rótulo de versão da versão atual (por exemplo, '2.0', '5.0') |
|
Rótulo de versão anterior
|
previousVersionLabel | string |
Rótulo de versão usado para comparação (por exemplo, '1.0', '4.0') |
|
Título do Item
|
itemTitle | string |
Título do item alterado |
|
Item URL
|
itemUrl | string |
Link direto para o item do SharePoint alterado |
|
Data de Modificação
|
modifiedDate | date-time |
Carimbo de data/hora da última modificação |
|
Modificado por
|
modifiedBy | string |
Nome de exibição do usuário que modificou o item pela última vez |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |
Obter HTML de alerta de item detalhado
Retorna HTML de Retransmissão de Alerta pronto para uso para alterações de item do SharePoint, projetado principalmente para emails de alerta no estilo do SharePoint, mas também utilizável em documentos ou outros destinos compatíveis com HTML.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
URL completa do site do SharePoint que contém a lista ou biblioteca. |
|
Lista ou biblioteca
|
listId | True | string |
GUID ou o título exato da lista ou biblioteca do SharePoint. A lista suspensa retorna valores GUID, mas a entrada manual pode usar um GUID ou o título exato da lista. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint a ser analisado para obter alterações. |
|
Comparar de
|
triggerWindowStartToken | string |
Define o ponto de partida para a comparação de alterações. Aceita {TriggerWindowStartToken} do gatilho do SharePoint (recomendado), um rótulo de versão como '5.0', um token de alteração bruto do SharePoint ou uma data de linha de base ISO 8601/date-time, como '2026-03-30' ou '2026-03-30T14:15:00Z'. Os valores somente data são interpretados como meia-noite no Fuso Horário selecionado ou UTC se o Fuso Horário estiver em branco. Omita para comparar com a versão imediatamente anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se as versões secundárias ou de rascunho devem participar da comparação. O padrão é false, o que significa que apenas as versões principais são usadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos no HTML gerado. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato de data personalizado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy'). O padrão será 'yyy-MM-dd' se não for especificado. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora acrescentado à data para campos DateTime com hora (por exemplo, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
ID de fuso horário IANA para conversão de data/hora (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
Indica se a operação foi concluída com êxito |
|
Message
|
message | string |
Mensagem legível por humanos que descreve o resultado |
|
Corpo HTML
|
htmlBody | string |
Corpo HTML completo pronto para uso em emails de alerta ou em outros destinos compatíveis com HTML |
|
Assunto Sugerido
|
subject | string |
Linha de assunto sugerida para o alerta |
|
Título do Item
|
itemTitle | string |
Título do item alterado |
|
Item URL
|
itemUrl | string |
Link direto para o item do SharePoint alterado |
|
É Novo Item
|
isNewItem | boolean |
True se o alerta for para um novo item ou arquivo do SharePoint em vez de uma atualização para um existente. |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |