Parametry w zapytaniach Wdata sprawiają, że zapytania są dynamiczne i mogą być używane w różnych okresach sprawozdawczych. W tej połączonej ścieżce edukacyjnej zmodyfikujemy nasze zapytanie, dodając parametr, czyniąc go dynamicznym, a następnie zmodyfikujemy nasz łańcuch, aby uwzględnić parametr. Następnie wyeksportujemy wyniki zapytania do arkusza kalkulacyjnego Workiva.
| Główny biznesowy przypadek użycia | Raportowanie danych przechowywanych w Wdata |
| Podstawowy cel edukacyjny | Wykonywanie zapytania z parametrem z łańcucha |
| Dodatkowe cele edukacyjne | Tworzenie parametru w zapytaniu |
| Wymagania wstępne |
Ukończ CLP | Utwórz zapytanie z polem obliczanym Ukończ CLP | Uruchom zapytanie i wyeksportuj wyniki Zidentyfikuj identyfikator zapytania CLP Employee Detail QueryOpcjonalnie - określ adres URL istniejącego arkusza kalkulacyjnego, do którego mają zostać zapisane wyniki |
| Szablon pomocniczy | CLP | Uruchom zapytanie z parametrem |
Krok 1: Edytuj istniejące zapytanie
Najpierw musimy edytować nasze zapytanie CLP Employee Detail Query, aby dodać parametr. Utworzymy parametr, który pozwoli nam zdecydować, dla którego kraju chcemy zobaczyć całkowitą liczbę pracowników.
- Z poziomu Wdata otwórz zapytanie CLP Employee Detail Query, aby je edytować
- Postępuj zgodnie z instrukcjami CLP | Create a Query with a Calculated Field, aby utworzyć zapytanie
- W prawym panelu kliknij ikonę Parametry
- Kliknij Add Parameters i wybierz Create New Parameter
- Nazwij parametr: Kraj
- Przełącz listę wyboru na
- W polu Opcje listy wymień następujące kraje, każdy kraj w osobnym wierszu:
- Australia
- Brazylia
- Włochy
- Kenia
- Stany Zjednoczone
- Zaktualizuj ustawienia domyślne na Brak
- Kliknij Utwórz
- Aby parametr mógł kontrolować wyniki naszego zapytania, musimy połączyć parametr z kolumną w danych źródłowych za pomocą filtrów. Przejdź do zakładki Filtry w zapytaniu.
- Zlokalizuj kolumnę Country w Danych źródłowych po lewej stronie, a następnie kliknij i przeciągnij ją do obszaru filtrów po lewej stronie
- Kliknij wartość filtra w miejscu, w którym znajduje się napis Empty String (Pusty ciąg), aby wypełnić wartość filtra
- Po prawej stronie pola wartości filtra kliknij przycisk parametrów
- Wybierz kraj
- Kliknij Zastosuj
-
- Masz teraz zapytanie z parametrem kraju, po kliknięciu przycisku Uruchom zapytanie zostaniesz zapytany, który kraj chcesz wyświetlić w wynikach zapytania
- Kliknij Zapisz
Krok 2: Edytuj istniejący łańcuch
- Przejdź do narzędzia Chain Builder i znajdź łańcuch CLP | Uruchom zapytanie i wyeksportuj wyniki
- Kliknij przycisk ołówka, aby edytować łańcuch
- Kliknij Ustawienia łańcucha w prawym górnym rogu
- Zmień nazwę łańcucha: CLP | Uruchom zapytanie z parametrem
- Uratuj łańcuch
Krok 3: Dane wejściowe środowiska uruchomieniowego
Używamy zdarzenia Runtime Inputs Chain, aby uruchomić łańcuch. Dzięki temu możemy poprosić o identyfikator zapytania do wykonania, wartość jego parametru oraz adres URL istniejącego arkusza kalkulacyjnego, do którego mają zostać zapisane wyniki. Pole Spreadsheet URL jest opcjonalne; jeśli pozostanie puste, utworzony zostanie nowy arkusz kalkulacyjny.
- Edytuj zdarzenie łańcucha wejść w czasie wykonywania, klikając dwukrotnie polecenie
- Kliknij przycisk Add Input i dodaj następujące dane wejściowe:
- Typ: TextField
- Wyświetlana nazwa: Wartość parametru zapytania
- Wymagane: Zaznaczone
- Opcjonalnie przeciągnij i upuść to nowe wejście, aby pojawiło się po wejściu Query ID i przed wejściem Spreadsheet URL
- Zapisz polecenie
Krok 4: Uruchom zapytanie
Aby pobrać najnowsze dane, najpierw należy uruchomić zapytanie. Po pomyślnym uruchomieniu zapytania możemy wyeksportować jego wyniki, aby wykorzystać je w raportach lub wysłać do innych systemów zewnętrznych. Do wykonania zapytania Wdata użyjemy polecenia Run Query.
- Kliknij dwukrotnie polecenie Run Query Command, aby je skonfigurować
- Kliknij przycisk ADD w sekcji Parameters
- W polu Name wpisz nazwę parametru zapytania, w tym przypadku nasz parametr nosi nazwę Country
- W polu Type wybierz Query Parameter Type, w tym przypadku nasz typ parametru to Text
- Kliknij pole Value
- W lewym panelu Zmienne kliknij strzałkę w dół, aby rozwinąć Wyzwalacz
- Kliknij strzałkę w dół, aby rozwinąć pozycję Runtime Inputs
- Kliknij na Query Parameter Value
- Zapisz polecenie
Krok 5: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, przetestuj wynik.
- Opublikuj Łańcuch
- Kliknij Execute, a następnie wybierz Run with Inputs
- Dodaj wartości dla danych wejściowych środowiska uruchomieniowego
- Identyfikator zapytania - Identyfikator zapytania CLP Employee Detail w Wdata
- Wartość parametru zapytania - wartość, według której chcesz filtrować zapytanie
- W tym przykładzie filtrujemy dane do Brazylia
- Adres URL arkusza kalkulacyjnego - pełny adres URL arkusza kalkulacyjnego, do którego chcesz wyeksportować wyniki zapytania
- Po pomyślnym zakończeniu łańcucha wyświetl arkusz kalkulacyjny, aby zweryfikować wyniki
- Łańcuch powinien pomyślnie uruchomić zapytanie i wyeksportować wyniki do arkusza kalkulacyjnego
- Możesz sprawdzić, czy dane zostały wyeksportowane do arkusza kalkulacyjnego i poprawnie przefiltrowane, przechodząc do adresu URL arkusza
Aby dowiedzieć się więcej na temat korzystania z łańcuchów w celu usprawnienia centralizacji danych, zapoznaj się z pozostałymi częściami Ścieżki gromadzenia danych!