Índice | ||||
---|---|---|---|---|
|
O objetivo da API de Importação de Recursos do TReports é promover uma forma de importar recursos existentes através ERP TOTVS. Com isso, o ERP TOTVS pode injetar no TReports um conjunto de recursos padrões, como por exemplo relatórios administrativos e financeiros.
Informações | ||
---|---|---|
| ||
A API pública de Importação está disponível em qualquer instalação do TReports a partir da versão 1.8.X (revisar na liberação) e suas operações estão documentadas via Swagger.
|
A Importação é uma API que recebe um arquivo ZIP contendo os recursos exportados no TReports, realiza a importação na instância atual e retorna as informações dos recursos importados. É possível também realizar a importação de um arquivo único de um recurso (ver limitação abaixo).
Atualmente a API suporta a importação dos tipos de recurso abaixo:
O formato de retorno da API para as informações dos recursos importados é:
*Obs: Caso seja enviado um arquivo simples contendo um recurso, o campo fileName ira retornar como null.
Detalhes da implementação são encontrados no endpoint abaixo:
A "alteração de compartilhamento do recurso" é uma API para completa alteração do compartilhamento do recurso, onde apenas os usuários com permissão de proprietário ou editor podem realizar a alteração.
A API suporta os tipos de recurso abaixo:
O formato do conjunto de credenciais a serem aplicadas no recurso e que deverá ser informado no corpo da requisição é:
Abaixo será exemplificando um caso em que que o ERP necessita importar no TReports alguns recursos previamente desenvolvidos.
Considerando que previamente foram criados e exportados no Treports os recursos abaixo:
Relatórios
Tabelas Dinâmicas
Visões de Dados
Os nomes dos arquivos exportados desses recursos foram editados e incluídos em um arquivo ZIP de nome "Recursos ERP" conforme figura abaixo:
Image Added
Obs.: Não é necessário que os arquivos simples dos recursos tenham a extensão ".treports". Essa extensão é utilizada apenas para identificar o tipo do recurso.
Ao enviar o arquivo ZIP contendo os arquivos acima via API de importação, será retornada as seguintes informaçõesAbaixo temos um exemplo de body da requisição com as credenciais do usuário que será o novo proprietário do recurso:
Bloco de código | ||||
---|---|---|---|---|
| ||||
[ { "type "fileName": "Funcionarios por departamento.treports", "resourceType": "Userdata-grid", "issuer "resourceId": "framework-bh.rac.dev.totvs.app/totvs.rac", "id": "123", "displayName": "John Doe" }922b0080-c30c-4972-a174-cff5e3ef2bf3" }, { "fileName": "Media de Vendas.treports", "resourceType": "pivot-table", "resourceId": "c5befab1-1d7f-47b5-880c-8f76c91ab8c0" }, { "fileName": "Relatorio de Banco de Horas.treports", "resourceType": "report", "resourceId": "27f87e71-e0ab-453a-9f3a-52623075f06c" }, { "fileName": "Relatorio de Depreciacao.treports", "resourceType": "report", "resourceId": "94032928-1aad-4336-ab0d-ec7836819307" }, { "fileName": "Total de Funcionarios.treports", "resourceType": "pivot-table", "resourceId": "b48f25a5-8f1f-42b5-83ea-d106b9dd28df" }, { "fileName": "Vendas por filial.treports", "resourceType": "data-grid", "resourceId": "7eeff9bb-0c73-447e-8f90-4307d7c712e1" } ] |
Informações | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Page Tree |
---|