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


---

# SPScriptedFacet - com escopo

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

Define itens de aspecto, filtros ou consultas mapeadas para um objeto de aspecto.

Você só pode usar a API SPScriptedFacet 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()](https://servicenow-prod.fluidtopics.net/foEEiIta9YmnXm6konTxUg#SPSFServiceScoped-createFacet_S_S "Cria um único objeto de aspectos de escolha.") ou [createMultiChoiceFacet()](https://servicenow-prod.fluidtopics.net/foEEiIta9YmnXm6konTxUg#SPSFServiceScoped-createMultiSelectFacet_S_S "Cria um objeto de aspectos de múltipla escolha.") da classe [SPScriptedFacetService](https://servicenow-prod.fluidtopics.net/foEEiIta9YmnXm6konTxUg#SPScriptedFacetServiceScopedAPI "Gera um objeto de aspectos de múltipla escolha ou de escolha única para uma origem de pesquisa avançada.") para gerar um objeto de aspectos.

## SPScriptedFacet - addFacetItem(cadeia de caracteres rótulo, objeto valueObj) {#ariaid-title2}

Adiciona itens de aspecto ou consultas mapeadas a um objeto de aspecto.
Antes de adicionar itens de aspecto a um objeto de aspecto, crie o objeto de aspecto usando os métodos createFacet() ou createMultiChoiceFacet() da classe SPScriptedFacetService.
{#SPSFScoped-addFacetItem_S_O__table_jzf_lfv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| rótulo | Cadeia de caracteres | O rótulo de exibição do item de aspecto ou consulta mapeada. |
| valueObj | Objeto | O item de aspecto ou consulta mapeada para o aspecto. Só pode conter os tipos cadeia de caracteres, número, booliano e duplo. |
[Tabela 1. Parâmetros]

{#SPSFScoped-addFacetItem_S_O__table_jzf_lfv_5cb} {#SPSFScoped-addFacetItem_S_O__table_kzf_lfv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#SPSFScoped-addFacetItem_S_O__table_kzf_lfv_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
      }
    }