注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
レイアウト
レイアウトウィジェットは、Object View ページの特定のタブ内でビューをさまざまなコンテナに配置し、レイアウトを整理して構造化するために使用します。
各 Object View では、3つの階層でレイアウトを制御できます。
- タブ。タブを設定するで説明されている機能を備えています。
- タブ内のレイアウトウィジェット（コンテナとも呼ばれます）。Object View をコンテンツのボックスに分けて整理できます。
- すべてのコンテンツウィジェット（可視化、プロパティとリンク、フィルターなど）。これらは Object View の構成要素です。
レイアウトコンテナには、次の種類があります。
- ページの視覚的なデザイン - 横方向配置と縦方向スタックコンテナ。
- タブ内にネストされたコンテンツの階層を追加 - タブ付きコンテナ。
- ユーザーが操作するフィルターに応じてコンテンツを表示または非表示にする - 条件付きコンテナ。
- オブジェクトの値を組み込んだテキストを表示 - Markdown ウィジェット。
横方向配置
このウィジェットでは、コンテナ内のウィジェットを横方向に並べて表示し、Object View のレイアウトを視覚的に整理できます。ほかのウィジェットを格納するためのコンテナであり、それ自体にほかの機能はありません。
設定
横方向配置ウィジェットを追加すると、設定で「項目を追加」をクリックしてウィジェットセレクターを開き、このコンテナ内にさまざまなウィジェットを追加できます。
コンテナ内の各ウィジェットに割り当てる幅を決めるには、2つの選択肢があります。
- 相対 - コンテナ内の各ウィジェットに整数を指定します。ウィジェットは、指定した数値の比率に応じて配置されます。例：3個のウィジェットのサイズが A=1、B=3、C=2 の場合、ウィジェット A は全体の長さの1/6、ウィジェット B は3/6を占めます。
- ピクセル - 各ウィジェットに割り当てるピクセル数を絶対値で指定します。ピクセル数の合計が Object View の上限（約1150ピクセル）を超えると、ウィジェットはページから「はみ出し」ます。
よくある問題と注意事項：
- 横方向配置ウィジェットには必ずタイトルを追加してください。ウィジェットを追加するにはタイトルが必須です。タイトルはウィジェットのヘッダーに表示されます。
縦方向スタックコンテナ
このウィジェットでは、コンテナ内のウィジェットを縦方向に積み重ねて表示し、Object View のレイアウトを視覚的に整理できます。ほかのウィジェットを格納するためのコンテナであり、それ自体に独立した機能はありません。
設定
縦方向スタックコンテナウィジェットを追加すると、設定で「項目を追加」をクリックしてウィジェットセレクターを開き、このコンテナ内にさまざまなウィジェットを追加できます。
よくある問題と注意事項：
- 縦方向スタックコンテナウィジェットには必ずタイトルを追加してください。ウィジェットを追加するにはタイトルが必須です。
- 縦方向スタックコンテナをほかのウィジェットの隣に揃えるには、設定の「書式」タブに移動し、デフォルトの「全幅」ではなく、左寄せまたは右寄せの配置を選択します。
- 設定の「設定」の下にある各タブの横の上下矢印を使って、タブの順序を選択します。ここでは、タブの削除や各タブ内のウィジェットの置き換えもできます。
タブ付きコンテナ
現在のタブ内にタブのコンテナを作成して、Object View にタブの階層をもう1つ追加します。ユーザーはこれらのタブを切り替えて閲覧できます。各タブには1個のウィジェットが含まれます（複数のウィジェットを格納するコンテナを含めることもできます）。
タブ付きコンテナは、ほかのウィジェットを格納するためのコンテナであり、それ自体に独立した機能はありません。
設定
- タブ付きコンテナウィジェットを追加すると、設定で「タブを追加」をクリックしてウィジェットセレクターを開き、このコンテナ内にさまざまなウィジェットのタブを追加できます。
- 各タブの名前は、そのタブにあるウィジェットのタイトルです。タイトルは設定の「書式」の下に表示されます。
- 設定の「設定」の下にある各タブの横の上下矢印を使って、タブの順序を選択します。ここでは、タブの削除や各タブ内のウィジェットの置き換えもできます。
よくある問題と注意事項：
- オントロジーの中心となるオブジェクトでは、このタブの使用が必要になる場合があります。ただし、「タブ内のタブ」によってユーザー体験が複雑になる点に注意してください。
- タブ付きコンテナウィジェットには必ずタイトルを追加してください。ウィジェットを追加するにはタイトルが必須です。タイトルはウィジェットのヘッダーに表示されます。
条件付きコンテナ
条件付きコンテナを使用すると、条件に応じてコンテンツを表示または非表示にできます。この条件は、次の項目に基づいて設定できます。
- ユーザーが Object View に適用するフィルター
- オブジェクトまたはリンクされたオブジェクトのプロパティ値
- 特定のタイプのリンクされたオブジェクトの存在
設定
このウィジェットには、1つまたは複数の条件付きセクションを追加できます。各セクションには、条件と、その条件に応じて条件付きで表示される1つ以上のウィジェットが含まれます。条件付きセクションを設定するには、次の3つのステップに沿って進めます。
ステップ1 – 条件を設定する
最初のステップでは、コンテナの内容を表示または非表示にする条件を定義します。条件には3つの種類があります。
条件1 – フィルター
フィルター条件では、Object View にフィルターが適用されているかどうかに基づいて、コンテナの内容を表示または非表示にします。この条件は、次の3つの方法で設定できます。
- 特定のフィルター – 特定のプロパティにフィルターが適用されている場合にのみ、コンテナの内容が表示されます。このプロパティには、現在表示しているオブジェクトのプロパティ、またはリンクされたオブジェクトのプロパティを使用できます。つまり、この条件を使用するには、条件で定義したものと同じオブジェクトおよびプロパティを絞り込む別のフィルターウィジェットが必要です。
- 例：空港の Object View を設定する際に、キャンセルされたフライトのみを保持するフィルター（Status = “Cancelled”）があるとします。キャンセルされたフライトの詳細を表示する条件付きコンテナは、この特定のフィルターが適用されている場合にのみ表示されるように設定します。
- 注：この種類の条件を機能させるには、「リンクされたオブジェクトを絞り込む」と「フィルタープロパティ」のドロップダウンで、同じオブジェクトタイプを選択する必要があります。
- フィルターなし – 現在のタブ、またはこのタブとクロスフィルターを共有しているタブのいずれにもフィルターが適用されていない場合にのみ、コンテナが表示されます。対象となるフィルターには、日付フィルター、ドロップダウンフィルター、ボタンフィルターなど、任意の種類を使用できます。
- 任意のフィルター – 現在のタブ、またはこのタブとクロスフィルターを共有しているタブにフィルターが1つ以上適用されている場合にのみ、コンテナが表示されます。フィルターなしと同様に、対象となるフィルターには、日付フィルター、ドロップダウンフィルター、ボタンフィルターなど、任意の種類を使用できます。
条件2 – プロパティ
プロパティ条件では、オブジェクトのプロパティ値に基づいて、コンテナのコンテンツを表示または非表示にします。対象のオブジェクトには、現在表示しているオブジェクト、またはリンクされたオブジェクトを使用できます。リンクされたオブジェクトの場合、現在のオブジェクトとの関係は1対1または多対1である必要があります。多対1の場合、現在のオブジェクトは関係の「多」側にある必要があります。
この種類の条件を使用するには、まず使用するプロパティを選択します。次に、そのプロパティに基づいて、条件付きコンテナの内容を表示するタイミングを定義します。これには4つの選択肢があります。
- 定義済み – プロパティの値が
nullではありません。 - 未定義 – プロパティの値が
nullです。 - 次の 1 つである： – プロパティの値が、定義した値のいずれかと一致します。
- 以下のいずれかではありません： – プロパティの値が、定義した値のいずれとも一致しません。
次の 1 つである： および以下のいずれかではありません： では、定義した値がプロパティタイプに合わせて変換されます（Integer、Double、日付、ブール値の場合）。このプロパティの比較方法の詳細については、以下を参照してください。
条件3 – リンクされたオブジェクト
リンクされたオブジェクト条件では、特定のタイプのリンクされたオブジェクトが存在するかどうかに基づいて、コンテナの内容を表示または非表示にします。この条件を設定するには、まずリンクパスを選択します。次に、選択したパスのリンクされたオブジェクトが存在する場合に条件付きコンテナの内容を表示するか、存在しない場合に表示するかを決めます。
この条件のロジックは、リンクされたオブジェクトのビューと比較すると理解できます。この条件を設定したコンテナの内容は、同じリンクパスを持つリンクされたオブジェクトのビューにオブジェクトが1個以上表示される場合（リンクされたオブジェクトが存在することを条件とする場合）、またはオブジェクトが表示されない場合（リンクされたオブジェクトが存在しないことを条件とする場合）にのみ表示されます。
ステップ2 – ウィジェットを追加する
条件を定義したら、2つ目のステップとして、コンテナ内に表示する実際のコンテンツを設定します。「セクションを追加」ボタンをクリックし、必要な数のウィジェットを追加します。上下の矢印を使用して、条件付きコンテナ内に表示されるウィジェットの順序を変更できます。
ステップ3 – レイアウトを選択する
最後の3つ目のステップでは、コンテナのレイアウトを選択します。レイアウトには、次のいずれかを選択できます。
- 横並び – 横並び配置コンテナウィジェットと同様に、ウィジェットが左から右に表示されます
- 縦並び – 縦積みコンテナウィジェットと同様に、ウィジェットが上から下に表示されます
この3つのステップを完了すると、条件付きコンテナの設定が完了し、使用できる状態になります。
よくある問題と注意事項：
- プロパティ値はどのように比較されますか？
- 文字列の値は通常どおり照合されます
- 数値型のプロパティの場合、ウィジェット内のすべての入力値が数値に変換され、数値型のプロパティと比較されます（たとえば、文字列 3.1415 を入力すると Double に変換されます）
- ブールプロパティの場合、ウィジェットで「true」、「yes」、「1」を使用すると、これらはすべて true の入力値とみなされ、それ以外はすべて false になります。
- 日付とタイムスタンプの値は、文字列に変換された後に照合されます
- 現在、配列には対応していません
- 条件を複数追加した場合、条件は上から下に評価されます。最初に満たされた条件のセクションが表示され、ほかの条件は無視されます。
- プロパティ値による条件付きコンテナのオプションは、1対1または多対1の関係で機能します。この場合、現在表示しているオブジェクトは関係の関連側（「多」側）にあります。
- 現在のオブジェクトが主要側にある多対多または1対多の条件には_対応しておらず_、リンクされたオブジェクトの値の集計による条件付き表示設定にも_対応していません_。
- 例：航空機オブジェクトを表示している場合、その航空機が所属する航空会社に依存する条件は追加できます（所属する航空会社が1社のみであると仮定します）。ただし、「プロパティ X を持つフライトオブジェクトがリンクされているかどうか」に依存する条件は追加できません。
- このウィジェットは、タブレベルの任意の「表示設定」をウィジェットレベルに拡張したものです。ただし、完全に同等ではありません。
- 「表示設定」では、ユーザーのプロフィールに応じた条件付きタブを定義できます。
- このウィジェットでは、（1）単一のタブ内で条件付きビューを設定でき、（2）適用されたフィルターによる条件付き表示設定のオプション（ユーザーのインタラクションに依存）を使用できますが、（3）ユーザーのプロフィールごとの条件付きビューは含まれていません。
- 適用されたフィルターによって表示または非表示にする条件付きセクションのオプションを有効にするには、右側の設定エディターの「設定」で、「クロスフィルタリング」のチェックボックスを必ずオンにしてください。
- 条件付きコンテナは、ほかのウィジェットを横並びまたは縦並びに配置するためだけのコンテナです。
Markdown
このウィジェットでは、Object View のレイアウトの一部としてリッチテキストを追加できます。Markdown の軽量なリッチテキスト書式構文（markdown-it ライブラリ）に基づくプレーンテキストエディターを提供します。さらに、テキストの一部にオブジェクトのプロパティ値を埋め込むテンプレート機能も利用できます。
設定
- テキストボックスはシンプルなテキストエディターで、標準の
markdown-itライブラリをサポートしています。 - オブジェクトプロパティのテンプレート機能 - 二重波括弧の {{propertyName}} 形式を使用して、Markdown コンテンツに現在のオブジェクトのプロパティ値を埋め込みます。propertyName は、オントロジーのプロパティの正確な名前で、大文字と小文字が区別されます。{{objectId}}、{{objectTypeId}}、{{objectTypeRid}} の値もサポートされています。
追加設定：
- 改行には、2つのオプションがあります。
- 改行を有効にする - オン（デフォルト）の場合、エディター内の1回の改行が実際の改行として反映されます。オフの場合、エディター内の改行は結果に影響しません。見出しの書式は引き続き使用できます。
- "
" を改行に変換する -
- サニタイズされた HTML の表示を有効にする - markdown-it を使用して HTML を安全に表示します。オブジェクトプロパティからの HTML の埋め込みは無効になっています。セキュリティのため、すべてのプロパティ値がエスケープされます。
よくある問題と注意事項：
- 現在、{{propertyName}} 形式で含めた長いテキストや配列は、テキストボックスからはみ出す可能性があり、デフォルトでは表示されません。