Поля ввода данных

Поля

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

Для добавления полей ввода данных в шаблон:

  1. Установите курсор в тексте шаблона.
  2. Нажмите кнопку Добавить поле на панели инструментов и выберите тип поля.
  3. Заполните параметры поля на панели справа.

Введенные параметры сохранятся автоматически. Добавленное поле появится в тексте, а также на боковой панели.

Типы полей:

  • Текст – поле для ввода текста, см. подробнее: Текст;
  • Расширенный текст – поле для добавления в документ форматированного текста из Case.one: Расширенный текст;
  • Выбор – поле с выбором значения из списка, см. подробнее: Выбор;
  • Число – поле для ввода числового значения, см. подробнее: Число;
  • Дата – поле для ввода значений в формате даты, см. подробнее: Дата;
  • Формула – поле для формирования текста в документе на основании значений других полей и арифметических операций над ними, см. подробнее: Формула;
  • QR код – поле для публикации в документе QR кода, сформированного на основе заданного пользователем значения, см. подробнее: QR код;
  • Компания – поле для для загрузки в документ данных о компании по ее ИНН, см. подробнее: Компания.

Текст

Используйте поле Текст, для добавления текстового значения в документ, например, фамилия, наименование заказчика, адрес и т.д.

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;
  • Множественная форма – задайте конвертацию введенного пользователем значения во множественное число в тексте документа:
    • Нет – не конвертировать, значение по умолчанию;
    • Да – конвертировать;
    • Зависит от значения поля – конвертировать, если значение указанного поля больше одного;
  • Язык – выберите язык конвертации: русский или английский. Поле отображается, если в поле Множественная форма выбрано любое значение, кроме Нет;
  • Поле – выберите поле, от значения которого будет зависеть конвертация. Поле отображается, если в поле Множественная форма выбрано значение Зависит от значения поля.

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

Расширенный текст

Поле Расширенный текст позволяет добавить в документ форматированный текст, включая списки, таблицы и изображения. Используйте поле при формировании документа по шаблону в Case.one для добавления в документ данных объекта из полей с типом Текстовое расширяемое.

ВниманиеСейчас поле можно заполнить только при интеграции Case.one с Doc.one.

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Внешний идентификатор – идентификатор поля во внешних системах. Чтобы поле было заполнено данными при формировании документа, укажите в параметре тег поля из Case.one.

При формировании документа контент из поля в Case.one будет вставлен в документ отдельным абзацем с новой строки. Форматирование текста в документе будет максимально сохранено, однако некоторые параметры, например, списки, будут приведены к стандартному виду Doc.one, так как Doc.one поддерживает только один стиль маркированных и нумерованных списков.

Выбор

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

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Значения – для указания вариантов ответа. Вводите каждый ответ с новой строки;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;
  • Множественная форма – задайте конвертацию введенного пользователем значения во множественное число в тексте документа:
    • Нет – не конвертировать, значение по умолчанию;
    • Да – конвертировать;
    • Зависит от значения поля – конвертировать если значение указанного поля больше одного;
  • Язык – выберите язык конвертации: русский или английский. Поле отображается, если в поле Множественная форма выбрано любое значение, кроме Нет;
  • Поле – выберите поле, от значения которого будет зависеть конвертация. Поле отображается, если в поле Множественная форма выбрано значение Зависит от значения поля.

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

Число

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

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;
  • Формат – выбор типа числа:
    • Целое число – целое число (по умолчанию);
    • Дробное число – дробное число;
    • Валюта – сумма в выбранной валюте до копеек, центов и т.д.;
    • Валюта (округленно) – округленная до целого числа сумма в выбранной валюте;
  • Валюта – выбор валюты. Отображается, если выбрано отображение результата в формате денежной суммы. Доступные значения: РублиДолларыЕвро;
  • Преобразовывать в текст – выберите Да, если в документе введенное значение нужно представить в виде текста;
  • Язык – выбор языка. Доступные языки: русский, английский. Отображается, если выбрана конвертация значения в текст;
  • Падеж – выбор падежа при конвертации в текст. Отображается, если выбран русский язык.

Подробнее о преобразовании значения поля в текст см. Как преобразовать числовое значение поля в текст.

Дата

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

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;
  • Формат даты – выберите в списке формат отображения даты. Если поле используется в разных частях шаблона, настройки формата необходимо указывать для каждого использования;
  • Язык – укажите, на каком языке отображать название месяца в поле (русский/английский).

При формировании документа Doc.one позволяет вводить в поле Дата только цифры, прочие символы игнорируются.

