Centro de suporte da Workiva

Com o conector JSON, você pode usar os comandos para transformar, buscar e converter dados de Notação de Objeto JavaScript (JSON) como parte de uma cadeia. Por exemplo, com esse conector, você pode:

• Converter uma matriz ou objeto JSON em CSV
• Converter dados CSV em uma matriz JSON
• Analisar texto como JSON com um esquema validado

Observação: Vários comandos de conectores geram uma saída JSON. Para extrair um valor JSON como uma cadeia de caracteres, lista ou JSON para uso com um comando posterior em uma cadeia, use uma transformação de variável.

Pré-requisitos

Para usar o conector JSON, recomendamos que você tenha um conhecimento básico da sintaxe JSON.

O JSON armazena e transmite dados estruturados - de um único número a várias cadeias de caracteres, matrizes e objetos - como texto simples. Uma string JSON contém:

• Uma matriz - ou uma lista de valores
• Um objeto , que contém uma matriz associativa de pares nome/valor

Para dar suporte a estruturas de dados complexas, você pode aninhar matrizes e objetos em seu JSON.

Matrizes

No JSON, as matrizes são cercadas por colchetes [] e contêm uma lista de valores separados por vírgula:

• Números
• Cadeias de caracteres de texto, entre aspas duplas ""
• Booleanos, true ou false
• Matrizes, entre colchetes []
• Objetos, entre colchetes {}
• NULL valores

Por exemplo, uma matriz de recursos Wdata seria [ "Tables", "Queries", "Chains" ].

Objetos

Os objetos são cercados por colchetes {} e contêm uma lista separada por vírgulas de pares de nome/valor. Cada par contém um nome de campo entre aspas duplas "", seguido de dois pontos : e seu valor. Os objetos são compatíveis com os mesmos tipos e sintaxe de valores que as matrizes. Por exemplo:

{
"product": "Wdata",
"company": "Workiva".
"features":[
 "Tables",
 "Queries",
 "Chains"
 ]
}

Configurar o conector JSON

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conector Conexão, selecione JSON e o CloudRunner padrão.
   
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
4. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
5. Para testar a conexão, crie e execute uma cadeia com o comando CSV para JSON do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se o comando Array to CSV do conector não conseguir gerar uma saída válida, verifique esses possíveis problemas.

O comando Array to CSV é bem-sucedido, mas a saída não tem dados

Se o comando Array to CSV indicar uma conversão bem-sucedida, mas sua saída não tiver dados, verifique se a entrada do arquivo de entrada contém matrizes JSON. Por exemplo, esse JSON retornaria e não detalhes sobre bicicletas e bolas:

{
 "store": {
 "bicycle": {
 "color": "red" (vermelho),
 "price" (preço): 19.95
 },
 "ball": {
 "color": "blue" (azul),
 "price" (preço): 21.95
 }
 }
}

Em vez disso, para retornar detalhes sobre bicicletas e bolas, envolva os detalhes com colchetes [], como uma matriz. Por exemplo:

{
 "store": {
 "bicycle": [{
 "color": "red",
 "price": 19.95
 }],
 "ball": [{
 "color": "blue",
 "price": 21.95
 }]
 }
}

Caminho do elemento da matriz raiz não encontrado

Se o erro Array to CSV retornar "Error finding the root array element, please check your path: Path not found", verifique se a chave a ser isolada está em uma matriz. Por exemplo, para capturar usageUnit nesse JSON, insira o JSONPath .pricingInfo[0].pricingExpression.usageUnit como a entrada Path to Root do comando:

{
 "skus": [{
 "skuId": "0033-4F4C-36F1",
 "description": "Long Term Storage (us-east4)",
 "category": {
 "serviceDisplayName": "BigQuery",
 "usageType": "OnDemand"
 },
 "serviceRegions": [
 "us-east4"
 ],
 "pricingInfo": [{
 "summary": "",
 "pricingExpression": {
 "usageUnit": "GiBy.mo",
 "displayQuantity": 1,
 "tieredRates": [{
 "startUsageAmount": 0,
 "unitPrice": {
 "currencyCode": "USD",
 "units": "0"
 }
 }]
 },
 "currencyConversionRate": 1,
 "effectiveTime": "2019-08-18T02:30:55.193Z"
 }],
 "serviceProviderName": "Google"
 }]
}