# JsonSet – função de script e gráfico

JsonSet() modifica uma string contendo dados JSON (JavaScript Object Notation). Ele pode definir ou inserir um valor JSON com o novo local especificado pelo caminho. Os dados devem ser JSON válidos, mas podem conter espaços extras ou novas linhas.

Sintaxe:

value JsonSet(json, path, value)

Tipo de dados de retorno: dual

Argumentos

| Argumento | Descrição |
| --- | --- |
| json | String contendo dados JSON. |
| path | O caminho deve ser especificado de acordo com a [RFC 6901](https://datatracker.ietf.org/doc/html/rfc6901). Isso permite o acúmulo de propriedades dentro de dados JSON sem usar funções complexas de substring ou índice e concatenação. |
| value | O novo valor da string em formato JSON. |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/JsonSet.htm)

#### Exemplo: JSON, caminho e valor válidos

| Exemplo | Resultado |
| --- | --- |
| `JsonSet('{}','/a','"b"')` | Retorna '{"a":"b"}' |
| `JsonSet('[]','/0','"x"')` | Retorna '["x"]' |
| `JsonSet('"abc"','','123')` | Retorna 123 |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/JsonSet.htm)

#### Exemplo: JSON, caminho ou valor inválido

| Exemplo | Resultado | Descrição |
| --- | --- | --- |
| `JsonSet('"abc"','/x','123')` | Retorna null | O caminho não aponta para uma parte válida dos dados JSON. |
| `JsonSet('{"a":{"b":"c"}}','a/b','"x"')` | Retorna null | O caminho é inválido. |
| `JsonSet('{"a":"b"}','/a','abc')` | Retorna null | O valor não é um JSON válido. Uma string deve estar entre aspas. |

Consulte também:

* [IsJson – função de script e gráfico](https://help.qlik.com/pt-BR/sense/November2024/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/IsJson.htm)

* [JsonGet – função de script e gráfico](https://help.qlik.com/pt-BR/sense/November2024/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/JsonGet.htm)