---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SPScriptedFacet : inclus dans le champ d'application

# SPScriptedFacet : inclus dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Définit des éléments de facette, des filtres ou des requêtes mappées pour un objet à facettes.

Vous ne pouvez utiliser l'API SPScriptedFacet que dans un script de génération de facettes dans une source de Portail de services recherche. Le script de génération de facette n'est visible que lorsque la source est scriptée est sélectionnée.

Il n'existe aucun constructeur pour cette classe. Utilisez plutôt les méthodes [createFacet()](https://servicenow-prod.fluidtopics.net/Zr2Tn4HF2UXWwWtrCjhAaA#SPSFServiceScoped-createFacet_S_S "Crée un objet de facettes de choix unique.") ou [createMultiChoiceFacet()](https://servicenow-prod.fluidtopics.net/Zr2Tn4HF2UXWwWtrCjhAaA#SPSFServiceScoped-createMultiSelectFacet_S_S "Crée un objet de facettes à choix multiples.") de la classe [SPScriptedFacetService](https://servicenow-prod.fluidtopics.net/Zr2Tn4HF2UXWwWtrCjhAaA#SPScriptedFacetServiceScopedAPI "Génère un objet de facettes à choix multiple ou à choix unique pour une source de recherche avancée.") pour générer un objet facets.

## SPScriptedFacet : addFacetItem(String, étiquette, objet, valueObj) {#ariaid-title2}

Ajoute des éléments de facette ou des requêtes mappées à un objet de facettes.
Avant d'ajouter des éléments de facette à un objet facettes, créez l'objet facettes à l'aide des méthodes createFacet() ou createMultiChoiceFacet() de la classe SPScriptedFacetService .
{#SPSFScoped-addFacetItem_S_O__table_jzf_lfv_5cb__entry__3}

| Nom | Type | Description |
|-|-|-|
| étiquette | Chaîne | Étiquette d'affichage de l'élément de facette ou de la requête mappée. |
| valueObj | Objet | L'élément de facette ou la requête mappée pour la facette. Ne peut contenir que les types chaîne, nombre, booléen et double. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

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