ステータス

オントロジー内のすべてのオブジェクトタイプ、プロパティ、およびリンクタイプには、開発状態を示す ステータス があります。オブジェクトタイプ、プロパティ、またはリンクタイプのステータスは、アクティブ、実験中、または廃止予定のいずれかになります。ステータスのメタデータは、オントロジー編集ユーザーが、どのオブジェクトタイプ、プロパティ、またはリンクタイプがユーザーアプリケーションで積極的に利用されているかを把握するのに役立ちます。これらのステータスは、オブジェクトエクスプローラー、Object Views、および ワークショップ で表示でき、ユーザーアプリケーションで使用することを意図したオブジェクトに関する詳細情報を提供します。

ステータスは次の3つの値のいずれかになります。

• アクティブ: オブジェクトタイプ、プロパティ、またはリンクタイプがユーザー向けアプリケーションで積極的に使用されており、オントロジーマネージャーで大きな破壊的変更が行われないことを示します。
• 実験中: オブジェクトタイプ、プロパティ、またはリンクタイプがまだ開発中であり、実験中のアイテムがユーザー向けアプリケーションで利用できなくなる変更が行われることがあることを示します。
• 廃止予定: オブジェクトタイプ、プロパティ、またはリンクタイプが近いうちに削除される予定であることを示します。廃止予定のアイテムは、ユーザー向けアプリケーションでの使用には依存しないでください。
  • 廃止予定のオブジェクトタイプ、プロパティ、またはリンクタイプには、次のメタデータも含まれます。
    • 廃止予定になっている理由の説明;
    • システムから削除される予定の期限; および
    • 廃止予定のものと置き換えることが意図されているオブジェクトタイプ、プロパティ、またはリンクタイプ。

許可されていない操作

アプリケーションがアクティブなオブジェクトタイプ、プロパティ、およびリンクタイプに依存していることを考慮して、オブジェクトタイプ、プロパティ、またはリンクタイプのステータスが アクティブ の場合、いくつかの破壊的な操作が許可されていません。

• 削除することはできません。オブジェクトタイプ、プロパティ、およびリンクタイプのステータスは、実験中 または 廃止予定 でなければ削除できません。
• アクティブ なオブジェクトタイプの主キーは変更できません。主キーを変更することは、実験中 とマークされたオブジェクトタイプに対してのみ可能です。
• アクティブなオブジェクトタイプ、プロパティ、およびリンクタイプの API 名は変更できません。API 名を変更することは、実験中 とマークされたものに対してのみ可能です。

ステータスピッカーを使用して、ステータスが 廃止予定 のオブジェクトタイプ、プロパティ、またはリンクタイプを再び 実験中 または アクティブ にすることはできません。代わりに、編集履歴ダイアログを使用して、オントロジーリソースを所望のステータスのバージョンに復元する 必要があります。

ステータスの編集

デフォルトでは、新しいオブジェクトタイプ、プロパティ、およびリンクタイプには、実験中 のステータスが与えられます。ステータスを変更するには：

1. 現在のステータスの隣にあるドロップダウンを選択します。
2. 新しいステータスを選択します。

オブジェクトタイプ、プロパティ、またはリンクタイプのステータスを 廃止予定 に変更する場合、次の操作が求められます。

• 廃止予定になっている理由についての説明を入力する
• システムから削除される予定の期限を入力する
• 任意で、廃止予定になっているものと置き換えることが意図されているオブジェクトタイプ、プロパティ、またはリンクタイプを選択する

これらのステータスは、オブジェクトエクスプローラー、Object Views、およびワークショップで表示でき、ユーザーアプリケーションで使用することを意図したオブジェクトに関する詳細情報を提供します。

オントロジーマネージャーは、オブジェクトタイプとその関連するプロパティまたはリンクタイプ間のステータスの整合性を保証します。たとえば、オブジェクトタイプが アクティブ から 実験中 に変更される場合、そのプロパティもすべて 実験中 とマークされます。

以下の表は、異なるステータスのオブジェクトタイプ間のリンクタイプの利用可能なステータスを示しています。一般的には：

• リンクタイプ内の少なくとも1つのオブジェクトタイプが 実験中 に変更された場合、リンクタイプは自動的に 実験中 に変更されます。
• リンクタイプ内の少なくとも1つのオブジェクトタイプが 廃止予定 に変更された場合、リンクタイプは自動的に 廃止予定 に変更されます。

リンクタイプの外部キーにも同じ要件が適用されます。アプリケーションは、プロパティを変更するときにリンクタイプのステータスを変更します。

• 外部キープロパティが 実験中 に変更された場合、そのリンクタイプは 実験中 に変更されます。
• 外部キープロパティが 廃止予定 に変更された場合、そのリンクタイプは 廃止予定 に変更されます。

アプリケーションは、無効な状態を防ぐためにステータスを変更します。外部キープロパティが 実験中 でまだ開発中の場合、そのリンクタイプは アクティブ にマークされず、本番環境での使用に依存するべきではありません。逆に、プロパティを アクティブ にマークすると、アプリケーションは外部キーとしてプロパティを参照するリンクタイプを アクティブ に変更しません。これは、外部キープロパティが本番環境で使用されている場合でも、リンクタイプとそのバッキングデータソースがまだ開発中であることが有効だからです。

ステータスの一括編集

プロパティ

オブジェクトタイプを 実験中 から アクティブ に変更するとき、オブジェクトタイプのすべてのプロパティに アクティブ ステータスを適用するオプションもあります。

オブジェクトタイプのプロパティ間のステータスは、オブジェクトタイプの プロパティ ページからも一括編集できます。プロパティの一括編集について詳しく読む。

オブジェクトタイプ

オブジェクトタイプ間のステータスも、ホームページのオブジェクトビューページから一括編集できます。編集するオブジェクトタイプのチェックボックスを選択し、テーブルの右上にある ステータスの編集 ボタンを選択します。

トラブルシューティング

プロパティステータスとリンクタイプステータスの間の競合

エラー OntologyMetadata:ConflictBetweenLinkTypeStatusAndPropertyTypeStatus が表示された場合、リンクタイプのステータスとプロパティのステータスの間に競合があります。たとえば、外部キーが 廃止予定 の場合、その外部キーを参照するリンクタイプも 廃止予定 である必要があります。

オブジェクトタイプステータスとリンクタイプステータスの間の競合

エラー OntologyMetadata:ConflictBetweenLinkTypeStatusAndObjectTypeStatus が表示された場合、リンクタイプのステータスと、それに関連するオブジェクトタイプのステータスの間に競合があります。これは、上記の表によると無効なオブジェクトタイプ-リンクタイプケースがある場合に発生します。たとえば、実験中 のオブジェクトタイプは、アクティブ のリンクタイプを持つことはできません。