O que é Consulta Hierárquica?
A consulta hierárquica organiza os resultados da pesquisa no repositório em múltiplos níveis, em vez de apresentá-los como uma lista plana. Isso permite que você examine como o conteúdo do modelo está organizado e como os elementos correspondentes se relacionam com seus projetos e diagramas circundantes.
Uma consulta pode abranger até quatro níveis:
- Projeto:O projeto do repositório que contém o conteúdo do modelo.
- Diagrama:O diagrama onde um elemento correspondente está localizado.
- Elemento:O elemento do modelo que atende aos critérios especificados.
- Subelemento:Um componente mais detalhado contido dentro ou associado a um elemento.
Você pode começar em um nível superior e refinar progressivamente a consulta conforme avança para níveis mais profundos. Níveis intermediários também podem ser pulados, permitindo que você inicie diretamente no nível mais relevante para sua análise.
Por que usar Consulta por Hierarquia?
Repositórios grandes frequentemente contêm muitos projetos, diagramas e elementos de modelo. Uma pesquisa convencional pode identificar itens correspondentes, mas fornecer contexto limitado sobre onde esses itens estão localizados ou como se encaixam na estrutura geral do modelo.
A consulta por hierarquia ajuda você a:
- Localizar elementos de modelo em múltiplos projetos e diagramas.
- Entender o contexto que envolve os resultados da pesquisa.
- Filtrar resultados por tipo de elemento e atributos.
- Rastrear relações entre diagramas, elementos e subelementos.
- Explorar estruturas de arquitetura e dependências de forma mais eficiente.
- Gerar resultados legíveis por máquina para processamento adicional.
- Salvar e reutilizar consultas para análise repetível.
Essa abordagem é especialmente útil ao trabalhar com modelos de arquitetura empresarial, repositórios ArchiMate, grandes projetos de sistemas e outros ambientes de modelagem complexos.
Como Abrir Consulta por Hierarquia
- Faça login no seu repositório Visual Paradigm.
- Clique notrês pontosbotão.
- SelecioneQueryBase.
- Escolha o workspace que deseja acessar.
- Acesse o painel corporativo.
- Clique Ferramentasno canto superior direito.
- Selecione Consulta por Hierarquia.
A ferramenta Consulta por Hierarquia abre com um painel de construção de consulta no lado direito da interface. Este painel é onde você define os níveis, condições e critérios para sua consulta.
Como Construir uma Consulta Hierárquica
Ao construir uma consulta hierárquica, comece decidindo o que deseja localizar e qual contexto circundante você precisa. Você pode iniciar com um projeto, diagrama, elemento ou subelemento e, em seguida, adicionar condições nos níveis apropriados.
1. Selecione o Nível Inicial
Escolha o nível em que sua pesquisa deve começar. Iniciar no nível de projeto é útil quando deseja examinar resultados em todo o repositório. Iniciar no nível de elemento é mais eficiente quando você já sabe o tipo de conteúdo de modelo que precisa encontrar.
2. Adicionar Condições de Pesquisa
Defina critérios como tipo de elemento, nome ou valores de atributo. As condições podem ser refinadas conforme a consulta avança pela hierarquia, ajudando você a restringir o conteúdo amplo do repositório a um conjunto específico de resultados.
3. Refinar a Hierarquia
Adicione condições em níveis mais profundos quando precisar de mais contexto. Por exemplo, você pode pesquisar um tipo específico de elemento e, em seguida, examinar os projetos e diagramos nos quais esses elementos aparecem.
4. Pular Níveis Desnecessários
Você não precisa usar todos os níveis da hierarquia. Se informações de projeto ou diagrama não forem necessárias, você pode pular esses níveis e consultar diretamente os elementos ou subelementos relevantes para sua análise.
Exemplo: Encontrar Elementos de Nó ArchiMate
Suponha que você queira localizar elementos de nó ArchiMate cujos nomes contenham a palavra servidor. Você pode configurar a consulta para pesquisar por:
- Um tipo de elemento de nó ArchiMate.
- Uma condição de nome que contenha a palavra “servidor”.
Após executar a consulta, o QueryBase retorna os dados correspondentes no formato JSON. Os resultados identificam os elementos de nó ArchiMate que satisfazem as condições e mostram onde estão localizados no repositório.
Em um repositório grande, os resultados podem revelar que os elementos de nó correspondentes estão distribuídos por vários projetos e diagramas. Isso fornece um contexto útil que pode não ser evidente a partir de uma simples lista de nomes correspondentes.
Visualizar Resultados como um Gráfico Hierárquico
Após executar uma consulta, selecione o Gráfico botão para exibir os resultados correspondentes como uma estrutura hierárquica. O gráfico mostra como os resultados estão organizados entre projetos, diagramas, elementos e subelementos.
O gráfico hierárquico pode ajudá-lo a:
- Ver quais projetos contêm elementos correspondentes.
- Identificar os diagramas associados a esses elementos.
- Entender a localização e o contexto do conteúdo do modelo.
- Rastrear estruturas de arquitetura e dependências.
- Navegar por repositórios complexos sem perder o contexto geral.
Ao encontrar um diagrama relevante, clique em seu link de diagrama para abri-lo diretamente. Isso permite que você passe da análise em nível de repositório para a inspeção visual do modelo subjacente.
Exportar Resultados da Consulta como JSON
Os resultados da consulta podem ser exportados no formato JSON para processamento adicional ou integração com outras ferramentas. O JSON é útil quando você precisa manipular os dados retornados, analisá-los programaticamente ou incluí-los em um fluxo de trabalho de relatórios mais amplo.
Resultados exportados podem suportar tarefas como:
- Criar relatórios personalizados.
- Realizar análise adicional de dados.
- Integrar informações do modelo em aplicativos externos.
- Comparar resultados entre diferentes consultas ou projetos.
- Automatizar fluxos de trabalho de análise de repositórios.
Salvar e Reutilizar Configurações de Consulta
Consultas hierárquicas podem ser salvas para uso futuro. Clique no Exportar Consulta botão no canto superior direito para salvar a configuração da consulta como um arquivo JSON.
Salvar uma configuração de consulta permite que você:
- Repetir a mesma análise posteriormente.
- Reutilizar uma consulta em diferentes projetos.
- Padronizar pesquisas de repositórios em uma equipe.
- Compartilhar a lógica da consulta com outros modeladores e analistas.
- Manter critérios consistentes para investigações recorrentes.
Para reutilizar uma consulta existente, importe seu arquivo JSON previamente salvo no QueryBase. Isso evita reconstruir a consulta manualmente e ajuda a tornar a análise do modelo mais consistente e repetível.
Melhores Práticas para Consultas Hierárquicas
- Comece com um objetivo claro:Decida se você está procurando um elemento específico, examinando a cobertura do projeto ou rastreando relacionamentos.
- Use condições precisas:Combine tipos de elementos, nomes e atributos para reduzir resultados irrelevantes.
- Escolha o nível inicial correto:Comece no nível do projeto ou do diagrama para uma descoberta ampla, ou inicie no nível do elemento para buscas direcionadas.
- Use a visualização de gráfico para contexto:Troque dos resultados em JSON para o gráfico hierárquico quando precisar entender a estrutura do repositório.
- Abra diagramas relacionados:Inspeione o diagrama original para validar o significado e o contexto de um elemento correspondente.
- Salve consultas repetíveis:Exporte as configurações da consulta quando a mesma análise for necessária novamente.
- Mantenha os dados dos resultados separados da lógica da consulta:Exporte os resultados para análise e exporte as configurações da consulta para reutilização.
Perguntas Frequentes
O que é Consulta por Hierarquia no Visual Paradigm?
Consulta por Hierarquia é um recurso do QueryBase que pesquisa modelos de repositório em vários níveis, incluindo projetos, diagramas, elementos e subelementos. Ele apresenta os resultados nos formatos JSON e gráfico hierárquico.
Quantos níveis uma consulta hierárquica pode conter?
Uma consulta hierárquica pode abranger até quatro níveis: projeto, diagrama, elemento e subelemento.
Posso pular níveis ao criar uma consulta?
Sim. Você pode pular níveis intermediários ou começar diretamente no nível mais relevante para sua pesquisa.
O QueryBase pode pesquisar um tipo específico de elemento de modelo?
Sim. Você pode definir condições com base em tipos de elementos de modelo, nomes e outros atributos disponíveis. Por exemplo, você pode pesquisar elementos de nó ArchiMate cujos nomes contenham uma palavra específica.
Como os resultados da consulta hierárquica são exibidos?
Os resultados da consulta são retornados no formato JSON e também podem ser exibidos como um gráfico hierárquico. O gráfico mostra como os elementos correspondentes estão organizados dentro de projetos e diagramas.
Posso abrir o diagrama que contém um elemento correspondente?
Sim. Selecione o link do diagrama nos resultados para abrir o diagrama relacionado e inspecionar o elemento correspondente em seu contexto de modelagem.
Posso salvar uma consulta hierárquica para uso posterior?
Sim. Use a função Exportar Consulta para salvar a configuração da consulta como um arquivo JSON. Você pode importar o arquivo posteriormente para reutilizar a mesma consulta.
Resumo
A capacidade de consulta hierárquica do Visual Paradigm QueryBase oferece uma maneira prática de explorar repositórios de modelos complexos. Ao organizar pesquisas entre projetos, diagramas, elementos e subelementos, ela revela não apenas quais itens correspondem aos seus critérios, mas também onde esses itens se encaixam dentro da estrutura geral do modelo.
Com resultados em JSON, visualização de grafos hierárquicos, navegação direta em diagramas e configurações de consulta reutilizáveis, o Query by Hierarchy suporta a descoberta eficiente de repositórios, análise de arquitetura, rastreamento de dependências e investigação de modelos repetível.
Saiba mais sobre o QueryBase em https://www.visual-paradigm.com/features/querybase/.
