FAQs

Frequently Asked Questions

Q1. What is Worklog Reports?

A. Worklog Reports is a time tracking and worklog management application for Atlassian Jira Cloud. It allows teams to log work with detailed categorization, view time entries across multiple formats (Calendar, Dashboard, Timesheet, List views), and generate advanced reports with export capabilities to PDF and Excel. The app maintains bidirectional sync with Jira's native time tracking system through automated webhooks.

Q2. Who should use Worklog Reports?

A. Worklog Reports is designed for:

• Development teams tracking time across sprints, issues, and projects

• Project managers requiring visibility into team time allocation and capacity

• Freelancers and consultants billing clients for hours worked with detailed invoices

• Team leads and administrators generating time reports for stakeholders

• Individual contributors organizing daily work activities and tracking personal productivity

Q3. What platforms does Worklog Reports support?

A. Worklog Reports is built on the Atlassian Forge platform and supports:

• Jira Cloud

• Accessible via web browser on desktop and mobile devices

• Responsive design that adapts to different screen sizes

Q4. What views and features are available?

A. Worklog Reports provides six primary views:

• Calendar View - Weekly grid with 30-minute time slots, drag-and-drop functionality, and visual progress indicators

• Dashboard - Overview with today's hours, weekly summary, assigned issues, recent work, and custom JQL search

• Timesheet View - Traditional timesheet format with weekly, 30-day, and 60-day views, advanced filtering by project, category and subcategory

• List View - Chronological list of all worklogs

• Reports (Admin only) - Advanced filtering, multiple aggregation types (by Category, Subcategory, Project, User), and export to PDF/Excel

• Settings (Admin only) - Manage work categories and subcategories for the organization

Key features include:

• Time logging with flexible formats (1h, 30m, 1h 30m)

• Customizable categories and subcategories

• Issue search across key, summary, and description

• Duplicate worklog functionality

• Multi-dimensional filtering

• Real-time synchronization with Jira

Q5. What are work categories and can I customize them?

A. Work categories help organize time entries by type of activity. The app includes seven default categories:

• Development (Frontend, Backend, Database, API, Code Review, Refactoring)

• Design (Wireframes, UI, UX Research, Prototyping, Visual Design, User Testing)

• Testing (Unit, Integration, Manual, Automated, Bug Verification, Performance)

• Meeting (Planning, Standup, Review, Retrospective, Client Meeting, Team Sync)

• Documentation (Technical, User, API, Process, Requirements)

• BugFix (Critical, Minor, UI, Performance, Security)

• Ideation (Brainstorming, Research, Feature Planning, Technical Analysis, Solution Design)

Customization (Admin only):

• Add new categories tailored to your workflow

• Create subcategories under any category

• Edit existing category/subcategory names

• Delete unused categories

• Changes apply immediately for all users

Q6. What's the difference between regular users and administrators?

A. User capabilities differ based on Jira Administrator permissions:

Regular Users:

• Log work on issues assigned to them

• View only their own worklogs

• Access Calendar, Dashboard, Timesheet, and List views

• Get reports for personal data only

• Use all available categories set by admin

Administrators (with "Administer Jira" permission):

• Log work on any issue in the project

• View all team members' worklogs

• Access Settings page

• Manage categories and subcategories (add, edit, delete)

• Generate team-wide reports with assignee filter

• Export entire team's data

Q7. What report types and aggregations are available?

A. Reports can be configured with five aggregation types:

1. Detailed List (No aggregation all filters set by default)

• Shows every individual worklog entry as a separate row

• Use for: Client invoicing, detailed audits, itemized billing

2. Aggregate by Category

• Groups by work type (Development, Testing, Design, etc.)

• Shows total hours per category with subcategory breakdown

• Use for: Understanding time distribution across work types

3. Aggregate by Project

• Groups by Jira project key

• Shows total hours, issue count, and team members per project

• Use for: Project budget tracking, capacity planning

4. Aggregate by User (Admin only)

• Groups by team member

• Shows each person's total hours by category

• Use for: Utilization analysis, performance reviews

5. Aggregate by Project, then by User (Admin only)

• Multi-level grouping showing which people work on which projects

• Use for: Resource allocation, quarterly planning, identifying overloaded team members

All reports support date range selection (This Week, Last Week, Last 30/60 days), multi-dimensional filtering (categories, subcategories, projects, assignees), and export to PDF or Excel.

Q8. Can I import existing worklogs from Jira?

A. The app syncs worklogs created in Jira after installation through webhooks.

• Only new worklogs (created after app installation) appear in the app

Q9. How does time zone handling work?

A. The app uses Jira profile time zone settings:

To configure:

1. Go to Jira Profile → Personal Settings

2. Select your Time Zone

3. Save changes

4. Refresh Worklog Reports

This ensures consistent time display across different team members' time zones.

Q10. What happens if I delete a worklog?

A. Deletion is permanent and bidirectional:

The same applies if you delete a worklog directly in Jira - the app receives the webhook and deletes the corresponding entry.