Пользовательские схемы

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

Когда это имеет смысл

• Документ от одного поставщика с нестандартным оформлением.
• Отраслевые особенности: весовые талоны, протоколы испытаний, топливные карты.
• Поля, которые вам нужны в вашей системе и нигде больше не встречаются.

Учтите, что документ с пользовательской схемой нельзя отправить в бухгалтерию или экспортировать в бухгалтерские форматы — они читают фиксированные поля счета. Остаются JSON, XML, YAML, CSV, Excel и PDF. В отчеты попадает только документ, который имеет числовое поле TotalAmount.

Как определить

С помощью редактора на вкладке Схемы. Пишется в JSON Schema — объект с properties, у каждого поля type и description, списки как array с items. Кто знает стандарт, не будет удивлен; кто не знает, начнет с шаблона (счет, счет с НДС, чек, накладная, минимальный) или с копии системной схемы. Поля шаблонов имеют английские названия, как и системные схемы, так что к ним форма контроля найдет описание; описания полей на языке интерфейса и могут быть переписаны.

Ссылки, allOf, oneOf, условия и подобные конструкции редактор не вводит; схема должна быть плоским деревом полей. Копия системной схемы также несет свои задания для модели, поэтому распознает также хорошо, как и шаблон; с помощью кнопки Отсоединить она становится обычной пользовательской схемой.

Описание поля — это инструкция для модели

Это самая важная часть всей страницы. description предназначено не только для человека, его читает и модель. Разница между «номер заказа» и «номер заказа, начинается с Z- и состоит из шести цифр, обычно находится в правом верхнем углу у штрих-кода» колоссальная для успешности.

Ограничения

Количество полей определяется тарифом: 80 на Free и Starter, 160 на Business, 240 на Scale. Считаются также вложенные поля и поля элементов. Названия и описания отправляются модели для каждого документа, поэтому более длинная схема означает более дорогую обработку.

Тестирование

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

Изменения и удаление

Модифицированная схема действует для дальнейшей обработки. Документы, которые уже прошли, сохраняют данные в том виде, в котором они были созданы. Схему, по которой был распознан хотя бы один документ, удалить нельзя — документы потеряли бы форму контроля.