注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
オブジェクトタイプを編集する
オブジェクトタイプとそのプロパティを編集すると、アプリケーションが動作しなくなり、ユーザーのワークフローに支障をきたす可能性があります。オブジェクトタイプやプロパティの編集を進める前に、以下の破壊的変更の可能性に関するセクションをお読みください。
破壊的変更の可能性
ライトバックは、オントロジーのオブジェクトに対するユーザーの編集を、永続的な Foundry データセットに保存する処理です。このデータセットはライトバックデータセットと呼ばれます。Object Storage v1 (Phonograph) では、オブジェクトタイプ、または結合テーブルを持つ多対多のリンクタイプに対して、ライトバックデータセットを設定する必要があります。これは、オブジェクトタイプまたはリンクタイプがユーザーによる編集を受け付けるための前提条件です。Object Storage v2 の実体化データセットとライトバックデータセットの比較について、詳しくはこちらをご覧ください。
ライトバックを使用しないオブジェクトタイプ
Object Storage v1 (Phonograph) でオブジェクトタイプの元データソースの登録解除と再登録が必要になる変更を行うと、再インデックス中、そのタイプのオブジェクトはユーザーアプリケーションで利用できなくなります。これらの変更について、以下で説明します。
以下の変更を保存すると、オブジェクトタイプの元データソースの登録解除と再登録（または削除）が行われます。
- オブジェクトタイプの元データソースの変更。
- オブジェクトタイプの主キーの変更。
- オブジェクトタイプの削除。
これらの変更を保存しようとすると、ユーザーアプリケーションに及ぼす可能性のある影響について警告が表示されます。
たとえば、オブジェクトタイプが Workshop アプリケーションで使用されている場合、再インデックスが完了するまで、その Workshop アプリケーションは正常に動作しなくなります。オブジェクトタイプの再インデックスの進行状況は、データソースページの Phonograph ペインで確認できます。
Object Storage v1 (Phonograph) について詳しくはこちら。
ライトバックを使用するオブジェクトタイプ
オブジェクトタイプでライトバックが有効になっている場合、そのオブジェクトタイプを編集するときには特に慎重に対応する必要があります。オブジェクトタイプに対して行われた編集の履歴は、Object Storage v1 (Phonograph) に保存されます。ライトバックデータセットがビルドされるたびに、編集履歴が再適用され、ライトバックデータセット内の編集済みオブジェクトの最終的な状態が生成されます。オブジェクトタイプの元データソースを Object Storage v1 (Phonograph) から登録解除すると、Object Storage v1 (Phonograph) の編集履歴が削除され、それ以降のライトバックデータセットのビルドに失敗します。
前のセクションで挙げた登録解除が必要な変更に加え、ライトバックを使用するオブジェクトタイプでは、過去に一度でも編集を受け付けたプロパティのスキーマを変更すると、そのプロパティが現在は編集を受け付けていなくても、登録解除が必要になります。これは、そのようなプロパティのいずれにも当てはまります。スキーマの変更には、プロパティの ID とベースタイプの変更が含まれます。
以下の変更では登録解除が不要なため、編集履歴が失われるリスクはありません。
- 編集を受け付けたプロパティの表示名、タイトルキー、レンダリングヒント、タイプクラス、重要性を変更しても、オブジェクトタイプの登録解除は不要です。
- 編集を一度も受け付けていないフィールドを削除したり、そのフィールドのスキーマを変更したりしても、オブジェクトタイプの登録解除は不要です。そのため、編集を受け付けているほかのフィールドの編集が消去されたり、元に戻されたりすることはありません。
Object Storage v1 (Phonograph) は、これらのスキーマ変更に応じてオブジェクトタイプの元データソースを自動的に登録解除することはありません。代わりに、再インデックスに失敗します。再インデックスに成功するには、保存したスキーマ変更を元に戻すか、オブジェクトタイプのデータソースページの Phonograph ペインで、そのオブジェクトタイプの元データソースを手動で登録解除して再登録する必要があります。
プロパティエディターのプロパティペインでは、フィールドが過去に一度でも編集を受け付けたかどうかが強調表示されます。
さらに、編集履歴を消去するリスクのある変更を保存しようとすると、編集に及ぼす可能性のある影響について警告が表示されます。
既存のオブジェクトタイプとプロパティを編集する際の考慮事項を理解したうえで、安全に変更を行えます。
既存のオブジェクトタイプを編集する
既存のオブジェクトタイプに移動する
ホームページのサイドバーからオブジェクトタイプのページを選択し、一覧から別のオブジェクトタイプを選択することで、作業対象のオブジェクトタイプをいつでも変更できます。また、アプリケーションヘッダーの検索バーで新しいオブジェクトタイプをいつでも検索できます。ナビゲーションについて詳しくはこちら。
オブジェクトタイプを削除する
オブジェクトタイプの表示サイドバーの右上にある 
（3点）アイコンを選択し（下の画像を参照）、ドロップダウンから削除を選択すると、オブジェクトタイプを削除できます。オブジェクトタイプとそれに関連するすべてのリンクタイプを削除対象としてステージングするかどうかを確認するダイアログが表示されます。
- オブジェクトタイプの削除は変更を保存した後にのみ反映され、そのオブジェクトタイプを参照するビューやアプリケーションは動作しなくなります。
- ステータスがアクティブのオブジェクトタイプは削除できません。ステータスについて詳しくはこちら。
元データソースを追加または削除する
元データソースなしで作成したオブジェクトタイプに元データソースを追加するには、以下の手順に沿って進めてください。
- オブジェクトタイプのプロパティページの上部にあるプロパティマッピングを編集するを選択して、プロパティエディターに移動します。
- データソースペインで元データソースを追加を選択し、利用可能なデータソースを選びます。
- データソースの列を既存のオブジェクトタイプのプロパティにマッピングします。
- オブジェクトタイプのセキュリティ設定を確認し、変更を保存します。
元データソースを削除するには、同じプロパティエディターに移動し、データソースペインからデータソースを削除します。必要なオブジェクトセキュリティポリシーを設定し、変更を保存します。
元データソースの削除は、オブジェクトタイプがプロジェクトに保存されている場合にのみ利用可能です。これにより、オブジェクトタイプは元データソースから権限を継承する代わりに、プロジェクトベースの権限モデルを使用します。削除したデータソースの列にマッピングされていたすべてのプロパティは編集専用プロパティになるため、その値はデータソースの列ではなく、アクションを通じて入力されます。
元データソースを変更する
次の手順で元データソースを変更できます。
- オブジェクトタイプのプロパティページの上部にあるプロパティマッピングを編集するを選択して、プロパティエディターに移動します。
- データソースペインの上部にある
置換ボタンを選択します。これにより、Foundry で利用可能なデータソースの一覧を見て選択できるようになります。
オブジェクトタイプの元データソースを変更すると、古いデータソースの列とオブジェクトタイプのプロパティの間の接続がすべて削除されます。古いデータソースと同じスキーマを持つ新しいデータソースに変更する場合にのみ、プロパティは自動的に再マッピングされます。それ以外の場合は、オブジェクトタイプのプロパティを新しいデータソースに再マッピングする必要があります。
オブジェクトタイプのメタデータを編集する
- アイコン： デフォルトのアイコンを選択して、ユーザーがこのタイプのオブジェクトを閲覧したときにユーザーアプリケーションに表示される、オブジェクトタイプのアイコンと色をカスタマイズします。
- 表示名と説明： 既存の表示名または説明を選択して、テキストを編集します。
- ステータス： 現在のステータスを選択すると、利用可能なステータスのドロップダウンが開きます。非推奨、試験的、アクティブのステータスから選択します。
- 重要性： 現在の重要性を選択すると、利用可能な重要性のドロップダウンが開きます。重要性が強調のオブジェクトタイプは、アプリケーションでユーザーに最初に表示されます。重要性が非表示のオブジェクトタイプは、ユーザーアプリケーションに表示されません。
- API名： 既存のAPI名を選択して、値を変更します。
- ステータスがアクティブのオブジェクトタイプのAPI名は変更できません。
オブジェクトタイプのオブジェクトIDは、最初のオブジェクトタイプ作成プロセスの後には編集できません。
トラブルシューティング
エラー: Phonograph2:FoundryColumnNameNotFound
エラー Phonograph2:FoundryColumnNameNotFound が表示された場合、保存しようとしているオブジェクトタイプの元データソースから列が削除され、プロパティがマッピングされていない状態になっています。このプロパティをマッピングするか、削除する必要があります。
エラー: Phonograph2:InvalidColumnRemoval
エラー Phonograph2:InvalidColumnRemoval が表示された場合、編集が行われたプロパティの元となっていた列が削除されています。データソースに列を追加し直すか、オブジェクトタイプの登録を解除して再登録する必要があります。
詳しくは、上記の破壊的変更の可能性のセクションを参照してください。
エラー: Phonograph2:InvalidColumnFieldSchemaChange
エラー Phonograph2:InvalidColumnFieldSchemaChange が表示された場合、編集が行われたプロパティの ID またはキーが変更されています。変更を元に戻すか、オブジェクトタイプの登録を解除して再登録する必要があります。
詳しくは、上記の破壊的変更の可能性のセクションを参照してください。
エラー: OntologyMetadata:IncompatibleFoundryFieldSchemaForPropertyType
エラー OntologyMetadata:IncompatibleFoundryFieldSchemaForPropertyType が表示された場合、元となる列のデータ型と互換性のないベースタイプを持つプロパティを保存しようとしています。たとえば、列 X のデータ型が「文字列」に変更されたものの、ベースタイプが「Integer」のプロパティ X にマッピングされている可能性があります。
エラー: Phonograph2:SchemaMismatch
エラー Phonograph2:SchemaMismatch が表示された場合、オブジェクトの元となるスキーマを意図的に変更したものの、Ontology Manager でオブジェクトのプロパティタイプをまだ更新していない可能性があります。新しいデータ型を受け入れるようにプロパティのデータ型を編集して、オントロジーを変更します。変更を公開してデータセットを再ビルドし、オブジェクトの再インデックス化を開始します。
エラー: FieldTypeIncompatibleWithOntologyPropertyType
エラー FieldTypeIncompatibleWithOntologyPropertyType または「Phonograph でオブジェクトタイプを更新できませんでした」というメッセージが表示された場合、オブジェクトの元となるデータセットのデータ型と、オントロジーが想定するデータ型が一致していません。スキーマの更新がデータセットとオントロジーの両方に反映されていることを確認する必要があります。
オントロジーまたはデータセットを意図的に変更した場合は、オブジェクトとその元データソースの所有者に連絡し、最近の変更を把握してください。