PhpStorm 2024.3 Help

Attach and detach Perforce jobs to changelists

The Perforce integration with PhpStorm provides you with a user interface for attaching and detaching Perforce jobs to changelists.

Note that the integration does not support creation of Perforce jobs.

To get access to working with Perforce jobs, select the Enable Perforce Jobs Support checkbox on the Perforce page of the Settings dialog.

From this topic you will learn how to:

  • Attach jobs to changelists:

  • Find the desired job to attach to a changelist using:

    • The standard search functionality, which enables you to specify numerous search criteria and thus to flexibly configure the search procedure.

    • The quick search functionality, which enables you to have the found job linked to the changelist automatically.

  • Detach jobs from changelists.

To find and link a job at any stage of your work

  1. Open the Commit tool window Alt+0.

  2. Select the changelist you want to link a job to.

  3. From the context menu of the changelist, choose Edit Associated Jobs.

  4. Find the desired job. Do one of the following:

  5. View the details of the found job and click OK.

To find and link a job during commit

  1. In the Changes view, select the changelist you want to link a job to and open the Commit Changes dialog.

  2. Find the desired job using the controls in the Jobs area. Do one of the following:

  3. View the details of the found job and continue the commit procedure.

To find a job using the standard search functionality

  1. In the dialog that opens or in the Jobs area of the Commit Changes dialog, click the findPerforceJob.png button.

    Which dialog you are currently in depends on whether you are linking jobs during commit or at any other stage of work.

  2. In the dialog that opens, specify the desired search parameters.

  3. Click the Search button. The jobs that match the specified criteria are shown in the Search Results list. To view the details of a job, select it in the list.

  4. Select the desired job and click OK. The dialog closes, and you return to the dialog where you started the search:

To quickly find and link one job

  1. Open the Edit Jobs Linked to Changelist dialog or switch to the Jobs area of the Commit Changes dialog.

    The dialog to be used depends on whether you are linking jobs during commit or at any other stage of work.

  2. In the field, type the desired job name search pattern and click the button. The job is found and automatically linked to the current changelist.

    If no job matching the specified pattern is found, the corresponding information message is displayed.

To detach a job from a changelist

  • In the Edit Jobs Linked to Changelist dialog or in the Jobs area of the Commit Changes dialog, select the desired job and click the button.

    The dialog to be used depends on whether you are detaching jobs during commit or at any other stage of work.

Last modified: 17 June 2024