Document

Объект является базовым объектом для всех типов документов . Обладает базовым набором свойств и методов, которые также работают для всех производных типов документов.

Свойства

Type:

Строка, чтение - тип документа

Не рекомендуется, начиная с версии 5.21.0: Используйте тройку TypeNamedId, DocumentFunction, Version

TypeNamedId:

Строка, чтение - строковый идентификатор типа документа

Добавлено в версии 5.21.0.

DocumentFunction:

Строка, чтение - функция документа

Добавлено в версии 5.21.0.

Version:

Строка, чтение - информация о версии XSD схемы, в соотвествии с которой сформирован документ

Добавлено в версии 5.21.0.

Organization:

Organization , чтение - организация, которая отправила исходящий документ, либо получила входящий документ

OrganizationId:

Строка, чтение - идентификатор организации, которой принадлежит документ

Не рекомендуется, начиная с версии 5.31.0: Используйте поле OrganizationGuid

OrganizationGuid:

Строка, чтение - идентификатор организации, которой принадлежит документ

Добавлено в версии 5.31.0.

Counteragent:

BoxInfo , чтение - контрагент документа. Для внутренних документов будет пустым

DocumentId:

Строка, чтение - идентификатор документа

OneSDocumentId:

Строка, чтение - дополнительный идентификатор документа

PackageId:

Строка, чтение - идентификатор пакета

Direction:

Строка, чтение - направление документа. Возможные значения

Department:

Department , чтение - подразделение организации, к которому привязан документ

FromDepartment:

Department , чтение - подразделение организации, из которого был отправлен документ

Добавлено в версии 3.0.8.

ToDepartment:

Department , чтение - подразделение организации, в которое был отправлен документ

Добавлено в версии 3.0.8.

Timestamp:

Дата и время, чтение - дата и время отправки документа (в текущем часовом поясе)

TimestampSeconds:

Число, чтение - дата и время отправки документа в секундах

Не рекомендуется, начиная с версии 5.30.2.

DocumentDate:

Дата, чтение - дата документа

DocumentNumber:

Строка, чтение - номер документа

Title:

Строка, чтение - название документа, например, Счет-фактура №123 от 20.02.18

FileName:

Строка, чтение - имя файла документа, с которым он загружался в Диадок

PathURL:

Строка, чтение - URL документа, по которому он доступен в web-интерфейсе

InitialDocumentIds:

