Page tree
Skip to end of metadata
Go to start of metadata

What is it?

The problem you need to solve: 

You want to log work on an issue, but you want to specify on what kind of activity.

This requirement has been raise to Atlassian in 2003 : JRA-1780


How Minyaa solves this problem:

It provides the concept of Worklog Types, allowing you to assign a category to your worklogs. e.g. Analysis, Development, Testing, ...


How it Works

Minyaa allows you to categorize your worklogs using a concept named Worklog Types.

When you log work, in the Worklog Gadget or in the Log Work Page, you can specify the type of your worklog.

When this is done, you can do reporting on your worklogs to find how time was spent.


Where are they available?

Once your Worklog Types are configured, they are available in different places ...

In the Log Work page

The JIRA's Default Log Work Page is overridden in order to integrate the selection of a Worklog Type (also the author):
 

In Fast Worklog gadgets

Some Worklog Gadgets are available and allow also to log work with Workog Type details.

In Worklog reports

Some specific reports are available and allow to use Worklog Type as aggregation criteria .. See  In Worklog Reports for more details.


When are they available?

Once your Worklog Types are configured, they are available by default for all projects. But it is possible to define some restriction at different levels :

  • Project (using Properties)
  • Workflows
  • ... and later Project Scheme ( ALKMT-56 - Getting issue details... STATUS )

... at Projects Level

It is possible to change the list of Worklog Types applied on project.

By using the additional configuration property WORKLOG_TYPE_LIST in the <JIRA_HOME>/jira-config.properties :

The supported format is WORKLOG_TYPE_LIST.<scope>=<worklogTypes> where ...

VariableValuesObservations
<scope>defaultThe list of Worklog Types is assumed as default. It means that orhers existing Worklog Types are not available without deleting them.
<projectKey>The list of Worklog Types is assumed as default for the identified project
<worklogTypes>
<worklogTypeId>|<worklogTypeId>
The list of Worklog Types is defined by Id with "|" as list separator..
<worklogTypeName>|<worklogTypeName>
The list of Worklog Types is defined by Name.

By example, you can have ...

<JIRA_HOME>/jira-config.properties
WORKLOG_TYPE_LIST.default=Development|Discussion
WORKLOG_TYPE_LIST.DEV=Development
WORKLOG_TYPE_LIST.TST=Discussion

... at Workflows Level

It is also possible to define this restriction (inclusive or exclusive) directly in the Workflows. See in details Worklog Type by Workflows.


Configuring Worklog Types

You can find the Worklog Types configuration menu in JIRA's administration menu: 

By creating each new Worklog Type

You can add your own Worklog Types like any Issue Constant : 

You will have to specify the different attributes of the Worklog Type.

ParameterDescription
NameThe default name in english of the Worklog Type.
This name will be used when no translation is available.
DescriptionThe default description in english of the worklog type.

This description will be used when no translation is available.
Assumed as default forThe Worklog Type is assumed as default for the mentioned Project Role.
Icon

Path to the icon relative to JIRA's appplication path.

This icon is used for report generation.

Some default icons are available (see below table)

ColorA color reprenting the worklog type

This color is used for report generation.
Order

This parameter changes the order in which worklog types will appear in the FastWorklog Portlet and in JIRA's Log Work page

And using different icons ...

Minyaa Time plugin embeds additional Worklog Type icons.

You will have to specify a Icon path with following format : /download/resources/fr.alkaes.minyaa.jira-plugin-minyaa-time:myaatm-icons/icons/worklogtypes/<IconFileName>

Worklog Type

Icon

Icon file Name
Analysis

wlAnalisys_16.png
Development

wlDevelopment_16.png
Discussion

wlDiscussion_16.png
Documentation

wlDocumentation_16.png
Mail Review

wlMailReview_16.png
Meeting

wlMeeting_16.png
Pair Programming

wlPairProgramming_16.png
Phone Call

wlPhoneCall_16.png
Releasing Process

wlReleasing_16.png
Studies

wlStudies_16.png

But without Translation capacities 

Instead of Minyaa 3.x, where Worklog Type was based on a extension of the JIRA Constant Manager and where Minyaa was able to benefit from the Constant Translation Manager, Minyaa 4.x has not yet a Translation mechanism. 

 

Minyaa 3.x

Thanks for noting that the related documentation with Minyaa Time 3.x is available here .

On this page:


Useful hint

See also ...

  • No labels