Powrót do spisu komponentów: Plus Tools

Przykładowa mapa procesu: Confluence Tools 2017-03-09 14-42-11.zip

Przeznaczenie:

Komponent służy do wypełnienia "Tabeli Dynamicznej" (Przy użyciu komponentu Wczytywanie danych do Tabelki z JSON'a)   danymi z bazy danych, pogrupowanych wedle tej listy.

Może także mapować wartości, po których nastąpiło grupowanie.

Krócej:

Komponent grupuje dane i dla wybranej grupy zapisuje wybrane kolumny do tabeli dynamicznej (za pośrednictwem mapowania JSON'a i dodatkowej akcji);

Parametry:

"Alias Bazy danych w dbExplorerze :"

Typ pola STRING. Wyświetlana nazwa bazy danych w parametrach połączeń w  konfiguracji w Edytorze danych (Dostępna zakładka po zainstalowaniu Pluginu dbExplorer), dla której ma się wykonać zapytanie SQL. Dla wewnętrznej jak i zewnętrznej bazy danych wymagane jest skonfigurowanie połączenia w Edytorze danych.

"NameForQuery :"  

Typ pola STRING. Wartość pola z  kolumny "name" z tabeli systemowej "pm_querydatachooser", dla której będą pobierane pola "query" i "parameters" .  reszta pól jest ignorowana.

"Lista parametrów zapytania [Opcjonalnie] :"

Typ pola VARIABLE_ARRAY. Lista zmiennych dla których identyfikator  jest równy wartością z pola "parameters"  z tabeli systemowej "pm_querydatachooser". Przy składaniu zapytania SQL, nazwy parametrów zapytania są zmieniane na wartości odczytane z zmiennych o takim identyfikatorze jak nazwa parametru. Wszystkie parametry muszą mieć swój odpowiednik na  liście. (Poza parametrami DCKEY które są brane z pola Datachoosera). Przy braku parametrów zapytania można te pole zostawić puste.

"Lista zmiennych z tabeli dynamicznej :"

Typ pola VARIABLE_ARRAY. Lista zmiennych tabelarycznych (Zmiennych  podpiętych w tabeli dynamicznej). Odczytywany jest  identyfikator tych zmiennych, potrzebny do stworzenia JSON'a (nazwy pól).

"Lista nazw kolumn z BD które będą mapowane do tabeli dynamicznej :"

Typ pola STRING_ARRAY. Lista nazw kolumn które będą wykorzystywane do zbudowania JSON'a.(wartości pól). Ilość zmiennych z tabeli dynamicznej musi być równa ilości nazw kolumn BD. (nazw pola = wartość pola) .

"Lista nazw kolumn z BD po których będzie grupowanie danych :" 

Typ pola STRING_ARRAY . Lista nazw kolumn dla których ma być robione grupowanie danych (wybrane wartości z pozostałych kolumn( w jednej grupie) zostaną użyte do zbudowania JSON'a ).  Tylko nazwy z tej listy mogą posłużyć do mapowania wartości i wyświetlaniu w dynamicznej liście.

Mapowania:

"json-map"

Kolumn w liście dynamicznej zawierająca JSON'a dla każdego wiersza. Najlepiej zmapować na zmienna typu tekstowego lub pola tekstowego.

Szczegółowy opis działania:

Datachooser pobiera dane z BD za pomocą zapytania z tabeli "pm_querydatachooser".

Następnie wedle listy z parametru:  "Lista nazw kolumn z BD po których będzie grupowanie danych :" następuje grupowanie danych.

Po pogrupowaniu są wybierane kolumny z parametru "Lista nazw kolumn z BD które będą mapowane do tabeli dynamicznej :" i na postawię "Lista zmiennych z tabeli dynamicznej :" budowany jest obiekt JSON, który będzie zmapowany pod nazwa "json-map".

 Żeby dane z  tego JSONa zapisać w tabeli dynamicznej zalecane jest użycie akcji Wczytywanie danych do Tabelki z JSON'a z tej wtyczki.

Przykład:

Przykładowa tabela "koszyk"

Zapytanie w tabeli "pm_querydatachooser"

Konfiguracja Dynamicznej listy "Datachooser z JSON"

Działanie Dynamicznej listy "Datachooser z JSON" w procesie

Wypełnienie tabeli po przekazaniu JSON'a z "JSON maping" (za pomocą ukrytego pola tekstowego)  do akcji Wczytywanie danych do Tabelki z JSON'a