Creating Segments

To replicate selected defects from a single data source to multiple other defect trackers or SCM systems, you create segments. 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.

To create a segment for a Perforce or Defect Tracking Source:

1. Before creating segments, stop the replication engine (on the Gateway Mappings tab, click Stop Replication.)
2. Click Edit Segments... The Edit Segments dialog is displayed.
3. Specify the field to be used to filter defects by choosing the field from the Segment using SELECT field list. (The fields listed are SELECT fields returned by the data source plugin.)
4. To add a segment, click New... In the New Segment dialog, specify a name for the segment and click OK.
5. Specify the values that you want to include in the segment by moving them from the Unassigned options column to the Included options column.
6. To save your segment definition, click OK.
7. Start the replication engine (on the Gateway Mappings tab, click Start Replication.)

To continue the preceding example, you can create a segment named "Database" that selects all Perforce jobs with the Subsystem field set to "db" and another segment named "Web Application" that selects all Perforce jobs with the Subsystem field set to "webapp".

To use segments for replication, choose the segment when defining mappings on the Gateway Mappings tab. 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.

Important: 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.