После заполнения поля выполняется проверка введенных значений. Поле выделяется цветом, если:

  • Дата указана не полностью (заполнены не все ячейки маски);
  • В поле указана несуществующая дата.

Также для ввода значений в поля Дата можно использовать календарь. Неделя в календаре начинается с понедельника.

Формула

Используйте поле Формула, чтобы показать результат вычислений значений других полей и арифметических операций над ними. Так можно вычислить и автоматически добавить в документ сумму двух введенных ранее числовых значений, вычислить процент от суммы и т.д.

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Формула – для ввода формулы;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Формат – выбор формата отображения результата вычислений:
    • Дробное число – дробное число;
    • Целое число – целое число (по умолчанию);
    • Валюта – сумма до копеек, центов и т.д.;
    • Валюта (округленно) – округленная сумма до целого числа;
  • Валюта – выбор валюты. Отображается, если выбрано отображение результата в формате денежной суммы. Доступные значения: РублиДолларыЕвро;
  • Преобразовывать в текст – выберите Да, если в документе введенное значение нужно представить в виде текста;
  • Язык – выбор языка. Доступные языки: русский, английский. Отображается, если выбрана конвертация значения в текст;
  • Падеж – выбор падежа при конвертации в текст. Отображается, если выбран русский язык.

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

Доступны арифметические операции:

  • Сложение – "+";
  • Вычитание – "-";
  • Умножение – "*";
  • Деление – "/". Приоритет арифметических операций соответствует правилам математики. Для изменения приоритета используйте круглые скобки.

Вы можете использовать поле Число в формулах. Для этого в текст формулы введите символ # и выберите значение в списке полей Число шаблона и его блоков. Для поиска конкретного поля начните ввод его наименования - Doc.one оставит в предложенном списке только те поля, названия которых содержат введенные символы.

Одно поле можно использовать несколько раз в пределах одной формулы.

Если пользователь переименовал поле в шаблоне, Doc.one актуализирует представление этого поля в формуле.

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

Если поле, на которое ссылается формула, было удалено из шаблона или изменило свой идентификатор, оно будет выделено оранжевым цветом.

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

Если результатом вычисления формулы является дробное число, оно округляется до двух знаков после запятой (символ разделителя используется из настроек инстанса).

Если в формуле используются поля, значения которых еще не указаны пользователем, Doc.one подставляет на их место 0. Если формула невалидна (например, если формула ссылается на удаленное поле), в тексте документа отобразится значение "#VALUE!".

Вы можете настроить отображение результатов вычисления формулы в виде текста в документе. См. подробнее: Как преобразовать числовое значение поля в текст.

QR код

Используйте поле QR код для публикации в документе QR кода. Код формируется на основе заданного пользователем значения.

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если вы работаете с другими системами и передаете в них шаблоны или документы Doc.one, укажите идентификатор поля для синхронизации шаблона;
  • Значение – значение, на основе которого формируется код;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;

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

QR код отображается в виде изображения 100х100px. Если будет изменено значение на боковой панели документа или шаблона (если в документе поле не заполнено), код и его изображение изменится.

Вы можете добавить поле QR код в:

  • колонтитул;
  • текст шаблона или блока;
  • таблицу.

На QR код можно наложить условие.

Вы можете использовать поле несколько раз в пределах шаблона.

Если код содержится в типовом блоке, то после открепления текста от блока, QR код не отображается.

Компания

Используйте поле Компания для загрузки в документ данных о компании по ее ИНН. Данные заполняются через интеграцию Doc.one с сервисом CaseBook через API CaseBook. По умолчанию интеграция доступна на всех инстансах.

Боковая панель содержит параметры поля:

  • Название – для ввода названия поля. По умолчанию указано название, совпадающее с типом поля. Обязательно для заполнения;
  • Обязательное поле – если для формирования документа обязательно нужно заполнить данное поле, выберите значение Да, если заполнение необязательно – Нет. Система не позволит скачать документ, пока не будут заполнены все обязательные поля;
  • Подсказка – для ввода подсказки. Введенная подсказка будет отображаться пользователю при наведении на поле в редакторе документа;
  • Внешний идентификатор – идентификатор поля во внешних системах. Если Doc.one взаимодействует с внешними системами и передает в них шаблоны или документы, укажите идентификатор поля для синхронизации шаблона. Указанную по умолчанию подсказку можно изменить;
  • Видимость – по умолчанию все добавленные поля видимы в документе. Если вы хотите скрыть, но не удалять поле, выберите значение Скрыть в параметре Видимость – тогда документ будет формироваться без учета этого поля, поле не будет отображаться в тексте и на боковой панели документа. Для отображения поля выберите Показать;
  • Данные – данные компании, которые будут загружаться в документ после ввода ИНН. Значение выбирается из списка. Параметр Данные индивидуален для каждого поля Компания, в том числе для каждой его копии.

