注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

インターフェース定義を編集する

破壊的変更

インターフェースはAPI名を公開するため、インターフェース定義への変更は下流のアプリケーションを破損させる可能性があり、既存のオブジェクト実装は必ず破損します。新しい必須プロパティ、リンクタイプ制約、またはアクションタイプ制約をインターフェースに追加する場合、そのインターフェースを使用するオブジェクトタイプのすべての実装も、オントロジーの同じ更新で変更する必要があります。また、インターフェース定義とそれを利用する側を同時に更新することを推奨します。

インターフェースの変更と同時に下流のアプリケーションを更新できない場合は、代わりにインターフェースの新しいバージョンを(拡張機能または独立したインターフェースとして)作成し、できるだけ早く新しいインターフェース定義に移行できます。

新しいプロパティを追加する

インターフェース設定のプロパティタブから、新しいプロパティを選択します。インターフェースプロパティの設定サイドパネルが開きます。

インターフェースのプロパティを編集する。

プロパティのメタデータを編集するための利用可能なオプションは4つのタブに分かれており、次の設定にアクセスできます。

  1. 表示名と説明: 既存の表示名または説明を選択して、テキストを編集します。
  2. API名: 既存のAPI名を選択して、値を変更します。
  3. プロパティのベースタイプ: ドロップダウンメニューからプロパティのベースタイプを選択します。プロパティのデータ型によって、そのプロパティの値に対して実行できる操作が制限されます。
    • たとえば、ベースタイプが timestamp のプロパティは、Object Explorer のタイムラインウィジェットに表示できます。
  4. 主キー制約: プロパティを主キーにする必要があるか、主キーにできないかを指定します。

インターフェースのプロパティタイプを変更する場合、このインターフェースを実装するすべてのオブジェクトタイプも更新する必要があります。

  1. タイプクラス: アプリケーションが解釈できる追加のメタデータとしてタイプクラスを適用します。
  2. レンダリングヒント: チェックリストからレンダリングヒントを選択して、プロパティ値の表示方法と Object Storage v1 (Phonograph) でのインデックス化方法を改善します。
  3. 重要性: 既存の重要性を選択すると、利用可能な重要性のドロップダウンメニューが開きます。強調に設定されたプロパティは、アプリケーションでユーザーに最初に表示されます。非表示に設定されたプロパティは、ユーザーのアプリケーションに表示されません。

共通プロパティを追加する

インターフェース設定のプロパティタブから、共通プロパティを追加を選択し、インターフェースに追加する共通プロパティを選択します。

リンクタイプ制約を追加する

リンクタイプの制約タブから、新しいリンクタイプ制約を作成を選択し、必要な制約のメタデータを追加します。

アクションタイプ制約を追加する

アクションタイプの制約タブから、新しいアクションタイプ制約を作成を選択し、必要な制約のメタデータとパラメーター制約を追加します。

プロパティを削除する

プロパティタブから、インターフェースから削除するプロパティの横にある ... を選択します。または、インターフェースプロパティのサイドパネルを開き、右上隅のゴミ箱アイコンを選択します。

インターフェースからプロパティを削除する。

リンクタイプ制約を削除または編集する

リンクタイプ制約タブから、編集する、またはインターフェースから削除するリンクタイプ制約の横にある ... を選択します。

リンクタイプ制約を削除または編集する。

制約を編集する場合、初めてリンクタイプ制約を作成するときと同じように、メタデータを更新できます。

アクションタイプ制約を削除または編集する

アクションタイプの制約タブから、編集する、またはインターフェースから削除するアクションタイプ制約の横にある ... を選択します。

制約を編集する場合、初めてアクションタイプ制約を作成するときと同じように、メタデータとパラメーター設定を更新できます。