Configureren Adobe Workfront for Jira
Gemaakt voor:
- Gebruiker
Met Adobe Workfront for Jira kunt u uw Jira - en Workfront -systemen integreren.
Nadat u de invoegtoepassing hebt geïnstalleerd, kunt u workflows definiëren waarmee automatisch Jira -problemen worden gemaakt wanneer Workfront -werkitems worden gemaakt. De items in beide toepassingen worden gekoppeld en sommige van de gegevens worden automatisch bijgewerkt in beide systemen.
Alle gebruikers in Workfront en Jira kunnen van deze integratie profiteren. Ze hebben alleen een licentie nodig voor het systeem waarin ze het meest werken, en niet voor beide systemen.
Deze invoegtoepassing is beschikbaar voor zowel de Server - als de OnDemand -versie (of Cloud -versie) van Jira Software.
Zie Workfront for Jiraop de website Atlassian Marketplace voor een lijst met Jira versies die Workfront for Jira momenteel ondersteunt.
Toegangsvereisten
Breid uit om de toegangseisen voor de functionaliteit in dit artikel weer te geven.
U moet het volgende hebben:
Adobe Workfront plan |
Nieuw: alle of Huidig: Pro of hoger |
Adobe Workfront licentie |
Nieuw: Standard of Huidig: Plan |
Jira toegang |
Toegang tot systeembeheerder Belangrijk: we raden u aan aparte systeembeheerdersaccounts te maken in Jira en Workfront om deze integratie te bevorderen in plaats van bestaande accounts te gebruiken die aan gebruikers kunnen worden gekoppeld. |
Configuraties op toegangsniveau | U moet een Workfront beheerder zijn. |
Voor meer detail over de informatie in deze lijst, zie vereisten van de Toegang in de documentatie van Workfront.
Vereisten
Voordat u Workfront for Jira kunt configureren, moet u:
- Installeer Workfront for Jira .
Voor instructies bij het installeren van Workfront for Jira, zie installeren Adobe Workfront for Jira.
Configureren Workfront for Jira
Door Workfront for Jira te configureren, kunt u:
- Definieer triggers die Jira -items maken wanneer Workfront -items worden gemaakt.
- Geef op welke velden moeten worden gesynchroniseerd tussen items die zijn gekoppeld tussen Jira en Workfront .
- Nadat u Workfront for Jira hebt geconfigureerd in uw Jira -omgeving, zien alle Jira -gebruikers een Workfront rechterdeelvenster op alle Jira -items. Het deelvenster bevat informatie over de items die kunnen worden gekoppeld vanuit Workfront of geeft op dat er geen Workfront -items zijn gekoppeld aan Jira -items.
- Wanneer u de Jira Server -installatie gebruikt, wordt alleen het Workfront-deelvenster weergegeven voor de problemen die worden geassocieerd met projecten die zijn geïdentificeerd als triggers voor de Workfront-integratie. Voor meer informatie over vestiging trekkers voor het Workfront to Jira werkschema, zie trekkers voor het automatisch verbinden van punten tussen Jira en Workfront vormen.
Om Workfront for Jira te configureren:
-
Meld u aan bij Jira als Jira -beheerder.
-
Klik op Settings in het hoofdmenu Jira .
-
Klik op Add-ons en vervolgens op Manage add-ons .
-
Vouw de invoegtoepassing Workfront uit.
-
Klik op Configure.
-
Volg de aanwijzingen om u aan te melden bij Workfront .
NOTE
De gebruiker moet een geldigeapiKey
in Workfront hebben om een verbinding tot stand te brengen.U moet zich aanmelden bij Workfront als Workfront -beheerder om de configuratie voort te zetten.
NOTE
- Workfront maakt verbinding met Jira via OAuth 2.0, een standaard die door de meeste webgebaseerde integraties wordt gebruikt voor de verificatie en autorisatie van gebruikers.
- Wanneer u wordt ertoe aangezet om het domein van uw Workfront rekening in te gaan, typ het gebruikend dit formaat: yourCompany'sDomain.my.workfront.com. Het domein van uw bedrijf is gewoonlijk de naam van uw bedrijf.
- Verbeterde verificatie is pas beschikbaar als een Workfront -beheerder deze heeft ingeschakeld voor deze integratie.
-
Selecteer in Jira het tabblad Triggers om het automatisch maken van Jira items te configureren als er nieuwe Workfront -items worden gemaakt.
Voor meer informatie over vestiging trekkers voor Workfront aan Jira werkschema, zie trekkers voor automatisch het verbinden van punten tussen Jira en Workfront vormen.
-
Selecteer het tabblad Setup om de synchronisatie van velden tussen gekoppelde Jira - en Workfront -items te configureren.
Voor meer informatie over vestiging de synchronisatie van gebieden tussen Jira en Workfront, zie gebiedssynchronisatie tussen Jira en Workfront Puntenvormen.
NOTE
Nadat u de triggers en de synchronisatie van velden tussen de twee toepassingen hebt gedefinieerd, kan elke Workfront -gebruiker die taken of problemen kan maken, mogelijk een item maken in Jira . De gebruiker kan een item maken als de criteria voor het item dat hij of zij maakt, overeenkomen met de triggers in Jira , zelfs als de gebruiker geen Jira -licentie heeft. Bovendien kan elke gebruiker van Jira direct aan het Jira -item beginnen te werken en zijn de updates ervan zichtbaar in Workfront zonder een Workfront -licentie. Alle updates in Workfront zijn ook zichtbaar op de Jira -items. -
(Optioneel) Selecteer het tabblad Activity Log om eventuele fouten te controleren die tijdens de integratie zijn opgetreden.
Voor meer informatie over Activity Log, zie Mening Jira Activity Log.
triggers configureren voor het automatisch koppelen van items tussen Jira en Workfront
Als systeembeheerder van Jira kunt u triggers definiëren die automatisch problemen veroorzaken in Jira wanneer een item in Workfront aan bepaalde criteria voldoet.
Houd rekening met het volgende wanneer u het maken van Jira -items activeert terwijl Workfront -items worden gemaakt:
- De integratie verloopt in één richting: u kunt alleen items die u maakt in Workfront, activeren en automatisch maken in Jira . U kunt items die u maakt in Jira niet automatisch laten activeren in Workfront .
- Er is geen limiet voor het aantal triggers dat u kunt gebruiken.
- Als een item dat u maakt in Workfront overeenkomt met meerdere triggers, wordt er slechts één item gemaakt in Jira . Het item wordt gemaakt in Jira op basis van de eerste trigger (in de volgorde waarin deze zijn gedefinieerd in Jira ). Alle andere triggers worden genegeerd.
- Er kan slechts één item in Workfront worden gekoppeld aan één item in Jira. U kunt één Workfront -item nooit koppelen aan meerdere Jira -problemen of één Jira -uitgave aan meerdere Workfront -items.
triggers configureren voor het automatisch maken van items in Jira :
-
Meld u aan bij Jira als systeembeheerder.
-
Klik op Settings in het hoofdmenu Jira .
-
Klik op Add-ons en vervolgens op Manage add-ons .
-
Vouw de invoegtoepassing Workfront uit.
-
Klik op Configure.
-
Meld u aan bij Workfront als systeembeheerder.
Het tabblad Triggers is standaard geselecteerd in Jira.
-
Klik op Add trigger om een nieuwe trigger toe te voegen.
-
Geef in het veld Workfront team/user/role de naam van een Workfront -team, -gebruiker of -taakrol op en klik om deze te selecteren wanneer deze in de lijst wordt weergegeven.
NOTE
U kunt geen veelvoudige trekkers voor het zelfde team, de gebruiker, of de rol hebben.Wanneer iemand een taak of een uitgave maakt en deze aan een van deze entiteiten toewijst, wordt automatisch een uitgave gemaakt in Jira.
-
Typ in het veld Jira project de naam van een Jira -project en klik om het te selecteren wanneer het in de lijst wordt weergegeven.
Wanneer de Jira -uitgave wordt gemaakt, wordt deze geplaatst in het project dat u hier hebt gekozen.
-
Selecteer een Issue type van het drop-down menu.
Dit geeft het type uitgave aan dat wordt gemaakt in Jira wanneer aan de voorwaarden van deze trigger wordt voldaan, op basis van uw instellingen voor dat specifieke project in Jira .
-
Klik op Save.
Met deze configuratie wordt telkens wanneer een Workfront -gebruiker een item maakt dat overeenkomt met de opgegeven triggers, een nieuwe uitgave gemaakt in Jira .
Veldsynchronisatie configureren tussen Jira en Workfront Items
Als beheerder Jira kunt u bepalen welke velden automatisch moeten worden gesynchroniseerd voor items die zijn gekoppeld tussen Workfront en Jira. Bepaalde velden kunnen worden gesynchroniseerd van het item Workfront naar het item Jira en andere velden kunnen worden gesynchroniseerd van Jira naar Workfront.
Om te bepalen welke gebieden automatisch op punten zouden moeten synchroniseren die tussen de twee toepassingen worden verbonden:
-
Meld u aan bij Jira als Jira-beheerder.
-
Klik op Settings in het hoofdmenu Jira .
-
Klik op Add-ons en vervolgens op Manage add-ons .
-
Vouw de invoegtoepassing Workfront uit.
-
Klik op Configure.
-
Meld u aan bij Workfront als Workfront-beheerder.
-
Klik in Jira op de tab Setup .
-
Selecteer in de sectie Synchronize from Workfront to Jira de velden die u wilt bijwerken in Jira wanneer deze worden bijgewerkt in Workfront.
-
Selecteer een van de volgende frequenties waarmee de velden worden gesynchroniseerd:
On CreationDe velden die u opgeeft, worden gesynchroniseerd tussen de gekoppelde Workfront- en Jira -items wanneer het item in Workfront wordt gemaakt.AlwaysDe velden die u opgeeft, worden gesynchroniseerd tussen de gekoppelde Workfront- en Jira-items wanneer de velden worden bijgewerkt in Workfront.NeverDe velden die u opgeeft, worden nooit gesynchroniseerd tussen de gekoppelde Workfront - en Jira -items. Er zijn geen aanwijzingen in Jira dat het veld is bijgewerkt in Workfront . -
Selecteer een van de volgende opties om de velden van Workfront tot en met Jira te synchroniseren:
NameDe naam van een taak of een uitgave in Workfront wordt de naam van de uitgave waaraan deze is gekoppeld in Jira .
Opmerking: wanneer nieuwe items automatisch in Jira worden gemaakt, wordt de Workfront naam altijd bijgewerkt op het Jira -item, ongeacht of dit veld hier is ingeschakeld of niet. Wanneer een Jira punt manueel met een Workfront punt wordt verbonden, werkt de Naam van het Workfront punt slechts in Jira bij wanneer u aan selecteert altijd dit gebied synchroniseert. Voor meer informatie over het verbinden van punten manueel of automatisch, zie punten tussen Adobe Workfront en Jira verbinden.
DescriptionDe beschrijving van een taak of een probleem in Workfront wordt de beschrijving van de uitgave waaraan deze is gekoppeld in Jira .DocumentenDocumenten die zijn gekoppeld aan een taak of een uitgave in Workfront , worden ook gekoppeld aan de uitgave waaraan deze is gekoppeld in Jira. De nieuwe documentversies van Workfront worden toegevoegd als afzonderlijke documenten aan Jira en met _v<version number> toegevoegd om op de genummerde versie in Workfront te wijzen.
Bijvoorbeeld, als de naam van een document in Workfront HoofdAdvertentie is, en u een nieuwe versie aan het binnen Workfront toevoegt, wordt de nieuwe versie overgebracht naar Jira als nieuw document met de naam HoofdAd_v2 .
Belangrijk:
Houd rekening met het volgende wanneer u documenten synchroniseert:
-
Documenten groter dan 5 MB worden niet gesynchroniseerd. Als een documentsynchronisatie mislukt omdat het document te groot is, wordt een fout in het activiteitenlogboek geregistreerd.
Voor meer informatie over het activiteitenlogboek, zie Mening het Logboek van de Activiteit van Jira.
-
Documenten die zijn gekoppeld aan taken en uitgaven van externe servers worden niet overgebracht naar de Jira -items. Alleen documenten die rechtstreeks op de taak of de uitgave in Workfront zijn geüpload, worden overgebracht naar de gekoppelde uitgave in Jira .
-
Als u een proefdruk wilt maken op basis van een document, moet u de proefdruk genereren in Workfront .
Voor meer informatie bij het produceren van een proef, zie een proef voor een bestaand documentin creëren een proef voor een document.
Planned Completion DateDe Planned Completion Date van een taak of een uitgave in Workfront wordt de Due Date van de uitgave waaraan deze is gekoppeld in Jira .
Opmerking: zorg ervoor dat u Due Date bij Jira -problemen weergeeft, zodat deze waarde wordt gesynchroniseerd.
-
-
-
Selecteer in de sectie Synchronize from Jira to Workfront de velden die u wilt bijwerken in Workfront wanneer deze worden bijgewerkt in Jira .
-
Selecteer een van de volgende frequenties waarmee de velden worden gesynchroniseerd:
AlwaysDe velden die u opgeeft, worden altijd gesynchroniseerd tussen de gekoppelde Workfront - en Jira -items wanneer de velden worden bijgewerkt in Jira .NeverDe velden die u opgeeft, worden nooit gesynchroniseerd tussen de gekoppelde Workfront - en Jira -items. Er zijn geen aanwijzingen in Workfront dat het veld is bijgewerkt in Jira .
Opmerking: als u Nooit selecteert, kunnen Workfront -velden nog steeds handmatig worden bijgewerkt vanuit Jira in het linkerdeelvenster Workfront van het Jira -probleem. Deze updates worden alleen weergegeven voor Workfront items in Jira en Workfront en niet voor Jira -items.
-
Selecteer deze optie om de volgende velden van Jira tot en met Workfront te synchroniseren:
StatusDe Status van een uitgave in Jira wordt de Status van de taak of uitgave waaraan deze is gekoppeld in Workfront .
voor meer informatie over Workfront statussen, zie een statuscreëren of uitgeven.AssigneeDe Assignee van een uitgave in Jira wordt de Assignee van de taak of uitgave waaraan deze is gekoppeld in Workfront .
Belangrijk: Wanneer u een punt in Jira aan een gebruiker toewijst die geen Workfront rekening heeft, leidt de integratie tot een nieuwe actieve gebruiker in Workfront slechts wanneer automatisch tot een gebruiker in Workfront leidt als de Jira gebruiker geen Workfront rekening aan Always heeft. Deze gebruiker neemt geen Workfront -licentie in. Actieve gebruikers kunnen worden toegewezen aan tijdelijke items in Workfront , maar ze kunnen niet worden opgenomen in updates.
AttachmentsBijlagen van een probleem in Jira worden ook toegevoegd aan de taak of het probleem waaraan het is gekoppeld in Workfront .CommentsEen opmerking over een Jira -uitgave wordt ook gepost op het gekoppelde Workfront -item in het Updates -gebied. Een opmerking die in het Updates -gebied is geplaatst voor een Workfront taak of Issues syncs naar de native commentaarstream van Jira voor de gekoppelde uitgave.
Deze is standaard ingesteld op Always . Als u Never hier selecteert, kunt u nog steeds handmatig opmerkingen op een gekoppeld item posten in Workfront of in Jira .
-
-
Selecteer in de sectie OTHER welke extra velden moeten worden bijgewerkt tussen gekoppelde items.
-
Selecteer een optie om te bepalen of de velden die u opgeeft Always of Never bijwerken in Jira of Workfront wanneer ze worden gewijzigd.
-
Selecteer een van de volgende velden en updates:
Copy Workfront Aangepaste gegevens in het rechterdeelvenster in JiraHiermee geeft u de Workfront aangepaste gegevens van een item weer in het deelvenster Workfront rechts.
Opmerking: secties Aangepaste formulieren worden weergegeven in het rechterdeelvenster van Workfront en hebben toegang tot het toegangsniveau van de Workfront System Administrator.
Copy Workfront Prioriteit in het rechterdeelvenster in JiraGeeft de Workfront Prioriteit van een item weer in het deelvenster Workfront rechts.Add an update in the Workfront Tabblad Updates over wijzigingen in Vervaldatum in JiraVoegt een opmerking toe op het tabblad Update van het Workfront -item wanneer de Due Date verandert in een gekoppeld Jira -item.Automatically create a user in Workfront als de Jira -gebruiker geen Workfront -account heeftDe volgende scenario's bestaan:
-
Wanneer u Always selecteert, schakelt u de integratie in om een nieuwe Workfront-gebruiker te maken telkens wanneer een Jira gebruiker zonder een Workfront -account de volgende handelingen uitvoert op een gekoppelde Jira -uitgave:
-
Wordt toegewezen aan een Jira -uitgave
-
Hiermee wordt tijd geregistreerd voor een Jira -probleem
Deze nieuwe gebruiker neemt geen Workfront -licentie in. De standaardinstelling is Altijd. Aan de naam van de gebruiker die op deze manier in Workfront is gemaakt, is "Jira" toegevoegd.
-
-
Wanneer u Never selecteert, gebeuren de volgende dingen:
- U kunt geen Jira toewijzingen zien voor de Workfront -items. In dit geval worden alleen toewijzingen die in Workfront zijn gemaakt, weergegeven op de Workfront -items.
- De tijd die door een gebruiker zonder een Workfront -account is aangemeld bij een gekoppelde Jira -uitgave, wordt niet automatisch overgedragen naar het gekoppelde Workfront -item. U kunt de tijd nog steeds vastleggen op het Workfront -item in het rechterdeelvenster van het Jira -probleem.
-
-
-
Klik op Save.
Nu, telkens wanneer een gebruiker om het even welke gebieden bijwerkt die in deze configuratie op een punt in of Jira of Workfront worden gespecificeerd, wordt het verbonden punt in de andere toepassing ook bijgewerkt.
Problemen oplossen
Items kunnen niet in Jira worden gemaakt vanwege triggervelden gemarkeerd als " Couldn’t be found"
Probleem
Wanneer een fout optreedt met de Workfront for Jira -toepassing, schakelt Workfront de triggers uit om verdere complicaties te voorkomen. Wanneer die trekkers gehandicapt zijn, tonen zij als "Couldn’t be found".
Oplossing
Zoek de fout die de triggers heeft uitgeschakeld. U kunt de fout vinden in Workfront for Jira Activity Log .
De gemeenschappelijkste oorzaak van dit gedrag is de fout "Field ‘duedate’ cannot be set. It is not on the appropriate screen, or unknown."
Deze fout houdt in dat u Planned Completion Date van Workfront tot Jira probeert te synchroniseren. Hiervoor moet u ervoor zorgen dat uw Jira -objecten een veld hebben met de naam "Due Date". Als ze dit veld niet hebben, kan Workfront de geplande afsluitdatum niet synchroniseren vanaf Workfront en worden de triggers uitgeschakeld.
Voer een van de volgende handelingen uit om deze fout op te lossen:
- Vraag de Jira -beheerder om de betrokken Jira -objecten bij te werken om er zeker van te zijn dat ze een datumveld hebben dat is ingesteld op de datum waarop ze zijn toegepast.
- Schakel de synchronisatie uit van de geplande afsluitdatum van Workfront op de Workfront Setup -pagina.