コンテンツフラグメントモデル content-fragment-models

IMPORTANT
早期導入プログラムを通じて、コンテンツフラグメントモデルの様々な機能を利用できます。
ステータスと、関心のあるユーザーへの適用方法を確認するには、 リリースノートを確認してください。

Adobe Experience Manager(AEM)as a Cloud Service のコンテンツフラグメントモデルでは、コンテンツフラグメントのコンテンツの構造を定義します。これらのフラグメントは、ページオーサリングまたはヘッドレスコンテンツの基盤として使用できます。

コンテンツフラグメントモデルを使用するには、以下を行います。

コンテンツフラグメントモデルの作成 creating-a-content-fragment-model

  1. ツール一般 ​に移動し、コンテンツフラグメントモデル ​を開きます。

  2. 目的の設定またはサブ設定に適したフォルダーに移動します。

  3. 作成」を使用してウィザードを開きます。

    note caution
    CAUTION
    コンテンツフラグメントモデルの使用が有効になっていない場合、「作成」オプションは使用できません。
  4. モデルタイトル ​を指定します。
    また、例えば「タグ」、「説明」を追加し、必要に応じて「モデルを有効化」を選択してモデルを有効にすることで、様々なプロパティを定義できます。
    デフォルトのプレビュー URL パターン.

    note note
    NOTE
    詳しくは、コンテンツフラグメントモデル - プロパティを参照してください。

    タイトルと説明

  5. 作成」を使用して、空のモデルを保存します。アクションの成功を示すメッセージが表示され、「開く」を選択して、モデルを直ちに編集するか、「完了」でコンソールに戻ります。

CAUTION
複数の参照されたフラグメントに対してクエリを実行する場合は、様々なフラグメントモデルに同じ名前でタイプが異なるフィールド名を付けることはお勧めしません。
詳しくは、コンテンツフラグメントと共に使用する AEM GraphQL API - 制限事項を参照してください。

コンテンツフラグメントモデル - プロパティ content-fragment-model-properties

これらのプロパティは、モデルの作成時に定義され、後にコンテンツフラグメントモデルの「プロパティ」オプションで編集できます。

  • 基本

    • モデルタイトル

    • タグ

    • 説明

    • モデルを有効化

    • デフォルトのプレビュー URL パターン
      コンテンツフラグメントエディターを使用すると、作成者は外部フロントエンドアプリケーションのコンテンツを​ プレビュー ​できます。プレビューサービス ​を設定したら、フロントエンドアプリケーションの URL を追加します。

      プレビュー URL は次のパターンに従う必要があります。
      https://<preview_url>?param=${expression}

      使用できる式は次のとおりです。

      • ${contentFragment.path}
      • ${contentFragment.model.path}
      • ${contentFragment.model.name}
      • ${contentFragment.variation}
      • ${contentFragment.id}
    • 画像をアップロード

コンテンツフラグメントモデルの定義 defining-your-content-fragment-model

コンテンツフラグメントモデルは、データタイプ ​の選択を使用して、結果として得られるコンテンツフラグメントの構造を効果的に定義します。モデルエディターを使用して、データタイプのインスタンスを追加し、それらを設定して必須フィールドを作成できます。

