API Reference

Obter dados de um documento

Para que serve?

Serve para consultar as informações de documento em qualquer campo template (dentro e fora da grid) de um processo numa determinada atividade.

Quando usar?

Esse serviço geralmente é utilizado para ver as informações especificas de um documento de uma determinada atividade, como:

  • Obter as informações de identificação de um documento para manutenção;
  • Obter as informações de versão, autor e data de criação do documento;
  • Obter as informações de documento para exibi-la em um outro sistema;

Essa consulta poderá ser executada em qualquer situação de um processo, ou seja, em andamento, finalizado ou cancelado.

O serviço permite consultar os valores principais do documento e não trará as informações referentes aos campos de template (metadados), nem fará o download do documento.

Para realizar o download de documentos, utilize os serviços:

Como usar?

Na chamada do serviço é preciso passar a identificação da instância do processo e da atividade em andamento (código da atividade e o ciclo), o campo do documento (template), o código do documento (templateId) e a identificação do documento (fileUniqueId).

Esse serviço pode ser executado a partir de um usuário responsável pela atividade em andamento ou que tenha permissão de pesquisa em atividades já executadas.

O fileUniqueId é uma identificação do documento e é obtida no momento da inclusão do documento na atividade. Caso não tenha essa informação, é necessário utilizar os serviços:

O retorno da execução desse serviço serão as informações principais do documento referentes a inclusão do mesmo, com códigos de identificação, versão, tipo do arquivo, data de criação e etc..

Com essas informações é possível por exemplo executar os serviços de manutenção ou download de documentos.

Para consultar todos os detalhes, utilize o link abaixo para acessar a documentação técnica.

Link da APIs

VersõesLinkRelease InicialRelease FinalStatus
V1Documentação Técnica5.50 RTM 1.06🟢

🟢 API Disponível
🟡 API Depreciada
🔴 API Descontinuada