<< Click to Display Table of Contents >> Объектная модель > Базовое решение Directum RX > Docflow – документооборот > Иерархия документов > OfficialDocument – официальный документ Контроль возврата документов (выдача) |
![]() ![]() |
Журнал записей о передаче (выдаче и возврате) документа сотрудникам и/или контрагентам (карточка документа, закладка «Выдача»). Ситуации использования описаны в разделе «Выдача и возврат документов».
Имя свойства |
Отображаемое имя |
---|---|
Действие |
|
Кому передан |
|
Оригинал |
|
Срок возврата |
|
Дата возврата |
|
Дата выдачи |
|
Результат возврата |
|
Примечание |
|
Задача возврата |
|
Итерация |
|
External link Id |
*Action (Действие): Перечисление
Действие, совершенное с оригиналом или копией бумажного документа.
Имя |
Отображаемое имя |
---|---|
Delivery |
Выдача сотруднику |
Sending |
Отправка контрагенту |
Endorsement |
Согласование с контрагентом |
Delivery указывается тогда, когда запись создается вручную. Отражает факт передачи документа сотруднику. Если свойство ReturnDate (Дата возврата) заполнено, то запись нельзя удалять и редактировать.
Sending указывается программно в рамках задачи на согласование по регламенту. Отражает факт отправки документа контрагенту. Если свойство ReturnDate (Дата возврата) заполнено, то запись нельзя удалять и редактировать.
Endorsement указывается программно в рамках задачи на согласование документа по регламенту. Отражает факт отправки документа контрагенту с контролем подписания документа со стороны контрагента. Удаление записей с данным действием запрещено. Если свойство ReturnDate (Дата возврата) заполнено, то запись нельзя редактировать.
*DeliveredTo (Кому передан): Sungero.Company.Employee
Сотрудник, кому передан документ. Если документ передается на подписание контрагенту, то это сотрудник, ответственный за контроль возврата документа. Программно заполняется в следующих случаях:
•В схеме задачи в блоке «Отправка контрагенту» в обработчике события «Выполнение задания» заполняется исполнителем этапа «Контроль возврата», либо исполнителем текущего этапа, если в регламенте нет этапа «Контроль возврата».
•В диалоге по действию «Через сервис обмена» заполняется текущим пользователем.
Используется в фильтрации папок «Документы у сотрудников», «Документы к возврату» и «Документы у контрагентов», в диалогах выдачи/возврата, в отчете «Контроль возврата документов» и при формировании LocationState (Местонахождения).
IsOriginal (Оригинал): Логическое
Признак того, что был выдан оригинал документа. Используется только при программном формировании метки о местонахождении документа.
*DeliveryDate (Дата выдачи): Дата
Фактическая дата передачи оригинала или копии документа.
ReturnDeadline (Срок возврата): Дата
Планируемая дата возврата документа.
ReturnTask (Задача возврата): Sungero.Workflow.Task
Ссылка на задачу на контроль возврата документа или на задачу на согласование по регламенту.
ReturnDate (Дата возврата): Дата
Фактическая дата возврата документа.
ReturnResult (Результат возврата): Перечисление
Результат возврата документа.
Имя |
Отображаемое имя |
---|---|
Returned |
Возвращен |
Signed |
Подписан |
Not Signed |
Не подписан |
AtControl |
На контроле |
Returned. Возвращен сотрудником. Значение можно установить вручную в табличной части в проводнике. Также заполняется программно при выполнении задания на контроль возврата.
AtControl. Сотрудник выполнил задание на возврат документа и ожидается подтверждение возврата документа делопроизводителем. Заполняется только программно в рамках задачи на контроль возврата документа.
Signed. Документ подписан контрагентом. Заполняется только программно в рамках задачи на контроль возврата документа или фоновым процессом обработки поступивших документов из сервисов обмена.
NotSigned. Контрагент отказал в подписании документа. Заполняется только программно в рамках задачи на контроль возврата документа или фоновым процессом обработки поступивших документов из сервисов обмена.
Note (Примечание): Строка (250)
Пояснение к действию, совершенному с документом. Носит информативный характер.
Устанавливается программно в схеме задачи на согласование по регламенту в блоке «Отправка контрагенту» в обработчике события «Выполнении задания». Может быть указано сотрудником в диалоге выдачи бумажного экземпляра документа.
Номер итерации согласования документа в рамках задачи на согласование по регламенту. Скрытое свойство, заполняется в обработчике события «Изменение значения свойства» свойства ReturnTask (Задача возврата). Номер итерации отделяет записи в коллекции Tracking (Выдача) текущего круга задачи на согласование по регламенту от предыдущих.
В схеме задачи в блоке «Контроль возврата» в обработчике события «Старт задания» проверяется необходимость автоматического выполнения задания, если документ уже был возвращен. В коллекции Tracking (Выдача) берется запись с номером итерации = <Номер итерации текущей задачи на согласование по регламенту> и ReturnTask (Задача возврата) = <Ссылка на текущую задачу на согласование по регламенту>. Если ReturnResult (Результат возврата) заполнен, то задание выполняется программно.
ExternalLinkId (External link Id): Идентификатор
ИД записи справочника Информация о документе обмена. Скрытое свойство, заполняется программно при отправке и получении документов из сервисов обмена. Используется для:
•определения того, что документ был отправлен через сервисы обмена, при:
•возврате документов контрагенту через действие «Вернуть документ»;
•проверке возможности редактирования записей в коллекции Tracking (Выдача) (некоторые свойства записи с заполненным данным свойством редактировать нельзя);
•создании задач на контроль возврата документа (задачи не создаются для записей с заполненным данным свойством);
•формировании отчета «Контроль возврата документов». В отчет попадают документы, выданные сотрудникам или отправленные контрагентам традиционным способом; в таких ситуациях данное свойство будет не заполнено;
•формировании LocationState (Местонахождения);
•связи документов в сервисе обмена с документами в Directum RX при отправке ответа контрагенту и при получении ответа от контрагента.
IsReturnRequired (Требуется возврат): Логическое
Признак того, что требуется возврат документа от сотрудника.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) ищется хотя бы одна запись с заполненным ReturnDeadline (Сроком возврата), выданная сотруднику (Action (Действие) = Delivery) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено).
Недоступно на карточке в проводнике. Используется при вычислении папок «Документы к возврату» модуля «Делопроизводство» и «Документы у сотрудников» модуля «Договоры», а также при определении доступности действия «Вернуть документ».
DeliveredTo (Кому передан): Sungero.Company.Employee
Сотрудник, кому передан документ.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) берется запись с минимальным ReturnDeadline (Сроком возврата), выданная сотруднику (Action (Действие) = Delivery) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено). Если сотрудников с одинаковым сроком несколько, то берется тот, кому был выдан оригинал (IsOriginal (Оригинал) = True).
Недоступно на карточке в проводнике. Используется для отображения в списках.
ReturnDeadline (Срок возврата): Дата
Плановая дата возврата документа от сотрудника.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) берется запись с минимальным ReturnDeadline (Сроком возврата), выданная сотруднику (Action (Действие) = Delivery) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено).
Недоступно на карточке в проводнике. Используется для отображения в списках.
ReturnDate (Дата возврата): Дата
Фактическая дата возврата документа.
Вычисляется программно при сохранении документа. Если IsReturnRequired (Требуется возврат) = False, то в коллекции Tracking (Выдача) берется запись с максимальной ReturnDate (Датой возврата), иначе свойство не заполняется.
Недоступно на карточке в проводнике. Используется для отображения в списках.
IsHeldByCounterparty (Требуется возврат от контрагента): Логическое
Признак того, что требуется возврат документа от контрагента.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) ищется хотя бы одна запись с заполненным ReturnDeadline (Сроком возврата), отправленная контрагенту на согласование (Action (Действие) = Endorsement) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено).
Недоступно на карточке в проводнике. Используется при вычислении папок «Документы у контрагента» модуля «Договоры» и «Документы к возврату» модуля «Делопроизводство», а также при определении доступности действия «Вернуть документ».
ResponsibleForReturnEmployee (Ответственный за возврат): Sungero.Company.Employee
Ответственный за возврат документа от контрагента.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) берется запись с минимальным ReturnDeadline (Сроком возврата), отправленная контрагенту на согласование (Action (Действие) = Endorsement) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено). Если записей с одинаковым сроком несколько, то берется запись с минимальной DeliveryDate (Датой выдачи).
Недоступно на карточке в проводнике. Используется при вычислении папки «Документы у контрагента» модуля «Договоры» и для отображения в других списках.
ScheduledReturnDateFromCounterparty (Срок возврата от контрагента): Дата
Планируемая дата возврата документа от контрагента.
Вычисляется программно при сохранении документа. В коллекции Tracking (Выдача) берется запись с минимальным ReturnDeadline (Сроком возврата), отправленная контрагенту на согласование (Action (Действие) = Endorsement) и еще не возвращенная (свойство ReturnDate (Дата возврата) не заполнено).
Недоступно на карточке в проводнике. Используется при вычислении папки «Документы у контрагента» модуля «Договоры» и для отображения в других списках.
Логика работы функциональности по контролю возврата документов
Контроль возврата документов от сотрудников
1.Выдача документа через диалог по действию «Выдать документ» либо вручную добавлением записи на вкладке «Выдача».
В обработчике данного действия создается запись в дочерней коллекции Tracking (Выдача) с Action (Действие) = Delivery.
Если было заполнено свойство ReturnDeadline (Срок Возврата), то в обработчике события «До сохранения» документа создается задача на контроль возврата (исполнитель = DeliviredTo (Кому передан), срок = ReturnDeadline (Срок возврата)). Ссылка на задачу сохраняется в поле ReturnTask (Задача возврата).
2.Выполнение задания на возврат сотрудником, вернувшим документ.
В схеме задачи в блоке «Возврат документа» в обработчике события «Выполнение задания» свойство ReturnResult (Результат возврата) устанавливается значением AtControl для записи с ReturnTask (Задача возврата) = <Ссылка на задачу на возврат>.
3.Выполнение задания на контроль возврата делопроизводителем.
В схеме задачи в блоке «Контроль возврата документа» в обработчике события «Выполнение задания» устанавливается ReturnResult (Результат возврата) в значение Returned для записи с ReturnTask (Задача возврата) = <Ссылка на задачу на возврат>.
4.Если отметка о возврате документа делопроизводителем производится вручную (на вкладке «Выдача»), либо по действию «Вернуть документ».
В обработчике события «До сохранения» документа прекращается задача на контроль возврата документа (задача определяется по ReturnTask (Задача возврата)).
В обработчике события «До сохранения» документа запускаются обработчики активных блоков мониторинга задачи на контроль возврата документа (задача определяется по ReturnTask (Задача возврата)). Запущенные обработчики мониторингов завершают задачу на контроль возврата.
Обмен документами с контрагентами
1.Обмен традиционными способами (без использования сервисов обмена).
•Выполнение задания на отправку документа контрагенту.
Если в правиле согласования есть этап «Контроль возврата», то будут созданы записи в дочерней коллекции Tracking (Выдача) согласно таблице:
Документ подписан |
События |
|
---|---|---|
Нашей орг. |
Контрагентом |
|
Нет |
Нет |
Создается две записи с Action (Действие) = Endorsement Моделируем ситуацию, когда контрагенту уходят 2 экземпляра документа на подписание, и они оба должны вернуться, чтобы подписать с нашей стороны. |
Да |
Нет |
Создается две записи: с Action (Действие) = Sending и Action (Действие) = Endorsement Моделируем ситуацию, когда контрагенту уходят 2 экземпляра документа, подписанных нашей стороной. После подписания контрагентом, один экземпляр должен вернуться, другой экземпляр остается у контрагента. |
Да |
Да |
Создается запись с Action (Действие) = Sending Моделируем ситуацию, когда документы уже подписаны всеми сторонами и нужно вернуть экземпляр контрагента. |
Если этапа нет, то создается запись в дочерней коллекции Tracking (Выдача) с Action (Действие) = Sending
•Выполнение задания на контроль возврата документа от контрагента.
В схеме задачи на блоке «Контроль возврата» в обработчике события «Выполнение задания» свойство ReturnResult (Результат возврата) устанавливается значением Signed/NotSigned (в соответствии с результатом выполнения задания) для записи с ReturnTask (Задача возврата) = <Ссылка на задачу на согласование по регламенту>.
2.Обмен электронными документами через сервисы обмена (ЮЗДО). Доступен как в рамках задачи на согласование по регламенту, так и без нее.
•Документ создается в нашей организации, подписывается и отправляется контрагенту. Отправляется через диалог по действию «Через сервис обмена».
Если в диалоге не была запрошена подпись получателя, то в обработчике данного действия создается запись в дочерней коллекции Tracking (Выдача) с Action (Действие) = Sending.
Если в диалоге была запрошена подпись получателя, то в обработчике данного действия создается запись в дочерней коллекции Tracking (Выдача) с Action (Действие) = Endorsement, ExternalLinkId (External link Id) = <ИД записи справочника «Информация о документе обмена»>.
•Фоновая обработка подписания документов контрагентом, отправленных в п.2.2.1.
В обработчике фонового процесса GetMessages, при поступлении ответа от контрагента, для записи с ExternalLinkId (External link Id) = <ИД записи справочника «Информация о документе обмена»>, свойство ReturnResult (Результат возврата) устанавливается значением Signed/NotSigned (в соответствии с ответом контрагента). Все активные задания на контроль возврата выполняются с соответствующим результатом, если обмен происходил в рамках задачи на согласование по регламенту или возврат контролировался в рамках блока «Контроль возврата от контрагента».
•Документ создается у контрагента, подписывается им и отправляется нам на подписание. После подписания нами отправляется ответ контрагенту. Отправляется через диалог по действию «Через сервис обмена».
В обработчике данного действия создается запись в дочерней коллекции Tracking (Выдача) с Action (Действие) = Sending.
© Компания Directum, 2024 |