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 HTML di avviso pronto per l'uso, in modo da visualizzare esattamente ciò che è cambiato anziché le notifiche generiche modificate. È anche possibile usare le informazioni sulle modifiche e sulla versione nelle decisioni e nelle condizioni del flusso.
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 per enti pubblici - 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 | software 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 per Power Platform e Microsoft 365 Copilot
Inoltro avvisi aiuta le organizzazioni a sostituire gli avvisi SharePoint classici con soluzioni moderne di Power Automate e Copilot Studio. Confronta SharePoint elementi, file e pagine con le versioni precedenti e restituisce informazioni sulle modifiche strutturate, cronologia delle versioni e contenuto di notifica pronto all'uso senza richiedere agli autori di creare una logica di confronto delle versioni SharePoint complessa.
Overview
SharePoint trigger possono identificare che un elemento, un file o una pagina è stato modificato, ma non fornisce un confronto completo dei valori precedenti e correnti.
La compilazione di tale confronto richiede spesso ai creatori di recuperare versioni, interpretare i token di modifica, confrontare i campi e formattare i risultati per le notifiche o l'elaborazione downstream.
L'inoltro avvisi centralizza le azioni riutilizzabili per Power Automate e Copilot Studio.
Funzionalità principali
L'inoltro degli avvisi centralizza le azioni riutilizzabili che possono:
- identificare le modifiche dettagliate a livello di campo
- restituisce valori di campo precedenti e correnti
- generare codice HTML pronto all'uso per SharePoint messaggi di posta elettronica di avviso
- recuperare la cronologia delle versioni di elementi, file e pagine
- confrontare da un token di trigger, modificare il token, l'etichetta della versione o la data
- format supportati tipi di campo complessi SharePoint
- restituire informazioni strutturate per Power Automate e Microsoft 365 Copilot
Inoltro avvisi supporta SharePoint elenchi, raccolte documenti e raccolte pagine del sito.
Come iniziare
Un flusso di avviso SharePoint tipico include:
- Un trigger SharePoint, ad esempio Quando viene creato o modificato un elemento.
- Azione Di inoltro avvisi, ad esempio Recupera elemento o Modifica file come HTML avviso.
- Un messaggio di posta elettronica o un'altra azione di notifica che usa l'oggetto restituito e il corpo HTML.
Per le condizioni, la formattazione personalizzata o gli scenari dell'agente di Microsoft Copilot Studio, usare Get Detailed Item o File Changes e usare le informazioni sulle modifiche strutturate restituite.
Per le versioni cronologiche SharePoint, usare Recupera elemento o Cronologia versioni file.
Documentation
Documentazione, informazioni di riferimento sulle azioni, esempi e indicazioni introduttive sono disponibili all'indirizzo:
Documentazione di Inoltro avvisi
Esercitazioni video
Procedure dettagliate, esempi e procedure sono disponibili nel canale YouTube di Alert Relay:
Licenze e versioni di valutazione
Le licenze di Inoltro avvisi sono a livello di tenant. Una singola versione di valutazione o sottoscrizione si applica nel tenant Microsoft Entra e le relative unità di utilizzo vengono condivise dai flussi di inoltro avvisi e dagli utenti in tale tenant.
La versione di valutazione di 90 giorni viene avviata automaticamente quando un'azione di inoltro avvisi viene eseguita per la prima volta nel tenant e include 300 unità di utilizzo condivise nella versione di valutazione. Per i piani correnti e altri dettagli, vedere Prezzi e licenze di Inoltro avvisi.
Azioni
Ottenere modifiche dettagliate all'elemento o al file
Restituisce modifiche dettagliate a livello di campo tra la versione corrente di un elemento SharePoint, un file o una pagina e una versione precedente.
L'azione restituisce informazioni strutturate, inclusi i valori precedenti e correnti, i valori formattati e i metadati di confronto. Usarlo quando un flusso o un agente Microsoft Copilot Studio deve esaminare, riepilogare o intervenire sulle singole modifiche.
Ottenere modifiche all'elemento o al file come HTML di avviso
Genera codice HTML pronto all'uso che mostra le modifiche apportate in un elemento, un file o una pagina SharePoint.
L'azione restituisce anche un oggetto di posta elettronica suggerito, un titolo dell'elemento e un collegamento all'elemento. Usarlo per creare messaggi di posta elettronica di avviso più avanzati SharePoint senza creare espressioni complesse di confronto tra html e versioni in ogni flusso.
Ottenere la cronologia delle versioni dell'elemento o del file
Restituisce la cronologia delle versioni delimitata e pageable per un SharePoint elemento, un file o una pagina.
L'azione può restituire i campi selezionati SharePoint e supporta i limiti di versione, data e SharePoint del token di trigger. Usarlo per scenari cronologici di revisione, controllo, creazione di report, approvazione e riconoscimento della versione dei flussi di lavoro.
Analizzare le informazioni sulla versione di SharePoint
Decodifica SharePoint informazioni trigger-window e change-token.
Usare questa azione per recuperare il timestamp del token, applicare decisioni basate su data o versione e filtrare i trigger di versione secondaria o bozza indesiderati prima di chiamare un'azione di modifica dettagliata.
Usi tipici
Inoltro avvisi consente di:
- sostituire gli avvisi SharePoint classici con flussi di Power Automate
- inviare notifiche formattate che mostrano esattamente cosa è cambiato
- confrontare i valori precedenti e correnti per i campi aziendali importanti
- tenere traccia delle modifiche apportate ai metadati dei documenti e alle pagine SharePoint
- recuperare SharePoint cronologia delle versioni dell'elemento e del file
- approvazione della compilazione, revisione, governance e flussi di lavoro di controllo
- fornire informazioni sulle modifiche SharePoint strutturate per Microsoft 365 Copilot
Autenticazione e accesso
Inoltro avvisi usa Microsoft Entra ID'autenticazione delegata.
SharePoint'accesso viene eseguito nel contesto dell'utente connesso. Inoltro avvisi non concede agli utenti autorizzazioni aggiuntive SharePoint, pertanto gli utenti devono avere già accesso al sito, all'elenco, alla raccolta, all'elemento o al file pertinente SharePoint.
Requisiti e ambito supportato
- Inoltro avvisi supporta SharePoint Online. Server SharePoint locale non è supportato.
- Le azioni vengono eseguite quando vengono chiamate da Power Automate o da un altro client supportato. Per le notifiche di modifica, usare un trigger di SharePoint appropriato per avviare il flusso.
- I confronti che usano i token di trigger SharePoint si basano sulla finestra del trigger SharePoint. La linea di base risultante può differire da un limite di versione specifico dell'elemento.
- La formattazione dettagliata è disponibile per i tipi di campo SharePoint supportati. Per informazioni di riferimento sul tipo di campo corrente, vedere la documentazione di Inoltro avvisi.
Support
Sito web: https://independnet.com.au/alert-relay/
Supporto: https://independnet.com.au/alert-relay/support
Posta elettronica: support@alertrelay.com.au
Informativa sulla privacy: https://independnet.com.au/alert-relay/privacy
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
|
Analizzare le informazioni sulla versione di Share |
Decodifica un SharePoint Confronta da token. Quando vengono forniti anche il numero di versione e la data di modifica, determina se l'elemento o il file è una nuova versione. Usare questa azione non fatturabile nelle condizioni del flusso prima di chiamare azioni fatturabili di Inoltro avvisi. |
| Ottenere la cronologia delle versioni dell'elemento o del file |
Restituisce fino al numero richiesto di versioni per un SharePoint list elemento o un file, più recente. Ogni versione include dettagli della versione, valori di colonna, valori di testo formattati e indicatori che mostrano le colonne modificate rispetto alla versione disponibile precedente. Selezionare il sito e l'elenco o la raccolta durante la configurazione di questa azione per rendere le colonne disponibili come contenuto dinamico. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente. |
| Ottenere modifiche all'elemento o al file come HTML di avviso |
Restituisce codice HTML di inoltro avvisi pronto per SharePoint modifiche agli elementi, progettato principalmente per i messaggi di posta elettronica di avviso, ma utilizzabile ovunque sia supportato il codice HTML. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente. |
| Ottenere modifiche dettagliate all'elemento o al file |
Recupera le modifiche dettagliate e formattate a livello di campo per un SharePoint list elemento o file, confrontando la versione corrente con una versione precedente. Usare questa opzione quando si vogliono dati di modifica avanzati, non solo i SharePoint indicatori di modifica true/false. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente. |
Analizzare le informazioni sulla versione di SharePoint
Decodifica un SharePoint Confronta da token. Quando vengono forniti anche il numero di versione e la data di modifica, determina se l'elemento o il file è una nuova versione. Usare questa azione non fatturabile nelle condizioni del flusso prima di chiamare azioni fatturabili di Inoltro avvisi.
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. |
|
Numero di versione
|
versionNumber | string |
Numero di versione dal trigger o dall'azione SharePoint, ad esempio 0.1, 1.0 o 1.5. Usato per identificare le versioni secondarie/bozza. |
|
|
Data modifica
|
modifiedDate | date-time |
Data modificata dal trigger o dall'azione SharePoint. Usato per rilevare se la versione SharePoint visibile è cambiata durante la finestra del trigger. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se i numeri di versione secondaria/bozza devono essere conteggiati come nuove versioni. Il valore predefinito è falso. |
|
|
Timezone
|
timezone | string |
Fuso orario facoltativo per i valori di confronto locali, ad esempio 'America/New_York', 'Europe/London' o 'Australia/Sydney' (ID fuso orario IANA). Se omesso, viene restituito solo il valore UTC. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean |
True quando le informazioni sulla versione sono state analizzate correttamente; false quando la convalida o l'elaborazione non è riuscita. |
|
Message
|
message | string |
Messaggio rivolto all'utente che descrive il risultato dell'operazione. Gli agenti e i copiloti devono visualizzare questo messaggio all'utente quando contiene informazioni di valutazione, sottoscrizione, utilizzo, avviso o elaborazione della versione. |
|
Ora utc della data del token
|
tokenDateTimeUTC | date-time |
Data e ora del token Compare From restituito in formato UTC. |
|
Data token ora locale
|
tokenDateTimeLocal | date-time |
Data e ora dal token Compare From, convertito nel fuso orario selezionato. |
|
Token decodificato
|
decodedToken | string |
I SharePoint non elaborati modificano il token dopo la decodifica. Se Compare From era già un token non elaborato, corrisponde al valore fornito. |
|
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. |
|
È stata rilevata una nuova versione
|
isNewVersionDetected | boolean |
True quando i metadati di trigger/azione forniti mostrano una nuova versione visibile SharePoint deve essere elaborata. False quando la versione deve essere ignorata. Null quando non sono presenti metadati sufficienti per determinare. |
|
Versione secondaria
|
isMinorVersion | boolean |
True quando il numero di versione specificato è una versione secondaria/bozza. Null quando il numero di versione non è stato specificato. |
|
È la prima versione secondaria
|
isFirstMinorVersion | boolean |
True quando il numero di versione specificato è la prima versione secondaria/bozza, in genere 0.1. Null quando il numero di versione non è stato specificato. |
|
È la prima versione principale
|
isFirstMajorVersion | boolean |
True quando il numero di versione specificato è la prima versione principale/pubblicata, in genere 1.0. Null quando il numero di versione non è stato specificato. |
|
Data di modifica UTC
|
modifiedDateUtc | date-time |
Data modifica specificata normalizzata in formato UTC. Null quando la data di modifica non è stata specificata. |
|
Data modifica locale
|
modifiedDateLocal | date-time |
Data modifica specificata convertita nel fuso orario selezionato. Null quando la data o il fuso orario modificati non è stato specificato. |
|
Error
|
error | string |
Dettagli errore se l'operazione ha esito positivo è false. |
Ottenere la cronologia delle versioni dell'elemento o del file
Restituisce fino al numero richiesto di versioni per un SharePoint list elemento o un file, più recente. Ogni versione include dettagli della versione, valori di colonna, valori di testo formattati e indicatori che mostrano le colonne modificate rispetto alla versione disponibile precedente. Selezionare il sito e l'elenco o la raccolta durante la configurazione di questa azione per rendere le colonne disponibili come contenuto dinamico. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL sito
|
siteUrl | True | string |
Selezionare un sito SharePoint o immettere l'URL del sito. |
|
Elenco o raccolta
|
listId | True | string |
Selezionare l'elenco o la raccolta le cui colonne di versione devono essere disponibili come contenuto dinamico nel flusso. |
|
ID articolo
|
itemId | True | integer |
SharePoint list ID elemento. Può essere fornito in modo dinamico in fase di esecuzione, ad esempio da un trigger SharePoint o da un'azione di flusso precedente. |
|
Unità di utilizzo massime
|
maximumUsageUnits | True | integer |
Limite richiesto selezionato dal chiamante sulle unità di utilizzo che questa chiamata può utilizzare. Il valore predefinito è 1. Si tratta di una protezione di fatturazione, non di un limite di conteggio delle versioni; un'unità di utilizzo può restituire più versioni complete. Usare Versioni massime per limitare il numero di righe di versione. |
|
Versioni massime
|
maximumVersions | integer |
Numero totale massimo di righe di versione complete da restituire in tutte le pagine. Lasciare vuoto per continuare fino al termine dell'intervallo selezionato, della cronologia disponibile o del budget delle unità di utilizzo. Ogni risposta non contiene più di 100 versioni. |
|
|
Campi da restituire
|
fieldsToReturn | array of string |
SharePoint colonne da includere in ogni versione. Aggiungere una colonna per ogni elemento. Lasciare campi vuoti per restituire ogni colonna supportata. La selezione di un numero inferiore di colonne può ridurre le dimensioni della risposta e il lavoro delle unità di utilizzo. |
|
|
Confronta da
|
fromVersion | string |
Punto di partenza per l'intervallo di cronologia delle versioni. Usa triggerWindowStartToken del trigger di SharePoint, se disponibile. È anche possibile immettere un'etichetta di versione, un token di modifica non elaborato o una data/ora di base. I valori di sola data usano mezzanotte nel fuso orario selezionato o UTC se non è selezionato alcun fuso orario. Lasciare vuoto per nessun limite precedente. |
|
|
Confronto con
|
toVersion | string |
Punto finale per l'intervallo di cronologia delle versioni. Usare il trigger di SharePoint WindowEndToken, se disponibile. È anche possibile immettere un'etichetta di versione, un token di modifica non elaborato o una data/ora. I valori di sola data usano mezzanotte nel fuso orario selezionato o UTC se non è selezionato alcun fuso orario. Lasciare vuoto per nessun limite più recente. |
|
|
Paging Token
|
continuationToken | string |
Token usato per recuperare la pagina successiva della cronologia delle versioni, se ne è stata restituita una precedente. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se includere versioni secondarie o bozza durante il recupero della cronologia delle versioni. Il valore predefinito è false, quindi vengono restituite solo le versioni principali. |
|
|
Formato data
|
dateFormat | string |
Formato utilizzato per i campi DateTime, ad esempio 'aa-MM-gg', 'dd/MM/aa', 'MM/gg/aa'). Il valore predefinito è 'aaaa-MM-gg'. |
|
|
Formato ora
|
timeFormat | string |
Formato utilizzato per la parte temporale dei campi DateTime, ad esempio HH:mm:ss, HH:mm, hh:mm tt. Il valore predefinito è HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso orario usato per la formattazione di date e ore (ad esempio, America/New_York, Europa/Londra, Australia/Sydney). Impostazione predefinita su UTC. |
Valori restituiti
Ottenere modifiche all'elemento o al file come HTML di avviso
Restituisce codice HTML di inoltro avvisi pronto per SharePoint modifiche agli elementi, progettato principalmente per i messaggi di posta elettronica di avviso, ma utilizzabile ovunque sia supportato il codice HTML. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL sito
|
siteUrl | True | string |
Selezionare un sito SharePoint o immettere l'URL del sito. |
|
Elenco o raccolta
|
listId | True | string |
Selezionare un elenco o una raccolta oppure immettere il titolo o il GUID. |
|
ID articolo
|
itemId | True | integer |
ID dell'elemento o del file di SharePoint da analizzare per individuare le modifiche. |
|
Confronta da
|
triggerWindowStartToken | string |
Punto di partenza per il confronto. Usa triggerWindowStartToken del trigger di SharePoint, se disponibile. È anche possibile immettere un'etichetta di versione, un token di modifica non elaborato o una data/ora di base. I valori di sola data usano mezzanotte nel fuso orario selezionato o UTC se non è selezionato alcun fuso orario. Lasciare vuoto per confrontare la versione precedente. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se includere versioni secondarie o bozza durante il confronto delle modifiche. Il valore predefinito è false, quindi vengono confrontate 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 utilizzato per i campi DateTime, ad esempio 'aa-MM-gg', 'dd/MM/aaaa'). Il valore predefinito è 'aaaa-MM-gg'. |
|
|
Formato ora
|
timeFormat | string |
Formato utilizzato per la parte temporale dei campi DateTime, ad esempio HH:mm:ss, HH:mm, hh:mm tt. Il valore predefinito è HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso orario usato per la formattazione di date e ore (ad esempio, America/New_York, Europa/Londra, Australia/Sydney). Impostazione predefinita su UTC. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean |
True quando l'azione è stata completata correttamente; false quando la convalida o l'elaborazione non è riuscita. |
|
Message
|
message | string |
Messaggio rivolto all'utente che descrive il risultato dell'operazione. Gli agenti e i copiloti devono visualizzare questo messaggio all'utente quando contiene informazioni di valutazione, sottoscrizione, utilizzo, avviso o elaborazione della versione. |
|
Visualizzare l'avviso utente
|
shouldDisplayUserNotice | boolean |
Indica se Inoltro avvisi ha restituito una versione di valutazione, una sottoscrizione o un avviso di utilizzo importante per l'utente. |
|
Codice di avviso utente
|
userNoticeCode | string |
Motivo leggibile del computer stabile per l'avviso dell'utente. |
|
Gravità avviso utente
|
userNoticeSeverity | string |
Gravità della presentazione per l'avviso dell'utente: informazioni, avvisi o critici. |
|
Avviso utente
|
userNotice | string |
Informazioni importanti sulla versione di valutazione, la sottoscrizione o l'utilizzo di Inoltro avvisi. |
|
Avviso utente Invito all'azione
|
userNoticeCallToAction | string |
Cosa può fare l'utente successivamente, incluso il sito Web di Inoltro avvisi e il messaggio di posta elettronica di supporto. |
|
Corpo HTML
|
htmlBody | string |
Corpo HTML per il messaggio di avviso, pronto per l'uso nella posta elettronica o in qualsiasi punto del codice HTML supportato. |
|
Oggetto avviso generato
|
subject | string |
Riga dell'oggetto suggerita per l'avviso |
|
Nome elemento o file
|
itemTitle | string |
Titolo o nome file dell'elemento o del file modificato. |
|
URL elemento o file
|
itemUrl | string |
Collegamento diretto all'elemento o al file SharePoint modificato. |
|
Nuovo elemento
|
isNewItem | boolean |
Determina se l'avviso generato descrive l'elemento o il file come aggiunto o modificato. |
|
Error
|
error | string |
Dettagli errore se l'operazione ha esito positivo è false |
Ottenere modifiche dettagliate all'elemento o al file
Recupera le modifiche dettagliate e formattate a livello di campo per un SharePoint list elemento o file, confrontando la versione corrente con una versione precedente. Usare questa opzione quando si vogliono dati di modifica avanzati, non solo i SharePoint indicatori di modifica true/false. I risultati possono includere una versione di valutazione, una sottoscrizione o un avviso di utilizzo importanti per l'utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL sito
|
siteUrl | True | string |
Selezionare un sito SharePoint o immettere l'URL del sito. |
|
Elenco o raccolta
|
listId | True | string |
Selezionare un elenco o una raccolta oppure immettere il titolo o il GUID. |
|
ID articolo
|
itemId | True | integer |
ID dell'elemento o del file di SharePoint da analizzare per individuare le modifiche. |
|
Confronta da
|
triggerWindowStartToken | string |
Punto di partenza per il confronto. Usa triggerWindowStartToken del trigger di SharePoint, se disponibile. È anche possibile immettere un'etichetta di versione, un token di modifica non elaborato o una data/ora di base. I valori di sola data usano mezzanotte nel fuso orario selezionato o UTC se non è selezionato alcun fuso orario. Lasciare vuoto per confrontare la versione precedente. |
|
|
Includi versioni secondarie
|
includeMinorVersions | boolean |
Indica se includere versioni secondarie o bozza durante il confronto delle modifiche. Il valore predefinito è false, quindi vengono confrontate 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 utilizzato per i campi DateTime, ad esempio 'aa-MM-gg', 'dd/MM/aa', 'MM/gg/aa'). Il valore predefinito è 'aaaa-MM-gg'. |
|
|
Formato ora
|
timeFormat | string |
Formato utilizzato per la parte temporale dei campi DateTime, ad esempio HH:mm:ss, HH:mm, hh:mm tt. Il valore predefinito è HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso orario usato per la formattazione di date e ore (ad esempio, America/New_York, Europa/Londra, Australia/Sydney). Impostazione predefinita su UTC. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Success
|
success | boolean |
True quando l'azione è stata completata correttamente; false quando la convalida o l'elaborazione non è riuscita. |
|
Message
|
message | string |
Messaggio rivolto all'utente che descrive il risultato dell'operazione. Gli agenti e i copiloti devono visualizzare questo messaggio all'utente quando contiene informazioni di valutazione, sottoscrizione, utilizzo, avviso o elaborazione della versione. |
|
Visualizzare l'avviso utente
|
shouldDisplayUserNotice | boolean |
Indica se Inoltro avvisi ha restituito una versione di valutazione, una sottoscrizione o un avviso di utilizzo importante per l'utente. |
|
Codice di avviso utente
|
userNoticeCode | string |
Motivo leggibile del computer stabile per l'avviso dell'utente. |
|
Gravità avviso utente
|
userNoticeSeverity | string |
Gravità della presentazione per l'avviso dell'utente: informazioni, avvisi o critici. |
|
Avviso utente
|
userNotice | string |
Informazioni importanti sulla versione di valutazione, la sottoscrizione o l'utilizzo di Inoltro avvisi. |
|
Avviso utente Invito all'azione
|
userNoticeCallToAction | string |
Cosa può fare l'utente successivamente, incluso il sito Web di Inoltro avvisi e il messaggio di posta elettronica di supporto. |
|
Campi modificati
|
changedFields | array of object |
Elenco di campi confrontati SharePoint, inclusi il nome di ogni campo, il valore precedente, il valore corrente e se è stato modificato. |
|
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. |
|
Nuovo elemento
|
isNewItem | boolean |
True quando l'elemento o il file deve essere considerato nuovo per la finestra di confronto risolta anziché come aggiornamento. |
|
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') |
|
Nome elemento o file
|
itemTitle | string |
Titolo o nome file dell'elemento o del file modificato. |
|
URL elemento o file
|
itemUrl | string |
Collegamento diretto all'elemento o al file SharePoint modificato. |
|
Data modifica
|
modifiedDate | date-time |
Data e ora 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 |