Os comandos JSON permitem gerar e analisar os objetos de linguagem de formato JSON. Mais particularmente, o formato JSON faz que seja possível o acesso as bases 4D (dados e estrutura) utilizando um navegador web.

O suporte de objetos estruturados é uma das grandes novidades da linguagem de 4D v14, destinado a facilitar o intercâmbio de dados estruturados. Graças aos comandos do tema "JSON", 4D pode trabalhar diretamente com objetos JSON. Entretanto, 4D também pode trabalhar com objetos "nativos" (cuja estrutura se inspira em JSON), o que permite o intercâmbio com todos os tipos de linguagem. Para mais informação, consulte o capítulo Objetos (Linguagem).

"JSON ou JavaScript Object Notation é um formato de dados baseado em texto, genérico, derivado da notação dos objetos da linguagem ECMAScript." (fonte: Wikipedia). JSON é independente de qualquer outra linguagem, porém utiliza as convenções que são familiares para os programadores que utilizam C++ ou JavaScript, Perl, etc. É um formato que é particularmente adequado para o intercâmbio de dados.

Esta seção resume os princípios de notação implementados em JSON. Para uma descrição completa deste formato, consulte o seguinte site: www.json.org/index.html.

A sintaxe JSON está baseada nos seguintes princípios:

• Os dados consistem em pares de nome/valor,
• Os dados estão separados por vírgulas,
• Os objetos estão definidos por colchetes {},
• Os arrays estão definidos por colchetes [ ].

Os dados JSON se expressam em forma de pares nome/valor (ou chave/valor). Um par nome/valor contém um nome de campo (entre aspas), logo dois pontos, seguido de um valor. Por exemplo:

"Nome":"João" 

Nome="João"

Os seguintes tipos de valores são suportados em JSON:

Os objetos JSON se definem com colchetes e podem conter um número indefinido de pares nome/valor, por exemplo:

{ "nome":"João" , "Sobrenome":"Silva" }

Objetos JSON podem ser armazenadas e gerenciados em  4D por variáveis objeto (_O_C_OBJECT) e campos.

Os arrays JSON se definem com colchetes. Cada array pode conter um número indefinido de objetos:

{
    "employees": [
        { "nome":"João" , "sobrenome":"Silva" },
        { "nome":"Ana" , "sobrenome":"Alves" },
        { "nome":"Pedro" , "sobrenome":"Machado" }
    ]
}

Arrays JSON podem ser armazenados e gerenciados em 4D através de variáveis do tipo coleção (_O_C_COLLECTION).

4D suporta e resolve ponteiros JSON através do comando JSON Resolve pointers. Um ponteiro JSON é uma string que pode ser utilizada para acessar a um campo ou um valor de chave en particular no documento JSON inteiro. Por convenção, uma URI que contenha um ponteiro JSON pode ser encontrado em uma propriedade objeto JSON que deve ser chamada "$ ref".

{
   "$ref":<path>#<json_pointer>
}

Os ponteiros JSON se resolvem chamando o comando JSON Resolve pointers ou automaticamente quando se usa Formulários Dinâmicos .

Para mais informação, consulte a descrição do comando JSON Resolve pointers.

Por padrão, quando se convertem dados 4D desde JSON, é levada em conta a zona horária da máquina na que a conversão é levada a cabo (de conformidade com JavaScript). Por exemplo, em França (GMT+2), a conversão de 23/08/2013! da "2013-08-22T22:00:00Z" e vice versa.

Pode mudar este funcionamento e não ter em conta a zona horária, durante a implementação dos procedimentos de exportação, por exemplo, utilizando o comando SET DATABASE PARAMETER (seletor Dates inside objects). Note que esse seletor também pode influenciar a maneira como as datas são armazenadas em objetos

Nota: A partir de 4D v16 R6, strings de data JSON em formato "AAAA-MM-DD" também podem ser suportados. Para saber mais, veja a opção  "Use date type instead of ISO date format in objects" em Página Compatibilidade.

Para mais informação sobre como converter datas 4D/JSON, consulte .