# Карточка экземпляра процесса

> [HTML Version](360012498891.html)

**Карточка экземпляра** — это инструмент для контроля и управления запущенным бизнес-процессом. Позволяет отслеживать статус выполнения, просматривать историю, контекстные данные и схему процесса в реальном времени. При необходимости выполнение экземпляра можно прервать. Администратор системы может также обновить его до последней версии процесса, архивировать или удалить.

В статье описано:

- кому доступна карточка экземпляра и где её можно открыть;

- какая информация отображается на вкладках **История**, **Контекст** и **Карта процесса**; 

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

## Кому и где доступна карточка экземпляра

Открыть карточку экземпляра может:

- администратор системы — на страницах [Монитор процессов](360010403439.md), [Монитор ошибок](error_monitor.md), [Массовые операции](bulk-operations.md), [Архивация экземпляров процессов](process-archiving.md);

- пользователь без прав администратора системы — только по прямой ссылке. Например, при упоминании пользователя в ассоциированной ленте карточки экземпляра он получит оповещение с ссылкой на экземпляр. Пользователь может перейти в карточку по ссылке и просмотреть сообщение. Чтобы такой сценарий выполнился, в [настройках процесса](360012263052.md#associated-tape) должна быть выбрана ассоциированная лента бизнес-процесса.

Права доступа обычного пользователя к данным и действиям в карточке экземпляра определяются его ролью в процессе. Подробнее об этом читайте в статье [«Доступ к задачам и экземплярам процесса»](access-to-tasks-and-instances.md#process-access).

## Содержание карточки экземпляра

В карточке экземпляра отображаются:

**(Instance-page-3.png)**

1. Верхняя панель с кнопками:

- **(update-instance.png)**— обновить карточку экземпляра для отображения актуальных данных;

- **(process_map.png) **— открыть карту процесса;

- **(tracing-process-instance-icon.png) **— [посмотреть список трейсов](#tracing);

- **(fullscreen-button.png) **— перейти в полноэкранный режим;

- значок крестика — закрыть карточку экземпляра.

2. Вкладки [История](#history_tab), [Контекст](#context_tab), [Карта процесса](#process_map).

3. Боковая панель, на которой можно посмотреть:

- статус экземпляра:

	- **Ожидание** — активный экземпляр, ожидающий выполнения действия, например завершения задачи или срабатывания таймера;

	- **Выполняется** — активный экземпляр с неполадками, например, если автоматическое действие долго обрабатывается;

	- **Прерван** — исполнение экземпляра остановлено;

	- **Завершен** — экземпляр процесса успешно выполнен;

	- **Ошибка** — в ходе процесса возникла ошибка;

	- **Архив** — прерванный или завершённый экземпляр, который отправлен в архив. Доступно, если в компании [включена архивация экземпляров процессов](process-archiving.md);

- версию процесса, дату и время запуска экземпляра, а также инициатора запуска;

- сообщения, отправленные сотрудниками из процессных задач. Обратите внимание, в карточках задач и экземпляра процесса может отображаться как лента процесса, так и лента элемента приложения или файла. Это зависит от [настроек ленты](360012263052.md#associated-tape) в дизайнере процесса.

4. Нижняя панель с кнопками:

- **Прервать процесс** — прекратить исполнение процесса, если он стал неактуален или в ходе процесса возникла ошибка, которая не может быть решена другим способом. Доступно инициатору процесса и пользователям с [правами доступа на управление процессами](360007527512.md#assign).

Обратите внимание, если для текущего процесса [заданы правила прерывания](360012263052.md#interruption) и у него есть дочерний или родительский процессы, выполнение их экземпляров автоматически прервётся;

- **Обновление версии** — применить к уже запущенному экземпляру последние изменения, внесённые в процесс. Доступно [администратору системы](360006871932.md#administrators), если экземпляр не обновлён до актуальной версии. Допустим, экземпляр был запущен с утра, а в обед уже была опубликована новая версия процесса с важными правками. Нажмите кнопку, чтобы ход процесса обновился и внесённые изменения появились в карте экземпляра;

- **Архивировать**, **Разархивировать** — отправить прерванный или завершённый экземпляр в архив или вернуть его оттуда. Доступно администратору, если в компании [включена архивация экземпляров процессов](process-archiving.md);

- **Удалить безвозвратно** — [удалить экземпляр процесса](delete-instance.md) со статусом **Прерван**, **Завершен** или **Архив**. Также из раздела **Задачи** удалятся закрытые задачи, поставленные в рамках этого экземпляра. Доступно администратору системы, если в компании активирована такая возможность.

### Вкладка «История»

На вкладке **История** отображается информация по выполнению каждого блока на схеме процесса. Вы можете просмотреть исполнителя, срок выполнения операции, дату и время её запуска и завершения. На панели справа отображается название процесса, дата его запуска, инициатор и лента бизнес-процесса.

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

Для блоков в списке используются цветовые обозначения:

- синий цвет — активные пользовательские задачи и таймеры. После выполнения они перечёркиваются, при этом цвет таймера меняется на чёрный;

- серый цвет — другие блоки, действия в которых выполняются автоматически;

- красный цвет — просроченные задачи и блоки с ошибкой выполнения.

На вкладке доступны следующие действия:

1. Если вы являетесь автором задачи или в настройках доступа к приложению вам [выданы права на управление процессами](360007527512.md), то можете открыть карточку любой задачи и переназначить её с текущего исполнителя на другого пользователя.

2. Вы можете перейти к диалогу с исполнителем задачи в карточке экземпляра. Для этого нажмите на имя пользователя и выберите опцию **Написать сообщение**.

3. Если процесс остановился на каком‑либо шаге с ошибкой, вы можете перезапустить этот шаг или пропустить его, чтобы возобновить работу. Подробнее об этом читайте в статье [«Возобновить экземпляр процесса»](restart-process.md).

Вы также можете [прервать процесс](#interrupt-process) и [обновить](#update-version) его.

### Вкладка «Контекст»

На вкладке **Контекст** по умолчанию показываются все контекстные переменные процесса и их значения. Это удобно, если вам нужно получить информацию о нескольких параметрах экземпляра — все данные отображаются на одной вкладке. 

**(process_context.PNG)**

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

При необходимости можно скрыть определённые контекстные переменные. Эта настройка осуществляется в дизайнере бизнес-процессов. Подробнее о том, как добавить или скрыть переменные, читайте в статье [«Вкладка „Настройки“»](360012263052.md#instance_page_settings).

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

### Вкладка «Карта процесса»

Карта — это схема процесса, на которой в реальном времени отображается ход выполнения задач. Чтобы открыть её, перейдите на вкладку **Карта процесса** или нажмите на верхней панели значок **(process_map.png).**

**(hmfile_hash_15be91d2.png)**

С помощью карты вы можете отслеживать, какие работы уже выполнены, а к каким участники процесса ещё не приступили. Блоки на схеме обведены:

- синим контуром — выполненные задачи и переходы;

- зелёным контуром — текущие операции;

- красным контуром — при выполнении операции возникла ошибка. 

### Трассировка скриптов бизнес-процесса

Если для процесса включён сбор трейсов в разделе **Администрирование > Инструменты разработчика**, [администратор системы](360006871932.md#administrators) может проанализировать выполнение его скриптов. Это позволяет оценить продолжительность отдельных запросов, оптимизировать код и выявить причины ошибок. Чтобы посмотреть список трейсов, в правом верхнем углу карточки экземпляра нажмите значок **(tracing-process-instance-icon.png). **

Подробнее о настройке трассировки и информации в карточке трейса читайте в статье [«Трассировка серверных скриптов»](server-script-tracing.md#trace-content).

## Форма карточки экземпляра 

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

Форма карточки редактируется в дизайнере на вкладке **Настройки**. Подробнее об этом читайте в статье [«Вкладка „Настройки“»](360012263052.md#instance_page_settings).

**(process-settings-4.png)**