Alert Relay (Preview)
Přenos výstrah pomáhá nahradit vyřazení výstrah SharePointu bohatšími moderními oznámeními. Vrátí podrobné změny na úrovni pole a html upozornění připravené k použití, abyste mohli zobrazit přesně to, co se změnilo místo obecných upravených oznámení.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Třída | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Azure Government oblastí – Azure oblasti Čína - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Name | Podpora independNET |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadata konektoru | |
|---|---|
| Vydavatel | independNET Products |
| Internetová stránka | https://independnet.com.au/alert-relay/ |
| Zásady ochrany osobních údajů | https://independnet.com.au/alert-relay/privacy |
| Kategorie | Spolupráce; Produktivita |
Přenos výstrah
Alert Relay for Power Platform a Microsoft 365 Copilot
Alert Relay pomáhá organizacím nahradit klasická upozornění SharePoint moderními Power Automate a Copilot Studio řešeními. Porovnává SharePoint položky, soubory a stránky s dřívějšími verzemi a vrací strukturované informace o změnách, historii verzí a obsah oznámení připravený k použití, aniž by tvůrci museli vytvářet komplexní logiku porovnání verzí SharePoint.
Přehled
SharePoint triggery můžou identifikovat, že se položka, soubor nebo stránka změnila, ale neposkytují úplné porovnání předchozích a aktuálních hodnot.
Sestavení, které porovnávání často vyžaduje, aby tvůrci načetli verze, interpretují tokeny změn, porovnávali pole a výsledky formátu pro oznámení nebo podřízené zpracování.
Alert Relay centralizuje, které pracují prostřednictvím opakovaně použitelných akcí pro Power Automate a Copilot Studio.
Klíčové funkce
Výstraha Relay centralizuje, které pracují prostřednictvím opakovaně použitelných akcí, které mohou:
- identifikace podrobných změn na úrovni pole
- vrácení předchozích a aktuálních hodnot polí
- Generování kódu HTML připraveného k použití pro e-maily s upozorněními SharePoint
- načtení historie verzí položek, souborů a stránek
- porovnání z tokenu triggeru, změny tokenu, popisku verze nebo data
- Formát podporovaný složitými typy polí SharePoint
- vrácení strukturovaných informací pro Power Automate a Microsoft 365 Copilot
Služba Alert Relay podporuje seznamy SharePoint, knihovny dokumentů a knihovny stránek webu.
Začínáme
Typický tok upozornění SharePoint zahrnuje:
- Aktivační událost SharePoint, například Při vytvoření nebo úpravě položky.
- Akce přenosu výstrah, například Získat položku nebo změny souboru jako HTML upozornění.
- E-mail nebo jiná akce oznámení, která používá vrácený předmět a text HTML.
Pro podmínky, vlastní formátování nebo Microsoft Copilot Studio scénáře agenta, použijte získat podrobné změny položky nebo souboru a pracovat s strukturovanými informacemi o změnách, které vrátí.
Pro historické verze SharePoint použijte historii verzí získat položku nebo soubor.
Documentation
K dispozici jsou dokumentace, referenční informace o akcích, příklady a úvodní pokyny:
Dokumentace ke službě Alert Relay
Výuková videa
Podrobné návody, příklady a videa s postupy jsou k dispozici v kanálu YouTube pro přenos výstrah:
Licencování a zkušební verze
Licencování služby Alert Relay je široké na úrovni tenanta. Jedna zkušební verze nebo předplatné se vztahuje na tenanta Microsoft Entra a její jednotky využití sdílí toky služby Alert Relay a uživatelé v daném tenantovi.
90denní zkušební verze se spustí automaticky, když se v tenantovi spustí jakákoli akce služby Alert Relay a zahrnuje 300 jednotek využití sdílených v rámci zkušební verze. Aktuální plány a další podrobnosti najdete v tématu o cenách a licencování služby Alert Relay.
Akce
Získání podrobných změn položek nebo souborů
Vrátí podrobné změny na úrovni pole mezi aktuální verzí položky SharePoint, souboru nebo stránky a starší verzí.
Akce vrátí strukturované informace, včetně předchozích a aktuálních hodnot, formátovaných hodnot a metadat porovnání. Použijte ho, když tok nebo Microsoft Copilot Studio agent potřebuje zkontrolovat, sumarizovat nebo reagovat na jednotlivé změny.
Získání změn položek nebo souborů ve formátu HTML upozornění
Vygeneruje kód HTML připravený k použití, který ukazuje, co se změnilo v SharePoint položce, souboru nebo stránce.
Akce také vrátí navrhovaný předmět e-mailu, název položky a odkaz na položku. Umožňuje vytvářet bohatší e-maily s upozorněními SharePoint bez vytváření složitých výrazů porovnání html a verzí v každém toku.
Získání historie verzí položky nebo souboru
Vrátí ohraničenou historii verzí s možností stránky pro položku SharePoint, soubor nebo stránku.
Akce může vrátit vybraná pole SharePoint a podporuje hranice tokenu triggeru, data a SharePoint. Můžete ho použít pro historické scénáře kontroly, auditu, generování sestav, schvalování a pracovních postupů pracujících s verzemi.
Analýza informací o verzi SharePoint
Dekóduje SharePoint informace o aktivačním okně a tokenu změn.
Pomocí této akce můžete načíst časové razítko tokenu, použít rozhodnutí na základě data nebo verze a filtrovat nežádoucí aktivační události podverze nebo konceptu před voláním podrobné akce změny.
Typické použití
Výstraha Relay vám může pomoct:
- nahrazení klasických upozornění SharePoint toky Power Automate
- odesílání formátovaných oznámení s přesně tím, co se změnilo
- porovnání předchozích a aktuálních hodnot pro důležitá obchodní pole
- sledování změn metadat dokumentů a stránek SharePoint
- Načtení SharePoint historie verzí položek a souborů
- vytváření schvalovacích, kontrolovaných, zásad správného řízení a auditování pracovních postupů
- poskytování strukturovaných SharePoint informací o změnách na Microsoft 365 Copilot
Ověřování a přístup
Alert Relay používá Microsoft Entra ID delegovaného ověřování.
SharePoint přístup se provádí v kontextu přihlášeného uživatele. Služba Alert Relay neuděluje uživatelům další oprávnění SharePoint, takže uživatelé už musí mít přístup k příslušnému webu SharePoint, seznamu, knihovně, položce nebo souboru.
Požadavky a podporovaný obor
- Služba Alert Relay podporuje SharePoint Online. SharePoint Server místní prostředí se nepodporuje.
- Akce se spouští při zavolání Power Automate nebo jiným podporovaným klientem. U oznámení o změnách použijte k zahájení toku příslušnou aktivační událost SharePoint.
- Porovnání pomocí tokenů aktivačních událostí SharePoint jsou založená na okně triggeru SharePoint. Výsledný směrný plán se může lišit od hranice verze specifické pro jednotlivé položky.
- Podrobné formátování je k dispozici pro podporované typy polí SharePoint. Aktuální odkaz na typ pole najdete v dokumentaci ke službě Alert Relay.
Support
Internetová stránka: https://independnet.com.au/alert-relay/
Podpora: https://independnet.com.au/alert-relay/support
E-mail: support@alertrelay.com.au
Zásady ochrany osobních údajů: https://independnet.com.au/alert-relay/privacy
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Default | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Parsovat porovnání z |
Dekóduje aktivační událost TriggerWindowStartToken nebo nezpracovaný token změny SharePointu a vrátí vložené časové razítko pro podmínky toku a rozhodnutí podle směrného plánu. Tato akce nevolá SharePoint. |
| Získání podrobného kódu HTML upozornění na položku |
Vrátí kód HTML pro přenos výstrah připravený k použití pro změny položek SharePointu, určený především pro e-maily upozornění ve stylu SharePointu, ale také použitelné v dokumentech nebo jiných cílech podporujících HTML. |
| Získání podrobných změn položek |
Načte podrobné a formátované změny na úrovni polí pro položku nebo dokument seznamu SharePointu a porovná aktuální verzi s předchozí verzí. Tuto možnost použijte, pokud chcete místo předdefinovaných příznaků polí ve stylu SharePointu použít bohatou změnu. |
Parsovat porovnání z
Dekóduje aktivační událost TriggerWindowStartToken nebo nezpracovaný token změny SharePointu a vrátí vložené časové razítko pro podmínky toku a rozhodnutí podle směrného plánu. Tato akce nevolá SharePoint.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Porovnat od
|
compareFrom | True | string |
TriggerWindowStartToken nebo nezpracovaný token změny SharePointu tak, aby dekódoval. Tato akce nepodporuje popisky verzí a hodnoty data a data a času ISO. |
|
Timezone
|
timezone | string |
Volitelné ID IANA časového pásma pro místní porovnávací hodnotu (například America/New_York, Europe/London, Australia/Sydney). Pokud tuto hodnotu vynecháte, vrátí se pouze hodnota UTC. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Datum a čas tokenu UTC
|
tokenDateTimeUTC | date-time |
Časové razítko tokenu ve standardu UTC |
|
Místní datum a čas tokenu
|
tokenDateTimeLocal | date-time |
Časové razítko tokenu bylo převedeno na požadované časové pásmo. |
|
Dekódovaný token
|
decodedToken | string |
Dekódovaný text nezpracovaného tokenu Pro nezpracovaný vstup tokenu odpovídá původní hodnotě. |
|
Je token Base64.
|
isBase64Token | boolean |
True, když byl příchozí token kódován base64. |
|
Sequence
|
sequence | integer |
Hodnota sekvence změn SharePointu vložená do tokenu |
|
Identifikátor GUID seznamu
|
listGuid | uuid |
Identifikátor GUID seznamu nebo knihovny vložený do tokenu |
|
Verze tokenu
|
tokenVersion | integer |
Číslo verze tokenu. |
|
Typ tokenu
|
tokenType | integer |
Číslo typu tokenu SharePointu |
|
Error
|
error | string |
Podrobnosti o chybě při analýze se nezdaří. |
Získání podrobného kódu HTML upozornění na položku
Vrátí kód HTML pro přenos výstrah připravený k použití pro změny položek SharePointu, určený především pro e-maily upozornění ve stylu SharePointu, ale také použitelné v dokumentech nebo jiných cílech podporujících HTML.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Adresa URL webu
|
siteUrl | True | string |
Úplná adresa URL sharepointového webu obsahujícího seznam nebo knihovnu |
|
Seznam nebo knihovna
|
listId | True | string |
GUID nebo přesný název sharepointového seznamu nebo knihovny Rozevírací seznam vrátí hodnoty GUID, ale ruční zadávání může použít buď identifikátor GUID, nebo přesný název seznamu. |
|
ID položky
|
itemId | True | integer |
ID položky nebo souboru SharePointu pro analýzu změn |
|
Porovnat od
|
triggerWindowStartToken | string |
Definuje výchozí bod pro porovnání změn. Přijímá aktivační událost SharePointu {TriggerWindowStartToken} (doporučeno), popisek verze, například 5.0, nezpracovaný token změny SharePointu nebo standardní datum a datum a čas podle standardu ISO 8601, například 2026-03-30 nebo 2026-03-30T14:15:00Z. Hodnoty jen pro datum se interpretují jako půlnoc ve vybraném časovém pásmu nebo UTC, pokud je časové pásmo prázdné. Vynecháme porovnání s bezprostředně předchozí verzí. |
|
|
Zahrnout podverze
|
includeMinorVersions | boolean |
Ať už se má porovnání účastnit podverze nebo konceptů. Výchozí hodnota je false, což znamená, že se používají pouze hlavní verze. |
|
|
Zahrnout nezměněná pole
|
includeUnchangedFields | boolean |
Zda mají být vygenerovaná pole zahrnuta do vygenerovaného kódu HTML beze změny. Výchozí hodnota je true. |
|
|
Formát data
|
dateFormat | string |
Vlastní formát data pro pole DateTime (například rrrr-MM-dd, dd/MM/rrrr). Výchozí hodnota je yyyy-MM-dd, pokud není zadána. |
|
|
Formát času
|
timeFormat | string |
Formát času připojený k datu pro pole DateTime s časem (například HH:mm:ss, HH:mm, hh:mm tt). |
|
|
Timezone
|
timezone | string |
ID IANA timezone pro převod data a času (například America/New_York, Europe/London, Australia/Sydney). |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Určuje, jestli se operace úspěšně dokončila. |
|
Message
|
message | string |
Zpráva čitelná pro člověka popisující výsledek |
|
Text HTML
|
htmlBody | string |
Kompletní text HTML připravený k použití v e-mailech s upozorněními nebo v jiných cílech podporujících HTML |
|
Navrhované předměty
|
subject | string |
Navrhovaný řádek předmětu pro upozornění |
|
Název položky
|
itemTitle | string |
Název změněné položky |
|
Adresa URL položky
|
itemUrl | string |
Přímý odkaz na změněnou položku SharePointu |
|
Je nová položka
|
isNewItem | boolean |
Hodnota True, pokud je výstraha určená pro novou položku nebo soubor SharePointu, a ne pro aktualizaci existující položky. |
|
Error
|
error | string |
Podrobnosti o chybě, pokud je úspěch nepravda |
Získání podrobných změn položek
Načte podrobné a formátované změny na úrovni polí pro položku nebo dokument seznamu SharePointu a porovná aktuální verzi s předchozí verzí. Tuto možnost použijte, pokud chcete místo předdefinovaných příznaků polí ve stylu SharePointu použít bohatou změnu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Adresa URL webu
|
siteUrl | True | string |
Úplná adresa URL sharepointového webu obsahujícího seznam nebo knihovnu (například |
|
Seznam nebo knihovna
|
listId | True | string |
GUID nebo přesný název sharepointového seznamu nebo knihovny Rozevírací seznam vrátí hodnoty GUID, ale ruční zadávání může použít buď identifikátor GUID, nebo přesný název seznamu. |
|
ID položky
|
itemId | True | integer |
ID položky nebo souboru SharePointu k analýze změn (dostupné z výstupu triggeru jako ID). |
|
Porovnat od
|
triggerWindowStartToken | string |
Definuje výchozí bod pro porovnání změn. Přijímá aktivační událost SharePointu {TriggerWindowStartToken} (doporučeno), popisek verze, například 5.0, nezpracovaný token změny SharePointu nebo standardní datum a datum a čas podle standardu ISO 8601, například 2026-03-30 nebo 2026-03-30T14:15:00Z. Hodnoty jen pro datum se interpretují jako půlnoc ve vybraném časovém pásmu nebo UTC, pokud je časové pásmo prázdné. Vynecháme porovnání s bezprostředně předchozí verzí. |
|
|
Zahrnout podverze
|
includeMinorVersions | boolean |
Ať už se má porovnání účastnit podverze nebo konceptů. Výchozí hodnota je false, což znamená, že se používají pouze hlavní verze. |
|
|
Zahrnout nezměněná pole
|
includeUnchangedFields | boolean |
Zda mají být v odpovědi zahrnuta nezměněná pole. Výchozí hodnota je true. |
|
|
Formát data
|
dateFormat | string |
Vlastní formát data pro pole DateTime (například rrrr-MM-dd, dd/MM/rrrr, MM/dd/rrrr). Výchozí hodnota je yyyy-MM-dd, pokud není zadána. |
|
|
Formát času
|
timeFormat | string |
Formát času připojený k datu pro pole DateTime s časem (například HH:mm:ss, HH:mm, hh:mm tt). Výchozí hodnota je HH:mm:ss, pokud není zadána. |
|
|
Timezone
|
timezone | string |
ID IANA timezone pro převod data a času (například America/New_York, Europe/London, Australia/Sydney). Výchozí hodnota je UTC, pokud není zadána. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Určuje, jestli se operace úspěšně dokončila. |
|
Message
|
message | string |
Zpráva čitelná pro člověka popisující výsledek |
|
Změněná pole
|
changedFields | array of object |
Sledované pole jako pole |
|
Hodnota sloupce se změnila.
|
changedFields.hasChanged | boolean |
Hodnota True, pokud se hodnota tohoto pole změnila mezi předchozí a aktuální verzí |
|
Hodnota předchozího sloupce (text)
|
changedFields.previousAsString | string |
Formátovaná předchozí hodnota jako řetězec čitelný člověkem |
|
Interní název pole
|
changedFields.internalName | string |
Název interního pole SharePointu |
|
Název pole
|
changedFields.displayName | string |
Popisný zobrazovaný název pole |
|
Hodnota předchozího sloupce (podrobný)
|
changedFields.previous |
Nezpracovaná předchozí hodnota Tato vlastnost je dynamická a může to být řetězec, číslo, logická hodnota, objekt, pole nebo hodnota null v závislosti na typu pole Služby SharePoint. |
|
|
Aktuální hodnota sloupce (text)
|
changedFields.currentAsString | string |
Naformátovaná aktuální hodnota jako řetězec čitelný člověkem |
|
Aktuální hodnota sloupce (podrobný)
|
changedFields.current |
Nezpracovaná aktuální hodnota Tato vlastnost je dynamická a může to být řetězec, číslo, logická hodnota, objekt, pole nebo hodnota null v závislosti na typu pole Služby SharePoint. |
|
|
Má srovnávací směrný plán.
|
hasComparisonBaseline | boolean |
Hodnota True, pokud byla vyřešena odlišná základní verze pro porovnání s aktuální verzí. |
|
Je první verze směrného plánu.
|
isBaselineFirstVersion | boolean |
Hodnota True, pokud je vyřešená základní verze první verzí, která byla zaznamenána pro položku nebo soubor. |
|
Popisek aktuální verze
|
currentVersionLabel | string |
Popisek verze aktuální verze (například 2.0, 5.0) |
|
Popisek předchozí verze
|
previousVersionLabel | string |
Popisek verze použitý pro porovnání (například 1.0, 4.0) |
|
Název položky
|
itemTitle | string |
Název změněné položky |
|
Adresa URL položky
|
itemUrl | string |
Přímý odkaz na změněnou položku SharePointu |
|
Datum změny
|
modifiedDate | date-time |
Časové razítko nejnovější změny |
|
Upraveno kým
|
modifiedBy | string |
Zobrazované jméno uživatele, který položku naposledy upravil |
|
Error
|
error | string |
Podrobnosti o chybě, pokud je úspěch nepravda |