Skill-Matrix

Prev Next

:::(Info)To download, visit: Library.
:::

Was ist das „Skill Matrix“-Widget?

Mit dem „Skill Matrix“-Widget können Sie die Fähigkeiten der Benutzer und die Kompetenzstufen bei Aufgaben in einer tabellarischen Matrix visualisieren, filtern und verwalten.

Screenshot 2025-08-08 at 17.32.49.png

Sie können dieses Widget nutzen, um:

  • die Fähigkeiten der Bediener zu verfolgen und Lücken zu identifizieren
  • Fähigkeiten nach Benutzer, Gruppe, Aufgabe oder Stufe anzeigen
  • Fähigkeitsdaten dynamisch zu filtern
  • Mit Matrixzellen interagieren, um detaillierte Datensätze anzuzeigen oder Aktionen auszulösen

In dieser Anleitung wird erläutert, wie Sie das Widget „Kompetenzmatrix“ in Tulip einrichten und verwenden.


Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Zugriff auf Ihr Tulip-Konto
  • Berechtigung zum Anzeigen von Dienstkonten und zum Verwalten von Tabellen
  • Die URL Ihres Tulip-Kontos und Ihre Workspace-ID

1. Konfigurieren Sie die obligatorischen Parameter

1.1 Rufen Sie Ihr Dienstkonto ab

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

  1. Klicken Sie oben rechts in Tulip auf Ihr Benutzersymbol.
  2. Gehen Sie zu „Kontoeinstellungen“.
  3. Klicken Sie im Menü auf der linken Seite auf „Tulip-API “.
  4. Klicken Sie auf „Dienstkonto erstellen“.
  5. Geben Sie Ihrem Dienstkonto einen Namen (z. B. „SkillMatrixWidget“).
  6. Weisen Sie die folgenden Bereiche zu:
  7. table-queries:read
  8. tables:read
  9. tables:write
  10. users:read
  11. Klicken Sie auf „Erstellen“.
  12. Kopieren Sie den Auth-Header, entfernen Sie jedoch das Wort „Basic“ und das Leerzeichen danach.
  13. Bei der Konfiguration des Widgets: Wenn Sie aufgefordert werden, zwischen „Variable“ und „Statischer Wert“ für das Dienstkonto zu wählen, wählen Sie „Statischer Wert“ und fügen Sie Ihre Anmeldedaten (ohne „Basic“) direkt in das Feld ein.
Caution

Never share your Service Account credentials publicly.


1.2 So finden Sie die URL Ihres Tulip-Kontos

Die URL Ihres Kontos sieht in der Regel so aus:
Ihr-Konto.tulip.co


1.3 Suchen Sie Ihre Task-Tabellen-ID

  1. Gehen Sie in Tulip zum Abschnitt „Tabellen “.
  2. Klicken Sie auf die entsprechende Aufgabetabelle.
  3. Kopieren Sie die Tabellen-UID aus dem Detailbereich.

1.4 Feld-IDs ermitteln

Ermitteln Sie die Feld-IDs für:

  • Den Benutzer (z. B. Name oder Benutzer-ID)
  • Den Namen der Fertigkeit/Aufgabe
  • dem Kompetenzniveau

So ermitteln Sie die ID eines Feldes:

  1. Öffnen Sie die Tabelle.
  2. Klicken Sie auf die Spaltenüberschrift.
  3. Rufen Sie die Feld-ID im Eigenschaftenfenster auf.
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. Optionale Parameter konfigurieren

Sie können das Widget mithilfe der folgenden optionalen Parameter weiter anpassen:

  • Gruppenfeld-ID: Ordnet Daten nach Team, Abteilung usw.
  • Entwurfsstatus: Filtert nach Status (z. B. „Aktiv“, „Abgeschlossen“).
  • Stufenfarben: Weisen Sie verschiedenen Kompetenzstufen benutzerdefinierte Farben zu.

2.1 Filter

