

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Validando as definições do fluxo de trabalho localmente
<a name="workflows-validate-local"></a>

Você pode validar uma definição de fluxo de trabalho com as próprias ferramentas da linguagem de fluxo de trabalho antes de ligar `CreateWorkflow` ou `CreateWorkflowVersion`. Ele detecta problemas como erros de sintaxe e referências que não são resolvidos.

A validação local verifica sua definição em relação ao idioma do fluxo de trabalho, não em relação a HealthOmics requisitos. Para os lanternos que HealthOmics é executado durante a criação do fluxo de trabalho, consulte [Fluxo de trabalho intermitente em HealthOmics](workflows-linter.md).

## Instalando um validador
<a name="workflows-validate-local-install"></a>

Os validadores são softwares de terceiros que AWS não mantém.
+ **WDL** — Instalar [miniwdl](https://miniwdl.readthedocs.io/en/latest/getting_started.html), um kit de ferramentas local para executores e desenvolvedores da WDL.
+ **Nextflow** — Instalar [Próximo fluxo](https://docs.seqera.io/nextflow/install) v25.10 ou posterior. As versões anteriores também não têm o `nextflow lint` não comande ou informe nenhum aviso.
+ **CWL** — Instalar [cwltool](https://cwltool.readthedocs.io/en/latest/), a implementação de referência dos padrões CWL.

**nota**  
Sua execução pode usar uma versão mais antiga do Nextflow do que aquela com a qual você usa o lint. O `nextflow lint` o comando é analisado com a sintaxe estrita, que sua execução pode não usar. Portanto, antes de reescrever uma definição para satisfazer uma descoberta de sintaxe, verifique qual versão de sintaxe sua execução usa, descrita em [Especifique a versão da sintaxe do Nextflow](workflow-definition-nextflow.md#nextflow-syntax-version). Para como HealthOmics seleciona a versão do Nextflow para uma execução, consulte [Versões do Nextflow](workflows-lang-versions.md#workflows-versions-p2).

## Executando o validador
<a name="workflows-validate-local-run"></a>

Execute o validador no arquivo de definição principal ou, para o Nextflow, no diretório que o contém.

------
#### [ WDL ]

```
miniwdl check {{main-file}}
```

------
#### [ Nextflow ]

```
nextflow lint {{definition-directory}}
```

------
#### [ CWL ]

```
cwltool --validate {{main-file}}
```

------

Para um pacote de vários arquivos, coloque os arquivos em disco com os mesmos caminhos relativos que eles têm no arquivo ZIP para o qual você fez o upload HealthOmics. As referências são resolvidas em relação ao arquivo que as declara, não ao diretório a partir do qual você executa o comando. Para ver os principais requisitos de arquivo, consulte [HealthOmics requisitos de definição de fluxo de trabalho](workflow-defn-requirements.md).

Passe `nextflow lint` o diretório em vez do arquivo principal, para que ele também verifique `nextflow.config`, que não é acessado no arquivo principal.

**nota**  
Quando você passa `-format`, `nextflow lint` reescreve os arquivos de definição que não têm erros. A formatação com a v25.10 ou posterior pode produzir uma sintaxe que as versões anteriores do Nextflow rejeitam, portanto, não formate a menos que sua execução use a versão com a qual você formata.

## Lendo os resultados da validação
<a name="workflows-validate-local-results"></a>

miniwdl e `nextflow lint` saia com um status diferente de zero quando eles relatam um erro, mas com um status zero quando eles relatam apenas avisos, então leia a saída em vez de confiar no status de saída.
+ **WDL** — miniwdl relata o primeiro erro do qual não consegue se recuperar ou um resumo de cada documento carregado com qualquer descoberta de lint em linha.
+ **Nextflow** — O Nextflow relata cada erro e aviso com seu arquivo, linha e coluna e cita a linha ofensiva. Ele termina com uma contagem dos arquivos que tiveram erros e uma contagem dos que não tiveram nenhum, então um arquivo com um aviso, mas sem erro, é considerado como não tendo nenhum. Para alterar o formato do relatório, passe `-o`, por exemplo `-o json`.
+ **CWL** — cwltool relata que o arquivo é CWL válido ou uma falha na validação do arquivo, linha e coluna de cada problema.

**nota**  
As versões do Nextflow diferem no quanto relatam. O Nextflow v26.04 conta os avisos em seu resumo e os inclui em `-o json` saída. O Nextflow v25.10 imprime avisos somente na saída padrão e não relata nenhum em seu resumo ou em seu `-o json` saída.