Erhältlich für: Jira Cloud, Jira Server (On-Premise) und Datacenter (auch LDAP-geschützt)
Einrichtung durch: Miro Team-Admin & Jira System-Admin mit Projektadministrationsberechtigungen
⚠️ Sollten technische Probleme auftreten, lies bitte unseren Artikel über Mögliche Probleme und wie du sie beheben kannst.
In den Artikeln FAQ zu Jira-Karten und Wie richte ich webHook für Jira-Karten ein erfährst du mehr über Jira-Karten.
Konfiguration von Miro in Jira
✏️ Bitte beachte, dass die Menüs von Jira je nach Jira-Version unterschiedlich sein können. Der allgemeine Ablauf sollte jedoch derselbe sein. Die folgenden Anweisungen findest du auch im Atlassian-Support.
Schritt 1: Anwendungslink
Erstelle zunächst einen Anwendungslink und konfiguriere ihn.
- Gehe zu Jira Einstellungen > Produkte > Integrationen > App-Links > Link erstellen:
Beachte, dass sich die Jira-Oberfläche je nach Jira-Version unterscheiden kann
- Wähle Direkte App-Verknüpfung und gib https://miro.com/ in das Feld URL der App ein.
Wichtig: Du musst die URL in genau diesem Format eingeben. Klicke auf Weiter.
Den Link erstellen
- Klicke im nächsten Menü einfach erneut auf Weiter.
- Überprüfe im Menü Link überprüfen, ob die URL immer noch genau https://miro.com/ ist, und gib den Anwendungsnamen deiner Wahl ein. Scrolle nach unten und aktiviere unten das Kontrollkästchen Eingehenden Link erstellen. Überspringe die übrigen Felder und klicke auf Weiter.
Nur das Feld für den Namen der App muss ausgefüllt werden
- Hier siehst du die Felder für die Miro-Werte. Um die Werte zu erhalten, melde dich bei Miro an.
- Für die Integration auf Teamebene gehst du zu Team-Einstellungen > Apps & Integrationen > Jira-Karten.
- Für die Integration auf Unternehmensebene gehst du zu Einstellungen des Unternehmens > Apps > Apps verwalten > Jira-Karten > Einstellungen.
Wenn du Jira-Karten nicht in deiner Apps-Liste hast, scrolle zum Anfang des Abschnitts, klicke auf Apps installieren und fahre fort, die App vom Miro Marketplace zu installieren. Wenn du die Jira-Karte in der Liste siehst, klicke darauf, um sie zu öffnen.
Der Tab "Plugin" wird geöffnet und du kannst Schritt 1 sehen, um die benötigten Werte zu erhalten:Jira-Karten Werte
Kopiere die Werte und füge sie dem Atlassian Review Link Menü hinzu.
- Du wirst für einen oder zwei Momente die Verarbeitungsmeldung sehen:
Der letzte Schritt der Linkerstellung
Damit sind alle Schritte, die auf der Seite von Atlassian durchgeführt werden müssen, abgeschlossen. Der Link erscheint in der Liste deiner Anwendungslinks.
Schritt 2: Verbindung
Gehe zurück zu deinen Jira-Karteneinstellungen in Miro und wähle eine der folgenden Optionen aus: „Einen Webhook manuell erstellen“ oder „Einen Webhook automatisch erstellen“. Wenn du „manuell“ auswählst, deaktiviere die Option. Weitere Informationen findest du in diesem Artikel/span>. Wir empfehlen dringend, den WebHook zu verwenden, damit du ihn bei großen Updates des Plugins nicht zurücksetzen musst.
Zum Schluss gibst du deine Jira-URL ein und klickst auf Verbinden:
Jira-Karten miteinander verbinden
Um die Jira-URL zu erhalten, kopiere die Base-URL deiner Jira-Instanz. Wir akzeptieren folgende Formate:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Falls deine Jira-URL nicht akzeptiert wird, lies bitte diesen Artikel. Bitte stelle außerdem sicher, dass Miro ausreichend Zugriff auf dein Jira-Konto hat, um die Verbindung herstellen zu können.
Jetzt hast du deine Jira-Instanz mit deinem Miro-Team verbunden.
⚠️ Während Atlassian den Support für Jira Server im Februar 2024 eingestellt hat, wird Miro die Integration von Jira Karten für Jira Server auf absehbare Zeit weiter unterstützen.
- Gehe zu https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Wenn „Anwendunglinks“ nicht ausgewählt ist, klicke es bitte an.
Jira Server App-Links
- Klicke auf Link erstellen. Wähle „Atlassian-Produkt“ aus und gib die Anwendungs-URL „https://miro.com“ ein. Klicke auf Weiter.
Konfigurieren der URL der App
- Du wirst zum Dialogfeld „Link-Anwendungen“ weitergeleitet. Gib einen Anwendungsnamen ein (z. B. Jira-Karte für Miro) und wähle als Anwendungstyp „Generische Anwendung“ aus.
Unter „Du erstellst einen Link von:“ solltest du nun die URL der Jira-Anwendung sehen und unter „Zu dieser Anwendung:“ sollte https://miro.com angezeigt werden. Klicke auf Weiter.jira_server_link_applicationsDetails zur Konfiguration der Link-Anwendungen
- Die Link-Konfiguration wird verarbeitet. Wenn der Prozess abgeschlossen ist, findest du deinen neuen Link auf dem Jira-Server, unter „Anwendungslinks“.
Deine konfigurierte App im Jira Server
- Nun musst du noch die Informationen zu deiner Anwendung festlegen. Klicke zum Bearbeiten der Anwendungsinformationen auf das Bleistiftsymbol deiner Anwendung.
- Klicke im Dialogfeld „Konfigurieren“ auf die Option Eingehende Authentifizierung . Gib den API-Schlüssel, den API-Namen, den Public Key und optional eine Beschreibung ein.
- Für die Integration auf Teamebene sind diese Informationen verfügbar unter Team-Einstellungen > Apps & Integrationen > Jira-Karten.
- Für die Integration auf Organisationsebene sind diese Informationen verfügbar unter Einstellungen im Unternehmen > Apps > Apps verwalten > Jira-Karten > Einstellungen.
Details zur eingehenden Authentifizierung im Jira Server konfigurieren
Jira App Link Details in Miro
-
Scrolle bis zum Ende der Optionen für die „Eingehende Authentifizierung“ und klicke auf Speichern. Dein Verifizierungsstatus sollte nun bestätigt sein, und dieser Jira-Server kann ab sofort innerhalb von Miro für die Verwendung mit Jira-Karten genutzt werden. Achte darauf, dass du auf der Miro-Seite "Jira Server" und "OAuth 1.0" auswählst.
jira_server_welcome_to_jira
Autorisierung von Personen
Nachdem die Integration verbunden wurde, muss jede Person ihr persönliches Jira-Profil verbinden, um die richtigen Berechtigungen einzurichten. Dadurch wird sichergestellt, dass jeder Zugriff auf der Miro-Seite genau der gleiche ist wie bei deiner Jira-Instanz. Wenn Personen zum ersten Mal versuchen, eine Jira-Karte zu importieren oder zu bearbeiten, werden sie aufgefordert, sich mit ihren individuellen Zugangsdaten bei Jira anzumelden.
Danach können sie Aufgaben als Karten auf dem Whiteboard hinzufügen. Alle Änderungen, die in Jira vorgenommen wurden, werden auch in den Jira-Karten auf dem Board angezeigt.
✏️ Wenn eine Person keine Jira-Anmeldeinformationen, aber Zugriff auf das Board hat, auf dem die Karte hinzugefügt wurde, sieht sie den Namen der Karte, die Art des Problems, die Priorität, die zugewiesene Person und alle Attribute, die auf der Jira-Karte angezeigt werden. Allerdings können sie die Karte nicht erweitern, um weitere Attribute zu sehen und sie zu bearbeiten, es sei denn, dies wurde autorisiert. Wenn die Person ihre Jira-Anmeldeinformationen nicht verbindet, wird der Avatar der zugewiesenen Person nicht angezeigt und die Karte sieht ganz allgemein anders aus.
Verwendung einer Jira-Instanz für mehrere Miro-Teams
Du kannst Karten auf Team- oder auf Organisationsebene installieren. Wenn du mehrere Teams hast, kannst du die Einstellungen auf Organisationsebene nutzen, damit du die Einrichtung nicht für jedes Team wiederholen musst. Der bestehende App-Link wird für alle Teams verwendet.
Nachdem du dein Team oder deine Organisation mit einer Jira-Instanz verbunden hast, wird in deinen Jira WebHooks ein neuer WebHook für dieses Miro-Team oder diese Organisation erstellt. Durch das Erstellen eines WebHooks wird ein Kanal für Aktualisierungsanfragen eingerichtet.
Wenn du Einstellungen auf Organisationsebene festlegst, behalten Teams, die bereits verbunden sind, ihre aktuellen Einstellungen bei. Sie können jedoch jederzeit zu den Einstellungen auf Organisationsebene wechseln.
Außerdem können Teams bei Bedarf die Einstellungen auf Organisationsebene außer Kraft setzen, um sich mit einer anderen Jira-Instanz zu verbinden.
Wenn du ein Enterprise-Kunde bist, der mehrere Verbindungen auf Teamebene in die Standardverbindung auf Organisationsebene migrieren möchte, wende dich an dein Konto-Team.
⚠️ Wenn du mehrere Teams separat verbinden willst, empfehlen wir, dem Webhook für jedes Team einen eigenen Namen zu geben. Gehe zu deiner Jira WebHooks-Seite und bearbeite jeden neu erstellten Webhook.
Die Verbindung mehrerer Jira-Instanzen mit einem Miro-Team wird nicht unterstützt.
Deaktivieren des Plugins
Für die Integration auf Teamebene gehst du zu Teameinstellungen > Apps & Integrationen > Jira-Karten. Wähle dann Für Team entfernen.
Für die Integration auf Unternehmensebene kannst du die Nutzung von Jira-Apps einschränken, indem du zu Unternehmenseinstellungen > Apps > Apps verwalten > Jira-Karten gehst. Stelle dann den Kippschalter in die Aus-Position.
⚠️ Wenn du Jira für die Organisation deaktivierst, können Nutzer aus allen Enterprise Teams keine Jira-Karten verwenden. Mehr über die App-Verwaltung und die Beschränkung von Apps erfährst du unter App-Verwaltung.
Weitere Informationen: Siehe Wie man Jira-Karten verwendet.