Page Comparison

Introduction

This guide will walk you through the process of automating workflow to create new Salesforce Objects.

Prerequisites

• Connection configured (see Configure a Connection).
• Configuration of the mapping and mapping schema (see Configure Mappings and Configure Mapping Schemes).

A JIRA workflow can be customized to create new Salesforce objects in Salesforce when triggered by a particular step. This is achieved by adding a new post function to a workflow step.

A practical usage of this feature would be if a JIRA issue used for support is escalated and a Salesforce Case must be created for it. Without workflow customization the user would have to push the issue to Salesforce manually. With workflow customization this can be completely automated as long as all the required information is supplied to Salesforce.

Step-by-Step Guide

The following steps use the example of creating a Salesforce Case object in Salesforce whenever the associated issue hits the Start Progress transition of the Open step in the default JIRA workflow.

1. Go to Cog Icon > Issues.
   
   
2. In the side bar, click Workflows.
   
   
3. Copy the existing jira (Read-only System Workflow) to new a Jira project workflow to a new workflow for the Salesforce by clicking Copy under the Actions column.
   Image Removed
   Image Added
   
   
4. Name the new workflow "Salesforce Project Workflow" and add a description.
   Click Copy.
   Image Removed
   Image Added
    
5. You will see the new inactive workflow in the list of workflows.
   Image Removed
   We now need to edit the Open step of the new workflowshould be automatically be brought to the copied Workflow.
   Click on Steps in the Operations column of the new workflow.
    A list of steps available for the workflow will display Diagram.
   
   
6. A workflow diagram will appear.
   Click the Start Progress transition for Open step.
   Image Removed
   Click on the Post Functions tab.
   Image Removed
   Click on the Add link at the top of the post function area on the Create transition arrow.
   When the pop-up screen appears, choose Post Functions.
   
   Image Added
   
   
7. Click on Add Post Function to add a new post function.
   Image Removed
   Image Added
   
   
8. A post function called Push to Remote System will be available.
   Select this and click Add.
   Image Removed
   Image Added
   
   
9. Select the Target System and object type from the drop-down menu (e.g.: "Development Salesforce Case"). The Target System will be the name inherited from the connection you set up for Salesforce. In our example this was "Development Salesforce". The list of all possible objects in Salesforce is listed.
   Click Add.
   Image Removed
   
   Image Added
   
   
10. After adding the Post Function, you will need to reorder the Post Function sequence.
    By default, the "Push the issue as a new Salesforce Case..." will be at the top.
    
    Image Added
    
    You will need to move it down below the "Creates the issue originally" Post Function:
    
    Image Added
    
    
11. The workflow is now ready!
    Next you will need to create a workflow scheme and associate it to your Salesforce project. (See: Activating Workflow on how to do this.)
     
12. To ensure the post function has been set up properly, create a new issue in the Salesforce project in JIRA and click Start Progress.
    A new Salesforce Case should be created in Salesforce and its details automatically populated in the JIRA issue.