Warnungsrelay (Vorschau)

Alert Relay hilft, SharePoint-Benachrichtigungen durch umfangreichere, moderne Benachrichtigungen zu ersetzen. Es gibt detaillierte Änderungen auf Feldebene sowie einsatzbereite Warnungs-HTML zurück, sodass Sie genau anzeigen können, was sich geändert hat, anstatt generische geänderte Benachrichtigungen. Sie können auch Änderungs- und Versionsinformationen in Flussentscheidungen und Bedingungen verwenden.

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
E-Mail	support@alertbridge.com.au

Connectormetadaten
Herausgeber	independNET Software
Website	https://independnet.com.au/alert-relay/
Datenschutzrichtlinie	https://independnet.com.au/alert-relay/privacy
Kategorien	Zusammenarbeit; Produktivität

Warnungsrelay

Warnungsrelay für Power Platform und Microsoft 365 Copilot

Alert Relay hilft Organisationen dabei, klassische SharePoint Warnungen durch moderne Power Automate und Copilot Studio Lösungen zu ersetzen. Es vergleicht SharePoint Elemente, Dateien und Seiten mit früheren Versionen und gibt strukturierte Änderungsinformationen, Versionsverlauf und einsatzbereiten Benachrichtigungsinhalt zurück, ohne dass Hersteller komplexe SharePoint Versionsvergleichslogik erstellen müssen.

Übersicht

SharePoint Trigger können erkennen, dass ein Element, eine Datei oder eine Seite geändert wurde, aber sie bieten keinen vollständigen Vergleich der vorherigen und aktuellen Werte.

Das Erstellen dieses Vergleichs erfordert häufig, dass Entwickler Versionen abrufen, Änderungstoken interpretieren, Felder vergleichen und Ergebnisse für Benachrichtigungen oder nachgelagerte Verarbeitung formatieren.

Warnungsrelay zentralisiert, die wiederverwendbare Aktionen für Power Automate und Copilot Studio verwenden.

Wichtige Features

Warnungsrelay zentralisiert, die durch wiederverwendbare Aktionen funktionieren, die:

Identifizieren detaillierter Änderungen auf Feldebene
Zurückzugeben von vorherigen und aktuellen Feldwerten
Generieren von sofort einsatzbereiten HTML-Code für SharePoint Warnungs-E-Mails
Abrufen des Element-, Datei- und Seitenversionsverlaufs
Vergleichen von einem Triggertoken, Änderungstoken, Versionsbezeichnung oder Datum
Format unterstützt komplexe SharePoint Feldtypen
Strukturierte Informationen für Power Automate und Microsoft 365 Copilot zurückgeben

Warnungsrelay unterstützt SharePoint Listen, Dokumentbibliotheken und Websiteseitenbibliotheken.

Getting Started

Ein typischer SharePoint Warnungsfluss umfasst:

Ein SharePoint Trigger, z. B. beim Erstellen oder Ändern eines Elements.
Eine Warnungsrelayaktion, z. B. Element- oder Dateiänderungen als Warnungs-HTML abrufen.
Eine E-Mail- oder eine andere Benachrichtigungsaktion, die den zurückgegebenen Betreff und den HTML-Textkörper verwendet.

Verwenden Sie für Bedingungen, benutzerdefinierte Formatierungen oder Microsoft Copilot Studio Agent-Szenarien das Abrufen detaillierter Elemente oder Dateiänderungen, und arbeiten Sie mit den zurückgegebenen strukturierten Änderungsinformationen.

Verwenden Sie für historische SharePoint Versionen den Versionsverlauf "Element abrufen" oder "Dateiversionsverlauf".

Documentation

Dokumentation, Aktionsreferenzinformationen, Beispiele und Erste-Schritte-Anleitungen finden Sie unter:

Dokumentation zum Warnungsrelay

Video-Lernprogramme

Schrittweise exemplarische Vorgehensweisen, Beispiele und Anleitungen finden Sie im YouTube-Kanal "Alert Relay":

Alert Relay auf YouTube

Lizenzierung und Testversion

