#Obliczenia JSON

#Wprowadzenie

W oparciu o różne silniki obliczeń JSON, ten węzeł pozwala na przetwarzanie lub transformację złożonych danych JSON generowanych przez poprzedzające węzły, tak aby mogły być wykorzystane przez kolejne etapy przepływu pracy. Przykładowo, wyniki operacji SQL lub żądań HTTP mogą zostać przekształcone w wymagane wartości i formaty zmiennych, co ułatwi ich dalsze użycie.

#Tworzenie węzła

W interfejsie konfiguracji przepływu pracy, proszę kliknąć przycisk plusa („+”) w procesie, aby dodać węzeł „Obliczenia JSON”:

#Konfiguracja węzła

#Silnik parsowania

Węzeł Obliczenia JSON obsługuje różne składnie dzięki różnym silnikom parsowania. Mogą Państwo wybrać silnik w zależności od swoich preferencji i specyfiki każdego z nich. Obecnie obsługiwane są trzy silniki parsowania:

• JMESPath
• JSONPath Plus
• JSONata

#Źródło danych

Źródłem danych może być wynik poprzedzającego węzła lub obiekt danych w kontekście przepływu pracy. Zazwyczaj jest to obiekt danych bez wbudowanej struktury, na przykład wynik węzła SQL lub węzła żądania HTTP.

#Wyrażenie parsowania

Niestandardowe wyrażenia parsowania, dostosowane do wymagań parsowania i wybranego silnika parsowania.

Od wersji v1.0.0-alpha.15 wyrażenia obsługują zmienne. Zmienne są wstępnie parsowane przed wykonaniem przez konkretny silnik, zastępując je określonymi wartościami tekstowymi zgodnie z regułami szablonów ciągów znaków, a następnie łączone z innymi statycznymi ciągami w wyrażeniu, tworząc ostateczne wyrażenie. Ta funkcja jest bardzo przydatna, gdy trzeba dynamicznie budować wyrażenia, na przykład gdy część zawartości JSON wymaga dynamicznego klucza do parsowania.

#Mapowanie właściwości

Gdy wynikiem obliczeń jest obiekt (lub tablica obiektów), mogą Państwo dalej mapować wymagane właściwości na zmienne podrzędne za pomocą mapowania właściwości, aby mogły być użyte przez kolejne węzły.

#Przykład

Załóżmy, że dane do parsowania pochodzą z poprzedzającego węzła SQL, który służy do pobierania danych, a jego wynikiem jest zestaw danych zamówień:

[
  {
    "id": 1,
    "products": [
      {
        "id": 1,
        "title": "Product 1",
        "price": 100,
        "quantity": 1
      },
      {
        "id": 2,
        "title": "Product 2",
        "price": 120,
        "quantity": 2
      }
    ]
  },
  {
    "id": 2,
    "products": [
      {
        "id": 3,
        "title": "Product 3",
        "price": 130,
        "quantity": 1
      },
      {
        "id": 4,
        "title": "Product 4",
        "price": 140,
        "quantity": 2
      }
    ]
  }
]

Jeśli chcemy sparsować i obliczyć całkowitą cenę dwóch zamówień z danych, a następnie połączyć ją z odpowiadającym ID zamówienia w obiekt, aby zaktualizować całkowitą cenę zamówienia, możemy to skonfigurować w następujący sposób:

1. Proszę wybrać silnik parsowania JSONata;
2. Proszę wybrać wynik węzła SQL jako źródło danych;
3. Proszę użyć wyrażenia JSONata $[0].{"id": id, "total": products.(price * quantity)} do parsowania;
4. Proszę wybrać mapowanie właściwości, aby zmapować id i total na zmienne podrzędne;

Ostateczny wynik parsowania jest następujący:

[
  {
    "id": 1,
    "total": 340
  },
  {
    "id": 2,
    "total": 410
  }
]

Następnie, proszę iterować przez wynikową tablicę zamówień, aby zaktualizować całkowitą cenę zamówień.