CAUTION
既存のコンテンツフラグメントで既に使用されているモデルを編集すると、それらの依存フラグメントに影響を与える可能性があります。
  1. ツール一般 ​に移動し、コンテンツフラグメントモデル ​を開きます。

  2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

  3. 必要なモデルを 編集 用に開きます。クイック操作を使用するか、モデルを選択してツールバーから操作を選択します。

    モデルを開くと、モデルエディターに以下の情報が表示されます。

    • 左:フィールドが既に定義されています
    • 右:フィールドの作成に使用できる​ データタイプ(およびフィールドの作成後に使用する​ プロパティ
    note note
    NOTE
    あるフィールドを「必須」と指定した場合、左側のウィンドウに表示される​ ラベル ​にアスタリスク(*)が付きます。

プロパティ

  1. フィールドを追加するには

    • 必要なデータタイプをフィールドの必要な場所にドラッグします。

      データタイプをドラッグしてフィールドを作成

    • フィールドがモデルに追加されると、その特定のデータタイプに対して定義できる​ プロパティ ​が右側のパネルに表示されます。ここで、そのフィールドに必要な項目を定義することができます。

      • 多くのプロパティは自明です。詳しくは「プロパティ」を参照してください。

      • フィールドラベル」を入力すると、「プロパティ名」が空欄の場合は自動入力され、後で手動で更新できます。

        note caution
        CAUTION
        データタイプのプロパティの「プロパティ名」を手動で更新する場合、名前には、A~Z、a~z、0~9 および特殊文字のアンダースコア「_」のみ ​を使用することができます。
        以前のバージョンの AEM で作成されたモデルに不正な文字が含まれている場合は、それらの文字を削除または更新します。

      次に例を示します。

      フィールドのプロパティ

  2. フィールドを削除するには

    必須フィールドを選択し、ごみ箱アイコンを選択します。アクションの確認が求められます。

    削除

  3. すべての必須フィールドを追加し、必要に応じて関連するプロパティを定義します。次に例を示します。

    保存

  4. 保存」を選択して、定義を保持します。

データタイプ data-types

モデルの定義には、次のデータタイプを選択できます。

  • 1 行のテキスト

    • 1 行のテキストのフィールドを追加します。最大長を定義できます
    • フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
  • 複数行テキスト

    • リッチテキスト、プレーンテキストまたはマークダウンのテキストエリア
    • フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
    note note
    NOTE
    テキストエリアがリッチテキスト、プレーンテキストまたはマークダウンのどれであるかは、モデル内で、プロパティの​ デフォルトのタイプ ​によって定義されます。
    この形式は、コンテンツフラグメントエディターから変更はできませんが、モデルからのみ変更できます。
  • 数値

    • 数値フィールドの追加
    • フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
  • ブール型

    • ブール型チェックボックスを追加
  • 日時

    • 日付や時刻のフィールドを追加する
  • 列挙

    • チェックボックス、ラジオボタン、ドロップダウンフィールドのセットを追加
      • フラグメント作成者が使用できるオプションを指定できます
  • タグ

    • フラグメント作成者がタグの領域にアクセスして選択できるようにする
  • フラグメント参照

    • 他のコンテンツフラグメントの参照をネストされたコンテンツの作成に使用可能

    • このデータタイプは、フラグメント作成者が次の操作を行えるように設定可能です。

      • 参照先フラグメントの直接編集
      • 適切なモデルに基づいた新しいコンテンツフラグメントの作成
      • フィールドの新しいインスタンスを作成
    • 参照は、参照されるリソースへのパスを指定します。例:/content/dam/path/to/resource

  • フラグメント参照(UUID)

    • 他のコンテンツフラグメントの参照をネストされたコンテンツの作成に使用可能

    • このデータタイプは、フラグメント作成者が次の操作を行えるように設定可能です。

      • 参照先フラグメントの直接編集
      • 適切なモデルに基づいた新しいコンテンツフラグメントの作成
      • フィールドの新しいインスタンスを作成
    • エディターでは、参照は参照されるリソースへのパスを指定します。内部的には、参照は、リソースを参照するユニバーサル固有識別子(UUID)として保持されます

      • UUID を知っている必要はありません。フラグメントエディターで、必要なフラグメントを参照できます
  • コンテンツ参照

    • 任意の種類の他のコンテンツを参照し、ネストされたコンテンツの作成に使用可能
    • 画像が参照されている場合は、サムネールを表示するように選択可能
    • フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
    • 参照は、参照されるリソースへのパスを指定します。例:/content/dam/path/to/resource
  • コンテンツ参照(UUID)

    • 任意の種類の他のコンテンツを参照し、ネストされたコンテンツの作成に使用可能
    • 画像が参照されている場合は、サムネールを表示するように選択可能
    • フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
    • エディターでは、参照は参照されるリソースへのパスを指定します。内部的には、参照は、リソースを参照するユニバーサル固有識別子(UUID)として保持されます
      • UUID を知っている必要はありません。フラグメントエディターで、必要なアセットリソースを参照できます
  • JSON オブジェクト

    • コンテンツフラグメントの作成者がフラグメントの対応する要素に JSON 構文を入力できます。

      • 別のサービスからコピー&ペーストした JSON を AEM に直接保存できるようにします。
      • JSON が渡され GraphQL で JSON として出力されます。
      • コンテンツフラグメントエディターに JSON 構文のハイライト表示機能、オートコンプリートおよびエラーのハイライト表示機能が含まれています。
  • タブプレースホルダー

    • コンテンツフラグメントコンテンツの編集時に使用するタブを導入を許可します。

      • モデルエディターで区切りとして表示され、コンテンツデータタイプのリストをセクションに分割します。各インスタンスは、新しいタブの開始を表します。
      • フラグメントエディターでは、各インスタンスがタブとして表示されます。
      note note
      NOTE
      このデータタイプは書式設定にのみ使用され、AEM GraphQL スキーマでは無視されます。

プロパティ properties

多くのプロパティは自明です。プロパティによっては次に示す追加の詳細情報があります。

  • プロパティ名

    データタイプのこのプロパティを手動で更新する場合、名前には、A~Z、a~z、0~9 および特殊文字としてアンダースコア「_」のみ ​を使用する​ 必要があります

    note caution
    CAUTION
    以前のバージョンの AEM で作成されたモデルに不正な文字が含まれている場合は、それらの文字を削除または更新します。
  • レンダリング形式

    フラグメント内のフィールドを実現/レンダリングするための様々なオプション。多くの場合、これにより、オーサーにフィールドの 1 つのインスタンスが表示されるか、オーサーが複数のインスタンスを作成できるかを定義できます。複数フィールド ​を使用する場合、項目の最小数と最大数を定義できます。詳しくは、検証を参照してください。

  • フィールドラベル
    フィールドラベル ​を入力すると、プロパティ名 ​を自動生成し、必要に応じて手動で更新できます。

  • 検証 ​基本検証は、
    必須 ​プロパティなどのメカニズムで使用できます。一部のデータ型には、追加の検証フィールドがあります。詳しくは、「検証」を参照してください。

  • データタイプが​ 複数行テキスト ​の場合、「デフォルトの種類」を次のいずれかとして定義できます。

    • リッチテキスト
    • Markdown
    • プレーンテキスト

    指定しなかった場合は、デフォルト値の​ リッチテキスト ​がこのフィールドで使用されます。

    コンテンツフラグメントモデルで​ デフォルトのタイプ ​を変更した場合、その影響が既存の関連コンテンツフラグメントに及ぶのは、そのフラグメントがエディターで開かれて保存された後です。

  • 一意
    (特定のフィールドの)コンテンツは、現在のモデルから作成されたすべてのコンテンツフラグメントで一意である必要があります。

    これにより、同じモデルの別のフラグメントに既に追加されているコンテンツをコンテンツ作成者が繰り返し作成できないようになります。

    例えば、コンテンツフラグメントモデルの 1 行のテキスト ​フィールド Country は、2 つの依存するコンテンツフラグメントで同じ Japan 値を持つことはできません。2 つ目のインスタンスが試行された場合、警告が表示されます。

    note note
    NOTE
    言語ルートごとに一意性が確保されます。
    note note
    NOTE
    バリエーションは、同じフラグメントのバリエーションと同じ​ 一意の ​値を持つことができますが、他のフラグメントのバリエーションで使用されている値とは異なります。
  • 特定のデータタイプとそのプロパティについて詳しくは、コンテンツ参照 ​を参照してください。

  • 特定のデータタイプとそのプロパティについて詳しくは、フラグメント参照(ネストされたフラグメント) ​を参照してください。

  • 変換可能

    コンテンツフラグメントモデルエディターのフィールドの「翻訳可能」チェックボックスをオンにした場合:

    • フィールドのプロパティ名がまだ存在しない場合は、翻訳設定のコンテキスト /content/dam/<sites-configuration> に確実に追加されます。
    • GraphQL の場合:「コンテンツフラグメント」フィールドの <translatable> プロパティを yes に設定して、変換可能なコンテンツのみを含む JSON を出力するための GraphQL クエリフィルターを許可します。

検証 validation

様々なデータ型に、結果のフラグメントにコンテンツが入力される際の検証要件を定義できるようになりました。

  • 1 行のテキスト

    • 事前定義された正規表現と比較します。
  • 数値

    • 特定の値を確認します。
  • コンテンツ参照

    • 特定のタイプのコンテンツをテストします。
    • 指定したファイルサイズ以下のアセットのみを参照できます。
    • 定義済みの幅または高さ(ピクセル単位)の範囲に収まる画像のみを参照できます。
  • フラグメント参照

    • 特定のコンテンツフラグメントモデルをテストします。
  • 最小項目数最大項目数

    複数フィールド ​として定義されているフィールド(レンダリング形式 ​で設定)には、次のオプションがあります。

    • 最小項目数
    • 最大項目数

    これらは、コンテンツフラグメントエディターで検証されます。

参照の使用によるネストされたコンテンツの作成 using-references-to-form-nested-content

コンテンツフラグメントは、次のいずれかのデータタイプを使用して、ネストされたコンテンツを作成できます。

  • コンテンツ参照

    • 他のコンテンツへの単純な参照(任意のタイプ)を提供します。

    • データタイプによって提供されます。

      • コンテンツ参照 - パスベース
      • コンテンツ参照(UUID) - UUID ベース
    • (結果のフラグメント内で)1 つまたは複数の参照に対して設定できます。

  • フラグメント参照(ネストされたフラグメント)

    • 指定した特定のモデルに応じて、他のフラグメントを参照します。

    • データタイプによって提供されます。

      • フラグメント参照 - パスベース
      • フラグメント参照(UUID) - UUID ベース
    • 構造化データを包含/取得できます。

      note note
      NOTE
      このメソッドは、GraphQL でコンテンツフラグメントを使用したヘッドレスコンテンツ配信を使用する場合、特に重要になります。

      * (結果のフラグメント内で)1 つまたは複数の参照に対して設定できます。

NOTE
コンテンツ/フラグメント参照とコンテンツ/フラグメント参照(UUID)の詳細 🔗 および UUID ベースのデータタイプへのアップグレードについては、UUID 参照のためのコンテンツフラグメントのアップグレード」を参照してください。
NOTE
AEM では次の繰り返しを防止できます。
  • コンテンツ参照
    これにより、ユーザーは現在のフラグメントに参照を追加できなくなり、フラグメント参照ピッカーダイアログが空になる場合があります。

  • GraphQL のフラグメント参照
    相互に参照される複数のコンテンツフラグメントを返すディープクエリを作成する場合、最初に null が返されます。

CAUTION
複数の参照されたフラグメントに対してクエリを実行する場合は、様々なフラグメントモデルに同じ名前でタイプが異なるフィールド名を付けることはお勧めしません。
詳しくは、コンテンツフラグメントと共に使用する AEM GraphQL API - 制限事項を参照してください。

コンテンツ参照 content-reference

コンテンツ参照 および コンテンツ参照(UUID) データタイプを使用すると、画像、ページ、エクスペリエンスフラグメントなどの別のソースからコンテンツをレンダリングできます。

標準プロパティに加えて、以下を指定できます。

  • 参照されるコンテンツを格納する場所を指定または表す ルートパス

    note note
    NOTE
    これは、コンテンツフラグメントエディターの使用時に、このフィールドで画像を直接アップロードして参照する場合に必須です。
    詳しくは、参照画像を参照してください。
  • 参照可能なコンテンツタイプ

    note note
    NOTE
    コンテンツフラグメントエディターの使用時に、このフィールドで画像を直接アップロードして参照する場合は、画像 ​を含める必要があります。
    詳しくは、参照画像を参照してください。
  • ファイルサイズの制限

  • 画像が参照されている場合:

    • サムネールを表示
    • 画像の高さと幅の制限

コンテンツ参照

フラグメント参照(ネストされたフラグメント) fragment-reference-nested-fragments

フラグメント参照 および フラグメント参照(UUID) データタイプは、1 つ以上のコンテンツフラグメントを参照できます。 複数のレイヤーを持つ構造化データを取得できるようになるので、アプリで使用するコンテンツを取得する場合、この機能は特に重要になります。

次に例を示します。

  • 次が含まれる従業員の詳細を定義するモデルです。
    • 事業主(会社)を定義するモデルへの参照
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
NOTE
フラグメント参照は、GraphQL でコンテンツフラグメントを使用したヘッドレスコンテンツ配信で特に重要になります。

標準プロパティに加えて、次のものを定義できます。

  • レンダリング時の名前:

    • multifield - フラグメント作成者は個別の参照を複数作成できます。

    • fragmentreference - フラグメント作成者はフラグメントへの 1 つの参照を選択できます。

  • モデルタイプ
    複数のモデルを選択できます。コンテンツフラグメントに参照を追加する場合、これらのモデルを使用して参照先のフラグメントが既に作成されている必要があります。

  • ルートパス
    参照されるフラグメントのルートパスを指定または表します。

  • フラグメントの作成を許可

    これにより、フラグメント作成者は、適切なモデルに基づいてフラグメントを作成できるようになります。

    • fragmentreferencecomposite - フラグメント作成者が複数のフラグメントを選択して複合フラグメントを作成できるようになります。

    フラグメント参照

NOTE
繰り返し防止メカニズムが設定されます。これにより、ユーザーがフラグメント参照で現在のコンテンツフラグメントを選択できなくなり、フラグメント参照ピッカーダイアログが空になる場合があります。
GraphQL にも、フラグメント参照の繰り返しを防止する機能があります。相互に参照する 2 つのコンテンツフラグメントにわたるディープクエリを作成すると、null が返されます。

コンテンツフラグメントモデルの有効化または無効化 enabling-disabling-a-content-fragment-model

コンテンツフラグメントモデルを​ 有効化 ​または​ 無効化 ​して、その使用を完全に制御できます。

コンテンツフラグメントモデルの有効化 enabling-a-content-fragment-model

モデルを作成したら、次のようにモデルを有効にする必要があります。

  • コンテンツフラグメントの作成時に選択できます。
  • コンテンツフラグメントモデル内から参照する
  • GraphQL で使用する(スキーマが生成される)

次のいずれかとしてフラグ付けされたモデルを有効にするには

  • ドラフト:新規(有効化されていない)
  • 無効:明示的に無効化されている

​有効化」オプションは、次のいずれかから使用します。

  • 上部のツールバー(必要なモデルが選択されている場合)
  • 対応するクイックアクション(必要なモデルにマウスを移動)

ドラフトまたは無効なモデルの有効化

コンテンツフラグメントモデルの無効化 disabling-a-content-fragment-model

モデルを無効にすると、以下のようになります。

  • このモデルは、新しい ​コンテンツフラグメントを作成する際の基盤としては使用できなくなります。

  • ただし、

    • GraphQL スキーマは生成され続け、スキーマのクエリも引き続き可能です(JSON API への影響を回避するため)。
    • モデルに基づくコンテンツフラグメントは、引き続き GraphQL エンドポイントからクエリして返すことができます。
  • モデルは参照できなくなりますが、既存の参照は変更されず、引き続き GraphQL エンドポイントからクエリして返すことができます。

有効」としてフラグ付けされたモデルを無効にするには、次のいずれかの「無効にする」オプションを使用します。

  • 上部のツールバー(必要なモデルが選択されている場合)
  • 対応するクイックアクション(必要なモデルにマウスを移動)

有効なモデルの無効化

アセットフォルダーでのコンテンツフラグメントモデルの許可 allowing-content-fragment-models-assets-folder

コンテンツのガバナンスを実装するには、アセットフォルダーに​ ポリシー ​を設定して、そのフォルダーでのフラグメント作成に使用可能なコンテンツフラグメントモデルを管理します。

NOTE
このメカニズムは、ページの高度なプロパティでページとその子に対してページテンプレートを許可することに似ています。

許可されているコンテンツフラグメントモデル ​に​ ポリシー ​を設定するには:

  1. 必要なアセットフォルダーの​ プロパティ ​を開きます。

  2. ポリシー」タブを開き、以下を設定します。

    • 継承元<folder>

      ポリシーは、新しい子フォルダーの作成時に自動的に継承されます。サブフォルダーで親フォルダーとは異なるモデルを許可する必要がある場合は、ポリシーを再設定(継承を解除)できます。

    • 許可されているコンテンツフラグメントモデルパス (パス別)

      複数のモデルを許可できます。

    • 許可されているコンテンツフラグメントモデルタグ (タグ別)

      複数のモデルを許可できます。

    コンテンツフラグメントモデルポリシー

  3. 変更内容を​ 保存 ​します。

フォルダーに対して許可されるコンテンツフラグメントモデルは、次の順序で解決されます。

  • 許可されているコンテンツフラグメントモデル ​の​ ポリシー
  • 空の場合は、継承ルールを使用してポリシーの決定を試みます。
  • 継承チェーンを使用しても結果が得られない場合は、そのフォルダーの Cloud Services 設定を調べます(最初は直接、次に継承を使用して調べます)。
  • 上記のいずれでも結果が得られない場合、そのフォルダーに許可されるモデルはありません。

コンテンツフラグメントモデルの削除 deleting-a-content-fragment-model

CAUTION
コンテンツフラグメントモデルを削除すると、依存するフラグメントに影響を与える場合があります。

コンテンツフラグメントモデルを削除するには、次の操作を実行します。

  1. ツール一般 ​に移動し、コンテンツフラグメントモデル ​を開きます。

  2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

  3. モデルを選択し、次にツールバーの「削除」を選択します。

    note note
    NOTE
    モデルが参照されている場合は、適切なアクションを実行できるように警告が表示されます。

コンテンツフラグメントモデルの公開 publishing-a-content-fragment-model

コンテンツフラグメントモデルは、そのモデルに依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。

コンテンツフラグメントモデルを公開するには、次の操作を実行します。

  1. ツール一般 ​に移動し、コンテンツフラグメントモデル ​を開きます。

  2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

  3. モデルを選択し、次にツールバーの「公開」を選択します。
    公開ステータスがコンソールに示されます。

    note note
    NOTE
    まだ公開されていないモデルのコンテンツフラグメントを公開すると、選択リストにそのことが示され、モデルがフラグメントと共に公開されます。

コンテンツフラグメントモデルを非公開にする unpublishing-a-content-fragment-model

コンテンツフラグメントモデルがフラグメントによって参照されていない場合は、そのモデルを非公開にできます。

コンテンツフラグメントモデルを非公開するには、次の操作を実行します。

  1. ツール一般 ​に移動し、コンテンツフラグメントモデル ​を開きます。

  2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

  3. モデルを選択し、次にツールバーの「非公開」を選択します。
    公開ステータスがコンソールに表示されます。

1 つ以上のフラグメントで現在使用されているモデルを非公開にしようとすると、エラーメッセージが表示されます。次に例を示します。

使用中のモデルを非公開にするときに表示されるコンテンツフラグメントモデルのエラーメッセージ

このメッセージでは、参照パネルを確認して詳細を調べるよう提案されます。

参照パネル内のコンテンツフラグメントモデル

ロック済み(公開済み)コンテンツフラグメントモデル locked-published-content-fragment-models

この機能は、公開済みのコンテンツフラグメントモデルに対するガバナンスを提供します。

課題 the-challenge

  • コンテンツフラグメントモデルは、AEM における GraphQL クエリのスキーマを決定します。

    • AEM GraphQL スキーマは、コンテンツフラグメントモデルが作成されると同時に作成され、オーサー環境とパブリッシュ環境の両方に存在できます。

    • 公開上のスキーマは、JSON 形式のコンテンツフラグメントコンテンツをライブ配信する場合の基盤となるので、非常に重要です。

  • コンテンツフラグメントモデルが変更つまり編集された場合には、問題が発生する可能性があります。つまり、スキーマの変更が既存の GraphQL クエリに影響を与える可能性があります。

  • コンテンツフラグメントモデルに新しいフィールドを追加する場合は、(通常は)悪影響はありません。ただし、既存のデータフィールド(名前など)を変更したり、フィールド定義を削除したりすると、既存の GraphQL クエリでこれらのフィールドをリクエストする際に、クエリが機能しなくなります。

要件 the-requirements

  • ライブコンテンツ配信に既に使用されているモデル(つまり、公開済みのモデル)を編集する際のリスクをユーザーに認識させる。

  • 意図しない変更を避ける。

いずれにせよ、変更されたモデルが再公開されると、クエリが機能しなくなる可能性があります。

解決策 the-solution

これらの問題に対処するために、コンテンツフラグメントモデルは、公開され次第、オーサー環境では読み取り専用モードに​ ロック ​されます。このステータスは、ロック済み ​と表示されます。

ロックされたコンテンツフラグメントモデルのカード

モデルが​ ロック済み(読み取り専用モード)の場合、モデルの内容と構造は表示できますが、モデルを編集することはできません。

ロック済み ​モデルは、コンソールまたはモデルエディターで管理できます。

  • コンソール

    コンソールで、ツールバーの「ロック解除」および「ロック」アクションを使用して、読み取り専用モードを管理できます。

    ロックされたコンテンツフラグメントモデルのツールバー

    • モデルを​ ロック解除 ​して編集を有効にすることができます。

      ロック解除」を選択した場合、警告が表示されるので、「ロック解除」アクションを確定する必要があります。
      コンテンツフラグメントモデルをロック解除する際のメッセージ

      その後、モデルを編集用に開くことができます。

    • 編集後にまたモデルを​ ロック ​することもできます。

    • モデルを再公開すると、すぐに​ ロック済み(読み取り専用)モードに戻ります。

  • モデルエディター

    • ロックされているモデルを開くと、警告が表示され、「キャンセル」、「読み取り専用で表示」、「編集」の 3 つのアクションが提示されます。

      ロックされたコンテンツフラグメントモデルを表示する際のメッセージ

    • 読み取り専用で表示」を選択した場合、モデルの内容と構造が表示されます。

      読み取り専用で表示 - ロックされたコンテンツフラグメントモデル

    • 編集」を選択すると、更新内容を編集して保存できます。

      編集 - ロックされたコンテンツフラグメントモデル

      note note
      NOTE
      まだ上部に警告が表示される場合がありますが、その場合は、モデルが既存のコンテンツフラグメントで既に使用されています。
    • キャンセル」を選択すると、コンソールに戻ります。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab