Загрузка и показ документов - Сценарии ExtSdk2 — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 5 промежуточных версий 2 участников)
Строка 1: Строка 1:
Чтобы загрузить и показать документ во внешней системе необходимо получить ссылку на интересующее вложение как указано в статье [https://sbis.ru/help/integration/api/sequence/visual_doc Отобразить вложение документа в API]. После получения ссылки можно по перейти по ней и посмотреть документ в браузере. Так же можно скачать данные по ссылке через метод [[LoadDataFromURLToFile | LoadDataFromURLToFile ]], принимающий на вход ссылку для скачивания и имя сохраняемого файла.
+
Данная статья описывает функционал позволяющий организовать как просмотр электронных документов находящихся в СБИС, так и электронных документов подготовленных к отправке.
  
=== Пример вызова и получение ответа===
+
==Просмотр и загрузка электронных документов СБИС==
 +
Данный раздел описывает как организовать просмотр карточки электронного документа СБИС. Данный просмотр может быть реализован для любого документа СБИС. Для инициализации просмотра достаточно знать только идентификатор документа.
  
<syntaxhighlight lang="python" line='line'>
+
Просмотр карточки электронного документа СБИС как правило используется при клике на строки списка документов полученного соответствующими методами API, либо из карточки документа информационной системы (при условии что в системе хранится связь между документом ИС и документом СБИС.
  
    #Пример вызова
+
Для просмотра документа необходимо получить информацию о документе при помощи метода [https://sbis.ru/help/integration/api/all_methods/read_doc СБИС.ПрочитатьДокумент] через [[CallSabyApi|CallSabyApi]] Данный метод позволит показать данные карточки документа и список вложений / файлов (электронных документов).
    query_id = str(uuid.uuid4())
+
При клике пользователя на вложение интеграционный модуль должен получить представление документа. На каждом вложении есть ссылки по которым можно скачать представление в HTML или PDF виде.
    module_method = "ExtSdk2.LoadDataFromURLToFile "
+
* Ссылка HTML представление хранится в свойстве - СсылкаНаHTML
    parameters_module_method = json.dumps({"Url": ссылка, "FileName": имя сохраняемого файла}, ensure_ascii=True)
+
* Ссылка PDF представление хранится в свойстве - СсылкаНаPDF
    account_id = ********@plugin.sbis.ru
 
  
    ole.CallMethod( query_id, guid_module, module_method, parameters_module_method, account_id )
+
Если данных карточки документа не хватает для загрузки документа в информационную систему, интеграционное решение может получить непосредственно первичный документ скачав его по ссылке. Ссылка для скачивания находится в свойстве "Файл".
  
    #Пример получения ответа
+
Кроме указанных ссылок в списке вложений могут присутствовать сгенерированные СБИС вложения (вложения учета). Данные вложения генерируются в случаях когда СБИС используется для ведения учета. Они генерируются на основе данных карточки документа СБИС, которая в свою очередь заполняется по данным электронного документа и введенных в рамках внутреннего документооборота данных.  Вложения учета можно отличить от первичных документов / вложений по свойству ВложениеУчета.
    json_string = ole.ReadAllObject()
 
     
 
</syntaxhighlight>
 
  
Более подробное описание вызова методов и получение ответом см. [[ Подключение_к_ExtSdk2_через_OLE_-_Сценарии_ExtSdk2 | Подключение к ExtSdk2 ]]
+
В ExtSDK2 скачать двоичные данные по ссылке можно при помощи метода [[LoadDataFromURLToFile|LoadDataFromURLToFile]]
 +
 
 +
==Просмотр подготовленных к отправке документов==
 +
Для того чтобы организовать просмотр подготовленных документов перед отправкой, интеграционное решение может запросить HTML или PDF представление документов на основание подготовленного интеграционным решением XML файла. Получение HTML представления осуществляется при помощи метода [[ReadDocumentAsHTML|ReadDocumentAsHTML]]. Документ PDF необходимо скачать через [[LoadDataFromURLToFile|LoadDataFromURLToFile]] с указанием формата файла .pdf
 +
  
 
[[Категория:Сценарии ExtSdk2]]
 
[[Категория:Сценарии ExtSdk2]]

Текущая версия на 14:51, 28 мая 2021

Данная статья описывает функционал позволяющий организовать как просмотр электронных документов находящихся в СБИС, так и электронных документов подготовленных к отправке.

Просмотр и загрузка электронных документов СБИС

Данный раздел описывает как организовать просмотр карточки электронного документа СБИС. Данный просмотр может быть реализован для любого документа СБИС. Для инициализации просмотра достаточно знать только идентификатор документа.

Просмотр карточки электронного документа СБИС как правило используется при клике на строки списка документов полученного соответствующими методами API, либо из карточки документа информационной системы (при условии что в системе хранится связь между документом ИС и документом СБИС.

Для просмотра документа необходимо получить информацию о документе при помощи метода СБИС.ПрочитатьДокумент через CallSabyApi Данный метод позволит показать данные карточки документа и список вложений / файлов (электронных документов). При клике пользователя на вложение интеграционный модуль должен получить представление документа. На каждом вложении есть ссылки по которым можно скачать представление в HTML или PDF виде.

  • Ссылка HTML представление хранится в свойстве - СсылкаНаHTML
  • Ссылка PDF представление хранится в свойстве - СсылкаНаPDF

Если данных карточки документа не хватает для загрузки документа в информационную систему, интеграционное решение может получить непосредственно первичный документ скачав его по ссылке. Ссылка для скачивания находится в свойстве "Файл".

Кроме указанных ссылок в списке вложений могут присутствовать сгенерированные СБИС вложения (вложения учета). Данные вложения генерируются в случаях когда СБИС используется для ведения учета. Они генерируются на основе данных карточки документа СБИС, которая в свою очередь заполняется по данным электронного документа и введенных в рамках внутреннего документооборота данных. Вложения учета можно отличить от первичных документов / вложений по свойству ВложениеУчета.

В ExtSDK2 скачать двоичные данные по ссылке можно при помощи метода LoadDataFromURLToFile

Просмотр подготовленных к отправке документов

Для того чтобы организовать просмотр подготовленных документов перед отправкой, интеграционное решение может запросить HTML или PDF представление документов на основание подготовленного интеграционным решением XML файла. Получение HTML представления осуществляется при помощи метода ReadDocumentAsHTML. Документ PDF необходимо скачать через LoadDataFromURLToFile с указанием формата файла .pdf