スキーマのエクスポートとインポート

Data Fabric / Data Service でエンティティとチョイス セットのスキーマをエクスポートおよびインポートして、開発、テスト、運用全体にわたるアプリケーション ライフサイクル管理をサポートします。

概要

スキーマは、すべてのエンティティとチョイス セットのメタデータであり、エンティティ フィールドのデータ型やエンティティ フィールド間のリレーションシップなどの情報を保持します。

By exporting and importing schema, you are able to implement the best practices of an application lifecycle management—development, testing, deployment—considering capabilities such as copying schema between tenants and folders, or tracking schema changes through a source control tool of your choice.

Exporting schema downloads a JSON file containing the entity metadata on your local machine. You may share the file to be imported by different developers into their tenants or folders, and you yourself can import schemas developed by the community.

Cloning entities across scopes

You can use export and import to clone a native entity schema from one scope to another. For example, export a tenant-level entity and import it into a folder to create a folder-scoped copy with the same schema. Only the schema is cloned — no data is copied. The imported entity is independent of the original and can be modified separately.

This is useful when you want to reuse an existing entity design in a folder for use with Solutions, without recreating the schema manually.

権限

スキーマをエクスポートおよびインポートするユーザーには、以下の管理権限を設定する必要があります。

操作	アクセス許可
スキーマをエクスポート	スキーマの表示
スキーマをインポート	スキーマのカスタマイズ スキーマの表示

必要な権限の設定方法については、「 アクセス権を管理する 」をご覧ください。

スキーマをエクスポートする

注:

• スキーマをエクスポートできるのは、適切な権限を持つユーザーのみです。
• All native entities present in the tenant are exported.
• システム組み込みエンティティと対応するシステム フィールドは、エクスポートから除外されます。

To export schema:

1. Data Fabric/Data Service で目的のテナントに移動します。
2. [ インポート/エクスポート] を選択します。
3. [スキーマをエクスポート] を選択します。エクスポートの確認を求めるポップアップ メッセージが表示されます。
4. [ 確定 ] を選択してエクスポートをトリガーします。スキーマを含む .JSON ファイルがマシンにダウンロードされます。

スキーマをインポートする

注:

• スキーマをインポートできるのは、適切な権限を持つユーザーのみです。
• インポートされるスキーマ ファイルの要件は以下のとおりです。
  • 有効であること
  • JSON 形式であること
  • 30 MB 未満であること
• インポートされたスキーマの [作成者] と [変更者] フィールドには、インポートを実行したユーザーが入力されます。
• [作成時刻] と [最終変更時刻] フィールドには、インポートのタイムスタンプが入力されます。
• インポート プロセスは、一度開始されると停止できません。

To import a schema:

1. Navigate to the desired tenant or folder in Data Fabric / Data Service.
2. [ インポート/エクスポート] を選択します。
3. Select Import Schema.
4. Select the destination location (tenant or folder) for the import.
5. Browse for the schema file and select it.
   注:

   The schema file must be in JSON format and valid. If you are generating schema files through coding agents, verify that the field types match the expected Data Fabric types, as incorrect types can cause unexpected behavior.

6. Select the entities and choice sets you want to import.
7. If no duplicate is detected, the selected entities are imported in the selected destination. In case of duplicates, the Entities Import window is displayed, allowing you to either append duplicate fields to existing entities or to not import the duplicates.

重複を処理する

The process of importing a schema compares the existing entities, fields, or choice sets in the selected destination to those in the imported schema.

インポートされたスキーマ内で見つかった重複ごとに、以下のオプションが表示されます。

既存の一覧に追加 (既定のオプション)

• Entity fields and choice sets that do not exist in the selected destination are imported.
• プロパティ (名前やデータ型など) が異なるフィールドとチョイス セットを含むエンティティはインポートされません。

インポートしない

• The entity does not get imported to the selected destination.