Die Warnungsrelaylizenzierung ist mandantenweit. Eine einzelne Testversion oder ein einzelnes Abonnement gilt für den Microsoft Entra Mandanten, und seine Nutzungseinheiten werden von Warnungsrelay-Flüssen und -Benutzern in diesem Mandanten gemeinsam genutzt.

Die 90-Tage-Testversion wird automatisch gestartet, wenn jede Warnungsrelay-Aktion zuerst im Mandanten ausgeführt wird und 300 Nutzungseinheiten umfasst, die für die gesamte Testversion freigegeben wurden. Aktuelle Pläne und weitere Details finden Sie unter Warnungsrelay-Preise und -Lizenzierung.

Actions

Abrufen detaillierter Element- oder Dateiänderungen

Gibt detaillierte Änderungen auf Feldebene zwischen der aktuellen Version eines SharePoint Elements, einer Datei oder Seite und einer früheren Version zurück.

Die Aktion gibt strukturierte Informationen einschließlich vorheriger und aktueller Werte, formatierter Werte und Vergleichsmetadaten zurück. Verwenden Sie ihn, wenn ein Ablauf oder Microsoft Copilot Studio Agent einzelne Änderungen prüfen, zusammenfassen oder reagieren muss.

Abrufen von Element- oder Dateiänderungen als Warnungs-HTML

Generiert sofort einsatzbereiten HTML-Code, der anzeigt, was in einem SharePoint Element, einer Datei oder Seite geändert wurde.

Die Aktion gibt auch einen vorgeschlagenen E-Mail-Betreff, Elementtitel und Elementlink zurück. Verwenden Sie sie, um umfangreichere SharePoint Warnungs-E-Mails zu erstellen, ohne komplexe HTML- und Versionsvergleichsausdrücke in jedem Fluss zu erstellen.

Element- oder Dateiversionsverlauf abrufen

Gibt den gebundenen, seitenfähigen Versionsverlauf für ein SharePoint Element, eine Datei oder eine Seite zurück.

Die Aktion kann ausgewählte SharePoint Felder zurückgeben und Versions-, Datums- und SharePoint Triggertokengrenzen unterstützen. Verwenden Sie sie für Verlaufsüberprüfungs-, Überwachungs-, Berichterstellungs-, Genehmigungs- und Versionsbezogene Workflowszenarien.

Analysieren SharePoint Versionsinformationen

Decodiert SharePoint Triggerfenster- und Änderungstokeninformationen.

Verwenden Sie diese Aktion, um den Tokenzeitstempel abzurufen, Datums- oder versionsbasierte Entscheidungen anzuwenden und unerwünschte Neben- oder Entwurfsversionsauslöser zu filtern, bevor Sie eine detaillierte Änderungsaktion aufrufen.

Typische Verwendungen

Warnungsrelay kann Ihnen helfen:

Ersetzen von klassischen SharePoint Warnungen durch Power Automate Flüsse
Formatierte Benachrichtigungen senden, die genau zeigen, was geändert wurde
Vergleich der vorherigen und aktuellen Werte für wichtige Geschäftsfelder
Nachverfolgen von Änderungen an Dokumentmetadaten und SharePoint Seiten
Abrufen SharePoint Element- und Dateiversionsverlaufs
Erstellen von Genehmigungs-, Überprüfungs-, Governance- und Überwachungsworkflows
Bereitstellen von strukturierten SharePoint Änderungsinformationen für Microsoft 365 Copilot

Authentifizierung und Zugriff

Warnungsrelay verwendet Microsoft Entra ID delegierte Authentifizierung.

SharePoint Zugriff im Kontext des angemeldeten Benutzers ausgeführt wird. Das Warnungsrelay gewährt Benutzern keine zusätzlichen SharePoint Berechtigungen, sodass Benutzer bereits Zugriff auf die relevante SharePoint Website, Liste, Bibliothek, Element oder Datei haben müssen.

Anforderungen und unterstützter Bereich

