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

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

Добавьте группу состояний и подключите её к типу, для которого хотите настроить состояния версий.
Создайте роль согласования, согласно которой будет работать автоматизация при подписании документа.
Добавьте скрипт автоматизации.

Пример настройки базы данных для работы с состояниями версий документов реализован в демонстрационных базах данных.

Добавление группы состояний

Для добавления группы состояний:

Откройте тип, который является документом, например, Документ.
В карточке Редактирование типа найдите поле Группа состояний версий документа, раскройте его и перейдите в диалог Управление группами состояний...
Создайте новую группу состояний, например DocumentVersionsState.
Откройте окно Состояния, используя команду Выбор состояний. Создайте одно или несколько новых состояний, если необходимо. Например, В производство работ (intoProduction).
Выберите несколько состояний в группу. Например, В производство работ, Аннулирован, <нет>.

Настройте переходы между ними. Например, из <нет> в Аннулирован и в В производство работ. Из Аннулирован в <нет>. Из В производство работ в Аннулирован.

Установите Роль для выполнения действия, кому будет доступно осуществление настроенных переходов.

Обратите внимание, если вы используете одно состояние в разных группах, например, Аннулирован (annuled) для группы состояний версий документов и для атрибута типа состояние у документов, то при настройке фильтра в обозревателе элементов по этому состоянию, будут отфильтрованы все элементы, имеющие данное состояние.

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

Создание роли подписанта

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

Перейдите в тип Задание на согласование (task_approval);
Выберите и откройте на редактирование атрибут Роль согласования (signingRole);
В дополнительные параметры добавьте роль, например, <Item>В производство работ</Item>.

Теперь эту роль можно использовать в скрипте автоматизации.

Добавление скрипта автоматизации

Пример автоматизации DocumentVersionsStateManager можно скопировать из демонстрационных баз данных или из комплекта разработчика.

Добавьте скрипт на вкладку С# и сценарий на вкладку JSON. Заполните параметры в сценарии согласно описанию действия.