

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ワークフロー定義をローカルで検証する
<a name="workflows-validate-local"></a>

`CreateWorkflow` または を呼び出す前に、ワークフロー言語独自のツールを使用してワークフロー定義を検証できます`CreateWorkflowVersion`。構文エラーや解決されない参照などの問題を検出します。

ローカル検証は、定義を HealthOmics の要件ではなくワークフロー言語と照合します。ワークフローの作成中に HealthOmics が実行する linters については、「」を参照してください[HealthOmics のワークフローlinters](workflows-linter.md)。

## バリデータのインストール
<a name="workflows-validate-local-install"></a>

バリデーターは、 が管理していないサードパーティー製ソフトウェア AWS です。
+ **WDL** – WDL 用のローカルランナーおよび開発者ツールキット[miniwdl](https://miniwdl.readthedocs.io/en/latest/getting_started.html)である をインストールします。
+ **Nextflow** — [Nextflow](https://docs.seqera.io/nextflow/install) v25.10 以降をインストールします。以前のバージョンには `nextflow lint` コマンドがないか、警告が報告されていません。
+ **CWL** – CWL 標準の[cwltool](https://cwltool.readthedocs.io/en/latest/)リファレンス実装である をインストールします。

**注記**  
実行では、リントする Nextflow バージョンよりも古い Nextflow バージョンを使用できます。`nextflow lint` コマンドは、実行で使用されない可能性のある厳密な構文で解析します。したがって、構文の検出結果を満たすように定義を書き換える前に、「」で説明されているように、実行で使用する構文バージョンを確認してください[Nextflow 構文バージョンを指定する](workflow-definition-nextflow.md#nextflow-syntax-version)。HealthOmics が実行の Nextflow バージョンを選択する方法については、「」を参照してください[Nextflow バージョン](workflows-lang-versions.md#workflows-versions-p2)。

## バリデータの実行
<a name="workflows-validate-local-run"></a>

メイン定義ファイルに対して検証を実行し、Nextflow の場合はそれを含むディレクトリに対して検証を実行します。

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

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

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

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

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

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

------

マルチファイルバンドルの場合、ファイルを HealthOmics にアップロードする ZIP アーカイブにあるのと同じ相対パスでディスクにレイアウトします。リファレンスは、コマンドを実行するディレクトリではなく、それらを宣言するファイルに関連して解決されます。メインファイルの要件については、「」を参照してください[HealthOmics ワークフロー定義の要件](workflow-defn-requirements.md)。

メインファイルから到達`nextflow.config`しない もチェックするように、メインファイルではなく `nextflow lint` ディレクトリを渡します。

**注記**  
を渡すと`-format`、 はエラーのない定義ファイルを書き`nextflow lint`換えます。v25.10 以降でフォーマットすると、以前の Nextflow バージョンが拒否する構文が生成されるため、実行でフォーマットするバージョンを使用しない限り、フォーマットしないでください。

## 検証結果の読み取り
<a name="workflows-validate-local-results"></a>

miniwdl と は、エラーを報告する場合は 0 以外のステータスで`nextflow lint`終了しますが、警告のみを報告する場合は 0 ステータスで終了します。終了ステータスに依存するのではなく、出力を読み取ります。
+ **WDL** – は、復旧できない最初のエラー、またはインラインで lint 検出結果とともにロードされたすべてのドキュメントの概要miniwdlを報告します。
+ **Nextflow** – Nextflow は、各エラーと警告をファイル、行、列とともにレポートし、問題のある行を引用符で囲みます。最後に、エラーのあるファイルの数とエラーのないファイルの数で終わるため、警告があるがエラーのないファイルは、エラーがないものとしてカウントされます。レポート形式を変更するには、 `-o`を渡します。例: `-o json`。
+ **CWL** – は、ファイルが有効な CWL であるか、各問題のファイル、行、列で検証に失敗したことをcwltool報告します。

**注記**  
Nextflow のバージョンは、レポートの量によって異なります。Nextflow v26.04 は、警告をその概要にカウントし、`-o json`出力に含めます。Nextflow v25.10 は、警告をデフォルトの出力にのみ出力し、概要または`-o json`出力のいずれでも報告しません。