UI での XDM スキーマの書き出し export-xdm-schemas-in-the-UI
スキーマライブラリ内のすべてのリソースは、組織内の特定のサンドボックスに格納されます。 場合によっては、サンドボックスと組織の間で Experience Data Model (XDM)リソースを共有する必要があります。
このニーズに対応するために、Adobe Experience Platform UI の Schemas ワークスペースでは、スキーマライブラリ内の任意のスキーマの書き出しペイロードを生成できます。 その後、このペイロードを Schema Registry API の呼び出しで使用して、スキーマ(およびすべての依存リソース)をターゲットサンドボックスおよび組織に読み込むことができます。
前提条件
Experience Platform UIではXDMリソースをエクスポートできますが、ワークフローを完了するには、スキーマ Registry API を使用してそれらのリソースを他のサンドボックスまたは組織にインポートする必要があります。 このガイドに従う前に、必要な認証ヘッダーに関する重要な情報については、 スキーマレジストリ API の概要 のガイドを参照してください。
書き出しペイロードの生成 generate-export-payload
書き出しペイロードは、 Browse タブの詳細パネルからExperience Platform UIで生成することも、スキーマエディターのスキーマのキャンバスから直接生成することもできます。
書き出しペイロードを生成するには、左側のナビゲーションで「Schemas」を選択します。 Schemas ワークスペース内で、書き出すスキーマの行を選択して、右側のサイドバーにスキーマの詳細を表示します。
次に、使用可能なオプションから Copy JSON アイコン(
これにより、スキーマ構造に基づいて生成された JSON ペイロードがクリップボードにコピーされます。 上記の「Loyalty Members」スキーマの場合、次の JSON が生成されます。
| code language-json |
|---|
|
ペイロードは、スキーマエディターの右上にある「More」を選択してコピーすることもできます。 ドロップダウンメニューには、[ Copy JSON structure ] と [ Delete schema] の 2 つのオプションがあります。
ペイロードは配列の形式を取り、各配列項目はエクスポートするカスタム XDM リソースを表すオブジェクトです。 上記の例では、「Loyalty details」カスタムフィールドグループと「Loyalty Members」スキーマが含まれています。 スキーマで使用されるコアリソースは、すべてのサンドボックスと組織で使用できるので、書き出しに含まれません。
組織のテナント ID の各インスタンスは、ペイロードでは <XDM_TENANTID_PLACEHOLDER> として表示されます。 これらのプレースホルダーは、次の手順でスキーマを読み込む場所に応じて、適切なテナント ID 値に自動的に置き換えられます。
API を使用したリソースの読み込み import-resource-with-api
スキーマの書き出し JSON をコピーしたら、Schema Registry API の /rpc/import エンドポイントに対する POST リクエストのペイロードとして使用できます。 スキーマを目的の組織およびサンドボックスに送信するための呼び出しを設定する方法について詳しくは、 インポートエンドポイントガイド を参照してください。
次の手順
このガイドに従うと、XDM スキーマを別の組織またはサンドボックスに正常に書き出すことができます。 Schemas UI の機能について詳しくは、Schemas UI の概要を参照してください