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