...
1. Voraussetzungen für die Nutzung
Die URL und das Admin Token müssen in der Jira Administration konfiguriert sein.
Die benutzerdefinierten Felder: Kunde, Projekt und Tätigkeit müssen einem Kontext zugewiesen werden und im Issue konfiguriert sein.
Der Benutzer muss sein persönliches Moco API Token im Profil konfiguriert haben.
Anleitungen für die Umsetzung dieser Punkte findest du auf der Seite Installation und Konfiguration
2. Arbeitszeit eintragen
Sind alle Voraussetzungen erfüllt, erscheint beim Protokollieren der Arbeitszeit in Jira eine Checkbox im Dialog: "Zeiteintrag nach MOCO übertragen" (Orange markiert).Ist diese Checkbox ausgewählt, wird der Zeiteintrag nach dem Speichern in Jira auch an MOCO übertragen. Dabei werden die Werte aus den Benutzerdefinierten Feldern (Orange markiert): Kunde, Projekt, Tätigkeit ausgelesen und in MOCO verwendet.
2.1 Arbeitszeiten von Jira nach MOCO
Die Arbeitszeit entspricht der in Jira angegebenen Zeit. Hier einige Beispiele zur Umrechnung:
...
Zeitformat in Jira
...
Zeitformat in Moco
...
Erklärung
...
4h
...
4h
...
Stundenzahlen werden entsprechend nach MOCO übertragen.
...
1h 30m
1
...
.
...
1d
...
8h
...
1d bedeutet einen Arbeitstag und entspricht damit 8h.
...
1h 7m
...
1h
...
MOCO rundet viertelstündig auf oder ab. Bis 7 Minuten darüber wird abgerundet.
...
1h 8m
...
1,25h
...
Ab 8 Minuten wird zur nächsten Viertelstunde aufgerundet.
...
1d 2h
...
10h
...
Einen Arbeitstag überschreitende Stunden werden zu den 8h hinzugerechnet.
...
Die Beschreibung in MOCO entsteht entsprechend der Eintragung in der Arbeitsbeschreibung in Jira. Wurde keine vorgenommen, wird die im Issue hinterlegt Zusammenfassung übernommen.
...
Eintragung in Jira
...
Eintragung in MOCO
...
Arbeitsbeschreibung: "Problem wurde gelöst"
...
[Issue Key] Problem wurde gelöst
...
Arbeitsbeschreibung: Keine angegeben
Issue Zusammenfassung: Test XY
...
[Issue Key] Test XY
2.3 Abgleich der Zeiten von Jira und MOCO
Läd man die Issue Detailseite neu, nachdem man Arbeitszeit protokolliert hat, wird im Tab Arbeitsprotokoll im Bereich Aktivitäten unter der in Jira verbuchten Arbeitszeit nun auch der Status in MOCO angezeigt.
Die Farbe des Badges gibt an, ob die Jira Zeit zu der Moco Zeit passt. Grün bedeutet die Zeiten sind identisch. Rot bedeutet es gibt Abweichungen. Solche Abweichungen können entstehen, wenn die Zeiten entweder in Jira oder Moco bearbeitet werden, ohne dass diese an das andere System übertragen werden.
2.4 Arbeitszeit bearbeiten
Bearbeitet man das Arbeitsprotokoll in Jira erscheint im Dialog, wie beim Erstellen auch, eine Checkbox mit "Zeiten nach MOCO übertragen". Wird diese beim Bearbeiten ausgewählt, wird die Änderung ebenfalls an MOCO übertragen. Dabei werden folgende Dinge berücksichtigt:
Kunde, Projekt und Tätigkeit
Gebuchte Zeit
Arbeitsbeschreibung bzw. Issue Summary
| Hinweis |
|---|
Änderung von Kunde, Projekt, Tätigkeit Werden die Selectfelder Kunde, Projekt oder Tätigkeit im Issue geändert, hat das erstmal keine Auswirkungen auf die Zeiten in MOCO. Möchte man die Änderung von Jira nach MOCO übertragen, muss man folgendermaßen vorgehen:
Dadurch werden die Arbeitsprotokolle in MOCO aktualisiert und die neuen Werte übernommen. |
2.5 Arbeitszeit löschen
Im Löschen Dialogfeld gibt es ebenfalls die Checkbox "Nach Moco übertragen". Wird diese ausgewählt und der Zeiteintrag gelöscht, wird auch der dazugehörige Eintrag in MOCO gelöscht.
3. Standard Projekteinstellungen
In den Projekteinstellungen können Sie für die MOCO Felder "Kunde", "Projekt" und "Tätigkeit" Standardeinstellungen vornehmen. Diese werden dann für jedes neu angelegt Ticket übernommen, solange keine anderen Angaben gemacht wurden. Subtask übernehmen jeweils automatisch die Werte des übergeordneten Tickets, wenn keine anderen Angaben gemacht wurden.
...
Requirements for usage
URL and the admin token have to be configured in the Jira administration.
The custom fields "Company, Project and Task" have to be assigned to a context and configured in the issue.
The user has to configure his personal MOCO API token in his profil.
You find detailled instructions for the execution of these points on the pages Installation and Configuration.
2. Log working hours
If all requirements are completed, you will find a checkbox in the window for logging work hours which says:"transfer entry to MOCO"(orange marked).
Is the checkbox checked, your working log will be transfered to MOCO after saving it in Jira. The plugin will use the values from the custom fields (orange marked): Company, Project, Task.
2.1 Working hours conversion from Jira to MOCO
Your working hours are equal to your logged hours in Jira. Here are some examples for the conversion:
Zeitformat in Jira | Zeitformat in Moco | Erklärung |
|---|---|---|
4h | 4h | Hours will be transfered to MOCO accordingly. |
1h 30m | 1,5h | In Jira you have to type in single minutes. MOCO will convert them to hours. |
1d | 8h | 1d describes one working day and is equal to 8h. |
1h 7m | 1h | MOCO rounds up or down to the next quarter of an hour. Up to 7 minutes will be adjusted downwards. |
1h 8m | 1,25h | Starting with 8 minutes MOCO will round up to the next quarter of an hour. |
1d 2h | 10h | Every hour that extends one working day will be added to 8h. |
2.2 Transfer of the working description
The description in MOCO will be created accordingly to the entry in your working description in Jira. If you haven't given any, the plugin will transfer the issue summary that was recorded in the ticket.
Entry in Jira | Entry in MOCO |
|---|---|
Working description: "Problem solved" | [Issue Key] Problem solved |
Working description: Nothing stated Issue Summary: Test XY | [Issue Key] Test XY |
2.3 Comparison of hours in Jira and MOCO
When you reload the detailpage of the ticket after logging working hours, you will see your MOCO status (orange marked) in the tab "Work Log".
The color of the badge indicated if the hours in Jira match the hours in MOCO. Green means that they're identical. Red means that there are variations. These variations can occure, if you edit times either in Jira or MOCO without being transfered to the other system.
2.4 Edit working hours
When you edit your Working Log in Jira you will see the same checkbox that you saw when you created your working log that say "Transfer hours to MOCO". If you check the field while editing, the changes will be also transfered to MOCO. Following details will be adjusted:
Company, project, taks
Time spent
Work Description respectively the Issue Summary
Changes regarding Company, Project and Task
If you change the selectfields Company, Project and Task it will initially have no impact on the hours in MOCO. To transfer the changes from Jira to MOCO you have to do the following steps:
Chance Company, Project and Task.
Select and edit each work log in the tab "Work Log".
Just save the open window to transfer the changes.
That way you will update your worklogs in MOCO and it will adopt the new values.
2.5 Delete working hours
In your delete dialog field you will find the checkbox "Transfer to MOCO" aswell. If the field is checked and you delete your work log, the associated entry in MOCO will be deleted, too.
3. Standard Project Settings
You can set standard settings für every project. New created tickets will automatically use the recorded values as long as there is nothing else defined in the ticket. Subtask will automatically use the values from their parent task if nothing else is defined in the ticket.
...