# Umzug aus Jira

Stand: 2026-11-06

So holen Sie ein Jira-Projekt nach IT4S, was mitkommt und was nicht. Der Import liest Jira Cloud über die API; Sie können ihn beliebig oft wiederholen, bis Sie umstellen, und jeder Lauf aktualisiert, statt doppelt anzulegen.

## Schritt für Schritt

1. **Jira verbinden:** unter *Verwaltung › Einstellungen › Integrationen* die Jira-Adresse, die E-Mail-Adresse eines Atlassian-Kontos und dessen API-Token eintragen, *Speichern*, dann *Verbindung testen*. Das Konto muss die Projekte sehen, die Sie importieren wollen.
2. **Projekt wählen:** *Verwaltung › Jira-Import*, das **Jira-Projekt** wählen, dann **Importieren in**: *Ein neues Projekt* (IT4S legt es mit dem **IT4S-Projektschlüssel** und Namen an; die Issue-Schlüssel bleiben die aus Jira) oder *Ein bestehendes Projekt* (die Issues kommen zu den eigenen dazu; die Schlüssel wechseln auf den des Projekts, auch dort, wo Texte sie nennen, und vergebene Nummern bekommen die nächste freie).
3. **Analysieren:** IT4S exportiert das Projekt im Hintergrund und zeigt, was der Import anlegen würde: Issues, Kommentare, Arbeitszeiten, Anhänge, Releases, Komponenten, Tags, Personen und die gefundenen Probleme. Importiert ist noch nichts.
4. **Status-Zuordnung prüfen:** jeder Jira-Status des Projekts mit dem IT4S-Status, den seine Issues bekommen. Zeilen, die nur über ihre Jira-Kategorie passen, haben einen Hinweis; wählen Sie dort den richtigen Status.
5. **Personen prüfen:** Jira-Personen werden über die E-Mail-Adresse (oder den Namen) zugeordnet oder über die Benutzerzuordnung, die Sie ausfüllen. Für **Benutzer ohne IT4S-Konto** wählen Sie *Als inaktive Benutzer anlegen* (wenn Jira ihre E-Mail-Adresse zeigt; einladen können Sie sie später) oder *Ihre Issues und Kommentare dem importierenden Admin zuordnen*.
6. **Importieren:** Issues, Kommentare, Arbeitszeiten, Dateien und der Feldverlauf kommen herein; die Seite zeigt den Fortschritt und am Ende, was angelegt und aktualisiert wurde.
7. **Ergebnis ansehen:** das Board des Projekts, ein paar Issues und ihren Verlauf. Dann laden Sie Ihr Team ein (siehe [Verwaltung](https://it4s.at/hilfe/handbuch/administration/)).
8. **Bis zur Umstellung:** den letzten Lauf öffnen und **Aus Jira aktualisieren und importieren** klicken. IT4S lädt das Projekt neu und übernimmt, was sich in Jira geändert hat, auch dort gelöschte Arbeitszeiten.

## Was mitkommt

| Jira | IT4S |
|---|---|
| Issue-Typen Epic, Story, Task, Bug, Sub-task | dieselben Typen; *New Feature* wird Story, *Improvement* und *Spike* werden Task, andere Typen Task (oder Sub-task bei Sub-task-Typen) |
| Status | über den Namen (To Do, In Progress, In Review, Done, Won't Do und übliche Varianten), sonst über die Jira-Kategorie; Ihre Wahl in der Status-Zuordnung gewinnt. *Done* mit einer Lösung wie *Won't Fix*, *Duplicate* oder *Declined* wird Wird nicht gemacht. *In Planning*, *New Idea* und *Waiting for approval* bekommen den nächstliegenden Status und einen Tag mit dem ursprünglichen Namen |
| Prioritäten | Highest/Blocker/Critical → Höchste, High/Major → Hoch, Medium/Normal → Mittel, Low/Minor → Niedrig, Lowest/Trivial → Niedrigste |
| Zusammenfassung, Beschreibung, Zuständig, Melder, Fälligkeit | dieselben Felder; der Melder fällt auf den Ersteller zurück |
| Parent und Epic-Link | übergeordnetes Issue; ein Parent außerhalb des Exports entfällt mit Hinweis |
| Labels | Tags |
| Fix-Versionen | Releases (veröffentlicht oder nicht, mit Datum); bei mehreren behält das Issue die erste |
| Komponenten | Komponenten mit kurzem Code; bei mehreren behält das Issue die erste, ein Kommentar nennt die anderen |
| Ursprüngliche und verbleibende Schätzung | Schätzungen in Zeit |
| Kommentare, Arbeitszeiten, Anhänge | Kommentare, Arbeitszeiten (mit Person und Tag), Dateien am Issue |
| Verknüpfungen | *blockiert*, *hängt zusammen mit*, *dupliziert*; *klont* und unbekannte Arten werden *hängt zusammen mit* |
| Board-Reihenfolge (Rank) | die Reihenfolge auf dem IT4S-Board |
| Verlauf | der Verlauf zeigt Änderungen an Status, Zuständig, Priorität, Typ, Titel, Tags, Release und Parent mit Datum und Person aus Jira, markiert *via Jira import* |
| Links auf andere Jira-Issues in Texten | öffnen das importierte Issue in IT4S (auch Board-Links mit `selectedIssue=…`) |

## Was in Jira bleibt

- Eigene Felder, Story Points, die Lösung als Feld, Sprints, Jira-Workflows und Schemata, Boards und Filter, Dashboards und Daten von Marketplace-Apps.
- Änderungen an Feldern, die IT4S nicht hat, fehlen im Verlauf; das Ergebnis nennt ihre Zahl.
- Links auf nicht importierte Issues und Confluence-Links bleiben, wie sie sind; die Zeile *Anhänge in Jira* zeigt weiter auf Jira. Confluence-Seiten kommen mit dem eigenen Confluence-Import in die Dokumentation.

## Gut zu wissen

- **Jederzeit wiederholen:** Issues über den Schlüssel, Kommentare, Arbeitszeiten und Dateien über ihre Jira-ID, Releases und Tags über den Namen: Nichts kommt doppelt, und Änderungen in Jira kommen nach IT4S.
- **Die Limits des Tarifs gelten:** Auf Free hat ein Workspace bis zu 3 Projekte und 3 Benutzer; Personen, die der Import als inaktive Benutzer anlegt, zählen erst, wenn Sie sie einladen. Große Importe mit vielen Dateien brauchen den Speicher des Tarifs Team.
- **Wie lange es dauert,** hängt von der Zahl der Issues, Kommentare und Dateien ab; die Seite zeigt den Fortschritt und läuft weiter, wenn Sie sie schließen.
- **Hilfe beim Umzug:** Größere Umgebungen (mehr Projekte, Confluence, Personen und Rollen) zieht Silvertip mit Ihnen um: Schreiben Sie an info@silvertip-it.at.