Добавление пользовательских свойств

1

С версии 20.6 Платформа НЕЙРОСС предоставляет простой редактор пользовательских свойств, позволяющий в простом и наглядном виде добавлять пользовательские свойства владельца и пропуска. С версии 20.10 Платформа НЕЙРОСС предоставляет возможность выполнения экспорта созданных свойств в файл формата JSON с целью последующего импорта на другом узле Платформа НЕЙРОСС.

2

3

4

Перечень стандартных свойств владельца и пропуска приведён в разделе ~[[[Управление пропусками ~> Общие сведения>>doc:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome||anchor="Управлениепропусками-Общиесведения"]]].

Общие сведения

Данные владельца и пропуска могут быть дополнены произвольным набором пользовательских свойств следующего типа: текст, логическое поле (Да/Нет), дата, время, дата и время, список. Перечень значений для поля типа «список» настраивается, редактируется и дополняется. Для отображения пользовательских свойств в форме владельца или в форме пропуска предусмотрен простой конструктор форм, вы также можете разработать шаблон формы самостоятельно или заказать такую разработку. Пользовательское свойство также может быть добавлено в таблицу пропусков, при этом обеспечивается сортировка и фильтрация записей по добавленным полям.

10

11

Функция дополнения данных владельца и пропуска произвольным набором пользовательских свойств входит в пакет установки Платформы НЕЙРОСС и дополнительно не лицензируется.

12

13

== {{id name="Добавлениепользовательскихсвойств-Окнораздела"/}}Окно раздела ==

14

15

Настройка пользовательских свойств осуществляется в разделе **Настройки СКУД**.

**ВАЖНО**

Права доступа к разделу разграничиваются, требуется право «Администрирование» раздела Персонал ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Управление пользователями.WebHome]]].

\\

[[image:attach:s_bp_arm_properties.png||width="900"]]

26

27

1. **Разделы**: панель переключения между разделами АРМ НЕЙРОСС Доступ: [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_cards.png||thumbnail="true" width="22"]][[Персонал>>doc:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome]], [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_graphs.png||thumbnail="true" width="24"]][[ (%%)Графики работы>>doc:neyross.АРМ НЕЙРОСС Доступ.Графики работы.WebHome]],(%%) [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_levels_access.png||thumbnail="true" width="22"]] (%%)[[Уровни доступа>>doc:neyross.АРМ НЕЙРОСС Доступ.Уровни доступа.WebHome||style="text-align: left;" shape="rect"]], [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_levels_control.png||thumbnail="true" width="24"]] (%%)[[Уровни управления>>doc:neyross.АРМ НЕЙРОСС Доступ.Уровни управления.WebHome||style="text-align: left;" shape="rect"]], [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_rooms.png||thumbnail="true" width="24"]] [[doc:neyross.АРМ НЕЙРОСС Доступ.Помещения.WebHome]], [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_request.png||thumbnail="true" height="19"]] [[doc:neyross.АРМ НЕЙРОСС Доступ.Заявки на пропуска.WebHome]], [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_properties.png||thumbnail="true" height="18"]]Настройки СКУД, [[image:attach:ui.Параметры узла.WebHome@btn_prp.png||thumbnail="true" width="22"]] [[Настройки АРМ>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.WebHome]];

28

1. **Вкладки:**

29

11. **Свойства владельца пропуска / Свойства пропуска**: свойства владельца пропуска и свойства пропуска редактируются независимо, на отдельных вкладках;

30

11. [[Уточнения статусов пропусков>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка уточнений статусов пропусков.WebHome]]

31

11. [[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Управление персональными данными.WebHome]]

32

1. **Список свойств**: список стандартных и пользовательских свойств пропуска или владельца (в зависимости от выбранной вкладки [2]);

33

1. **Настройки свойства**: стандартные свойства не редактируются, но по уникальному ключу свойства вы можете настроить нестандартное поведение; перечень настроек пользовательского свойства зависит от его типа.

34

35

== {{id name="Добавлениепользовательскихсвойств-Добавлениесвойства"/}}Добавление свойства ==

36

37

Для добавления свойства нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_plus_circle.png||thumbnail="true" height="17"]] **Добавить новое свойство** в блоке **Свойства**.

38

39

[[image:attach:userfields_add1.png||height="250"]]

40

41

Задайте название и тип данных поля. Нажмите на кнопку **Добавить**.

|=(((

Поле

)))|=(((

Комментарий

)))

|(((

Название

)))|(((

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

)))

|(((

Уникальный ключ

)))|(((

(((

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

58

59

60

В имени ключа запрещается использование символа «точка». При транслитерации точка заменяется подчёркиванием.

)))

)))

|(((

Тип данных

)))|(((

Выберите значение из раскрывающегося списка:

68

69

* Текст — для однострочных или многострочных текстовых полей;

70

* Переключатель — для логических полей (Да/Нет);

71

* Дата/время — для значений даты, времени или даты и времени;

72

* Список — при необходимости выбора значения из предустановленного списка значений.

73

)))

74

75

== {{id name="Добавлениепользовательскихсвойств-Настройкасвойства"/}}Настройка свойства ==

76

77

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

**Тип «Текст»**

Свойство типа «текст» может быть однострочным или многострочным.

82

83

[[image:attach:userfields_text.png||width="490"]]

84

85

**Тип «Переключатель»**

86

87

Свойство типа «переключатель» не имеет дополнительных настроек и отображается в виде переключателя [[image:attach:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка последовательной нумерации пропусков.WebHome@fa-off.png||thumbnail="true" height="18"]]. Значение по умолчанию: нет, не задано, не установлено.

