コンテンツフラグメントモデルの管理 managing-content-fragment-models
コンテンツフラグメントコンソールから、コンテンツフラグメントモデルを管理し、 エディターを開いて構造を定義できます。
Adobe Experience Manager（AEM）as a Cloud Service のコンテンツフラグメントモデルでは、コンテンツフラグメントのコンテンツの構造を定義します。これらのフラグメントは、ヘッドレスコンテンツやページオーサリングの基盤として使用できます。
コンテンツフラグメントモデルの操作方法 how-to-work-with-content-fragment-models
非常に簡単な概要として、コンテンツフラグメントモデルを操作するには、次の操作を行います。
- インスタンスに対するコンテンツフラグメントモデル機能の有効化
- コンテンツフラグメントモデルを 作成します。
- この時点で、モデルを 有効 にすることもできます（コンテンツフラグメントの作成時に使用します）。
- モデルの構造を 定義します。
- コンテンツフラグメントモデルを有効にする（まだ行っていない場合）。
- ポリシー の設定による必要なアセットフォルダーに対するコンテンツフラグメントモデルの許可
コンソールでのコンテンツフラグメントモデルの基本構造と処理 basic-structure-handling-content-fragment-models-console
コンテンツフラグメントコンソールの左端のパネルを使用して、表示、参照および管理するリソースタイプとして コンテンツフラグメントモデル を選択します。
これにより、コンテンツフラグメントモデルのビューが開きます。
主な領域が 3 つあります。
-
上部のツールバー
- 標準の AEM 機能を提供します
- IMS 組織も表示します
- 様々なアクションの提供
-
左側のパネル
- フォルダーとしてリストされた すべての設定へのパスを表示します
- フォルダーツリーを表示したり非表示にしたりできます
- ツリーの特定のフォルダーを選択できます
- ネストされたフォルダー（サブ設定）を表示するようにサイズ変更できます
- コンテンツフラグメントモデルと同様に、 コンテンツフラグメントまたは Assets を表示できます。パネルへのリンクを圧縮または展開することもできます
-
右側のメインパネル
-
選択したフォルダーの下に保持されているすべてのコンテンツフラグメントモデルのリストを確認します。
-
選択したフォルダーのコンテンツフラグメントモデルと、すべてのサブフォルダーが表示されます。
- 場所はパンくずリストで示されます。これを使用して、場所を変更することもできます:
-
コンテンツフラグメントモデルに関する 様々な情報フィールドのリンクは、フィールドに応じて、次のことが可能です。
- エディターで適切なモデルを開きます
- 設定へのパスに関する情報を表示
- モデルの状態に関する情報を表示します
-
コンテンツフラグメントモデルに関する その他の特定の情報フィールドを使用して 高速フィルタリングを行うことができます。
- 列の値を選択すると、直ちにフィルターとして適用されます
- 高速フィルタリングは、変更者、公開者 および ステータス 列でサポートされています。
-
列ヘッダーにマウスオーバーを使用すると、ドロップダウンアクションセレクターと幅スライダーが表示されます。これらを使用すると、次のことができます。
- 並べ替え - 昇順または降順に適切なアクションを選択します。
これにより、テーブル全体がその列に従って並べ替えられます。並べ替えは、適切な列でのみ使用できます。 - 列のサイズを変更 - アクションまたは幅スライダーを使用します。
- 並べ替え - 昇順または降順に適切なアクションを選択します。
-
詳細な アクションを実行する 1 つ以上のモデルを選択
-
-
「フィルターパネル」を開きます
-
このコンソールで使用できるキーボードショートカットの選択
-
コンテンツフラグメントモデルに関して提供される情報 information-content-fragment-models
コンソールのメインパネルや右パネル（テーブル表示）には、コンテンツフラグメントモデルに関する様々な情報が表示されます。 また一部の項目には、その他のアクションや情報への直接リンクも含まれます。
モデルプロパティ model-properties
特定のモデルを選択すると、そのモデルのプロパティが（ モデルの作成時に定義したとおりに）表示されます。 モデルが ロック済み でない場合、一部の項目は更新できます。 また、モデル（タイトル の横にある情報アイコンを使用して、この情報パネルを開いたり閉じたりするこ もできます。
-
タイトル
-
タグ
-
説明
-
プレビュー URL パターン
コンテンツフラグメントモデルを使用すると、作成者は外部フロントエンドアプリケーションでコンテンツを プレビュー できます。 プレビューサービス を設定したら、フロントエンドアプリケーションの URL を追加します。
プレビュー URL は次のパターンに従う必要があります。
https://<preview_url>?param=${expression}使用できる式は次のとおりです。
${contentFragment.path}${contentFragment.model.path}${contentFragment.model.name}${contentFragment.variation}${contentFragment.id}
アクション actions
（左側のパネルで）フォルダーを選択すると、直接または特定のモデルを選択した後に使用できる様々なアクションがあります。
- 様々なアクションをコンソールから直接実行できます
- 1 つ以上のコンテンツフラグメントモデルを選択して、適切なアクションを表示するとができます。
アクション（未選択） actions-unselected
フォルダーの選択後、特定のコンテンツフラグメントモデルを選択しなくても、コンソールから特定のアクションを実行できます。
- 作成 新しい（空の）モデル
コンテンツフラグメントコンソールでのコンテンツフラグメントモデルのアクション actions-selected-content-fragment-models
特定のモデルを選択すると、そのモデルで使用可能なアクションに焦点を当てたツールバーが開きます。 複数のモデルを選択することもできます。使用可能なアクションはそれに応じて調整されます。
1 つのモデルを選択すると、右側のパネルに モデルのプロパティも表示されます。
コンソールに表示される列の選択 select-columns-console
他のコンソールと同様に、表示する列やアクションに使用できる列を設定できます。
表示または非表示にできる列のリストが表示されます。
コンテンツフラグメントモデルのフィルタリング filter-content-fragment-models
フィルターパネルには、次の機能があります。
-
一連の述語
- ステータスフィールド、タグ、ユーザーなどを含む
- 1 つ以上の述語を選択して組み合わせ、フィルターを作成できます
選択すると、（メインパネルの上部に フィルター条件」オプションが表示されます。 そこから選択を解除できます。次に例を示します。
高速フィルタリング fast-filtering
リスト内の特定の列の値をクリックして、述語を選択することもできます。1 つ以上の値を選択して、述語を組み合わせることができます。
例えば、「ステータス」列の「有効」を選択します。 選択すると、フィルターの述語として表示され、それに応じてリストがフィルターされます。
コンテンツフラグメントモデルの作成 creating-a-content-fragment-model
-
目的の設定またはサブ設定に適したフォルダーに移動します。
-
作成 を使用してダイアログを開きます。
note caution CAUTION 作成 オプションは、次の場合にのみ使用できます。 - コンテンツフラグメントモデルの使用が有効になっている合
- モデルを作成するフォルダーを選択している場合。
-
設定の パス を選択し、名前 を指定します。
note note NOTE 設定には、現在の設定（現在のフォルダー）が自動入力されます。 フォルダーアイコンをクリックして設定を変更することもできます。 様々なプロパティも定義できます。
- タイトル
最初に タイトル を入力すると、そこから 名前 が生成されます。 - 説明
- モデルを有効にする モデルを有効にする 有効にする
note note NOTE 詳しくは、コンテンツフラグメントモデル - プロパティを参照してください。 
- タイトル
-
作成 を使用して空のモデルを保存するか、作成して開く を使用します。
コンテンツフラグメントモデルの有効化 enabling-a-content-fragment-model
モデルを作成したら、次のようにモデルを有効にする必要があります。
- コンテンツフラグメントの作成時に選択できます。
- コンテンツフラグメントモデル内から参照する
- GraphQL で使用する（スキーマが生成される）
モデルは次の うに有効化 できます。
- 新しいモデルの作成時
- オプションがダイアログに表示されます。
- モデルが明確に 無効 されたとき
- 必要なモデルを選択すると、上部のツールバーで 有効にする アクションを使用できます。
コンテンツフラグメントモデルの無効化 disabling-a-content-fragment-model
モデルを無効にすると、以下のようになります。
-
このモデルは、新しい コンテンツフラグメントを作成する際の基盤としては使用できなくなります。
-
ただし、
- GraphQL スキーマは生成され続け、スキーマのクエリも引き続き可能です（JSON API への影響を回避するため）。
- モデルに基づくコンテンツフラグメントは、引き続き GraphQL エンドポイントからクエリして返すことができます。
-
モデルは参照できなくなりますが、既存の参照は変更されず、引き続き GraphQL エンドポイントからクエリして返すことができます。
有効 フラグが設定されているモデルを無効にするには、次の場所から 無効 オプションを使用します。
- 上部のツールバー（必要なモデルが選択されている場合）
アセットフォルダーでのコンテンツフラグメントモデルの許可 allowing-content-fragment-models-assets-folder
コンテンツのガバナンスを実装するには、アセットフォルダーに ポリシー を設定して、そのフォルダーでのフラグメント作成に使用可能なコンテンツフラグメントモデルを管理します。
許可されているコンテンツフラグメントモデル に ポリシー を設定するには：
-
必要なアセットフォルダーの プロパティ を開きます。
-
「ポリシー」タブを開き、以下を設定します。
-
継承元
<folder>ポリシーは、新しい子フォルダーの作成時に自動的に継承されます。サブフォルダーで親フォルダーとは異なるモデルを許可する必要がある場合は、ポリシーを再設定（継承を解除）できます。
-
許可されているコンテンツフラグメントモデルパス (パス別)
複数のモデルを許可できます。
-
許可されているコンテンツフラグメントモデルタグ (タグ別)
複数のモデルを許可できます。
-
-
変更内容を 保存 します。
フォルダーに対して許可されるコンテンツフラグメントモデルは、次の順序で解決されます。
- 許可されているコンテンツフラグメントモデル の ポリシー。
- 空の場合は、継承ルールを使用してポリシーの決定を試みます。
- 継承チェーンを使用しても結果が得られない場合は、そのフォルダーの Cloud Services 設定を調べます（最初は直接、次に継承を使用して調べます）。
- 上記のいずれでも結果が得られない場合、そのフォルダーに許可されるモデルはありません。
コンテンツフラグメントモデルの公開 publishing-a-content-fragment-model
コンテンツフラグメントモデルは、そのモデルに依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。
コンテンツフラグメントモデルを公開するには：
-
コンテンツフラグメントモデルに移動して選択します。 複数のモデルを選択できます。
-
ツールバーの 公開 を選択します。
-
公開ダイアログで、「宛先」を選択します。
- パブリッシュサービス
- プレビューサービス
-
選択したモデルとその参照を公開するワークフローが開始されます。 公開ステータスがコンソールに表示されます。
コンテンツフラグメントモデルのロック locked-content-fragment-models
この機能を使用すると、モデルを更新できるかどうかを制御できますが、公開済みのコンテンツフラグメントモデルに対するガバナンスも提供されます。
課題 the-challenge
-
コンテンツフラグメントモデルは、AEM における GraphQL クエリのスキーマを決定します。
-
AEM GraphQL スキーマは、コンテンツフラグメントモデルが作成されると同時に作成され、オーサー環境とパブリッシュ環境の両方に存在できます。
-
公開上のスキーマは、JSON 形式のコンテンツフラグメントコンテンツをライブ配信する場合の基盤となるので、非常に重要です。
-
-
コンテンツフラグメントモデルが変更つまり編集された場合には、問題が発生する可能性があります。つまり、スキーマの変更が既存の GraphQL クエリに影響を与える可能性があります。
-
コンテンツフラグメントモデルに新しいフィールドを追加する場合は、（通常は）悪影響はありません。ただし、既存のデータフィールド（名前など）を変更したり、フィールド定義を削除したりすると、既存の GraphQL クエリでこれらのフィールドをリクエストする際に、クエリが機能しなくなります。
要件 the-requirements
-
ライブコンテンツ配信に既に使用されているモデル（つまり、公開済みのモデル）を編集する際のリスクをユーザーに認識させる。
-
意図しない変更を避ける。
いずれにせよ、変更されたモデルが再公開されると、クエリが機能しなくなる可能性があります。
解決策 the-solution
これらの問題に対処するために、コンテンツフラグメントモデルは、公開され次第、オーサー環境では読み取り専用モードに ロック されます。このステータスは ロック済み と表示されます。
モデルが ロック済み（読み取り専用モード）の場合、モデルの内容と構造は表示できますが、モデルを編集することはできません。
ロック済み モデルは、コンソールまたはモデルエディターで管理できます。
-
コンソール
コンソールで、ツールバーの「ロック解除」および「ロック アクションを使用して、読み取り専用モードを管理できます。
-
モデルを ロック解除 して編集を有効にすることができます。
「ロック解除」を選択した場合、警告が表示されるので、「ロック解除」アクションを確定する必要があります。
その後、モデルを編集用に開くことができます。
-
編集後にまたモデルを ロック することもできます。
-
モデルを再公開すると、すぐに ロック済み（読み取り専用）モードに戻ります。
-
-
モデルエディター
-
ロックされているモデルを開くと、警告が表示され、「キャンセル」、「読み取り専用で表示」、「編集 の 3 つのアクションが提示されます。
-
読み取り専用で表示 を選択した場合、モデルの内容と構造を表示できます。
-
「編集」を選択すると、更新内容を編集して保存できます。
note note NOTE まだ上部に警告が表示される場合がありますが、その場合は、モデルが既存のコンテンツフラグメントで既に使用されています。 -
「キャンセル」を選択すると、コンソールに戻ります。
-