Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede


1. Voraussetzungen für die Nutzung

  1. Die URL und das Admin Token müssen in der Jira Administration konfiguriert sein.
  2. Die benutzerdefinierten Felder: Kunde, Projekt und Tätigkeit müssen einem Kontext zugewiesen werden und im Issue konfiguriert sein.
  3. 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.

Info


2.1 Arbeitszeiten von Jira nach MOCO

Die Arbeitszeit entspricht der in Jira angegebenen Zeit. Hier einige Beispiele zur Umrechnung:

Zeitformat in JiraZeitformat in MocoErklärung
4h4hStundenzahlen werden entsprechend nach MOCO übertragen.
1h 30m1,5hIn Jira werden einzelne Minuten eingetragen. MOCO wandelt diese in ein absolutes Format um.
1d

8h

1d bedeutet einen Arbeitstag und entspricht damit 8h.
1h 7m1hMOCO rundet viertelstündig auf oder ab. Bis 7 Minuten darüber wird abgerundet.
1h 8m1,25hAb 8 Minuten wird zur nächsten Viertelstunde aufgerundet.
1d 2h10h

Einen Arbeitstag überschreitende Stunden werden zu den 8h hinzugerechnet.


2.2 Übertragung der Arbeitsbeschreibung

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 JiraEintragung 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.

Info



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

Note

Ä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:

  1. Kunde, Projekt oder Tätigkeit ändern.
  2. Im Tab Arbeitsprotokoll alle einzelnen Arbeitsprotokolle auswählen und bearbeiten.
  3. In der bearbeiten Maske keine Änderung vornehmen und einfach speichern.

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.

Sv translation
languageen

1. Requirements for usage

  1. URL and the admin token have to be configured in the Jira administration.
  2. The custom fields "Company, Project and Task" have to be assigned to a context and configured in the issue.
  3. 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

4h4hHours will be transfered to MOCO accordingly.
1h 30m1,5hIn 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 7m1hMOCO rounds up or down to the next quarter of an hour. Up to 7 minutes will be adjusted downwards.
1h 8m1,25hStarting with 8 minutes MOCO will round up to the next quarter of an hour.
1d 2h10h

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:

  1. Chance Company, Project and Task.
  2. Select and edit each work log in the tab "Work Log".
  3. 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.