Managing Perforce Server Sources

To add a Perforce Server source:

1. Click New. The Add Perforce Server Source dialog is displayed.
2. Enter the server connection details (see below).
3. Click Check connection and jobspec. If you have correctly specified valid values, the dialog displays a success message in the Server status field. If a connection error is displayed, correct your entries and again click Check connection and jobspec. P4DTG retrieves and displays reference field data for the specified Perforce server. If the Server status field says that the server is not configured, you must add the required fields to the Perforce job specification. For details, see the Perforce Defect Tracking Gateway User's Guide.
4. Click OK to save your entries and dismiss the dialog.

Server Connection Details

• Name: an alias for the Perforce server and its associated connection information.
• Server: the name of the Perforce server host machine and the port on which it is running. Specify as hostname:port; for example p4host:1667.
• User name: the user name to be used to connect to the Perforce server when data is read or written.
• Password: password for the specified user, if required.
• Reference fields: The data required to replicate issues and jobs. The references fields are:
  • Modified Date: the date that the job was last updated

  • Modified By: the Perforce user who last updated the job.

Important: To ensure that you can distinguish jobs modified by the gateway, create a dedicated Perforce user to be used only by the gateway. The user name must be used only for defect replication. Do not use this user name for any other purpose. Ensure that the user name is neither a prefix nor a suffix of any other user name. For example, if you already have a Perforce user named “admin-logger,” do not assign “admin” or “logger” as the user name.

To edit a Perforce server source: click the source in the Perforce server sources list, then click Edit.

To configure filtering of selected defects to replicate them to differing defect trackers or SCM systems, define segments.

To delete a Perforce server source: click the source in the Perforce server sources list, then click Delete. The source is marked for deletion. To delete the source permanently, click Apply or OK. To undelete a marked source, click the source that is marked for deletion, then click Undelete.