データソースからのデータの使用

を選択 データソース 左側のパネルに接続されたデータソースが表示されます。

データソースを選択し、選択したデータソースで使用可能なコンテンツスニペットジェネレーターを表示します。

{width="300"}

データソースパネルには、使用可能なコンテンツスニペットジェネレーターのリストが表示されます。

を選択 追加 新しいコンテンツスニペットジェネレーターを追加します。 この コンテンツスニペットジェネレーターを追加 パネルが開きます。

にクエリを入力 データクエリ テキストボックス。 を選択 サンプルクエリをコピー データクエリを迅速にコピーする。 クエリを手動で作成する代わりに、サンプルクエリをコピーしてに貼り付けることができます データクエリ テキストボックス。 次に、データ要件に従ってクエリを編集するだけです。

ファイルコネクタを使用している場合は、コンピューターから JSON ファイルをアップロードするか、Adobe Experience Manager Assets から JSON ファイルを参照できます。

から、データソースにマッピングするテンプレートを選択します。 データマッピングテンプレート ドロップダウン。
選択したデータソースに対する標準のテンプレートがドロップダウンに表示されます。 例えば、「PostgreSQL」データソースという名前のデータソースの「sql-table」テンプレートを表示できます。

この Resource rest Client、Salsify、Akeneo、Microsoft ADO などの一部のコネクタに対してドロップダウンが表示される。 ドロップダウンから任意のリソースを選択し、そのリソースに接続して、ジェネレーターを使用してコンテンツスニペットまたはトピックを作成します。

クリック 取得 データソースからデータを取得し、SQL クエリによって生成されたデータにテンプレートを適用します。

データは、プレビューまたは DITA ソースビューで表示できます。

1. プレビューには、コンテンツに挿入した際のデータの表示方法が表示されます。 プレビューには、選択したテンプレートの形式でデータのごく一部が表示されます。
   次に例を示します。

   • SQL テーブル テンプレートを選択した場合は、SQL データを表形式で表示できます。
   • Jira 順序付きリストテンプレートを選択した場合は、Jira の課題の順序付きリストを表示できます。

2. ソースビューには、DITA ソースビューのデータが表示されます。

   {width="800"} *コンテンツスニペットジェネレーターを追加します。 データをソースモードまたはプレビューモードで表示します。*

クエリーの結果を保存するには、ジェネレータの名前を入力し、 追加. 新しいコンテンツスニペットジェネレーターがリストに追加されます。

データソースを選択して、選択したデータソースで使用可能なコンテンツスニペットジェネレーターとトピックジェネレーターを表示します。

{width="300"}

接続されたデータ ソースのトピック ジェネレータを追加します。

を選択 追加 を選択して、 トピック ジェネレータ ドロップダウンから新しいトピックジェネレーターを追加します。 この トピック ジェネレータの追加 パネルが開きます。

の次の 3 つのタブにあるフィールドに値を入力します。 トピック ジェネレータの追加 パネル：

設定を取得

{width="300"}

トピックジェネレーターのデータクエリ、データマッピングテンプレート、ルートノードの詳細を追加し、「設定を取得」パネルで一意の名前を付けます。

1. にクエリを入力 データクエリ テキストボックス。 を選択 サンプルクエリをコピー データクエリを迅速にコピーする。 クエリを手動で作成する代わりに、サンプルクエリをコピーしてに貼り付けることができます データクエリ テキストボックス。 次に、データ要件に従ってクエリを編集するだけです。

   note note
   NOTE
   Experience Managerには、様々なデータソース内のすべてのリソースに対する様々なサンプルクエリが用意されています。 これらは、データの取得元のデータソースにマッピングされます。

2. ファイルコネクタを使用している場合は、コンピューターから JSON ファイルをアップロードするか、Adobe Experience Manager Assets から JSON ファイルを参照できます。

   note note
   NOTE
   ファイルコネクタを使用する場合は、データクエリの代わりにファイルをアップロードまたは参照するためのオプションを表示します。

3. から、データソースにマッピングするテンプレートを選択します。 データマッピングテンプレート ドロップダウン。

   note note
   NOTE
   管理者がカスタマイズしたテンプレートを設定している場合は、（管理者が行ったテンプレートパス設定に基づいて）それらのテンプレートもドロップダウンリストに表示されます。 たとえば、順序付きリスト、表、段落、またはその他の DITA エレメントを含むトピックテンプレートを作成できます。

4. を入力 ルートノード. これは、データにアクセスするノードです。 次に、トピック ジェネレータは、ルート ノードで定義されたレベルに各トピックを作成します。 例えば、Jira のルートノードとして「issues」を追加できます。 したがって、クエリによって 13 件の問題が返された場合は、各問題に対して 1 つのトピックの 13 のトピックが返されます。

5. クリック 取得 データソースからデータを取得し、SQL クエリによって生成されたデータにテンプレートを適用します。 プレビューには、選択したテンプレートの形式でトピックが表示されるほんの一部が表示されます。 例えば、1 つの Jira の課題を、クエリから生成されたすべてのフィールドと共に表示できます。

6. トピック ジェネレータの名前を入力します。

   note note
   NOTE
   新しいトピックジェネレータの名前は、ファイル命名規則に従う必要があります。 トピック ジェネレータの名前にスペースを含めることはできません。 また、既存のトピック ジェネレータの名前で新しいトピック ジェネレータを保存することはできません。 エラーが発生しました。

出力設定

{width="300"}

出力設定パネルに、出力パスとトピック命名規則の詳細を入力します。 DITA マップを生成し、名前を付けます。

1. を入力 出力パス トピックを保存する場所の詳細。
2. が含まれる トピックの命名規則 ​を選択します。velocity タグを使用して、値または変数を入力できます。 新しいトピックは命名規則に従います。 例えば、 $key jira キーに基づいてトピックを作成するには、次の手順を実行します。
3. オプションを有効にする マップを生成 生成されたすべてのトピックを含むマップを作成する場合。
4. 新しい DITA マップの名前を入力します。

メタデータ

ドロップダウンから、トピックに渡すメタデータプロパティを選択します。 名前 カスタムプロパティとデフォルトプロパティの両方がドロップダウンリストに表示されます。

例えば、次のスクリーンショットでは、 dc:description, dc:language, dc:title、および docstate は、値を定義できるデフォルトのプロパティです。 author などのカスタムプロパティを作成し、その値を定義できます。

{width="300"}

トピックに渡すメタデータプロパティをメタデータパネルに追加します。

ジェネレータの名前を入力して、 保存 クエリ結果を保存します。 新しいトピック ジェネレータがリストに追加されます。

クリック 保存して生成 トピック ジェネレータを保存し、トピック ジェネレータから新しいトピックを生成します。

{width="650"}

既存のトピック ジェネレータから新しいトピックを生成します。

Web エディターで Velocity テンプレートを編集します。

にツールとその機能を追加する <tool.function> 形式。 次に例を示します。

• 計算ツールを使用して乱数を生成するには、次を使用します $mathTool.random.
• 数学ツールを使用して数値の合計を生成するには、次を使用します $mathTool.add(num1, num2).

テンプレートを使用して、コンテンツスニペットまたはトピックを作成します。

テンプレートをデータに適用した後、プレビューまたは DITA ソースビューでデータを表示できます。