Centrum wsparcia Workiva

Krok 1: Skopiuj istniejące zapytanie

Po pierwsze, potrzebujemy zapytania z parametrem. Utworzymy kopię naszego istniejącego zapytania i dodamy parametr, który pozwoli nam zdecydować, dla którego kraju chcemy zobaczyć całkowitą liczbę pracowników.

• Na stronie głównej Wdata Home znajdź zapytanie CLP Employee Detail Query i otwórz menu
  • Wybierz Kopiuj

• Zaktualizuj nazwę zapytania na CLP Employee Detail by Country Query

• Kliknij Zapisz zapytanie
• Na ekranie edycji zapytania kliknij ikonę Parameters w prawym panelu

• 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 przycisk 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: Utwórz połączenie przychodzące

Aby dowiedzieć się, jak odświeżyć połączenie za pomocą łańcucha, musimy najpierw ustanowić połączenie między zapytaniem Wdata a arkuszem kalkulacyjnym. 

• Przejdź do arkusza kalkulacyjnego CLP Employee Overview
• Dodaj nowy arkusz, klikając przycisk
  • Zmień nazwę na Szczegóły pracowników CLP według kraju
• Dodaj połączenie przychodzące do arkusza Szczegóły pracownika CLP według kraju:
  • Otwórz panel Connections (Połączenia) po prawej stronie, klikając ikonę Connections (Połączenia)
  • Na karcie Połączenia przychodzące wybierz Dodaj połączenie
    • Wybierz Wdata Query
    • Wybierz CLP Employee Detail by Country Query (Szczegóły pracowników CLP według kraju)
    • Ustaw parametr kraju na Australia
    • Kliknij Connect

• W arkuszu kalkulacyjnym CLP Employee Overview dostępne są teraz dwa arkusze z połączeniami przychodzącymi

Krok 3: Edytuj istniejący łańcuch

• Przejdź do aplikacji Chain Builder i znajdź łańcuch CLP | Refresh Connection using ID
• Kliknij przycisk ołówka, aby edytować łańcuch
• Kliknij Ustawienia łańcucha w prawym górnym rogu
  • Zmień nazwę łańcucha: CLP | Odśwież połączenia z parametrem
• Uratuj łańcuch

Krok 4: Dane wejściowe środowiska uruchomieniowego

Do uruchomienia łańcucha używamy polecenia Runtime Inputs. Pozwala nam to określić, które połączenie chcemy odświeżyć w czasie wykonywania łańcucha, a także parametr, dla którego chcemy zaktualizować wartość.

• Edytuj zdarzenie łańcucha wejść w czasie wykonywania, klikając dwukrotnie polecenie
• Kliknij dwukrotnie przycisk Add Input i dodaj następujące wejścia:
  • Wejście 1:
    • Typ: TextField
    • Wyświetlana nazwa: Nazwa parametru
    • Wymagane: Niezaznaczone
  • Wejście 2:
    • Typ: TextField
    • Wyświetlana nazwa: Wartość parametru
    • Wymagane: Niezaznaczone
• Zapisz polecenie

Krok 5: Odśwież połączenie

Aby uwzględnić dodany parametr, musimy zaktualizować polecenie Refresh Connections, aby uwzględnić parametr i wartość, które powinny zostać przesłane do zapytania.

• Edytuj stronę Refresh Connection klikając dwukrotnie na Command
  • Identyfikator połączenia: Nadal używaj zmiennej Connection ID z Runtime Inputs
  • Dodaj parametr
    • Ponieważ nasze parametry są zapisywane w źródle (w zapytaniu), będziemy chcieli wypełnić parametry w źródle. Kliknij przycisk + obok opcji Source Parameters (Parametry źródła)
    • Nazwa parametru: Użyj zmiennej Parameter Name z Runtime Inputs - pozwala to na przekazanie wartości Parameter Name określonej w czasie wykonywania łańcucha do polecenia Refresh Connections
      • Kliknij pole Parameter Name
      • W lewym panelu rozwiń listę rozwijaną Wyzwalacz
      • Rozwiń listę rozwijaną Runtime Inputs
      • Wybierz zmienną Parameter Name
    • Wartość parametru: Użyj zmiennej Parameter Value z Runtime Inputs - pozwala to na przekazanie wartości parametru określonej w czasie wykonywania łańcucha do polecenia Refresh Connections
      • Kliknij pole Parameter Name
      • W lewym panelu rozwiń listę rozwijaną Wyzwalacz
      • Rozwiń listę rozwijaną Runtime Inputs
      • Wybierz zmienną Parameter Value
• Zapisz polecenie

Krok 6: Przetestuj ćwiczenie

Teraz, gdy łańcuch jest gotowy, przetestuj wynik

• Opublikuj Łańcuch
• Kliknij Execute, a następnie wybierz Run With Inputs
• Znajdź identyfikator połączenia
  • Przejdź do arkusza kalkulacyjnego przeglądu pracowników CLP
  • W panelu połączeń znajdź połączenie CLP Employee Detail by Country Query Connection i kliknij strzałkę w górę. Po pojawieniu się listy rozwijanej wybierz View Properties

• Skopiuj identyfikator połączenia - upewnij się, że nie pominąłeś żadnych znaków ani nie dodałeś spacji

• Przejdź z powrotem do narzędzia Chain Builder i wklej identyfikator połączenia do pola Connection ID Runtime Input
• Wypełnij dane wejściowe parametrów
  • Nazwa parametru: nazwa parametru w zapytaniu - w tym ćwiczeniu nazwa parametru to Country
  • Wartość parametru: wartość, według której ma być filtrowane zapytanie - w tym ćwiczeniu będziemy filtrować do Brazylia
    • Uwaga: wybranie innej wartości parametru niż ta, która jest już zapisana w arkuszu kalkulacyjnym, spowoduje nadpisanie arkusza kalkulacyjnego, zobaczymy, że nasze dane zmienią się z Australii na Brazylię.
• Kliknij przycisk Start
• Po zakończeniu tworzenia łańcucha przejdź z powrotem do arkusza kalkulacyjnego i sprawdź, czy połączenie zostało pomyślnie odświeżone!

Udane uruchomienie łańcucha:

Pomyślne odświeżenie połączenia:

Dowiedz się więcej o odświeżaniu połączeń za pomocą łańcuchów, wykonując następną ścieżkę: Odśwież listę połączeń!