Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения: Azure Logic Apps (стандартная версия)
Словарь — это коллекция определений словаря, которые используют понятные имена для фактов, используемых в условиях правила и действиях. Определения словаря упрощают чтение, понимание и совместное использование правил несколькими людьми в определенном бизнес-домене. Например, разработчики инструментов, ответственные за интеграцию разработки правил в новые или существующие приложения, могут использовать словари. Словари повысят разрыв между семантикой бизнеса и реализацией.
В этом руководстве показано, как создавать и определять словари, размещенные в общем хранилище правил с помощью Microsoft Rules Composer. Можно выбрать источники данных для использования, создать новый словарь и добавить определения словаря. Вы можете сохранить версию словаря в хранилище правил.
Необходимые компоненты
Скачайте и установите Microsoft Rules Composer.
XML-файл, содержащий хранилище правил, в котором требуется добавить словарь.
Как словарь упрощает чтение и понимание правил?
Термины, используемые для определения условий правил и действий, часто выражаются с помощью доменных или отраслевых nomenclature. Например, пользователь электронной почты записывает правила с помощью таких терминов, как "сообщения, полученные от" и "полученные после". Аналитик страхового бизнеса пишет правила с помощью таких терминов, как "факторы риска" и "сумма покрытия".
В качестве другого примера переменная для состояния утверждения может указывать на определенное значение в схеме XML. Вместо вставки этого сложного представления в правило можно создать определение словаря, связанное с этим значением переменной, и использовать "Состояние" в качестве понятного имени. Затем можно использовать "Состояние" в любом количестве правил. Артефакты технологий, такие как XML-объекты и XML-документы, реализующие условия правила и действия правил, лежат в этой терминологии для конкретного домена. Однако обработчик правил может получить соответствующие данные из таблицы, в которой хранятся эти данные.
Условия и действия правил основаны на источниках данных, которые могут иметь подробные, трудночитаемые сведения о привязке, которые сообщают пользователю мало или ничего о том, что ссылается на привязки. Подсистема правил позволяет создавать словари, упрощающие разработку правил, предлагая интуитивно понятные термины для конкретного домена, которые можно связать с условиями и действиями правила.
Создание словаря
Откройте microsoft Rules Composer. В меню "Хранилище правил" выберите "Загрузить".
Найдите и выберите XML-файл, содержащий хранилище правил, над которым вы хотите работать.
В окне обозревателя фактов выберите вкладку "Словарь".
На вкладке "Словари" найдите папку "Словарь".
Откройте контекстное меню папки и нажмите кнопку "Добавить новый словарь".
Microsoft Rules Composer создает новый пустой словарь с номером 1.0 в качестве версии по умолчанию.
Прежде чем использовать словарь, словарь должен иметь метку версии. Это требование гарантирует, что определения словаря не изменятся и сохраняют целостность ссылок, что означает, что любые наборы правил, использующие эту конкретную версию, не неожиданно завершаются ошибкой из-за изменений в базовом словаре.
В следующей таблице описаны другие сочетания клавиш, которые можно использовать для работы с словарями:
| Команда ярлыка | Задача |
|---|---|
| Добавление новой версии | Создайте новую пустую версию словаря из выбранного словаря. Вы можете скопировать определения словаря из других версий словаря и вставить их в новую версию. |
| Вставка версии словаря | В выбранном словаре вставьте ранее скопированные определения словаря из другой версии словаря в качестве новой версии. |
| Удаление | Удалите выбранный словарь и все его версии. |
В следующей таблице описаны другие сочетания клавиш, которые можно использовать для работы с версиями словаря:
| Команда ярлыка | Задача |
|---|---|
| Добавление нового определения | Запустите мастер определения словаря, чтобы создать новое определение в выбранной версии словаря. |
| Сохранить | Сохраните изменения, внесенные в выбранную версию словаря и ее определения. |
| Перезаряжать | Перезагрузите выбранную версию словаря и ее определения, включая параметр отмены текущих изменений, внесенных в этой версии, и восстановите содержимое из хранилища правил. |
В следующей таблице описаны другие сочетания клавиш, которые можно использовать для работы с версиями словаря:
| Команда ярлыка | Задача |
|---|---|
| Изменение | Запустите мастер определения словаря, чтобы изменить выбранное определение. |
| Перейти к исходному факту | Для выбранного определения словаря перейдите к соответствующему исходному факту в сборке .NET или схеме XML. |
| Команда ярлыка | Задача |
|---|---|
| Выбор корневого узла | В схеме XML, содержащей несколько корневых узлов, выберите корневой узел для загрузки. |
В следующих разделах приведены дополнительные сведения об этих задачах.
Копирование версии словаря
Если вы хотите внести изменения в словарь, создайте новую версию словаря, чтобы отразить изменения. Вы можете создать копию из существующей версии словаря, но с другим номером версии.
В окне обозревателя фактов откройте контекстное меню версии словаря и выберите "Копировать".
Откройте контекстное меню словаря и выберите " Вставить версию RuleSet".
Microsoft Rules Composer создает новую версию словаря с теми же определениями, что и скопированная версия, но с другим числом.
Внимание
При создании новой версии словаря правила, созданные с использованием предыдущей версии словаря, по-прежнему ссылались на предыдущую версию. Обязательно обновите ссылки между этими правилами и новой версией словаря.
Создание пустой версии словаря
После добавления определений в версию словаря можно создать новую пустую версию словаря с другим номером и сохранить эту версию, чтобы она работала позже.
В окне обозревателя фактов выберите вкладку "Словарь".
На вкладке "Словари" найдите словарь, из которого нужно создать новую версию.
Откройте контекстное меню словаря и выберите команду "Добавить новую версию".
Microsoft Rules Composer создает новую пустую версию словаря с другим номером.
Откройте контекстное меню новой версии словаря и нажмите кнопку "Сохранить".
Теперь вы можете скопировать определения словаря из других версий словаря и вставить их в новую версию.
Переименование словаря
Прежде чем переименовать словарь или набор правил, необходимо сохранить все, что означает все версии определений словаря.
В окне обозревателя фактов выберите вкладку "Словарь".
На вкладке "Словари" в папке "Словари" найдите словарь, который требуется переименовать.
Выберите словарь и в окне "Свойства " измените имя.
Создание определения словаря
Определение словаря можно создать в виде константного значения, диапазона значений, набора значений или элементов из сборки .NET или XML-документа. Чтобы создать определение словаря, можно использовать мастер определения словаря.
Кроме того, можно создать новое определение словаря, выбрав факт на вкладке классов .NET или на вкладке "Схемы XML", например или в элементе класса .NET, перетаскивая факт на вкладку "Словари".
— например, XML-узел,
Если выбрать общедоступную переменную, параметры Get и Set по-прежнему доступны, как и в мастере определения XML.
Добавление константного значения в качестве определения словаря
На вкладке "Словари" в папке "Словари".
В папке "Словарь" откройте контекстное меню для нужной версии словаря.
В контекстном меню версии словаря выберите "Добавить новое определение".
Вы также можете перетаскивать элементы с вкладки классов .NET и вкладки "Схемы XML".
Мастер определения словаря запускается для создания определения.
В мастере выберите константное значение, диапазон значений или набор значений, а затем нажмите кнопку "Далее".
Введите следующую информацию:
Свойство Описание Имя определения Имя определения. Описание Описание определения. Тип определения Для этой задачи выберите константное значение. Затем нажмите кнопку Далее.
Введите следующую информацию:
Свойство Описание Тип определения Выберите системный тип данных для определения. Отображаемое имя Введите имя, которое не превышает 512 символов. Ценность Введите значение константы. По завершении нажмите кнопку "Готово".
Добавление диапазона значений в виде определения словаря
На вкладке "Словари" в папке "Словари".
В папке "Словарь" откройте контекстное меню для нужной версии словаря.
В контекстном меню версии словаря выберите "Добавить новое определение".
Вы также можете перетаскивать элементы с вкладки классов .NET и вкладки "Схемы XML".
Мастер определения словаря запускается для создания определения.
В мастере выберите константное значение, диапазон значений или набор значений, а затем нажмите кнопку "Далее".
Введите следующую информацию:
Свойство Описание Имя определения Имя определения. Описание Описание определения. Тип определения Для этой задачи выберите диапазон значений. Затем нажмите кнопку Далее.
В списке типов определения выберите системный тип данных для определения.
В разделе Шаг 1. Укажите отображаемое имя и значение для диапазона "Низкий" и "Высокий диапазон", в таблице выберите "Низкий диапазон", а затем нажмите кнопку "Изменить".
В открываемом поле "Определение параметра" доступно только параметр "Использовать константное значение ".
Введите константное значение, чтобы указать нижний диапазон и нажмите кнопку "ОК".
Повторите предыдущие шаги для диапазона High, которые должны превышать значение Range Low .
В разделе Шаг 2. Укажите строку формата отображения для диапазона в свойстве строки формата отображения введите строку формата отображения. Чтобы вернуться к строке формата отображения по умолчанию, выберите default.
Примечание.
Убедитесь, что строка формата содержит индексы параметров с помощью фигурных скобок, например использовать
{0}и{1}служить заполнителями для параметров высокого и низкого диапазона.В следующем примере показан пример определения словаря для диапазона значений:
Затем нажмите кнопку Готово.
Добавление набора значений в качестве определения словаря
На вкладке "Словари" в папке "Словари".
В папке "Словарь" откройте контекстное меню для нужной версии словаря.
В контекстном меню версии словаря выберите "Добавить новое определение".
Вы также можете перетаскивать элементы с вкладки классов .NET и вкладки "Схемы XML".
Мастер определения словаря запускается для создания определения.
В мастере выберите константное значение, диапазон значений или набор значений, а затем нажмите кнопку "Далее".
Введите следующую информацию:
Свойство Описание Имя определения Имя определения. Описание Описание определения. Тип определения Для этой задачи выберите набор значений. Затем нажмите кнопку Далее.
Введите следующую информацию:
Свойство Описание Тип определения Выберите системный тип данных для определения. Отображаемое имя Введите имя, которое не превышает 512 символов. В разделе "Определение значений" доступен только параметр "Использовать константное значение ".
Чтобы добавить член в набор, введите постоянное значение и нажмите кнопку "Добавить".
Повторите предыдущий шаг для количества значений, которые необходимо включить в набор.
В следующем примере показаны несколько значений в наборе:
Чтобы переместить значение в относительном порядке набора, в поле "Значения " выберите значение и нажмите кнопку "Вверх " или "Вниз".
Чтобы удалить элемент из набора, в поле "Значения " выберите значение и нажмите кнопку "Удалить".
После завершения набора нажмите кнопку "Готово".
Добавление класса или члена класса .NET в качестве определения словаря
Перед началом работы обязательно поместите сборки .NET в локальный каталог в Microsoft Rules Composer. При обновлении сборки .NET обязательно обновите ссылки на версию набора правил на эту сборку. Дополнительные сведения см. в статье Об обновлении ссылок на сборки .NET.
На вкладке "Словари" в папке "Словари".
В папке "Словарь" откройте контекстное меню для нужной версии словаря.
В контекстном меню версии словаря выберите "Добавить новое определение".
Можно также перетащить класс или член класса .NET на вкладке классов .NET.
Мастер определения словаря запускается для создания определения.
В мастере выберите класс .NET или член класса, а затем нажмите кнопку "Далее".
Введите следующую информацию:
Свойство Описание Имя определения Имя определения. Описание Описание определения. В разделе сведений о члене класса нажмите кнопку "Обзор".
Найдите и выберите нужную сборку, а затем нажмите кнопку "Открыть".
В поле "Выбор привязки" разверните узел сборки.
Выберите класс или разверните класс и выберите член класса, а затем нажмите кнопку "ОК".
Выберите один из следующих шагов:
Если выбрать класс, для отображаемого имени введите имя, которое не превышает 512 символов, и нажмите кнопку "Готово".
Теперь вы закончите работу с этим разделом.
Если выбрать член класса с параметрами, нажмите кнопку "Далее".
Откроется страница " Указать отображаемое имя " Класс .NET или определение члена класса", чтобы указать значение и строку формата отображения для каждого параметра.
В разделе Шаг 1. Укажите отображаемое имя и значение для каждого параметра в поле "Параметры", выберите параметр и нажмите кнопку "Изменить".
Для значения параметра доступен только параметр "Использовать константное значение ", поэтому введите константное значение.
В разделе "Шаг 2. Укажите строку формата отображения в свойстве строки формата отображения" введите строку формата отображения. Чтобы вернуться к строке формата отображения по умолчанию, выберите default.
Примечание.
Убедитесь, что строка формата содержит индексы параметров с помощью фигурных фигурных скобок, например использовать
{0}и{1}служить заполнителями для параметров.Повторите предыдущие шаги для каждого параметра в члене класса.
В следующем примере показаны несколько параметров в элементе класса:
Создание определения словаря из сборки .NET
Определения словаря можно создавать из классов или членов классов в сборке .NET для определения предикатов, аргументов и действий. Перед началом работы обязательно поместите сборки .NET в локальный каталог в Microsoft Rules Composer. При обновлении сборки .NET обязательно обновите ссылки на версию набора правил на эту сборку. Дополнительные сведения см. в статье Об обновлении ссылок на сборки .NET.
В окне обозревателя фактов перейдите на вкладку классов .NET.
В разделе "Сборки .NET" перетащите класс или член класса в существующее определение словаря, которое отображается на вкладке "Словари ".
Создание определения словаря из элемента или атрибута XML-документа
Определения словаря можно создавать из XML-элементов и атрибутов, просматривая схемы XSD и перетаскивая элементы в редактор условий или редактор действий, чтобы определить предикаты, аргументы и действия.
На вкладке "Словари" в папке "Словари".
В папке "Словарь" откройте контекстное меню для нужной версии словаря.
В контекстном меню версии словаря выберите "Добавить новое определение".
Мастер определения словаря запускается для создания определения.
В мастере выберите элемент или атрибут XML-документа, а затем нажмите кнопку "Далее".
Введите следующую информацию:
Свойство Описание Имя определения Имя определения. Описание Описание определения. В разделе сведений о XML-документе нажмите кнопку "Обзор".
Найдите и выберите файл схемы (XSD) и выберите элемент документа или атрибут.
В списке "Тип " выберите тип, совместимый с типом выбранного элемента или атрибута из схемы.
Примечание.
Модуль не проверяет существование определенного элемента и тип документа. Если вы утверждаете XML-документ, который не имеет элемента, вы получите ошибку во время выполнения. Если вы утверждаете XML-документ с неизвестным типом документа, подсистема просто игнорирует документ.
Если подсистема не может выполнить допустимый приведение между указанным типом и типом выбранного элемента документа или атрибута, возникает ошибка во время выполнения.
В разделе "Выбор операции" выберите тип операции, указывающий, планируется ли получить значение элемента или атрибута или задать это значение.
Если вы решили задать значение, нажмите кнопку "Далее" и укажите формат отображения.
Откроется страница "Указать отображаемое имя" — элемент XML-документа или страницу атрибутов , чтобы указать значение и строку формата отображения для использования.
В разделе Шаг 1. Укажите отображаемое имя и значение для каждого параметра в поле "Параметры", выберите параметр и нажмите кнопку "Изменить".
Для значения параметра доступен только параметр "Использовать константное значение ", поэтому введите константное значение.
В разделе "Шаг 2. Укажите строку формата отображения в свойстве строки формата отображения" введите строку формата отображения. Чтобы вернуться к строке формата отображения по умолчанию, выберите default.
Примечание.
Убедитесь, что строка формата содержит индексы параметров с помощью фигурных фигурных скобок, например использовать
{0}и{1}служить заполнителями для параметров.
По завершении нажмите кнопку "Готово".
В следующем примере показаны сведения о определении словаря на основе элемента или атрибута XML-документа:
При создании определений словаря для XML-узлов выражения XPath для привязок имеют аналогичные значения по умолчанию на основе правил, описанных ранее. Однако эти значения можно изменить в мастере определения словаря. Изменения выражений помещаются в определение словаря и отражаются в любых аргументах правил, создаваемых из определений словаря.
