Поделиться через


Учебник: Создание и активация правила Fabric Activator

Активатор Fabric в Microsoft Fabric позволяет выполнять действия при обнаружении шаблонов или условий в потоках данных. Если вы не знакомы с Активатором Fabric, прочитайте раздел Что такое Активатор Fabric. В этом руководстве вы используете примеры данных, включенные в Активатор Fabric, для выполнения следующих задач:

  • Просмотр примера активатора
  • Изучение данных
  • Изучение правила
  • Запуск правила
  • Создайте объект
  • Создание правила

Необходимые компоненты

Прежде чем приступить к работе, вам потребуется рабочая область с емкостью Fabric. Сведения о рабочих областях Fabric см. в статье "Рабочие области". Если у вас нет Fabric, вам будет предложено начать пробную версию.

Создание примера активатора

  1. Перейдите на портал Fabric.

  2. В области навигации слева выберите многоточие (...), а затем нажмите кнопку "Создать".

    Снимок экрана: левая панель навигации с выбранным элементом

  3. На странице Create в разделе Real-Time Intelligence выберите Data Activator.

    Снимок экрана: страница

  4. На странице "Активация" выберите "Попробовать пример".

    Снимок экрана: параметр добавления данных или использования примеров данных.

Изучение данных

На этом шаге мы рассмотрим данные потока событий, на основе этого примера.

Новый активатор содержит раздел Обозревателя . Прокрутите вниз и выберите поток событий доставки пакета.

снимок экрана активатора с выбранным потоком событий доставки пакета.

Эти события показывают состояние пакетов в режиме реального времени, которые находятся в процессе доставки.

Просмотрите входящие события и наведите указатель мыши на данные события в динамической таблице. Каждая точка данных содержит сведения о событии. Возможно, вам придется прокрутить все это.

Изучение правила

Используйте правило, чтобы указать значения событий, которые необходимо отслеживать, условия, которые необходимо обнаружить, и действия, которые требуется выполнить активатору Fabric.

