---
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


---

# SPScriptedFacetService - com escopo

# SPScriptedFacetService - 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

Gera um objeto de aspectos de múltipla escolha ou de escolha única para uma origem de pesquisa avançada.

A API SPScriptedFacetService só pode ser usada em um script de geração de aspecto em uma origem de pesquisa Portal de serviços. O script de geração de aspecto só fica visível quando É origem com script estiver selecionado.

Não há nenhum construtor para esta classe. Em vez disso, use os métodos createFacet() ou createMultiChoiceFacet() para gerar um objeto de aspectos.

## SPScriptedFacetService - createFacet (rótulo de cadeia de caracteres, ID de cadeia de caracteres) {#ariaid-title2}

Cria um único objeto de aspectos de escolha.
Depois de criar o objeto de aspectos, adicione itens de aspecto ou consultas mapeadas ao aspecto usando o método addFacetItem() da classe SPScriptedFacet.
{#SPSFServiceScoped-createFacet_S_S__table_apb_rfv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| rótulo | Cadeia de caracteres | Rótulo para o aspecto. |
| ID | Cadeia de caracteres | ID do aspecto. |
[Tabela 1. Parâmetros]

{#SPSFServiceScoped-createFacet_S_S__table_apb_rfv_5cb} {#SPSFServiceScoped-createFacet_S_S__table_bpb_rfv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto de aspectos de escolha única. Retorna um erro quando: * Foi encontrado um rótulo ou ID duplicado. * Um rótulo ou ID não está definido. {#SPSFServiceScoped-createFacet_S_S__ul_obk_vvw_xcb} |
[Tabela 2. Retorna]

{#SPSFServiceScoped-createFacet_S_S__table_bpb_rfv_5cb}  
Só pode ser usado em um script de geração de aspecto em uma origem de pesquisa avançada do Portal de serviços.

    var stateFacet = facetService.createFacet("State", "state");

## SPScriptedFacetService - createMultiChoiceFacet (rótulo de cadeia de caracteres, ID de cadeia de caracteres) {#ariaid-title3}

Cria um objeto de aspectos de múltipla escolha.
Depois de criar o objeto de aspectos, adicione itens de aspecto ou consultas mapeadas ao aspecto usando o método addFacetItem() da classe SPScriptedFacet.
{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_apb_rfv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| rótulo | Cadeia de caracteres | Rótulo para o aspecto. |
| ID | Cadeia de caracteres | ID do aspecto. |
[Tabela 3. Parâmetros]

{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_apb_rfv_5cb} {#SPSFServiceScoped-createMultiSelectFacet_S_S__table_bpb_rfv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto de aspectos de múltipla escolha. Retorna um erro quando: * Foi encontrado um rótulo ou ID duplicado. * Um rótulo ou ID não está definido. {#SPSFServiceScoped-createMultiSelectFacet_S_S__ul_obk_vvw_xcb} |
[Tabela 4. Retorna]

{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_bpb_rfv_5cb}  

    function createMultiChoiceFacetFromKB(label, variable, values, orderBy){
      if(!values || values.length == 0)
        return;

      var kbFacet = facetService.createMultiChoiceFacet(label, variable);
      var kbMap = {};
      for(var i in values) {
        var key = values[i].label;
        var value = values[i].id;
        var parent = new KBParentData().getParentCategory(value, key);
        key = parent.join(' > ');
        kbMap[key] = value;
      }

      var labels = Object.keys(kbMap).sort();
      for (i = 0; i < labels.length; i++) {
        var currentLabel = labels[i];
        kbFacet.addFacetItem(currentLabel, kbMap[currentLabel]);
        //adds facet search options for each kbMap entry
      }
    }