Creating Salesforce Objects from Jira

Prerequisites

To create a Salesforce object from a Jira Issue, the following prerequisites must be met:

  1. The object must be configured for integration with Jira.  zAgileConnect comes pre-configured with integration of Salesforce Case and Jira Issue.  However, it can also be optionally configured for integration of other Salesforce standard and custom objects with Jira.  For more on this, please refer to Integrating Salesforce Object with JIRA Issue

  2. The Create Salesforce Objects from Jira option must be enabled in the zAgileConnect package configuration (General Setting).

image2021-5-25_15-49-56.png

Configuration

Creation of Salesforce Objects from Jira leverages Salesforce Global Create Actions and involves the following steps 

  • In Salesforce - Define a Global Action to create a Salesforce object.  In the examples presented here, Global Action for creating a Case from Jira is presented.

  • In Jira - 1) Assign Projects and Groups for which to enable the Create action, and 2) Configure the field mapping for the creation.

These steps are described below using Case Creation from Jira as an example.

Define Global Create Action in Salesforce

The example below demonstrates creation of a Global Action for creating a Case

Screen Shot 2021-05-24 at 9.07.45 PM.png

Once created, fields may be selected for the creation dialog. 

The fields selected for the Global Action are those that are one of the following:

1) fields mapped to Jira Issue fields, or

2) fields populated with values derived from Salesforce (ex: picklist fields, Related List fields), or

3) fields populated with default values.


Screen Shot 2021-05-24 at 9.09.11 PM.png

Configure pre-defined values for fields which are auto-populated when the Case is created

Screen Shot 2021-05-24 at 9.11.31 PM.png

Configure Field Mapping in Jira

If Create Salesforce objects feature is enabled in the zAgileConnect Salesforce package (as described above), this feature will show as 'enabled' in zAgileConnect Jira add-on configuration setting (Salesforce Object Configuration) as shown below. 

For each Global Action that will be configured for object creation from Jira, Assign Jira Projects and Jira Groups for access to the Create Action

image2021-5-25_19-32-17.png

For each Global Action that will be configured for object creation from Jira, map the fields defined in the Global Action to

1) Jira Issue fields,

2) Salesforce fields, or

3) default values. 

Fields that are default or auto-populated may also be hidden from the Create dialog.

Screen Shot 2021-05-24 at 9.41.17 PM.png

Creating a Salesforce object from Jira Issue

Once configured, the option to create one or more Salesforce objects from Jira, the option may be selected from the Issue Menu (More)

screen1.png


Screen Shot 2021-05-25 at 7.30.16 AM.png

Auto-creation of a Salesforce object from Jira Issue using a Jira Post Function

zAgileConnect Jira add-on provides Post Function (Create Salesforce Object Postfunction) for auto-creating Salesforce objects from an Issue using Jira workflow.

image2021-5-25_20-46-49.png

This Post Function can be added to a workflow and configured appropriately for automatic creation of a Salesforce object based on specific Jira Issue events.

screen2.png
image2021-5-26_12-59-0.png

Multiple email addresses for error notification can be set separated by commas.