Konfigurieren von Adobe Workfront for Jira
Sie können Adobe Workfront for Jira verwenden, um Ihre Jira- und Workfront zu integrieren.
Nach der Installation des Add-ons können Sie Workflows definieren, die beim Erstellen von Jira automatisch Workfront Probleme verursachen. Die Elemente in beiden Anwendungen werden verknüpft, und einige ihrer Informationen werden automatisch in beiden Systemen aktualisiert.
Von dieser Integration können alle Anwender in Workfront und Jira profitieren. Sie benötigen lediglich eine Lizenz für das System, in dem sie am meisten arbeiten, und nicht für beide Systeme.
Dieses Add-on ist sowohl für die Server- als auch für OnDemand-Versionen (oder Cloud) Jira Software verfügbar.
Eine Liste der Jira Versionen, die Workfront for Jira derzeit unterstützt, finden Sie unter Workfront for Jira auf der Atlassian Marketplace.
Zugriffsanforderungen
Sie müssen über Folgendes verfügen:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront Plan |
Neu: Beliebig oder Aktuell: Pro oder höher |
| Adobe Workfront Lizenz |
Neu: Standard oder Aktuell: Plan |
| Jira Zugriff |
Systemadministratorzugriff Wichtig: Es wird empfohlen, separate Systemadministratorkonten in Jira und Workfront zu erstellen, um diese Integration zu ermöglichen, anstatt vorhandene Konten zu verwenden, die an Benutzer angehängt sein könnten. |
| Konfigurationen der Zugriffsebene | Sie müssen Workfront sein. |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation zu Workfront.
Voraussetzungen
Bevor Sie Workfront for Jira konfigurieren können, müssen Sie:
- Installieren Sie Workfront for Jira.
Anweisungen zur Installation von Workfront for Jira finden Sie unter Installieren Adobe Workfront for Jira.
Konfigurieren von Workfront for Jira
Durch die Konfiguration von Workfront for Jira haben Sie folgende Möglichkeiten:
- Trigger definieren, die Jira Elemente erstellen, wenn Workfront Elemente erstellt werden.
- Geben Sie an, welche Felder zwischen Elementen synchronisiert werden sollen, die zwischen Jira und Workfront verknüpft sind.
- Nachdem Sie Workfront for Jira in Ihrer Jira konfiguriert haben, wird allen Jira Benutzern ein Workfront rechter Bereich für alle Jira Elemente angezeigt. Das Bedienfeld enthält Informationen zu den Elementen, die von Workfront aus verknüpft werden können, oder gibt an, dass keine Workfront Elemente mit Jira Elementen verknüpft sind.
- Bei Verwendung der Jira Server-Installation wird das Bedienfeld Workfront nur für Probleme angezeigt, die mit Projekten verbunden sind, die als Trigger für die Workfront-Integration identifiziert wurden. Weitere Informationen zum Einrichten von Triggern für den Workfront to Jira-Workflow finden Sie unter Konfigurieren von Triggern für die automatische Verknüpfung von Elementen zwischen Jira und Workfront.
So konfigurieren Sie Workfront for Jira:
-
Melden Sie sich bei Jira als Jira an.
-
Klicken Sie Hauptmenü auf EinstellungenJira.
-
Klicken Sie Add-ons und dann auf Add-ons verwalten.
-
Erweitern Sie das Add-on Workfront .
-
Klicken Sie Konfigurieren.
-
Befolgen Sie die Anweisungen, um sich bei Workfront anzumelden.
note note NOTE Die Benutzerin bzw. der Benutzer muss über eine gültige apiKeyin Workfront verfügen, um eine erfolgreiche Verbindung herzustellen.Sie müssen sich bei Workfront als Workfront anmelden, um die Konfiguration fortzusetzen.
note note NOTE - Workfront stellt mithilfe von OAuth 2.0 eine Verbindung zu Jira her. Dies ist ein Standard, der von den meisten Web-basierten Integrationen zur Authentifizierung und Autorisierung von Benutzern verwendet wird.
- Wenn Sie aufgefordert werden, die Domain Ihres Workfront Kontos einzugeben, geben Sie sie in folgendem Format ein: yourCompany'sDomain.my.workfront.com. Die Domain Ihres Unternehmens ist normalerweise der Name Ihres Unternehmens.
- Die erweiterte Authentifizierung ist erst verfügbar, wenn sie von einem Workfront-Administrator für diese Integration aktiviert wurde.
-
Wählen Sie in Jira die Registerkarte Trigger aus, um die automatische Erstellung Jira Elemente zu konfigurieren, wenn neue Workfront erstellt werden.
Weitere Informationen zum Einrichten von Triggern für den Workflow "Workfront to Jira" finden Sie unter Konfigurieren von Triggern für die automatische Verknüpfung von Elementen zwischen Jira und Workfront.
-
Wählen Sie die Setup, um die Synchronisierung von Feldern zwischen verknüpften Jira und Workfront zu konfigurieren.
Weitere Informationen zum Einrichten der Feldsynchronisierung zwischen Jira und Workfront finden Sie unter Konfigurieren der Feldsynchronisierung zwischen Jira und Workfront Elementen.
note note NOTE Nachdem Sie die Trigger und die Synchronisierung von Feldern zwischen den beiden Anwendungen definiert haben, kann jeder Workfront, der Aufgaben oder Probleme erstellen kann, möglicherweise Trigger bei der Erstellung eines Elements in Jira verursachen. Der/die Benutzende kann ein Element erstellen, wenn die Kriterien des von ihm/ihr erstellten Elements mit den Triggern in Jira übereinstimmen, auch wenn der/die Benutzende keine Jira hat. Außerdem kann jeder Jira Benutzer sofort mit der Arbeit am Jira beginnen, und seine Aktualisierungen sind in Workfront sichtbar, ohne dass er über eine Workfront-Lizenz verfügt. Alle Aktualisierungen in Workfront sind auch in den Jira Elementen sichtbar. -
(Optional) Wählen Sie die Registerkarte Aktivitätsprotokoll, um alle Fehler zu überprüfen, die während der Integration aufgetreten sein könnten.
Weitere Informationen zum Aktivitätsprotokoll finden Sie unter Anzeigen Jira Aktivitätsprotokolls.
Konfigurieren von Triggern für die automatische Verknüpfung von Elementen zwischen Jira und Workfront
Als Jira können Sie Trigger definieren, die automatisch Probleme in Jira verursachen, wenn ein Element in Workfront bestimmte Kriterien erfüllt.
Beachten Sie beim Konfigurieren des Auslösers für die Erstellung von Jira beim Erstellen Workfront Elemente Folgendes:
- Trigger Die Integration ist unidirektional: Sie können nur Elemente, die Sie in erstellen, Workfront automatisch in Jira erstellt werden. Sie können Elemente, die Sie in erstellen, nicht Jira, dass sie automatisch in Workfront erstellt werden, in Trigger setzen.
- Es gibt keine Begrenzung dafür, wie viele Trigger Sie haben können.
- Wenn ein Element, das Sie in Workfront erstellen, mit mehr als einem der Trigger übereinstimmt, wird nur ein Element in Jira erstellt. Das Element wird in Jira gemäß dem ersten Trigger erstellt (in der Reihenfolge, in der sie in Jira definiert wurden). Alle anderen Trigger werden ignoriert.
- Nur ein Element in Workfront kann mit einem Element in Jira verknüpft werden. Sie können niemals ein Workfront mit mehreren Jira oder ein Jira mit mehreren Workfront verknüpfen.
So konfigurieren Sie Trigger für die automatische Erstellung von Elementen in Jira:
-
Melden Sie sich bei Jira als Systemadministrator an.
-
Klicken Sie Hauptmenü auf EinstellungenJira.
-
Klicken Sie Add-ons und dann Add-ons verwalten.
-
Erweitern Sie das Add-on Workfront .
-
Klicken Sie Konfigurieren.
-
Melden Sie sich bei Workfront als Systemadministrator an.
Die Registerkarte Trigger" ist in Jira standardmäßig ausgewählt.
-
Klicken Sie Trigger hinzufügen, um einen neuen Trigger hinzuzufügen.
-
Geben Sie im Feld Workfront-Team/Benutzer/Rolle den Namen eines Workfront-Teams, eines Benutzers oder eines Aufgabengebiets an und klicken Sie dann auf das gewünschte Team, um es auszuwählen, wenn es in der Liste angezeigt wird.
note note NOTE Sie können nicht mehrere Trigger für dasselbe Team, denselben Benutzer oder dieselbe Rolle haben. Wenn jemand eine Aufgabe oder ein Problem erstellt und sie bzw. es einer dieser Entitäten zuweist, wird in Jira automatisch ein Problem erstellt.
-
Beginnen Sie im Feld JiraProjekt mit der Eingabe des Namens eines Jira Projekts und klicken Sie dann, um es auszuwählen, wenn es in der Liste angezeigt wird.
Wenn das Jira Problem erstellt wird, wird es in dem hier ausgewählten Projekt platziert.
-
Wählen Sie DropdownMenü einen Problemtyp) aus.
Dies zeigt den Problemtyp an, der in Jira erstellt wird, wenn die Bedingungen dieses Triggers erfüllt sind, und zwar basierend auf Ihren Einstellungen für dieses spezifische Projekt in Jira.
-
Klicken Sie auf Speichern.
Mit dieser Konfiguration wird jedes Mal, wenn ein Workfront ein Element erstellt, das den angegebenen Triggern entspricht, ein neues Problem in Jira erstellt.
Konfigurieren der Feldsynchronisierung zwischen Jira und Workfront Elementen
Als Jira können Sie festlegen, welche Felder automatisch für Elemente synchronisiert werden sollen, die zwischen Workfront und Jira verknüpft sind. Bestimmte Felder können vom Workfront zum Jira synchronisiert werden, andere können von Jira zu Workfront synchronisiert werden.
So definieren Sie, welche Felder automatisch für Elemente synchronisiert werden sollen, die zwischen den beiden Anwendungen verknüpft sind:
-
Melden Sie sich bei Jira als Jira-Administrator an.
-
Klicken Sie Hauptmenü auf EinstellungenJira.
-
Klicken Sie Add-ons und dann Add-ons verwalten.
-
Erweitern Sie das Add-on Workfront .
-
Klicken Sie Konfigurieren.
-
Melden Sie sich bei Workfront als Workfront-Administrator an.
-
Klicken Sie in Jira auf die Registerkarte Setup.
-
Wählen im Abschnitt „Synchronisieren von Workfront mit Jira die Felder aus, die Sie in Jira aktualisieren möchten, wenn sie in Workfront aktualisiert werden.
-
Wählen Sie eine der folgenden Frequenzen, mit denen die Felder synchronisiert werden sollen:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header bei Erstellung Die angegebenen Felder werden zwischen den verknüpften Workfront- und Jira-Elementen synchronisiert, wenn das Element in Workfront erstellt wird. Immer Die angegebenen Felder werden zwischen den verknüpften Workfront- und Jira-Elementen synchronisiert, wenn die Felder in Workfront aktualisiert werden. Never Die angegebenen Felder werden nie zwischen den verknüpften Workfront und Jira Elementen synchronisiert. In Jira gibt es keinen Hinweis darauf, dass das Feld in Workfront aktualisiert wurde. -
Wählen Sie eine der folgenden Optionen aus, um die Felder von Workfront nach Jira zu synchronisieren:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Name Der Name einer Aufgabe oder eines Problems in Workfront wird zum Namen des Problems, mit dem es bzw. es in Jira verknüpft ist.
Hinweis: Wenn neue Elemente in Jira automatisch erstellt werden, wird der Workfront immer für das Jira Element aktualisiert, unabhängig davon, ob dieses Feld hier aktiviert ist oder nicht. Wenn ein Jira Element manuell mit einem Workfront Element verknüpft wird, wird der Name des Workfront Elements nur in Jira aktualisiert, wenn Sie dieses Feld Immer synchronisieren. Weitere Informationen zum manuellen oder automatischen Verknüpfen von Elementen finden Sie unter Verknüpfen von Elementen zwischen Adobe Workfront und Jira.
Beschreibung Die Beschreibung einer Aufgabe oder eines Problems in Workfront wird zur Beschreibung des Problems, mit dem es bzw. es in Jira verknüpft ist. Dokumente Dokumente, die an eine Aufgabe oder ein Problem in Workfront angehängt sind, sind auch an das Problem angehängt, mit dem es in Jira verknüpft ist. Neue Dokumentversionen von Workfront werden Jira als separate Dokumente hinzugefügt und mit _v<Versionsnummer> angehängt, um die nummerierte Version in Workfront anzugeben.
Wenn beispielsweise der Name eines Dokuments in Workfront "" lautet Sie ihm in Workfront eine neue Version hinzufügen, wird die neue Version als neues Dokument mit dem Namen "Jira" in übertragen.
Wichtig:
Beachten Sie beim Synchronisieren von Dokumenten Folgendes:
-
Dokumente mit mehr als 5 MB werden nicht synchronisiert. Wenn die Synchronisierung eines Dokuments fehlschlägt, weil das Dokument zu groß ist, wird ein Fehler im Aktivitätsprotokoll protokolliert.
Weitere Informationen zum Aktivitätsprotokoll finden Sie unter Jira-Aktivitätsprotokoll anzeigen.
-
Dokumente, die mit Aufgaben und Problemen von externen Servern verknüpft sind, werden nicht an die Jira Elemente übertragen. Nur Dokumente, die direkt auf die Aufgabe oder das Problem in Workfront hochgeladen werden, werden auf die verknüpfte Anfrage in Jira übertragen.
-
Um einen Korrekturabzug aus einem Dokument zu erstellen, müssen Sie den Korrekturabzug in Workfront generieren.
Weitere Informationen zum Erstellen eines Korrekturabzugs finden Sie unter Erstellen eines Korrekturabzugs für ein vorhandenes Dokumentin Erstellen eines Korrekturabzugs für ein Dokument.
Geplantes Abschlussdatum Das Geplantes Abschlussdatum einer Aufgabe oder eines Problems in Workfront wird zum Fälligkeitsdatum des Problems, mit dem es in Jira verknüpft ist.
Hinweis: Stellen Sie sicher, dass bei Problemen Due DateJira angezeigt wird, damit dieser Wert synchronisiert werden kann.
-
-
-
Wählen im Abschnitt „Synchronisieren von Jira nachWorkfront" die Felder aus, die Sie in Workfront aktualisieren möchten, wenn sie in Jira aktualisiert werden.
-
Wählen Sie eine der folgenden Frequenzen, mit denen die Felder synchronisiert werden sollen:
table 0-row-2 1-row-2 layout-auto html-authored no-header Immer Die angegebenen Felder werden immer zwischen den verknüpften Workfront und Jira Elementen synchronisiert, wenn die Felder in Jira aktualisiert werden. Never Die angegebenen Felder werden nie zwischen den verknüpften Workfront und Jira Elementen synchronisiert. In Workfront gibt es keinen Hinweis darauf, dass das Feld in Jira aktualisiert wurde.
Hinweis: Wenn Sie Nie auswählen, können Workfront Felder weiterhin manuell aus Jira im linken Workfront des Jira aktualisiert werden. Diese Aktualisierungen werden nur für Workfront Elemente in Jira und Workfront und nicht für Jira Elemente angezeigt.
-
Wählen Sie diese Option aus, um eines der folgenden Felder von Jira nach Workfront zu synchronisieren:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Status Der Status eines Problems in Jira wird zum Status der Aufgabe oder des Problems, mit der bzw. dem es in Workfront verknüpft ist.
Weitere Informationen zum Workfront finden Sie unter Erstellen oder Bearbeiten eines Status.Bevollmächtigter Der Bevollmächtigte eines Problems in Jira wird zum Bevollmächtigten der Aufgabe oder des Problems, mit der bzw. dem es in Workfront verknüpft ist.
Wichtig: Wenn Sie einem Benutzer, der kein Jira Konto hat, ein Element in Workfront zuweisen, erstellt die Integration nur dann einen neuen aktiven Benutzer in Workfront, wenn Automatisch einen Benutzer in Workfront erstellen, wenn der Jira Benutzer kein Workfront Konto hat auf Always gesetzt ist. Dieser Benutzer ist nicht im Besitz einer Workfront. Aktive Benutzende können Arbeitselementen in Workfront zugewiesen werden, können jedoch nicht in Aktualisierungen eingeschlossen werden.
Anlagen Anlagen eines Problems in Jira sind auch an die Aufgabe oder das Problem angehängt, mit der bzw. dem es in Workfront verknüpft ist. Kommentare Ein Kommentar zu einem Jira Problem wird auch über das verknüpfte Workfront im Bereich Updates veröffentlicht. Umgekehrt wird ein Kommentar, der im Bereich Aktualisiert für eine Workfront Aufgabe oder ein Problem gepostet wird, mit dem nativen Kommentar-Stream von Jira für das verknüpfte Problem synchronisiert.
Standardmäßig ist dies auf Always festgelegt. Wenn Sie hier Never auswählen, können Sie dennoch manuell Kommentare zu einem verknüpften Element entweder in Workfront oder in Jira posten.
-
-
Wählen Sie im Abschnitt SONSTIGE aus, welche zusätzlichen Felder zwischen verknüpften Elementen aktualisiert werden sollen.
-
Wählen Sie eine Option aus, um festzulegen, ob die von Ihnen angegebenen Felder Immer oder Nie in Jira oder Workfront aktualisiert werden sollen, wenn sie geändert werden.
-
Wählen Sie aus den folgenden Feldern und Aktualisierungen aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Workfront Benutzerdefinierte Daten im rechten Bedienfeld in Jira kopieren Zeigt die Workfront benutzerdefinierten Daten eines Elements im Workfront rechten Bedienfeld an.
Hinweis: Benutzerdefinierte Formularabschnitte werden im rechten Workfront Bereich mit der Zugriffsebene des Workfront angezeigt.
Workfront Priorität im rechten Bedienfeld in Jira kopieren Zeigt die Workfront eines Elements im Workfront rechten Bedienfeld an. Fügen Sie auf der Registerkarte Workfront-Updates eine Aktualisierung zu den Änderungen des Fälligkeitsdatums in Jira hinzu Fügt einen Kommentar in die Registerkarte Update des Workfront ein, wenn sich das Due Date im verknüpften Jira ändert. Automatisches Erstellen eines Benutzers in Workfront, wenn der Jira Benutzer kein Workfront Konto hat Die folgenden Szenarien sind vorhanden:
-
Wenn Sie Always auswählen, aktivieren Sie die Integration so, dass jedes Mal, wenn ein Jira ohne Workfront-Konto die folgenden Aktionen für ein verknüpftes Jira ausführt, ein neuer Workfront-Benutzer erstellt wird:
-
Ist einem Jira Problem zugewiesen
-
Protokolliert die Zeit für ein Jira Problem
Dieser neue Benutzer ist nicht im Besitz einer Workfront. Die Standardeinstellung ist Immer . Dem auf diese Weise in erstellten Benutzer wurde Workfront "Jira" hinzugefügt.
-
-
Wenn Sie Never auswählen, passiert Folgendes:
- Es werden keine Jira Zuweisungen für die Workfront Elemente angezeigt. In diesem Fall werden in Workfront nur Zuweisungen auf den Workfront Elementen angezeigt.
- Die Zeit, die ein Benutzer ohne ein Jira-Konto für ein verknüpftes Workfront-Problem protokolliert hat, wird nicht automatisch auf das verknüpfte Workfront-Element übertragen. Sie können weiterhin Zeit für das Workfront Element im rechten Bedienfeld des Jira Problems protokollieren.
-
-
-
Klicken Sie auf Speichern.
Jedes Mal, wenn ein Benutzer eines der in dieser Konfiguration für ein Element in Jira oder Workfront angegebenen Felder aktualisiert, wird jetzt auch das verknüpfte Element in der anderen Anwendung aktualisiert.
Fehlerbehebung
Elemente können in Jira nicht erstellt werden, da Trigger-Felder mit der Kennzeichnung " nicht gefunden "
Problem
Wenn bei der Workfront for Jira Anwendung ein Fehler auftritt, deaktiviert Workfront die Trigger, um weitere Komplikationen zu vermeiden. Wenn diese Trigger deaktiviert sind, werden sie als " nicht gefunden“ .
Lösung
Suchen Sie den Fehler, der die Trigger deaktiviert hat. Den Fehler finden Sie im Workfront for Jira Aktivitätsprotokoll.
Die häufigste Ursache für dieses Verhalten ist der Fehler "Feld 'duedate' kann nicht festgelegt werden. Es ist nicht auf dem entsprechenden Bildschirm oder unbekannt."
Dieser Fehler bedeutet, dass Sie versuchen, das " Abschlussdatum“ von Workfront nach Jira zu synchronisieren. Dazu müssen Sie sicherstellen, dass Ihre Jira ein Feld namens „Fälligkeitsdatum aufweisen. Wenn dieses Feld nicht vorhanden ist, kann Workfront das geplante Abschlussdatum nicht mit Workfront synchronisieren und deaktiviert Ihre Trigger.
Um diesen Fehler zu beheben, führen Sie einen der folgenden Schritte aus:
- Bitten Sie Ihren Jira, die betroffenen Jira zu aktualisieren, um sicherzustellen, dass sie ein Feld für das Fälligkeitsdatum haben.
- Deaktivieren Sie die Synchronisierung des geplanten Abschlussdatums von Workfront auf der Seite „Setup von Workfront.