В области обозревателя отображаются объекты, такие как потоки событий для этого активатора. события доставки — это один из объектов, созданных из событий доставки пакетов .

  1. В области обозревателя выберите объект с именем "События доставки". Вы можете создать правила о объектах, использующих данные из потока событий доставки пакета. Например, правило, проверяющее пакеты для температуры.

    Снимок экрана: таблица событий доставки и столбец температуры.

  2. Обратите внимание, что раздел "События по идентификатору объекта" организован по идентификаторупакета. Идентификатор пакета — это идентификатор столбца, который однозначно идентифицирует каждый пакет. Этот уникальный идентификатор используется для назначения событий пакета объектам package.

    Снимок экрана: уникальный столбец идентификатора на экране

  3. Выберите правило температуры, называемое слишком горячим для медицины. В правой области просмотрите область "Определение ", чтобы узнать, как работает правило.

    Снимок экрана: пример правила.

  4. В разделе "Монитор" выберите "Температура". Значения температуры получены из столбца "Температура " в таблице событий доставки. Столбец "Температура" можно просмотреть на предыдущем снимке экрана.

    Снимок экрана: раздел

  5. В разделе "Условие " отображается условие правила для мониторинга температуры, превышающей 20 градусов цельсия.

    Снимок экрана: раздел

  6. Прокрутите вниз до фильтра свойств. Наше правило применяется только к пакетам, содержащим лекарства. В таблице события доставки правило смотрит на столбец с именем содержимое специального ухода. В столбце содержания для особого ухода некоторые пакеты имеют значение Лекарство.

    Снимок экрана: раздел фильтра свойств области

  7. Наконец, прокрутите вниз до действия. Выберите одно из следующих действий, если условие выполнено:

    1. Отправка уведомления по электронной почте: Отправляет сообщение электронной почты себе или другим пользователям в вашей организации.

      1. Для действия "Выбрать" выберите "Отправить сообщение электронной почты".
      2. В поле "Кому" введите адреса электронной почты получателей или используйте раскрывающийся список, чтобы выбрать свойство, значение которого является адресом электронной почты. По умолчанию ваш адрес электронной почты заполняется здесь.
      3. В поле "Тема" введите тему уведомления по электронной почте.
      4. В поле "Заголовок" введите заголовок уведомления по электронной почте.
      5. Для заметок введите заметки для уведомления по электронной почте.

        Замечание

        При вводе темы, заголовка или заметок можно ссылаться на свойства в данных, введя @ или нажав кнопку рядом с текстовыми полями. Например: @BikepointID.

      6. В контексте выберите значения раскрывающегося списка, который нужно включить в уведомление по электронной почте.

      Снимок экрана: раздел

    2. Отправьте уведомление Microsoft Teams: Отправляет себе сообщение Microsoft Teams. Вы можете настроить содержимое заголовка и сообщения.

      1. Выберите действие Teams -->Сообщение отдельным лицам или Сообщение в групповом чате, или Сообщение в канале.
      2. Выполните одно из следующих действий в зависимости от выбранного варианта.
        • Если вы выбрали параметр "Сообщение для отдельных лиц ", введите адреса электронной почты получателей или используйте раскрывающийся список, чтобы выбрать свойство, значение которого является адресом электронной почты. При выполнении условия сообщение электронной почты отправляется указанным лицам.
        • Если выбран параметр сообщения группового чата , выберите групповой чат в раскрывающемся списке. При выполнении условия сообщение публикуется в групповом чате.
        • Если выбран параметр публикации канала , выберите команду и канал из раскрывающихся списков. При выполнении условия сообщение публикуется в выбранном канале.
      3. В поле "Заголовок" введите заголовок уведомления Teams.
      4. Для заметок введите заметки для уведомления Teams.

        Замечание

        При вводе темы, заголовка или заметок можно ссылаться на свойства в данных, введя @ или нажав кнопку рядом с текстовыми полями. Например: @BikepointID.

      5. В контексте выберите значения раскрывающегося списка, который нужно включить в уведомление Teams.

      Снимок экрана: раздел

    3. Выполнение действий Fabric: Чтобы настроить оповещение для запуска конвейера Fabric, задания Spark или записной книжки при выполнении условия, выполните следующие действия.

      1. Для выбора действия выберите "Запустить конвейер", "Выполнить задание Spark", "Запустить записную книжку" или "Выполнить функцию" (предварительная версия).

      2. Чтобы запустить элемент Select Fabric, выберите элемент Fabric (конвейер, записная книжка, задание Spark или функция) из списка.

      3. Выберите "Добавить параметр " и укажите имя параметра для элемента Fabric и значение для него. Можно добавить несколько параметров. Параметры из данных оповещения можно передать, введя @или нажав кнопку рядом с текстовым полем. Например: @BikepointID.

        Снимок экрана, показывающий раздел

    4. Пользовательские действия: Чтобы настроить оповещение для вызова настраиваемого действия при выполнении условия, выполните следующие действия:

      1. Для действия "Выбрать" выберите "Создать настраиваемое действие".

        Снимок экрана, демонстрирующий раздел

      2. Как упоминалось в разделе "Действие", сначала создайте правило, а затем завершите настройку пользовательского действия, следуя шагам из Запуск пользовательских действий (потоки Power Automate).

      3. После создания настраиваемого действия в области определения выберите настраиваемое действие в раскрывающемся списке "Выбор действия ".

    5. Нажмите кнопку "Создать", чтобы сохранить правило активатора.

Мы создали правило для Fabric Activator. Правило выполняется в потоке событий доставки пакетов. Правило ищет пакеты с медикаментами и проверяет, превышает ли температура в настоящее время 20 градусов по Цельсию. Когда температура становится больше 20 градусов Цельсия, отправляется сообщение Teams.

Ознакомьтесь с другими правилами, чтобы узнать, как они работают.

Запуск правила