Alert Relay unterstützt SharePoint Online. SharePoint Server lokal wird nicht unterstützt.
Aktionen werden ausgeführt, wenn sie von Power Automate oder einem anderen unterstützten Client aufgerufen werden. Verwenden Sie für Änderungsbenachrichtigungen einen geeigneten SharePoint Trigger, um den Fluss zu starten.
Vergleiche mit SharePoint Triggertoken basieren auf dem SharePoint Triggerfenster. Der resultierende Basisplan kann sich von einer elementspezifischen Versionsgrenze unterscheiden.
Detaillierte Formatierungen stehen für unterstützte SharePoint Feldtypen zur Verfügung. Weitere Informationen finden Sie in der Warnungsrelay-Dokumentation für den aktuellen Feldtypverweis.

Support

Website: https://independnet.com.au/alert-relay/

Unterstützung: https://independnet.com.au/alert-relay/support

E-Mail: support@alertrelay.com.au

Datenschutz: https://independnet.com.au/alert-relay/privacy

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 Element- oder Dateiänderungen	Ruft detaillierte, formatierte Änderungen auf Feldebene für ein SharePoint-Liste Element oder eine Datei ab, wobei die aktuelle Version mit einer früheren Version verglichen wird. Verwenden Sie diese Einstellung, wenn Sie umfangreiche Änderungsdaten benötigen, nicht nur die integrierten SharePoint Wahr-/Falsch-Änderungsindikatoren. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.
Abrufen von Element- oder Dateiänderungen als Warnungs-HTML	Gibt bereit zu verwendende Warnungsrelay-HTML für SharePoint Elementänderungen zurück, die hauptsächlich für Warnungs-E-Mails entwickelt wurden, aber auch überall verwendet werden können, wo HTML unterstützt wird. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.
Analysieren SharePoint Versionsinformationen	Decodiert eine SharePoint Vergleichen von Token. Wenn auch Versionsnummer und Änderungsdatum angegeben werden, bestimmt sie, ob das Element oder die Datei eine neue Version ist. Verwenden Sie diese nicht abrechnende Aktion in Flussbedingungen, bevor Sie aktionen des Warnungsrelays aufrufen.
Element- oder Dateiversionsverlauf abrufen	Gibt bis zur angeforderten Anzahl von Versionen für ein SharePoint-Liste Element oder eine Datei zurück, das am neuesten ist. Jede Version enthält Versionsdetails, Spaltenwerte, formatierte Textwerte und Indikatoren, die zeigen, welche Spalten von der vorherigen verfügbaren Version geändert wurden. Wählen Sie die Website und Die Liste oder Bibliothek aus, während Sie diese Aktion konfigurieren, um ihre Spalten als dynamischen Inhalt verfügbar zu machen. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.

Abrufen detaillierter Element- oder Dateiänderungen

Vorgangs-ID:: AlertBridgeGetDetailedChanges

