Документация 3.0
Реквизиты
Изменен: 27.09.2026 15:05:25
Реквизиты документа — это поля, из которых складывается его содержимое: текст, числа, даты, таблицы, изображения и ссылки на записи программы. Тип реквизита определяет способ заполнения поля, доступные настройки и дальнейшее использование значения.
Реквизиты настраиваются отдельно для каждого типа документа. Чтобы поле появилось при просмотре и печати, добавьте соответствующую переменную в печатную форму. Наличие поля в форме заполнения само по себе не добавляет его в печатную форму.
Где настраивать реквизиты
- В аккаунте клиники откройте «Администрирование» → «Управление документами» → «Типы документов».
- Найдите нужный тип документа и откройте «Реквизиты» через его контекстное меню.
- Добавьте новый реквизит или откройте существующий. Выберите тип, заполните название и необходимые настройки, затем сохраните изменения.
Общие свойства
Настройки распределены по вкладкам «Основные», «Вывод в форме» и «Дополнительные». Набор дополнительных параметров зависит от выбранного типа реквизита.
| Свойство | Назначение |
|---|---|
| Тип | Определяет, как пользователь заполняет поле и как программа обрабатывает его значение. Доступные типы описаны ниже. |
| Название | Подпись поля в форме заполнения документа. Обязательно для заполнения. |
| Код | Уникальное обозначение реквизита в пределах типа документа. Используется в формулах и переменных печатной формы. Задается при создании; при редактировании существующего реквизита поле недоступно. Удобно использовать короткие понятные коды, например result или comment. |
| Вкладка | Позволяет разместить реквизит на определенной вкладке формы документа. |
| Заголовок перед реквизитом | Добавляет заголовок перед полем, например для группы результатов или рекомендаций. |
| Выводить разделитель перед реквизитом | Визуально отделяет поле от предыдущих реквизитов. |
| Комментарий | Пояснение для сотрудника, заполняющего документ. |
| Условная группа | Связывает видимость поля с условиями. Если выбрано несколько групп, достаточно выполнения условия хотя бы одной из них. |
| Обязательный | Отмечает реквизит как обязательный. Для документов, требующих активации, заполнение обязательных реквизитов проверяется при активации. |
| Индексируется | Позволяет использовать значение реквизита документа при поиске пациентов. |
У некоторых типов дополнительно доступны значение «По умолчанию», запрет редактирования «Только чтение» и настройка «Скрыть в форме редактирования документа». Эти параметры относятся к форме заполнения; состав печатной формы настраивается отдельно.
Типы реквизитов
В редакторе доступен 31 тип реквизита. Ниже они перечислены в порядке выбора в программе.
1. Строка
Однострочное текстовое поле для короткого значения: обозначения, номера, краткого результата или примечания. Пользователь вводит текст непосредственно в поле.
Можно задать значение по умолчанию, разрешить HTML-содержимое, запретить редактирование или скрыть поле в форме. Настройка «Возможно указать отсутствие значения» позволяет явно отметить, что значения нет; для такого случая задается отдельный текст. Это удобно, когда отсутствие результата нужно отличать от незаполненного поля.
2. Число
Числовое поле для количества, измерения или другого значения, которое потребуется сравнивать и использовать в расчетах. Подходит для реквизитов, участвующих в вычислениях.
Доступны значение по умолчанию, режим только для чтения, скрытие поля и настройка «Допускаются только положительные значения». Как и у строки, можно разрешить явное указание отсутствующего значения. Если для реквизита настроены нормы, они используются при отображении результата; выход за границы нормы может выделяться в печатной форме.
3. Текст
Многострочное поле для развернутого описания: жалоб, результатов осмотра, комментария или рекомендаций. Используйте его, когда содержимое занимает несколько предложений или абзацев.
Можно задать текст по умолчанию, включить HTML-содержимое, запретить редактирование или скрыть поле в форме. Для короткого значения без абзацев удобнее тип «Строка».
4. Выбор
Позволяет выбрать один вариант из заранее заданного списка. Для вариантов настраиваются подпись в форме и отдельное значение для вывода: например, короткий вариант при заполнении может заменяться развернутым текстом в печатной форме.
В обычном режиме поле допускает ввод собственного текста. При включении «Сохранять код значения» используется выбор из списка с сохранением символьного кода варианта; произвольный ввод в этом режиме недоступен. Если отдельный текст для печати не задан, выводится название выбранного варианта.
5. Таблица
Предназначена для повторяющихся строк с одинаковым набором колонок: перечня измерений, позиций или назначений. У таблицы есть собственный код реквизита, а у каждой колонки — свой код внутри таблицы. Тип колонки определяет способ заполнения ячейки. Он выбирается из отдельного списка и не совпадает с полным перечнем типов реквизитов документа.
Создание и настройка колонок
- Создайте реквизит типа «Таблица» и заполните его название и код.
- В блоке «Колонки таблицы» задайте для каждой колонки «Заголовок», «Код колонки» и «Тип данных». Используйте разные коды, например
item,quantity,comment. - Через меню слева от описания колонки добавьте колонки перед ней или после нее, измените порядок командами «Вверх» и «Вниз».
- Выберите «Свойства» в том же меню, чтобы настроить дополнительные параметры выбранного типа. Набор параметров различается; у типов «Текст» и «Услуга» отдельное окно дополнительных свойств в текущем редакторе отсутствует.
- Сохраните реквизит. Если нужны заранее заполненные строки, откройте его снова и перейдите по ссылке «Заполнить данные по умолчанию».
«Максимальное количество рядов» ограничивает число строк. Пустое значение означает отсутствие заданного ограничения. Настройка «Скрыть в форме редактирования документа» относится ко всей таблице.
Типы колонок
В списке «Тип данных» доступны 11 вариантов.
| Тип колонки | Заполнение и назначение | Настройки и особенности |
|---|---|---|
| Строка | Однострочный текст: краткое название, обозначение, примечание. | Ширина, выравнивание, «Только чтение», скрытие в форме или при печати, отображение свернутым. |
| Текст | Многострочное описание в ячейке. | Переносы строк сохраняются при печати. Отдельное окно дополнительных свойств для этого типа не предусмотрено. |
| Число | Числовое значение: количество, измерение, сумма. | Ширина, выравнивание, «Только чтение», «Допускаются только положительные значения», скрытие в форме или при печати. Значения участвуют в итогах. Особенность свернутого отображения описана ниже. |
| Счетчик | Автоматическая нумерация строк начиная с 1. | Номер не вводится вручную. При редактировании документа колонка не показывается; при просмотре и печати номера определяются порядком строк. Доступны ширина, выравнивание и скрытие при печати. |
| Справочник | Выбор записи из указанного справочника программы. | В свойствах обязательно выберите «Справочник». Доступны ширина, выравнивание, скрытие при печати и «Шаблон» для представления выбранной записи. |
| Выбор варианта | Один вариант из выпадающего списка. | В «Вариантах значений» введите по одному варианту на строку. Доступны ширина и скрытие при печати. Произвольного ввода и отдельного текста для печати каждого варианта здесь нет. |
| Склад | Выбор склада в каждой строке таблицы. | Список учитывает доступ пользователя к складам. Доступны ширина и скрытие при печати. Подходит, когда разным строкам нужны разные склады. |
| Пользователь | Выбор учетной записи пользователя программы. | Доступны ширина и скрытие при печати. В печатной форме выводится имя пользователя. |
| Товар | Поиск и выбор товара из номенклатуры. | Доступны ширина, скрытие при печати и «Исключить дубли товаров» в списке выбора. Для таблиц с товарами предусмотрены групповое добавление и ввод штрихкода. |
| Услуга | Поиск и выбор услуги из номенклатуры. | При печати к названию добавляется описание услуги, если оно заполнено. Отдельного окна дополнительных свойств для этой колонки нет. Поддерживается групповое добавление. |
| Сотрудник | Выбор сотрудника организации с его учетным номером. | В «Отборе по полю» укажите отдельный реквизит документа типа «Выбор организации». Без выбранной организации список сотрудников не заполняется. Доступны ширина и скрытие при печати. |
«Пользователь» обозначает учетную запись для работы с программой, а «Сотрудник» — запись сотрудника в организации. Для колонки «Сотрудник» сначала создайте и сохраните реквизит выбора организации, затем свяжите с ним колонку. В документе сначала выберите организацию.
У колонки «Справочник» шаблон определяет текст при печати. Например, #title# выводит название записи; другие поля указываются по их кодам между знаками #. Если шаблон колонки не задан, используется шаблон самого справочника, а при его отсутствии — название выбранной записи.
Видимость и оформление
Дополнительные параметры действуют только для тех типов колонок, у которых они доступны в окне «Свойства».
| Параметр | Что меняет |
|---|---|
| Ширина | Ширину колонки, например 10%. При настройке учитывайте общую ширину таблицы и длину содержимого. |
| Выравнивание | Расположение значения по левому краю, по центру или по правому краю при печати. |
| Только чтение | Запрещает ручное изменение ячейки; подходит для заранее заполненных или формируемых программой значений. |
| Скрыть в печатной форме | Исключает колонку из стандартного вывода таблицы при просмотре и печати документа. В форме заполнения она может оставаться доступной. |
| Скрыть в форме документа | Убирает колонку из формы заполнения. Само по себе не исключает ее из печатной формы. |
| Отображать столбец свернутым | Переносит строковое поле в дополнительные свойства строки, открываемые через колонку «Доп.». Это позволяет освободить место в широкой таблице. |
У числовой колонки настройка свернутого отображения тоже присутствует, но в текущей форме не реализован вывод такого поля в дополнительных свойствах строки. Для чисел оставляйте ее выключенной. Хотя бы одна обычная колонка должна оставаться видимой в форме, чтобы таблицу можно было заполнить.
Строки по умолчанию и групповое добавление
После первого сохранения реквизита становится доступна ссылка «Заполнить данные по умолчанию». Здесь можно подготовить исходные строки, чтобы сотрудник не вводил один и тот же перечень заново.
При заполнении документа строки можно добавлять, удалять и переставлять через меню строки. У таблиц с колонкой «Товар» или «Услуга» появляется действие «Добавить несколько», а при наличии «Товара» — поле ввода штрихкода.
В текущей форме групповое добавление использует первую по порядку колонку типа «Товар» или «Услуга», а добавление по штрихкоду — первую колонку «Товар». Отдельная настройка «Групповое добавление по столбцу» в редакторе реквизита сейчас не меняет этот выбор. Учитывайте порядок колонок, если таких полей несколько.
Итоги и вычисления
Флажок «Отображать ряд итоговых значений» добавляет строку итогов в стандартную печатную форму таблицы. Суммируются все нескрытые числовые колонки; суммы выводятся с двумя знаками после запятой. Колонки «Строка», «Текст» и «Счетчик» не суммируются, даже если в них отображаются цифры.
В «Коде столбца для поля «Итого:»» укажите код видимой нечисловой колонки, под которой должна появиться эта подпись. Например, для таблицы с колонками item и quantity подпись можно разместить под item, а под quantity будет сумма.
Суммирование колонок не рассчитывает произведение количества и цены в каждой строке. Отдельного типа колонки «Вычисляемый» в редакторе таблицы нет. Такие расчеты должны быть предусмотрены логикой конкретного типа документа; обычный реквизит «Вычисляемый» настраивается отдельно от колонок таблицы.
Пример настройки таблицы
Для перечня позиций с количеством и пояснениями можно создать такую структуру:
| Заголовок | Код колонки | Тип данных | Настройка |
|---|---|---|---|
| № | num |
Счетчик | Автоматическая нумерация при печати. |
| Наименование | item |
Строка | Основная видимая колонка. |
| Количество | quantity |
Число | Ограничение положительными значениями, если это нужно для документа. |
| Примечание | comment |
Текст | Развернутое пояснение к каждой позиции. |
Включите строку итогов и задайте item для подписи «Итого:». Заполните две строки с количеством 2 и 3: при печати они получат номера 1 и 2, а сумма количества составит 5.00. Для выбора позиций из номенклатуры замените тип колонки «Наименование» на «Товар» или «Услуга».
Само добавление товара или услуги в ячейку не определяет учетную операцию: списание, оказание услуги и начисление оплаты зависят от назначения и логики типа документа.
6. Вычисляемый
Показывает результат формулы, использующей значения других реквизитов. Пользователь заполняет исходные поля, а вычисляемое значение получает автоматически; вручную изменить его в форме нельзя.
В настройке «Выражение» укажите формулу с кодами реквизитов. Например, count * price вычисляет произведение значений полей с кодами count и price. В «Формате вывода» задается представление результата, в том числе число знаков после запятой. Перед использованием проверьте расчет и печать на заполненном документе.
7. Изображение
Поле для загрузки одного изображения с возможностью просмотра в форме и вывода в печатном документе. Подходит, когда изображение должно находиться в определенном месте бланка.
Для отображения поддерживаются JPEG и PNG. Если загрузить файл другого формата, вместо изображения может появиться сообщение «Невозможно визуализировать файл». Параметр «Ширина изображения» регулирует его размер при выводе. Для произвольных файлов, которые достаточно хранить при документе, используйте вложения документа.
8. Справочник
Позволяет выбирать запись из одного из справочников программы. В настройке «Справочник» укажите, откуда брать значения. При заполнении документа сотрудник выбирает запись, а в печатной форме выводится ее название.
Используйте этот тип, когда один набор значений нужен в разных документах и должен поддерживаться централизованно. Если варианты относятся только к одному полю, обычно достаточно типа «Выбор».
9. Выбор организации
Выбор одной из собственных организаций клиники, заведенных в программе. Реквизит сохраняет связь с выбранной организацией, а не только введенное вручную название.
Подходит для документов, в которых нужно явно указать собственную организацию. Для выбора клиента, поставщика или другого внешнего участника используйте «Выбор контрагента». Нужные сведения об организации включаются в печатную форму в соответствии с ее настройками.
10. Выбор пользователя
Позволяет выбрать пользователя программы из списка незаблокированных пользователей клиники. Например, поле может обозначать сотрудника, ответственного за конкретную часть документа. При печати выводится имя выбранного пользователя.
Значение хранится как отдельный реквизит. Сам выбор пользователя в таком поле не меняет автора документа.
11. Множественный выбор
Набор вариантов с флажками, из которых можно отметить несколько одновременно. Подходит для перечней признаков или выполненных действий, где ответы не исключают друг друга.
Для вариантов задаются подписи в форме и тексты для печати. Вывод можно настроить по-разному: показывать все варианты или только отмеченные, размещать их в строку или столбец, использовать обозначения флажков или выводить только текст.
12. Выбор склада
Выбор склада для документа. Список учитывает филиал документа и права пользователя на склады; удаленные склады исключаются.
Если документ должен работать со складами разных филиалов, у реквизита можно включить «Не использовать фильтрацию по филиалам». При печати выводится название выбранного склада. Само заполнение поля не заменяет оформление предусмотренной документом складской операции.
13. Выбор кассы
Выбор учетной кассы клиники. В список включаются действующие, неудаленные кассы филиала документа. При необходимости доступна настройка «Не использовать фильтрацию по филиалам».
В печатной форме выводится название кассы. Этот реквизит обозначает место учета денежных средств; для выбора устройства, на котором формируется фискальный чек, предусмотрен отдельный тип «Выбор фискального регистратора».
14. Выбор магазина
Позволяет выбрать магазин филиала документа из числа неудаленных. Используется в документах, которым нужна связь с определенным магазином.
При печати выводится название выбранного магазина. Для выбора места хранения товаров используйте реквизит «Выбор склада»: магазин и склад обозначают разные объекты учета.
15. Кнопки действий
Добавляет в форму документа кнопки для выполнения действий, предусмотренных его типом. Для каждой кнопки задаются подпись и «Код операции».
Действие должно быть заранее реализовано в логике типа документа. Произвольное название или код сами по себе не создают новую операцию. Это элемент управления формой, а не поле для хранения текста; добавлять его следует при наличии известной поддерживаемой операции.
16. Выбор даты
Поле для ввода календарной даты. Подходит, например, для даты события или срока, который нужно сохранить в документе. В печатной форме дата отображается в формате день, месяц и год.
Поле только хранит дату. Если требуется создать плановый визит пациента, используйте специальный тип «Дата запланированного визита».
17. Выбор времени
Поле для ввода времени в часах и минутах. При отсутствии значения в форме подставляется текущее время; при заполнении его можно изменить.
Используется для фиксации времени события в документе. Само по себе не создает запись на прием и не резервирует интервал расписания.
18. Выбор отделения
Выбор одного из неудаленных отделений клиники. При печати выводится название отделения. Подходит, когда документ нужно связать с организационным подразделением.
Отделение и филиал клиники — разные сущности. Выбор отделения в реквизите не заменяет выбор филиала самого документа.
19. Выбор контрагента
Поле для поиска и выбора контрагента: клиента, поставщика или другого участника расчетов. В форме предусмотрены поиск, открытие списка, добавление и редактирование контрагента; доступность действий зависит от прав пользователя.
Настройка «Фильтровать по наличию договора типа» позволяет ограничить выбор контрагентами с договорами нужного типа. В печатную форму можно включать название и другие данные выбранного контрагента через соответствующие переменные. Этот реквизит также служит основой для зависимых полей договора, расчетного счета, филиала контрагента и счета на оплату.
20. Выбор фискального регистратора
Позволяет выбрать неудаленный фискальный регистратор филиала документа. Используется в типах документов, чья логика предусматривает работу с таким устройством.
Выбор регистратора указывает нужное оборудование. Формирование и печать чека выполняются соответствующим действием программы; само заполнение реквизита чек не создает.
21. Выбор договора
Выбор договора с контрагентом, указанным в другом реквизите документа. Сначала создайте поле «Выбор контрагента», затем укажите его в настройке договора «Отбор договоров по полю». Дополнительно можно ограничить список типом договора.
При заполнении учитываются выбранный контрагент и организация филиала документа; удаленные договоры исключаются. Пока контрагент не указан, зависимое поле не показывается. Если найден подходящий договор по умолчанию, он может подставиться автоматически. При печати выводится название договора.
22. Выбор расчетного счета
Выбор банковского счета контрагента или организации клиники. В настройке «Отбор счета по полю» укажите реквизит с контрагентом либо вариант «[Филиал документа]» для счетов организации филиала.
В форме предлагаются счета выбранного владельца с номером и названием. Пока источник не настроен или связанный контрагент не выбран, поле недоступно для заполнения. При создании документа может подставляться счет по умолчанию. Этот тип обозначает банковские реквизиты; для ссылки на выставленный счет используется «Выбор счета контрагенту».
23. Выбор ставки НДС
Выпадающий список ставок НДС, предусмотренных программой для системы налогообложения организации. Пользователь выбирает готовый вариант; произвольный текст в этом поле не вводится.
Используется в расчетных и учетных документах, которым требуется значение ставки. Применение выбранной ставки в суммах и печатной форме зависит от настроек и логики конкретного типа документа.
24. Список заказов
Поле для показа сведений о заказах, подготовленных логикой конкретного типа документа. В форме оно выводит готовое содержимое и не предоставляет самостоятельный выбор заказов или ручной ввод списка.
Простое добавление такого реквизита не собирает заказы пациента автоматически. Используйте его в типах документов, где предусмотрено заполнение этого списка; порядок вывода в печать также определяется настройками документа.
25. Выбор диагноза
Позволяет выбрать диагноз из справочника и при необходимости отметить «Диагноз является предварительным». При печати выводится полное название диагноза с указанием предварительного характера, если установлен флажок.
При сохранении документа пациента выбранный диагноз регистрируется у пациента со связью с этим документом. Поэтому для такой регистрации нужен именно этот тип реквизита: обычный текст с названием диагноза остается текстом документа.
26. Дата запланированного визита
Поле даты, которое при сохранении документа пациента создает связанный плановый визит. Подходит для назначения повторного посещения с последующей обработкой в разделе плановых визитов.
В настройке «Реквизит с комментарием к планируемому визиту» можно выбрать поле типа «Строка» или «Текст», чтобы использовать его содержимое как комментарий к визиту. Если комментарий не задан, формируется пояснение с указанием документа.
При изменении документа дата и комментарий обновляются у связанного визита, пока он находится в исходном состоянии и еще не обработан. Этот реквизит не бронирует время специалиста в расписании. Для даты без создания визита используйте «Выбор даты».
27. Идентификатор лабораторного анализа
Поле для номера лабораторной пробы, по которому программа связывает документ с результатами оборудования. Это идентификатор анализа, а не отдельный измеренный показатель. В форме предусмотрены ввод номера, кнопка «Заполнить» для получения результатов и очистка значения.
Для работы необходима настроенная связь с лабораторным оборудованием. У типа документа должна быть включена настройка «Документ данного типа связан с лабораторным оборудованием», а у реквизита — выбраны соответствующие модели анализаторов. В полях результатов типа «Строка» или «Число» настраивается «Значение результата анализа».
После сохранения документа с идентификатором программа связывает пробу с документом для обработки результатов. Одного добавления поля без настройки оборудования и сопоставления показателей недостаточно для автоматического заполнения.
28. Выбор филиала контрагента
Выбор филиала внешнего контрагента. В настройках укажите поле со значением контрагента, от которого зависит список филиалов.
В форме сначала выбирается контрагент, затем один из его филиалов. Без выбранного контрагента зависимое поле скрыто. Этот реквизит относится к структуре контрагента и не меняет филиал клиники, в котором оформляется документ.
29. Выбор услуги
Поле поиска и выбора одной услуги из номенклатуры. Настройка «Группа услуг» позволяет ограничить поиск определенной группой. При печати выводится название выбранной услуги.
Используйте его, когда в документе нужна ссылка на услугу. Регистрация факта ее оказания и начисление оплаты выполняются предусмотренными для этого действиями; обычный выбор услуги в реквизите их не заменяет.
30. QR код по ссылке
Пользователь вводит ссылку в текстовое поле. При сохранении документа по ней формируется изображение QR-кода для печатной формы. Получатель может отсканировать код, чтобы открыть указанный адрес.
Размер вывода задается параметром «Ширина изображения». После сохранения проверьте код в печатной форме и убедитесь, что он ведет по нужному адресу. Переменная этого реквизита предназначена для вывода изображения кода, а не только исходного текста ссылки.
31. Выбор счета контрагенту
Позволяет найти и выбрать уже созданный активный документ «Счет контрагенту». В настройках укажите «Поле контрагента» и «Поле договора» — реквизиты, по которым будет отбираться счет.
Сначала в документе выбирается контрагент и договор, затем соответствующий им счет. До выбора контрагента поле счета скрыто. В списке и печатной форме счет обозначается названием и датой. Выбор связывает документы; он не создает новый счет и не регистрирует оплату.
Проверка настроенного реквизита
После изменения настроек откройте документ этого типа и проверьте заполнение поля. Для зависимых списков сначала заполните исходные реквизиты: например, контрагента перед договором. Для вычисляемого поля проверьте результат на понятных исходных значениях.
Затем добавьте нужные переменные через «Менеджер переменных» в печатную форму, сохраните документ и проверьте просмотр и печать. Для специальных расчетных реквизитов используйте представление, предусмотренное печатной формой и логикой типа документа.
Удаление реквизита
Ошибочно созданные реквизиты можно удалить. Удаление затрагивает структуру типа документа и работу с этим полем в ранее созданных документах. Штатной отмены удаления нет.
При удалении убираются описание реквизита, его варианты выбора, настроенные исходные данные таблицы и связанные значения норм. Значения поля в ранее сохраненных документах этой операцией напрямую не удаляются, но поле исчезает из формы, а его вывод при печати может нарушиться. Перед удалением используемого поля проверьте связанные формулы, условия и печатную форму.
Следующая статья: Печатная форма