Waarschuwingsrelay (preview)
Alert Relay helpt het buiten gebruik stellen van SharePoint-waarschuwingen te vervangen door uitgebreidere, moderne meldingen. Het retourneert gedetailleerde wijzigingen op veldniveau en kant-en-klare waarschuwings-HTML, zodat u precies kunt weergeven wat er is gewijzigd in plaats van algemene gewijzigde meldingen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| contact opnemen met | |
|---|---|
| Name | independNET-ondersteuning |
| URL | https://independnet.com.au/alert-relay/support |
| E-mailen | support@alertbridge.com.au |
| Connectormetagegevens | |
|---|---|
| Publisher | independNET-producten |
| Website | https://independnet.com.au/alert-relay/ |
| Privacybeleid | https://independnet.com.au/alert-relay/privacy |
| Categorieën | Samenwerking; Productiviteit |
Waarschuwingsrelay
Alert Relay helpt het buiten gebruik stellen van SharePoint-waarschuwingen te vervangen door uitgebreidere, moderne meldingen voor Microsoft 365-omgevingen. Het bevat gedetailleerde Informatie over SharePoint-items en documentwijziging, waaronder opgemaakte vergelijkingen op veldniveau en kant-en-klare HTML-waarschuwingsuitvoer.
Overview
Alert Relay is ontworpen voor makers die nuttigere SharePoint-meldingen willen dan de standaardervaring 'item is gewijzigd'.
Het biedt ondersteuning voor:
- gedetailleerde wijzigingsinspectie op veldniveau
- kant-en-klare HTML-uitvoer voor waarschuwings-e-mailberichten
- tokenparsering activeren voor basislijn- en first-run-beslissingen
- SharePoint-lijsten
- documentbibliotheken
- Sitepagina's/paginabibliotheken
Belangrijke functies
1. Gedetailleerd bijhouden van wijzigingen
De connector kan de huidige versie van een SharePoint-item of -document vergelijken met een eerdere versie en gestructureerde wijzigingsgegevens retourneren.
2. Kant-en-klare HTML-waarschuwingsuitvoer
De connector kan opgemaakte HTML genereren, zodat stromen nuttige e-mailberichten met waarschuwingen kunnen verzenden zonder dat er handmatig complexe HTML-expressies hoeven te worden gebouwd.
3. Tokenparseren activeren
De Parse Compare From actie ontsleutelt SharePoint-wijzigingstokens, zoals TriggerWindowStartToken en retourneert de ingesloten tijdstempel- en tokengegevens voor besluitvorming in stromen.
4. Dynamische vervolgkeuzelijsten
De connector bevat dynamische vervolgkeuzelijsten voor:
- Sites
- lijsten en bibliotheken
- datumnotaties
- tijdnotaties
- tijdzones
5. Flexibele vergelijkingsbasislijn
De connector biedt ondersteuning voor het vergelijken van:
- SharePoint-triggertokens
- onbewerkte SharePoint-wijzigingstokens
- versielabels
- ISO 8601-datum-/datum-tijdbasislijnen
Ondersteunde acties
Gedetailleerde wijzigingen ophalen
Retourneert gestructureerde JSON die gewijzigde velden beschrijft, inclusief eerdere en huidige opgemaakte waarden.
Gedetailleerde wijzigingen ophalen als HTML-waarschuwing
Retourneert kant-en-klare HTML-uitvoer en gerelateerde waarschuwingsmetagegevens voor e-mail of andere HTML-compatibele bestemmingen.
Vergelijken van parseren van
Decodeert een SharePoint-trigger-/wijzigingstoken en retourneert de ingesloten tijdstempel- en tokendetails.
Typische gebruiksvoorbeelden
- Betere SharePoint-waarschuwingsmails verzenden wanneer een lijstitem wordt gewijzigd
- Vorige en huidige waarden weergeven voor belangrijke zakelijke velden
- Wijzigingen in metagegevens van documentbibliotheek bijhouden
- Goedkeurings-, nalevings- of controlemeldingsstromen bouwen
- Luidruchtige waarschuwingen voor het eerst uitvoeren onderdrukken door triggertokendatums te evalueren op basis van een gekozen basislijn
Authenticatie
Alert Relay maakt gebruik van Microsoft Entra ID-verificatie samen met een API-abonnementssleutel.
Als u de connector wilt gebruiken, heeft een gebruiker het volgende nodig:
- toegang tot de relevante SharePoint-site, -lijst of -bibliotheek
- een geldige Alert Relay-verbinding
- een geldige abonnementssleutel voor de Alert Relay-API
Wanneer een tenant voor het eerst Alert Relay gebruikt, wordt deze automatisch in de evaluatiemodus geplaatst. Neem contact op support@alertbridge.com.auom de proefversie te verlaten.
Aan de slag komen
Een typische validatiestroom maakt gebruik van:
- Een SharePoint-trigger zoals
When an item is created or modified - Een waarschuwingsrelaisactie, zoals
Get Detailed Changes as Alert HTML - Een e-mail- of opstellenstap voor het gebruik van de geretourneerde onderwerp- en HTML-uitvoer
Voor gestructureerde downstreamverwerking gebruikt Get Detailed Changes en voert u deze uit over de geretourneerde changedFields matrix.
Bekende problemen en beperkingen
- SharePoint Online wordt ondersteund; SharePoint Server on-premises wordt niet ondersteund.
- Timing van SharePoint-triggers kan van invloed zijn op first-run-vergelijkingen, omdat triggertokens het SharePoint-triggervenster weerspiegelen in plaats van een waarschuwingsgeschiedenis per item.
Support
Website:
Privacybeleid:
Ondersteuning:
E-mail voor ondersteuning:
- support@alertbridge.com.au
Aanvullende notities
Alert Relay is bedoeld om de bruikbaarheid voor op SharePoint gebaseerde meldingsscenario's te verbeteren door de hoeveelheid aangepaste expressies die nodig zijn in stromen te verminderen, met name voor html-e-mailopmaak en wijzigingsinspectie op veldniveau.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Gedetailleerde HTML-code voor itemwaarschuwingen ophalen |
Retourneert kant-en-klare HTML-code voor SharePoint-items, ontworpen voor e-mailberichten met waarschuwingen in SharePoint-stijl, maar ook bruikbaar in documenten of andere HTML-bestemmingen. |
| Gedetailleerde itemwijzigingen ophalen |
Hiermee worden gedetailleerde, opgemaakte wijzigingen op veldniveau opgehaald voor een SharePoint-lijstitem of -document, waarbij de huidige versie wordt vergeleken met de vorige versie. Gebruik dit als u uitgebreide wijzigingsgegevens wilt in plaats van de ingebouwde SharePoint-stijl waar/onwaar veldvlagmen. |
| Vergelijken van parseren van |
Decodeert een TriggerWindowStartToken of onbewerkt SharePoint-wijzigingstoken en retourneert de ingesloten tijdstempel voor stroomvoorwaarden en basislijnbeslissingen. Met deze actie wordt SharePoint niet aangeroepen. |
Gedetailleerde HTML-code voor itemwaarschuwingen ophalen
Retourneert kant-en-klare HTML-code voor SharePoint-items, ontworpen voor e-mailberichten met waarschuwingen in SharePoint-stijl, maar ook bruikbaar in documenten of andere HTML-bestemmingen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Site-URL
|
siteUrl | True | string |
Volledige URL van de SharePoint-site met de lijst of bibliotheek. |
|
Lijst of bibliotheek
|
listId | True | string |
GUID of exacte titel van de SharePoint-lijst of -bibliotheek. De vervolgkeuzelijst retourneert GUID-waarden, maar handmatige vermelding kan een GUID of de exacte lijsttitel gebruiken. |
|
Artikel-ID
|
itemId | True | integer |
Id van het SharePoint-item of -bestand dat moet worden geanalyseerd op wijzigingen. |
|
Vergelijken van
|
triggerWindowStartToken | string |
Definieert het beginpunt voor wijzigingsvergelijking. Accepteert het {TriggerWindowStartToken} van de SharePoint-trigger (aanbevolen), een versielabel zoals '5.0', een onbewerkt SharePoint-wijzigingstoken of een ISO 8601-basislijndatum/datum-tijd, zoals '2026-03-30' of '2026-03-30T14:15:00Z'. Alleen-datumwaarden worden geïnterpreteerd als middernacht in de geselecteerde tijdzone of UTC als tijdzone leeg is. Laat weg om te vergelijken met de direct vorige versie. |
|
|
Secundaire versies opnemen
|
includeMinorVersions | boolean |
Of secundaire of conceptversies deel moeten uitmaken van de vergelijking. De standaardinstelling is onwaar, wat betekent dat alleen primaire versies worden gebruikt. |
|
|
Ongewijzigde velden opnemen
|
includeUnchangedFields | boolean |
Of ongewijzigde velden moeten worden opgenomen in de gegenereerde HTML. De standaardwaarde is true. |
|
|
Datumnotatie
|
dateFormat | string |
Aangepaste datumnotatie voor Datum/tijd-velden (bijvoorbeeld 'jjjj-MM-dd', 'dd/MM/jjjj'). De standaardwaarde is 'jjjj-MM-dd' als deze niet is opgegeven. |
|
|
Tijdnotatie
|
timeFormat | string |
Tijdnotatie toegevoegd aan datum/tijdvelden met tijd (bijvoorbeeld 'UU:mm:ss', 'UU:mm', 'uu:mm', 'uu:mm tt'). |
|
|
Timezone
|
timezone | string |
IANA-tijdzone-id voor datum-/tijdconversie (bijvoorbeeld 'Amerika/New_York', 'Europa/Londen', 'Australië/Sydney'). |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Geeft aan of de bewerking is voltooid |
|
Message
|
message | string |
Leesbaar bericht waarin het resultaat wordt beschreven |
|
HTML-hoofdtekst
|
htmlBody | string |
Volledige HTML-hoofdtekst die gereed is voor gebruik in waarschuwings-e-mailberichten of andere HTML-bestemmingen |
|
Voorgesteld onderwerp
|
subject | string |
Voorgestelde onderwerpregel voor de waarschuwing |
|
Titel van item
|
itemTitle | string |
Titel van het gewijzigde item |
|
Item-URL
|
itemUrl | string |
Directe koppeling naar het gewijzigde SharePoint-item |
|
Is nieuw item
|
isNewItem | boolean |
Waar als de waarschuwing voor een nieuw SharePoint-item of -bestand is in plaats van een update naar een bestaand item of bestand. |
|
Fout
|
error | string |
Foutdetails als geslaagd onwaar is |
Gedetailleerde itemwijzigingen ophalen
Hiermee worden gedetailleerde, opgemaakte wijzigingen op veldniveau opgehaald voor een SharePoint-lijstitem of -document, waarbij de huidige versie wordt vergeleken met de vorige versie. Gebruik dit als u uitgebreide wijzigingsgegevens wilt in plaats van de ingebouwde SharePoint-stijl waar/onwaar veldvlagmen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Site-URL
|
siteUrl | True | string |
Volledige URL van de SharePoint-site met de lijst of bibliotheek (bijvoorbeeld |
|
Lijst of bibliotheek
|
listId | True | string |
GUID of exacte titel van de SharePoint-lijst of -bibliotheek. De vervolgkeuzelijst retourneert GUID-waarden, maar handmatige vermelding kan een GUID of de exacte lijsttitel gebruiken. |
|
Artikel-ID
|
itemId | True | integer |
Id van het SharePoint-item of -bestand dat moet worden geanalyseerd op wijzigingen (beschikbaar vanuit triggeruitvoer als id). |
|
Vergelijken van
|
triggerWindowStartToken | string |
Definieert het beginpunt voor wijzigingsvergelijking. Accepteert het {TriggerWindowStartToken} van de SharePoint-trigger (aanbevolen), een versielabel zoals '5.0', een onbewerkt SharePoint-wijzigingstoken of een ISO 8601-basislijndatum/datum-tijd, zoals '2026-03-30' of '2026-03-30T14:15:00Z'. Alleen-datumwaarden worden geïnterpreteerd als middernacht in de geselecteerde tijdzone of UTC als tijdzone leeg is. Laat weg om te vergelijken met de direct vorige versie. |
|
|
Secundaire versies opnemen
|
includeMinorVersions | boolean |
Of secundaire of conceptversies deel moeten uitmaken van de vergelijking. De standaardinstelling is onwaar, wat betekent dat alleen primaire versies worden gebruikt. |
|
|
Ongewijzigde velden opnemen
|
includeUnchangedFields | boolean |
Of ongewijzigde velden moeten worden opgenomen in het antwoord. De standaardwaarde is true. |
|
|
Datumnotatie
|
dateFormat | string |
Aangepaste datumnotatie voor Datum/tijd-velden (bijvoorbeeld 'jjjj-MM-dd', 'dd/MM/jjjj', 'MM/dd/jjjj'). De standaardwaarde is 'jjjj-MM-dd' als deze niet is opgegeven. |
|
|
Tijdnotatie
|
timeFormat | string |
Tijdnotatie toegevoegd aan datum/tijdvelden met tijd (bijvoorbeeld 'UU:mm:ss', 'UU:mm', 'uu:mm', 'uu:mm tt'). De standaardwaarde is 'uu:mm:ss' als deze niet is opgegeven. |
|
|
Timezone
|
timezone | string |
IANA-tijdzone-id voor datum-/tijdconversie (bijvoorbeeld 'Amerika/New_York', 'Europa/Londen', 'Australië/Sydney'). De standaard is UTC als er geen specifieke tijdzone is opgegeven. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Geeft aan of de bewerking is voltooid |
|
Message
|
message | string |
Leesbaar bericht waarin het resultaat wordt beschreven |
|
Gewijzigde velden
|
changedFields | array of object |
Bijgehouden velden als een matrix. |
|
Kolomwaarde is gewijzigd
|
changedFields.hasChanged | boolean |
Waar als de waarde van dit veld is gewijzigd tussen de vorige en huidige versie |
|
Vorige kolomwaarde (tekst)
|
changedFields.previousAsString | string |
Opgemaakte vorige waarde als een door mensen leesbare tekenreeks |
|
Interne veldnaam
|
changedFields.internalName | string |
Interne SharePoint-veldnaam |
|
Veldnaam
|
changedFields.displayName | string |
Beschrijvende weergavenaam voor het veld |
|
Vorige kolomwaarde (gedetailleerd)
|
changedFields.previous |
Onbewerkte vorige waarde. Deze eigenschap is dynamisch en kan een tekenreeks, getal, booleaanse waarde, object, matrix of null zijn, afhankelijk van het SharePoint-veldtype. |
|
|
Huidige kolomwaarde (tekst)
|
changedFields.currentAsString | string |
Opgemaakte huidige waarde als een door mensen leesbare tekenreeks |
|
Huidige kolomwaarde (gedetailleerd)
|
changedFields.current |
Onbewerkte huidige waarde. Deze eigenschap is dynamisch en kan een tekenreeks, getal, booleaanse waarde, object, matrix of null zijn, afhankelijk van het SharePoint-veldtype. |
|
|
Heeft vergelijkingsbasislijn
|
hasComparisonBaseline | boolean |
Waar als een afzonderlijke basislijnversie is opgelost voor vergelijking met de huidige versie. |
|
Is eerste versie basislijn
|
isBaselineFirstVersion | boolean |
Is waar als de opgeloste basislijnversie de eerste versie is die ooit is vastgelegd voor het item of bestand. |
|
Huidig versielabel
|
currentVersionLabel | string |
Versielabel van de huidige versie (bijvoorbeeld '2.0', '5.0') |
|
Label van vorige versie
|
previousVersionLabel | string |
Versielabel dat wordt gebruikt voor vergelijking (bijvoorbeeld '1.0', '4.0') |
|
Titel van item
|
itemTitle | string |
Titel van het gewijzigde item |
|
Item-URL
|
itemUrl | string |
Directe koppeling naar het gewijzigde SharePoint-item |
|
Gewijzigd op
|
modifiedDate | date-time |
Tijdstempel van de meest recente wijziging |
|
Gewijzigd door
|
modifiedBy | string |
Weergavenaam van de gebruiker die het item het laatst heeft gewijzigd |
|
Fout
|
error | string |
Foutdetails als geslaagd onwaar is |
Vergelijken van parseren van
Decodeert een TriggerWindowStartToken of onbewerkt SharePoint-wijzigingstoken en retourneert de ingesloten tijdstempel voor stroomvoorwaarden en basislijnbeslissingen. Met deze actie wordt SharePoint niet aangeroepen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Vergelijken van
|
compareFrom | True | string |
TriggerWindowStartToken of onbewerkt SharePoint-wijzigingstoken om te decoderen. Versielabels en ISO-datum-/datum-tijdwaarden worden niet ondersteund door deze actie. |
|
Timezone
|
timezone | string |
Optionele IANA-tijdzone-id voor een lokale vergelijkingswaarde (bijvoorbeeld 'Amerika/New_York', 'Europa/Londen', 'Australië/Sydney'). Als u dit weglaat, wordt alleen de UTC-waarde geretourneerd. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Datum/tijd van token UTC
|
tokenDateTimeUTC | date-time |
Tijdstempel van tokens in UTC. |
|
Datum/tijd van token lokaal
|
tokenDateTimeLocal | date-time |
Tokentijdstempel geconverteerd naar de aangevraagde tijdzone. |
|
Gedecodeerd token
|
decodedToken | string |
Onbewerkte tokentekst gedecodeerd. Voor onbewerkte tokeninvoer komt dit overeen met de oorspronkelijke waarde. |
|
Is Base64-token
|
isBase64Token | boolean |
Waar wanneer het binnenkomende token base64 is gecodeerd. |
|
Sequence
|
sequence | integer |
SharePoint-wijzigingsreekswaarde die is ingesloten in het token. |
|
Lijst-GUID
|
listGuid | uuid |
Lijst of bibliotheek-GUID die is ingesloten in het token. |
|
Tokenversie
|
tokenVersion | integer |
Tokenversienummer. |
|
Token type
|
tokenType | integer |
SharePoint-tokentypenummer. |
|
Fout
|
error | string |
Foutdetails bij parseren mislukt. |