Ruft detaillierte, formatierte Änderungen auf Feldebene für ein SharePoint-Liste Element oder eine Datei ab, wobei die aktuelle Version mit einer früheren Version verglichen wird. Verwenden Sie diese Einstellung, wenn Sie umfangreiche Änderungsdaten benötigen, nicht nur die integrierten SharePoint Wahr-/Falsch-Änderungsindikatoren. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Website-URL	siteUrl	True	string	Wählen Sie eine SharePoint Website aus, oder geben Sie die Website-URL ein.
Liste oder Bibliothek	listId	True	string	Wählen Sie eine Liste oder Bibliothek aus, oder geben Sie den Titel oder die GUID ein.
Artikel-ID	itemId	True	integer	ID des SharePoint-Elements oder der Datei, das für Änderungen analysiert werden soll.
Vergleichen von	triggerWindowStartToken		string	Ausgangspunkt für den Vergleich. Verwenden Sie das TriggerWindowStartToken des SharePoint, wenn verfügbar. Sie können auch eine Versionsbezeichnung, ein Unformatiertes Änderungstoken oder ein geplantes Datum/eine geplante Uhrzeit eingeben. Datums-only-Werte verwenden Mitternacht in der ausgewählten Zeitzone oder UTC, wenn keine Zeitzone ausgewählt ist. Lassen Sie nichts, um mit der vorherigen Version zu vergleichen.
Nebenversionen einschließen	includeMinorVersions		boolean	Gibt an, ob Beim Vergleichen von Änderungen Neben- oder Entwurfsversionen eingeschlossen werden sollen. Standardwert ist "false", sodass nur Hauptversionen verglichen 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	Format, das für DateTime-Felder verwendet wird (z. B. 'JJJJ-MM-TT', 'TT/MM/JJJJ', 'MM/TT/JJJJ'). Der Standardwert ist "yyyy-MM-dd".
Zeitformat	timeFormat		string	Format, das für den Zeitteil von DateTime-Feldern verwendet wird (z. B. HH:mm:ss, HH:mm, hh:mm tt). Standardwert ist HH:mm:ss.
Timezone	timezone		string	Zeitzone, die beim Formatieren von Datums- und Uhrzeitangaben verwendet wird (z. B. Amerika/New_York, Europa/London, Australien/Sydney). Der Standardwert ist UTC.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Success	success	boolean	True, wenn die Aktion erfolgreich abgeschlossen wurde; false, wenn die Überprüfung oder Verarbeitung fehlgeschlagen ist.
Meldung	message	string	Benutzergerichtete Nachricht, die das Ergebnis des Vorgangs beschreibt. Agents und Copiloten sollten diese Meldung dem Benutzer anzeigen, wenn es Test-, Abonnement-, Nutzungs-, Warnungs- oder Versionsverarbeitungsinformationen enthält.
Benutzerhinweis anzeigen	shouldDisplayUserNotice	boolean	Gibt an, ob das Warnungsrelay eine wichtige Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer zurückgegeben hat.
Benutzerhinweiscode	userNoticeCode	string	Stabile maschinenlesbare Ursache für den Benutzerhinweis.
Schweregrad des Benutzers	userNoticeSeverity	string	Präsentationsschweregrad für den Benutzerhinweis: Informationen, Warnungen oder kritisch.
Benutzerhinweis	userNotice	string	Wichtige Informationen zur Testversion, zum Abonnement oder zur Nutzung des Warnungsrelays.
Handlungsaufruf des Benutzers	userNoticeCallToAction	string	Was der Benutzer als Nächstes tun kann, einschließlich der Alert Relay-Website und Support-E-Mail.
Geänderte Felder	changedFields	array of object	Liste mit verglichenen SharePoint Feldern, einschließlich name jedes Felds, vorheriger Wert, aktueller Wert und ob es geändert wurde.
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.
Ist ein neues Element	isNewItem	boolean	True, wenn das Element oder die Datei als neu für das aufgelöste Vergleichsfenster behandelt werden soll, anstatt als Aktualisierung.
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')
Element- oder Dateiname	itemTitle	string	Titel oder Dateiname des geänderten Elements oder der Geänderten Datei.
Element- oder Datei-URL	itemUrl	string	Direkter Link zum geänderten SharePoint Element oder Datei.
Geändert am	modifiedDate	date-time	Datum und Uhrzeit der letzten Ä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

Abrufen von Element- oder Dateiänderungen als Warnungs-HTML

Vorgangs-ID:: AlertBridgeGetDetailedChangesAsAlertHtml

