Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

create Custom

...

Fields

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.

...

For more information regarding Custom Fields, view the Jira documentation.)

Please note the following defaults for these fields:

  • Globally available for all issues.

  • Are automatically added to the default Field Configuration

...

  • . For more information, view the Jira documentation regarding field behavior.

  • 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:

...


Image Added 

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.

...

...

Table of Contents
maxLevel3

...

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:

  1. Go to  Cog

...

  1. Icon  > Issues.
     

  2. In the sidebar,

...

  1. under Fields, click Custom Fields.
     

  2. Click on

...

  1. the Add Custom Field

...

  1.  link near the top.

...


  1. Image Added

...



  1. The Select a Field Type

...

  1.  dialog box will appear.

...

  1. Click Advanced.

  2. Choose the field you want to create,

...

  1. either Remote Object Link

...

  1.  or Multi Object Link and

...

  1. click Next.

...


  1. Image Added



  2. Type in

...

  1. Name

...

  1.  and Description

...

  1.  for your new field.
    Then

...

  1. click Create.

...


  1.  

  2. You are now asked to associate the field you just created to screens.
    Choose the screen you want to associate the field with and

...

  1. click Update.

...


  1. Image Added


     

  2. You will now need to specify which Salesforce object you want the field to link to.

    Find your new field's listing and on the far right, click the

...

  1.  Cog Icon > Configure:

...

  1. Image Added
  2. At the screen for

...

  1. the Default Configuration Scheme

...

  1.  for your field, click

...

  1. the Edit Configurations

...

  1.  link under Configurations.

...


  1. Image Added



  2. On

...

  1. the Edit Display Template

...

  1.  screen, choose

...

  1. the Remote System

...

  1.  and Remote Object

...

  1.  you want linked to the custom field.
    Then

...

  1. click Submit.
     

  2. You can now

...

  1. start adding a Remote Object Link.

...


See Modifying display templates for information on how to customize the display templates of the custom fields.

 

What's

...

next?

...

...