---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CatalogSearch - Com escopo

# CatalogSearch - Com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API CatalogSearch fornece métodos que permitem pesquisar itens do catálogo.

Para usar esta classe em uma aplicação com escopo, use o identificador de namespace `sn_sc`. O plug-in API com escopo do Catálogo de serviços (ID: com.glideapp.servicecatalog.scoped.api) habilitado por padrão é necessário para acessar a API CatalogSearch.

## CatalogSearch - CatalogSearch() {#ariaid-title2}

Cria uma instância da classe CatalogSearch.
{#r_CSS-CatalogSearch__table_w4w_r1y_5z__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#r_CSS-CatalogSearch__table_w4w_r1y_5z}  

    var catSearchGR = new sn_sc.CatalogSearch().search('', '', 'Apple', false, true);
    catSearchGR.query();
    while(catSearchGR.next()) {
      gs.info(catSearchGR.getValue('name'));
    }

## CatalogSearch - pesquisa (cadeia de caracteres catalogID, cadeia de caracteres categoryID, termo de cadeia de caracteres, booliano móvel, booliano noDepthSearch) {#ariaid-title3}

Pesquisa um item do catálogo com base em um termo de pesquisa. A pesquisa pode ser restrita a um nível de categoria de catálogo.
{#r_CSS-search_S_S_S_B_B__table_t55_3by_5z__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| catalogID | Cadeia de caracteres | Identificador do catálogo a ser pesquisado. |
| ID da categoria | Cadeia de caracteres | Identificador da categoria do catálogo a ser pesquisada. |
| termo | Cadeia de caracteres | Termo de pesquisa. |
| para celular | Booliano | Sinalizador que indica se os itens do catálogo expostos para dispositivos móveis são pesquisados. Valores válidos: * verdadeiro: pesquisa itens do catálogo móvel. * falso: não pesquisa itens do catálogo móvel. {#r_CSS-search_S_S_S_B_B__ul_ils_fwq_2pb} |
| noDepthSearch | Booliano | Sinalizador que indica se as subcategorias devem ser pesquisadas. Valores válidos: * verdadeiro: não pesquisa subcategorias. * falso: pesquisar subcategorias. {#r_CSS-search_S_S_S_B_B__ul_iqz_3wq_2pb} |
[Tabela 2. Parâmetros]

{#r_CSS-search_S_S_S_B_B__table_t55_3by_5z} {#r_CSS-search_S_S_S_B_B__table_u55_3by_5z__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | Retorna o GlideRecord em sc_cat_item que corresponde ao resultado da pesquisa. |
[Tabela 3. Retorna]

{#r_CSS-search_S_S_S_B_B__table_u55_3by_5z}  
Este exemplo mostra como pesquisar todos os catálogos e todas as categorias para o termo: ServiceNow.

    var now_GR = new sn_sc.CatalogSearch().search('', '', 'ServiceNow', false, false);
    now_GR.query();
    while(now_GR.next()) {
      gs.log(now_GR.name);
    }

Saída:

    ServiceNow T-shirt