ドキュメントの検索
karat

+

K

APIリファレンス ↗
オントロジーオブジェクトおよびリンクタイプオブジェクトタイプオブジェクトタイプの編集
Feedback

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

オブジェクトタイプの編集

警告

オブジェクトタイプとそのプロパティを編集すると、アプリケーションの破壊的な影響がユーザーのワークフローに影響を与える可能性があります。オブジェクトタイプやプロパティの編集を行う前に、以下の破壊的変更の可能性のセクションをお読みください。

破壊的変更の可能性

書き戻し機能のないオブジェクトタイプ

Object Storage V1(Phonograph)がオブジェクトタイプの基となるデータソースの登録解除および再登録を要求する変更は、その再インデックス時間中に、そのタイプのオブジェクトがユーザーアプリケーションで利用できなくなります。これらの変更については以下に説明します。

オブジェクトタイプの基となるデータソースを登録解除および再登録(または削除)する変更は、以下のとおりです。

  • オブジェクトタイプの基となるデータソースを変更する。
  • オブジェクトタイプの主キーを変更する。
  • オブジェクトタイプを削除する。

これらの変更を保存しようとすると、ユーザーアプリケーションへの潜在的な影響について警告されます。

Warning: Reindexing will make objects unavailable

例えば、オブジェクトタイプがWorkshopアプリケーションで使用されている場合、そのWorkshopアプリケーションは、再インデックスが完了するまで壊れてしまいます。オブジェクトタイプの再インデックスの進行状況は、DatasourcesページのPhonographペインで確認できます。

Tracking reindex in Phonograph

Object Storage V1(Phonograph)についての詳細

書き戻し機能のあるオブジェクトタイプ

オブジェクトタイプに書き戻し機能が有効になっている場合は、そのオブジェクトタイプを編集する際には特別な注意が必要です。オブジェクトタイプに対して行われた編集の履歴は、Object Storage V1(Phonograph)に保存されています。書き戻しデータセットをビルドするたびに、編集の履歴が再適用され、書き戻しデータセットの編集済みオブジェクトの最終状態が取得されます。オブジェクトタイプの基となるデータソースがObject Storage V1(Phonograph)から登録解除されると、Object Storage V1(Phonograph)の編集履歴が削除され、書き戻しデータセットの今後のビルドが失敗します。

前のセクションで述べた登録解除が必要な変更に加えて、書き戻し機能のあるオブジェクトタイプでは、いずれかの時点で編集を受けたオブジェクトタイプのすべてのプロパティに対してスキーマ変更が行われた場合にも、登録解除が必要となります。スキーマ変更には、プロパティのIDや基本タイプの変更が含まれます。

以下の変更は、登録解除を必要としないため、編集履歴の消失のリスクはありません。

  • 編集を受けたプロパティの表示名、タイトルキー、レンダリングヒント、タイプクラス、表示可能性を変更しても、オブジェクトタイプの登録解除は必要ありません
  • 編集を受けていないフィールドを削除したり、編集を受けていないフィールドにスキーマ変更を行っても、オブジェクトタイプの登録解除は必要ありません。そのため、編集を受けている他のフィールドに対する編集の消去や元に戻しは発生しません。
警告

Object Storage V1(Phonograph)は、これらのスキーマ変更に対してオブジェクトタイプの基となるデータソースを自動的に登録解除しません。代わりに、再インデックスが失敗し、保存したスキーマ変更が元に戻されるか、オブジェクトタイプのDatasourceページのPhonographペインで、オブジェクトタイプの基となるデータソースを手動で登録解除および再登録することでのみ成功します。

プロパティエディタのプロパティペインでは、フィールドが過去に編集を受けたかどうかがわかります。

Properties pane

さらに、編集履歴を消すリスクのある変更を保存しようとすると、編集に対する潜在的な影響について警告されます。

Warning about impact on edits

これで、既存のオブジェクトタイプやプロパティの編集を行う際の注意点が理解できたので、安全に変更を行うことができます。

既存のオブジェクトタイプを編集する

既存のオブジェクトタイプに移動する

ホームページのサイドバーからオブジェクトタイプページを選択し、リストから別のオブジェクトタイプを選択することで、いつでも作業中のオブジェクトタイプを変更できます。また、アプリケーションヘッダーの検索バーで新しいオブジェクトタイプを検索することもできます。ナビゲーションについての詳細

オブジェクトタイプを削除する

オブジェクトタイプを削除するには、オブジェクトタイプビューサイドバーの右上にある ...(3つのドット)アイコンを選択し、ドロップダウンから削除オプションを選択します。これにより、オブジェクトタイプとその関連するすべてのリンクタイプを削除するためのステージングを確認するダイアログが表示されます。

  • オブジェクトタイプの削除は、変更を保存した後にのみ有効になり、オブジェクトタイプを参照しているビューやアプリケーションが壊れます。
  • activeステータスのオブジェクトタイプは削除できません。ステータスについての詳細
