> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/wt-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/wt-knowledge-base/guidelines/code.md).

# Код

## Форматирование кода <a href="#code-formatting" id="code-formatting"></a>

#### Workflow XML Editor

Для автоматического выравнивания кода в редакторе Workflow XML Editor используется сочетание клавиш **Ctrl + Q.**

{% hint style="info" %}
Полный список сочетаний клавиш приведен в [статье](/wt-knowledge-base/workflow-xml-editor/keyboard-shortcuts.md).
{% endhint %}

## Серверная часть <a href="#server" id="server"></a>

Элементы серверного xml-файла группируем в логические боки в рамках родительского тэга. И каждый блок отмечаем комментарием, раскрывающим смысл блока.

Например, запросы на получение списка городов и списка клиентов и запросы на редактирование этих списков объединяем в два блока:

<figure><img src="/files/4IIz5aqcS8VqSlebTHEF" alt=""><figcaption></figcaption></figure>

В начале блока идут запросы на чтение данных о клиентах, а затем запросы на редактирование этих  данных.

В блок запросов для работы со списком можно добавить запрос на получение короткого списка, который будет использовать на формах в ComboBox - запрос ClientShortSelectSqlQuery. Если этот запрос будет вызываться только на одной форме, то лучше описать его в блоке запросов связанных с этой формой. Например, в блок запросов для работы с заказами добавлены запросы OrderPositionByOrderIdSelectSqlQuery и OrderPaymentByOrderIdSelectSqlQuery, которые будут вызываться только на форме заказа:

<figure><img src="/files/Zw6P3LEiJbaEdrXf3VTy" alt=""><figcaption></figcaption></figure>

Аналогично группируем и AccessPoint, собирая в один блок точки доступа привязанные к одной сущности:

<figure><img src="/files/p9v55rIsEd0E9malSvvT" alt=""><figcaption></figcaption></figure>

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

Описание Permission и Role так же группируем в блоки.

## Клиентская часть <a href="#client" id="client"></a>

### Элементы формы <a href="#form-elements" id="form-elements"></a>

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

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

<figure><img src="/files/pHRZAi8j3iciQxf9TWZO" alt=""><figcaption></figcaption></figure>

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

<div><figure><img src="/files/2g1S6FpvuPsdQPGQe88T" alt=""><figcaption></figcaption></figure> <figure><img src="/files/j2vuQt0CbVG8TWMFkmGr" alt=""><figcaption></figcaption></figure></div>

### Объекты формы <a href="#form-objects" id="form-objects"></a>

Порядок описания xml-кода элементов формы должен соответствовать порядку отображения элементов в интерфейсе. Объекты описываются сверху вниз и слева направо в пределах своего контейнера.

<figure><img src="/files/r6NYDBgQeHcPtGLwQQ7N" alt=""><figcaption></figcaption></figure>