6. Admin Setup - Permissions, Calendars and Advanced Settings

As an administrator, you have access to three key configuration areas that control how Status Time and Times works for your organization. This section guides you through setting up permissions, work calendars, and advanced system settings.

To access admin features, you need:

• Jira administrator permissions

• Specific module permissions within the app

Open

Status Time and Times uses a module-based permission system with four distinct modules:

1. Go to Jira Settings → Apps → Status Time and Times

2. Click on the "Permissions" tab

3. You'll see all four modules with their current access settings

Open

For each module, you have two access control options:

• When to use: For widely-used features like Reports

• How: Toggle the switch to "All Users"

• Result: Every Jira user can access this module

• When to use: For sensitive features like Permissions or Advanced Settings

• How: Toggle switch to "Selected Groups" and choose specific user groups

• Result: Only members of selected groups can access this module

Reports Module

• Access: All Users (most common setup)

• Reason: Reports are the primary feature most users need

Work Calendars Module

• Access: Selected Groups (site-admin only)

• Reason: Calendar changes affect time calculations across the organization

User Permissions Module

• Access: Selected Groups (site-admin only)

• Reason: Security-sensitive feature that controls access to other modules

Advanced Settings Module

• Access: Selected Groups (site-admin only)

• Reason: System-wide settings that affect data formats and performance

• Always have access: Site-admin groups cannot be removed from any module

• Automatic inclusion: They're automatically included even if not explicitly selected

• Visual indicator: Marked with orange "SITE-ADMIN" tags in group lists

• Changes are not applied until you click "Save Settings"

• You'll see a warning banner if you have unsaved changes

• All module permissions are saved together in one operation

Work calendars define when your team actually works, enabling accurate business time calculations. This is crucial for meaningful time tracking that excludes weekends, holidays, and non-working hours.

Every installation includes a "Default Work Calendar" that:

• Cannot be deleted: Ensures system always has a working calendar

• Name cannot be changed: Maintains system consistency

• Is used by default: For all time calculations unless specified otherwise

1. Go to admin panel → Work Calendars tab

2. Click "New Calendar" button

3. Fill in the calendar form

Open

Calendar Name

• Purpose: Identify the calendar (e.g., "US East Coast", "EMEA Team", "24/7 Support")

• Requirements: At least 2 characters, must be unique

• Tip: Use descriptive names that indicate the team or region

Timezone

• Purpose: Ensures accurate time calculations for global teams

• Options: All standard time zones available

• Important: Choose the time zone where most team members are located

Open

Choose which days of the week are working days:

• Standard: Monday to Friday (most common)

• Custom: Any combination of days

• Examples:

  • Sunday to Thursday (Middle East)

  • Tuesday to Saturday (some retail)

  • Every day (24/7 operations)

You have two options for work time configuration:

Option 1: Standard Hours

• Set specific start and end times

• Can have multiple time slots (e.g., morning and afternoon shifts)

• Example: 09:00-12:00 and 13:00-17:00

Option 2: 24-Hour Operation

• Toggle "24 Hours" checkbox

• Automatically sets 00:00:00 to 23:59:59

• Perfect for continuous operations

Open

1. Click "Add Time Slot"

2. Set start and end times

3. Ensure no overlap between slots

4. System validates automatically

Holidays are excluded from the calculations of business time on specific dates.

Single Day Holiday

• Use for: New Year's Day, Christmas Day, etc.

• Configuration: Set date and description

• Repeat option: Mark to repeat every year automatically

Date Range Holiday

• Use for: Spring Festival, Christmas week, summer shutdown

• Configuration: Set start date, end date, and description

• Repeat option: Mark to repeat every year (useful for standard holidays)

Open

The calendar preview shows you exactly how your configuration works:

• Week View: Detailed daily breakdown

• Month View: Overview of entire month

• Navigation: Move between time periods

• Legend: Color coding for work days, holidays, and non-working days

Open

The preview includes helpful calculations:

• Work Days: Total number of working days

• Work Hours: Total hours per week/month

• Holidays: Number of configured holidays

Base your calendars on standard business practices in your region.

Update holidays annually, especially for non-repeating company events.

Create separate calendars for different regions or time zones if your team is distributed.

Use the preview feature to verify your configuration before saving.

Advanced Settings control global application behavior that affects all users and reports.

• Must have "Advanced Settings" module permission

• Typically restricted to system administrators

This feature allows you to customize the appearance of dates throughout the application.

Common Patterns:

• DD/MM/YY → 25/12/23

• DD-MMM-YYYY → 25-Dec-2023

• MMMM DD, YYYY → December 25, 2023

• YYYY-MM-DD → 2023-12-25

Open

Controls how date and time combinations appear.

Requirements:

• Must include both date AND time elements

• Date patterns: D, M, Y

• Time patterns: H, h, m, s, A

Examples:

• DD/MMM/YY HH:mm → 25/Dec/23 14:30

• YYYY-MM-DD hh:mm A → 2023-12-25 02:30 PM

• DD-MMM-YY HH:mm:ss → 25-Dec-23 14:30:45

Controls how many issues can be retrieved in a single database query.

Default Value: 10,000 issues
Range: 0 - 30,000 issues
Impact: Higher values improve efficiency but may affect performance

Open

Small Teams (< 100 users): 5,000 - 10,000
Medium Teams (100-500 users): 10,000 - 15,000
Large Organizations (500+ users): 15,000 - 30,000
Performance Issues: Reduce to 5,000 or lower

The system validates all settings before saving:

• Must contain valid date pattern characters

• Cannot exceed 50 characters

• Must follow recognized format conventions

• Must contain both date AND time elements

• Cannot exceed 50 characters

• Must include proper separators

• Must be between 0 and 30,000

• System recommends staying under 20,000 for optimal performance

• Only enabled when changes are made

• Saves all settings simultaneously

• Shows loading state during save operation

• Restores the factory default values

• Requires user confirmation

• Does not auto-save (you must click Save after reset)