Ретранслятор оповещений (предварительная версия)
Ретранслятор оповещений помогает заменить устаревшие оповещения SharePoint более богатыми современными уведомлениями. Он возвращает подробные изменения на уровне поля и готовый к использованию HTML-код оповещений, чтобы вы могли точно показать, что изменилось вместо универсальных измененных уведомлений.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: - Azure для государственных организаций регионы - Azure регионы Китая - Министерство обороны США (DoD) |
| Power Apps | Premium | Все регионы Power Apps кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Premium | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Name | Поддержка independNET |
| URL | https://independnet.com.au/alert-relay/support |
| Адрес электронной почты | support@alertbridge.com.au |
| Метаданные соединителя | |
|---|---|
| Publisher | Продукты independNET |
| Веб-сайт | https://independnet.com.au/alert-relay/ |
| Политика конфиденциальности | https://independnet.com.au/alert-relay/privacy |
| Категории | Сотрудничество; Продуктивность |
Ретранслятор оповещен
Ретранслятор оповещений для Power Platform и Microsoft 365 Copilot
Ретранслятор оповещений помогает организациям заменить классические оповещения SharePoint современными решениями Power Automate и Copilot Studio. Он сравнивает SharePoint элементы, файлы и страницы с более ранними версиями и возвращает структурированные сведения об изменениях, журнал версий и содержимое уведомлений, готовые к использованию, не требуя создания сложной логики сравнения версий SharePoint.
Обзор
триггеры SharePoint могут определить, что элемент, файл или страница изменены, но они не предоставляют полное сравнение предыдущих и текущих значений.
Для создания этого сравнения часто требуется, чтобы производители извлекли версии, интерпретировали маркеры изменений, сравнивали поля и форматировали результаты для уведомлений или обработки нижестоящего потока.
Ретранслятор оповещений централизирует работу с повторно используемыми действиями для Power Automate и Copilot Studio.
Ключевые функции
Ретранслятор оповещений централизирует работу с повторно используемыми действиями, которые могут:
- определение подробных изменений на уровне поля
- возвращает значения предыдущих и текущих полей
- создание готовых к использованию HTML для сообщений электронной почты SharePoint оповещений
- Получение элемента, файла и журнала версий страницы
- сравнение с маркером триггера, маркером изменений, меткой версии или датой
- Формат поддерживаемых сложных типов полей SharePoint
- возвращает структурированные сведения для Power Automate и Microsoft 365 Copilot
Ретранслятор оповещений поддерживает SharePoint списки, библиотеки документов и библиотеки страниц сайта.
Getting Started
Типичный поток оповещений SharePoint включает:
- Триггер SharePoint, например при создании или изменении элемента.
- Действие ретранслятора оповещений, например получение изменений элемента или файла в виде HTML-кода оповещения.
- Сообщение электронной почты или другое действие уведомления, использующее возвращаемую тему и текст HTML.
Для условий пользовательские сценарии форматирования или Microsoft Copilot Studio агента используйте команду Get Detailed Item или File Change и работать со структурированными сведениями об изменениях, которые он возвращает.
Для исторических версий SharePoint используйте журнал версий элементов или файлов.
Documentation
Документация, справочные сведения о действиях, примеры и рекомендации по началу работы доступны по адресу:
Документация по ретранслятору оповещен
Видеоучебники
Пошаговые руководства, примеры и видеоролики о том, как это сделать, доступны на канале YouTube ретрансляции оповещений:
Ретранслятор оповещений на YouTube
Лицензирование и пробная версия
Лицензирование ретранслятора оповещений — это лицензирование на уровне клиента. Одна пробная версия или подписка применяется в клиенте Microsoft Entra, а его единицы использования совместно используются потоками ретрансляции оповещений и пользователями в этом клиенте.
Пробная версия 90-дневной запускается автоматически, когда любое действие ретрансляции оповещений сначала запускается в клиенте и включает 300 единиц использования, общих для всех пробных версий. Сведения о текущих планах и дополнительных сведениях см. в разделе о ценах и лицензировании ретранслятора оповещений.
Действия
Получение подробных изменений элемента или файла
Возвращает подробные изменения на уровне поля между текущей версией элемента SharePoint, файлами или страницей и более ранней версией.
Действие возвращает структурированные сведения, включая предыдущие и текущие значения, отформатированные значения и метаданные сравнения. Используйте его, когда поток или агент Microsoft Copilot Studio должен проверять, сводить или действовать по отдельным изменениям.
Получение изменений элемента или файла в виде HTML-кода оповещения
Создает готовый HTML-код, показывающий, что изменилось в элементе SharePoint, файле или странице.
Действие также возвращает рекомендуемую тему электронной почты, название элемента и ссылку на элемент. Используйте его для создания более широких SharePoint оповещений без создания сложных выражений сравнения HTML и версий в каждом потоке.
Получение журнала версий элементов или файлов
Возвращает привязанный журнал версий, доступный для страницы, SharePoint элемента, файла или страницы.
Действие может возвращать выбранные поля SharePoint и поддерживать границы версии, даты и SharePoint маркера триггера. Используйте его для сценариев рабочего процесса с учетом исторических данных, аудита, отчетности, утверждения и поддержки версий.
Анализ сведений о версии SharePoint
Декодирует SharePoint сведения о триггере и маркере изменений.
Используйте это действие, чтобы получить метку времени маркера, применить решения на основе дат или версий и отфильтровать нежелательные триггеры дополнительных или черновиковых версий перед вызовом подробного действия изменения.
Типичные варианты использования
Ретранслятор оповещений поможет вам:
- замените классические оповещения SharePoint потоками Power Automate
- отправка отформатированных уведомлений с указанием того, что изменилось
- сравнение предыдущих и текущих значений важных бизнес-полей
- отслеживание изменений метаданных документа и страниц SharePoint
- Получение журнала версий SharePoint и элементов
- Создание рабочих процессов утверждения, проверки, управления и аудита
- предоставление структурированных SharePoint сведений об изменении Microsoft 365 Copilot
Проверка подлинности и доступ
Ретранслятор оповещений использует делегированную проверку подлинности Microsoft Entra ID.
SharePoint доступ выполняется в контексте пользователя, вошедшего в систему. Ретранслятор оповещений не предоставляет пользователям дополнительные разрешения SharePoint, поэтому пользователи уже должны иметь доступ к соответствующему сайту SharePoint, списку, библиотеке, элементу или файлу.
Требования и поддерживаемые области
- Ретранслятор оповещений поддерживает SharePoint Online. SharePoint Server локальной среде не поддерживается.
- Действия выполняются при вызове Power Automate или другом поддерживаемом клиенте. Для уведомлений об изменениях используйте соответствующий триггер SharePoint для запуска потока.
- Сравнения с помощью маркеров триггера SharePoint основаны на окне триггера SharePoint. Результирующий базовый план может отличаться от границы версии для конкретного элемента.
- Подробное форматирование доступно для поддерживаемых типов полей SharePoint. См. документацию по ретранслятору оповещений для текущей ссылки на тип поля.
Support
Сайт: https://independnet.com.au/alert-relay/
Поддержка: https://independnet.com.au/alert-relay/support
Адрес электронной почты: support@alertrelay.com.au
Конфиденциальности: https://independnet.com.au/alert-relay/privacy
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя. | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение подробных изменений элементов |
Извлекает подробные, отформатированные изменения на уровне поля для элемента списка SharePoint или документа, сравнивая текущую версию с предыдущей версией. Используйте это, если требуется расширенные данные об изменении, а не встроенные флаги полей в стиле SharePoint true/false. |
| Получение подробных оповещений об оповещении элементов |
Возвращает готовые к использованию HTML-коды ретранслятора оповещений для SharePoint для изменений элементов, предназначенных в основном для сообщений оповещений в стиле SharePoint, но и для использования в документах или других назначениях с поддержкой HTML. |
| Синтаксический анализ из |
Декодирует маркер изменения TriggerWindowStartToken или необработанный маркер изменений SharePoint и возвращает внедренную метку времени для условий потока и базовых решений. Это действие не вызывает SharePoint. |
Получение подробных изменений элементов
Извлекает подробные, отформатированные изменения на уровне поля для элемента списка SharePoint или документа, сравнивая текущую версию с предыдущей версией. Используйте это, если требуется расширенные данные об изменении, а не встроенные флаги полей в стиле SharePoint true/false.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
URL-адрес сайта
|
siteUrl | True | string |
Полный URL-адрес сайта SharePoint, содержащего список или библиотеку (например, |
|
Список или библиотека
|
listId | True | string |
GUID или точное название списка или библиотеки SharePoint. Раскрывающийся список возвращает значения GUID, но запись вручную может использовать GUID или точное название списка. |
|
Код товара
|
itemId | True | integer |
Идентификатор элемента или файла SharePoint для анализа изменений (доступный из выходных данных триггера в качестве идентификатора). |
|
Сравнение из
|
triggerWindowStartToken | string |
Определяет начальную точку сравнения изменений. Принимает триггер SharePoint {TriggerWindowStartToken} (рекомендуется), метку версии, например "5.0", необработанный маркер изменения SharePoint или базовый код ISO 8601, например "2026-03-30" или "2026-03-03-30T14:15:00Z". Значения только даты интерпретируются как полуночи в выбранном часовом поясе или в формате UTC, если часовой пояс пуст. Опустить сравнение с немедленной предыдущей версией. |
|
|
Включение дополнительных версий
|
includeMinorVersions | boolean |
Следует ли использовать дополнительные или черновики версий в сравнении. По умолчанию используется значение false, то есть используются только основные версии. |
|
|
Включение без изменений полей
|
includeUnchangedFields | boolean |
Следует ли включать в ответ без изменений поля. По умолчанию используется значение true. |
|
|
Формат даты
|
dateFormat | string |
Настраиваемый формат даты для полей DateTime (например, "гггг-ММ-дд", "dd/MM/гггг", "ММ/гггг", "MM/dd/гггг". По умолчанию значение yyyy-MM-dd, если оно не указано. |
|
|
Формат времени
|
timeFormat | string |
Формат времени, добавленный к дате полей DateTime с временем (например, HH:mm:ss, HH:mm, hh:mm). Значение по умолчанию — HH:mm:ss, если оно не указано. |
|
|
Timezone
|
timezone | string |
Идентификатор часового пояса IANA для преобразования даты и времени (например, "Америка/New_York", "Европа/Лондон", "Австралия/Сидней". По умолчанию используется время UTC, если не указано. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Success
|
success | boolean |
Указывает, успешно ли выполнена операция |
|
Message
|
message | string |
Читаемое человеком сообщение, описывающее результат |
|
Измененные поля
|
changedFields | array of object |
Отслеживаемые поля в виде массива. |
|
Значение столбца изменилось
|
changedFields.hasChanged | boolean |
Значение true, если значение этого поля изменилось между предыдущей и текущей версией |
|
Предыдущее значение столбца (текст)
|
changedFields.previousAsString | string |
Форматирование предыдущего значения в виде строки, доступной для чтения человеком |
|
Внутреннее имя поля
|
changedFields.internalName | string |
Имя внутреннего поля SharePoint |
|
Имя поля
|
changedFields.displayName | string |
Понятное отображаемое имя поля |
|
Предыдущее значение столбца (подробно)
|
changedFields.previous |
Необработанное предыдущее значение. Это свойство является динамическим и может быть строкой, числом, логическим значением, объектом, массивом или null в зависимости от типа поля SharePoint. |
|
|
Текущее значение столбца (текст)
|
changedFields.currentAsString | string |
Форматируемое текущее значение в виде удобочитаемой для человека строки |
|
Текущее значение столбца (подробно)
|
changedFields.current |
Необработанное текущее значение. Это свойство является динамическим и может быть строкой, числом, логическим значением, объектом, массивом или null в зависимости от типа поля SharePoint. |
|
|
Имеет базовые показатели сравнения
|
hasComparisonBaseline | boolean |
Значение true, если для сравнения с текущей версией разрешена отдельная базовая версия. |
|
Базовая первая версия
|
isBaselineFirstVersion | boolean |
Значение true, если разрешенная базовая версия является первой версией, записываемой для элемента или файла. |
|
Текущая метка версии
|
currentVersionLabel | string |
Метка версии текущей версии (например, "2.0", "5.0" ) |
|
Предыдущая метка версии
|
previousVersionLabel | string |
Метка версии, используемая для сравнения (например, "1.0", "4.0" ) |
|
Название элемента
|
itemTitle | string |
Заголовок измененного элемента |
|
URL-адрес элемента
|
itemUrl | string |
Прямая ссылка на измененный элемент SharePoint |
|
Дата изменения
|
modifiedDate | date-time |
Метка времени последнего изменения |
|
Изменено
|
modifiedBy | string |
Отображаемое имя пользователя, который последний раз изменил элемент |
|
Error
|
error | string |
Сведения об ошибке, если успешное выполнение равно false |
Получение подробных оповещений об оповещении элементов
Возвращает готовые к использованию HTML-коды ретранслятора оповещений для SharePoint для изменений элементов, предназначенных в основном для сообщений оповещений в стиле SharePoint, но и для использования в документах или других назначениях с поддержкой HTML.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
URL-адрес сайта
|
siteUrl | True | string |
Полный URL-адрес сайта SharePoint, содержащего список или библиотеку. |
|
Список или библиотека
|
listId | True | string |
GUID или точное название списка или библиотеки SharePoint. Раскрывающийся список возвращает значения GUID, но запись вручную может использовать GUID или точное название списка. |
|
Код товара
|
itemId | True | integer |
Идентификатор элемента или файла SharePoint для анализа изменений. |
|
Сравнение из
|
triggerWindowStartToken | string |
Определяет начальную точку сравнения изменений. Принимает триггер SharePoint {TriggerWindowStartToken} (рекомендуется), метку версии, например "5.0", необработанный маркер изменения SharePoint или базовый код ISO 8601, например "2026-03-30" или "2026-03-03-30T14:15:00Z". Значения только даты интерпретируются как полуночи в выбранном часовом поясе или в формате UTC, если часовой пояс пуст. Опустить сравнение с немедленной предыдущей версией. |
|
|
Включение дополнительных версий
|
includeMinorVersions | boolean |
Следует ли использовать дополнительные или черновики версий в сравнении. По умолчанию используется значение false, то есть используются только основные версии. |
|
|
Включение без изменений полей
|
includeUnchangedFields | boolean |
Следует ли включать неизмененным полям в созданный HTML-код. По умолчанию используется значение true. |
|
|
Формат даты
|
dateFormat | string |
Настраиваемый формат даты для полей DateTime (например, yy-MM-dd, dd/MM/гггг). По умолчанию значение yyyy-MM-dd, если оно не указано. |
|
|
Формат времени
|
timeFormat | string |
Формат времени, добавленный к дате полей DateTime с временем (например, HH:mm:ss, HH:mm, hh:mm). |
|
|
Timezone
|
timezone | string |
Идентификатор часового пояса IANA для преобразования даты и времени (например, "Америка/New_York", "Европа/Лондон", "Австралия/Сидней". |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Success
|
success | boolean |
Указывает, успешно ли выполнена операция |
|
Message
|
message | string |
Читаемое человеком сообщение, описывающее результат |
|
Текст HTML
|
htmlBody | string |
Полный текст HTML, готовый к использованию в сообщениях электронной почты оповещений или других назначениях с поддержкой HTML |
|
Рекомендуемая тема
|
subject | string |
Рекомендуемая строка темы для оповещения |
|
Название элемента
|
itemTitle | string |
Заголовок измененного элемента |
|
URL-адрес элемента
|
itemUrl | string |
Прямая ссылка на измененный элемент SharePoint |
|
Новый элемент
|
isNewItem | boolean |
Значение true, если оповещение предназначено для нового элемента или файла SharePoint, а не для обновления существующего элемента. |
|
Error
|
error | string |
Сведения об ошибке, если успешное выполнение равно false |
Синтаксический анализ из
Декодирует маркер изменения TriggerWindowStartToken или необработанный маркер изменений SharePoint и возвращает внедренную метку времени для условий потока и базовых решений. Это действие не вызывает SharePoint.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Сравнение из
|
compareFrom | True | string |
ТриггерWindowStartToken или необработанный маркер изменения SharePoint для декодировать. Метки версий и значения даты и даты и даты и времени ISO не поддерживаются этим действием. |
|
Timezone
|
timezone | string |
Необязательный идентификатор часового пояса IANA для локального значения сравнения (например, "Америка/New_York", "Европа/Лондон", "Австралия/Сидней". Если опущено, возвращается только значение UTC. |
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Время даты токена в формате UTC
|
tokenDateTimeUTC | date-time |
Метка времени токена в формате UTC. |
|
Локальный локальный период даты маркера
|
tokenDateTimeLocal | date-time |
Метка времени маркера, преобразованная в запрошенный часовой пояс. |
|
Декодированные маркеры
|
decodedToken | string |
Декодированный текст необработанного маркера. Для ввода необработанного маркера это соответствует исходному значению. |
|
Является токеном Base64
|
isBase64Token | boolean |
Значение True, если входящие маркеры были закодированы в кодировке Base64. |
|
Sequence
|
sequence | integer |
Значение последовательности изменений SharePoint, внедренное в токен. |
|
Идентификатор GUID списка
|
listGuid | uuid |
Список или GUID библиотеки, внедренный в маркер. |
|
Версия токена
|
tokenVersion | integer |
Номер версии токена. |
|
Тип маркера
|
tokenType | integer |
Номер типа токена SharePoint. |
|
Error
|
error | string |
Сведения об ошибке при сбое синтаксического анализа. |