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

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

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

NOTE
データをスキーマに取り込む前に、不要なフィールドグループを削除できます。 詳しくは、スキーマからフィールドグループを削除する方法に関するドキュメントを参照してください。

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

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

フィールドの非推奨化 deprecate

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

選択したフィールドと「非推奨にする」がハイライト表示されているスキーマエディター

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

「確認」がハイライト表示されたフィールドを非推奨にするダイアログ

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

NOTE
いったん非推奨になると、セグメント化ダッシュボード、Customer Journey Analytics、Adobe Journey Optimizer などのダウンストリーム UI で、非推奨フィールドがワークフローの一部として表示されなくなります。 ただし、ダウンストリーム UI には、必要に応じて非推奨フィールドを表示したり、非推奨フィールドを引き続き通常のフィールドとして扱ったりするオプションがあります。 詳しくは、それぞれのドキュメントを参照してください。 非推奨フィールドを使用しているクエリやオーディエンスは、引き続き想定どおりに動作します。

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

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

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

選択したフィールド、「非推奨フィールドを表示」および「保存」がハイライト表示されたスキーマエディター

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

非推奨フィールドを取り消すには、まず前述のように非推奨フィールド ​を表示し、エディターの構造 セクションから非推奨フィールドを選択します。 次に、​ フィールドプロパティ ​ サイドバーから​ 非推奨 ​を選択し、保存​を選択します。

非推奨フィールド、「非推奨にしない」および「保存」がハイライト表示されたスキーマエディター

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

確認がハイライト表示された非推奨フィールド ​ ダイアログ。

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

次の手順

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

recommendation-more-help
experience-platform-help-xdm