.. _tags-settings: Настройки тэгов ====================================== Для просмотра и редактирования настроек тэгов необходимо на странице с настройками выбрать пункт меню ``Тэги`` или перейти по адресу: ``{адрес:порт}/settings/tags``. Откроется страница, на которой находится таблица, содержащая все добавленные тэги. .. image:: img/tags-settings-list.png :scale: 51 :align: center :alt: Настройки тэгов .. _tags-settings-add: Добавление нового тэга ------------------------------- Для добавления нового тэга необходимо на странице с настройками тэгов нажать кнопку ``Добавить``. Откроется страница с формой для добавления нового тэга. .. image:: img/tags-settings-add.png :scale: 100 :align: center :alt: Добавление нового тэга На форме находятся две вкладки: - :ref:`tags-settings-tag` - :ref:`tags-settings-rules` .. _tags-settings-tag: Тэг ~~~~~~~~~~~~~~~~ На вкладке ``Тэг`` находятся поля для ввода настроек тэга. .. note:: Описание параметров тэгов см. :ref:`tags-settings-tag-parameters`. .. image:: img/tags-settings-tag.png :scale: 100 :align: center :alt: Вкладка 'Тэг' Для сохранения введенных параметров нажмите кнопку ``Сохранить``. В случае если сохранять введенные данные не требуется, нажмите кнопку ``Отмена``. .. _tags-settings-rules: Правила определения тэга ~~~~~~~~~~~~~~~~~~~~~~~~~ На вкладке ``Правила определения тэга`` находится таблица с правилами определения данного тэга. Вкладка становится доступной после сохранения тэга на вкладке ``Тэг``. .. image:: img/tags-settings-rules.png :scale: 39 :align: center :alt: Вкладка 'Правила определения тэга' .. note:: Тэги без правил, если определены, применяются к документам, которым не были назначены другие тэги. Добавление нового правила ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Для добавления нового правила нажмите кнопку ``Добавить``. Откроется страница с формой для добавления нового правила. Заполните поля с параметрами правила. .. note:: Описание параметров правил определения тэгов см. :ref:`tags-settings-rules-parameters`. .. image:: img/tags-settings-rules-add.png :scale: 100 :align: center :alt: Добавление нового правила Для изменения поля ``Значения`` нужно нажать кнопку |settings-icon|. После этого откроется окно с выбором значения. .. image:: img/tags-settings-rules-values.png :scale: 100 :align: center :alt: Выбор значения После выбора необходимого типа значения отобразится таблица со значениями. .. image:: img/tags-settings-rules-values-type.png :scale: 100 :align: center :alt: Выбор типа значения Для добавления нового значения необходимо нажать кнопку ``Добавить``. Для удаления значения необходимо нажать кнопку ``Удалить``. Для сохранения всех введенных параметров нажмите кнопку ``Сохранить``. В случае если сохранять введенные данные не требуется, нажмите кнопку ``Отмена``. Изменение правила ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Для изменения правила нужно на странице с правилами в таблице выбрать необходимое правило и нажать кнопку ``Изменить``. Откроется страница с формой для изменения правила. Данная форма аналогична форме добавления нового правила. Удаление правила ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Для удаления правила нужно на странице с правилами в таблице выбрать необходимое правило и нажать кнопку ``Удалить``. Появится всплывающее окно с подтверждением удаления. Изменение добавленного тэга ------------------------------------ Для изменения тэга нужно на странице с настройками тэгов в таблице выбрать необходимый тэг и нажать кнопку ``Изменить``. Откроется страница с формой для изменения тэга. .. image:: img/tags-settings-update.png :scale: 100 :align: center :alt: Форма изменения тэга Данная форма аналогична форме добавления нового тэга. Подробное описание порядка действий с формой см. :ref:`tags-settings-add`. Удаление добавленного тэга ----------------------------------- Для удаления тэга нужно на странице с настройками тэгов в таблице выбрать необходимый тэг и нажать кнопку ``Удалить``. Появится всплывающее окно с подтверждением удаления. .. image:: img/tags-settings-delete-confirmation.png :scale: 100 % :align: center :alt: Подтверждение удаления тэга .. note:: Нельзя удалить тэг, если он используется для документов. Перевод тэга в режим "только для чтения" -------------------------------------------------- Если тэг уже используется для документов, то изменение его параметров может привести к ошибкам при анализе исторических данных. Для устранения указанных проблем для тэгов доступен перевод в режим "только для чтения". После перевода тэга в режим "только для чтения" его редактирование будет невозможно. Для перевода тэга в режим "только для чтения" нужно на странице с настройками тэгов в таблице выбрать необходимый тэг и нажать кнопку ``Только для чтения``. Появится всплывающее окно с подтверждением. Для перевода в режим "только для чтения" нажмите кнопку ``Да``. .. image:: img/tags-settings-readonly.png :scale: 100 % :align: center :alt: Подтверждение перевода тэга в режим "только для чтения" .. note:: Данное действие необратимо. После перевод тэга в режим "только для чтения" его уже нельзя будет вернуть в режим редактирования. После перевода тэга в режим "только для чтения" доступен только просмотр настроек тэга без возможности его редактирования. Для просмотра настроек тэга нужно на странице с настройками тэгов в таблице выбрать необходимый тэг и нажать кнопку ``Просмотр``. Откроется страница с формой для просмотра настроек тэга. .. image:: img/tags-settings-show.png :scale: 100 % :align: center :alt: Просмотр тэга Включение или выключение тэга в режиме "только для чтения" ------------------------------------------------------------------------ В режиме "только для чтения" редактирование тэга недоступно. Для включения или выключения тэга нужно на странице с настройками тэгов в таблице выбрать необходимый тэг и нажать кнопку ``Включить`` или ``Выключить`` в зависимости от текущего состояния тэга. .. _tags-settings-tag-parameters: Параметры тэгов ------------------------ Описание параметров тэгов приведено в таблице ниже. .. list-table:: Параметры тэгов :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Значение тэга - Значение тэга (т.е. сам тэг) - Да * - Описание - Описание тэга - Да * - Используется - Признак того, что тэг используется - Да .. _tags-settings-rules-parameters: Параметры правил определения тэгов ----------------------------------- Описание параметров правил определения тэгов приведено в таблице ниже. .. list-table:: Правила определения тэгов :widths: 10 40 10 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Выражение - Выражение для правила определения тэга - Да * - Аргумент выражения - Аргумент выражения, если для выражения требуется аргумент (например, XPath-выражение) - Нет * - Результат выражения - Доступны два варианта: * "Любой" - оператор вернет успешный резльтутат, если условие выполнено хотя бы для одного из элементов коллекции, которую вернуло выражение; * "Все" - оператор вернет успешный резльтутат, если условие выполнено для всех элементов коллекции, которую вернуло выражение. Применимо для выражений, возвращающих коллекции. Не применимо для скалярных выражений. - Да * - Оператор - Оператор для правила определения тэга - Да * - Значения - Значения для правила определения тэга - Да .. |settings-icon| image:: img/settings-icon.png