--- title: "Matryca umiejętności" slug: "skill-matrix" status: "new" updated: 2026-10-22T17:13:34Z published: 2026-10-22T17:13:34Z canonical: "support.tulip.co/skill-matrix" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Matryca umiejętności :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## Czym jest widżet „Skill Matrix”? **Widżet „Skill Matrix”** pozwala na wizualizację, filtrowanie i zarządzanie umiejętnościami użytkowników oraz poziomami kompetencji w zakresie zadań w tabeli w formie macierzy. ![Screenshot 2025-08-08 at 17.32.49.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-08-08%20at%2017.32.49.png) ### Za pomocą tego widżetu można: - Śledzenie umiejętności operatorów i identyfikowanie braków - Przeglądania umiejętności według użytkownika, grupy, zadania lub poziomu - Dynamicznego filtrowania danych dotyczących umiejętności - Interakcji z komórkami macierzy w celu wyświetlenia szczegółowych rekordów lub uruchomienia działań W niniejszym przewodniku wyjaśniono, jak skonfigurować i korzystać z widżetu „Macierz umiejętności” w **Tulip**. --- ## Wymagania wstępne Zanim zaczniesz, upewnij się, że masz: - Dostęp do **konta** w serwisie **Tulip** - Uprawnienia do **przeglądania kont usługowych** i **zarządzania tabelami** - **adres URL konta Tulip** oraz **identyfikator obszaru roboczego** --- ## 1. Skonfiguruj parametry obowiązkowe ### 1.1 Uzyskaj swoje konto serwisowe Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Kliknij **ikonę użytkownika** w prawym górnym rogu Tulip. 2. Przejdź do **Ustawień konta**. 3. Kliknij opcję **„Tulip API** ” w menu po lewej stronie. 4. Kliknij opcję **„Utwórz konto serwisowe**”. 5. Nadaj nazwę swojemu kontu serwisowemu (np. `SkillMatrixWidget`). 6. Przypisz następujące zakresy: 7. `table-queries:read` 8. `tables:read` 9. `tables:write` 10. `users:read` 11. Kliknij **„Utwórz**”. 12. Skopiuj **nagłówek uwierzytelniający**, ale **usuń** słowo `„Basic”` oraz spację po nim. 13. Podczas konfiguracji widżetu: Jeśli pojawi się monit o wybranie opcji **„Wartość** **zmienna”** lub **„Wartość statyczna”** dla **konta serwisowego**, wybierz **opcję „Wartość statyczna”** i wklej swoje dane uwierzytelniające **(bez słowa „Basic”)** bezpośrednio w polu. Caution Never share your Service Account credentials publicly. --- ### 1.2 Znajdź adres URL swojego konta Tulip Adres URL Twojego konta zazwyczaj wygląda następująco: `twoje-konto.tulip.co` --- ### 1.3 Znajdź identyfikator tabeli zadań 1. Przejdź do sekcji **„Tables” (Tabele** ) w Tulip. 2. Kliknij odpowiednią **tabelę zadań**. 3. Skopiuj identyfikator **UID tabeli** z sekcji szczegółów. --- ### 1.4 Zidentyfikuj identyfikatory pól Znajdź **identyfikatory pól** dla: - Użytkownika (np. imię i nazwisko lub identyfikator użytkownika) - Nazwy umiejętności/zadania - Poziomu umiejętności Aby znaleźć identyfikator pola: 1. Otwórz tabelę. 2. Kliknij nagłówek kolumny. 3. Sprawdź **identyfikator pola** w panelu właściwości. Tip There are no enforced default names for these fields; you must decide which of your fields will be treated as user/skill/level when configuring the widget. --- ## 2. Skonfiguruj parametry opcjonalne Możesz dodatkowo dostosować widżet, korzystając z następujących opcjonalnych parametrów: - **Identyfikator pola grupy**: porządkuje dane według zespołu, działu itp. - **Status projektu**: filtruje według statusu (np. Aktywny, Zakończony). - **Kolory poziomów**: przypisz niestandardowe kolory do różnych poziomów umiejętności. --- ### 2.1 Filtry Można dodać opcjonalne filtry, aby dostosować, jakie dane pojawiają się w macierzy. | Filtr | Opis | | --- | --- | | **Tytuł** | Domyślnie filtr **„Tytuł”** odnosi się zazwyczaj do pola grupy, nazwy umiejętności lub kategorii zadania. | | **Widoczny** | Kontroluje widoczność rekordu. Domyślnie ustawione na `„true`”. | :::(Informacja) (Uwaga) Filtry są opcjonalne i powinny odzwierciedlać konkretny przypadek użycia. Możesz skonfigurować filtry dla kilku elementów typu „ fields ” i łatwo wyłączyć te, których nie potrzebujesz po zakończeniu konfiguracji. Tylko aktywne filtry będą miały wpływ na dane. ::: --- ### 2.2 Konfiguracja zaawansowana #### Filtry zapytań API Możesz kontrolować, które rekordy są wyświetlane, używając niestandardowych zapytań filtrujących API. Note When you apply multiple filter conditions, they are combined using a logical **AND**. This means **all conditions must be true** for a record to be returned. **Przykładowe zapytania:**`json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}` **Limit API:** Ogranicz liczbę ładowanych wierszy. ### 2.3. Ustaw identyfikator obszaru roboczego - **ID obszaru roboczego** można znaleźć w adresie URL serwisu Tulip po `znaku /w/.` Na przykład:`https://your-account.tulip.co/w/DEFAULT` → ID obszaru roboczego to `DEFAULT` - W przypadku przestrzeni roboczej domyślnej należy użyć `wartości DEFAULT` lub pozostawić pole puste. ## 3. Korzystanie z widżetu „Skill Matrix” ### 3.1. Wyświetlanie danych dotyczących umiejętności Po skonfigurowaniu widżet wyświetla matrycę zawierającą: - Użytkowników - Zadania lub umiejętności - Odpowiednich poziomów umiejętności Skorzystaj z wbudowanych filtrów rozwijanych (Grupy, Umiejętności, Poziomy), aby zawęzić widok. ### 3.2. Odśwież i filtruj - Kliknij **„Wyczyść filtry”**, aby usunąć wszystkie wybrane filtry. - Kliknij **„Odśwież”**, aby zaktualizować dane. ### 3.3. Filtr wstępny Filtry wstępne dynamicznie filtrują dane na podstawie: - Aktualnie zalogowanego użytkownika - Wybranego zespołu lub działu - Zakresu dat lub zmiany Tip Use pre-filters to personalize views for operators or supervisors. ## 4. Dodaj wyzwalacze dla interaktywnych działań Możesz skonfigurować widżet tak, aby uruchamiał akcje po kliknięciu komórki przez użytkownika. 1. Otwórz panel **„Wyzwalacze** ”. 2. Ustaw akcję dla **identyfikatora rekordu** po kliknięciu komórki. 3. Włącz opcję **„Załaduj rekord”**, aby wyświetlić więcej szczegółów dotyczących użytkownika lub umiejętności. ## Wskazówki - Sprawdź dokładnie **identyfikatory** **tabeli** i **pól**, aby uniknąć literówek. - Używaj filtrów, aby dostosować pulpity nawigacyjne do różnych ról. - Przed uruchomieniem w środowisku produkcyjnym przetestuj pulpit przy użyciu danych testowych. ## Rozwiązywanie problemów | Problem | Prawdopodobna przyczyna | Sugerowane rozwiązanie | | --- | --- | --- | | Matryca się nie ładuje | Nieprawidłowe dane uwierzytelniające API lub adres URL | Sprawdź ponownie dane uwierzytelniające/adres URL | | Dane się nie wyświetlają | Filtry są zbyt restrykcyjne | Usuń lub złagodź filtry | | Pola „niezdefiniowane” | Użyto nieprawidłowego identyfikatora pola | Sprawdź identyfikatory pól w tabeli | | Komórki, których nie można kliknąć | Nie skonfigurowano wyzwalacza | Skonfiguruj wyzwalacz w widżecie | ## Więcej informacji: [Lista rekordów A Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Jak skonfigurować API Tulip](https://support.tulip.co/docs/set-up-a-tulip-api)