So erstellen und konfigurieren Sie 𝕍𝕃 Issue Pickers
Vollständige Anleitung zum Anlegen und Konfigurieren von VIP.LEAN Issue Pickern: beide Wege zum Anlegen, die Abschnitte Field, Selection, Display und Links, die Live-Vorschau und das Hinzufügen zu Masken.
1. Issue Picker in der App anlegen (empfohlen)
Erforderliche Jira-Rolle: Jira Administrator
- Öffnen Sie Settings › Apps und wählen Sie in der Seitenleiste Issue Picker. Jira-Administratoren finden die Seite auch unter Apps › Issue Picker.
- Klicken Sie auf + Issue Picker oder, solange die Liste leer ist, auf Create Issue Picker.
- Füllen Sie die Abschnitte aus Kapitel 3 aus. Nur der Name ist Pflicht.
- Klicken Sie auf Create. Die App legt das benutzerdefinierte Jira-Feld an und speichert die Einstellungen; das kann einen Moment dauern.
- Fügen Sie das neue Feld Ihren Masken hinzu (Kapitel 4). Das übernimmt die App nicht.

2. Issue Picker in den Feldeinstellungen von Jira anlegen
Erforderliche Jira-Rolle: Jira Administrator
- Legen Sie in den Einstellungen für benutzerdefinierte Felder von Jira ein neues Feld vom Typ VIP.LEAN Issue Picker an und geben Sie einen Namen und optional eine Beschreibung ein.
- Öffnen Sie Settings › Apps › Issue Picker und klicken Sie auf Re-index. Erst dann kennt die App das neue Feld. Bis dahin zeigt das Feld an Arbeitselementen „Issue Picker configuration is broken, please contact your JIRA administrator.“
- Öffnen Sie den neuen Picker mit Edit und konfigurieren Sie ihn (Kapitel 3). Nach dem Re-index startet er mit Standardeinstellungen: kein Verknüpfungstyp, keine JQL und Use app permissions for the search eingeschaltet.
3. Issue Picker konfigurieren
Erforderliche Jira-Rolle: Jira Administrator
Der Editor hat vier Abschnitte. Ein Etikett neben jedem zeigt, wo seine Einstellungen gelten:
- All contexts: gleich für jeden Space und Arbeitstyp.
- Default context: die Standardwerte des Pickers. Ein Kontext kann sie für bestimmte Spaces und Arbeitstypen überschreiben; siehe So verwalten Sie bestehende Issue Picker.
3.1 Field

| Einstellung | Standard | Beschreibung |
|---|---|---|
| Name | Pflicht | Erscheint als Feldname an Arbeitselementen und wird im benutzerdefinierten Jira-Feld gespeichert. Bis zu 255 Zeichen. |
| Description | Leer | Optional. Wird als Beschreibung des benutzerdefinierten Jira-Feldes gespeichert. |
| Field ID | – | Erscheint beim Bearbeiten, schreibgeschützt, z. B. customfield_10096. Sie brauchen sie für JQL, Automation-Regeln und die REST-API. |
| Multi-Select | Aus | Im Feld können mehrere Arbeitselemente ausgewählt werden. Gilt in jedem Kontext gleich, weil der gespeicherte Wert und die Verknüpfungen davon abhängen. |
3.2 Selection
Wie der Picker sucht und welche Arbeitselemente er anbietet. Das sind die Standardwerte; ein Kontext kann sie überschreiben.

