Portail de support Workiva

Avec le connecteur JSON, vous pouvez utiliser des commandes pour transformer, récupérer et convertir des données JavaScript Object Notation (JSON) dans le cadre d'une chaîne. Par exemple, avec ce connecteur, vous pouvez :

• Convertir un tableau ou un objet JSON en CSV
• Convertir des données CSV en un tableau JSON
• Analyse du texte en JSON avec un schéma validé

Note : Les commandes de plusieurs connecteurs génèrent une sortie JSON. Pour extraire une valeur JSON sous forme de chaîne, de liste ou de JSON afin de l'utiliser avec une commande plus loin dans une chaîne, utilise une transformation de variable.

Conditions préalables

Pour utiliser le connecteur JSON, il est recommandé d'avoir une connaissance de base de la syntaxe JSON.

JSON stocke et transmet des données structurées - d'un simple nombre à plusieurs chaînes, tableaux et objets - sous forme de texte brut. Une chaîne JSON contient soit

• Un tableau - ou une liste de valeurs
• Un objet , qui contient un tableau associatif de paires nom/valeur.

Pour prendre en charge des structures de données complexes, vous pouvez imbriquer des tableaux et des objets dans votre JSON.

Tableaux

En JSON, les tableaux sont entourés de crochets [] et contiennent une liste de valeurs séparées par des virgules :

• Chiffres
• Chaînes de texte, entourées de guillemets ""
• Booléens, vrai ou faux
• Tableaux, entourés de crochets []
• Objets, entourés de parenthèses {}
• NULL valeurs

Par exemple, un tableau de caractéristiques Wdata serait [ "Tables", "Queries", "Chains" ].

Objets

Les objets sont entourés de crochets {} et contiennent une liste de paires nom/valeur séparées par des virgules. Chaque paire contient un nom de champ entre guillemets "", suivi de deux points : et de sa valeur. Les objets prennent en charge les mêmes types et la même syntaxe de valeurs que les tableaux. Par exemple :

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

Configurer le connecteur JSON

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez JSON et le CloudRunner par défaut.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.
4. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
5. Pour tester la connexion, créez et exécutez une chaîne avec la commande CSV to JSON du connecteur et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si la commande Array to CSV du connecteur ne génère pas de sortie valide, vérifiez les points suivants.

Array to CSV réussit, mais sa sortie ne contient pas de données

Si la commande Array to CSV indique une conversion réussie mais que sa sortie ne contient pas de données, assurez-vous que son fichier d'entrée contient des tableaux JSON. Par exemple, ce JSON renverrait no détails sur les bicyclettes et les ballons :

{
 "store" : {
 "bicycle" : {
 "color" : "rouge",
 "prix" : 19.95
 },
 "balle" : {
 "couleur" : "bleu",
 "prix" : 21.95
 }
 }
}

Au lieu de cela, pour obtenir des informations sur les bicyclettes et les ballons, il convient de placer les informations entre crochets [], comme dans un tableau. Par exemple :

{
 "store" : {
 "bicycle" : [{
 "couleur" : "rouge",
 "prix" : 19.95
 }],
 "balle" : [{
 "couleur" : "bleu",
 "prix" : 21.95
 }]
 }
}

Le chemin de l'élément du tableau racine n'a pas été trouvé

Si l'erreur Array to CSV renvoie "Error finding the root array element, please check your path : Path not found", vérifiez que la clé à isoler se trouve dans un tableau. Par exemple, pour capturer usageUnit dans ce JSON, entrez le JSONPath .pricingInfo[0].pricingExpression.usageUnit comme entrée de la commande Path to Root:

{
 "skus" : [{
 "skuId" : "0033-4F4C-36F1",
 "description" : "Stockage à long terme (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"
 }]
}