88

89

[[image:attach:userfields_logical.png||width="490"]]

**Тип «Дата/время»**

Свойство типа «дата/время» может содержать информацию о паре дата-время, только дату (при этом время устанавливается в 00:00), либо только время.

94

95

[[image:attach:userfields_date.png||width="490"]]

**Тип «Список»**

Свойство типа «список» предоставляет классический справочник с уникальным кодом для каждого значения, возможностью добавления и корректировки значений, поиском по коду и значению. Для добавления нового значения в список нажмите на кнопку **Добавить значение**, задайте код и текст значения, подтвердите завершение ввода нажатием клавиши **Enter (Ввод)** или кнопки **Сохранить [[image:attach:btn_save_circle_black.png||thumbnail="true" height="20"]]**. Для удаления значения из справочника нажмите на кнопку [[image:attach:btn_delete_gray.png||thumbnail="true" height="20"]]**Удалить**.

100

101

[[image:attach:userfields_list.png||width="780"]]

102

103

== {{id name="Добавлениепользовательскихсвойств-Настройкашаблоновформвводаитаблицыпропусков"/}}Настройка шаблонов форм ввода и таблицы пропусков ==

104

105

Для ввода данных по пользовательским свойствам необходимо добавить эти поля на форму владельца пропуска (для свойств владельца) и на форму пропуска (для свойств пропуска) ~[[[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка форм ввода данных.WebHome]]].

106

107

Для поиска и сортировки пропусков по пользовательским свойствам необходимо добавить соответствующие поля в таблицу пропусков [[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка таблицы пропусков.WebHome]].

**ПРИМЕЧАНИЕ**

Возможен импорт данных владельца пропуска и данных пропуска из файла CSV. При необходимости импорта нестандартных полей предварительно необходимо создать требуемый перечень пользовательских свойств. В настоящее время поддерживается импорт текстовых полей и полей типа «список». Для списков при подготовке файла CSV необходимо указывать не текстовое значение, а уникальный код поля. Импорт полей типа «дата/время» и «логическое» в настоящее время не поддерживается. При необходимости импорта уровня доступа используйте UUID уровня.

\\

== {{id name="Добавлениепользовательскихсвойств-Удалениесвойства"/}}Удаление свойства ==

118

119

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

120

121

[[image:attach:userfields_del.png]]

122

123

[[image:attach:userfields_del1.png]]

124

125

126

Соответствующие данные у владельцев/пропусков остаются. Для отображения можно добавить новое пользовательское свойство с тем же ключом и добавить поле на форму / в таблицу

127

128

При удалении значения поля типа «список», для всех владельцев\пропусков, для которых задано это значение, данные также не очищаются, но могут быть заменены другим значением.

129

130

131

== {{id name="Добавлениепользовательскихсвойств-Экспортиимпортсвойств"/}}Экспорт и импорт свойств(%%) ==

132

133

Платформа НЕЙРОСС с версии 20.10 предоставляет возможность переноса пользовательских свойств с одного узла Платформа НЕЙРОСС на другой. Это позволяет заказать разработку какой-либо новой функциональности, например, — форм ввода данных владельца пропуска, а затем загрузить готовую форму пропуска и готовый перечень пользовательских свойств. Данные свойств сохраняются в файле формата JSON.

134

135

136

Экспорт свойств владельца пропуска и свойств пропуска осуществляется независимо в разные файлы формата JSON. Импорт свойств владельца пропуска и пропуска также осуществляется независимо, из разных файлах, на соответствующих вкладках приложения.

137

138

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

**Экспорт свойств**

1. Для экспорта пользовательских свойств владельца пропуска перейдите к вкладке **Свойства владельца пропуска**. Для экспорта пользовательских свойств пропуска перейдите к вкладке **Свойства пропуска**. Нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_down.png||thumbnail="true" height="16"]]**Экспорт**.

144

1. (((

145

Файл формата JSON будет подготовлен и сохранён в папке загрузок браузера. Примеры файлов:

146

147

148

Пользовательские свойства, [владельцы пропусков/пропуска], [количество], ДД.ММ.ГГГГ ЧЧ_ММ_СС.JSON

149

150

151

, где [владельцы пропусков/пропуска] — тип экспортированных свойств, [количество] — количество свойств, ДД.ММ.ГГГГ ЧЧ_ММ_СС — дата и время выполнения процедуры экспорта. Например:

152

153

154

Пользовательские свойства, владельцы пропусков/пропуска, 5,26.07.2023 16_22_05.json

155

Пользовательские свойства, пропуска, 2, 26.07.2023 16_22_07.json

С версии 20.22 Платформы НЕЙРОСС добавлена возможность выбора имени файла и папки для сохранения файла. Функция выбора доступна при работе в АРМ НЕЙРОСС.

160

161

)))

162

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

**Импорт свойств**

1. Для импорта пользовательских свойств владельца пропуска перейдите к вкладке **Свойства владельца пропуска**. Для импорт пользовательских свойств пропуска перейдите к вкладке **Свойства пропуска**. Нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_up.png||thumbnail="true" height="16"]]Импорт.

167

1. В отобразившемся окне укажите путь к файлу формата JSON.

168

[[image:attach:userfields_import1.png||height="250"]]

169

1. Ознакомьтесь с информацией о количестве свойств, которые будут импортированы. Нажмите на кнопку **Импорт**.

170

[[image:attach:userfields_import2.png||height="250"]]

171

1. Дождитесь сообщения об успешном завершении процедуры импорта.

Wiki source code of Добавление пользовательских свойств