Configuring Administration Tool Preferences

To configure settings for the Administration Tool, choose Edit > Preferences... (Windows) or P4Admin > Preferences... (Mac). The Preferences dialog includes the following configuration pages:

Click Apply to save your changes. Click OK to save your changes and exit the dialog.

Connections

You can configure the following settings for connecting to Perforce servers:

When the application launches:

  • Restore all previously opened connections: Do not prompt for connection settings; reconnect to the server to which you were connected during your last session.

Opening and closing connections:

  • Use IP-specific tickets when logging in: Specifies whether your login ticket is restricted to the IP address from which you are connecting.

  • Automatically log off when closing a connection: Specifies whether your ticket is invalidated when you log out.

Logging

You can configure the following logging options:

Log pane options:

  • Show p4 reporting commands: Specifies whether the log pane in the Administration Tool window displays all commands issued by the Administration Tool, including commands issued by the Administration Tool to obtain status information from the Perforce server.

Logging to a file:

  • Enable logging to file: Logs Administration Tool activity to the specified file.

    • Name: Specifies the name and location of the log file.

    • Size: Specifies the maximum size of the log file.

Display

You can configure the following Administration Tool display and localization options:

Application:

  • Show the What's New in P4V page after upgrading: Display the What's New page as a tab in the P4V window.

  • Dates: Sets the date format used throughout the Administration Tool.

    • Use OS format for dates: Use the format that your operating system uses.

    • Format dates using Perforce standard (yyyy/mm/dd hh:mm:ss)

Localization:

  • Language used for application menus, labels, and dialogs (requires restart): Select language.

  • Set encoding for all connections to: Sets the character encoding for connections to unicode-mode Perforce servers.

    If you do not set the encoding here, you are prompted to enter the character encoding every time you set up a connection to a unicode-mode Perforce server. The encoding that you set here does not affect server connections whose character encoding has already been set at connection. If you are unsure which setting to choose, consult your Perforce administrator.

Files

You can configure the way the Administration Tool displays files and file icons:

  • Show Perforce filetype for files in the Workspace and Depot tree: Toggles display of filetype in the tree panes.

  • Show revision information for files in the Workspace and Depot tree:Toggles display of revision numbers in the tree panes.

  • Render thumbnails for Maya files: Enables the Administration Tool to display thumbnail images of Maya media files.

  • File preview font: Specifies the font that the Administration Tool uses to display files in the preview pane.

    Click Show fixed sized fonts only to limit the selection in the font drop-down to fixed-sized fonts.

Behavior

You can configure the following Administration Tool user interface behaviors:

Prompts:

  • Warn before reverting files: Specifies whether the Administration Tool displays a prompt before reverting files.

  • Prompt for changelist when checking out, adding, or deleting files: Specifies whether the Administration Tool displays the "Choose changelist" dialog when you open files.

  • Prompt to get latest revision when checking out files that are out of date

  • Prompt when connecting to a new Perforce Sandbox: Specifies whether the Administration Tool displays a prompt before you connect to a new Perforce Sandbox.

Drag and drop:

  • Enable integration on directory-to-directory drag and drop: Launches the Merge/Integrate dialog when you drop a folder on another folder.

  • Enable diff comparisons on file-to-file drag and drop: Launches the Diff dialog when you drop a file on another file.

Tools

You can configure the following Revision Graph and Time-Lapse View options:

Revision Graph:

  • Use software rendering for Revision Graph: Enable only if your machine is having problems rendering Revision Graph output. For details, consult the Perforce Knowledge base.

  • Limit Revision Graph to ancestors and descendants: Controls how much of a file's integration history is displayed.

Time-Lapse View:

  • Show branch history in Time-lapse View by default: Specifies whether Time-lapse View displays the integration/merge history for the selected file by default. You can also toggle the display of integration history in Time-lapse View.

Editor

To associate file types with the applications you use to edit them:

  1. Click Add.

  2. Select a file extension from the drop-down list.

  3. Enter or browse for the associated application.

  4. (Optional) Select Always use the selected application to open files of this type to set the application as the default.

  5. Click Save.

You can enter as many applications as you like for each extension. All of the applications will appear as options when you context-click a file in the Administration Tool and select Open With.

Note

Any application that you've used to open a file from the context menu in the Administration Tool appears by default as an associated application on the Editor page in the Administration Tool Preferences dialog, unless you remove it.

Diff

To set the default diff application, select one of the following:

  1. P4Merge: Perforce's companion diff tool.

  2. Other application: Browse to your preferred diff tool.

    To specify arguments for third-party diff applications, enter %1 for the name of the first file and %2 for the name of the second file in the Arguments field. Perforce replaces these placeholders with the actual filenames when calling the diff application.

To assign diff applications by file type:

  1. Click Add.

  2. Select a file extension from the drop-down list.

  3. Enter or browse for the associated application.

  4. Specify arguments for third-party diff applications in the Arguments field:

    Enter %1 for the name of the first file and %2 for the name of the second file. The Administration Tool replaces these placeholders with the actual filenames when calling the diff application.

  5. Click Save.

    The extension and associated application are displayed in the list of file type-application associations.

Applets

You can enable Perforce servers to serve applets that can run in the Administration Tool. In order for these applets to run in the Administration Tool, you must enable applets in your Administration Tool preferences. For more information about Perforce applets, see the Perforce JavaScript API for Visual Tools Users Guide.

To enable Perforce applets to run in the Administration Tool:

  1. Select Allow Perforce applets to run in P4Admin.

  2. Specify the Perforce servers from which you are willing to accept Perforce applets:

    • Enter the Perforce server name or host:port in the Server field.

    • Click Add.

  3. Click Advanced... to specify the following settings:

    • Save cookies from applets (Click Remove Cookies to delete all applet-generated cookies).

    • Allow applets to store data locally

    • Manually configure web proxy used by applets for internet access: Enter the web proxy address and port.