リンクタイプを編集する

潜在的な破壊的変更

書き戻しのないリンクタイプ

リンクタイプのバックデータソースを登録解除して再登録する必要がある変更は、再インデックスの期間中にそのタイプのリンクがユーザーアプリケーションで利用できなくなります。これらの変更は以下に説明されています。

以下の変更を保存すると、リンクタイプのバックデータソースが登録解除および再登録（または削除）されます：

• 多対多リンクタイプのバックデータソースを変更する。
• リンクタイプのカーディナリティを変更する。
• リンクタイプの外部キーを変更する。
• リンクタイプを削除する。

これらの変更を保存しようとすると、ユーザーアプリケーションへの影響について警告されます。

たとえば、リンクタイプが Workshop アプリケーションでの検索に使用されている場合、その Workshop アプリケーションは再インデックスが完了するまで機能しなくなります。リンクタイプの再インデックスの進行状況は、そのリンクタイプの Phonograph ペインの Datasources ページで追跡できます。

Object Storage V1 (Phonograph) についてさらに学ぶ。

書き戻しのあるリンクタイプ

リンクタイプに書き戻しが有効になっている場合、そのリンクタイプを編集する際には追加の注意が必要です。リンクタイプに行われた編集の履歴は Object Storage V1 (Phonograph) に保存されます。書き戻しデータセットがビルドされるたびに、編集の履歴が再適用され、書き戻しデータセットの最終的な編集リンクの状態が得られます。リンクタイプのバックデータソースが Object Storage V1 (Phonograph) から登録解除されると、Object Storage V1 (Phonograph) における編集の履歴が削除され、書き戻しデータセットの将来のビルドは失敗します。

前のセクションでリストされた登録解除が必要な変更に加えて、書き戻しのあるリンクタイプのバックデータソースのいずれかの列に対してスキーマ変更が行われた場合、編集履歴を持つリンクタイプのバックデータソースを登録解除する必要があります。スキーマ変更には、列の名前や基本タイプの変更が含まれます。

編集履歴を消去するリスクがある変更を保存しようとすると、編集への影響について警告されます。

既存のリンクタイプを編集する際の考慮事項を理解したので、安全に変更を行うことができます。

既存のリンクタイプを編集する

• 既存のリンクタイプに移動する
• リンクタイプを削除する
• バックデータソースを変更する
• リンクタイプのメタデータを編集する

既存のリンクタイプに移動する

リンクタイプページをホームページのサイドバーから選択し、リストから別のリンクタイプを選択することで、常に作業中のリンクタイプを変更できます。また、アプリケーションヘッダーの検索バーで新しいリンクタイプを検索することもできます。ナビゲーションについてさらに読むには、こちらをご覧ください。

リンクタイプを削除する

リンクタイプビューのサイドバーの右上にある （3 つの点）アイコンを選択し、ドロップダウンから Delete オプションを選択することで、リンクタイプを削除できます。削除の確認ダイアログが表示され、リンクタイプを削除することを確認できます。

• リンクタイプの削除は、変更を保存した後にのみ有効になり、オブジェクトタイプを参照しているビューやアプリケーションが破損します。
• active ステータスのリンクタイプは削除できません。ステータスについてさらに読むには、こちらをご覧ください。

バックデータソースを変更する

バックデータソースを変更するには：

1. リンクタイプビューの Datasources ページに移動します。
2. 既存のデータソースの横にある Select アイコンを選択します。これにより、Foundry 内の利用可能なデータソースを閲覧および選択できます。

リンクタイプのメタデータを編集する

1. ステータス: リンクタイプペインの上部にある既存のステータスを選択して、利用可能なステータスのドロップダウンを開きます。deprecated、experimental、active のステータスから選択します。
   • ステータスについてさらに読むには、こちらをご覧ください。
2. キー: ドロップダウンから選択して、外部キーや多対多リンクタイプの列マッピングを変更します。
   • 多対多カーディナリティを持つリンクタイプでは、バックデータソースの列はオブジェクトタイプの主キーにマッピングされる必要があります。オブジェクトタイプの主キーのプロパティのタイプがリンクタイプのバックデータソースの列のタイプと同じでない場合、エラーが発生し保存できません。
   • 他のカーディナリティを持つリンクタイプでは、オブジェクトタイプのいずれかのキーがそのオブジェクトタイプの主キーにマッピングされる必要があり、カーディナリティの「1」側が一意であることを保証します。
3. API 名: 既存の API 名を選択して値を変更します。
   • active ステータスのリンクタイプの API 名は変更できません。
     • ステータスについてさらに読むには、こちらをご覧ください。
     • 有効な API 名についてさらに読むには、こちらをご覧ください。
4. 可視性: リンクの可視性リストから可視性を確認します。prominent リンクタイプは、アプリケーションにこのリンクタイプをユーザーに最初に表示するよう促します。hidden リンクタイプはユーザーアプリケーションに表示されません。
5. タイプクラス: タイプクラスを追加のメタデータとして適用し、アプリケーションが解釈できるようにします。
   • 詳細については、利用可能なタイプクラスのリストを参照してください。