Документ - структура и редактирование

Структура документа

Содержимое каждого Документа описывается с помощью набора информационных полей различного типа. Набор полей создается для каждого определенного Вида документа разработчиками Carabi Solutions Web.

Примеры типов информационных полей Документа:

Подробнее про поля Документа вы можете прочитать здесь

Для удобства, поля Документа разделены на две группы:

  1. Основная информация по документу
  2. Дополнительная информация о документе сгруппированная по вкладкам

Карточка документа - блоки информации.png

Основная информация по документу

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

Дополнительная информация о документе

Часто для удобства пользователя в Карточке документа требуется отобразить расширенную информацию о документе. Примеры:

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

Наименование выбранной активной вкладки выделено синим цветом с нижним подчеркиванием:

Карточка документа - активная вкладка.png

Информация на вкладке может быть представлена двумя способами:

  1. Одиночный Документ с отображением полей
  2. Список Документов с отображением в виде таблицы

Пример вкладки с полями одиночного документа:

Для строительного заказа во вкладке "Объект работ" размещено подробное описание проекта в виде набора полей:

Карточка документа - допинфа по полям.png

Пример вкладки со списком документов:

Нужно показать Документ "Накладная" вместе с составами накладной. Тогда составы накладной можно разместить в виде таблицы во вкладке "Состав накладной". Каждая строка таблицы представляет собой информацию по одному составу накладной:

Карточка документа - накладная - составы.png

В этом случае можно кликнуть по любому Составу накладной и в соседней вкладке приложения откроется Документ "Состав накладной". Работу с представлениями Документов в виде таблицы подробнее смотрите здесь.

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

Информационные поля документа

Содержимое каждого Документа описывается с помощью набора информационных полей различного типа. Набор полей создается для каждого определенного Вида документа разработчиками Carabi Solutions Web.

Особенности информационных полей Документа:

У информационного поля есть наименование и значение:

Карточка документа - поля.png

Значение поля – это конкретные данные, хранимые в поле.

Например, каждый Документ "Физическое лицо" соответствует некоторому конкретному физическому лицу.  У одного Документа поле с наименованием "Фамилия" обладает значением - "Иванов", у другого Документа может быть значение "Петров", у третьего - "Сидоров" и т.д. 

Типы данных полей

Данные, хранимые в значениях полей, могут быть различных типов.

Простой тип данных

Является базовым типом и предназначен для хранения значений простых типов. Например:

Примеры заполнения простого типа данных:

Тип данных - Число: 

image.png

Тип данных - Текст:

image.png

Тип данных - Дата:

image.png

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

image.png

Словарный тип данных

Представляет собой словарь, список всех возможных значений некоторых данных, которые должны быть описаны точно и однозначно. При нажатии на поле, которое содержит словарное значения, открывается выпадающее окно, где следует выбрать нужное значение или множество значений из словаря и нажать кнопку "Применить". Например, поле словарного типа "Условия оплаты":

image.png

Если необходимо изменить состав словарного поля, то обратитесь к администратору платформы Carabi Solutions Web.

Ссылочный тип данных

Ссылочный тип данных - это такой тип данных поля в Документе, который не содержит самих значений, он ссылается на другой Документ на платформе Carabi Solutions Web.

Наличие в Документе поля ссылочного типа означает, что между несколькими Документами устанавливается логическая связь. Связи могут быть двух типов:

Примеры связей и их отображения в Карточке документа:

1.Так выглядит связь "один к одному" в Навигаторе Карточки документа:

Карточка документа - ссылка один к одному.png

Для изменения ссылочного поля нужно кликнуть по нему:

Карточка документа - ссылка один к одному 2.png

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

Карточка документа - ссылка один к одному 3.png

2.Так выглядит связь "один ко многим" в Навигаторе Карточки документа:

Карточка документа - ссылка один ко многим.png

Если в Карточке документа требуется отобразить ссылку "один ко многим", то для этого используются вкладки в нижней части экрана. Так выглядят составы накладной в Карточке документа "Накладная":

Карточка документа - ссылка один ко многим 3.png

Обязательность заполнения полей

Бывают обязательные к заполнению поля и необязательные. При создании и сохранении документа система проверяет, все ли обязательные поля заполнены. Если хотя бы одно обязательное поле не заполнено, то система выдает предупреждение и не сохраняет Документ.

Нижняя граница обязательных к заполнению полей выделена красным цветом, например:

Карточка документа - обязательные поля.png

Действия с полями и уровни доступа по редактированию

В зависимости от Роли пользователя и статуса Документа поля могут быть доступны к редактированию и недоступны к редактированию.

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

Нижняя граница полей без доступа к редактированию выделена серым цветом:

Карточка документа - поля нередактируемые.png

Если переместить курсор на поле без возможности редактирования, то такое поле подсвечивается серым цветом:

image.png

Существуют поля, которые отображаются не для всех Ролей пользователя. Например, в одной и той же карточке документа "Клиент", пользователь под ролью "Бухгалтер" видит платежные реквизиты и контакты клиента, а пользователь под ролью "Менеджер" видит только контакты клиента

Управляющие элементы поля

В правой части поля, в зависимости от типа данных и доступа, могут располагаться управляющие полем элементы.

Карточка документа - управляющие элементы поля.png

image.png - элемент "Корзина" отвечает за очистку значения поля

image.png - этот элемент может находиться только в ссылочном поле.

Если кликнуть на элементimage.png, то сразу открывается Документ, на который установлена ссылка:

image.pngimage.png

 Если кликнуть по значению поля, то открывается список Документов, для установления ссылки на нужный Документ:

image.pngimage.png

Сохранение документа

Для сохранения, внесенных в поля документа изменений, необходимо нажать на кнопку "Сохранить", расположенную в правом верхнем углу экрана приложения:

image.png

Если все обязательные поля документа заполнены и по бизнес-процессу, в котором документ принимает участие, все условия соблюдены, то документ успешно сохранится. Иначе, пользователь увидит всплывающее окно с предупреждением или описанием ошибки.


Revision #15
Created 6 May 2025 11:40:42 by Кропотов Роман
Updated 29 June 2026 12:03:28 by Кропотов Роман