リンクタイプの作成

新しいリンクタイプを作成するには、以下のいずれかの方法で行います。

• ホームページのヘッダーにあるリンクタイプカードから 新しいリンクタイプ を選択するか、

  

• リンクしたいオブジェクトタイプに移動し、オブジェクトタイプの 概要 ページにあるリンクタイプグラフ内の 新しいリンクタイプの作成 ボタンを選択します。

  

新しいリンクタイプの設定

新しいリンクタイプを作成した後、リンクタイプを設定して保存する必要があります。新しいリンクタイプを保存する前に、以下の設定手順が必要です。

1. ID: リンクタイプの一意の識別子を選択してください。これは主に、アプリケーションの設定時にこのタイプのリンクを参照するために使用されます。
   • IDには、小文字、数字、ダッシュが含まれることができます。
   • IDの最初の文字は、必ず小文字である必要があります。
   • IDが保存されると、IDを変更することはできません。
2. オブジェクトタイプ: 開始オブジェクトタイプにリンクしたいオブジェクトタイプを選択します。
3. カーディナリティ: リンクタイプの両側のカーディナリティを選択します。オブジェクトタイプは、1対1、1対多、多対1、多対多の4つの異なるタイプのカーディナリティを通じて関連付けることができます。以下の例では、2つのオブジェクトタイプがカーディナリティを介して互いに関連していると仮定してください。Aircraft オブジェクトタイプと Flight オブジェクトタイプです。
   • 1対1のカーディナリティ: これは、1つの Aircraft が1つの Flight にリンクされるべきことを示しています。なお、1対1のカーディナリティは、意図された関係の指標として機能しますが、1対1のマッピングは強制されません。
   • 1対多のカーディナリティ: これは、1つの Aircraft が複数の Flights にリンクできることを示しています。
   • 多対1のカーディナリティ: これは、複数の Aircraft が1つの Flight にリンクできることを示しています。
   • 多対多のカーディナリティ: これは、1つの Aircraft が複数の Flights にリンクでき、1つの Flight が複数の Aircraft にリンクできることを示しています。
     • 多対多のカーディナリティを選択すると、最初のオブジェクトタイプ（この例では Aircraft ）と2つ目のオブジェクトタイプ（この例では Flight ）の主キー間のリンクのすべての組み合わせを含むデータソースのアップロードが求められます。
   • リンクタイプを編集または書き戻すことをユーザーに許可するためには、バッキングデータソースが必要な多対多のカーディナリティが必要です。ユーザーがデータを編集できるようにする方法について詳しく学ぶ。
4. キー: リンクを作成するためにどのプロパティや列を使用するか選択します。
   • 1対1または1対多のカーディナリティのリンクタイプでは、あるオブジェクトタイプの 外部キー プロパティが、他のオブジェクトタイプの 主キー プロパティを参照する必要があります。
     • 例えば、aircraft ID プロパティは Aircraft オブジェクトタイプの主キーです。Flight オブジェクトタイプの assigned aircraft ID プロパティは外部キーです。Aircraft の aircraft ID が Flight の assigned aircraft ID に一致すると、Aircraft と Flight オブジェクトタイプの間にリンクが作成されます。
   • 多対多のカーディナリティのリンクタイプでは、リンクタイプのバッキングデータソース内のどの列が、リンクされたオブジェクトタイプの各主キーにマップされるかを選択します。
     • オブジェクトタイプの主キーのプロパティの基本タイプが、リンクタイプのバッキングデータソース内の主キーがマップされている列のタイプと同じでない場合、エラーが発生し、保存できません。
5. 表示名: リンクタイプの両側の表示名を入力してください。リンクタイプの片側は、そのオブジェクトタイプへのリンクを表します。Aircraft オブジェクトタイプの表示名は、Flight から Aircraft へのリンクを説明します。この例では、表示名に Assigned Aircraft を選択できます。なぜなら、1つの Flight には1つの Assigned Aircraft があるからです。
6. 複数形の表示名: カーディナリティが多いリンクタイプの片側には、複数形の表示名も入力するよう求められます。これは、ユーザーアプリケーションがリンクされたオブジェクトを表示する際に正しい名前を表示できるようにするためです。この例では、Flight オブジェクトタイプの複数形の表示名は、Aircraft から Flight へのリンクを説明します。1つの Aircraft には複数の Scheduled Flights があるため、複数形の表示名は Scheduled Flights にするかもしれません。
7. API名: コード内でプログラム的にリンクタイプを参照するときに使用される API 名フィールドに入力します。リンクタイプの片側の API 名は、そのタイプのオブジェクトを返すために使用できます。例えば、リンクタイプの Aircraft 側の API 名が assignedAircraft の場合、Flight.assignedAircraft.get() を呼び出すと、それらの Flight オブジェクトにリンクされた Aircraft オブジェクトが返されます。
   • リンクタイプのAPI名は、以下の条件を満たす必要があります。
     • 小文字で始まり、英数字のみで構成される。
     • camelCaseで記述される。
     • 同じオブジェクトタイプに関連するすべてのリンクタイプで一意である。
   • API名について詳しく学ぶ。

これらのフィールドが入力されると、リンクタイプを保存することができます。これを行うには、オントロジーに変更を保存する方法の手順に従ってください。

トラブルシューティング

エラー: Phonograph2:DatasetAndBranchAlreadyRegistered

エラー Phonograph2:DatasetAndBranchAlreadyRegistered が表示された場合、保存しようとしているリンクタイプのバッキングデータソースは、オントロジー内の別のリンクタイプで既に使用されており、再度使用することはできません。