Подготовка документа к подписанию

Добавление информации в титул

Если вам нужно добавить информацию о подписанте к уже сгенерированному документу, — подготовьте его к подписанию методом PrepareDocumentsToSign. Этот метод позволяет автоматически добавить в XML-файл титула формализованного документа информацию о подписанте.

Обратите внимание, что метод позволяет указать информацию только об одном подписанте. При этом количество подписей под документом не ограничено.

Подготовка к подписанию доступна не для всех документов: определить возможность подготовки документа к подписанию можно с помощью свойства DocumentTypeDescriptionV2.DocumentFunctionV2.DocumentVersionV2.SupportsContentPatching, полученного методом GetDocumentTypes (V2). Инструкция о получении данных из метода GetDocumentTypes приведена на странице Получение информации о типе документа.

К подписанию можно подготовить:

• черновик,

• неотправленный исходящий документ

• незагруженный в Диадок формализованный документ.

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

Метод PrepareDocumentsToSign принимает на вход данные подписанта в структуре PrepareDocumentsToSignRequest, а в ответе возвращает список документов, подготовленных к подписанию и отправке.

В зависимости от типа заполнения данных подписанта, укажите данные подписанта в структуре PrepareDocumentsToSignRequest следующим образом:

• SignerType = 1 — заполните структуру Signer.

• SignerType = 2 — заполните структуру ExtendedSigner.

• SignerType = 3 — передайте данные подписанта в универсальном формате в поле SignerContent. Чтобы его подготовить:

  • Получите файл XSD-схемы упрощенного XML-файла подписанта с помощью метода GetDocumentTypes (V2). Инструкция о получении данных для подписанта из метода GetDocumentTypes приведена в разделе Данные для заполнения блока подписанта.

  • Подготовьте по полученной схеме упрощенный XML-файл подписанта. О том, как это сделать, написано в разделе Универсальный формат заполнения данных подписанта.

Заполнение имени файла в документах формата приказа №970

Атрибут ИдФайл для документов в формате приказа №970 имеет вид R_T_A_O_GGGGMMDD_N1_N2_N3_N4_N5_N6_N7. Описание префиксов доступно в разделе Формат имени файла.

Во время подготовки к отправке методом PrepareDocumentsToSign документы проходят валидацию на соответствие формату и содержимому документа. Если в ИдФайл будет обнаружено несоответствие, то Диадок сформирует верное значение. Автоматическое заполнение имени файла работает по следующим правилам:

• Если ИдФайл соответствует формату и содержимому документа, то он останется неизменным.

• Если ИдФайл не заполнен или не соответствует формату, то Диадок сформирует ИдФайл на основе содержимого документа. Значения будут установлены следующим образом:

  • N2 = 1, если в документе есть атрибут СведПрослеж. В ином случае N2 = 0.

  • N3 = 1, если в документе есть атрибут НомСредИдентТов. В ином случае N3 = 0.

  • N4 = 0.

  • N5 = 0.

  • N6 = 1, если в документе есть атрибут КодВидПр. В ином случае N6 = 0.

  • N7 = 00.

  Обратите внимание, что значения N4 = 1 и N5 = 1 можно указать только вручную. ИдФайл при этом должен соответствовать формату, в ином случае значения будут автоматически изменены на N4 = 0 и N5 = 0. В документе нет атрибутов, по которым Диадок мог бы установить наличие признака.

• Если ИдФайл соответствует формату, но в нем отсутствуют или не соответствуют формату только идентификаторы получателя и отправителя, то сначала Диадок заполнит эти значения, а затем запустит валидацию.

  Значения будут установлены следующим образом:

  • A = GUID получателя, если в структуре PrepareDocumentsToSignRequest был передан атрибут ToBoxId. В ином случае A = xxxx.

  • O = GUID отправителя.

• Если атрибут ИдФайл отсутствует в документе, то Диадок не сможет заполнить его.