Introduction
This guide walks you through the process of configuring Connector Custom Fields, which is necessary if you intend to use Remote Object Links.
Automatically Created Custom Field
When a mapping is created, an accompanying read-only custom field of type "Remote System Reference" is automatically created for you to display the information from Salesforce in the JIRA issues. The administrator might wish to configure the field as for other custom fields. (View the JIRA documentation at http://confluence.atlassian.com/x/vAESCw.)
Please note the following defaults for these fields:
- Globally available for all issues.
- Are automatically added to the default Field Configuration (see: http://confluence.atlassian.com/x/dgISCw).
- Their field templates are empty, although there is a default view that displays a link back to the Salesforce object.
- They are not associated with any screens.
The administrator may want to add a field template and will need to associate the field with at least one screen.
An example of some automatically created Salesforce custom fields is shown below in a view from the standard Custom Fields page in Administration:
Remote Linking Custom Fields
The connector provides two other custom fields that can be added by an administrator to JIRA issues:
- Remote Object Link
- Multi Remote Object Link
These fields allow a JIRA issue to link to more objects in Salesforce than the automatically added custom field.
For example, you might want to also add to a JIRA issue, which is linked to a Salesforce Case, links to related Contacts in Salesforce. The multi field allows you to add more than one link.
Adding New Custom Fields
You won't need to add the Remote System Reference fields as they are automatically created as mentioned in the introduction.
If you wish you can add the Remote Object linking fields with the following steps:
- Go to the Administration section of the application and enter your password if prompted.
- Click on the Custom Fields link in the Issue Fields section of the left menu.
- Click on the Add Custom Field link near the top.
- Choose the field you want to create, either Remote Object Link or Multi Object Link and click Next.
- Type in a name for your new field and associate it with issue types and projects before clicking Finish.
- The new field will then be added to the custom field list for your instance and will be available in the issues types and projects you configured in the previous step.
You will then be prompted to add the field to screens so that these are actually visible for the user.
Do this, and click Update.
- You will now need to specify which Salesforce object you want the field to link to.
Click on the Configure link of your new field.
- Select the Remote System for Salesforce and Remote Object Type that you want to link to.
Click Submit.
- You will be taken back to the default configuration screen for the field.
It should now display the remote system and object it will be linking to.
Please see Modifying Display Templates for information on how to customize the display templates of the custom fields.