Руководство: Создание и активация правила Fabric Activator

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

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

Предварительные условия

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

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

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

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

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

  3. В разделе "Создание" в разделе "Аналитика Real-Time" выберите "Активация данных".

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

  4. В активаторе нажмите кнопку "Попробовать пример".

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

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

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

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

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

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

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

Исследуйте правило

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        Замечание

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

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

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

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

      1. Выберите действие Teams -->Сообщение отдельным лицам или Сообщение в групповом чате, или Сообщение в канале.
      2. Выполните одно из следующих действий в зависимости от выбранного варианта.
        • Если вы выбрали параметр "Сообщение для отдельных лиц ", введите адреса электронной почты получателей или используйте раскрывающийся список, чтобы выбрать свойство, значение которого является адресом электронной почты. При выполнении условия сообщение Teams отправляется указанным лицам.
        • Если выбран параметр сообщения группового чата , выберите групповой чат в раскрывающемся списке. При выполнении условия сообщение публикуется в групповом чате.
        • Если выбран параметр публикации канала , выберите команду и канал из раскрывающихся списков. При выполнении условия сообщение публикуется в выбранном канале.
      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. Правило выполняется против потока событий доставки пакетов. Правило ищет пакеты с медикаментами и проверяет, превышает ли температура в настоящее время 20 градусов по Цельсию. Когда температура становится больше 20 градусов Цельсия, отправляется сообщение Teams.

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

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

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

  1. Выберите слишком опасно для медицины.

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

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

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

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

  4. Выберите Пуск. Это действие активирует правило. Вы получаете сообщение в Microsoft 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 см. в следующем разделе: