View Source

<style>
.release-box {
	height: 30px; 
	width: 100px; 
	padding-top: 8px;
	text-align: center; 
	border-radius: 5px; 
	font-weight: bold; 
	background-color: #d4af37; 
	border-color: #FCE28A;
}

.release-box:hover {
  	cursor: hand;
    cursor: pointer;
    opacity: .9; 
}
</style>
<meta name="robots" content="noindex">

<div class="release-box">
<a href="https://docs.perspectium.com/display/gold" style="text-decoration: none; color: #FFFFFF; display: block;">
Gold
</a>
</div>

To ensure that the data being shared out of Jira and into ServiceNow (inbound data) is being mapped correctly when arriving at your ServiceNow instance, you will need to add and update some of the scripts in the transform maps under the PSP Common Transform Maps module. ServiceNow transform maps handle the format of data being shared into a ServiceNow instance. Making changes to the transform map scripts will allow data to be properly shared out of Jira and then be mapped correctly to the relevant fields in ServiceNow.

Prerequisites

See Bond Jira with ServiceNow and complete its prerequisites.

Procedure

To get started with updating your transform map, follow these steps:

Access the transform map

Log into your ServiceNow instance and navigate to Perspectium Common Documents > Perspectium Common Transform Maps or simply type and then select Transform Maps in the Filter Navigator on the upper left-hand side of the screen. Then, search for and then click into the transform map you are integrating.

Table	Transform Map
Incident	PSP Common Incident to Incident
Change Request	PSP Common Change to Change

Add transform scripts

Create a new transform script by clicking New under the Transform Scripts tab.

Helium > Add and edit ServiceNow transform maps for Jira > New Transform Script.png

Select onBefore in the When field, then fill the Script field with the following:

(function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
	if (source.u_action == "correlate") {
		ignore = true;
		return;
	}
})(source, map, log, target);

Helium > Add and edit ServiceNow transform maps for Jira > Transform Script.png

Add a new transform map

Create a new transform map that will handle correlating responses from Jira.

Navigate back to Perspectium Common Documents > Perspectium Common Transform Maps, then click New.

Then, set the Source table to the table map that corresponds to the table you are integrating:

Table	Source Table
Incident	PSP Common Incident
Change Request	PSP Common Change

Set the Target table to the table you are integrating to. Then, click Submit when done.

Helium > Add and edit ServiceNow transform maps for Jira > Perspectium Correlation Jira Transform Map.png

Add new field maps to the transform map

Go back to the transform map you created from the previous step, and create new Field Maps by clicking New.

Helium > Add and edit ServiceNow transform maps for Jira > New fielp map.png

Set the Source field to correlation_id, and the Target field to Sys ID. Then, check the Coalesce box.

Source field	Target field	Coalesce
correlation_id	sys_id	true

Click Submit when done.

Helium > Add and edit ServiceNow transform maps for Jira > Correlation Id to Sys Id Field Map.png

Repeat the same steps for creating field maps to the following:

Source field	Target field	Coalesce
sys_id	correlation_id	false
correlation_display	correlation_display	false

Add a transform script to the transform map

Go back to the transform map you created and create a new transform script by clicking New under the Transform Scripts tab.

Select onBefore in the When field, then fill the Script field with the following:

(function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
	if (source.u_action != "correlate") {
		ignore = true;
		return;
	}
})(source, map, log, target);

Prerequisites

Access the transform map

Add transform scripts

Add a new transform map

Add new field maps to the transform map

Add a transform script to the transform map

Next Steps

Similar topics

Contact Perspectium Support

US: 1 888 620 8880

UK: 44 208 068 5953

support@perspectium.com