UI での XDM フィールドの非推奨化

エクスペリエンスデータモデル（XDM）を使用すると、データの取り込み後にスキーマフィールドを非推奨（廃止予定）にすることで、ビジネスニーズの変化に合わせてデータモデルを柔軟に管理できます。不要なフィールドを非推奨（廃止予定）にして、UI ビューから削除したり、ダウンストリーム UI で非表示にしたりできます。便利なことに、スキーマエディターのチェックボックスを使用すると、非推奨フィールドを表示でき、必要に応じて非推奨フィールドの非推奨化を解除することもできます。

非推奨フィールドはデフォルトで UI に表示されないので、スキーマエディター内でスキーマが無駄なく整理され、不要なフィールドがセグメントビルダーやジャーニーデザイナーなどのダウンストリーム依存関係に追加されるのを防ぐことができます。フィールドの非推奨化には下位互換性もあります。オーディエンスやクエリなどの非推奨フィールドを使用する他のシステムでは、非推奨フィールドが引き続き意図されたとおりに評価されます。既存のセグメントで使用されている場合、非推奨フィールドは通常どおりに扱われます。つまり、非推奨フィールドはセグメントビルダーキャンバスに想定どおりに表示され、非推奨フィールドで使用可能なデータに基づいて評価されます。これは、既存のデータフローに悪影響を与えない非破壊的な変更です。

データをいったんスキーマに取り込むと、破壊的な変更を行わずにスキーマからフィールドを削除することはできなくなります。 この場合、スキーマエディターまたはスキーマレジストリ API を使用して、スキーマまたはカスタムリソース内の不要なフィールドを非推奨（廃止予定）にすることができます。

このドキュメントでは、Experience Platform ユーザーインターフェイスでスキーマエディターを使用して、様々な XDM リソースのフィールドを非推奨（廃止予定）にする方法について説明します。 API を使用して XDM フィールドを非推奨（廃止予定）にする手順については、スキーマレジストリ API を使用した XDM フィールドの非推奨化に関するチュートリアルを参照してください。

フィールドの非推奨化 deprecate

カスタムフィールドを非推奨（廃止予定）にするには、編集するスキーマのスキーマエディターに移動します。 キャンバスの「構造」セクションから非推奨（廃止予定）にするフィールドを選択します。その後、フィールドプロパティから「非推奨にする」を選択します。

選択を確認するダイアログが表示され、フィールドが結合スキーマの UI ビューから削除され、ダウンストリーム UI で非表示になることが通知されます。 アクションを完了するには、「確認」を選択します。

これで、フィールドが UI ビューから削除されます。

非推奨フィールドの表示 show-deprecated

既に非推奨（廃止予定）になっているフィールドを表示するには、スキーマエディターで関連するスキーマに移動します。 キャンバスの「構成」セクションの「非推奨フィールドを表示」チェックボックスを選択します。

非推奨フィールドが UI ビューに表示されます。 「保存」を選択して、設定を確定します。

フィールドの非推奨化解除 undeprecate-fields

非推奨フィールドを元に戻すには、上記のように「非推奨フィールドを表示」を選択してから、エディターの「構造」セクションから非推奨フィールドを選択します。 次に、「フィールドプロパティ」サイドバーから「非推奨にしない」を選択して、「保存」を選択します。

フィールドを非推奨にしないダイアログが表示されます。 変更を確定するには、「確認」を選択します。

これで、このフィールドは、UI ビューおよびダウンストリーム UI で標準フィールドとして表示されるようになります。 やはりここでも、フィールドを非推奨にするオプションがあります。

次の手順

このドキュメントでは、スキーマエディター UI を使用して XDM フィールドを非推奨（廃止予定）にする方法について説明しました。 カスタムリソースのフィールドの設定について詳しくは、API での XDM フィールドの定義に関するガイドを参照してください。記述子の管理について詳しくは、記述子エンドポイントガイドを参照してください。