Как заполнить реквизиты компании, введя только ее ИНН

Представим, что в документах вы каждый раз заполняете реквизиты компании-партнера:

  • Название;
  • Юридический адрес;
  • ИНН;
  • КПП;
  • ОГРН.

Doc.one позволяет автоматически заполнять все эти реквизиты, просто введя ИНН компании.

Для быстрого заполнения реквизитов компании добавьте в шаблон поле Компания:

  1. Установите курсор в тексте и нажмите кнопку Добавить поле.
  2. Выберите тип поля Компания. Поле добавлено в шаблон. Справа появилась панель параметров поля.
  3. Заполните параметры. Измените название поля на содержательное, например, Заказчик. Укажите обязательность поля, подсказку, видимость и пр.
  4. Выберите тип данных, которые будут заполнены в документе после ввода ИНН компании. В нашем примере это Наименование.
  5. Установите курсор в тексте ниже добавленного поля.
  6. Выберите поле в списке боковой панели и нажмите кнопку .
  7. Выберите пункт Вставить в текст. Поле с таким же названием будет добавлено в шаблон.
  8. Выберете это поле в тексте. Справа появились параметры для этой копии поля.
  9. Сейчас в параметре Данные выберите Адрес организации.
  10. Повторите действия для каждого реквизита компании. Выберите последовательно значения данных ИНН, КПП, ОГРН.
  11. Опубликуйте шаблон, чтобы применить изменения.

Теперь пользователю при составлении документа достаточно только указать ИНН компании в поле Заказчик, чтобы все нужные реквизиты компании появились в документе.

Редактировать поле

Для редактирования поля:

  1. Откройте вкладку Поля боковой панели. Появится список полей, которые добавлены в шаблон.
  2. Выберите поле в списке и нажмите кнопку .
  3. Выберите Редактировать.

Новые параметры поля будут сохранены автоматически.

Как добавить существующее поле в текст шаблона

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

Для добавления в текст поля из списка полей шаблона:

  1. Установите курсор в тексте шаблона в том месте, куда нужно добавить поле.
  2. Перейдите на вкладку Поля боковой панели. Отобразится список полей, которые уже добавлены в шаблон.
  3. Выберите поле в списке и нажмите кнопку .
  4. Выберите Вставить в текст.

Поле будет добавлено в шаблон в том месте, где был установлен курсор.

ПримечаниеИзменение поля влечет его изменение во всех местах использования.
ВниманиеDoc.one запрещает создание блока, если поле используется в тексте создаваемого блока и где-то вне этого текста.

Как преобразовать числовое значение поля в текст

Если вам нужно, чтобы в документах число или денежная сумма была написана текстом (стоимость услуги, количество товара, пени и т.д.), то следует добавить числовое поле и настроить его на отображение в виде текста. Тогда в документах указанное число будет написано текстом в заданном вами падеже.

Например, вам нужно в договоре указать текстом стоимость оплаты: "Оплата производится в размере 3150 рублей".

Для этого:

  1. Добавьте в шаблон текст: "Оплата производится в размере".
  2. Установите курсор после слова "в размере" и нажмите кнопку Добавить поле на панели управления.
  3. Выберите тип Число. В тексте появилось поле ввода.
  4. Укажите формат числа Валюта (округленно), так как требуется добавить денежную сумму без копеек.
  5. Укажите валюту Рубли.
  6. Теперь нужно настроить отображение числа в виде текста. Выберите значение Да в поле Преобразовывать в текст.
  7. Выберите Русский в поле Язык.
  8. Укажите падеж для слова в скобках. В данном случае - родительный.

Шаблон для нашего примера готов. Теперь для указания денежной суммы текстом вам достаточно создать документ на основе этого шаблона и указать в нем значение поля.

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

Удалить поле

Способ 1:

  1. Перейдите на вкладку Поля боковой панели. Отобразится список полей, которые добавлены в шаблон.
  2. Выберите поле в списке боковой панели и нажмите кнопку .
  3. Выберите Удалить.
  4. Подтвердите действие в появившемся окне.

Способ 2:

Найдите поле в тексте шаблона. Установите курсор слева или справа от него и нажмите клавишу Delete / Backspace.

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