ファイルをソースとする新しいプロジェクトインポーター new-project-importer-from-file
ここでは、CSV／XLS スプレッドシートから AEM Screens プロジェクトに一連のロケーションを一括で読み込む機能について説明します。
はじめに introduction
AEM Screens プロジェクトを組織で初めて設定する場合は、すべてのロケーションも作成します。プロジェクトに多数のロケーションが含まれる場合は、UI で何回も選択したり待機したりする退屈なタスクが多く発生します。
この機能は、プロジェクトのセットアップに要する時間を短縮して、予算の問題を解決することを目的としています。
この機能では、作成者が入力ファイルとしてスプレッドシートを提供でき、システムがバックエンドにロケーションツリーを自動的に作成できるので、以下のメリットがあります。
- UI を使用して手動で選択するよりも、はるかに優れたパフォーマンスを実現します
- 顧客は既存のロケーションを独自のシステムから書き出して、直接 AEM に簡単に読み込むことができます
このプロセスにより、初回のプロジェクトセットアップ時または既存の AEM Screens プロジェクトを新しいロケーションに拡張する際に、時間と費用の両方を節約できます。
アーキテクチャの概要 architectural-overview
プロジェクトインポーター機能のアーキテクチャの概要を次の図に示します。
データモデル data-model
プロジェクトインポーターのデータモデルを以下で説明します。
path {string*}[./jcr:title] {string*}template {string}[./jcr:description] {string}したがって、スプレッドシート（CSV/XLS）ファイルには次の列が必要です。
- path {string}：読み込む場所のパス。プロジェクトの場所フォルダーをルートとします（つまり、
/fooは/content/screens/<project>/locations/fooに読み込まれます）。 - template {string}：新しいロケーションに使用するテンプレート。今のところ、使用可能な値は「location」だけですが、今後、この値はすべての Screens テンプレート（
display、sequencechannelなど）に拡張される予定です。 - [。/*] {string}：場所（つまり、
./jcr:title、./jcr:description、./foo, ./bar）に設定する任意のオプションプロパティ。現在のリリースではフィルタリングはできません。
プロジェクトインポーターの使用 using-project-importer
この節では、AEM Screens プロジェクトでのプロジェクトインポーターの使用方法について説明します。
- CSV／XLS／XLSX 拡張子以外のファイルは、現在のリリースではサポートされていません。
- 読み込まれるファイルに対してプロパティのフィルタリングは行われず、「./」で始まるものはすべて読み込まれます。
前提条件 prerequisites
-
DemoProjectImport というタイトルのプロジェクトを作成します。
-
読み込む必要があるサンプル CSV または Excel ファイルを使用します。
デモ用に次の Excel ファイルをダウンロードできます。
最低限必要なフィールドを含んだファイルの読み込み importing-the-file-with-minimum-required-fields
最小限の必須フィールドを含むファイルをロケーションフォルダーに読み込むには、以下の手順に従います。
-
AEM Screens プロジェクト（DemoProjectImport）に移動します。
-
サイドバーの DemoProjectImporter ／ 作成／ロケーションを読み込む をクリックします。
-
読み込み ウィザードが表示されます。ロケーションを含むプロジェクトのファイルをクリックするか、前提条件 の節でダウンロードした minimal-file.xls ファイルをクリックします。
ファイルを選択したら、「次へ」をクリックします。
-
読み込みウィザードでファイル（ロケーション）の内容を確認し、「読み込み」をクリックします。
-
その結果、プロジェクトに読み込まれたすべての場所が表示されるようになります。
