## Описания компонентов   {#components}

Ниже описаны следующие компоненты формы:

-   [Компонент добавления ссылки](#link)
-   [Компонент выбора пользователя](#userchooser)
-   [Компонент выбора файла](#filechooser)
-   [Компонент выбора записи реестра](#registrychooser)
-   [Модифицированный компонент выбора записи реестра](#reg_create_chooser)
-   [Числовое поле](#numeric_field)

### Компонент добавления ссылки {#link}

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

![Компонент добавления ссылки](resources/img/storage/link.png)

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

![Диалог настройки ссылки](resources/img/storage/link_settings.png)

В данном окне присутствуют следующие настройки:
    
-   URL - поле для ввода ссылки
    
-   Надпись - поле для ввода текста, который отображается в данном 
    поле в режиме просмотра или после лейбла "Ссылка:" в режиме 
    редактирования
    
-   Открывать в отдельном окне - опция для настройки возможности 
    открытия ссылки в отдельном окне

После добавления ссылки и по нажатию на кнопку "Готово", поле 
заполняется соответствующим значением. По нажатию на ссылку в режиме
просмотра производится переход по данной ссылке.

### Компонент выбора пользователя {#userchooser}

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

![Компонент выбора пользователя](resources/img/storage/comp_userchooser.png)

По нажатию на кнопку справа от поля ввода появляется диалог выбора 
пользователя. 

![Диалог выбора пользователей](resources/img/storage/userchooser.png) 
    
В данном диалоге возможен выбор только одного пользователя. Выбранный
пользователь выделяется голубым цветом. Доступен поиск пользователя 
по его ФИО и должности. Для выбора пользователя необходимо выделить 
нужного и кликнуть по кнопке "Выбрать", после чего поле заполнится
тегом выбранного пользователя. При необходимости можно удалить тег, нажав
на крестик и подтвердив данное действие.

### Компонент выбора файла {#filechooser}

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

![Компонент выбора файла в режиме редактирования](resources/img/storage/filechooser.png)

В режиме редактирования отображается кнопка "Выбрать файл". По нажатию 
на нее появляется меню со следующими пунктами:
    
-   С компьютера
    
-   Из хранилища

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

![Диалоговое окно выбора файла](resources/img/storage/choose_file.png) 
    
При выборе пункта "Из хранилища" открывается диалоговое окно выбора файла
из хранилища. Личная папка пользователя отображается, также отображаются
все папки, на которые у пользователя есть права. Доступен единичный
выбор файла, без возможности добавления новой папки. После выбора 
необходимого файла, он выделяется голубым цветом, кнопка "Выбрать"
становится активной. По нажатию на эту кнопку файл загружается
на форму.  
    
![Диалоговое окно выбора файла из хранилища](resources/img/storage/choose_storage_file.png)

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

При выборе пункта "Создать новый" открывается диалоговое окно создания
нового файла. После ввода названия файла кнопка "Готово" сановится активной.
По нажатию на эту кнопку создается новый файл с расширением `htd`, 
добавляется в список файлов. По нажатию на лейбл с названием данного файл
открывается HTD-редактор с пустым содержимым. 

![Диалоговое окно создания нового файла](resources/img/storage/create_new.png)

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

### Компонент выбора записи реестра {#registrychooser}

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

![Компонент выбора записи реестра](resources/img/storage/regchooser.png)

По нажатию на кнопку справа от поля ввода появляется диалог выбора записи
реестра. 

![Диалог выбора записи реестра](resources/img/storage/registrychooser.png)

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

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

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

### Модифицированный компонент выбора записи реестра {#reg_create_chooser}

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

Список доступных действий данного компонента: 

-   "+Создать"

-   "Выбрать из реестра"

-   "Удалить"

![Модифицированный компонент выбора записи реестра](resources/img/storage/reg_create_chooser.png)

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

![Модифицированный компонент выбора записи реестра с выбранным значением](resources/img/storage/rcc_chosen.png)

*Создание новой записи реестра из текущей формы:*

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

![Диалог создания новой записи реестра](resources/img/storage/rcc_new.png)

*Выбор существующей записи реестра:*

Выбор записи осуществляется по нажатию на лейбл *"Выбрать из реестра"* 
(доступен всегда). По нажатию на лейбл открывается 
[диалог выбора записи реестра](#registrychooser). После выбора записи
реестра поле компонента заполнится соответствующим значением.

*Удаление текущего выбранного значения компонента:*

Удаление текущего значения компонента доступно по нажатию на лейбл *"Удалить"*, 
который доступен только после выбора какого-либо значения. По нажатию на лейбл
"Удалить" компонент принимает вид пустого поля ввода.

### Числовое поле {#numeric_field}

Данный компонент позволяет отобразить типизированные десятичные числовые значения. 
Внешне компонент аналогичен компоненту «Однострочное поле». В поле серым 
цветом отображается подсказка с текстом "Введите число". Данное поле принимает 
только числа и некоторые символы (точка, запятая).

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

> **Пример:**
    Для товара, цена которого за единицу равна 230 тенге, можно ввести сумму за 
35 единиц, введя в поле *Сумма, тенге* следующее:

> =230*35

> В поле *Сумма, тенге* отобразится значение этого выражения: 

> 8 050




