メタデータリファレンス

リンクタイプは、Foundry オントロジー内で次のメタデータによって表されます。

• ID: リンクタイプの一意の識別子で、主にアプリケーションを設定する際に、このタイプのリンクを参照するために使用されます。たとえば、employee-employer は、Employee オブジェクトタイプと Company オブジェクトタイプの間に定義されたリンクタイプの ID です。
• RID: Foundry 内のすべてのリソースに対して自動生成される一意の識別子です。リンクタイプの RID は、プラットフォーム全体のエラーメッセージで参照されます。
• ステータス： リンクタイプが開発プロセスのどの段階にあるかを、ユーザーやほかのオントロジー作成者に示します。アクティブ、試験的、非推奨のいずれかになります。デフォルトでは、Employee → Employer リンクタイプのステータスは試験的です。ステータスの詳しい説明を参照してください。
• オブジェクトタイプ： リンクタイプの定義を通じて関連付けられるオブジェクトタイプです。たとえば、Employee → Employer リンクタイプは、Employee オブジェクトタイプと Company オブジェクトタイプを参照します。
• カーディナリティ： リンクタイプ内の各オブジェクトタイプに、1個のオブジェクトがあるのか、多数のオブジェクトがあるのかをアプリケーションに示します。たとえば、Employee → Employer リンクタイプでは、多数の従業員が1個の雇用主にリンクされるため、Employee オブジェクトタイプのカーディナリティは多、Company オブジェクトタイプのカーディナリティは一です。直属の部下に複数の上司が存在でき、上司に複数の直属の部下が存在できる場合、Direct Report ↔ Manager リンクタイプ内の Employee オブジェクトタイプのカーディナリティはいずれも多になります。
• キー： リンクの作成に使用されるプロパティまたは列です。
  • カーディナリティが一対一または一対多のリンクタイプでは、一方のオブジェクトタイプのプロパティ（外部キー）が、もう一方のオブジェクトタイプの主キープロパティを参照します。この外部キーと主キーの間の参照によって、オブジェクト間のリンクが定義されます。たとえば、Employee → Employer リンクタイプでは、Employee オブジェクトタイプに、Company オブジェクトタイプの company ID プロパティ（主キー）を参照する employer ID プロパティ（外部キー）が存在する場合があります。
  • カーディナリティが多対多のリンクタイプでは、主キーのペアを含むテーブルによって、2個のオブジェクト間のリンクが定義されます。これらのリンクタイプでは、結合テーブルを指定し、さらにキーをマッピングする必要があります。このマッピングは、結合テーブルのどの列が、リンクタイプ内のどのオブジェクトタイプの主キーを参照するかをアプリケーションに示します。たとえば、Direct Report ↔ Manager リンクタイプの元となる結合テーブルには、employee numbers のペアが含まれる場合があり、各ペアが Direct Report ↔ Manager リンクを表します。
• 表示名： ユーザーアプリケーションでこのタイプのリンクにアクセスするすべてのユーザーに表示される名前です。リンクタイプの各側には表示名があります。リンクタイプの一方の側は、そのオブジェクトタイプへのリンクを表します。たとえば、Employee → Employer リンクタイプでは、Employee オブジェクトタイプの表示名は Employee、Company オブジェクトタイプの表示名は Employer です。
• 複数形の表示名： ユーザーアプリケーションで、多数のオブジェクトタイプにリンクされたこのタイプのリンクにアクセスするすべてのユーザーに表示される名前です。たとえば、Employee → Employer リンクタイプでは、Employee オブジェクトタイプの複数形の表示名は Employees です。一方、従業員ごとに会社は1個しか存在できないため、Company オブジェクトタイプには複数形の表示名がありません。
• API名： コード内でリンクタイプをプログラムから参照する際に使用される名前です。リンクタイプの一方の側のAPI名を使用すると、そのタイプのオブジェクトを返すことができます。たとえば、Employee → Employer リンクタイプの Employee 側のAPI名が employee の場合、Company.employee.get() を呼び出すと、それらの Company オブジェクトにリンクされた Employee オブジェクトが返されます。API名（TSv1）の詳しい説明を参照してください。
• 重要性： リンクタイプの一方の側（その側のオブジェクトタイプへのリンクを指します）をどの程度目立たせて表示するかをユーザーアプリケーションに示します。リンクタイプの一方の側が強調に設定されている場合、アプリケーションはその側をユーザーに最初に表示します。リンクタイプの一方の側が非表示に設定されている場合、その側はユーザーアプリケーションに表示されません。デフォルトでは、リンクタイプの Employee 側と Company 側の重要性は通常です。
• タイプクラス： ユーザーアプリケーションによって解釈される追加のメタデータです。タイプクラスの詳しい説明を参照してください。

オントロジーでのリンクタイプの作成と設定、およびリンクタイプのメタデータの検証要件について、詳しくはこちら。

プロパティ（オブジェクトタイプの特性）について、詳しくはこちら。