Erro Graph could not be found using process name

Boa tarde!

Ao executar o meu arquivo .run, foi apresentado o erro Graph could not be found using process name.

O que é este erro e como posso solucionar ele?

Bom dia Felipe, segue documentação:

Objetivo
Este documento tem como objetivo orientar a identificação e correção do erro: Graph could not be found using process name

1. Descrição do Problema
O erro indica que o sistema não conseguiu localizar o graph especificado, devido a uma inconsistência no nome do processo configurado.
Essa inconsistência ocorre quando o valor definido no parâmetro gdc.etl.graph, presente no arquivo config.properties, não corresponde ao nome real do processo existente no projeto.

Importante: O erro está relacionado ao nome do processo (process name) e não ao seu ID. Ainda assim, recomenda-se validar também o ID como boa prática.

2. Causa
A causa mais comum deste erro é a divergência entre:

  • O nome do processo configurado no arquivo config.properties
  • O nome real do processo cadastrado no projeto na GoodData

3. Solução
Verificar o parâmetro no arquivo config.properties

3.1. Acesse o arquivo config.properties utilizado na execução.

3.2. Localize o seguinte parâmetro: gdc.etl.graph

3.3. Verifique o valor configurado.

No exemplo acima - TOTVS-FastAnalytics-Protheus-Backoffice-1.3.12/graph/_Main.grf

Este valor representa:

  • Nome do processo
  • Caminho do graph principal (_Main.grf)

4. Identificar o nome correto do processo
Para obter o nome correto do processo, é necessário utilizar o plugin da GoodData.
Pré-requisito

  • Ter o plugin da GoodData instalado no navegador (Link)

Passo a passo

  • Acesse a URL do projeto na GoodData
  • Clique no plugin da GoodData (canto superior direito de sua tela)
  • Selecione a opção DataLoad
  • Clique em Processes
  • Uma nova aba será aberta
  • Clique no link identificado como self
  • Localize o nome do processo exibido (role a página para baixo, assim encontrará o nome)

:heavy_check_mark: O nome apresentado nesta etapa é o nome correto do processo utilizado na execução do graph _Main.grf.
5. Validar e corrigir o parâmetro

Compare:

  • O valor atual do config.properties
  • O nome do processo obtido no plugin

Caso haja divergência:

  • Copie o nome correto do processo
  • Atualize o parâmetro gdc.etl.graph no arquivo config.properties

6. Reexecutar o processo
Após realizar a correção:

  • Salve o arquivo config.properties
  • Execute novamente o arquivo .run

7. Boas Práticas

  • Sempre validar o nome do processo após:
  • Atualizações de versão
  • Alterações no projeto
  • Evitar copiar configurações de outros ambientes sem validação
  • Validar também o ID do processo, embora não seja a causa direta deste erro