Обработка документов

Большинство ответных действий с документом выполняется с помощью метода PatchTask.AddToPatch().

1. Создайте PatchTask, см. Box.CreatePatchTask().

2. Определите с какими документами и что необходимо сделать.

3. Передайте в PatchTask документы и действие.

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

5. Отправьте сформированные ответы.

Ниже примеры для наиболее часто используемых действий. Другие действия можно найти в описании метода PatchTask.AddToPatch().

• Подписание документа
• Отказ в подписи
• Отправка извещения о получении
• Согласование
• Аннулирование

Кроме PatchTask существуют объекты для выполнения некоторых операций в фоне:

• Объекты для фоновой обработки документов
  • Извещения о получении
  • Отмена фиксации кодов маркировки

Примечание

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

Примечание

Метод PatchTask.AddToPatch() возвращает коллекцию PatchItem. Учитывайте, что в некоторых сценариях, в поле PatchItem.Document может лежать не тот документ, который был передан в PatchTask.AddToPatch(). Например, для закрытых пакетов.

А если передавалась коллекция документов, то не для каждого из них может быть соответсвующий PatchItem. В методе PatchTask.AddToPatch() происходит фильтрация подходящих под действие документов.