<html><title>Creating Segments</title>
<h1>Creating Segments</h1>
<p>To replicate selected defects from a single data source to multiple other defect
trackers or SCM systems, you create <i>segments</i>. For example, if your all
developers use Perforce jobs, but your support teams use Bugzilla to track your
database bugs and Mercury Quality center to track your Web application bugs,
you can create separate segments for each project and replicate them independently.
<p><b>To create a segment for a Perforce or Defect Tracking Source: </b>
<ol>
<li>Before creating segments, stop the replication engine (on the Gateway Mappings
tab, click <b>Stop Replication</b>.) </li>
<li>Click <b>Edit Segments</b>... The <b>Edit Segments</b> dialog is displayed.
</li>
<li>Specify the field to be used to filter defects by choosing the field from
the <b>Segment using SELECT field</b> list. (The fields listed are SELECT
fields returned by the data source plugin.) </li>
<li>To add a segment, click <b>New...</b> In the <b>New Segment</b> dialog,
specify a name for the segment and click <b>OK</b>. </li>
<li>Specify the values that you want to include in the segment by moving them
from the <b>Unassigned options</b> column to the <b>Included options</b> column.
</li>
<li>To save your segment definition, click <b>OK</b>. </li>
<li>Start the replication engine (on the Gateway Mappings tab, click <b>Start
Replication</b>.) </li>
</ol>
<p>To continue the preceding example, you can create a segment named "Database"
that selects all Perforce jobs with the <b>Subsystem</b> field set to "db"
and another segment named "Web Application" that selects all Perforce
jobs with the <b>Subsystem</b> field set to "webapp".
<p>To use segments for replication, choose the segment when defining mappings
on the <a href="MapTab.html">Gateway Mappings tab</a>. Note that, if you segment
a Perforce source or a Defect Tracking Source, you are required to choose a
segment and cannot choose the top-level source. A non-segmented data source
that is in use (already referenced by a mapping) cannot be segmented. After
a data source has been segmented and one or more of the segments has been mapped,
you cannot remove SELECT values from the segment definition.
<p><b>Important</b>: The filters you use to define segments are applied to both
inbound and outbound jobs and defects. When configuring segments for mirroring,
you must ensure that jobs or defects that are selected from a source for replication
are not filtered out by the target, and vice versa. In other words, you must
define sources and their segments in such a way that the desired sets of jobs
and defects flow in both directions.
<hr>
<a href="about.html">About</a><br>
<a href="index.html">Contents</a><br>
<i><font size="-1">segments.html</font></i> </html>