DocXpress (GED)

Estes nós falam com o DocXpress, o GED da Debarry: encontram documentos pelo valor de um índice (CPF, matrícula, contrato), trazem o arquivo para dentro do fluxo e consultam os dados de uma versão sem baixar nada.

O caminho de uso costuma ser sempre o mesmo: Pesquisar encontra os documentos, Baixar traz o arquivo, e daí ele segue para um e-mail, uma assinatura, um ZIP ou o "Salvar em arquivo" (veja Arquivos e planilhas).

Antes de começar: a credencial

Cadastre uma vez em Credenciais, no tipo DocXpress (GED — Debarry). Os dados vêm da Debarry:

Use Testar conexão na lista de credenciais para conferir os dados antes de montar o fluxo.

Os identificadores vêm da Debarry

Classe e campo são números, não nomes: a classe do documento (ex.: 2808) e o índice em que você procura (ex.: 97 para o CPF). Peça-os à Debarry, ou descubra os campos que a sua base usa com o nó Campos da classe, abaixo.

DocXpress — Pesquisar documentos

Procura na classe e emite um item por documento encontrado, já com os dados que o próximo nó precisa (idDoc, idVersao, verNomeArquivo e os demais campos da versão).

• Classe do documento — obrigatório.
• Campo de busca — o número do índice. Em branco, traz os documentos da classe.
• Valor procurado — ex.: {{ cpf }}. Obrigatório quando há campo de busca.
• Critérios adicionais (JSON) — opcional, para procurar por mais de um campo ao mesmo tempo: [{"IdCampo":96,"Valor":"0201532606"}].
• Tempo limite.

A pesquisa traz no máximo 50 documentos e não tem paginação. Quando o resultado chega nesse teto, cada item sai marcado com _docxpress.truncado verdadeiro — teste esse campo com um IF e avise, em vez de seguir achando que processou todos. Para trazer menos, estreite a busca com mais critérios.

DocXpress — Baixar documento

Baixa o arquivo e o anexa ao item, pronto para anexar num e-mail, mandar para assinatura ou salvar.

• Documento — o idDoc que a pesquisa devolve: {{ idDoc }}.
• Nome do arquivo — opcional; em branco usa o nome do próprio documento no GED.
• Onde anexar (propriedade) — o nome do anexo dentro do item, quando você carrega mais de um arquivo por item.
• Tempo limite.

DocXpress — Dados da versão

Traz nome do arquivo, tamanho, número de páginas, hash, se está assinada e se está publicada — sem baixar o arquivo. Bom para decidir antes de gastar a transferência: só seguir adiante se o documento estiver assinado, por exemplo.

• Versão — o idVersao que a pesquisa devolve: {{ idVersao }}.
• Tempo limite.

DocXpress — Campos da classe

Lista os índices preenchidos nos documentos de uma classe. É como se descobre o número de cada campo antes de montar uma pesquisa.

• Classe do documento — obrigatório.
• O que trazer:
  • Resumo (padrão) — um item por campo, com quantas vezes ele aparece. Não traz valores, então serve para configurar sem passar dado de pessoa pelo fluxo.
  • Valores — um item por documento e campo, para quando o fluxo precisa mesmo dos dados.
• Somente o documento e Somente o campo — recortes opcionais.
• Máximo de valores a emitir — padrão 200, vale só no modo Valores. Uma classe pode ter centenas de milhares de registros; quando o teto corta, os itens saem marcados com _docxpress.truncado.
• Tempo limite — começa em 300 segundos, maior que o dos outros nós.

Este nó é para consulta pontual, não para rodar a cada item de um fluxo grande: o serviço devolve a classe inteira em qualquer um dos dois modos. Numa base real, isso foi cerca de 130 MB em torno de 27 segundos.