Adding Perforce P4 source control providers

Add a Perforce P4 provider to specify a source control integration connection for the Perforce ALM project. This makes it easier for users to set up the integration in ALM because the server connection is already configured. See Third-Party Integrations for a list of supported versions.

If your team uses P4 Code Review, you can specify the URL to provide hyperlinks to source files and changelists on the ALM item Source Files tab and in other areas, such as reports.

You must also add a provider if you use triggers to allow users to attach changelists to ALM issues, test cases, and requirements from P4 clients.

1. Choose Tools > Administration > Source Control Providers.

The Source Control Providers dialog box opens.

2. Click Add.

3. Enter the provider Name. You can enter up to 256 characters. Provider names must be unique.

4. Select Perforce P4 as the Type.

5. Enter the P4 Server address and Server port.

6. If you use P4 Code Review, enter the base P4 Code Review URL to provide hyperlinks to attached source files and changelists.

This base URL is automatically appended with the appropriate path for attachments on the Source Files tab in ALM items. For example, if the P4 Code Review URL is http://swarm.wysicorp.com, the following hyperlink formats are used:

  • Files—http://swarm.wysicorp.com/file/<depot_file_path>?v=<file_version>
  • Changelists—http://swarm.wysicorp.com/changes/<changelist_number>

7. Click OK to save the provider.

After the provider is added, it is available to select in the Source Control Integration Local Options dialog box when users enable the integration. See Configuring source control integration.

The read-only Provider key field and Active option are only used if you add P4 triggers to allow users to attach changelists to ALM items from P4 clients. The provider key is required in the script that runs the triggers and Active must be selected. See Configuring triggers to attach changelists from Perforce P4 clients to Perforce ALM items.