# Добавление простого поля на форму заявки ЛКС

Добавление простого поля на форму заявки ЛКС

В дальнейшем планируется разработка удобного конструктора для форм.

Пока конструктора нет, следует придерживаться следующего порядка действий.

Рассмотрим добавление полей для ввода текста, для вложения файлов и статичных полей (просто надпись)

1. Открыть меню "ЛК сотрудника"
2. Перейти в справочник "Типы заявок"
3. Открыть карточку требуемого типа
4. На закладке "Настройки front-end" переключиться на закладку "Шаблоны"

![](/files/6KPEv5JLbqmIZaJCyCcX)

1. Выделить всё, скопировать, в блокнот, сохранить. На случай, если придется вернуться к виду "как было".
2. Описание каждого поля начинается с "{" и заканчивается "}", блоки разделяются запятыми. В текущей или любой другой заявке нужно найти пример такого блока.\
   Для поля ввода текса нужно найти блок с типом "type": "textarea",\
   Для поля вложения файлов - "type": "file-multi",\
   Для простого текста - "type": "static",

   Далее нужно скопировать описание поля в буфер обмена

![](/files/PWjGDRqPKc5eU5ZVO9lV)

1. Нужно спозиционироваться между теми блоками, между которыми должно появиться новое поле и вставить код нового блока<br>

![](/files/x60ysms53h8zC5M8MNJS)

1. Если нужен точно такой же блок - менять ничего не нужно. Если нужно изменить название, содержимое и прочее - необходимо изменить значения параметров.\
   **Везде очень важно не потерять кавычки и разделители и не поставить лишних**
   1. Для файлов\
      "type": "file-multi", - не меняем, всегда такой\
      "formControlName": "files", - как будет называться поле на форме (служебное название), важно чтобы названия в рамках одной формы не повторялись\
      "label": "ru='Скан паспорта';en='Scan of passport'", - как будет называться поле на форме - что будет видеть пользователь\
      "gridClasses": \["col-md-12"], - не менять\
      "disabled": false, - не менять\
      "edited": true, - не менять\
      "validations": \["required"] - если в квадратных скобках "required", поле будет обязательным, если в квадратных скобках пусто - необязательным
   2. Для поля ввода текста\
      type": "textarea", - не меняем\
      "formControlName": "message", - как будет называться поле на форме (служебное название), важно чтобы названия в рамках одной формы не повторялись\
      "label": "ru='Место работы';en='Place of work'", - как будет называться поле на форме - что будет видеть пользователь\
      "gridClasses": \["col-md-12"], - не меняем\
      "disabled": false, - не меняем\
      "edited": true, - не меняем\
      "validations": \[] - если в квадратных скобках "required", поле будет обязательным, если в квадратных скобках пусто - необязательным
   3. Для надписи\
      "type": "static", - не меняем\
      "value": "ru='Если Вы хотите изменить даты отпуска или отменить отпуск, просим обратиться в отдел по работе с персоналом.' - какой текст будет отображаться в русском варианте ЛКС\
      ;en='If you want to change the dates of the vacation, please contact the HR department'", - какой текст будет отображаться в английском варианте ЛКС\
      "gridClasses": \["col-md-12"],
2. Если добавляли поле для вложения файлов, проверить, что в правом поле "Настройки" есть строка "loadFileType": "base64",. Если нет - добавить.

![](/files/J6lnRKawqOfhARlmh30Q)

1. Переключиться на закладку "Поля формы" и нажать "Заполнить поля формы"

![](/files/hhaiwbIQqyUam5M5bVjb)

1. Записать и закрыть
2. Открыть фронт клиента
3. Залогиниться под любым пользователем
4. Проверить, что форма отображается корректно, не заполняя ничего нажать "Отправить" - так проверяется обязательность полей (обязательные подсвечиваются красной рамкой)
5. Если всё сломалось и нужно вернуть как было, вернуться к п.5, вставить сохраненный шаблон, записать и закрыть. Начать сначала.
6. Если есть сложности - лучше обращаться к команде разработки.

### Ограничения <a href="#scroll-bookmark-2" id="scroll-bookmark-2"></a>

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

В связи с этим проверять их после изменения следует тоже более внимательно.

**Отличить их можно по заполненному полю "Алиас" и флагу "Использовать статичный шаблон"**\
Это, например, Командировки и Служебные поездки.<br>

![](/files/R1rjoRa2zwjVP8vnp2QZ)

\
Менять значение поля Алиас без согласования с фронтенд-разработчиками не стоит - всё сломается ![\_scroll\_external/icons/smile-fafa44cc4befaa8b901173eb8b31c4222272148803a07857cc0b0f93863aaff4.svg](/files/JnHWcgQhJ31eooecqJyL)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://padocs.empldocs.app/dlya-razrabotchikov/nastroiki-lks/nastroika-zayavok/dobavlenie-prostogo-polya-na-formu-zayavki-lks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
