---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Criação de uma consulta do Mapeamento de serviços usando o Construtor de consulta do CMDB

# Criação de uma consulta do Mapeamento de serviços usando o Construtor de consulta do CMDB {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

O tipo de consulta do Mapeamento de serviços é um padrão que consiste em classes e relacionamentos entre essas classes. Depois de criar o padrão e executar a consulta, a consulta retorna todos os serviços do Mapeamento de serviços que contêm esse padrão.

## Antes de Iniciar

Função necessária: cmdb_query_builder_read para exibir e executar somente consultas salvas, e cmdb_query_builder (contida para itil, itil_admin e asset) para criar e salvar consultas, modificar consultas salvas e executar consultas.

Usuários autorizados podem atualizar e [excluir](https://servicenow-prod.fluidtopics.net/rYrW4sqIqUFUCfemEIoeiQ "Exclua uma consulta do CMDB que não seja mais usada ou necessária.") uma consulta criada por outro usuário.

## Por Que e Quando Desempenhar Esta Tarefa

Para criar a consulta, arraste as classes de IC que você deseja incluir na consulta, solte-as como nó na tela e defina as propriedades de relacionamento entre elas. Em cada nó classe da consulta, você pode filtrar seus atributos para restringir os resultados a um conjunto específico de ICs dessa classe ou a um único IC específico. Você também pode selecionar quais colunas de propriedade devem ser exibidas nos resultados da consulta.

Ao avançar na criação de uma consulta, as opções de lista e outros elementos da interface do usuário do Construtor de consulta do CMDB são filtrados de forma dinâmica, conforme apropriado para as suas seleções.

Consulte [Consultas de exemplo](https://servicenow-prod.fluidtopics.net/V8jJGFe8207gImM2gbTlUg "Use as consultas de exemplo como modelos para criar suas consultas personalizadas do CMDB e do Mapeamento de serviços.") para obter orientações passo a passo de como criar uma consulta do Mapeamento de serviços no Construtor de consulta do CMDB.

## Procedimento

1. Navegar até TudoConfiguraçãoConstrutor de consulta do CMDB.
2. Na página do Construtor de consulta do CMDB, execute uma destas opções:
   1. Selecione Criar novo.
   2. Insira um Nome.
   3. Selecione Consulta de mapeamento de serviços como o Tipo de consulta.
   4. Selecione Criar.
   5. Selecione um widget de uma consulta salva para continuar criando uma consulta existente. [Como pesquisar uma consulta salva](https://servicenow-prod.fluidtopics.net/t8t9TsI~WgYUJQcWMpLMJg "O Construtor de consulta do CMDB permite que você pesquise uma consulta salva específica usando qualquer combinação de critérios de pesquisa, como o título da consulta, tipo, marcadores personalizados e quem criou ou atualizou a consulta.") primeiro, se necessário.
   6. Aponte para o canto superior direito de um widget de consulta salva.
   7. Selecione o ícone Duplicar consulta para editar uma cópia de uma consulta salva.  
      O nome padrão da nova consulta contém a "cópia" da cadeia de caracteres.
   {#build-service-mapping-query__substeps_ahp_4m3_tw}
3. Na tela, é possível executar qualquer uma destas opções:  
   * Adicionar classes de IC à consulta: selecione classes da lista de hierarquia Classes do CMDB e arraste-as para a tela.
   * Adicionar conexões (relacionamentos) entre dois nós na tela:
     1. No primeiro nó do relacionamento, selecione o pequeno quadrado no centro do lado direito.
     2. No segundo nó do relacionamento, selecione o pequeno quadrado no centro do lado esquerdo para criar a conexão.
     3. Em Propriedades da conexão na barra lateral direita, defina as seguintes configurações (selecione a linha de conexão se necessário):
        * Na seção "Direção do relacionamento", selecione o nó Primário (o nó Secundário se ajustará automaticamente).
        * Na seção Propriedades da consulta de serviço, selecione Localizar ICs relacionados ou Localizar ICs não relacionados para consultar um padrão no qual as duas classes mantenham ou não relacionamentos entre si, respectivamente.

          Por exemplo, `Todos os ICs do Tomcat WAR não conectados a um servidor Windows`.
        {#build-service-mapping-query__ul_dyt_dhp_tw}

     {#build-service-mapping-query__ol_mb1_xld_rw}  
     {#build-service-mapping-query__table_pnh_4jp_tw__entry__2}

     | Notação | Descrição |
     |-|-|
     | Linha tracejada | Um relacionamento em uma consulta do Mapeamento de serviços. |
     [Tabela 1. Notações de IU de relacionamento]

     {#build-service-mapping-query__table_pnh_4jp_tw}
   * Adicionar filtros a um nó classe: aplique filtros para restringir uma classe a um conjunto específico de ICs ou a um único IC específico.  
     1. Aponte para o nó ao qual adicionar um filtro e selecione o ícone Aplicar filtros que aparece acima do nó.
     2. Na seção Filtros, adicione o atributo e as [condições da lista relacionada](https://www.servicenow.com/docs/access?context=create-related-list-query&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).
     3. Feche a seção Filtros.
     {#build-service-mapping-query__ol_s2b_nnd_rw}Por exemplo: adicione um filtro de criticalidade de negócio para consultar os negócios considerados "extremamente críticos".

     Selecione Filtros aplicados na barra lateral direita para exibir todos os filtros de cada nó na tela.
   * Adicionar operadores E/OU à consulta:
     1. Conecte um nó a dois outros nós.
     2. Selecione a caixa E que é exibida na linha de conexão para alternar entre os operadores E e Ou.

     {#build-service-mapping-query__ol_uyd_3vp_rw}

     Por exemplo, C1 é Tomcat WAR, C2 é Servidor Linux e C3 é Servidor Windows. Consulte todos os ICs do Tomcat WAR conectados ao servidor Linux ou a um servidor Windows.
   * Adicionar colunas de propriedade de um nó que deverão ser exibidas nos resultados da consulta:  
     Nota:  
     em um relacionamento, os resultados da consulta são exibidos nas colunas parent, child e type. Não é possível adicionar outras colunas da tabela \[cmdb_rel_ci\].
     1. Selecione Propriedades no painel lateral direito.
     2. Selecione um nó uma ou duas vezes para que a seção "Colunas do relatório" do nó seja exibida na barra lateral direita e selecione Adicionar colunas.
     3. Selecione as propriedades e clique fora da lista de propriedades para fechá-la.
     {#build-service-mapping-query__ol_bhh_3qd_rw}
   * Selecionar colunas e adicionar filtros que serão aplicados ao conjunto de serviços resultante:
     1. Selecione Propriedades na barra lateral direita e selecione um espaço vazio na tela para garantir que nada seja selecionado.
     2. Selecione Adicionar colunas na parte inferior da barra lateral direita e selecione as colunas para adicionar. Selecione um ponto fora da lista de colunas para fechá-la.
     3. Selecione o ícone Aplicar filtros de consulta de mapeamento de serviço na parte superior da tela e adicione filtros.
     {#build-service-mapping-query__ol_lfm_dgh_hx}
   * Inverter toda a consulta e pesquisar todos os serviços do Mapeamento de serviços que não incluem o padrão de consulta: clique em um nó uma ou duas vezes para que as "Propriedades da consulta" sejam exibidas na barra lateral direita. Na seção Metadados, alterne os Serviços que Incluem este padrão para habilitar ou desabilitar a opção.
   * Adicionar um marcador de pesquisa que pode ser usado como critério de pesquisa para consultas salvas:
     1. Selecione o ícone Adicionar marcadores na parte superior da tela.
     2. Selecione Adicionar marcador e, na caixa de diálogo Marcadores de consulta, insira uma ou mais cadeias de caracteres de marcador.
     3. Selecione o ícone Adicionar marcadores novamente para fechar a caixa de diálogo Marcadores de consulta.
     {#build-service-mapping-query__ol_sm5_1pb_4y}
   {#build-service-mapping-query__ul_umc_tjd_rw}
4. Selecione Salvar.  
   Na guia Consultas salvas, aponte para um widget de consulta salva e selecione Informações da consulta para exibir detalhes da consulta, como o tipo de consulta, a data da última atualização e os cronogramas de consulta.
{#build-service-mapping-query__steps_mfz_3z1_hx}

## O que Fazer Depois

* Selecione Executar.

  O painel de resultados da consulte exibe apenas os 100 primeiros resultados da consulta.
  * Selecione Carregar mais resultados para mostrar o próximo conjunto de 100 resultados.
  * Selecione Carregar todos os resultados para mostrar o restante dos resultados da consulta, até o número especificado pela propriedade de sistema [glide.cmdb.query.max_results_limit](https://servicenow-prod.fluidtopics.net/Rf8kIpogVu_0aXXcW9yYeA "Defina valores de propriedade para configurar o processamento de consultas.") (10.000 por padrão).
  {#build-service-mapping-query__ul_gfw_42t_w1b}

  Selecione um IC para abrir o formulário de IC e, no formulário de IC, selecione Abrir no Espaço do CMDB para exibir a integridade do IC no bloco Integridade do IC no Espaço do CMDB. Esta operação requer a função sn_cmdb_user (usuário do CMDB).  
  Nota:  
  Quando uma consulta estiver em execução, aguarde a conclusão ou o tempo limite antes de abrir ou executar outra consulta.
* [Modificar configurações do Construtor de consulta](https://servicenow-prod.fluidtopics.net/Blbx_MgssJGJN~I_PhewRA "Defina as configurações que controlam algumas das funcionalidades do Construtor de consulta do CMDB."): selecione o ícone "Configurações" (![ícone de Configurações]()) para abrir a caixa de diálogo Configurações do Construtor de consulta.
* Copiar e compartilhar a URL de uma consulta salva com usuários que tenham acesso ao Construtor de consulta do CMDB. Colar o URL compartilhado em uma nova janela do navegador da Internet abre diretamente a consulta salva no Construtor de consulta do CMDB.
* [Criação de um relatório no Construtor de consulta do CMDB](https://servicenow-prod.fluidtopics.net/c3hH01JM5fjY9EA60E8Lrg "Use os relatórios do Construtor de consulta do CMDB para mostrar os resultados de uma consulta do CMDB ou de uma consulta do Mapeamento de serviços. Crie um relatório básico ou um relatório dinâmico que é atualizado automaticamente quando os resultados da consulta salva associada mudam.").
* [Crie uma programação](https://servicenow-prod.fluidtopics.net/y8vPgsMgI1517rOfgkaULQ "Programe uma consulta salva do CMDB para ser executada uma vez em um horário agendado ou em uma programação recorrente e para enviar os resultados da consulta por e-mail aos usuários especificados.") para executar a consulta no futuro e enviar os resultados por e-mail às partes interessadas.
* Exportar os resultados da consulta: Exportar resultados visíveis da consulta: selecione o menu contextual "Resultados da consulta" e selecione Exportar. Mesmo se o botão Carregar mais resultados estiver visível, indicando a existência de resultados adicionais da consulta, somente os resultados visíveis serão exportados.

* [Exportar e importar uma consulta do CMDB](https://servicenow-prod.fluidtopics.net/UpsgENtTa82SsZ~QTx6TzQ "Exporte uma definição de consulta salva do CMDB ou do Mapeamento de serviços para um arquivo XML que poderá ser importado e executado posteriormente no Construtor de consulta do CMDB. Esse processo permite transmitir uma consulta salva entre instâncias, por exemplo, de um ambiente de desenvolvimento para um ambiente de produção.") para transmitir uma definição de consulta entre instâncias.
* [Preencha um grupo do CMDB](https://servicenow-prod.fluidtopics.net/BpT_s4DzQ563YR3W7at70w#populate-cmdb-grp-saved-query "Dependendo do tipo de grupo, você pode preencher um grupo do CMDB adicionando manualmente ICs individuais, selecionando consultas salvas do CMDB ou criando consultas codificadas no próprio grupo do CMDB. Os ICs resultantes de cada consulta são adicionados como membros ao grupo.") usando a consulta salva.
* [Excluir consultas do CMDB](https://servicenow-prod.fluidtopics.net/rYrW4sqIqUFUCfemEIoeiQ "Exclua uma consulta do CMDB que não seja mais usada ou necessária.").
{#build-service-mapping-query__ul_jhq_hdx_rw}
**Conceitos relacionados**   

* [Consultas de exemplo](https://servicenow-prod.fluidtopics.net/V8jJGFe8207gImM2gbTlUg "Use as consultas de exemplo como modelos para criar suas consultas personalizadas do CMDB e do Mapeamento de serviços.")