| Einstellung | Standard | Beschreibung |
|---|---|---|
| Hide key in picker | Aus | Der Picker listet nur Zusammenfassungen. Schaltet zugleich Deactivate key search ein. |
| Deactivate key search | Aus | Die Eingabe eines Schlüssels findet das Arbeitselement nicht mehr direkt. |
| Use app permissions for the search | Aus | Die Suche läuft mit den Berechtigungen der App statt mit denen des Anwenders, der das Feld ausfüllt. Anwender sehen dann Schlüssel und Zusammenfassung auch von Arbeitselementen, die sie nicht öffnen können. Bei Pickern aus älteren App-Versionen ist die Option eingeschaltet. |
| Restricted to current space | Aus | Nur Arbeitselemente des aktuellen Space werden angeboten. |
| Add subtasks of the current work item | Aus | Subtasks des aktuellen Arbeitselements werden zusätzlich zum Auswahlfilter angeboten. Aus: Es wird kein Subtask angeboten. Picker aus der vorigen Version zeigen „Not set yet“ und bieten weiter Subtasks an, die zum Filter passen, bis Sie auf Leave them out klicken. |
| JQL | Leer | Optional. Nur Arbeitselemente, die zu dieser Abfrage passen, werden angeboten. Wird während der Eingabe gegen Jira geprüft; bis zu 8.000 Zeichen. |
3.3 Suche in der Vorschau prüfen
Unter dem Filter führt Preview die echte Suche in Jira aus, genau wie das Feld: mit den Berechtigungen der App oder mit Ihren, je nach Use app permissions for the search.
- Screen: Create, View oder Transition, bei Service-Spaces auch Portal create.
- Current work item: bei View und Transition das Arbeitselement, an dem das Feld steht. Bei Create und Portal create wählen Sie stattdessen Space · Work type.
- Search sent to Jira: die genaue JQL, darunter die gefundenen Arbeitselemente, jeweils 100.
Im Abschnitt Selection des Pickers selbst deckt die Vorschau die Spaces und Arbeitstypen ab, die keinen eigenen Kontext haben.

3.4 Display
Was das Feld zu jedem ausgewählten Arbeitselement in der Ansicht des Arbeitselements zeigt. Wählen Sie aus Issue Type, Issue Key, Summary, Status, Assignee und Priority; neue Picker zeigen alle sechs. Issue Key oder Summary bleibt immer sichtbar, damit jedes Arbeitselement erkennbar ist. Wird der Schlüssel ausgeblendet, entfällt auch der Link zum ausgewählten Arbeitselement.
Die Anzeigefelder gelten für die Ansicht des Arbeitselements. Die Liste im Picker selbst zeigt Symbol des Arbeitstyps, Schlüssel und Zusammenfassung.

3.5 Links
Hält den Feldwert und die Jira-Verknüpfungen des Arbeitselements synchron. Gilt in jedem Kontext gleich.

| Einstellung | Standard | Beschreibung |
|---|---|---|
| Link type | No issue link | Die Jira-Verknüpfung zwischen dem Arbeitselement und jedem ausgewählten Arbeitselement. Wird ein Arbeitselement aus dem Feld entfernt, wird seine Verknüpfung gelöscht. Das gilt auch für Werte aus Automation-Regeln oder der REST-API. |
| Remove field value if link is deleted | Aus | Wird die Verknüpfung in Jira gelöscht, wird auch das Arbeitselement aus dem Feld entfernt. |
| Add field value if link is added (multi-select) / Add field value if empty and link is added (single) | Aus | Wird die Verknüpfung in Jira angelegt, kommt das Arbeitselement auch ins Feld, sofern der Picker es dort anbieten würde. Ein Feld mit Einfachauswahl wird nur gefüllt, wenn es leer ist. |
4. Issue Picker zu Masken hinzufügen
Erforderliche Jira-Rolle: Jira Administrator
Die App legt das Feld an, fügt es aber keiner Maske hinzu. Das erledigen Sie mit den Standardfunktionen von Jira.
4.1 Company-managed Spaces
Fügen Sie das Feld den Masken zum Erstellen, Bearbeiten und Anzeigen der Spaces und Arbeitstypen hinzu, in denen Sie es brauchen, und den Transition-Masken, wenn es bei einer Transition ausgefüllt werden soll. In der Jira-Liste der benutzerdefinierten Felder erscheint es mit dem Typ VIP.LEAN Issue Picker.
4.2 Team-managed Spaces
Öffnen Sie in den Space-Einstellungen den Arbeitstyp, suchen Sie den Issue Picker in der Liste der Felder und ziehen Sie ihn ins Layout.
4.3 Portal von Jira Service Management
Um das Feld im Portal zu nutzen, fügen Sie es dem Anfrageformular des Anfragetyps hinzu.