Sie können optionale Filter hinzufügen, um anzupassen, welche Daten in der Matrix angezeigt werden.

Filter Beschreibung
Titel Standardmäßig bezieht sich der Filter „Titel“ in der Regel auf das Feld „Gruppe“, „Fähigkeitsname“ oder „Aufgabenkategorie“.
Sichtbar Steuert die Sichtbarkeit eines Datensatzes. Der Standardwert ist „true“.
Hinweis

Filter sind optional und sollten Ihrem Anwendungsfall entsprechen.

Sie können Filter für mehrere „ fields “ konfigurieren und nicht benötigte Filter nach der Einrichtung ganz einfach deaktivieren. Nur aktive Filter wirken sich auf Ihre Daten aus.


2.2 Erweiterte Konfiguration

API-Abfragefilter

Mithilfe benutzerdefinierter API-Filterabfragen können Sie steuern, welche Datensätze angezeigt werden.

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.

Beispielabfragen:json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}

API-Limit: Begrenzen Sie die Anzahl der geladenen Zeilen.

2.3. Legen Sie Ihre Workspace-ID fest

  • Sie finden Ihre Workspace-ID in der Tulip-URL hinter /w/. Beispiel:https://your-account.tulip.co/w/DEFAULT → Die Workspace-ID lautet DEFAULT
  • Verwenden Sie für den Standard-Workspace „DEFAULT“ oder lassen Sie das Feld leer.

3. Verwenden Sie das Skill-Matrix-Widget

3.1. Kompetenzdaten anzeigen

Nach der Konfiguration zeigt das Widget eine Matrix mit folgenden Informationen an:

  • Benutzer
  • Aufgaben oder Kompetenzen
  • Entsprechende Kompetenzstufen

Verwenden Sie die integrierten Dropdown-Filter (Gruppen, Kompetenzen, Stufen), um die Ansicht einzugrenzen.

3.2. Neu laden und filtern

  • Klicken Sie auf „Filter löschen“, um alle Filterauswahlen zu entfernen.
  • Klicken Sie auf „Neu laden“, um die Daten zu aktualisieren.

3.3. Vorfilter

Vorfilter filtern Daten dynamisch basierend auf:

  • dem aktuell angemeldeten Benutzer
  • dem ausgewählten Team oder der ausgewählten Abteilung
  • Datumsbereich oder Schicht
Tip

Use pre-filters to personalize views for operators or supervisors.

4. Auslöser für interaktive Aktionen hinzufügen

Sie können das Widget so konfigurieren, dass Aktionen ausgelöst werden, wenn ein Benutzer auf eine Zelle klickt.

  1. Öffnen Sie den Bereich „Trigger “.
  2. Legen Sie eine Aktion für die Datensatz-ID fest, wenn auf eine Zelle geklickt wird.
  3. Aktivieren Sie „Datensatz laden“, um weitere Details zum Benutzer oder zur Fähigkeit anzuzeigen.

Tipps

  • Überprüfen Sie Ihre Tabellen- und Feld-IDs sorgfältig, um Tippfehler zu vermeiden.
  • Verwenden Sie Filter, um Dashboards an verschiedene Rollen anzupassen.
  • Testen Sie mit Testdaten, bevor Sie das Dashboard in die Produktion übernehmen.

Fehlerbehebung

Problem Mögliche Ursache Vorgeschlagene Lösung
Die Matrix wird nicht geladen Ungültige API-Anmeldedaten oder URL Überprüfen Sie die Anmeldedaten/URL noch einmal
Daten werden nicht angezeigt Filter sind zu restriktiv Entfernen oder lockern Sie die Filter
„Undefinierte“ Felder Falsche Feld-ID verwendet Tabellenfeld-IDs überprüfen
Zellen sind nicht anklickbar Trigger nicht konfiguriert Trigger im Widget einrichten

Weiterführende Informationen:

Datensätze eines„ Tulip Table“auflistenSo richten Sie eine Tulip-API ein