Теперь вы знакомы с событиями и объектами, используемыми для создания правила. Следующим шагом является запуск правила.

  1. Выберите слишком горячий для медицины.

  2. При необходимости отправьте тестовое сообщение, выбрав Отправить мне действие теста. Сначала убедитесь, что вы получатель.

    Снимок экрана: раздел

  3. Вы должны получить сообщение, аналогичное следующему:

    Снимок экрана: пример уведомления Teams.

  4. Выберите Пуск. Это приводит к тому, что правило становится активным. Вы получаете сообщение Teams всякий раз, когда пакет медицины слишком горячий. Правило должно запускаться несколько раз в час.

    Снимок экрана: выделенная кнопка

  5. Позже можно отключить правило с помощью кнопки "Остановить " на ленте.

    Снимок экрана: кнопка

Создайте объект

Теперь пришло время создать собственный объект. В этом разделе удалите объект Package . Затем повторно создайте его для отслеживания состояния пакетов в транзитном режиме, когда часы доставки становятся больше 25.

  1. В области обозревателя щелкните правой кнопкой мыши пакет и выберите пункт "Удалить". В окне "Удалить элемент" нажмите кнопку "Удалить".

    Снимок экрана: меню Delete в объекте Package.

  2. Выберите поток событий доставки пакета и выберите новый объект на ленте.

    Снимок экрана: кнопка

  3. В панели Build object справа выполните следующие действия:

    1. Назовите новый объект Package2.

    2. Выберите PackageId в качестве уникального идентификатора.

    3. Выберите HoursInTransit и City в качестве свойств объекта.

    4. Нажмите кнопку создания.

      Снимок экрана: панель объектов Build.

Создание нового правила

Создайте правило, которое оповещает вас, если время транзита в доставке превышает пороговое значение.

  1. Выберите новое свойство HoursInTransit . На ленте выберите новое правило.

    Снимок экрана: кнопка

  2. В области определения выполните следующие действия.

    1. Для монитора выберите атрибут для мониторинга и при необходимости добавьте фильтры.

    2. Для условия выберите тип и случай.

    3. Для действия выберите один из вариантов отправки сообщения в Teams или по электронной почте.

    4. Нажмите кнопку "Сохранить".

      Снимок экрана: область определения.

  3. Правило должно отображаться под HoursInTransit в области навигатора. Выберите правило. В средней области выберите значок карандаша в верхней части и измените имя на Среднее время транзита сверх целевого.

    Снимок экрана: значок карандаша для изменения имени правила.

  4. В области определения справа выберите HoursInTransit. Затем выберите Добавить сводку>средних.

    Снимок экрана: область определения с выбранным параметром

  5. Задайте размер окна агрегирования в пять минут и размер шага в пять минут, а затем нажмите кнопку "Сохранить".

    Снимок экрана, показывающий панель определения с размером окна и шагом.

  6. Диаграмма "Монитор" обновляется, чтобы отразить суммирование, и ваша диаграмма мониторинга правил выглядит следующим образом.

    Снимок экрана диаграммы среднего транзитного времени для руководства по активатору.

  7. Проверьте правило, нажав кнопку Отправить мне тестовое действие. Убедитесь, что вы получите оповещение. При использовании электронной почты может потребоваться несколько минут.

    Снимок экрана: кнопка

  8. Запустите правило, нажав кнопку "Сохранить и начать " в области "Определение " или нажав кнопку "Пуск " на ленте.

    Снимок экрана: кнопка

    Вы создали первый объект и правило. В следующих шагах можно попытаться настроить некоторые другие правила для объекта Package2 .

    Когда вы будете готовы использовать Активатор Fabric для собственных данных, выполните действия, описанные в статье "Получение данных для Активатора Fabric".

Очистка ресурсов

Завершив работу с правилами, созданными в рамках руководства, обязательно остановите их. Если вы не отмените правила, вы и дальше будете получать уведомления о них. Вы также можете взимать плату за фоновую обработку. Выберите каждое правило в свою очередь и нажмите кнопку "Остановить " на ленте.

Дополнительные сведения о Microsoft Fabric также можно узнать: