Perforce Jobs in Fisheye and JIRA

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

This page describes the usage of Perforce Jobs in Fisheye. It also covers the JIRA integration aspects.

Solution

Workflow

The following workflow can be used in this scenario:

  • A JIRA issue is created

  • A Perforce Job is created from JIRA using the "PerforceJobCheckbox" field

(Auto-migrated image: description temporarily unavailable)
  • A commit is performed in Perforce and it is associated with the Perforce Job (in other words a p4 fix command is triggered)

    This can be achieve by linking the Job to a commit in the Perforce Job dialog:

(Auto-migrated image: description temporarily unavailable)
  • Unless the commit's comment (description in the screenshot above) contains the JIRA issue key. This will allow the Using Smart Commits feature to link the commit to the JIRA issue

  • Fisheye displays the "Fixed Jobs" even if the JIRA issue key is not provided in the Smart Commit

(Auto-migrated image: description temporarily unavailable)

FAQ

Commit Message / Smart Commits

Q: Do I need to provide the JIRA issue key in the commit message when committing the change in Perforce?

A: Yes, if the JIRA issue key is not provided in the commit message, then the Commit will not be displayed in the Development panel

See FE-6657 - As a user, I want FishEye to link the Perforce commit with a linked Job to a JIRA issue, so that I don't have to provide the JIRA issue key on every commit

Perforce Job without a JIRA issue key

Q: What if I use a Perforce Job which does not match a JIRA issue?

A: Fisheye will display it in the changeset (see the "nonJiraJob" id in the screenshot below)

(Auto-migrated image: description temporarily unavailable)
Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.