Gibt bereit zu verwendende Warnungsrelay-HTML für SharePoint Elementänderungen zurück, die hauptsächlich für Warnungs-E-Mails entwickelt wurden, aber auch überall verwendet werden können, wo HTML unterstützt wird. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Website-URL	siteUrl	True	string	Wählen Sie eine SharePoint Website aus, oder geben Sie die Website-URL ein.
Liste oder Bibliothek	listId	True	string	Wählen Sie eine Liste oder Bibliothek aus, oder geben Sie den Titel oder die GUID ein.
Artikel-ID	itemId	True	integer	ID des SharePoint-Elements oder der Datei, das für Änderungen analysiert werden soll.
Vergleichen von	triggerWindowStartToken		string	Ausgangspunkt für den Vergleich. Verwenden Sie das TriggerWindowStartToken des SharePoint, wenn verfügbar. Sie können auch eine Versionsbezeichnung, ein Unformatiertes Änderungstoken oder ein geplantes Datum/eine geplante Uhrzeit eingeben. Datums-only-Werte verwenden Mitternacht in der ausgewählten Zeitzone oder UTC, wenn keine Zeitzone ausgewählt ist. Lassen Sie nichts, um mit der vorherigen Version zu vergleichen.
Nebenversionen einschließen	includeMinorVersions		boolean	Gibt an, ob Beim Vergleichen von Änderungen Neben- oder Entwurfsversionen eingeschlossen werden sollen. Standardwert ist "false", sodass nur Hauptversionen verglichen 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	Format, das für DateTime-Felder verwendet wird (z. B. "jjjj-MM-TT", "tt/MM/jjjj"). Der Standardwert ist "yyyy-MM-dd".
Zeitformat	timeFormat		string	Format, das für den Zeitteil von DateTime-Feldern verwendet wird (z. B. HH:mm:ss, HH:mm, hh:mm tt). Standardwert ist HH:mm:ss.
Timezone	timezone		string	Zeitzone, die beim Formatieren von Datums- und Uhrzeitangaben verwendet wird (z. B. Amerika/New_York, Europa/London, Australien/Sydney). Der Standardwert ist UTC.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Success	success	boolean	True, wenn die Aktion erfolgreich abgeschlossen wurde; false, wenn die Überprüfung oder Verarbeitung fehlgeschlagen ist.
Meldung	message	string	Benutzergerichtete Nachricht, die das Ergebnis des Vorgangs beschreibt. Agents und Copiloten sollten diese Meldung dem Benutzer anzeigen, wenn es Test-, Abonnement-, Nutzungs-, Warnungs- oder Versionsverarbeitungsinformationen enthält.
Benutzerhinweis anzeigen	shouldDisplayUserNotice	boolean	Gibt an, ob das Warnungsrelay eine wichtige Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer zurückgegeben hat.
Benutzerhinweiscode	userNoticeCode	string	Stabile maschinenlesbare Ursache für den Benutzerhinweis.
Schweregrad des Benutzers	userNoticeSeverity	string	Präsentationsschweregrad für den Benutzerhinweis: Informationen, Warnungen oder kritisch.
Benutzerhinweis	userNotice	string	Wichtige Informationen zur Testversion, zum Abonnement oder zur Nutzung des Warnungsrelays.
Handlungsaufruf des Benutzers	userNoticeCallToAction	string	Was der Benutzer als Nächstes tun kann, einschließlich der Alert Relay-Website und Support-E-Mail.
HTML-Textkörper	htmlBody	string	HTML-Textkörper für die Warnmeldung, bereit für die Verwendung in E-Mails oder an beliebiger Stelle wird HTML unterstützt.
Generierter Benachrichtigungsbetreff	subject	string	Vorgeschlagene Betreffzeile für die Warnung
Element- oder Dateiname	itemTitle	string	Titel oder Dateiname des geänderten Elements oder der Geänderten Datei.
Element- oder Datei-URL	itemUrl	string	Direkter Link zum geänderten SharePoint Element oder Datei.
Ist ein neues Element	isNewItem	boolean	Bestimmt, ob die generierte Warnung das Element oder die Datei als hinzugefügt oder geändert beschreibt.
Fehler	error	string	Fehlerdetails, wenn der Erfolg falsch ist

Analysieren SharePoint Versionsinformationen

Vorgangs-ID:: AlertBridgeParseCompareFrom

Decodiert eine SharePoint Vergleichen von Token. Wenn auch Versionsnummer und Änderungsdatum angegeben werden, bestimmt sie, ob das Element oder die Datei eine neue Version ist. Verwenden Sie diese nicht abrechnende Aktion in Flussbedingungen, bevor Sie aktionen des Warnungsrelays aufrufen.

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.
Versionsnummer	versionNumber		string	Versionsnummer aus dem SharePoint Trigger oder Aktion, z. B. 0.1, 1.0 oder 1.5. Wird verwendet, um Neben-/Entwurfsversionen zu identifizieren.
Geändert am	modifiedDate		date-time	Änderungsdatum des SharePoint Triggers oder der Aktion. Wird verwendet, um zu erkennen, ob die sichtbare SharePoint Version während des Triggerfensters geändert wurde.
Nebenversionen einschließen	includeMinorVersions		boolean	Gibt an, ob Neben-/Entwurfsversionsnummern als neue Versionen gezählt werden sollen. Der Standardwert ist „false“.
Timezone	timezone		string	Optionale Zeitzone für lokale Vergleichswerte, z. B. "America/New_York", "Europe/London" oder "Australia/Sydney" (IANA timezone ID). Wenn dieser Wert nicht angegeben wird, wird nur der UTC-Wert zurückgegeben.

