Inoltro avvisi (anteprima)
Inoltro avvisi consente di sostituire il ritiro degli avvisi di SharePoint con notifiche più avanzate e moderne. Restituisce modifiche dettagliate a livello di campo e CODICE HTML di avviso pronto per l'uso, in modo da visualizzare esattamente ciò che è cambiato anziché le notifiche modificate generica.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure Government - Azure cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Name | Supporto independNET |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadati del connettore | |
|---|---|
| Editore | Prodotti independNET |
| Sito web | https://independnet.com.au/alert-relay/ |
| Informativa sulla privacy | https://independnet.com.au/alert-relay/privacy |
| Categorie | Collaborazione; Produttività |
Inoltro avvisi
Inoltro avvisi consente di sostituire il ritiro degli avvisi di SharePoint con notifiche più avanzate e moderne per gli ambienti Microsoft 365. Fornisce informazioni dettagliate sulle modifiche agli elementi e ai documenti di SharePoint, inclusi confronti a livello di campo formattati e output di avviso HTML pronto per l'uso.
Overview
Inoltro avvisi è progettato per gli autori che desiderano notifiche di SharePoint più utili rispetto all'esperienza predefinita "elemento modificato".
Supporta:
- ispezione dettagliata delle modifiche a livello di campo
- output HTML pronto all'uso per i messaggi di posta elettronica di avviso
- analisi dei token trigger per decisioni di base e first-run
- Elenchi SharePoint
- raccolte documenti
- Pagine del sito/raccolte pagine
Funzionalità principali
1. Rilevamento dettagliato delle modifiche
Il connettore può confrontare la versione corrente di un elemento o di un documento di SharePoint con una versione precedente e restituire i dettagli delle modifiche strutturate.
2. Output di avviso HTML pronto per l'uso
Il connettore può generare codice HTML formattato in modo che i flussi possano inviare messaggi di posta elettronica di avviso utili senza compilare manualmente espressioni HTML complesse.
3. Attivare l'analisi dei token
L'azione Parse Compare From decodifica i token di modifica di SharePoint, ad TriggerWindowStartToken esempio e restituisce il timestamp incorporato e i dettagli del token per il processo decisionale nei flussi.
4. Elenchi a discesa dinamici
Il connettore include il supporto dell'elenco a discesa dinamico per:
- Siti
- elenchi e raccolte
- formati di data
- formati di ora
- fusi orari
5. Baseline di confronto flessibile
Il connettore supporta il confronto tra:
- Token di trigger di SharePoint
- token di modifica di SharePoint non elaborati
- etichette di versione
- Baseline di data/ora ISO 8601
Azioni supportate
Ottenere modifiche dettagliate
Restituisce json strutturato che descrive i campi modificati, inclusi i valori formattati precedenti e correnti.
Ottenere modifiche dettagliate come HTML avviso
Restituisce l'output HTML pronto all'uso e i metadati di avviso correlati per la posta elettronica o altre destinazioni che supportano HTML.
Analizza confronto da
Decodifica un trigger/token di modifica di SharePoint e restituisce il timestamp incorporato e i dettagli del token.
Casi d'uso tipici
- Inviare messaggi di posta elettronica di avviso di SharePoint migliori quando viene modificato un elemento dell'elenco
- Mostra i valori precedenti e correnti per i campi aziendali importanti
- Tenere traccia delle modifiche ai metadati della raccolta documenti
- Creare flussi di approvazione, conformità o notifica di controllo
- Eliminare gli avvisi di prima esecuzione rumorosi valutando le date del token di attivazione rispetto a una baseline scelta
Authentication
Inoltro avvisi usa l'autenticazione di Microsoft Entra ID insieme a una chiave di sottoscrizione API.
Per usare il connettore, un utente deve:
- accesso al sito, all'elenco o alla raccolta di SharePoint pertinenti
- una connessione di inoltro avvisi valida
- una chiave di sottoscrizione dell'API di inoltro avvisi valida
Quando un tenant usa per la prima volta l'inoltro avvisi, viene inserito automaticamente in modalità di valutazione. Per uscire dalla modalità di valutazione, contattare support@alertbridge.com.au.
Come iniziare
Un flusso di convalida tipico usa:
- Un trigger di SharePoint, ad esempio
When an item is created or modified - Azione di inoltro avvisi, ad esempio
Get Detailed Changes as Alert HTML - Un passaggio di posta elettronica o Compose per usare l'oggetto restituito e l'output HTML
Per l'elaborazione downstream strutturata, usare Get Detailed Changes e scorrere la matrice restituita changedFields .
Problemi noti e limitazioni
- SharePoint Online è supportato; SharePoint Server locale non è supportato.
- L'intervallo dei trigger di SharePoint può influire sui confronti della prima esecuzione perché i token di trigger riflettono la finestra del trigger di SharePoint anziché una cronologia degli avvisi per elemento.
Support
Sito web:
Informativa sulla privacy:
Supporto:
Messaggio di posta elettronica di supporto:
- support@alertbridge.com.au
Note aggiuntive
Inoltro avvisi è progettato per migliorare l'usabilità per gli scenari di notifica basati su SharePoint riducendo la quantità di lavoro dell'espressione personalizzata necessaria nei flussi, in particolare per la formattazione della posta elettronica HTML e l'ispezione delle modifiche a livello di campo.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Analizza confronto da |
Decodifica un token di modifica TriggerWindowStartToken o SharePoint non elaborato e restituisce il timestamp incorporato per le condizioni del flusso e le decisioni di base. Questa azione non chiama SharePoint. |
| Ottenere il codice HTML dell'avviso dettagliato per gli elementi |
Restituisce codice HTML di inoltro avvisi pronto per l'uso per le modifiche degli elementi di SharePoint, progettate principalmente per i messaggi di posta elettronica di avviso di tipo SharePoint, ma utilizzabili anche in documenti o in altre destinazioni che supportano HTML. |
| Ottenere modifiche dettagliate degli elementi |
Recupera le modifiche dettagliate e formattate a livello di campo per una voce o un documento di elenco di SharePoint, confrontando la versione corrente con la versione precedente. Usare questa opzione quando si desiderano dati di modifica avanzati anziché i flag di campo true/false incorporati in stile SharePoint. |
Analizza confronto da
Decodifica un token di modifica TriggerWindowStartToken o SharePoint non elaborato e restituisce il timestamp incorporato per le condizioni del flusso e le decisioni di base. Questa azione non chiama SharePoint.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Confronta da
|
compareFrom | True | string |
TriggerWindowStartToken o token di modifica non elaborato di SharePoint per decodificare. Le etichette di versione e i valori di data/ora ISO non sono supportati da questa azione. |
|
Timezone
|
timezone | string |
ID fuso orario IANA facoltativo per un valore di confronto locale (ad esempio, 'America/New_York', 'Europe/London', 'Australia/Sydney'). Se omesso, viene restituito solo il valore UTC. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Ora utc della data del token
|
tokenDateTimeUTC | date-time |
Token timestamp in UTC. |
|
Data token ora locale
|
tokenDateTimeLocal | date-time |
Timestamp del token convertito nel fuso orario richiesto. |
|
Token decodificato
|
decodedToken | string |
Testo del token non elaborato decodificato. Per l'input del token non elaborato, corrisponde al valore originale. |
|
Is Base64 Token
|
isBase64Token | boolean |
True quando il token in ingresso è stato codificato in base64. |
|
Sequence
|
sequence | integer |
Valore della sequenza di modifica di SharePoint incorporato nel token. |
|
GUID elenco
|
listGuid | uuid |
GuiD elenco o libreria incorporato nel token. |
|
Versione del token
|
tokenVersion | integer |
Numero di versione del token. |
|
Tipo di token
|
tokenType | integer |
Numero del tipo di token di SharePoint. |
|
Error
|
error | string |
Dettagli dell'errore durante l'analisi non riesce. |
Ottenere il codice HTML dell'avviso dettagliato per gli elementi
Restituisce codice HTML di inoltro avvisi pronto per l'uso per le modifiche degli elementi di SharePoint, progettate principalmente per i messaggi di posta elettronica di avviso di tipo SharePoint, ma utilizzabili anche in documenti o in altre destinazioni che supportano HTML.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL sito
|
siteUrl | True | string |
URL completo del sito di SharePoint contenente l'elenco o la raccolta. |
|
Elenco o raccolta
|
listId | True | string |
GUID o titolo esatto dell'elenco o della raccolta di SharePoint. L'elenco a discesa restituisce valori GUID, ma la voce manuale può usare un GUID o il titolo esatto dell'elenco. |
|
ID articolo
|
itemId | True | integer |
ID dell'elemento o del file di SharePoint da analizzare per individuare le modifiche. |
|
Confronta da
|
triggerWindowStartToken | string |
Definisce il punto iniziale per il confronto delle modifiche. Accetta il trigger di SharePoint {TriggerWindowStartToken} (scelta consigliata), un'etichetta di versione, ad esempio '5.0', un token di modifica di SharePoint non elaborato o una data/ora prevista ISO 8601, ad esempio '2026-03-30' o '2026-03-30T14:15:00Z'. I valori di sola data vengono interpretati come mezzanotte nel fuso orario selezionato o utc se il fuso orario è vuoto. Omettere il confronto con la versione immediatamente precedente. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se le versioni secondarie o di bozza devono partecipare al confronto. Il valore predefinito è false, ovvero vengono usate solo le versioni principali. |
|
|
Includi campi non modificati
|
includeUnchangedFields | boolean |
Indica se i campi non modificati devono essere inclusi nel codice HTML generato. il valore predefinito è true. |
|
|
Formato data
|
dateFormat | string |
Formato di data personalizzato per i campi DateTime, ad esempio 'aa-MM-gg', 'dd/MM/aa'). Il valore predefinito è 'aaaa-MM-gg' se non specificato. |
|
|
Formato ora
|
timeFormat | string |
Formato ora aggiunto alla data per i campi DateTime con ora (ad esempio, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
ID fuso orario IANA per la conversione di data/ora (ad esempio, 'America/New_York', 'Europa/Londra', 'Australia/Sydney'). |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean |
Indica se l'operazione è stata completata correttamente |
|
Message
|
message | string |
Messaggio leggibile che descrive il risultato |
|
Corpo HTML
|
htmlBody | string |
Completare il corpo HTML pronto per l'uso nei messaggi di posta elettronica di avviso o in altre destinazioni con supporto HTML |
|
Oggetto suggerito
|
subject | string |
Riga dell'oggetto suggerita per l'avviso |
|
Titolo elemento
|
itemTitle | string |
Titolo dell'elemento modificato |
|
URL elemento
|
itemUrl | string |
Collegamento diretto all'elemento di SharePoint modificato |
|
Nuovo elemento
|
isNewItem | boolean |
True se l'avviso è relativo a un nuovo elemento o file di SharePoint anziché a un aggiornamento a uno esistente. |
|
Error
|
error | string |
Dettagli errore se l'operazione ha esito positivo è false |
Ottenere modifiche dettagliate degli elementi
Recupera le modifiche dettagliate e formattate a livello di campo per una voce o un documento di elenco di SharePoint, confrontando la versione corrente con la versione precedente. Usare questa opzione quando si desiderano dati di modifica avanzati anziché i flag di campo true/false incorporati in stile SharePoint.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL sito
|
siteUrl | True | string |
URL completo del sito di SharePoint contenente l'elenco o la raccolta , ad esempio |
|
Elenco o raccolta
|
listId | True | string |
GUID o titolo esatto dell'elenco o della raccolta di SharePoint. L'elenco a discesa restituisce valori GUID, ma la voce manuale può usare un GUID o il titolo esatto dell'elenco. |
|
ID articolo
|
itemId | True | integer |
ID dell'elemento o del file di SharePoint da analizzare per individuare le modifiche (disponibili dagli output del trigger come ID). |
|
Confronta da
|
triggerWindowStartToken | string |
Definisce il punto iniziale per il confronto delle modifiche. Accetta il trigger di SharePoint {TriggerWindowStartToken} (scelta consigliata), un'etichetta di versione, ad esempio '5.0', un token di modifica di SharePoint non elaborato o una data/ora prevista ISO 8601, ad esempio '2026-03-30' o '2026-03-30T14:15:00Z'. I valori di sola data vengono interpretati come mezzanotte nel fuso orario selezionato o utc se il fuso orario è vuoto. Omettere il confronto con la versione immediatamente precedente. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se le versioni secondarie o di bozza devono partecipare al confronto. Il valore predefinito è false, ovvero vengono usate solo le versioni principali. |
|
|
Includi campi non modificati
|
includeUnchangedFields | boolean |
Indica se i campi non modificati devono essere inclusi nella risposta. il valore predefinito è true. |
|
|
Formato data
|
dateFormat | string |
Formato di data personalizzato per i campi DateTime , ad esempio 'aaaa-MM-gg', 'dd/MM/aaaa', 'MM/gg/aa'). Il valore predefinito è 'aaaa-MM-gg' se non specificato. |
|
|
Formato ora
|
timeFormat | string |
Formato ora aggiunto alla data per i campi DateTime con ora (ad esempio, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). Il valore predefinito è 'HH:mm:ss' se non specificato. |
|
|
Timezone
|
timezone | string |
ID fuso orario IANA per la conversione di data/ora (ad esempio, 'America/New_York', 'Europa/Londra', 'Australia/Sydney'). Il valore predefinito è UTC se non specificato. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean |
Indica se l'operazione è stata completata correttamente |
|
Message
|
message | string |
Messaggio leggibile che descrive il risultato |
|
Campi modificati
|
changedFields | array of object |
Campi rilevati come matrice. |
|
Il valore della colonna è stato modificato
|
changedFields.hasChanged | boolean |
True se il valore di questo campo è stato modificato tra la versione precedente e quella corrente |
|
Valore colonna precedente (testo)
|
changedFields.previousAsString | string |
Valore precedente formattato come stringa leggibile |
|
Nome interno campo
|
changedFields.internalName | string |
Nome campo di SharePoint interno |
|
Nome campo
|
changedFields.displayName | string |
Nome visualizzato descrittivo per il campo |
|
Valore colonna precedente (dettagliato)
|
changedFields.previous |
Valore precedente non elaborato. Questa proprietà è dinamica e può essere una stringa, un numero, un valore booleano, un oggetto, una matrice o null a seconda del tipo di campo di SharePoint. |
|
|
Valore colonna corrente (testo)
|
changedFields.currentAsString | string |
Valore corrente formattato come stringa leggibile |
|
Valore colonna corrente (dettagliato)
|
changedFields.current |
Valore corrente non elaborato. Questa proprietà è dinamica e può essere una stringa, un numero, un valore booleano, un oggetto, una matrice o null a seconda del tipo di campo di SharePoint. |
|
|
Ha una linea di base di confronto
|
hasComparisonBaseline | boolean |
True se è stata risolta una versione di base distinta per il confronto con la versione corrente. |
|
È la prima versione prevista
|
isBaselineFirstVersion | boolean |
True se la versione di base risolta è la prima versione registrata per l'elemento o il file. |
|
Etichetta versione corrente
|
currentVersionLabel | string |
Etichetta di versione della versione corrente (ad esempio, '2.0', '5.0') |
|
Etichetta versione precedente
|
previousVersionLabel | string |
Etichetta di versione usata per il confronto (ad esempio, '1.0', '4.0') |
|
Titolo elemento
|
itemTitle | string |
Titolo dell'elemento modificato |
|
URL elemento
|
itemUrl | string |
Collegamento diretto all'elemento di SharePoint modificato |
|
Data modifica
|
modifiedDate | date-time |
Timestamp della modifica più recente |
|
Modificato da
|
modifiedBy | string |
Nome visualizzato dell'utente che ha modificato l'ultimo elemento |
|
Error
|
error | string |
Dettagli errore se l'operazione ha esito positivo è false |