МЕНЮ

SMART FORMS

Ведение справочников (НСИ)

SMART FORMS

В данном разделе мы рассмотрим пример создания измерения для справочника НСИ (нормативно-справочной информации), при этом воспользуемся механизмом автоматической загрузки из файл Excel, а так же настройку интерфейса для заполнения

Загрузка данных из файла Excel

Представим, что до этого момента все данные/справочники у нас велись в привычных таблицах Excel, и нам нужно создать точно такую же структуру измерений в SmartForms при этом, сделать так, чтобы вся структура измерений создалась автоматически. Это бывает удобно, когда нам нужно перенести список атрибутов из одного измерения в другой.

Сделаем это на простом примере. Для продолжения, скачайте демо-данные в формате Excel:

Download file

Файл представляет собой выгрузку из БД со списком сотрудников и номерами их документов.

Для того, чтобы автоматически создалась вся структура измерений необходимо предварительно подготовить (настроить) разметку полей в файле:

Настройка файла перед загрузкой

добавить две пустые строки в файле так, чтобы они были первыми в списке. И в них мы будем описывать необходимые нам параметры.
В первую (верхнюю) строку добавить тип данных (он может быть только один):

String - Строка
Text - Текст
Date - Дата
Integer - Целое число
Float - Дробное число
Link - Ссылка*

*Тип данных "Ссылка", ссылается на значения из других измерений. Это позволяет избежать дублирования и ускоряет процесс создания измерений.

Для такого типа данных указывается следующая запись: “Link->dim_<Идентификатор измерения на которое идет ссылка>”

В нашем случае мы ссылаемся на уже имеющееся измерение "dim_Mediastore_Dokument".

3. Для второй строки указывается свойство или свойства атрибутов (признак атрибута):

Group - Группировочный атрибут
Title - Заголовочный атрибут
KeyPart - Атрибут является частью уникального ключа
Required - Обязательный для заполнения
Unique - Значение атрибута должно быть уникальным

Если элемент содержит несколько признаков, то их следует указывать через разделитель “|”, пример “Title|KeyPart”

Признаки “Group” и “Title” взаимоисключающие, использовать вместе такие признаки атрибута нельзя.

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

Название измерения берётся из названия первого листа, загружаемого Excel, если в поле «Наименование измерения» не указано другого.

ViTalk

Виртуальный ассистент

Пример загружаемого файла

загрузка

Загрузка файла происходит в панели администратора, для этого:

В панели администрирования в разделе "Измерения" нажмите кнопку "Измерения".

2. В правой части окна нажмите кнопку "Загрузить из файла".

3. В проводнике выберите нужный Excel файл (требования к загружаемом файлу см. ниже).

4. После выбора нужного файла, автоматически начнется его загрузка.

Если название загружаемого измерения уже существует, то файл не будет загружен и не будет создано измерение. Система выдаст предупреждение.
Если есть некорректные данные, то система предупредит об этом

Для того, что бы не "потерять" загруженное измерение, включим параметр "Показывать на главном экране". Он позволяет перейти к форме (справочнику) из пользовательского интерфейса.

После того, как данные загрузились - переходим в пользовательский интерфейс

Создание вкладок и настройка правил заполнения

В боковом меню выбираем пункт "Справочники" и выбираем нужный нам справочник (Менеджеры_1).

Для того, чтобы отобразить все атрибуты, нажмите кнопку "Настройки таблицы", выберете все поля и нажмите "Сохранить". В этом окне можно как добавлять/удалять записи, так и редактировать их, то есть каким-либо образом влиять на состояние справочника.

Для того, что бы добавить данные (запись), нажмите соответствующую кнопку "Добавить строку".

И перед нами откроется интерфейс ввода данных.
По умолчанию в данной форме есть одно неудобство - перед нами доступны все поля для заполнения и отображаются единым списком.
К примеру, если мы начнём заполнять и выберем тип документа "Паспорт", то у нас будет поле "Номер документа", с которым не совсем понятно что делать, то есть это поле актуально для "Другого документа". При этом, если выбрать его, то поля "Серия" и "Номер" становятся лишними.

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

вкладки

Начнём с настройки "вкладок", делается это в Панели администратора → выбираем нужное измерение, переходим на соответствующую вкладку и в у нас открылся интерфейс, в котором нам необходимо сгруппировать существующие поля.

Механика создания вкладок для пользователя такова: из общего списка мы "перетаскиваем" поле "Вкладка" и на неё добавляем нужные нам поля, которые и будут в неё находится. Чтобы дать имя вкладке, достаточно нажать на неё и написать в поле "Опции" → "Имя вкладки" ввести название (имя).

Создадим вкладки с названиями:

Ф.И.О.

Фамилия
Имя
Отчество
Дата рождения

Документ

Документ
Серия
Номер
Выдан
Номер документа
Дата выдачи

И сохраняем.

Теперь форма ввода имеет более понятный интерфейс. Что снижает вероятность ошибки при заполнении.

