階層照会とは何ですか？
階層照会は、検索結果を単なる平坦なリストとして提示するのではなく、複数のレベルに整理します。これにより、モデルコンテンツがどのように構成されているか、および一致する要素が周囲のプロジェクトやダイアグラムとどのように関連しているかを検討することができます。
照会は最大 4 つのレベルをカバーできます：
- プロジェクト：モデルコンテンツを含むリポジトリプロジェクト。
- ダイアグラム：一致する要素が存在するダイアグラム。
- 要素：指定された基準を満たすモデル要素。
- サブ要素：要素内に含まれる、または要素に関連するより詳細なコンポーネント。
上位レベルから開始し、深く移動するにつれて照会を段階的に絞り込むことができます。中間レベルをスキップして、分析に最も関連するレベルから直接開始することも可能です。
なぜ階層照会を使用するのか？
大規模なリポジトリには多くのプロジェクト、ダイアグラム、およびモデル要素が含まれていることがよくあります。従来の検索では一致するアイテムを特定できますが、それらのアイテムがどこに位置しているか、または全体のモデル構造にどのように組み込まれているかについての文脈は限定的です。
階層照会は以下に役立ちます：
- 複数のプロジェクトおよびダイアグラムにわたるモデル要素の位置を特定する。
- 検索結果を取り巻く文脈を理解する。
- 要素の種類と属性に基づいて結果をフィルタリングする。
- ダイアグラム、要素、およびサブ要素間の関係を追跡する。
- アーキテクチャ構造と依存関係をより効率的に探索する。
- さらに処理するための機械可読な結果を生成する。
- 繰り返し分析のために照会を保存して再利用する。
このアプローチは、エンタープライズアーキテクチャモデル、ArchiMate リポジトリ、大規模なシステム設計、およびその他の複雑なモデリング環境を扱う際に特に有用です。
階層照会の開き方
- Visual Paradigm リポジトリにログインします。
- 「三点リーダー」」ボタンをクリックします。
- 「QueryBase.
- アクセスしたいワークスペースを選択してください。
- 企業ダッシュボードに入ります。
- 「ツール」」を右上隅でクリックしてください。
- 「階層によるクエリ」.
「階層によるクエリ」ツールは、インターフェースの右側にクエリ構築ペインを開いて起動します。このペインでは、クエリのレベル、条件、および基準を定義します。
階層クエリの構築方法
階層クエリを構築する際は、まず何を見つけたいか、そしてどのような周辺コンテキストが必要かを決定することから始めます。プロジェクト、ダイアグラム、要素、またはサブ要素から開始し、適切なレベルで条件を追加できます。
1. 開始レベルの選択
検索を開始するレベルを選択してください。プロジェクトレベルから開始するのは、リポジトリ全体の結果を調査したい場合に役立ちます。一方、必要なモデルコンテンツのタイプが既にある場合、要素レベルから開始する方が効率的です。
2. 検索条件の追加
要素タイプ、名前、または属性値などの基準を定義します。クエリが階層を進むにつれて条件を絞り込むことで、広範なリポジトリコンテンツを特定の結果セットに絞り込むことができます。
3. 階層の絞り込み
より多くのコンテキストが必要な場合は、より深いレベルに条件を追加します。例えば、特定の要素タイプを検索し、その後、その要素が現れるプロジェクトやダイアグラムを調査できます。
4. 不要なレベルのスキップ
階層のすべてのレベルを使用する必要はありません。プロジェクトまたはダイアグラムの情報が必要ない場合は、それらのレベルをスキップして、分析に関連する要素またはサブ要素を直接クエリできます。
例：ArchiMate ノード要素の検索
名前に「サーバー」」が含まれる ArchiMate ノード要素を見つけたいとします。クエリを以下のように設定できます：
- ArchiMate ノード要素タイプ。
- 「サーバー」という単語を含む名前条件。
クエリを実行した後、QueryBase は一致するデータを JSON 形式で返します。結果は、条件を満たす ArchiMate ノード要素を特定し、それらがリポジトリ内でどこに位置しているかを示します。
大規模なリポジトリでは、一致するノード要素が複数のプロジェクトやダイアグラムに分散していることが結果から明らかになる場合があります。これは、単なる一致する名前のリストからは明らかにならない、有用なコンテキストを提供します。
結果を階層グラフとして表示
クエリを実行した後、グラフボタンをクリックして、一致する結果を階層構造として表示します。このグラフは、結果がプロジェクト、ダイアグラム、要素、およびサブ要素にわたってどのように整理されているかを示します。
階層グラフは、以下に役立ちます：
- 一致する要素を含むプロジェクトを確認できます。
- それらの要素に関連するダイアグラムを特定できます。
- モデルコンテンツの場所と文脈を理解できます。
- アーキテクチャ構造と依存関係を追跡できます。
- 広範な文脈を失うことなく、複雑なリポジトリをナビゲートできます。
関連するダイアグラムが見つかったら、そのダイアグラムのリンクをクリックして直接開きます。これにより、リポジトリレベルの分析から、基盤となるモデルの視覚的な確認へと移行できます。
クエリ結果を JSON 形式でエクスポート
クエリ結果は、追加処理や他のツールとの統合のために JSON 形式でエクスポートできます。JSON は、返されたデータを操作したり、プログラム的に分析したり、より広範なレポートワークフローに含めたりする必要がある場合に便利です。
エクスポートされた結果は、以下のようなタスクをサポートできます：
- カスタマイズされたレポートの作成。
- 追加のデータ分析の実行。
- モデル情報を外部アプリケーションに統合すること。
- 異なるクエリまたはプロジェクト間の結果を比較すること。
- リポジトリ分析ワークフローの自動化。
クエリ設定の保存と再利用
階層クエリは将来のために保存できます。右上隅のクエリのエクスポートボタンをクリックして、クエリ設定を JSON ファイルとして保存します。
クエリ設定を保存することで、以下が可能になります：
- 後で同じ分析を繰り返すこと。
- 異なるプロジェクト間でクエリを再利用すること。
- チーム全体でリポジトリ検索を標準化すること。
- 他のモデラーやアナリストとクエリロジックを共有すること。
- 反復的な調査に一貫した基準を維持すること。
既存のクエリを再利用するには、以前に保存された JSON ファイルを QueryBase にインポートします。これにより、クエリを手動で再構築する必要がなくなり、モデル分析を一貫性があり、再現可能にすることができます。
階層クエリのベストプラクティス
- 明確な目的から始めましょう：特定の要素を検索しているのか、プロジェクトのカバレッジを確認しているのか、それとも関係を追跡しているのかを判断してください。
- 正確な条件を使用してください：要素タイプ、名前、属性を組み合わせることで、無関係な結果を減らします。
- 適切な開始レベルを選択してください：広範な発見にはプロジェクトまたは図レベルから始め、ターゲットを絞った検索には要素レベルから始めてください。
- 文脈を理解するためにグラフビューを使用してください：リポジトリの構造を理解する必要がある場合は、JSON結果から階層グラフに切り替えてください。
- 関連する図を開く：一致した要素の意味と文脈を検証するために、元の図を確認してください。
- 繰り返し使用可能なクエリを保存する：同じ分析が再度必要になる可能性がある場合、クエリ設定をエクスポートしてください。
- 結果データとクエリロジックを分離して保持する：分析のために結果をエクスポートし、再利用のためにクエリ設定をエクスポートしてください。
よくある質問
Visual Paradigmにおける「階層によるクエリ」とは何ですか？
「階層によるクエリ」は、プロジェクト、図、要素、サブ要素など複数のレベルにわたってリポジトリモデルを検索するQueryBaseの機能です。結果はJSON形式と階層グラフ形式で表示されます。
階層クエリには最大何レベルまで含まれることができますか？
階層クエリは最大4つのレベル（プロジェクト、図、要素、サブ要素）にわたることができます。
クエリを作成する際にレベルをスキップすることはできますか？
はい。中間レベルをスキップするか、検索に最も関連するレベルから直接開始することができます。
QueryBaseは特定のモデル要素タイプを検索できますか？
はい。モデル要素タイプ、名前、および他の利用可能な属性に基づいて条件を定義できます。例えば、特定の単語を含む名前のArchiMateノード要素を検索することができます。
階層クエリの結果はどのように表示されますか？
クエリ結果はJSON形式で返され、階層グラフとしても表示できます。グラフは、一致した要素がプロジェクトおよび図内でどのように整理されているかを示します。
一致した要素を含む図を開くことはできますか？
はい。結果内の図リンクを選択して、関連する図を開き、そのモデリングコンテキスト内で一致した要素を検査してください。
階層クエリを後で使用するために保存することはできますか？
はい。[クエリのエクスポート]機能を使用して、クエリ設定をJSONファイルとして保存できます。後でこのファイルをインポートして、同じクエリを再利用することができます。
要約
Visual Paradigm QueryBase の階層型クエリ機能は、複雑なモデルリポジトリを検索するための実用的な手段を提供します。プロジェクト、ダイアグラム、要素、サブ要素にわたって検索を整理することで、条件に一致するアイテムだけでなく、それらがより広範なモデル構造のどこに位置するかを明らかにします。
JSON 形式の結果、階層型グラフ可視化、ダイアグラムの直接ナビゲーション、再利用可能なクリ構成により、階層によるクエリは、効率的なリポジトリの発見、アーキテクチャ分析、依存関係の追跡、および反復可能なモデル調査をサポートします。
QueryBase については、以下で詳しくご覧ください。https://www.visual-paradigm.com/features/querybase/.
