W Kreatorze BI możesz używać filtrów opartych na parametrach, takich jak przepływy zadań i szablony workflow. Filtry te pomagają analizować dane w odpowiednim kontekście, na przykład koncentrując się na konkretnym przepływie lub indywidualnym szablonie workflow.
Filtry współpracują z parametrami raportu i automatycznie dostosowują dane w zależności od miejsca, z którego raport jest otwierany. Na przykład, jeśli raport zostanie otwarty z przepływu „Dział Prawny”, filtr natychmiast się zastosuje i wyświetli zadania tylko dla tego zespołu.
W artykule:
Skonfiguruj parametry raportu w Bitrix24
Przed dodaniem filtrów musisz skonfigurować parametry. Parametry te tworzą połączenie między raportem a danymi. Na przykład parametr tasks_flows_flow_id przekazuje identyfikator przepływu zadań, a bworkflow_template_id przekazuje identyfikator szablonu workflow. Parametry te można ustawić zarówno dla nowych, jak i istniejących raportów:
- Przejdź do sekcji Kreator BI.
- Aby utworzyć raport, kliknij Nowy raport.
- Aby edytować istniejący raport, otwórz Menu (≡) > Ustawienia.
Podczas tworzenia raportu określ jego nazwę, dodaj go do grup, w których będzie wyświetlany, i ustaw wymagane parametry.
Po dodaniu parametru możesz wybrać, czy raport ma być wyświetlany w odpowiedniej sekcji. Na przykład, jeśli użyjesz parametru identyfikatora przepływu, raport będzie dostępny po kliknięciu statusu przepływu. Jeśli dodasz identyfikator szablonu workflow, raport pojawi się w formularzu protokołu workflow.
Po określeniu parametrów należy je dodać do zestawu danych. Wykresy w raporcie są budowane na podstawie zestawu danych, więc parametry muszą być uwzględnione w zapytaniu. Jeśli parametry nie zostaną dodane, nie będą działać. Otwórz sekcję Identyfikatory parametrów i zapisz kody wymaganych zmiennych, aby użyć ich w zestawie danych.
Utwórz lub zaktualizuj zestaw danych
Jeśli tworzysz nowy raport, możesz określić parametry bezpośrednio w zapytaniu SQL.
- Kliknij zakładkę SQL > SQL Lab.
- Wybierz schemat bitrix24.
- Wprowadź zapytanie SQL i kliknij Run. Dodaj szablon Jinja do zapytania, aby upewnić się, że raport poprawnie stosuje wartość filtra. Na przykład, jeśli raport jest otwierany z protokołu workflow, Jinja zastąpi jego identyfikator, a raport wyświetli dane tylko dla tego procesu. Jeśli raport jest otwierany osobno, filtr nie otrzyma identyfikatora i wyświetli wszystkie dane.
Jak korzystać z szablonów Jinja w Kreatorze BI
Jeśli tworzysz zestaw danych po raz pierwszy, zapoznaj się z przykładowym zapytaniem.
Przykład zapytania SQL dla raportów przepływu zadań
To zapytanie SQL służy do wyodrębniania danych z zestawu danych przepływu zadań. Możesz je skopiować i zobaczyć, jak działa selekcja. Zapytanie wyświetla główne pola przepływu i obsługuje filtrowanie według parametru tasks_flows_flow_id.
SELECT f.id AS "Flow ID", f.name AS "Flow Name", f.creator_name AS "Flow Creator Name", f.planned_completion_time AS "Task Completion Time", f.tasks_ids AS "Tasks in Flow" FROM flow f WHERE 1=1 {% if url_param('tasks_flows_flow_id') is not none %} AND f.id = {{ url_param('tasks_flows_flow_id') }} {% endif %}
SELECT określa informacje do wyodrębnienia z zestawu danych. Na przykład zapytanie SELECT f.id AS "Flow ID":
- Wybiera identyfikator przepływu
idz zestawu danychflow. - Przypisuje mu nazwę
Flow ID. - Wyświetla wynik w osobnej kolumnie tabeli.
FROM określa zestaw danych, z którego pobierane są dane. Pobieramy z flow, który jest tabelą zawierającą informacje o przepływach zadań.
WHERE filtruje wyniki. Podstawowy warunek 1=1 jest używany do wygodnego dodawania dodatkowych ograniczeń.
Następnie używany jest szablon Jinja. Ta część sprawdza, czy parametr tasks_flows_flow_id jest obecny w raporcie. Jeśli raport jest otwierany z przepływu, Jinja zastępuje jego identyfikator i wyświetla dane tylko dla tego przepływu. Jeśli raport jest otwierany bezpośrednio w BI Builder, parametr nie jest przekazywany i wyświetlane są wszystkie dane.
Przykład zapytania SQL dla raportów szablonów workflow
To zapytanie SQL służy do wyodrębniania danych z trzech zestawów danych: zadań workflow (bizproc_task), aktywnych workflow (bizproc_workflow_state) i szablonów workflow (bizproc_workflow_template). Możesz je skopiować i zobaczyć, jak działa selekcja. Zapytanie wyświetla kluczowe informacje o aktywnych workflow i obsługuje filtrowanie według parametru workflow_template_id, umożliwiając budowanie raportu dla konkretnego szablonu procesu.
SELECT t.created_date AS "Task Creation Date", t.status_name AS "Task Status", t.user_name AS "Task Participant", w.started_by_name AS "Process Initiator", w.completed AS "Process Completion Status", w.duration AS "Time Spent", wt.name AS "Template Name" FROM bizproc_task t LEFT JOIN bizproc_workflow_state w ON t.workflow_id = w.id LEFT JOIN bizproc_workflow_template wt ON wt.id = w.workflow_template_id WHERE 1=1 {% if url_param('workflow_template_id') is not none %} AND wt.id = {{ url_param('workflow_template_id') }} {% endif %} ORDER BY t.created_date DESC;
SELECT określa dane do wyodrębnienia z zestawów danych. Na przykład zapytanie SELECT t.created_date AS "Task Creation Date":
- Wybiera datę utworzenia zadania
created_datez zestawu danychbizproc_task, - Przypisuje polu nazwę
Task Creation Date, - Wyświetla wynik w osobnej kolumnie tabeli.
FROM i LEFT JOIN określają zestawy danych, z których pobierane są dane, oraz sposób ich powiązania.
bizproc_taskzawiera zadania wykonywane przez pracowników,bizproc_workflow_stateprzechowuje dane o procesie, w ramach którego utworzono zadanie,bizproc_workflow_templateopisuje szablon workflow.
LEFT JOIN jest używany do wyświetlania wszystkich zadań, nawet jeśli niektóre nie mają informacji o stanie lub szablonie.
WHERE filtruje wyniki. Warunek 1=1 nie wpływa na selekcję i jest używany do uproszczenia dodawania filtrów.
Następnie używany jest szablon Jinja. Ta część sprawdza, czy parametr workflow_template_id jest obecny w raporcie. Jeśli raport jest otwierany z formularza protokołu workflow, Jinja zastępuje identyfikator i wyświetla tylko powiązane dane. Jeśli raport jest otwierany bezpośrednio w Kreatorze BI, parametr nie jest przekazywany i wyświetlane są wszystkie dane.
Zapisz wynikowy zestaw danych jako zestaw danych i utwórz wykres dla raportu.
Tworzenie wykresu na podstawie wirtualnego zestawu danych
Jeśli masz już raport, możesz po prostu edytować zestaw danych i dodać wymagany parametr.
- Otwórz zakładkę Zestawy danych i wybierz jeden z nich.
- Kliknij Edytuj.
Zmodyfikuj zapytanie SQL i dodaj parametr w zależności od filtra, którego planujesz użyć:
- Przepływy zadań —
WHERE 1=1 {% if url_param('tasks_flows_flow_id') is not none %} AND f.id = {{ url_param('tasks_flows_flow_id') }} {% endif %}. - Szablony workflow —
WHERE 1=1 {% if url_param('workflow_template_id') is not none %} AND wt.id = {{ url_param('workflow_template_id') }} {% endif %}.
Dodaj filtry i przetestuj raport
Aby dodać filtry:
- Otwórz raport w trybie edycji.
- Kliknij Dodaj/zmodyfikuj filtry w lewym panelu.
- Określ wymagany typ i nazwę, a następnie zapisz ustawienia.
Przetestuj działanie filtrów. Aby to zrobić, otwórz raport w sekcji, w której został osadzony. Lokalizacja zależy od wybranych parametrów:
Szablony workflow
- Przejdź do sekcji Automatyzacja > Workflow.
- Wybierz wymagany workflow i otwórz raport w zakładce Dziennik.
Przepływy zadań
- Przejdź do sekcji Zadania i Projekty > Przepływy.
- W kolumnie Analityka kliknij metrykę przepływu i otwórz raport.
W skrócie
- Filtry oparte na parametrach pomagają analizować dane w odpowiednim kontekście, na przykład dla konkretnego przepływu zadań lub szablonu workflow.
- Aby używać filtrów, skonfiguruj parametry raportu i określ sekcję, w której będzie otwierany.
- Jeśli tworzysz nowy raport, możesz dodać parametry bezpośrednio do zapytania SQL. Jeśli raport już istnieje, edytuj zestaw danych, aby dodać parametry.
- Następnie dodaj filtry do raportu, otwórz go w Bitrix24 i upewnij się, że wyświetla dane tylko dla wybranego przepływu lub procesu.