Warnungsrelay (Vorschau)
Alert Relay hilft, SharePoint-Benachrichtigungen durch umfangreichere, moderne Benachrichtigungen zu ersetzen. Es gibt detaillierte Änderungen auf Feldebene und einsatzbereite Warnungs-HTML zurück, sodass Sie genau anzeigen können, was sich geändert hat, anstatt generische geänderte Benachrichtigungen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | independNET-Support |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Connectormetadaten | |
|---|---|
| Herausgeber | independNET-Produkte |
| Website | https://independnet.com.au/alert-relay/ |
| Datenschutzrichtlinie | https://independnet.com.au/alert-relay/privacy |
| Kategorien | Zusammenarbeit; Produktivität |
Warnungsrelay
Das Warnungsrelay ersetzt die Einstellung von SharePoint-Warnungen durch umfangreichere, moderne Benachrichtigungen für Microsoft 365-Umgebungen. Es bietet detaillierte Informationen zu SharePoint-Elementen und -Dokumentänderungen, einschließlich formatierter Vergleiche auf Feldebene und einsatzbereiter HTML-Warnungsausgabe.
Übersicht
Das Warnungsrelay wurde für Entwickler entwickelt, die nützlichere SharePoint-Benachrichtigungen als die Standardmäßige Oberfläche "Element wurde geändert" benötigen.
Es unterstützt:
- Detaillierte Änderungsüberprüfung auf Feldebene
- sofort einsatzbereite HTML-Ausgabe für Warnungs-E-Mails
- Auslösen der Tokenanalyse für Basis- und Erstausführungsentscheidungen
- SharePoint-Listen
- Dokumentenbibliotheken
- Websiteseiten/Seitenbibliotheken
Wichtige Features
1. Detaillierte Änderungsnachverfolgung
Der Connector kann die aktuelle Version eines SharePoint-Elements oder -Dokuments mit einer früheren Version vergleichen und strukturierte Änderungsdetails zurückgeben.
2. Html-Benachrichtigungsausgabe bereit für die Verwendung
Der Connector kann formatierten HTML-Code generieren, sodass Flüsse nützliche Warnungs-E-Mails senden können, ohne komplexe HTML-Ausdrücke manuell zu erstellen.
3. Auslösen der Tokenanalyse
Die Parse Compare From Aktion decodiert SharePoint-Änderungstoken, z TriggerWindowStartToken . B. und gibt die eingebetteten Zeitstempel- und Tokendetails für Entscheidungsfindung in Flüssen zurück.
4. Dynamische Dropdowns
Der Connector enthält eine dynamische Dropdownunterstützung für:
- Standorte
- Listen und Bibliotheken
- Datumsformate
- Zeitformate
- Zeitzonen
5. Flexible Vergleichsbasislinie
Der Connector unterstützt den Vergleich von:
- SharePoint-Triggertoken
- Unformatierte SharePoint-Änderungstoken
- Versionsbezeichnungen
- ISO 8601- Datums-/Datum-Uhrzeit-Basispläne
Unterstützte Aktionen
Abrufen detaillierter Änderungen
Gibt strukturiertes JSON zurück, das geänderte Felder beschreibt, einschließlich vorheriger und aktueller formatierter Werte.
Detaillierte Änderungen als Warnungs-HTML abrufen
Gibt bereit zu verwendende HTML-Ausgabe und zugehörige Warnungsmetadaten für E-Mails oder andere HTML-fähige Ziele zurück.
Analysevergleich von
Decodiert ein SharePoint-Trigger-/Änderungstoken und gibt die eingebetteten Zeitstempel- und Tokendetails zurück.
Typische Anwendungsfälle
- Senden besserer SharePoint-Benachrichtigungs-E-Mails, wenn sich ein Listenelement ändert
- Anzeigen von vorherigen und aktuellen Werten für wichtige Geschäftsfelder
- Nachverfolgen von Metadatenänderungen der Dokumentbibliothek
- Erstellen von Genehmigungs-, Compliance- oder Überwachungsbenachrichtigungsflüssen
- Unterdrücken von lauten Warnungen bei der ersten Ausführung durch Auswerten von Triggertokendaten anhand eines ausgewählten Basisplans
Authentication
Alert Relay verwendet die Microsoft Entra ID-Authentifizierung zusammen mit einem API-Abonnementschlüssel.
Um den Connector zu verwenden, benötigt ein Benutzer Folgendes:
- Zugriff auf die relevante SharePoint-Website, -Liste oder -Bibliothek
- eine gültige Warnungsrelayverbindung
- ein gültiger Warnungsrelay-API-Abonnementschlüssel
Wenn ein Mandant das Warnungsrelay zum ersten Mal verwendet, wird er automatisch in den Testmodus versetzt. Um aus dem Testmodus zu wechseln, wenden Sie sich an support@alertbridge.com.au.
Getting Started
Ein typischer Überprüfungsfluss verwendet:
- Ein SharePoint-Auslöser, z. B.
When an item is created or modified - Eine Warnungsrelay-Aktion, z. B.
Get Detailed Changes as Alert HTML - Ein E-Mail- oder Verfassenschritt zur Verwendung des zurückgegebenen Betreffs und der HTML-Ausgabe
Verwenden Und durchlaufen Sie Get Detailed Changes für die strukturierte nachgelagerte Verarbeitung das zurückgegebene changedFields Array.
Bekannte Probleme und Einschränkungen
- SharePoint Online wird unterstützt; Lokales SharePoint Server wird nicht unterstützt.
- Die Anzeigedauer für SharePoint-Trigger kann sich auf Vergleiche der ersten Ausführung auswirken, da Triggertoken das SharePoint-Triggerfenster anstelle eines Warnungsverlaufs pro Element widerspiegeln.
Support
Website:
Datenschutz:
Unterstützung:
Support-E-Mail:
- support@alertbridge.com.au
Weitere Hinweise
Das Warnungsrelay soll die Benutzerfreundlichkeit für SharePoint-basierte Benachrichtigungsszenarien verbessern, indem die Menge der in Flüssen erforderlichen arbeit von benutzerdefinierten Ausdrücken reduziert wird, insbesondere für HTML-E-Mail-Formatierung und Änderungsüberprüfung auf Feldebene.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen detaillierter Elementbenachrichtigungs-HTML |
Gibt bereit zu verwendende Warnungsrelay-HTML für SharePoint-Elementänderungen zurück, die hauptsächlich für SharePoint-Stil-Warnungs-E-Mails entwickelt wurden, aber auch in Dokumenten oder anderen HTML-fähigen Zielen verwendet werden können. |
| Abrufen detaillierter Elementänderungen |
Ruft detaillierte, formatierte Änderungen auf Feldebene für ein SharePoint-Listenelement oder -Dokument ab, wobei die aktuelle Version mit der vorherigen Version verglichen wird. Verwenden Sie diese Einstellung, wenn Sie umfangreiche Änderungsdaten anstelle der integrierten Feldkennzeichnungen im SharePoint-Stil "true/false" verwenden möchten. |
| Analysevergleich von |
Decodiert ein TriggerWindowStartToken oder ein unformatiertes SharePoint-Änderungstoken und gibt den eingebetteten Zeitstempel für Flussbedingungen und Basisentscheidungen zurück. Diese Aktion ruft SharePoint nicht auf. |
Abrufen detaillierter Elementbenachrichtigungs-HTML
Gibt bereit zu verwendende Warnungsrelay-HTML für SharePoint-Elementänderungen zurück, die hauptsächlich für SharePoint-Stil-Warnungs-E-Mails entwickelt wurden, aber auch in Dokumenten oder anderen HTML-fähigen Zielen verwendet werden können.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Website-URL
|
siteUrl | True | string |
Vollständige URL der SharePoint-Website, die die Liste oder Bibliothek enthält. |
|
Liste oder Bibliothek
|
listId | True | string |
GUID oder exakter Titel der SharePoint-Liste oder -Bibliothek. Die Dropdownliste gibt GUID-Werte zurück, aber manuelle Eingabe kann entweder eine GUID oder den exakten Listentitel verwenden. |
|
Artikel-ID
|
itemId | True | integer |
ID des SharePoint-Elements oder der Datei, das für Änderungen analysiert werden soll. |
|
Vergleichen von
|
triggerWindowStartToken | string |
Definiert den Ausgangspunkt für den Änderungsvergleich. Akzeptiert das {TriggerWindowStartToken} des SharePoint-Triggers (empfohlen), eine Versionsbezeichnung wie "5.0", ein rohes SharePoint-Änderungstoken oder ein ISO 8601-Basisdatum/Datum-Uhrzeit wie "2026-03-30" oder "2026-03-30T14:15:00Z". Datumsgeschützte Werte werden in der ausgewählten Zeitzone als Mitternacht interpretiert, oder UTC, wenn die Zeitzone leer ist. Lassen Sie den Vergleich mit der unmittelbar vorherigen Version aus. |
|
|
Nebenversionen einschließen
|
includeMinorVersions | boolean |
Ob Neben- oder Entwurfsversionen am Vergleich teilnehmen sollen. Standardwert ist "false", was bedeutet, dass nur Hauptversionen verwendet werden. |
|
|
Unveränderte Felder einschließen
|
includeUnchangedFields | boolean |
Gibt an, ob unveränderte Felder in den generierten HTML-Code eingeschlossen werden sollen. Die Standardeinstellung ist „true“. |
|
|
Datumsformat
|
dateFormat | string |
Benutzerdefiniertes Datumsformat für DateTime-Felder (z. B. "JJJJ-MM-TT", "TT/MM/JJJJ"). Wenn nicht angegeben, wird standardmäßig "yyyy-MM-dd" festgelegt. |
|
|
Zeitformat
|
timeFormat | string |
An Datum angefügtes Zeitformat für DateTime-Felder mit Uhrzeit (z. B. 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
IANA-Zeitzonen-ID für die Datums-/Uhrzeitkonvertierung (z. B. "America/New_York", "Europe/London", "Australia/Sydney"). |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Success
|
success | boolean |
Gibt an, ob der Vorgang erfolgreich abgeschlossen wurde. |
|
Meldung
|
message | string |
Lesbare Nachricht, die das Ergebnis beschreibt |
|
HTML-Textkörper
|
htmlBody | string |
Vollständiger HTML-Textkörper, der in Warnungs-E-Mails oder anderen HTML-fähigen Zielen verwendet werden kann |
|
Vorgeschlagener Betreff
|
subject | string |
Vorgeschlagene Betreffzeile für die Warnung |
|
Elementtitel
|
itemTitle | string |
Titel des geänderten Elements |
|
Element-URL
|
itemUrl | string |
Direkter Link zum geänderten SharePoint-Element |
|
Ist ein neues Element
|
isNewItem | boolean |
True, wenn die Warnung für ein neues SharePoint-Element oder eine neue Datei anstelle einer Aktualisierung auf eine vorhandene ist. |
|
Fehler
|
error | string |
Fehlerdetails, wenn der Erfolg falsch ist |
Abrufen detaillierter Elementänderungen
Ruft detaillierte, formatierte Änderungen auf Feldebene für ein SharePoint-Listenelement oder -Dokument ab, wobei die aktuelle Version mit der vorherigen Version verglichen wird. Verwenden Sie diese Einstellung, wenn Sie umfangreiche Änderungsdaten anstelle der integrierten Feldkennzeichnungen im SharePoint-Stil "true/false" verwenden möchten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Website-URL
|
siteUrl | True | string |
Vollständige URL der SharePoint-Website, die die Liste oder Bibliothek enthält (z. B |
|
Liste oder Bibliothek
|
listId | True | string |
GUID oder exakter Titel der SharePoint-Liste oder -Bibliothek. Die Dropdownliste gibt GUID-Werte zurück, aber manuelle Eingabe kann entweder eine GUID oder den exakten Listentitel verwenden. |
|
Artikel-ID
|
itemId | True | integer |
ID des SharePoint-Elements oder der Datei, das nach Änderungen analysiert werden soll (verfügbar von Triggerausgaben als ID). |
|
Vergleichen von
|
triggerWindowStartToken | string |
Definiert den Ausgangspunkt für den Änderungsvergleich. Akzeptiert das {TriggerWindowStartToken} des SharePoint-Triggers (empfohlen), eine Versionsbezeichnung wie "5.0", ein rohes SharePoint-Änderungstoken oder ein ISO 8601-Basisdatum/Datum-Uhrzeit wie "2026-03-30" oder "2026-03-30T14:15:00Z". Datumsgeschützte Werte werden in der ausgewählten Zeitzone als Mitternacht interpretiert, oder UTC, wenn die Zeitzone leer ist. Lassen Sie den Vergleich mit der unmittelbar vorherigen Version aus. |
|
|
Nebenversionen einschließen
|
includeMinorVersions | boolean |
Ob Neben- oder Entwurfsversionen am Vergleich teilnehmen sollen. Standardwert ist "false", was bedeutet, dass nur Hauptversionen verwendet werden. |
|
|
Unveränderte Felder einschließen
|
includeUnchangedFields | boolean |
Gibt an, ob unveränderte Felder in die Antwort einbezogen werden sollen. Die Standardeinstellung ist „true“. |
|
|
Datumsformat
|
dateFormat | string |
Benutzerdefiniertes Datumsformat für DateTime-Felder (z. B. 'JJJJ-MM-TT', 'TT/MM/JJJJ', 'MM/TT/JJJJ'). Wenn nicht angegeben, wird standardmäßig "yyyy-MM-dd" festgelegt. |
|
|
Zeitformat
|
timeFormat | string |
An Datum angefügtes Zeitformat für DateTime-Felder mit Uhrzeit (z. B. 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). Wenn nicht angegeben, wird standardmäßig "HH:mm:ss" festgelegt. |
|
|
Timezone
|
timezone | string |
IANA-Zeitzonen-ID für die Datums-/Uhrzeitkonvertierung (z. B. "America/New_York", "Europe/London", "Australia/Sydney"). Wenn nicht angegeben, wird standardmäßig UTC verwendet. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Success
|
success | boolean |
Gibt an, ob der Vorgang erfolgreich abgeschlossen wurde. |
|
Meldung
|
message | string |
Lesbare Nachricht, die das Ergebnis beschreibt |
|
Geänderte Felder
|
changedFields | array of object |
Nachverfolgte Felder als Array. |
|
Spaltenwert wurde geändert
|
changedFields.hasChanged | boolean |
True, wenn der Wert dieses Felds zwischen der vorherigen und der aktuellen Version geändert wurde |
|
Vorheriger Spaltenwert (Text)
|
changedFields.previousAsString | string |
Formatierter vorheriger Wert als lesbare Zeichenfolge |
|
Interner Feldname
|
changedFields.internalName | string |
Interner SharePoint-Feldname |
|
Feldname
|
changedFields.displayName | string |
Anzeigename für das Feld |
|
Vorheriger Spaltenwert (detailliert)
|
changedFields.previous |
Unformatierter vorheriger Wert. Diese Eigenschaft ist dynamisch und kann je nach SharePoint-Feldtyp eine Zeichenfolge, eine Zahl, ein boolesches Objekt, ein Objekt, ein Array oder null sein. |
|
|
Aktueller Spaltenwert (Text)
|
changedFields.currentAsString | string |
Formatierter aktueller Wert als lesbare Zeichenfolge |
|
Aktueller Spaltenwert (detailliert)
|
changedFields.current |
Aktueller Rohwert. Diese Eigenschaft ist dynamisch und kann je nach SharePoint-Feldtyp eine Zeichenfolge, eine Zahl, ein boolesches Objekt, ein Objekt, ein Array oder null sein. |
|
|
Vergleichsbasislinie
|
hasComparisonBaseline | boolean |
True, wenn eine unterschiedliche Basisplanversion für den Vergleich mit der aktuellen Version aufgelöst wurde. |
|
Ist Baseline First Version
|
isBaselineFirstVersion | boolean |
True, wenn die aufgelöste Basisplanversion die erste Version ist, die für das Element oder die Datei jemals aufgezeichnet wurde. |
|
Aktuelle Versionsbezeichnung
|
currentVersionLabel | string |
Versionsbezeichnung der aktuellen Version (z. B. '2.0', '5.0') |
|
Bezeichnung der vorherigen Version
|
previousVersionLabel | string |
Für den Vergleich verwendete Versionsbezeichnung (z. B. '1.0', '4.0') |
|
Elementtitel
|
itemTitle | string |
Titel des geänderten Elements |
|
Element-URL
|
itemUrl | string |
Direkter Link zum geänderten SharePoint-Element |
|
Geändert am
|
modifiedDate | date-time |
Zeitstempel der neuesten Änderung |
|
Geändert von
|
modifiedBy | string |
Anzeigename des Benutzers, der das Element zuletzt geändert hat |
|
Fehler
|
error | string |
Fehlerdetails, wenn der Erfolg falsch ist |
Analysevergleich von
Decodiert ein TriggerWindowStartToken oder ein unformatiertes SharePoint-Änderungstoken und gibt den eingebetteten Zeitstempel für Flussbedingungen und Basisentscheidungen zurück. Diese Aktion ruft SharePoint nicht auf.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vergleichen von
|
compareFrom | True | string |
TriggerWindowStartToken oder unformatiertes SharePoint-Änderungstoken zum Decodieren. Versionsbezeichnungen und ISO-Datums-/Datum-Uhrzeitwerte werden von dieser Aktion nicht unterstützt. |
|
Timezone
|
timezone | string |
Optionale IANA-Zeitzonen-ID für einen lokalen Vergleichswert (z. B. "America/New_York", "Europe/London", "Australia/Sydney"). Wenn dieser Wert nicht angegeben wird, wird nur der UTC-Wert zurückgegeben. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Meldung
|
message | string | |
|
Utc-Uhrzeit des Tokendatums
|
tokenDateTimeUTC | date-time |
Tokenzeitstempel in UTC. |
|
Tokendatums-Uhrzeit lokal
|
tokenDateTimeLocal | date-time |
Tokenzeitstempel, der in die angeforderte Zeitzone konvertiert wurde. |
|
Decodiertes Token
|
decodedToken | string |
Decodierter unformatierter Tokentext. Bei unformatierten Tokeneingaben entspricht dies dem ursprünglichen Wert. |
|
Ist Base64-Token
|
isBase64Token | boolean |
True, wenn das eingehende Token base64-codiert wurde. |
|
Sequence
|
sequence | integer |
SharePoint-Änderungssequenzwert, der in das Token eingebettet ist. |
|
Listen-GUID
|
listGuid | uuid |
In das Token eingebettete Listen- oder Bibliotheks-GUID. |
|
Tokenversion
|
tokenVersion | integer |
Tokenversionsnummer. |
|
Tokentyp
|
tokenType | integer |
SharePoint-Tokentypnummer. |
|
Fehler
|
error | string |
Fehlerdetails, wenn die Analyse fehlschlägt. |