Gibt zurück

Name	Pfad	Typ	Beschreibung
Success	success	boolean	True, wenn die Versionsinformationen erfolgreich analysiert wurden; false, wenn die Überprüfung oder Verarbeitung fehlgeschlagen ist.
Meldung	message	string	Benutzergerichtete Nachricht, die das Ergebnis des Vorgangs beschreibt. Agents und Copiloten sollten diese Meldung dem Benutzer anzeigen, wenn es Test-, Abonnement-, Nutzungs-, Warnungs- oder Versionsverarbeitungsinformationen enthält.
Utc-Uhrzeit des Tokendatums	tokenDateTimeUTC	date-time	Datum und Uhrzeit aus dem Token "Vergleichen von" (In UTC zurückgegeben).
Tokendatums-Uhrzeit lokal	tokenDateTimeLocal	date-time	Datum und Uhrzeit aus dem Token "Vergleichen von" in die ausgewählte Zeitzone konvertiert.
Decodiertes Token	decodedToken	string	Unformatierte SharePoint Änderungstoken nach der Decodierung. Wenn Compare From bereits ein unformatiertes Token war, entspricht dies dem angegebenen 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.
Ist neue Version erkannt	isNewVersionDetected	boolean	True, wenn die bereitgestellten Trigger-/Aktionsmetadaten eine neue sichtbare SharePoint Version verarbeitet werden sollen. False, wenn die Version übersprungen werden soll. Null, wenn nicht genügend Metadaten vorhanden sind, um zu bestimmen.
Ist Nebenversion	isMinorVersion	boolean	True, wenn die angegebene Versionsnummer eine Neben-/Entwurfsversion ist. Null, wenn die Versionsnummer nicht angegeben wurde.
Ist die erste Nebenversion	isFirstMinorVersion	boolean	True, wenn die angegebene Versionsnummer die erste Neben-/Entwurfsversion ist, in der Regel 0.1. Null, wenn die Versionsnummer nicht angegeben wurde.
Ist die erste Hauptversion	isFirstMajorVersion	boolean	True, wenn die angegebene Versionsnummer die erste Haupt-/Veröffentlichungsversion ist, in der Regel 1.0. Null, wenn die Versionsnummer nicht angegeben wurde.
Änderungsdatum UTC	modifiedDateUtc	date-time	Angegebenes Änderungsdatum normalisiert in UTC. Null, als das Änderungsdatum nicht angegeben wurde.
Änderungsdatum lokal	modifiedDateLocal	date-time	Das angegebene Änderungsdatum wurde in die ausgewählte Zeitzone konvertiert. Null, wenn geändertes Datum oder Zeitzone nicht angegeben wurde.
Fehler	error	string	Fehlerdetails, wenn der Erfolg falsch ist.

Element- oder Dateiversionsverlauf abrufen

Vorgangs-ID:: GetItemOrFileVersionHistory

