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, a także 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ń. Informacje o zmianach i wersji można również używać w decyzjach i warunkach przepływu.
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 Software |
| 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
Przekaźnik alertów dla platformy Power Platform i Microsoft 365 Copilot
Usługa Alert Relay ułatwia organizacjom zastępowanie klasycznych alertów SharePoint nowoczesnymi rozwiązaniami Power Automate i Copilot Studio. Porównuje SharePoint elementów, plików i stron z wcześniejszymi wersjami oraz zwraca informacje o zmianach strukturalnych, historię wersji i zawartość powiadomień gotowych do użycia bez konieczności tworzenia złożonej logiki porównywania wersji SharePoint przez twórców.
Overview
SharePoint wyzwalacze mogą zidentyfikować, że element, plik lub strona uległ zmianie, ale nie zapewniają pełnego porównania poprzednich i bieżących wartości.
Tworzenie tego porównania często wymaga od twórców pobierania wersji, interpretowania tokenów zmian, porównywania pól i formatowania wyników dla powiadomień lub przetwarzania podrzędnego.
Usługa Alert Relay centralizuje działanie za pomocą akcji wielokrotnego użytku dla Power Automate i Copilot Studio.
Najważniejsze funkcje
Usługa Alert Relay centralizuje, które działają za pomocą akcji wielokrotnego użytku, które mogą:
- identyfikowanie szczegółowych zmian na poziomie pola
- zwracanie poprzednich i bieżących wartości pól
- generowanie gotowego do użycia kodu HTML na potrzeby wiadomości e-mail z alertami SharePoint
- pobieranie historii wersji elementu, pliku i strony
- porównanie z tokenu wyzwalacza, zmiana tokenu, etykieta wersji lub data
- format obsługiwanych złożonych typów pól SharePoint
- zwracanie informacji ustrukturyzowanych dla Power Automate i Microsoft 365 Copilot
Usługa Alert Relay obsługuje listy SharePoint, biblioteki dokumentów i biblioteki stron witryn.
Wprowadzenie
Typowy przepływ alertów SharePoint obejmuje:
- Wyzwalacz SharePoint, taki jak Po utworzeniu lub zmodyfikowaniu elementu.
- Akcja przekaźnika alertów, taka jak Pobieranie elementu lub zmiany pliku, jako html alertu.
- Wiadomość e-mail lub inna akcja powiadomienia, która używa zwróconego tematu i treści HTML.
W przypadku warunków, niestandardowego formatowania lub scenariuszy agenta Microsoft Copilot Studio użyj polecenia Pobierz szczegółowy element lub zmiany pliku i współpracuj ze zwracanymi informacjami o zmianie ustrukturyzowanej.
W przypadku historycznych wersji SharePoint użyj polecenia Pobierz element lub Historię wersji pliku.
Documentation
Dokumentacja, informacje referencyjne dotyczące akcji, przykłady i wskazówki dotyczące rozpoczynania pracy są dostępne pod adresem:
Dokumentacja usługi Alert Relay
Samouczki wideo
Przewodniki krok po kroku, przykłady i filmy wideo z instrukcjami są dostępne w kanale YouTube usługi Alert Relay:
Alert Relay w serwisie YouTube
Licencjonowanie i wersja próbna
Licencjonowanie usługi Alert Relay dotyczy całej dzierżawy. Pojedyncza wersja próbna lub subskrypcja ma zastosowanie w dzierżawie Microsoft Entra, a jej jednostki użycia są współużytkowane przez przepływy i użytkowników usługi Alert Relay w tej dzierżawie.
90-dniowa wersja próbna jest uruchamiana automatycznie po pierwszym uruchomieniu akcji usługi Alert Relay w dzierżawie i obejmuje 300 jednostek użycia współużytkowanych w całej wersji próbnej. Aby uzyskać informacje o bieżących planach i dalszych szczegółach, zobacz Alert Relay — cennik i licencjonowanie.
Czynności
Pobieranie szczegółowych zmian elementu lub pliku
Zwraca szczegółowe zmiany na poziomie pola między bieżącą wersją elementu SharePoint, pliku lub strony a starszą wersją.
Akcja zwraca informacje ustrukturyzowane, w tym poprzednie i bieżące wartości, sformatowane wartości i metadane porównania. Należy używać go, gdy przepływ lub Microsoft Copilot Studio agent musi sprawdzić, podsumować lub podjąć działania w sprawie poszczególnych zmian.
Pobieranie zmian elementu lub pliku jako alertu HTML
Generuje gotowy do użycia kod HTML pokazujący, co zmieniło się w elemencie SharePoint, pliku lub stronie.
Akcja zwraca również sugerowany temat wiadomości e-mail, tytuł elementu i link elementu. Służy do tworzenia bogatszych wiadomości e-mail SharePoint alertów bez tworzenia złożonych wyrażeń porównania kodu HTML i wersji w każdym przepływie.
Pobieranie historii wersji elementu lub pliku
Zwraca powiązaną, stronicowaną historię wersji dla elementu SharePoint, pliku lub strony.
Akcja może zwracać wybrane pola SharePoint i obsługuje granice wersji, daty i SharePoint tokenu wyzwalacza. Służy do przeglądania historycznego, inspekcji, raportowania, zatwierdzania i scenariuszy przepływu pracy obsługujących wersje.
Analizowanie informacji o wersji SharePoint
Dekoduje SharePoint informacje o wyzwalaczu i zmianie tokenu.
Użyj tej akcji, aby pobrać znacznik czasu tokenu, zastosować decyzje dotyczące daty lub wersji oraz filtrować niepożądane wyzwalacze wersji pomocniczej lub roboczej przed wywołaniem szczegółowej akcji zmiany.
Typowe zastosowania
Usługa Alert Relay może pomóc:
- zastępowanie alertów klasycznych SharePoint przepływami Power Automate
- wysyłanie sformatowanych powiadomień z dokładnie tym, co się zmieniło
- porównywanie poprzednich i bieżących wartości dla ważnych pól biznesowych
- śledzenie zmian metadanych dokumentu i stron SharePoint
- pobieranie SharePoint elementu i historii wersji pliku
- zatwierdzanie kompilacji, przeglądanie, zarządzanie i inspekcja przepływów pracy
- udostępnianie ustrukturyzowanych SharePoint zmian informacji na Microsoft 365 Copilot
Uwierzytelnianie i dostęp
Usługa Alert Relay używa Microsoft Entra ID uwierzytelniania delegowanego.
SharePoint dostęp jest wykonywany w kontekście zalogowanego użytkownika. Usługa Alert Relay nie udziela użytkownikom dodatkowych uprawnień SharePoint, dlatego użytkownicy muszą mieć już dostęp do odpowiedniej witryny SharePoint, listy, biblioteki, elementu lub pliku.
Wymagania i obsługiwany zakres
- Usługa Alert Relay obsługuje usługę SharePoint Online. SharePoint Server lokalnie nie jest obsługiwana.
- Akcje są uruchamiane po wywołaniu przez Power Automate lub innego obsługiwanego klienta. W przypadku powiadomień o zmianie użyj odpowiedniego wyzwalacza SharePoint, aby uruchomić przepływ.
- Porównania korzystające z tokenów wyzwalacza SharePoint są oparte na oknie wyzwalacza SharePoint. Wynikowy punkt odniesienia może różnić się od granicy wersji specyficznej dla elementu.
- Szczegółowe formatowanie jest dostępne dla obsługiwanych typów pól SharePoint. Zapoznaj się z dokumentacją usługi Alert Relay, aby uzyskać informacje o bieżącym typie pola.
Support
Witryna internetowa: https://independnet.com.au/alert-relay/
Wsparcie: https://independnet.com.au/alert-relay/support
Adres e-mail: support@alertrelay.com.au
Zasady ochrony prywatności: https://independnet.com.au/alert-relay/privacy
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
| Nazwisko | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
|
Analizowanie informacji o wersji Share |
Dekoduje SharePoint Compare From token. Po podaniu numeru wersji i daty modyfikacji określa, czy element lub plik jest nową wersją. Użyj tej akcji bez rozliczeń w warunkach przepływu przed wywołaniem akcji rozliczanych przez usługę Alert Relay. |
| Pobieranie historii wersji elementu lub pliku |
Zwraca maksymalnie żądaną liczbę wersji dla elementu lub pliku SharePoint list, najpierw najnowszy. Każda wersja zawiera szczegóły wersji, wartości kolumn, sformatowane wartości tekstowe i wskaźniki pokazujące, które kolumny zmieniły się od poprzedniej dostępnej wersji. Wybierz witrynę i listę lub bibliotekę podczas konfigurowania tej akcji, aby udostępnić kolumny jako zawartość dynamiczną. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika. |
| Pobieranie szczegółowych zmian elementu lub pliku |
Pobiera szczegółowe, sformatowane zmiany na poziomie pola dla elementu lub pliku SharePoint list, porównując bieżącą wersję z poprzednią wersją. Użyj tej funkcji, jeśli chcesz uzyskać zaawansowane dane zmiany, a nie tylko wbudowane wskaźniki zmian SharePoint wartości true/false. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika. |
| Pobieranie zmian elementu lub pliku jako alertu HTML |
Zwraca gotowy do użycia kod HTML usługi Alert Relay dla zmian elementów SharePoint zaprojektowany głównie dla wiadomości e-mail z alertami, ale także do użytku w dowolnym miejscu obsługiwanym przez kod HTML. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika. |
Analizowanie informacji o wersji SharePoint
Dekoduje SharePoint Compare From token. Po podaniu numeru wersji i daty modyfikacji określa, czy element lub plik jest nową wersją. Użyj tej akcji bez rozliczeń w warunkach przepływu przed wywołaniem akcji rozliczanych przez usługę Alert Relay.
Parametry
| Nazwisko | 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ę. |
|
Numer wersji
|
versionNumber | string |
Numer wersji z wyzwalacza lub akcji SharePoint, na przykład 0.1, 1.0 lub 1.5. Służy do identyfikowania wersji pomocniczych/wersji roboczych. |
|
|
Data modyfikacji
|
modifiedDate | date-time |
Data modyfikacji z wyzwalacza lub akcji SharePoint. Służy do wykrywania, czy widoczna wersja SharePoint została zmieniona w oknie wyzwalacza. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Czy numery wersji pomocniczych/wersji roboczych powinny być liczone jako nowe wersje. Wartość domyślna to fałsz. |
|
|
Timezone
|
timezone | string |
Opcjonalna strefa czasowa dla lokalnych wartości porównania, takich jak "Ameryka/New_York", "Europa/Londyn" lub "Australia/Sydney" (identyfikator strefy czasowej IANA). W przypadku pominięcia zwracana jest tylko wartość UTC. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean |
Prawda, gdy informacje o wersji zostały pomyślnie przeanalizowane; wartość false, gdy walidacja lub przetwarzanie nie powiodło się. |
|
Message
|
message | string |
Komunikat skierowany do użytkownika opisujący wynik operacji. Agenci i elementy copilots powinny wyświetlać użytkownikowi ten komunikat, gdy zawiera informacje o wersji próbnej, subskrypcji, użyciu, ostrzeżeniu lub przetwarzaniu wersji. |
|
Data tokenu o godzinie UTC
|
tokenDateTimeUTC | date-time |
Data i godzina z tokenu Compare From zwrócone w formacie UTC. |
|
Lokalna data tokenu
|
tokenDateTimeLocal | date-time |
Data i godzina z tokenu Porównaj z przekonwertowane na wybraną strefę czasową. |
|
Zdekodowany token
|
decodedToken | string |
Nieprzetworzone SharePoint zmienić token po dekodowaniu. Jeśli funkcja Compare From była już nieprzetworzonym tokenem, jest to zgodne z podaną 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. |
|
Czy wykryto nową wersję
|
isNewVersionDetected | boolean |
Wartość true, gdy podane metadane wyzwalacza/akcji pokazują, że powinna zostać przetworzona nowa widoczna wersja SharePoint. Fałsz, gdy należy pominąć wersję. Wartość null, jeśli nie ma wystarczającej ilości metadanych do określenia. |
|
Jest wersją pomocniczą
|
isMinorVersion | boolean |
Wartość true, jeśli podany numer wersji jest wersją pomocniczą/roboczą. Wartość null, gdy nie podano numeru wersji. |
|
Jest pierwszą wersją pomocniczą
|
isFirstMinorVersion | boolean |
Wartość true, jeśli podany numer wersji jest pierwszą wersją pomocniczą/wersją roboczą, zazwyczaj 0.1. Wartość null, gdy nie podano numeru wersji. |
|
Jest pierwszą wersją główną
|
isFirstMajorVersion | boolean |
Wartość true, jeśli podany numer wersji jest pierwszą wersją główną/opublikowaną, zazwyczaj 1.0. Wartość null, gdy nie podano numeru wersji. |
|
Data modyfikacji UTC
|
modifiedDateUtc | date-time |
Podana data modyfikacji znormalizowana do czasu UTC. Wartość null, gdy data modyfikacji nie została podana. |
|
Data modyfikacji lokalna
|
modifiedDateLocal | date-time |
Podana data modyfikacji przekonwertowana na wybraną strefę czasową. Wartość null, gdy nie podano zmodyfikowanej daty lub strefy czasowej. |
|
Error
|
error | string |
Szczegóły błędu, jeśli powodzenie jest fałszywe. |
Pobieranie historii wersji elementu lub pliku
Zwraca maksymalnie żądaną liczbę wersji dla elementu lub pliku SharePoint list, najpierw najnowszy. Każda wersja zawiera szczegóły wersji, wartości kolumn, sformatowane wartości tekstowe i wskaźniki pokazujące, które kolumny zmieniły się od poprzedniej dostępnej wersji. Wybierz witrynę i listę lub bibliotekę podczas konfigurowania tej akcji, aby udostępnić kolumny jako zawartość dynamiczną. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL witryny
|
siteUrl | True | string |
Wybierz witrynę SharePoint lub wprowadź adres URL witryny. |
|
Lista lub biblioteka
|
listId | True | string |
Wybierz listę lub bibliotekę, której kolumny wersji powinny być dostępne jako zawartość dynamiczna w przepływie. |
|
Identyfikator pozycji
|
itemId | True | integer |
SharePoint list identyfikator elementu. Można to dostarczać dynamicznie w czasie wykonywania, na przykład z wyzwalacza SharePoint lub wcześniejszej akcji przepływu. |
|
Maksymalna liczba jednostek użycia
|
maximumUsageUnits | True | integer |
Wymagany limit wybranego obiektu wywołującego dla jednostek użycia, które mogą być używane przez to wywołanie. Wartość domyślna to 1. Jest to ochrona rozliczeniowa, a nie limit liczby wersji; jedna jednostka użycia może zwrócić wiele pełnych wersji. Użyj opcji Maksymalna wersja, aby ograniczyć liczbę wierszy wersji. |
|
Maksymalne wersje
|
maximumVersions | integer |
Maksymalna całkowita liczba pełnych wierszy wersji, które mają być zwracane na wszystkich stronach. Pozostaw pole puste, aby kontynuować do zakończenia wybranego zakresu, dostępnej historii lub budżetu jednostek użycia. Każda odpowiedź nie zawiera więcej niż 100 wersji. |
|
|
Pola do zwrócenia
|
fieldsToReturn | array of string |
SharePoint kolumny do uwzględnienia w każdej wersji. Dodaj jedną kolumnę na element. Pozostaw pole Pola do zwracania pustego, aby zwrócić każdą obsługiwaną kolumnę. Wybranie mniejszej liczby kolumn może zmniejszyć rozmiar odpowiedzi i pracę jednostkową użycia. |
|
|
Porównanie z
|
fromVersion | string |
Punkt początkowy dla zakresu historii wersji. Użyj wyzwalacza SharePoint TriggerWindowStartToken, jeśli jest dostępny. Możesz również wprowadzić etykietę wersji, nieprzetworzonego tokenu zmiany lub datę/godzinę punktu odniesienia. Wartości tylko daty używają północy w wybranej strefie czasowej lub UTC, jeśli nie wybrano strefy czasowej. Pozostaw wartość pustą dla braku starszej granicy. |
|
|
Porównaj z
|
toVersion | string |
Punkt końcowy zakresu historii wersji. Użyj wyzwalacza SharePoint TriggerWindowEndToken, jeśli jest dostępny. Możesz również wprowadzić etykietę wersji, nieprzetworzonego tokenu zmiany lub datę/godzinę. Wartości tylko daty używają północy w wybranej strefie czasowej lub UTC, jeśli nie wybrano strefy czasowej. Pozostaw puste pole bez nowszej granicy. |
|
|
Token stronicowania
|
continuationToken | string |
Token używany do pobierania następnej strony historii wersji, jeśli został zwrócony przez poprzednie wywołanie. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Określa, czy należy uwzględnić wersje pomocnicze, czy wersje robocze podczas pobierania historii wersji. Wartością domyślną jest fałsz, więc zwracane są tylko wersje główne. |
|
|
Format daty
|
dateFormat | string |
Format używany dla pól DateTime (na przykład "rrrr-MM-dd", "dd/MM/rrrr", "MM/dd/rrrr"). Wartość domyślna to "yyyy-MM-dd". |
|
|
Format godziny
|
timeFormat | string |
Format używany dla części czasowej pól DateTime (na przykład HH:mm:ss, HH:mm, hh:mm tt). Wartość domyślna to HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Strefa czasowa używana podczas formatowania dat i godzin (na przykład Ameryka/New_York, Europa/Londyn, Australia/Sydney). Wartość domyślna to UTC. |
Zwraca
Pobieranie szczegółowych zmian elementu lub pliku
Pobiera szczegółowe, sformatowane zmiany na poziomie pola dla elementu lub pliku SharePoint list, porównując bieżącą wersję z poprzednią wersją. Użyj tej funkcji, jeśli chcesz uzyskać zaawansowane dane zmiany, a nie tylko wbudowane wskaźniki zmian SharePoint wartości true/false. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL witryny
|
siteUrl | True | string |
Wybierz witrynę SharePoint lub wprowadź adres URL witryny. |
|
Lista lub biblioteka
|
listId | True | string |
Wybierz listę lub bibliotekę albo wprowadź tytuł lub identyfikator GUID. |
|
Identyfikator pozycji
|
itemId | True | integer |
Identyfikator elementu lub pliku programu SharePoint do przeanalizowania pod kątem zmian. |
|
Porównanie z
|
triggerWindowStartToken | string |
Punkt wyjścia dla porównania. Użyj wyzwalacza SharePoint TriggerWindowStartToken, jeśli jest dostępny. Możesz również wprowadzić etykietę wersji, nieprzetworzonego tokenu zmiany lub datę/godzinę punktu odniesienia. Wartości tylko daty używają północy w wybranej strefie czasowej lub UTC, jeśli nie wybrano strefy czasowej. Pozostaw wartość pustą, aby porównać ją z poprzednią wersją. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Określa, czy należy uwzględnić wersje pomocnicze, czy wersje robocze podczas porównywania zmian. Wartości domyślne to false, więc porównywane są 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 |
Format używany dla pól DateTime (na przykład "rrrr-MM-dd", "dd/MM/rrrr", "MM/dd/rrrr"). Wartość domyślna to "yyyy-MM-dd". |
|
|
Format godziny
|
timeFormat | string |
Format używany dla części czasowej pól DateTime (na przykład HH:mm:ss, HH:mm, hh:mm tt). Wartość domyślna to HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Strefa czasowa używana podczas formatowania dat i godzin (na przykład Ameryka/New_York, Europa/Londyn, Australia/Sydney). Wartość domyślna to UTC. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean |
Wartość true po pomyślnym zakończeniu akcji; wartość false, gdy walidacja lub przetwarzanie nie powiodło się. |
|
Message
|
message | string |
Komunikat skierowany do użytkownika opisujący wynik operacji. Agenci i elementy copilots powinny wyświetlać użytkownikowi ten komunikat, gdy zawiera informacje o wersji próbnej, subskrypcji, użyciu, ostrzeżeniu lub przetwarzaniu wersji. |
|
Wyświetlanie powiadomienia użytkownika
|
shouldDisplayUserNotice | boolean |
Wskazuje, czy usługa Alert Relay zwróciła ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu dla użytkownika. |
|
Kod powiadomienia użytkownika
|
userNoticeCode | string |
Stabilna przyczyna czytelna dla komputera dla powiadomienia użytkownika. |
|
Ważność powiadomienia użytkownika
|
userNoticeSeverity | string |
Ważność prezentacji dla użytkownika: informacje, ostrzeżenie lub krytyczne. |
|
Powiadomienie użytkownika
|
userNotice | string |
Ważne informacje o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay. |
|
Wywołanie do akcji powiadomienia użytkownika
|
userNoticeCallToAction | string |
Co użytkownik może zrobić dalej, w tym witrynę internetową usługi Alert Relay i adres e-mail pomocy technicznej. |
|
Zmienione pola
|
changedFields | array of object |
Lista porównywanych pól SharePoint, w tym nazwy każdego pola, poprzedniej wartości, bieżącej wartości i tego, czy została zmieniona. |
|
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. |
|
Jest nowym elementem
|
isNewItem | boolean |
Wartość true, gdy element lub plik powinien być traktowany jako nowy dla rozwiązanego okna porównania, a nie jako aktualizacja. |
|
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") |
|
Nazwa elementu lub pliku
|
itemTitle | string |
Tytuł lub nazwa pliku zmienionego elementu lub pliku. |
|
Adres URL elementu lub pliku
|
itemUrl | string |
Bezpośredni link do zmienionego elementu lub pliku SharePoint. |
|
Data modyfikacji
|
modifiedDate | date-time |
Data i godzina 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 |
Pobieranie zmian elementu lub pliku jako alertu HTML
Zwraca gotowy do użycia kod HTML usługi Alert Relay dla zmian elementów SharePoint zaprojektowany głównie dla wiadomości e-mail z alertami, ale także do użytku w dowolnym miejscu obsługiwanym przez kod HTML. Wyniki mogą zawierać ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay dla użytkownika.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL witryny
|
siteUrl | True | string |
Wybierz witrynę SharePoint lub wprowadź adres URL witryny. |
|
Lista lub biblioteka
|
listId | True | string |
Wybierz listę lub bibliotekę albo wprowadź tytuł lub identyfikator GUID. |
|
Identyfikator pozycji
|
itemId | True | integer |
Identyfikator elementu lub pliku programu SharePoint do przeanalizowania pod kątem zmian. |
|
Porównanie z
|
triggerWindowStartToken | string |
Punkt wyjścia dla porównania. Użyj wyzwalacza SharePoint TriggerWindowStartToken, jeśli jest dostępny. Możesz również wprowadzić etykietę wersji, nieprzetworzonego tokenu zmiany lub datę/godzinę punktu odniesienia. Wartości tylko daty używają północy w wybranej strefie czasowej lub UTC, jeśli nie wybrano strefy czasowej. Pozostaw wartość pustą, aby porównać ją z poprzednią wersją. |
|
|
Uwzględnij wersje pomocnicze
|
includeMinorVersions | boolean |
Określa, czy należy uwzględnić wersje pomocnicze, czy wersje robocze podczas porównywania zmian. Wartości domyślne to false, więc porównywane są 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 |
Format używany dla pól DateTime (na przykład "rrrr-MM-dd", "dd/MM/rrrr"). Wartość domyślna to "yyyy-MM-dd". |
|
|
Format godziny
|
timeFormat | string |
Format używany dla części czasowej pól DateTime (na przykład HH:mm:ss, HH:mm, hh:mm tt). Wartość domyślna to HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Strefa czasowa używana podczas formatowania dat i godzin (na przykład Ameryka/New_York, Europa/Londyn, Australia/Sydney). Wartość domyślna to UTC. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
success | boolean |
Wartość true po pomyślnym zakończeniu akcji; wartość false, gdy walidacja lub przetwarzanie nie powiodło się. |
|
Message
|
message | string |
Komunikat skierowany do użytkownika opisujący wynik operacji. Agenci i elementy copilots powinny wyświetlać użytkownikowi ten komunikat, gdy zawiera informacje o wersji próbnej, subskrypcji, użyciu, ostrzeżeniu lub przetwarzaniu wersji. |
|
Wyświetlanie powiadomienia użytkownika
|
shouldDisplayUserNotice | boolean |
Wskazuje, czy usługa Alert Relay zwróciła ważne powiadomienie o wersji próbnej, subskrypcji lub użyciu dla użytkownika. |
|
Kod powiadomienia użytkownika
|
userNoticeCode | string |
Stabilna przyczyna czytelna dla komputera dla powiadomienia użytkownika. |
|
Ważność powiadomienia użytkownika
|
userNoticeSeverity | string |
Ważność prezentacji dla użytkownika: informacje, ostrzeżenie lub krytyczne. |
|
Powiadomienie użytkownika
|
userNotice | string |
Ważne informacje o wersji próbnej, subskrypcji lub użyciu usługi Alert Relay. |
|
Wywołanie do akcji powiadomienia użytkownika
|
userNoticeCallToAction | string |
Co użytkownik może zrobić dalej, w tym witrynę internetową usługi Alert Relay i adres e-mail pomocy technicznej. |
|
Treść HTML
|
htmlBody | string |
Treść HTML wiadomości alertu gotowa do użycia w wiadomości e-mail lub w dowolnym miejscu HTML jest obsługiwana. |
|
Wygenerowany temat alertu
|
subject | string |
Sugerowany wiersz tematu dla alertu |
|
Nazwa elementu lub pliku
|
itemTitle | string |
Tytuł lub nazwa pliku zmienionego elementu lub pliku. |
|
Adres URL elementu lub pliku
|
itemUrl | string |
Bezpośredni link do zmienionego elementu lub pliku SharePoint. |
|
Jest nowym elementem
|
isNewItem | boolean |
Określa, czy wygenerowany alert opisuje element lub plik jako dodany, czy zmieniony. |
|
Error
|
error | string |
Szczegóły błędu, jeśli powodzenie jest fałszywe |