リンクタイプを編集する

リンクタイプの編集は、アプリケーションの動作を妨げる影響を及ぼし、ユーザーのワークフローを中断させる可能性があります。リンクタイプの編集を進める前に、以下の破壊的変更の可能性に関するセクションをお読みください。

破壊的変更の可能性

ライトバックがないリンクタイプ

Object Storage v1 (Phonograph) でリンクタイプの元データソースの登録解除と再登録が必要になる変更を行うと、再インデックス中は、そのタイプのリンクがユーザーアプリケーションで利用できなくなります。該当する変更を以下に示します。

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

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

これらの変更を保存しようとすると、ユーザーアプリケーションに及ぼす可能性のある影響について警告が表示されます。

たとえば、Workshop アプリケーションの関連検索でリンクタイプが使用されている場合、再インデックスが完了するまで、その Workshop アプリケーションは正常に動作しなくなります。リンクタイプの再インデックスの進行状況は、データソースページの Phonograph ペインで確認できます。

Object Storage v1 (Phonograph) の詳しくはこちら。

ライトバックがあるリンクタイプ

リンクタイプでライトバックが有効になっている場合、そのリンクタイプを編集するときには特に注意が必要です。リンクタイプに加えられた編集の履歴は、Object Storage v1 (Phonograph) に保存されます。ライトバックデータセットがビルドされるたびに、編集履歴が再適用され、ライトバックデータセット内の編集されたリンクの最終的な状態が生成されます。Object Storage v1 (Phonograph) からリンクタイプの元データソースの登録が解除されると、Object Storage v1 (Phonograph) 内の編集履歴が削除され、それ以降のライトバックデータセットのビルドは失敗します。

前のセクションで示した登録解除が必要な変更に加えて、ライトバックがあるリンクタイプでは、過去に一度でも編集を受けたリンクタイプの元データソースのいずれかの列にスキーマ変更を加える場合も、登録解除が必要です。これは、現在は編集を受けていない場合にも当てはまります。スキーマ変更には、列の名前やベースタイプの変更が含まれます。

スキーマ変更では自動的に登録解除されません

これらのスキーマ変更に応じて、Object Storage v1 (Phonograph) がリンクタイプの元データソースの登録を自動的に解除することはありません。代わりに、再インデックスに失敗します。保存したスキーマ変更を元に戻すか、リンクタイプのデータソースページの Phonograph ペインで元データソースの登録解除と再登録を手動で行った場合にのみ、再インデックスに成功します。

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

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

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

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

リンクタイプを削除する

リンクタイプビューのサイドバーの右上にある（3点）アイコン（下の画像を参照）を選択し、ドロップダウンから削除を選択すると、オブジェクトタイプを削除できます。リンクタイプを削除対象としてステージングするか確認するダイアログが表示されます。

リンクタイプの削除は、変更を保存した後にのみ反映され、オブジェクトタイプを参照しているビューやアプリケーションの動作を妨げます。
ステータスがアクティブのリンクタイプは削除できません。ステータスの詳細を参照してください。

元データソースを変更する

元データソースは、以下の手順で変更できます。

リンクタイプビューのデータソースページに移動します。
既存のデータソースの横にある選択アイコンを選択します。Foundry 内の利用可能なデータソースを参照して選択できるようになります。

スキーマが一致する場合にのみキーが自動的に再マッピングされます

リンクタイプの元データソースを変更すると、以前のデータソースの列とリンクタイプを定義するキーとの間の対応付けがすべて削除されます。以前のデータソースと同じスキーマを持つ新しいデータソースに変更する場合にのみ、キーが自動的に再マッピングされます。それ以外の場合は、新しいデータソースにキーを再マッピングする必要があります。

元データソースを選択する

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

ステータス： リンクタイプペインの上部にある現在のステータスを選択すると、利用可能なステータスのドロップダウンが開きます。非推奨、試験的、アクティブのステータスから選択します。
- ステータスの詳細を参照してください。
キー： ドロップダウンから選択して、外部キー、または多対多のリンクタイプの列マッピングを変更します。
- カーディナリティが多対多のリンクタイプでは、元データソースの列をオブジェクトタイプの主キーにマッピングする必要があります。オブジェクトタイプの主キープロパティのデータ型が、リンクタイプの元データソースでマッピング先となる列のデータ型と異なる場合は、エラーにより保存できません。
- それ以外のカーディナリティのリンクタイプでは、アプリケーションの要件として、いずれかのオブジェクトタイプのキーをそのオブジェクトタイプの主キーにマッピングする必要があります。これにより、カーディナリティの「1」側の一意性が保証されます。
API名： 現在のAPI名を選択して、値を変更します。
- ステータスがアクティブのリンクタイプでは、API名を変更できません。
  - ステータスの詳細を参照してください。
  - 有効なAPI名の詳細を参照してください。
重要性： リンクの重要性リストから重要性を選択します。重要性が強調のリンクタイプは、アプリケーションでユーザーに優先的に表示されます。重要性が非表示のリンクタイプは、ユーザーアプリケーションに表示されません。
タイプクラス： アプリケーションが解釈できる追加のメタデータとして、タイプクラスを適用します。
- 詳細については、利用可能なタイプクラスのリストを参照してください。