Gibt bis zur angeforderten Anzahl von Versionen für ein SharePoint-Liste Element oder eine Datei zurück, das am neuesten ist. Jede Version enthält Versionsdetails, Spaltenwerte, formatierte Textwerte und Indikatoren, die zeigen, welche Spalten von der vorherigen verfügbaren Version geändert wurden. Wählen Sie die Website und Die Liste oder Bibliothek aus, während Sie diese Aktion konfigurieren, um ihre Spalten als dynamischen Inhalt verfügbar zu machen. Die Ergebnisse können eine wichtige Warnungsrelay-Testversion, ein Abonnement oder einen Nutzungshinweis für den Benutzer enthalten.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Website-URL	siteUrl	True	string	Wählen Sie eine SharePoint Website aus, oder geben Sie die Website-URL ein.
Liste oder Bibliothek	listId	True	string	Wählen Sie die Liste oder Bibliothek aus, deren Versionsspalten als dynamischer Inhalt im Fluss verfügbar sein sollen.
Artikel-ID	itemId	True	integer	SharePoint-Liste Element-ID. Dies kann dynamisch zur Laufzeit bereitgestellt werden, z. B. aus einem SharePoint Trigger oder einer früheren Ablaufaktion.
Maximale Nutzungseinheiten	maximumUsageUnits	True	integer	Erforderliche Anrufer-ausgewählte Grenze für die Nutzungseinheiten, die dieser Anruf verwenden kann. Der Standardwert ist 1. Dies ist ein Abrechnungsschutz, kein Grenzwert für die Versionsanzahl; eine Verwendungseinheit kann mehrere vollständige Versionen zurückgeben. Verwenden Sie maximale Versionen, um die Anzahl der Versionszeilen einzuschränken.
Maximale Versionen	maximumVersions		integer	Maximale Gesamtanzahl der vollständigen Versionszeilen, die auf allen Seiten zurückgegeben werden sollen. Lassen Sie den Vorgang leer, bis der ausgewählte Bereich, der verfügbare Verlauf oder das Budget der Verwendungseinheit endet. Jede Antwort enthält maximal 100 Versionen.
Zurückzugebende Felder	fieldsToReturn		array of string	SharePoint Spalten, die in jede Version eingeschlossen werden sollen. Fügen Sie pro Element eine Spalte hinzu. Lassen Sie Felder leer, um jede unterstützte Spalte zurückzugeben. Wenn Sie weniger Spalten auswählen, kann die Antwortgröße und die Verwendungseinheit reduziert werden.
Vergleichen von	fromVersion		string	Ausgangspunkt für den Versionsverlaufsbereich. Verwenden Sie das TriggerWindowStartToken des SharePoint, wenn verfügbar. Sie können auch eine Versionsbezeichnung, ein Unformatiertes Änderungstoken oder ein geplantes Datum/eine geplante Uhrzeit eingeben. Datums-only-Werte verwenden Mitternacht in der ausgewählten Zeitzone oder UTC, wenn keine Zeitzone ausgewählt ist. Lassen Sie keine ältere Grenze leer.
Vergleichen mit	toVersion		string	Endpunkt für den Versionsverlaufsbereich. Verwenden Sie den TriggerWindowEndToken des SharePoint, wenn verfügbar. Sie können auch eine Versionsbezeichnung, ein Unformatiertes Änderungstoken oder Datum/Uhrzeit eingeben. Datums-only-Werte verwenden Mitternacht in der ausgewählten Zeitzone oder UTC, wenn keine Zeitzone ausgewählt ist. Lassen Sie keine neuere Grenze leer.
Pagingtoken	continuationToken		string	Token, das zum Abrufen der nächsten Seite des Versionsverlaufs verwendet wird, wenn ein Token von einem vorherigen Aufruf zurückgegeben wurde.
Nebenversionen einschließen	includeMinorVersions		boolean	Gibt an, ob Nebenversionen oder Entwurfsversionen beim Abrufen des Versionsverlaufs eingeschlossen werden sollen. Standardwert ist "false", sodass nur Hauptversionen zurückgegeben werden.
Datumsformat	dateFormat		string	Format, das für DateTime-Felder verwendet wird (z. B. 'JJJJ-MM-TT', 'TT/MM/JJJJ', 'MM/TT/JJJJ'). Der Standardwert ist "yyyy-MM-dd".
Zeitformat	timeFormat		string	Format, das für den Zeitteil von DateTime-Feldern verwendet wird (z. B. HH:mm:ss, HH:mm, hh:mm tt). Standardwert ist HH:mm:ss.
Timezone	timezone		string	Zeitzone, die beim Formatieren von Datums- und Uhrzeitangaben verwendet wird (z. B. Amerika/New_York, Europa/London, Australien/Sydney). Der Standardwert ist UTC.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.