Beschreibung
Die Schnittstelle Jira ist eine bidirektionale Synchronisationsschnittstelle zwischen Multiflex-CRM-Aufgaben und Jira-Issues.
Sie wird eingesetzt, um:
-
CRM-Vorgänge/-Aufgaben aus Multiflex nach Jira zu exportieren bzw. dort zu aktualisieren.
-
Änderungen aus Jira wieder in Multiflex zurückzuschreiben.
-
Zusatzdaten zu synchronisieren (Status, Priorität, Zuordnung, Sprint, Zeitaufzeichnungen, Versionen, Custom-Fields, Reporter, User-Mapping).
Die Ausführung erfolgt im Autostart-Ablauf in dieser Reihenfolge:
|
Schritt |
Aktion |
|---|---|
|
1 |
Jira-Login (REST) |
|
2 |
Benutzer-Mapping PERSONALSTAMM ↔ Jira AccountId aufbauen |
|
3 |
Jira-Custom-Field-Optionen mit Multiflex-Vorgabewerten abgleichen |
|
4 |
Jira-Versionen mit Multiflex-Versionen abgleichen |
|
5 |
Sprints laden |
|
6 |
Export Multiflex → Jira |
|
7 |
Import Jira → Multiflex |
|
8 |
Temporäres User-Mapping löschen |
|
9 |
Settings speichern (u. a. LastExportDate, LastImportDate) |
Konfiguration
Technische Schnittstellenparameter
|
Feld |
Wert |
|---|---|
|
Key |
Jira |
|
Title |
Jira |
|
SupportsAutostart |
true |
|
CanLockInterface |
true |
|
Registrierung in WpfInterfaces |
vorhanden (InterfaceUILink(typeof(Interfaces.Jira.JiraInterface), null)) |
Relevante Settings (aktiv genutzt)
|
Setting |
Bedeutung |
|---|---|
|
RestAPIUrl |
Jira REST Basis-URL |
|
LoginEmail |
Jira Benutzer |
|
LoginPassword |
Jira Passwort/Token |
|
JiraGroupName |
Jira-Gruppe für User-Mapping |
|
StdProjectKey |
Fallback-Jira-Projekt |
|
BugIdentifier |
Kennung zur Typ-Zuordnung Bug/Feature |
|
JiraBugIssueType / JiraFeatureIssueType |
Jira-Issue-Typen |
|
JiraLowPrio / JiraMediumPrio / JiraHighPrio / JiraCriticalPrio |
Jira-Prioritätsnamen |
|
JiraCreatedStatus / JiraDoneStatus / JiraStartedStatus |
Jira-Statusnamen |
|
JiraDoneTransition / JiraStartedTransition |
Workflow-Transitionen |
|
JiraBoardID |
Board-ID für Sprint/Backlog |
|
StdUserForWorklog |
Default-User für Worklog/Reporter |
|
SyncTimeRecording |
Zeitbuchungen synchronisieren |
|
CreateTCLink |
TaskCenter-Link in Jira setzen |
|
DepartmentsForJiraExport |
Abteilungsfilter Export |
|
CRMRolesForSynchronization |
Rollenfilter Export |
|
CapacityERPTeam, CapacityWEBTeam, RoadMapCapacityERPTeam, RoadMapCapacityWEBTeam |
Kapazitätsplanung Sprintzuordnung |
|
FilterERPTeam, FilterWEBTeam |
Team-/Programmbereichsfilter |
|
LastExportDate, LastImportDate |
Zeitanker für Delta-Sync |
Exportablauf
-
Schnittstelle wird gestartet (INTERFACE=Jira) und Jira-Verbindung aufgebaut.
-
Benutzer-Mapping (PERSONALSTAMM ↔ Jira AccountID) wird erstellt.
-
Custom-Field-Optionen in Jira werden mit Multiflex-Vorgaben synchronisiert.
-
Jira-Versionen werden mit Multiflex-Versionen abgeglichen/ergänzt.
-
Sprints vom konfigurierten Board werden geladen.
-
Exportrelevante CRM-Datensätze werden per SQL selektiert (Delta- und Filterlogik).
-
Für jeden Datensatz wird Jira-Issue angelegt oder per JIRA_KEY aktualisiert.
-
Jira-Felder werden gesetzt (Typ, Summary, Description, Priorität, Program area/part, Window/Shop, Versionen, Labels, Reporter etc.).
-
Status-Transitionen (z. B. Done / Started) werden bei Bedarf ausgeführt.
-
Optional: Zeitaufzeichnungen werden nach Jira synchronisiert (SyncTimeRecording).
-
Sprintzuordnung/Backlog-Verschiebung wird durchgeführt (inkl. Kapazitätslogik).
-
Jira-Referenzen und Exportdatum werden in Multiflex-Profiling zurückgeschrieben.
Aktiv verwendete Felder
Selektierte Quellfelder (SQL)
|
Quelle |
Feld |
Verwendung |
|---|---|---|
|
VG_DETAIL |
INX (VDINX), MD, ERLEDIGT, BEGINN, ENDE, ROLLE, PLANSTUNDEN, PRIORITAET, AZ_DAUER, KATEGORIE, NOTIZ1, NOTIZ3, TEXT |
Hauptdaten Task/Delta/Planung |
|
VORGANG |
INX (VINX), VORGANG, BETRIFFT, TEXT, ZUORDNUNG, NUMMER (CUSTOMERNUMBER) |
Vorgangs-/Kundenkontext |
|
KUNDEN |
NAME1 (KUNDENBEZ) |
Epic/Anzeige |
|
PERSONALSTAMM |
ABTEILUNG, User-Bezug |
Filter/Team |
|
JIRA_USER_MAPPING |
JIRA_ACCOUNTID |
Assignee/Mapping |
|
VG_PROFKRIT |
JIRA_KEY (Parent), PROGVERSION, PROGRAMMBEREICH, PROGRAMMTEIL, FENSTER/SHOP, LÖSUNG IN VERSION, JIRA_EPIC |
Jira-Mapping/Felder |
|
VG_DETAIL_PROFKRIT |
JIRA_KEY (Task), Detail-Programmfeld, DEV TEAM |
Jira-Key/Feld-Override |
|
KUN_PROFKRIT |
JIRA_PROJEKT, JIRA_EPIC, JIRA_EXPORT_DATE |
Projekt/Epic/Deltaanker |
|
PROJEKTSTAMM + PERSONALSTAMM |
Projektleiter → JIRA_ACCOUNTID |
Reporter |
Export – Ziel in Jira (aktiv gesetzt)
|
Jira-Feld |
Quelle/Logik |
|---|---|
|
Issue Type |
ZUORDNUNG vs BugIdentifier |
|
Summary |
VORGANG + BETRIFFT |
|
Description |
ATEXT |
|
Priority |
PRIORITAET → Settings-Prioritäten |
|
Start date / End date |
VD.BEGINN/ENDE bzw. Sprintlogik |
|
Program area |
PROGRAMMBEREICH |
|
Program part |
PROGRAMMTEIL |
|
Window/Shop |
FS |
|
Internal notes |
NOTIZ1 |
|
Additional project information |
NOTIZ3 |
|
TaskCenter Operation Number |
optional (CreateTCLink) |
|
Labels |
z. B. RoadMap |
|
AffectsVersions/FixVersions |
PROGVERSION / LIV |
|
Reporter |
Projektleiter oder StdUserForWorklog |
|
Assignee |
JIRA_ACCOUNTID (falls vorhanden) |
|
Workflow Transition |
Done/Started nach Statuslogik |
|
Timetracking/Worklogs |
optional bei SyncTimeRecording |