Skip to main content
Skip table of contents

Mapping fields from Salesforce object to Jira Issue

Introduction

zAgileConnect supports field mapping from Case Fields to JIRA Issue fields (standard and custom).
The configuration for mapping may be found in the package Configuration page.

Notes

  • Since JIRA summary field is required, this field should be mapped to some compatible Case field during initial zAgileConnect setup
  • Please refer to the section below for compatibility in field mapping from Salesforce to Jira
  • Field mapping facilitates the following:
    • All mapped Issue fields are auto-populated during Issue Creation
    • Auto-creation of Issue from Case similarly uses the values from the mapped fields
    • Update issues using the values from the mapped fields.  zAgileConnect will update only the issues that were created from Salesforce Case.  Linked Issues do not support field mapping.

To ensure that a JIRA Issue field is available for mapping from Salesforce Issue Creation, please make sure that this Issue field is configured in JIRA’s Issue Creation screen.

Supported Issue Fields Types

Standard Fields

The following standard Jira Issue types are supported:

  • String (example: Summary, Description, Environment)
  • Component/s
  • Version/s (FixVersion/s, AffectsVersion/s)
  • Priority
  • Project
  • Issue Type
  • Date/DateTime (example: DueDate)

**Note: Issue Status may only be updated in Jira via workflow transitions

Custom Fields included in JIRA

The following custom fields types are supported:

TYPE

SCHEMA EXAMPLE

arrayschema: {


  • type“array”,
  • items“string”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:multiselect”

},

schema: {

  • type“array”,
  • items“string”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes”

}

schema: {

  • type“array”,
  • items“string”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:labels”

},

stringschema: {


  • type“string”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:textarea”

}

schema: {

  • type“string”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:textfield”

},

schema: {

  • type“string”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:select”

}

schema: {

  • type“string”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons”

}

projectschema: {


  • type“array”,
  • items“project”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:project”

}

component/sschema: {


  • type“array”,
  • items“component”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:component”

}

version/sschema: {


  • type“version”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:version”

},

schema: {

  • type“array”,
  • items“version”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:multiversion”

}

priorityschema: {


  • type“priority”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:priority”

}

dateschema: {


  • type“date”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:datepicker”

}

numberschema: {


  • type“number”,
  • custom“com.atlassian.jira.plugin.system.customfieldtypes:float”

},

datetimeschema: {


  • type“datetime”,
  • custom:“com.atlassian.jira.plugin.system.customfieldtypes:datetime”

}

Custom Fields added by Third-party plugins

Custom fields provided by Third-party plugins may be mapped only if those are derived from Standard Fields or Custom Fields included in Jira like: version, labels, issuetype, component, version[], issuetype[], labels[], component[], etc.

**Jira Agile fields (Sprint, Epic, etc) are currently not supported

Supported Case Fields Types

The following Field Types are supported by zAgileConnect:

TYPE FIELD VALUE

WHAT THE FIELD OBJECT CONTAINS

BooleanBoolean (true or false) values. For example Checkbox Salesforce field
CurrencyCurrency values
DateDate values
DateTimeDateTime values
DoubleDouble values
EmailEmail addresses
IDPrimary key field for an object
IntegerInteger values
MultiPicklistMulti-select picklists, which provide a set of enumerated values from which multiple values can be selected
PhonePhone numbers. Values can include alphabetic characters. Client applications are responsible for phone number formatting.
PicklistSingle-select picklists, which provide a set of enumerated values from which only one value can be selected
StringString values
TextAreaString values that are displayed as multiline text fields
URLURL values that are displayed as hyperlinks

Conversion from Salesforce Field Types to JIRA Issue Field Types

Case \ Issuecascade selecttextfieldtextarealabelsstringstring[]floatnumber

multicheckboxes

datepickerdatetimedateselectmultiselectversionversion[]componentcomponent[]prioritypriority[]urlprojectissuetype
Boolean (Checkbox)(error)(tick)(tick)(error)(tick)(error)(error)(error)(tick)(4)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Combobox
(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Currency(error)(tick)(tick)(error)(tick)(error)(tick)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
DataCategoryGroupReference
(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Date(error)(tick)(tick)(error)(tick)(error)(error)(error)(error)(tick)(tick)(5)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Datetime(error)(tick)(tick)(error)(tick)(error)(error)(error)(error)(tick)(tick)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Double(error)(tick)(tick)(error)(tick)(error)(tick)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Email(error)(tick)(tick)(error)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
EncryptedString
(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
ID
(tick)(tick)(error)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Integer
(tick)(tick)(error)(tick)(error)(tick)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
MultipickList(error)(tick)(tick)(tick)(tick)(tick)(error)(error)(tick)(error)(error)(error)(tick)(tick)(tick)(tick)(tick)(tick)(tick)(tick)(error)(error)(error)
Percent(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Phone(error)(tick)(tick)(error)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Picklist(error)(tick)(tick)(tick)(tick)(error)(error)(error)(error)(error)(error)(error)(tick)(error)(tick)(error)(tick)(error)(tick)(error)(error)(tick)(tick)
Reference
(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
String (Text)(error)(tick)(tick)(tick)(7)(tick)(tick)(error)(error)(tick)(error)(error)(error)(tick)(tick)(tick)(tick)(tick)(tick)(tick)(error)(error)(tick)(tick)
TextArea(error)(error)(tick)(error)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
Time
(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)
URL(error)(tick)(tick)(error)(tick)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(tick)(error)(error)
Basic Types
  1. If the value is null it will be passed on as null
  2. From any type to String, TextField or TextArea is a direct conversion using String.valueOf().
  3. Numbers (Double, Integer, Decimal, Long, etc.) are converted to type double
  4. Boolean are converted to string values "true" or "false" when mapped to Text Jira fields.  However if the Jira field target is multicheckboxes and it has multiple items then only the first item will be selected/unselected
  5. Date is converted from Salesforce Date directly. For Datetime, it will take year, month and date, discarding any other value. The following format is used: yyyy-MM-dd
  6. Datetime is converted from Salesforce taking the following format: yyyy-MM-dd\’T\’HH:mm:ss.SZ
  7. String can be converted to JIRA labels, words are split with blank spaces.
Complex Types
  1. Salesforce’s  Picklist and MultipickList to JIRA String Array (string[]) – each value is taken and sent to JIRA as an item (PickList) or an array (MultipickList) of String.
  2. Salesforce’s  Picklist and MultipickList to JIRA array (priority[], component[], version[], etc.) — each item(s) is matched with name or value (project name, version name, component name, etc.) if these match then the id is added to the result.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.