Centrum wsparcia Workiva

Za pomocą parametrów możesz poprosić o wartości do użycia w filtrach lub obliczeniach zapytania za każdym razem, gdy jest ono uruchamiane. Ustawiając te wartości w czasie wykonywania, możesz użyć zapytania w innym kontekście - takim jak konto, region lub okres czasu - za każdym razem, gdy jest uruchamiane.

Możesz utworzyć niestandardowe parametry do użycia z konkretnym zapytaniem lub właściciel obszaru roboczego może utworzyć parametry globalne do użycia z wieloma zapytaniami.

Utwórz niestandardowe parametry dla zapytania

Możesz ustawić parametry zapytania w Builderze lub Edytorze SQL. Gdy utworzysz parametr, możesz użyć go z wieloma filtrami i obliczeniami w zapytaniu. 

Krok 1. Utwórz parametr

1. W panelu Parametry kliknij Dodaj, a następnie wybierz Utwórz nowy parametr.
   
<!--
2. From the Parameters panel, click Create Parameter.
   
-->
3. Aby ułatwić identyfikację parametru, wprowadź unikalną nazwę zawierającą wyłącznie znaki alfanumeryczne i bez spacji.
4. W sekcji Filter type wybierz typ danych do filtrowania, taki jak Text lub Integer.

Krok 2. Ustaw wartości parametrów

Gdy zapytanie jest uruchamiane, jego parametry mogą akceptować dowolne wartości w oparciu o typ danych lub dostarczać listę określonych wartości do wyboru. 

• Aby zaakceptować dowolną wartość, wprowadź wartość domyślną (jeśli dotyczy) i kliknij Create.
• Aby podać listę określonych wartości:

1. Włącz Picklist.
2. Aby włączyć wiele wartości dla parametru, zaznacz pole wyboru Multi-Select .
3. W polu List Options wprowadź wartości do wyboru, naciskając Enter po każdej z nich.

   Uwaga: W przypadku parametru daty lub znacznika czasu wprowadź każdą opcję w formacie RRRR-MM-dd.

4. Wybierz dowolną wartość domyślną parametru i kliknij Akceptuj.

   Uwaga: W przypadku parametru multi-select wybierz co najmniej jedną wartość domyślną.

5. Kliknij Create, aby zakończyć.

Krok 3. Użyj parametru w zapytaniu

Aby zastosować wartość parametru do zapytania, użyj go w filtrze lub obliczeniach:

• Aby ustawić wartość filtra na podstawie parametru w programie Builder, wybierz go podczas definiowania filtra z prawego panelu Filter Properties.

  Uwaga: W przypadku parametru multi-select, wybierz operator filtra Is In List lub Is Not In List na karcie Filters.

• Aby użyć parametru z filtrem w edytorze SQL lub odwołać się do jego wartości w obliczeniach, wprowadź jego nazwę po dwukropku (:) w instrukcji SQL, na przykład :ReportingPeriod.

Użyj parametrów globalnych w zapytaniu

Twój właściciel obszaru roboczego może skonfigurować parametry globalne dla wspólnych wartości używanych w wielu zapytaniach. Aby użyć parametrów globalnych w zapytaniu:

1. W panelu Parameters kliknij Add, a następnie wybierz Select Global Parameter.
   
2. Wybierz parametry globalne do użycia w zapytaniu i kliknij Dodaj.
3. Aby edytować parametr globalny, wybierz go i zaktualizuj jego nazwę lub wartość zgodnie z potrzebami zapytania.

   Uwaga: Aby zapewnić spójność analizy, właściciel obszaru roboczego może zablokować parametr globalny, aby uniemożliwić edycję jego wartości.

4. Aby zastosować wartość parametru globalnego do zapytania, użyj go w filtrze lub obliczeniach:

   • Aby ustawić wartość filtra na podstawie parametru w programie Builder, wybierz go podczas definiowania filtra z prawego panelu Filter Properties.

     Uwaga: W przypadku parametru multi-select, wybierz operator filtra Is In List lub Is Not In List na karcie Filters.

   • Aby odwołać się do parametru w edytorze SQL, wprowadź jego nazwę po dwukropku (:) w instrukcji SQL, np. :ReportingPeriod.
   • Aby odwołać się do wartości parametru w instrukcji SQL obliczenia, wybierz parametr z menu Parametry.

Edytuj parametr zapytania

Aby dostosować lub zarządzać szczegółami parametru:

1. W panelu Parameters wybierz parametr do edycji.
2. W razie potrzeby edytuj nazwę parametru, typ danych lub wartości.
3. Kliknij Zastosuj.

Usuń parametr zapytania

Jeśli nie potrzebujesz już parametru, możesz usunąć go z zapytania. W panelu Parametry kliknij parametr Usuń , a następnie kliknij Zapisz .