JSSアプリのマニフェストファイルの生成

JSSアプリケーションのコードファーストのアーティファクト(ルート、ルートタイプ、プレースホルダー、コンポーネント、コンポーネントコンテンツなど)をすべて定義できたら、マニフェストの完全な定義を含むマニフェストを作成できます。

JSS CLIコマンドjss manifestを実行することで、JSSアプリのマニフェストを手動で生成できます。

しかし、マニフェスト生成プロセスをデバッグしていない場合は、マニフェストが自動的に生成されることが多いです:

• 切断された開発サーバーの起動時には、通常コマンド jss startを実行することで行われます。切断された開発サーバーはフォルダの sitecore/definitions を監視し、マニフェスト定義を追加、削除、変更した際にマニフェストを再構築します。
• JSSアーティファクトの展開やパッケージ化時にJSS CLIコマンドを使ってSitecoreし、JSS CLIコマンド jss deploy items または jss packageを使う場合。マニフェストを生成したくない場合は、 --skipManifest 引数を使用できます。

デフォルトでは、サンプルアプリケーションのJSSマニフェストはフォルダsitecore/manifestに送信されます。

マニフェストは以下のプロセスで生成されます:

1. JSS申請内のすべての /sitecore/definitions/*.sitecore.{js|ts} マニフェストファイルを見つけます。
2. JSSマニフェストファイルを反復し、各ファイルの default エクスポートを呼び出します。 default エクスポートは署名の関数であると期待されます: function(manifest) { }。
3. 各*.sitecore.{js|ts}ファイルは、default関数が受信するmanifestインスタンスに対して、addComponentやaddRouteなど様々なメソッドを呼び出します。
4. すべての*.sitecore.{js|ts}ファイルを処理した後、JSSは一連のパイプラインを通じてマニフェスト出力を生成し、パラメータ--manifestOutputPath consoleを指定すれば/sitecore/manifestまたはコンソールに出力を書き込みます。

!注マニフェスト生成プロセスはトランスパイル(ES6/TypeScript)マニフェストソースをサポートしています。サンプルアプリでは、トランスパイラーのデフォルト設定を /sitecore/definitions/config.jsで見つけることができます。このパスは、マニフェストを生成するCLIコマンドの --require引数で上書きできます。