Alert Relay (förhandsversion)
Alert Relay ersätter tillbakadragna SharePoint-aviseringar med rikare, moderna meddelanden. Den returnerar detaljerade ändringar på fältnivå och HTML för aviseringar som är redo att användas så att du kan visa exakt vad som har ändrats i stället för generiska ändrade meddelanden.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | independNET-support |
| URL | https://independnet.com.au/alert-relay/support |
| E-postmeddelande | support@alertbridge.com.au |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | independNET-produkter |
| Webbplats | https://independnet.com.au/alert-relay/ |
| Sekretesspolicy | https://independnet.com.au/alert-relay/privacy |
| Kategorier | Samarbete; Produktivitet |
Aviseringsrelä
Alert Relay ersätter tillbakadragna SharePoint-aviseringar med rikare, moderna meddelanden för Microsoft 365-miljöer. Den innehåller detaljerad information om ändring av SharePoint-objekt och dokument, inklusive formaterade jämförelser på fältnivå och html-aviseringsutdata som är redo att användas.
Overview
Alert Relay är utformat för tillverkare som vill ha mer användbara SharePoint-meddelanden än standardupplevelsen "objektet ändrades".
Den stöder:
- detaljerad kontroll av ändringar på fältnivå
- html-utdata som är redo att användas för e-postmeddelanden med aviseringar
- utlösa tokenparsing för baslinje- och första körningsbeslut
- SharePoint-listor
- Dokumentbibliotek
- Webbplatssidor/sidbibliotek
Huvudfunktioner
1. Detaljerad ändringsspårning
Anslutningsappen kan jämföra den aktuella versionen av ett SharePoint-objekt eller dokument med en tidigare version och returnera strukturerad ändringsinformation.
2. Html-aviseringsutdata som är redo att användas
Anslutningsappen kan generera formaterad HTML så att flöden kan skicka användbara aviseringsmeddelanden utan att skapa komplexa HTML-uttryck manuellt.
3. Utlösa tokenparsing
Åtgärden Parse Compare From avkodar SharePoint-ändringstoken, till exempel TriggerWindowStartToken och returnerar den inbäddade tidsstämpeln och tokeninformationen för beslutsfattande i flöden.
4. Dynamiska listrutor
Anslutningsappen innehåller dynamiskt listrutestöd för:
- sites
- listor och bibliotek
- datumformat
- tidsformat
- tidszoner
5. Flexibel jämförelsebaslinje
Anslutningsappen stöder jämförelse från:
- SharePoint-utlösartoken
- raw SharePoint-ändringstoken
- versionsetiketter
- ISO 8601 datum/datum-tid-baslinjer
Åtgärder som stöds
Hämta detaljerade ändringar
Returnerar strukturerad JSON som beskriver ändrade fält, inklusive tidigare och aktuella formaterade värden.
Hämta detaljerade ändringar som HTML-avisering
Returnerar HTML-utdata som är klara att användas och relaterade aviseringsmetadata för e-post eller andra HTML-kompatibla mål.
Parsa jämförelse från
Avkodar en SharePoint-utlösare/ändringstoken och returnerar den inbäddade tidsstämpeln och tokeninformationen.
Vanliga användningsfall
- Skicka bättre e-postmeddelanden med SharePoint-aviseringar när ett listobjekt ändras
- Visa tidigare och aktuella värden för viktiga affärsfält
- Spåra ändringar i dokumentbibliotekets metadata
- Skapa flöden för godkännande, efterlevnad eller granskningsmeddelanden
- Ignorera bullriga första körningsaviseringar genom att utvärdera datum för utlösartoken mot en vald baslinje
Authentication
Alert Relay använder Microsoft Entra ID-autentisering tillsammans med en API-prenumerationsnyckel.
Om du vill använda anslutningsappen behöver en användare:
- åtkomst till relevant SharePoint-webbplats, lista eller bibliotek
- en giltig aviseringsreläanslutning
- en giltig prenumerationsnyckel för Alert Relay API
När en klientorganisation först använder Alert Relay placeras den automatiskt i utvärderingsläge. Om du vill flytta från utvärderingsläget kontaktar du support@alertbridge.com.au.
Getting Started
Ett typiskt valideringsflöde använder:
- En SharePoint-utlösare, till exempel
When an item is created or modified - En aviseringsreläåtgärd, till exempel
Get Detailed Changes as Alert HTML - Ett e-postmeddelande eller skrivsteg för att använda det returnerade ämnet och HTML-utdata
För strukturerad nedströmsbearbetning använder Get Detailed Changes och itererar du över den returnerade changedFields matrisen.
Kända problem och begränsningar
- SharePoint Online stöds. Lokal SharePoint Server stöds inte.
- Tidsinställning för SharePoint-utlösare kan påverka jämförelser i första körningen eftersom utlösartoken återspeglar SharePoint-utlösarfönstret i stället för en aviseringshistorik per objekt.
Support
Webbplats:
Sekretesspolicy:
Stöd:
E-post för support:
- support@alertbridge.com.au
Ytterligare anteckningar
Alert Relay är avsett att förbättra användbarheten för SharePoint-baserade meddelandescenarier genom att minska mängden anpassat uttrycksarbete som krävs i flöden, särskilt för HTML-e-postformatering och kontroll av ändringar på fältnivå.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
Åtgärder
| Hämta detaljerad objektavisering HTML |
Returnerar redo att använda Alert Relay HTML för SharePoint-objektändringar, främst utformade för e-postmeddelanden i SharePoint-stil men även användbara i dokument eller andra HTML-kompatibla mål. |
| Hämta detaljerade objektändringar |
Hämtar detaljerade, formaterade ändringar på fältnivå för ett SharePoint-listobjekt eller -dokument och jämför den aktuella versionen med den tidigare versionen. Använd detta när du vill ha omfattande ändringsdata i stället för inbyggda true/false-fältflaggor i SharePoint-stil. |
| Parsa jämförelse från |
Avkodar en TriggerWindowStartToken eller en rå SharePoint-ändringstoken och returnerar den inbäddade tidsstämpeln för flödesvillkor och baslinjebeslut. Den här åtgärden anropar inte SharePoint. |
Hämta detaljerad objektavisering HTML
Returnerar redo att använda Alert Relay HTML för SharePoint-objektändringar, främst utformade för e-postmeddelanden i SharePoint-stil men även användbara i dokument eller andra HTML-kompatibla mål.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Webbplats-URL
|
siteUrl | True | string |
Fullständig URL för SharePoint-webbplatsen som innehåller listan eller biblioteket. |
|
Lista eller bibliotek
|
listId | True | string |
GUID eller exakt rubrik för SharePoint-listan eller -biblioteket. Listrutan returnerar GUID-värden, men manuell post kan använda antingen ett GUID eller den exakta listrubriken. |
|
Artikel-ID
|
itemId | True | integer |
ID för SharePoint-objektet eller filen som ska analyseras för ändringar. |
|
Jämför från
|
triggerWindowStartToken | string |
Definierar startpunkten för ändringsjämförelse. Godkänner SharePoint-utlösarens {TriggerWindowStartToken} (rekommenderas), en versionsetikett som "5.0", en rå SharePoint-ändringstoken eller ett ISO 8601-baslinjedatum/datum-tid, till exempel "2026-03-30" eller "2026-03-30T14:15:00Z". Endast datumvärden tolkas som midnatt i den valda tidszonen eller UTC om tidszonen är tom. Utelämna att jämföra med den omedelbart tidigare versionen. |
|
|
Inkludera delversioner
|
includeMinorVersions | boolean |
Om mindre versioner eller utkastversioner ska delta i jämförelsen. Standardvärdet är false, vilket innebär att endast större versioner används. |
|
|
Inkludera oförändrade fält
|
includeUnchangedFields | boolean |
Om oförändrade fält ska inkluderas i den genererade HTML-koden. Standardinställningen är true. |
|
|
Datumformat
|
dateFormat | string |
Anpassat datumformat för DateTime-fält (till exempel "åååå-MM-dd", "dd/MM/åååå").). Standardvärdet är "åå-MM-dd" om det inte anges. |
|
|
Tidsformat
|
timeFormat | string |
Tidsformat som läggs till datum för DateTime-fält med tid (till exempel "HH:mm:ss", "HH:mm", "hh:mm tt"). |
|
|
Timezone
|
timezone | string |
IANA-tidszons-ID för datum-/tidskonvertering (till exempel "America/New_York", "Europe/London", "Australia/Sydney"). |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Anger om åtgärden har slutförts |
|
Message
|
message | string |
Mänskligt läsbart meddelande som beskriver resultatet |
|
HTML-brödtext
|
htmlBody | string |
Slutföra HTML-brödtext som är redo att användas i aviseringsmeddelanden eller andra HTML-kompatibla mål |
|
Föreslaget ämne
|
subject | string |
Föreslagen ämnesrad för aviseringen |
|
Objektrubrik
|
itemTitle | string |
Rubrik för det ändrade objektet |
|
Objekt-URL
|
itemUrl | string |
Direktlänk till det ändrade SharePoint-objektet |
|
Är nytt objekt
|
isNewItem | boolean |
Sant om aviseringen gäller för ett nytt SharePoint-objekt eller en ny fil i stället för en uppdatering av ett befintligt objekt. |
|
Fel
|
error | string |
Felinformation om lyckat resultat är falskt |
Hämta detaljerade objektändringar
Hämtar detaljerade, formaterade ändringar på fältnivå för ett SharePoint-listobjekt eller -dokument och jämför den aktuella versionen med den tidigare versionen. Använd detta när du vill ha omfattande ändringsdata i stället för inbyggda true/false-fältflaggor i SharePoint-stil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Webbplats-URL
|
siteUrl | True | string |
Fullständig URL för SharePoint-webbplatsen som innehåller listan eller biblioteket (till exempel |
|
Lista eller bibliotek
|
listId | True | string |
GUID eller exakt rubrik för SharePoint-listan eller -biblioteket. Listrutan returnerar GUID-värden, men manuell post kan använda antingen ett GUID eller den exakta listrubriken. |
|
Artikel-ID
|
itemId | True | integer |
ID för SharePoint-objektet eller filen som ska analyseras för ändringar (tillgängligt från utlösarutdata som ID). |
|
Jämför från
|
triggerWindowStartToken | string |
Definierar startpunkten för ändringsjämförelse. Godkänner SharePoint-utlösarens {TriggerWindowStartToken} (rekommenderas), en versionsetikett som "5.0", en rå SharePoint-ändringstoken eller ett ISO 8601-baslinjedatum/datum-tid, till exempel "2026-03-30" eller "2026-03-30T14:15:00Z". Endast datumvärden tolkas som midnatt i den valda tidszonen eller UTC om tidszonen är tom. Utelämna att jämföra med den omedelbart tidigare versionen. |
|
|
Inkludera delversioner
|
includeMinorVersions | boolean |
Om mindre versioner eller utkastversioner ska delta i jämförelsen. Standardvärdet är false, vilket innebär att endast större versioner används. |
|
|
Inkludera oförändrade fält
|
includeUnchangedFields | boolean |
Om oförändrade fält ska inkluderas i svaret. Standardinställningen är true. |
|
|
Datumformat
|
dateFormat | string |
Anpassat datumformat för DateTime-fält (till exempel "åååå-MM-dd", "dd/MM/åååå", "MM/dd/ååååå"). Standardvärdet är "åå-MM-dd" om det inte anges. |
|
|
Tidsformat
|
timeFormat | string |
Tidsformat som läggs till datum för DateTime-fält med tid (till exempel "HH:mm:ss", "HH:mm", "hh:mm tt"). Standardvärdet är "HH:mm:ss" om det inte anges. |
|
|
Timezone
|
timezone | string |
IANA-tidszons-ID för datum-/tidskonvertering (till exempel "America/New_York", "Europe/London", "Australia/Sydney"). Standardvärdet är UTC om det inte anges. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Anger om åtgärden har slutförts |
|
Message
|
message | string |
Mänskligt läsbart meddelande som beskriver resultatet |
|
Ändrade fält
|
changedFields | array of object |
Spårade fält som en matris. |
|
Kolumnvärdet har ändrats
|
changedFields.hasChanged | boolean |
Sant om det här fältets värde har ändrats mellan den tidigare och den aktuella versionen |
|
Föregående kolumnvärde (text)
|
changedFields.previousAsString | string |
Formaterat tidigare värde som en läsbar sträng för människor |
|
Internt namn på fält
|
changedFields.internalName | string |
Internt SharePoint-fältnamn |
|
Fältnamn
|
changedFields.displayName | string |
Eget visningsnamn för fältet |
|
Föregående kolumnvärde (detaljerat)
|
changedFields.previous |
Föregående raw-värde. Den här egenskapen är dynamisk och kan vara en sträng, ett tal, booleskt värde, ett objekt, en matris eller ett null-objekt beroende på typen av SharePoint-fält. |
|
|
Aktuellt kolumnvärde (text)
|
changedFields.currentAsString | string |
Formaterat aktuellt värde som en läsbar sträng för människor |
|
Aktuellt kolumnvärde (detaljerat)
|
changedFields.current |
Aktuellt raw-värde. Den här egenskapen är dynamisk och kan vara en sträng, ett tal, booleskt värde, ett objekt, en matris eller ett null-objekt beroende på typen av SharePoint-fält. |
|
|
Har jämförelsebaslinje
|
hasComparisonBaseline | boolean |
Sant om en distinkt baslinjeversion löstes för jämförelse med den aktuella versionen. |
|
Är originalplanens första version
|
isBaselineFirstVersion | boolean |
Sant om den lösta baslinjeversionen är den första versionen som någonsin registrerats för objektet eller filen. |
|
Aktuell versionsetikett
|
currentVersionLabel | string |
Versionsetikett för den aktuella versionen (till exempel "2.0", "5.0") |
|
Tidigare versionsetikett
|
previousVersionLabel | string |
Versionsetikett som används för jämförelse (till exempel "1.0", "4.0") |
|
Objektrubrik
|
itemTitle | string |
Rubrik för det ändrade objektet |
|
Objekt-URL
|
itemUrl | string |
Direktlänk till det ändrade SharePoint-objektet |
|
Ändrat datum
|
modifiedDate | date-time |
Tidsstämpel för den senaste ändringen |
|
Ändrad av
|
modifiedBy | string |
Visningsnamn för den användare som senast ändrade objektet |
|
Fel
|
error | string |
Felinformation om lyckat resultat är falskt |
Parsa jämförelse från
Avkodar en TriggerWindowStartToken eller en rå SharePoint-ändringstoken och returnerar den inbäddade tidsstämpeln för flödesvillkor och baslinjebeslut. Den här åtgärden anropar inte SharePoint.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Jämför från
|
compareFrom | True | string |
TriggerWindowStartToken eller rå SharePoint-ändringstoken för att avkoda. Versionsetiketter och ISO-datum/datum-tid-värden stöds inte av den här åtgärden. |
|
Timezone
|
timezone | string |
Valfritt IANA-tidszons-ID för ett lokalt jämförelsevärde (till exempel "America/New_York", "Europe/London", "Australia/Sydney"). Om det utelämnas returneras endast UTC-värdet. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Utc-tid för tokendatum
|
tokenDateTimeUTC | date-time |
Tokentidsstämpel i UTC. |
|
Lokal tokendatumtid
|
tokenDateTimeLocal | date-time |
Tokentidsstämpel konverterad till den begärda tidszonen. |
|
Avkodad token
|
decodedToken | string |
Avkodad råtokentext. För råtokens indata matchar detta det ursprungliga värdet. |
|
Är Base64-token
|
isBase64Token | boolean |
Sant när den inkommande token var base64-kodad. |
|
Sequence
|
sequence | integer |
SharePoint-ändringssekvensvärdet inbäddat i token. |
|
List-GUID
|
listGuid | uuid |
List- eller biblioteks-GUID inbäddat i token. |
|
Tokenversion
|
tokenVersion | integer |
Versionsnummer för token. |
|
Tokentyp
|
tokenType | integer |
SharePoint-tokentypnummer. |
|
Fel
|
error | string |
Felinformation vid parsning misslyckas. |