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


---

# NameValuePairs - Global

# NameValuePairs - Global {#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 inclusão de script NameValuePairs fornece métodos para converter entre mapas e cadeias de caracteres que representam os pares de nome/valor no mapa.

O formulário de cadeia de caracteres é:\<name\> `=`\<value\> , = \<value, ... onde é um nome de cadeia de caracteres, opcionalmente entre aspas duplas (estilo Microsoft) e é um valor de cadeia de caracteres, também opcionalmente entre aspas duplas.  
A seguir estão todos exemplos de cadeias de caracteres de nome/valor válidas:

* `nome = valor`
* `nome = "Meu valor", nome = valor`
* `"Meu nome = este" = "Meu valor", "Meu valor, o tempo todo", nome = valor`
* `"Meu nome" = "Este" "nome""", nome = valor`
{#c_NameValuePairsAPI__ul_utm_d3r_pt}No terceiro exemplo, os valores entre aspas contêm igual a e vírgulas. No quarto exemplo, o valor cotado contém uma cotação.  
As instâncias têm as seguintes propriedades inicializadas:

* map: a forma de mapa (objeto JavaScript sendo usado como hashmap) dos pares de nome/valor, com aspas no estilo Microsoft removidas
* cadeia de caracteres: a forma de cadeia de caracteres dos pares de nome/valor, com aspas no estilo Microsoft.
{#c_NameValuePairsAPI__ul_etr_l3r_pt}

Use com qualquer script do lado do servidor em que você precise converter pares de nome/valor entre mapas e cadeias de caracteres.

## NameValuePairs - NameValuePairs(cadeia de caracteres stringForm) {#ariaid-title2}

Cria uma instância da classe inicializada com a cadeia de caracteres especificada.
{#r_NVP-NameValuePairs_S__table_ehc_vjr_pt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteresForm | Cadeia de caracteres | Os valores a serem usados ao criar o objeto. |
[Tabela 1. Parâmetros]

{#r_NVP-NameValuePairs_S__table_ehc_vjr_pt}

## NameValuePairs - NameValuePairs(Object mapForm) {#ariaid-title3}

Cria uma instância da classe inicializada com o mapa de hash especificado.
{#r_NVP-NameValuePairs_O__table_atb_kkr_pt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| mapForm | Objeto | O mapa a ser usado ao criar o objeto. |
[Tabela 2. Parâmetros]

{#r_NVP-NameValuePairs_O__table_atb_kkr_pt}

## NameValuePairs -- mapToString() {#ariaid-title4}

Produz `this.string` a partir de `this.map`.
{#r_NVP-mapToString__table_qlm_1lr_pt__entry__3}

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

{#r_NVP-mapToString__table_qlm_1lr_pt} {#r_NVP-mapToString__table_rlm_1lr_pt__entry__2}

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

{#r_NVP-mapToString__table_rlm_1lr_pt}

## NameValuePairs - quotify (valor do objeto) {#ariaid-title5}

Se o valor especificado contiver aspas duplas, iguais a, vírgulas ou espaços, este método colocará o valor entre aspas duplas e duplicará todas as aspas duplas entre aspas.
{#r_NVP-quotify_O__table_ogr_vlr_pt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Objeto | O valor a ser processado |
[Tabela 5. Parâmetros]

{#r_NVP-quotify_O__table_ogr_vlr_pt} {#r_NVP-quotify_O__table_pgr_vlr_pt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor com aspas adicionadas. |
[Tabela 6. Retorna]

{#r_NVP-quotify_O__table_pgr_vlr_pt}

## NameValuePairs -- stringToMap() {#ariaid-title6}

Produz `this.map` a partir de `this.string`.
{#r_NVP-stringToMap__table_xtm_mlr_pt__entry__3}

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

{#r_NVP-stringToMap__table_xtm_mlr_pt} {#r_NVP-stringToMap__table_ytm_mlr_pt__entry__2}

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

{#r_NVP-stringToMap__table_ytm_mlr_pt}