Alert Relay (wersja zapoznawcza)
Usługa Alert Relay pomaga zastąpić wycofywanie alertów programu SharePoint bogatszymi, nowoczesnymi powiadomieniami. Zwraca szczegółowe zmiany na poziomie pola i gotowy do użycia kod HTML alertu, dzięki czemu można wyświetlić dokładnie to, co zmieniło się zamiast ogólnych zmodyfikowanych powiadomień.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: - Azure Government regionów - Azure regionach Chin - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Name | obsługa independNET |
| adres URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadane łącznika | |
|---|---|
| Publisher | independNET Products |
| Witryna internetowa | https://independnet.com.au/alert-relay/ |
| Zasady ochrony prywatności | https://independnet.com.au/alert-relay/privacy |
| Kategorie | Kolaboracja; Produktywność |
Przekaźnik alertów
Usługa Alert Relay pomaga zastąpić wycofywanie alertów programu SharePoint bogatszymi, nowoczesnymi powiadomieniami dla środowisk platformy Microsoft 365. Zawiera on szczegółowe informacje o zmianach elementów i dokumentów programu SharePoint, w tym sformatowane porównania na poziomie pola i gotowe do użycia dane wyjściowe alertu HTML.
Overview
Usługa Alert Relay jest przeznaczona dla twórców, którzy chcą bardziej przydatnych powiadomień programu SharePoint niż domyślne środowisko "element został zmodyfikowany".
Obsługuje:
- szczegółowa inspekcja zmian na poziomie pola
- gotowe do użycia dane wyjściowe HTML dla wiadomości e-mail z alertami
- analizowanie tokenu wyzwalacza dla decyzji dotyczących linii bazowej i pierwszego uruchomienia
- Listy SharePoint
- biblioteki dokumentów
- Strony witryny /biblioteki stron
Najważniejsze funkcje
1. Szczegółowe śledzenie zmian
Łącznik może porównać bieżącą wersję elementu lub dokumentu programu SharePoint ze starszą wersją i zwrócić szczegóły zmiany strukturalnej.
2. Gotowe do użycia dane wyjściowe alertu HTML
Łącznik może wygenerować sformatowany kod HTML, aby przepływy mogły wysyłać przydatne wiadomości e-mail z alertami bez ręcznego kompilowania złożonych wyrażeń HTML.
3. Analizowanie tokenu wyzwalacza
Akcja Parse Compare From dekoduje tokeny zmian programu SharePoint, takie jak TriggerWindowStartToken i zwraca osadzony znacznik czasu i szczegóły tokenu do podejmowania decyzji w przepływach.
4. Dynamiczne listy rozwijane
Łącznik zawiera dynamiczną obsługę listy rozwijanej dla:
- Strony
- listy i biblioteki
- formaty dat
- formaty czasu
- strefy czasowe
5. Elastyczny punkt odniesienia porównania
Łącznik obsługuje porównanie z następujących składników:
- Tokeny wyzwalacza programu SharePoint
- nieprzetworzone tokeny zmian programu SharePoint
- etykiety wersji
- Plany bazowe daty/daty/godziny ISO 8601
Obsługiwane akcje
Uzyskiwanie szczegółowych zmian
Zwraca ustrukturyzowany kod JSON opisujący zmienione pola, w tym poprzednie i bieżące sformatowane wartości.
Pobieranie szczegółowych zmian jako html alertu
Zwraca gotowe do użycia dane wyjściowe HTML i powiązane metadane alertów dla poczty e-mail lub innych miejsc docelowych obsługujących kod HTML.
Analizowanie porównania z
Dekoduje token wyzwalacza/zmiany programu SharePoint i zwraca osadzony znacznik czasu i szczegóły tokenu.
Typowe przypadki użycia
- Wysyłanie lepszych wiadomości e-mail z alertami programu SharePoint w przypadku zmiany elementu listy
- Pokaż poprzednie i bieżące wartości dla ważnych pól biznesowych
- Śledzenie zmian metadanych biblioteki dokumentów
- Przepływy zatwierdzania, zgodności lub inspekcji kompilacji
- Pomijanie hałaśliwych alertów pierwszego uruchomienia przez ocenę dat tokenu wyzwalacza względem wybranego punktu odniesienia
Authentication
Usługa Alert Relay używa uwierzytelniania identyfikatora Entra firmy Microsoft wraz z kluczem subskrypcji interfejsu API.
Aby korzystać z łącznika, użytkownik musi:
- dostęp do odpowiedniej witryny programu SharePoint, listy lub biblioteki
- prawidłowe połączenie usługi Alert Relay
- prawidłowy klucz subskrypcji interfejsu API usługi Alert Relay
Gdy dzierżawa najpierw używa usługi Alert Relay, jest automatycznie umieszczana w trybie próbnym. Aby wyjść z trybu próbnego, skontaktuj się z .support@alertbridge.com.au
Wprowadzenie
Typowy przepływ weryfikacji używa:
- Wyzwalacz programu SharePoint, taki jak
When an item is created or modified - Akcja przekaźnika alertów, taka jak
Get Detailed Changes as Alert HTML - Wiadomość e-mail lub krok Redaguj, aby użyć zwróconego tematu i danych wyjściowych HTML
W przypadku przetwarzania podrzędnego ze strukturą należy użyć Get Detailed Changes metody i iterować w zwracanej changedFields tablicy.
Znane problemy i ograniczenia
- Usługa SharePoint Online jest obsługiwana; Lokalny program SharePoint Server nie jest obsługiwany.
- Chronometraż wyzwalacza programu SharePoint może mieć wpływ na porównania pierwszego uruchomienia, ponieważ tokeny wyzwalacza odzwierciedlają okno wyzwalacza programu SharePoint, a nie historię alertów dla poszczególnych elementów.
Support
Stronie internetowej:
Zasady ochrony prywatności:
Wsparcie:
Adres e-mail pomocy technicznej:
- support@alertbridge.com.au
Dodatkowe uwagi
Usługa Alert Relay ma na celu poprawę użyteczności scenariuszy powiadomień opartych na programie SharePoint przez zmniejszenie ilości pracy wyrażeń niestandardowych wymaganych w przepływach, szczególnie w przypadku formatowania wiadomości e-mail HTML i inspekcji zmian na poziomie pola.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Analizowanie porównania z |
Dekoduje token zmiany TriggerWindowStartToken lub nieprzetworzony token zmiany programu SharePoint i zwraca osadzony znacznik czasu dla warunków przepływu i decyzji dotyczących linii bazowej. Ta akcja nie wywołuje programu SharePoint. |
| Pobieranie szczegółowych zmian elementów |
Pobiera szczegółowe, sformatowane zmiany na poziomie pola dla elementu lub dokumentu listy programu SharePoint, porównując bieżącą wersję z poprzednią wersją. Użyj tej funkcji, gdy chcesz, aby zaawansowane dane zmieniały się, a nie wbudowane flagi pól true/false w stylu programu SharePoint. |
| Uzyskiwanie szczegółowego alertu o elemencie HTML |
Zwraca gotowy do użycia kod HTML przekaźnika alertów dla zmian elementów programu SharePoint zaprojektowany głównie dla wiadomości e-mail alertów w stylu programu SharePoint, ale także do użycia w dokumentach lub w innych miejscach docelowych obsługujących kod HTML. |
Analizowanie porównania z
Dekoduje token zmiany TriggerWindowStartToken lub nieprzetworzony token zmiany programu SharePoint i zwraca osadzony znacznik czasu dla warunków przepływu i decyzji dotyczących linii bazowej. Ta akcja nie wywołuje programu SharePoint.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Porównanie z
|
compareFrom | True | string |
TriggerWindowStartToken lub nieprzetworzony token zmiany programu SharePoint w celu dekodowania. Etykiety wersji i wartości daty/godziny ISO nie są obsługiwane przez tę akcję. |
|
Timezone
|
timezone | string |
Opcjonalny identyfikator strefy czasowej IANA dla lokalnej wartości porównania (na przykład "Ameryka/New_York", "Europa/Londyn", "Australia/Sydney". W przypadku pominięcia zwracana jest tylko wartość UTC. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean | |
|
Message
|
message | string | |
|
Data tokenu o godzinie UTC
|
tokenDateTimeUTC | date-time |
Znacznik czasu tokenu w formacie UTC. |
|
Lokalna data tokenu
|
tokenDateTimeLocal | date-time |
Sygnatura czasowa tokenu przekonwertowana na żądaną strefę czasową. |
|
Zdekodowany token
|
decodedToken | string |
Zdekodowany nieprzetworzonego tekstu tokenu. W przypadku nieprzetworzonych danych wejściowych tokenu jest to zgodne z oryginalną wartością. |
|
Jest tokenem Base64
|
isBase64Token | boolean |
Prawda, gdy token przychodzący został zakodowany w formacie base64. |
|
Sequence
|
sequence | integer |
Wartość sekwencji zmian programu SharePoint osadzona w tokenie. |
|
Identyfikator GUID listy
|
listGuid | uuid |
Wyświetlanie listy lub identyfikatora GUID biblioteki osadzonego w tokenie. |
|
Wersja tokenu
|
tokenVersion | integer |
Numer wersji tokenu. |
|
Typ tokenu
|
tokenType | integer |
Numer typu tokenu programu SharePoint. |
|
Error
|
error | string |
Szczegóły błędu podczas analizowania kończą się niepowodzeniem. |
Pobieranie szczegółowych zmian elementów
Pobiera szczegółowe, sformatowane zmiany na poziomie pola dla elementu lub dokumentu listy programu SharePoint, porównując bieżącą wersję z poprzednią wersją. Użyj tej funkcji, gdy chcesz, aby zaawansowane dane zmieniały się, a nie wbudowane flagi pól true/false w stylu programu SharePoint.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL witryny
|
siteUrl | True | string |
Pełny adres URL witryny programu SharePoint zawierającej listę lub bibliotekę (na przykład |
|
Lista lub biblioteka
|
listId | True | string |
Identyfikator GUID lub dokładny tytuł listy lub biblioteki programu SharePoint. Lista rozwijana zwraca wartości identyfikatora GUID, ale wpis ręczny może używać identyfikatora GUID lub dokładnego tytułu listy. |
|
Identyfikator pozycji
|
itemId | True | integer |
Identyfikator elementu lub pliku programu SharePoint, który ma być analizowany pod kątem zmian (dostępny z danych wyjściowych wyzwalacza jako identyfikator). |
|
Porównanie z
|
triggerWindowStartToken | string |
Definiuje punkt początkowy dla porównania zmian. Akceptuje {TriggerWindowStartToken} wyzwalacza programu SharePoint (zalecane), etykietę wersji, taką jak "5.0", nieprzetworzony token zmiany programu SharePoint lub datę/godzinę odniesienia ISO 8601, taką jak "2026-03-30" lub "2026-03-30T14:15:00Z". Wartości tylko daty są interpretowane jako północ w wybranej strefie czasowej lub UTC, jeśli strefa czasowa jest pusta. Pomiń porównanie z bezpośrednio poprzednią wersją. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Niezależnie od tego, czy wersje pomocnicze, czy wersje robocze powinny uczestniczyć w porównaniu. Wartości domyślne to false, co oznacza, że są używane tylko wersje główne. |
|
|
Uwzględnij niezmienione pola
|
includeUnchangedFields | boolean |
Określa, czy w odpowiedzi powinny znajdować się niezmienione pola. Domyślnie ustawione na true. |
|
|
Format daty
|
dateFormat | string |
Niestandardowy format daty dla pól DateTime (na przykład "rrrr-MM-dd", "dd/MM/rrrr", "MM/dd/rrrr"). Wartość domyślna to "yyyy-MM-dd", jeśli nie zostanie określona. |
|
|
Format godziny
|
timeFormat | string |
Format godziny dołączony do daty dla pól DateTime z godziną (na przykład "HH:mm:ss", "HH:mm", "hh:mm tt"). Wartość domyślna to "HH:mm:ss", jeśli nie zostanie określona. |
|
|
Timezone
|
timezone | string |
Identyfikator strefy czasowej IANA dla konwersji daty/godziny (na przykład "Ameryka/New_York", "Europa/Londyn", "Australia/Sydney". Wartość domyślna to UTC, jeśli nie zostanie określona. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean |
Wskazuje, czy operacja została ukończona pomyślnie |
|
Message
|
message | string |
Czytelny dla człowieka komunikat opisujący wynik |
|
Zmienione pola
|
changedFields | array of object |
Śledzone pola jako tablica. |
|
Zmieniono wartość kolumny
|
changedFields.hasChanged | boolean |
Prawda, jeśli wartość tego pola została zmieniona między poprzednią i bieżącą wersją |
|
Poprzednia wartość kolumny (tekst)
|
changedFields.previousAsString | string |
Sformatowana poprzednia wartość jako ciąg czytelny dla człowieka |
|
Nazwa wewnętrzna pola
|
changedFields.internalName | string |
Wewnętrzna nazwa pola programu SharePoint |
|
Nazwa pola
|
changedFields.displayName | string |
Przyjazna nazwa wyświetlana pola |
|
Poprzednia wartość kolumny (szczegółowa)
|
changedFields.previous |
Nieprzetworzona poprzednia wartość. Ta właściwość jest dynamiczna i może być ciągiem, liczbą, wartością logiczną, obiektem, tablicą lub wartością null w zależności od typu pola programu SharePoint. |
|
|
Bieżąca wartość kolumny (tekst)
|
changedFields.currentAsString | string |
Sformatowana bieżąca wartość jako ciąg czytelny dla człowieka |
|
Bieżąca wartość kolumny (szczegółowa)
|
changedFields.current |
Nieprzetworzona bieżąca wartość. Ta właściwość jest dynamiczna i może być ciągiem, liczbą, wartością logiczną, obiektem, tablicą lub wartością null w zależności od typu pola programu SharePoint. |
|
|
Ma punkt odniesienia porównania
|
hasComparisonBaseline | boolean |
Prawda, jeśli dla porównania została rozpoznana odrębna wersja punktu odniesienia dla bieżącej wersji. |
|
To pierwsza wersja wg planu bazowego
|
isBaselineFirstVersion | boolean |
Prawda, jeśli rozpoznana wersja punktu odniesienia jest pierwszą wersją, jaką kiedykolwiek zarejestrowano dla elementu lub pliku. |
|
Etykieta bieżącej wersji
|
currentVersionLabel | string |
Etykieta wersji bieżącej wersji (na przykład "2.0", "5.0") |
|
Etykieta poprzedniej wersji
|
previousVersionLabel | string |
Etykieta wersji używana do porównania (na przykład "1.0", "4.0") |
|
Tytuł elementu
|
itemTitle | string |
Tytuł zmienionego elementu |
|
Adres URL elementu
|
itemUrl | string |
Bezpośredni link do zmienionego elementu programu SharePoint |
|
Data modyfikacji
|
modifiedDate | date-time |
Sygnatura czasowa najnowszej modyfikacji |
|
Autor modyfikacji
|
modifiedBy | string |
Nazwa wyświetlana użytkownika, który ostatnio zmodyfikował element |
|
Error
|
error | string |
Szczegóły błędu, jeśli powodzenie jest fałszywe |
Uzyskiwanie szczegółowego alertu o elemencie HTML
Zwraca gotowy do użycia kod HTML przekaźnika alertów dla zmian elementów programu SharePoint zaprojektowany głównie dla wiadomości e-mail alertów w stylu programu SharePoint, ale także do użycia w dokumentach lub w innych miejscach docelowych obsługujących kod HTML.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL witryny
|
siteUrl | True | string |
Pełny adres URL witryny programu SharePoint zawierającej listę lub bibliotekę. |
|
Lista lub biblioteka
|
listId | True | string |
Identyfikator GUID lub dokładny tytuł listy lub biblioteki programu SharePoint. Lista rozwijana zwraca wartości identyfikatora GUID, ale wpis ręczny może używać identyfikatora GUID lub dokładnego tytułu listy. |
|
Identyfikator pozycji
|
itemId | True | integer |
Identyfikator elementu lub pliku programu SharePoint do przeanalizowania pod kątem zmian. |
|
Porównanie z
|
triggerWindowStartToken | string |
Definiuje punkt początkowy dla porównania zmian. Akceptuje {TriggerWindowStartToken} wyzwalacza programu SharePoint (zalecane), etykietę wersji, taką jak "5.0", nieprzetworzony token zmiany programu SharePoint lub datę/godzinę odniesienia ISO 8601, taką jak "2026-03-30" lub "2026-03-30T14:15:00Z". Wartości tylko daty są interpretowane jako północ w wybranej strefie czasowej lub UTC, jeśli strefa czasowa jest pusta. Pomiń porównanie z bezpośrednio poprzednią wersją. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Niezależnie od tego, czy wersje pomocnicze, czy wersje robocze powinny uczestniczyć w porównaniu. Wartości domyślne to false, co oznacza, że są używane tylko wersje główne. |
|
|
Uwzględnij niezmienione pola
|
includeUnchangedFields | boolean |
Określa, czy niezmieniane pola powinny być uwzględniane w wygenerowanych kodzie HTML. Domyślnie ustawione na true. |
|
|
Format daty
|
dateFormat | string |
Niestandardowy format daty dla pól DateTime (na przykład "rrrr-MM-dd", "dd/MM/rrrr"). Wartość domyślna to "yyyy-MM-dd", jeśli nie zostanie określona. |
|
|
Format godziny
|
timeFormat | string |
Format godziny dołączony do daty dla pól DateTime z godziną (na przykład "HH:mm:ss", "HH:mm", "hh:mm tt"). |
|
|
Timezone
|
timezone | string |
Identyfikator strefy czasowej IANA dla konwersji daty/godziny (na przykład "Ameryka/New_York", "Europa/Londyn", "Australia/Sydney". |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean |
Wskazuje, czy operacja została ukończona pomyślnie |
|
Message
|
message | string |
Czytelny dla człowieka komunikat opisujący wynik |
|
Treść HTML
|
htmlBody | string |
Kompletna treść HTML gotowa do użycia w wiadomościach e-mail z alertami lub w innych miejscach docelowych obsługujących kod HTML |
|
Sugerowany temat
|
subject | string |
Sugerowany wiersz tematu dla alertu |
|
Tytuł elementu
|
itemTitle | string |
Tytuł zmienionego elementu |
|
Adres URL elementu
|
itemUrl | string |
Bezpośredni link do zmienionego elementu programu SharePoint |
|
Jest nowym elementem
|
isNewItem | boolean |
Wartość true, jeśli alert dotyczy nowego elementu lub pliku programu SharePoint, a nie aktualizacji istniejącego. |
|
Error
|
error | string |
Szczegóły błędu, jeśli powodzenie jest fałszywe |