Delete object type

基となるデータソースを変更する

基となるデータソースを変更するには、以下の手順を実行します。

  1. オブジェクトタイプのPropertiesページの上部にあるEdit property mappingを選択して、プロパティエディタに移動します。
  2. Datasourcesペインの上部にある pen Replaceボタンを選択します。これにより、Foundryで利用可能なデータソースを閲覧および選択できます。
警告

オブジェクトタイプの基となるデータソースを変更すると、古いデータソースの列とオブジェクトタイプのプロパティの間の接続が解除されます。プロパティは、古いデータソースと同じスキーマを持つ新しいデータソースに変更した場合にのみ自動的に再マッピングされます。それ以外の場合は、オブジェクトタイプのプロパティを新しいデータソースに再マッピングする必要があります。

Backing datasource

オブジェクトタイプのメタデータを編集する

Edit object type metadata

  1. Icon: デフォルトのアイコンを選択して、このタイプのオブジェクトを表示するユーザーアプリケーションで表示されるオブジェクトタイプのアイコンと色をカスタマイズします。
  2. Display names and description: 既存の表示名や説明を選択してテキストを編集します。
  3. Status: 既存のステータスを選択して、利用可能なステータスのドロップダウンを開きます。deprecatedexperimentalactiveのステータスから選択できます。
  4. Visibility: 既存の表示可能性を選択して、表示可能性のドロップダウンを開きます。prominentなオブジェクトタイプは、アプリケーションがこのオブジェクトタイプをユーザーに最初に表示することになります。hiddenなオブジェクトタイプは、ユーザーアプリケーションに表示されません。
  5. API name: 既存のAPI名を選択して、その値を変更します。
    • activeステータスのオブジェクトタイプのAPI名は変更できません。

オブジェクトタイプのオブジェクトIDは、初期のオブジェクトタイプ作成プロセスの後に編集することはできません。

トラブルシューティング

エラー:Phonograph2:FoundryColumnNameNotFound

Phonograph2:FoundryColumnNameNotFoundというエラーが表示された場合、オブジェクトタイプの保存を試みているデータソースから列が削除され、プロパティがマッピングされていない状態になっています。プロパティは、マッピングするか削除する必要があります。

エラー:Phonograph2:InvalidColumnRemoval

Phonograph2:InvalidColumnRemovalというエラーが表示された場合、編集を受けたプロパティをバックアップしていた列が削除されています。列をデータソースに追加するか、オブジェクトタイプを登録解除して再登録する必要があります。

破壊的変更の可能性のセクションを参照してください。

エラー:Phonograph2:InvalidColumnFieldSchemaChange

Phonograph2:InvalidColumnFieldSchemaChangeというエラーが表示された場合、編集を受けたプロパティのIDまたはキーが変更されています。変更を元に戻すか、オブジェクトタイプを登録解除して再登録する必要があります。

破壊的変更の可能性のセクションを参照してください。

エラー:OntologyMetadata:IncompatibleFoundryFieldSchemaForPropertyType

OntologyMetadata:IncompatibleFoundryFieldSchemaForPropertyTypeというエラーが表示された場合、オブジェクトタイプのプロパティとそのバックアップの列タイプとの間に互換性のない基本タイプを持つプロパティを保存しようとしています。例えば、列Xのタイプが「string」に変更されたが、プロパティXの基本タイプが「integer」でマッピングされている場合です。

エラー:Phonograph2:SchemaMismatch

Phonograph2:SchemaMismatchというエラーが表示された場合、オブジェクトのバックアップになるデータセットのスキーマに意図的な変更を加えたが、オントロジーマネージャーのオブジェクトのプロパティタイプを更新していない可能性があります。オントロジーを編集し、新しいタイプを受け入れるようにプロパティのデータタイプを変更してください。変更を公開し、データセットを再ビルドし、オブジェクトの再インデックスを開始してください。

エラー:FieldTypeIncompatibleWithOntologyPropertyType

FieldTypeIncompatibleWithOntologyPropertyTypeというエラーが表示されたり、「Phonographオブジェクトタイプの更新に失敗しました」というメッセージが表示された場合、オブジェクトをバックアップするデータセットのデータタイプと、オントロジーが期待するデータタイプとの間に不一致があります。スキーマの更新がデータセットとオントロジーの両方に反映されるようにしなければなりません。

オントロジーやデータセットに意図的な変更を加えていない場合は、オブジェクトとそのバックアップデータソースの所有者と連絡を取り合って、最近の変更について理解してください。