ステータス

オントロジー内のすべてのオブジェクトタイプ、プロパティ、リンクタイプ、アクション、またはインターフェースには、開発状態を示すステータスがあります。オントロジーリソースのステータスは、アクティブ、実験的、非推奨、または例のいずれかです。ステータスメタデータは、ユーザーアプリケーションで積極的に使用されているリソースをオントロジー編集ユーザーが把握するのに役立ちます。これらのステータスは、Object Explorer、Object Views、およびWorkshopで表示され、どのオブジェクトタイプがユーザーアプリケーションで使用されることを意図しているかについての情報を提供します。

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

• アクティブ: リソースがユーザー向けアプリケーションで積極的に使用されており、オントロジーマネージャーで大きな破壊的変更が行われないことを示します。
• 実験的: リソースがまだ開発中であることを示します。実験的アイテムがユーザー向けアプリケーションで利用できなくなる変更が行われる可能性があります。
• 非推奨: リソースが近日中に削除されることを示します。非推奨アイテムはユーザー向けアプリケーションで依存しないようにすべきです。
  • 非推奨リソースには、次のメタデータも含まれます。
    • 非推奨の理由の説明。
    • システムから削除される予定の期限。
    • 非推奨のリソースを置き換えるために意図されたリソース。
• 例: リソースが例としてインストールされていることを示します。例のリソースは概念的なものであり、トレーニングや初期段階の探索的使用にのみ適しています。例は本番ワークフローでの使用を意図していません。

許可されていない操作

アプリケーションがオントロジーリソースに依存しているため、リソースが active ステータスの場合、いくつかの潜在的に破壊的な操作は許可されていません。

• 削除できません。リソースのステータスは experimental または deprecated である必要があります。
• active オブジェクトタイプの主キーを変更することはできません。主キーの変更は experimental とマークされたオブジェクトタイプに対してのみ可能です。
• アクティブなリソースの API 名を変更することはできません。API 名の変更は experimental とマークされたリソースに対してのみ可能です。

deprecated ステータスのリソースは、ステータスピッカーを使用して experimental、active、または example に戻すことはできません。代わりに、Edits History ダイアログを使用して、オントロジーリソースを目的のステータスのバージョンに復元する必要があります。

ステータスを編集する

デフォルトでは、新しいオントロジーリソースには experimental ステータスが与えられます。ステータスを変更するには:

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

リソースを deprecated ステータスに変更する場合、次のことを求められます。

• 非推奨の理由の説明を記入する、
• システムから削除される予定の期限を入力する、
• オプションで、非推奨にするリソースを置き換えることを意図したリソースを選択する。

これらのステータスは Object Explorer、Object Views、および Workshop で表示され、どのオブジェクトタイプがユーザーアプリケーションで使用されることを意図しているかについての情報を提供します。

Ontology Manager は、オブジェクトタイプとその関連プロパティまたはリンクタイプ間のステータスの一貫性を確保します。たとえば、オブジェクトタイプが active から experimental に変更された場合、そのすべてのプロパティも experimental とマークされます。

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

• リンクタイプの少なくとも 1 つのオブジェクトタイプが experimental に変更されると、そのリンクタイプは自動的に experimental に変更されます。
• リンクタイプの少なくとも 1 つのオブジェクトタイプが example に変更されると、そのリンクタイプは自動的に example に変更されます。
• リンクタイプの少なくとも 1 つのオブジェクトタイプが deprecated に変更されると、そのリンクタイプは自動的に deprecated に変更されます。

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

• 外部キーのプロパティが experimental に変更されると、そのリンクタイプは experimental に変更されます。
• 外部キーのプロパティが example に変更されると、そのリンクタイプは example に変更されます。
• 外部キーのプロパティが deprecated に変更されると、そのリンクタイプは deprecated に変更されます。

アプリケーションは、無効な状態を防ぐためにステータスを変更します。外部キーのプロパティが experimental で開発中である場合、そのリンクタイプは active とマークされて本番で使用されるべきではありません。対照的に、プロパティを active とマークする場合、アプリケーションは外部キーとしてプロパティを参照するリンクタイプを active に変更しません。外部キーのプロパティが本番で使用されている一方で、リンクタイプとそのデータソースはまだ開発中であることが有効だからです。

ステータスを一括編集する

プロパティ

オブジェクトタイプを experimental から active に変更する場合、オブジェクトタイプのすべてのプロパティに active ステータスを適用するオプションがあります。

オブジェクトタイプを example に変更すると、そのすべてのプロパティも自動的に example になります。

オブジェクトタイプのプロパティ全体のステータスは、オブジェクトタイプの Properties ページから一括で編集することもできます。プロパティの一括編集についてさらに読む

オブジェクトタイプ

オブジェクトタイプ全体のステータスも、オブジェクトタイプを編集するためにチェックボックスを選択し、テーブルの右上にある Edit status ボタンを選択することで、一括で編集することができます。

トラブルシューティング

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

OntologyMetadata:ConflictBetweenLinkTypeStatusAndPropertyTypeStatus エラーが発生した場合、リンクタイプのステータスとプロパティのステータスの間に競合があります。たとえば、外部キーが deprecated の場合、その外部キーを参照するリンクタイプも deprecated にする必要があります。

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

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