My Area Overview

The My Area section in the main navigation provides a space for all the logged-in user’s artifacts, like the calculated fields and teams created by the user, user-specific preferences, and timesheets the user needs to approve (if timesheet approval is enabled). This article covers My Preferences and API areas of My Area and provides links to other articles that cover the remaining areas in detail.

My Preferences.jpg

My Preferences

  • The application allows a few preferences to be set at the user level. For example, the user can decide whether on opening of a saved report, they would like to run the report automatically or not, etc.

  • The My Preferences tab shows user-specific preferences to customize the application behavior.

  • The following preferences can be set from this section.

    • Subscription Email Template: A subscription is used to send saved reports by email to recipients. If the logged in user wishes to use a specific email template for subscription emails set on his reports then the subject and the body of the email can be defined from this page. Please note this email template will only be applicable to the reports that the logged in user has saved

    • Report Preferences: Following report specific settings are allowed

      • A report will run automatically on opening from ‘My Saved Reports’ or ‘Shared Reports’ if this checkbox is enabled

      • For reports with column totals, a user can set that the totals row be excluded in the exported excel by enabling the checkbox

      • For reports with hyperlinks on certain fields like Issue Key, Project Name, etc., a user can set that the links be disabled in the exported excel by enabling the checkbox

    • Time Entry Preferences: While entering time via the My Timesheet screen, each entry box shows the Remaining estimate field by default. It is only for viewing purposes. But if the user wishes to not see the field in the time entry box then the setting can be enabled from this page

Appfire API

  • The Appfire API tab offers two endpoints that can be used to integrate with third-party apps that need the export of Jira data.

  • The benefit is that once the report is created in the add-on, the app/user can access the report data without always coming to the add-on to run the report and manually exporting it.

Configure the application link for Appfire API endpoints

  • When you navigate to Appfire API, If the application link has not been configured, you will see the Application link needed dialog box with instructions for setting it up. For more information, refer to Configure the Application link (Jira hosted only).

    ApplicationLink_Dialog_DC.jpg
  • After setting up the link, the Appfire API endpoints are displayed.

  • The first endpoint “/myReports” will give the ReportID and export URLs (excel, JSON, HTML formats) for all the saved reports and the reports shared with the logged in user.

  • The second endpoint “/report/export” provides direct URLs for exporting the report in a particular format - excel, JSON and HTML. The ReportID required by the endpoint can be obtained by calling the “/myReports” endpoint.

For information on other areas under My Area section, please refer to the links below.

My Calculated Fields - The application allows the creation of new calculated fields using standard Jira fields. Calculated fields provide additional flexibility for reporting as you can combine/bucket the values to get more meaningful data in the reports

My Teams - Allows the user to group users in teams.

Approvals - Allows users to setup approval workflows for timesheets where you can define approvers and their hierarchy and can subsequently report on the same

Related articles