настройка правил заполнения

В форме ввода справочника у нас остались поля, которые не относятся к "паспорту", и оператор ввода может ошибочно их заполнить. Чтобы этого избежать дополним настройку формы правилами.
По-другому можно сказать, что правила - это сценарии поведения полей (формы) для заполнения.

Интерфейс правил так же находится в панели администратора, на соответствующей вкладке.
Добавим новое правило.

После того, как мы нажали кнопку "Добавить правило", открывается окно, в котором мы задаём параметры сценариев (поведения) строк формы (справочника).

Данный блок настроек поделён на три блока:

Условие, где мы добавляем триггер на запуск механизма сценария.
Действие, которое будет выполняться при заданном условии.
Дополнительно - здесь можно написать комментарий для оператора ввода.

Для начала скроем все атрибуты из списка вкладки "Документ":

1

Для создания первого уровня условия мы нажимаем кнопку "+ условие" и выбираем что мы проверяем: выбираем атрибут "Документ" и добавляем условие (Значение отсутствует).

В блоке "Дополнительно" даётся описание системой, например: "Если Значение атрибута "Документ" не заполнено, то [Действие отсутствует]"
2

Как видно, "Действие" отсутствует, значит, что нам его нужно добавить. Нажимаем во втором блоке соответствующую кнопку. Первым шагом нам необходимо скрыть лишние атрибуты (поля), для этого, в поле "Объекты" выбираем:
-серия,
-номер,
-выдан,
-номер документа и
-дата выдачи. Вторым шагом добавляем действие, в нашем случае "Скрыть атрибут"
3

И в последнем блоке дадим комментарий для оператора ввода.
Скопируем "Текстовое описание" системы и вставим в поле "Комментарий".

Настройка получилась такого вида.

Сохраняем это правило.

Теперь добавим сценарии, когда у нас выбран паспорт (Документ 1).

Для этого добавляем новое правило, нажимаем соответствующую кнопку "Добавить правило", и действуем по тому же алгоритму (логике):

1

нажимаем кнопку "+ условие" и выбираем что мы проверяем.
Выбираем атрибут "Документ".
Добавляем условие (Значение из списка).
И выбираем элементы значения, с которым будем сравнивать (Паспорт гражданина РФ).

Видим описание: "Если Значение атрибута "Документ" из списка (Паспорт гражданина РФ), то [Действие отсутствует]"
2
Во втором блоке добавляем действие.
- Первым шагом оставим скрытыми атрибуты (поля), которые не будут видны, если выбран паспорт. Для этого выбираем "Номер документа", "дата выдачи" и назначаем действие "Скрыть атрибут".
- Но также нам нужно отобразить те поля, которые относятся к "Паспорту РФ", поэтому добавляем ещё одно действие и выбираем
-серия,
-номер,
-выдан.

Меняем действие, на "Показать атрибут"
3

И в последнем блоке дадим комментарий для оператора ввода.
Скопируем "Текстовое описание" системы и вставим в поле "Комментарий".

Таким образом мы сделали определённую логику (сценарий) при выборе паспорта.

Сохраняем настройки.

И таким же образом добавим сценарии, когда у нас выбран другой документ (Документ 2).

Для этого добавляем новое правило, нажимаем соответствующую кнопку "Добавить правило", и действуем по тому же алгоритму (логике):

1

нажимаем кнопку "+ условие" и выбираем что мы проверяем.
Выбираем атрибут "Документ".
Добавляем условие (Значение из списка).
И выбираем элементы значения, с которым будем сравнивать (Другой документ удостоверяющий личность).
2
Во втором блоке добавляем действие.
- Первым шагом оставим скрытыми атрибуты (поля), которые не будут видны, если выбран паспорт. Для этого выбираем:
-серия,
-номер,
-выдан.
и назначаем действие "Скрыть атрибут".
- Вторым шагом нужно отобразить те поля, которые относятся к "Документу 2", поэтому добавляем ещё одно действие и выбираем: "Номер документа" и "дата выдачи".
Меняем действие, на "Показать атрибут"
3

И в последнем блоке дадим комментарий для оператора ввода.
Скопируем "Текстовое описание" системы и вставим в поле "Комментарий".

Таким образом мы сделали определённую логику (сценарий) при выборе паспорта.

Сохраняем настройки.

Убеждаемся, что эти правила не противоречат, а дополняют друг друга.

Теперь мы можем управлять поведением пользователя (оператора ввода) при заполнении формы справочника. Что позволяет ввести нормативно-справочную документацию дополнительную верификацию данных.

Показатели

Измерения

Создание формы для заполнения

Настройка формы пользовательского ввода

Настройка
бизнес-правил

Настройка формато - логического
контроля

Создание тиража

Добавление системы согласования

Группа показателей

Справочник

Форма

Перейти к созданию тиража форм >>

Если у Вас появились вопросы - напишите нам