Dzięki konektorowi JSON możesz używać poleceń do przekształcania, pobierania i konwertowania danych JavaScript Object Notation (JSON) jako części łańcucha. Na przykład, za pomocą tego złącza możesz:
- Konwertuj tablicę lub obiekt JSON na CSV
- Konwertuj dane CSV na tablicę JSON
- Parsuj tekst jako JSON ze zweryfikowanym schematem
Uwaga: Polecenia kilku konektorów generują dane wyjściowe JSON. Aby wyodrębnić wartość JSON jako ciąg znaków, listę lub JSON do użycia z poleceniem w dalszej części łańcucha, użyj transformacji zmiennej.
Wymagania wstępne
Aby korzystać z konektora JSON, zalecamy podstawową znajomość składni JSON.
JSON przechowuje i przesyła ustrukturyzowane dane - od pojedynczej liczby do wielu ciągów, tablic i obiektów - jako zwykły tekst. Ciąg JSON zawiera albo:
- Tablica - lub lista wartości
- Obiekt , który zawiera tablicę asocjacyjną par nazwa/wartość
Aby obsługiwać złożone struktury danych, możesz zagnieżdżać tablice i obiekty w swoim JSON.
Tablice
W JSON tablice są otoczone nawiasami kwadratowymi [] i zawierają listę wartości oddzielonych przecinkami:
- Liczby
- Ciągi tekstowe otoczone podwójnymi cudzysłowami
"" - Booleans,
truelubfalse - Tablice otoczone nawiasami kwadratowymi
[] - Obiekty otoczone nawiasami klamrowymi
{} -
Wartości NULL
Na przykład tablica funkcji Wdata miałaby postać ["Tables", "Queries", "Chains" ].
Obiekty
Obiekty są otoczone nawiasami klamrowymi {} i zawierają oddzieloną przecinkami listę par nazwa/wartość. Każda para zawiera nazwę pola w podwójnych cudzysłowach "", po której następuje dwukropek : i jego wartość. Obiekty obsługują te same typy i składnię wartości co tablice. Na przykład:
{
"product": "Wdata",
"company": "Workiva".
"features":[
"Tables",
"Queries",
"Chains"
]
} Skonfiguruj konektor JSON
Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.
- Na stronie Chain Builder kliknij Connections, a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz JSON i domyślny CloudRunner.
- W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
- Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
- Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem CSV to JSON konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.
Rozwiązywanie problemów
Jeśli polecenie konektora Array to CSV nie generuje prawidłowych danych wyjściowych, sprawdź te potencjalne problemy.
Array to CSV powiodło się, ale dane wyjściowe nie zawierają danych
Jeśli polecenie Array to CSV wskazuje pomyślną konwersję, ale jego dane wyjściowe nie zawierają danych, upewnij się, że plik wejściowy zawiera tablice JSON. Na przykład, ten JSON zwróciłby nie szczegóły dotyczące rowerów i piłek:
{
"store": {
"rower": {
"kolor": "czerwony",
"cena": 19.95
},
"piłka": {
"kolor": "niebieski",
"cena": 21.95
}
}
} Zamiast tego, aby zwrócić szczegóły dotyczące rowerów i piłek, owiń je nawiasami kwadratowymi [], jak tablicę. Na przykład:
{
"store": {
"rower": [{
"color": "red",
"price": 19.95
}],
"ball": [{
"kolor": "niebieski",
"cena": 21.95
}]
}
} Nie znaleziono ścieżki elementu głównego tablicy
Jeśli błąd Array to CSV zwraca "Error finding the root array element, please check your path: Nie znaleziono ścieżki", sprawdź, czy klucz do wyizolowania znajduje się w tablicy. Na przykład, aby przechwycić usageUnit w tym pliku JSON, wprowadź JSONPath .pricingInfo[0].pricingExpression.usageUnit jako dane wejściowe polecenia Path to Root:
{
"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"
}]
}