<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Managing Gateway Mappings</title></head>
<body>
<h1>Managing Gateway Mappings</h1>
This tab enables you to map fields between defined Perforce server
sources and defect tracking sources. To create mappings, you associate
a defect tracking source with a Perforce server source, then assign
specific defect tracker fields to fields in Perforce jobs.
<p>Fields can be replicated in two ways:<br>
</p>
<ul>
<li><b>Copy:</b> One-way replication. Any change in the value is sent from the
source system to the target system <br>
</li>
<li><b>Mirror</b>: Two-way replication. Any change in the value in either system
is replicated in the other system<br>
</li>
</ul>
<b>To add a set of mappings:</b>
<ol>
<li>Click <b>New</b>. The <b>Add New Mapping</b> dialog is displayed.</li>
<li>Specify a name and choose the Defect Tracking Source and Perforce Server
Source, then click <b>OK</b>. The <b> Edit Perforce-Defect Tracker Mapping</b>
dialog is displayed, containing the following fields:
<p>
<ul>
<li><b>Defect tracker fields</b> lists fields defined in the defect tracker
that you can choose to replicate in Perforce jobs. Unmapped fields are
displayed in bold.</li>
<li><b>Perforce fields</b> lists fields from the Perforce job specification
that you can choose to replicate in the defect tracker. Unmapped fields
are displayed in bold.</li>
<li><b>Field mappings</b> lists the mappings you have defined. Mappings
are displayed in a tree, grouped by type and direction of mapping.</li>
</ul>
<br>
</li>
<li>For each field of interest, select the field and choose the method of replication,
as follows:
<ul>
<li><b>To replicate Perforce fields in the defect tracker</b>, select the
source field in the <b>Perforce fields</b> list and click the <b>Copy
to Defect tracker</b> or <b>Mirror with </b><b>Defect tracker</b> button.
</li>
<li><b>To replicate defect tracker fields in Perforce</b>, select the source
field in the <b>DTS Fields</b> pane and click the <b>Copy to Perforce</b>
or <b>Mirror with Perforce</b> button. </li>
</ul>
<br>
When you click the <b>Copy</b> or <b>Mirror</b> button, a list of available
fields is displayed. </li>
<p>
<li>Choose the target field to which you want to map the selected source field
and click <b>OK</b>.</li>
<li>If the target field is a <b>select</b> field (meaning a field that can contain
one of a defined set of values), the <b>Define Select Value Mapping </b>dialog
is displayed.</li>
<li>On the <b>Define Select Value Mapping </b>dialog, specify the correspondence
between all values in Perforce and those in the defect tracking system by
selecting the Perforce value and its corresponding defect tracker value and
clicking <b>Map to</b>. Your mappings are listed in the <b>Field Mappings</b>
field, sorted according to the type of mapping you selected.</li>
<li>To map how fixes are replicated between Perforce and the defect tracker,
select the desired mapping under <b>PERFORCE FIX DETAILS -> COPIED ->
DEFECT TRACKER</b>. The <b>Select Fix Details to Map</b> dialog is displayed.</li>
<li>For each fix mapping, check the desired options, then click <b>OK</b> to
save your changes. To add fix mappings, click <b>Fix Details</b> at the bottom
of the <b>Perforce Fields</b> list.</li>
<li>When you have mapped all values, click <b>OK</b>. </li>
<li>Click <b>OK</b> to save your entries and dismiss the dialog.</li>
</ol>
<p>Note that, if you have <a href="segments.html">segmented</a> a data source,
you cannot map the top-level data source, only segments, which are displayed
as <i>datasource/segment_name</i>.</p>
<p>Your newly-defined mapping is now listed in the <b>Defect Tracker/Perforce</b>
mappings list. </p>
<p>After you map <b>select</b> fields, the field pair is listed in the <b>Field
Mappings</b> pane, indicated by “(map)”. </p>
<ul>
<li><b>To view the value mappings</b>, place the cursor over the field pair—the
mappings are displayed in a tooltip. </li>
<li><b>To change the values mapped for a field</b>, click the field in the <b>Field
Mappings</b> pane and click <b>Edit Value Mappings</b>. </li>
<li><b>To remove a mapping</b>, click the mapping in the <b>Field Mappings</b>
pane, then click <b>Unmap</b></li>
<li><b>To change the values mapped for a field</b>, click the field in the <b>Field
Mappings </b> pane and click <b>Edit Value Mappings</b>. </li>
<li><b>To remove a mapping</b>, click the mapping in the <b>Field Mappings</b>
pane, then click <b>Unmap</b>.</li>
</ul>
<p><b>To start the replication engine:</b>
<ol>
<li> Specify the start date and time.</li>
<li> If you are starting the replication engine for the first time, or you have
stopped the replication engine and changed mappings, check <b>Sync from start
date</b> to ensure that previously replicated jobs and issues are replicated
again using your new mappings. </li>
<li> Click <b>Start replication</b>.</li>
</ol>
<hr>
<a href="about.html">About</a><br>
<a href="index.html">Contents</a> <br>
<i><font size="-1">maptab.html</font></i>
</body>
</html>