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

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

5

6

7

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

[[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание:

(% style="font-size: 20.0px;letter-spacing: -0.008em;" %)Общие сведения

21

22

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

23

24

(% style="letter-spacing: 0.0px;" %)Функция дополнения данных владельца и пропуска произвольным набором пользовательских свойств входит в пакет установки Платформы НЕЙРОСС и дополнительно не лицензируется.

25

26

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

27

28

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

**ВАЖНО**

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

\\

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

39

40

1. **Разделы**: (% style="color: rgb(23,43,77);" %)панель переключения между разделами АРМ НЕЙРОСС Доступ: [[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"]][[(% style="color: rgb(23,43,77);" %) (%%)Графики работы>>doc:neyross.АРМ НЕЙРОСС Доступ.Графики работы.WebHome]],(%%) [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_levels_access.png||thumbnail="true" width="22"]](% style="color: rgb(23,43,77);" %) (%%)[[Уровни доступа>>doc:neyross.АРМ НЕЙРОСС Доступ.Уровни доступа.WebHome||style="text-align: left;" shape="rect"]](% style="color: rgb(23,43,77);" %), [[image:attach:neyross.АРМ НЕЙРОСС Доступ.Управление пропусками.WebHome@btn_levels_control.png||thumbnail="true" width="24"]] (%%)[[Уровни управления>>doc:neyross.АРМ НЕЙРОСС Доступ.Уровни управления.WebHome||style="text-align: left;" shape="rect"]](% style="color: rgb(23,43,77);" %), [[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]];

41

1. (% style="color: rgb(23,43,77);" %)**Вкладки:**

42

11. (% style="color: rgb(23,43,77);" %)**Свойства владельца пропуска / Свойства пропуска**: свойства владельца пропуска и свойства пропуска редактируются независимо, на отдельных вкладках;

43

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

44

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

45

1. (% style="color: rgb(23,43,77);" %)**Список свойств**: список стандартных и пользовательских свойств пропуска или владельца (в зависимости от выбранной вкладки [2]);

46

1. (% style="color: rgb(23,43,77);" %)**Настройки свойства**: стандартные свойства не редактируются, но по уникальному ключу свойства вы можете настроить нестандартное поведение; перечень настроек пользовательского свойства зависит от его типа.

47

48

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

49

50

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

51

52

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

53

54

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

55

56

(% class="wrapped" %)

|=(((

Поле

)))|=(((

Комментарий

)))

|(((

Название

)))|(((

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

)))

|(((

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

)))|(((

(% class="content-wrapper" %)

71

(((

72

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

73

74

75

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

)))

)))

|(((

Тип данных

)))|(((

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

83

84

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

85

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

86

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

87

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

88

)))

89

90

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

91

92

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

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

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

97

98

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

99

100

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

101

102

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

103

104

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

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

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

109

110

[[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"]]**Удалить**.

115

116

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

117

118

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

119

120

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

121

122

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

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

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

\\

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

133

134

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

135

136

[[image:attach:userfields_del.png]]

137

138

[[image:attach:userfields_del1.png]]

139

140

141

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

142

143

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

144

145

146

== {{id name="Добавлениепользовательскихсвойств-Экспортиимпортсвойств"/}}(% style="font-size: 20.0px;letter-spacing: -0.008em;" %)Экспорт и импорт свойств(%%) ==

147

148

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

149

150

151

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

152

153

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

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

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

159

1. (((

160

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

161

162

163

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

164

165

166

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

167

168

169

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

170

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

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

175

176

)))

177

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

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

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

182

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

183

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

184

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

185

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

186

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

187

188

189

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