Коллекция строк, чтение - коллекция идентификаторов документов, на который ссылается данный документ (т.е. документы, которые по отношению к данному документы являются «родительскими»

SubordinateDocumentIds:

Коллекция строк, чтение - коллекция идентификаторов документов, которые ссылаются на данный документ (т.е. документы, которые по отношению к данному документу являются «дочерними»)

CustomDocumentId:

Строка, чтение - идентификатор документа, определяемый внешней системой

RouteId:

Строка, чтение - идентификатор маршрута согласования, на котором находится документ

WorkflowId:

Целое число, чтение - идентификатор типа документооборота

Status:

Строка, чтение - текущий статус документа в Диадоке. Перечень возможных значений зависит от типа документа и описан в спецификации соответствующего производного объекта

ResolutionStatus:

ResolutionStatus , чтение - текущий статус запрошенного согласования или подписи документа

Resolutions:

Коллекция объектов Resolution , чтение - история резолюций документа: согласований, подписаний, аннулирований

ResolutionRequests:

Коллекция объектов ResolutionRequest , чтение - история запросов резолюций документа: запросов согласований, запросов подписаний, запросов аннулирований

ResolutionRequestDenials:

Коллекция объектов ResolutionRequestDenial , чтение - коллекция объектов отказов по резолюциям

RevocationStatus:

Строка, чтение - статус аннулирования документа. Возможные значения

SenderSignatureStatus:

Строка, чтение - статус проверки ЭЦП отправителя. Возможные значения

RecipientResponseStatus:

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

ProxySignatureStatus:

Строка, чтение - статус промежуточной подписи. Возможные значения

Добавлено в версии 5.31.0.

RoamingNotificationStatus:

Строка, чтение - статус передачи документа через роуминг. Возможные значения

Добавлено в версии 5.3.1.

RoamingNotificationStatusDescription:

Строка, чтение - описание статуса передачи документа через роуминг

Добавлено в версии 5.3.1.

LastExternalStatuses:

коллекция объектов ExternalStatusLite , чтение - набор последних статусов внешнего документооборота

Добавлено в версии 5.32.0.

CustomData:

Коллекция объектов CustomDataItem , чтение - коллекция тэгов документа

Metadata:

Коллекция объектов MetadataItem , чтение - коллекция метаданных

RecipientReceiptMetadata:

RecipientReceiptMetadata , чтение - метаданные извещения о получении документа получателем

ConfirmationMetadata:

ConfirmationMetadata , чтение - метаданные подтверждения оператором отправки/получения документа или служебного документа

AmendmentRequestMetadata:

AmendmentRequestMetadata , чтение - метаданные уведомления об уточнении

IsDeleted:

Булево, чтение - флаг, показывающий, был ли удален данный документ

IsTest:

Булево, чтение - флаг, показывающий, что документ является тестовым и не имеет юридической силы

HasCustomPrintForm:

Булево, чтение - флаг, показывающий, что документ имеет нестандартную печатную форму

Добавлено в версии 3.0.10.

IsLockedPackage:

Булево, чтение - флаг, показывающий, что документ является частью нередактируемого пакета

Добавлено в версии 5.3.0.

IsRead:

Булево, чтение - флаг, показывающий, что документ был прочитан сотрудником организации

IsEncryptedContent:

Булево, чтение - флаг, показывающий, что содержимое документа зашифровано

Добавлено в версии 5.3.0.

EditingSettingId:

Строка, чтение - идентификатор настройки редактирования содержимого документа. Наличие данной настройки означает, что в содержимом файла может отсутствовать контент, редактирование которого разрешено данной настройкой

Добавлено в версии 5.29.13.

Методы

SaveContent() GetComment() GetDocumentPackage()
SaveBuyerContent() GetAnyComment() CreateReplySendTask()
SaveAllContent() Move() CreateReplySendTask2()
SaveAllContentAsync() Delete() CreateOutDocumentSignTask()
SaveAllContentZip() MarkAsRead() CreateResolutionRequestTask()
SaveAllContentZipAsync() SendRevocationRequest() CreateCustomDataPatchTask()
GetDynamicContent() AcceptRevocationRequest() AssignToResolutionRoute()
GetBase64Content() RejectRevocationRequest() RemoveFromResolutionRoute()
GetBase64ContentAsync() AddSubordinateOneSDocumentId() SetOneSDocumentId()
GetBase64Signature() RemoveSubordinateOneSDocumentId() ReSetOneSDocumentId()
GetBase64OriginalSignature() GetPrintForm() GetExternalStatuses()
GetSenderSignature() Approve()  
GetRecipientSignature() Disapprove()  
Document.SaveContent(FilePath)
FilePath:Строка Путь до файла, в который будет записан контент

Сохраняет титул отправителя на диск в указанный файл. Если файла не существует, то он будет создан, иначе перезаписан

Document.SaveBuyerContent(FilePath)
FilePath:Строка Путь до файла, в который будет записан контент

Сохраняет титул получателя документа в указанный файл. Если файла не существует, то он будет создан, иначе перезаписан. Если титул отсутсвует, то ничего не произойдёт

Document.SaveAllContent(DirectoryPath, WithProtocol=false)
DirectoryPath:Строка Путь до директории, в которой будут сохранены файлы
WithProtocol:Булево Признак необходимости сохранения протокола передачи документа

Сохраняет все файлы, относящиеся к документу (в т.ч. электронные подписи), в указанную директорию

Document.SaveAllContentAsync(DirectoryPath, WithProtocol=false)
DirectoryPath:Строка Путь до директории, в которой будут сохранены файлы
WithProtocol:Булево Признак необходимости сохранения протокола передачи документа

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

Document.SaveAllContentZip(FilePath)
FilePath:Строка Путь до файла, в который будет сохранён архив

Формирует архив, содержащий все файлы, относящиеся к документу (в т.ч. электронные подписи), и сохраняет его в указанный файл. Если файла не существует, то он будет создан, иначе перезаписан

Document.SaveAllContentZipAsync(FilePath)
FilePath:Строка Путь до файла, в который будет сохранён архив

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

Document.GetDynamicContent(DocflowSide)
DocflowSide:Строка Сторона документооборота, чей титул будет представлен. Возможные значения

Возвращает представление контента титула документа со стороны DocflowSide. Если запрашиваемого титула у документа нет, то результатом будет Undefined / Неопределено. Если для данного документа не существует схемы, в которой можно представить контент документа, то так же результатом будет Undefined / Неопределено

Document.GetBase64Content(DocflowSide)
DocflowSide:Строка Сторона документооборота, чей титул будет представлен. Возможные значения

Возвращает контент титула документа со стороны DocflowSide в виде Base64 строки

Document.GetBase64ContentAsync(DocflowSide)
DocflowSide:Строка Сторона документооборота, чей титул будет представлен. Возможные значения

Возвращает контент титула документа со стороны DocflowSide в виде Base64 строки

Document.GetBase64Signature(DocflowSide)
DocflowSide:Строка Сторона документооборота, подпись титула которой будет представлена. Возможные значения

Возвращает подпись с меткой времени к титулу документа со стороны DocflowSide в виде Base64 строки

Document.GetBase64OriginalSignature(DocflowSide)
DocflowSide:Строка Сторона документооборота, подпись титула которой будет представлена. Возможные значения

Возвращает оригинальную подпись (обычно без метки времени) титула документа со стороны DocflowSide в виде Base64 строки

Document.GetSenderSignature()

Возвращает представление подписи титула отправителя

Document.GetRecipientSignature()

Возвращает представление подписи титула получателя

Document.GetComment()

Возвращает строку с комментарием к документу, заданным при отправке

Не рекомендуется, начиная с версии 5.20.3: Используйте GetAnyComment() с типом AttachmentComment

Document.GetAnyComment(CommentType)
CommentType:строка Тип комментария. Возможные значения

Возвращает строку с комментарием определённого типа, связанным с документом

Добавлено в версии 5.20.3.

Document.Move(DepartmentId)
DepartmentId:Строка Идентификатор подразделения

Перемещает документ в указанное подразделение

Document.Delete()

Помечает документ как удаленный

Document.Approve([Comment])
Comment:Строка Комментарий, который будет указан при согласовании

Согласует документ

Document.Disapprove([Comment])
Comment:Строка Комментарий, который будет указан при отказе согласования

Отказывает в согласовании документа

Document.SetOneSDocumentId(ID)
ID:Строка Любая строка, идентифицирующая документ в учётной системе

Присваивает документу дополнительный идентификатор из учётной системы

Не рекомендуется, начиная с версии 5.29.9: Используйте Organization.CreateDataTask()

Document.ReSetOneSDocumentId()

Сбрасывает дополнительный идентификатор учётной системы у документа в Диадоке

Не рекомендуется, начиная с версии 5.29.9: Используйте Organization.CreateDataTask()

Document.AddSubordinateOneSDocumentId(ID)
ID:Строка Любая строка, идентифицирующая документ в учётной системе

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

Не рекомендуется, начиная с версии 5.29.9: Используйте Organization.CreateDataTask()

Document.RemoveSubordinateOneSDocumentId(ID)
ID:Строка Любая строка, идентифицирующая документ в учётной системе

Удаляет дополнительный подчинённый идентификатор

Не рекомендуется, начиная с версии 5.29.9: Используйте Organization.CreateDataTask()

Document.CreateResolutionRequestTask()

Создает задание для отправки запроса согласования

Document.GetPrintForm(FilePath, Timeout=30)
FilePath:Строка Путь до файла, в который будет сохранена печатная форма
Timeout:Беззнаковое целое число Таймаут за который необходимо получить печатную форму в секундах

Получает печатную форму документа в формате .pdf и сохраняет её в указанный файл. Если расширение файла отличается от .pdf, то такой файл будет создан

Добавлено в версии 3.0.10.

Document.GetDocumentPackage()

Возвращает пакет документов, в котором находится документ

Добавлено в версии 5.3.0.

Примечание

понятие пакета в терминах компоненты и в терминах HTTP-API или Веб-интерфейса разные. В данном случае в пакете будут содержаться только те документы, у которых LetterId/MessageId (первая половина DocumentId) совпадает со значением в исходном документе. Не стоит ожидать, что если документы связаны в пакет в веб интерфейсе, то все они вернутся в этом методе.

Document.CreateReplySendTask(ReplyType="AcceptDocument")
ReplyType:Строка Тип ответа. Возможные значения

Создает задание на выполнение ответного действия с документом

Не рекомендуется, начиная с версии 5.27.0: Используйте Document.CreateReplySendTask2()

Document.CreateReplySendTask2(ReplyType="AcceptDocument")
ReplyType:строка Тип ответа. Возможные значения

Создает задание на выполнение ответного действия с документом

Добавлено в версии 5.27.0.

Document.CreateOutDocumentSignTask()

Создает задание на подписание и отправку исходящего документа с отложенной отправкой

Добавлено в версии 5.6.0.

Document.MarkAsRead()

Помечает, что документ как прочитанный

Document.CreateCustomDataPatchTask()

Создает задание на редактирование коллекции CustomData

Document.AssignToResolutionRoute(RouteId[, Comment])
RouteId:строка Идентификатор маршрута
Comment:строка Комментарий, который будет добавлен при постановке документа на маршрут

Ставит документ на маршрут согласования. Получить доступные маршруты согласования можно методом Organization.GetResolutionRoutes()

Document.RemoveFromResolutionRoute(RouteId[, Comment])
RouteId:строка Идентификатор маршрута
Comment:строка Комментарий, который будет добавлен при снятии документа с маршрута

Снимает документ с маршрута согласования

Document.SendRevocationRequest([Comment])
Comment:строка комментарий к запросу аннулирования

Запрашивает аннулирование документа

Добавлено в версии 3.0.3.

Не рекомендуется, начиная с версии 5.27.0: Используйте Document.CreateReplySendTask2()

Document.AcceptRevocationRequest()

Принимает запрос аннулирования

Добавлено в версии 3.0.3.

Не рекомендуется, начиная с версии 5.27.0: Используйте Document.CreateReplySendTask2()

Document.RejectRevocationRequest()

Отказывает в аннулировании

Добавлено в версии 3.0.3.

Не рекомендуется, начиная с версии 5.27.0: Используйте Document.CreateReplySendTask2()

Document.GetExternalStatuses()

Возвращает коллекцию внешних статусов документа

Добавлено в версии 5.32.0.

Дополнительная информация

Объекты, производные от Document Описание
Contract договор
Invoice счет-фактура
InvoiceRevision исправление счета-фактуры
InvoiceCorrection корректировочный счет-фактура
InvoiceCorrectionRevision исправление корректировочного счета-фактуры
Nonformalized неформализованный документ
NonformalizedAcceptanceCertificate акт о выполнении работ в неформализованном виде
NonformalizedTorg12 ТОРГ-12 в неформализованном виде
NonformalizedProforma счет на оплату
XmlAcceptanceCertificate акт о выполнении работ в формализованном виде
XmlTorg12 ТОРГ-12 в формализованном виде
Utd универсальный передаточный документ
UtdRevision исправление универсального передаточного документа
Ucd универсальный корректировочный документ
UcdRevision исправление универсального корректировочного документа
BaseDocument документ произвольного типа