Step 9: Create a workspace | Admin

A workspace is the directory on your computer where assets that you are working on are stored. Each workspace is linked to a stream on the Helix Core Server.

Having a workspace lets you download files from the depot to your workspace, make changes to the files, and upload files to the server.

You will create one workspace for now. You can create others in the future depending on how your team uses Helix Core.

Because a workspace is linked to a specific folder on your computer and your Helix Core user account, a workspace is unique per user, per stream depot, and per computer. For example, if you want to work on a project from your laptop and your desktop, create a workspace on each computer.

To learn more about creating a workspace, watch this video or review the instructions following the video.

  1. In P4V, right-click the stream you previously created in the Stream Graph view and choose New Workspace.

  2. In the Workspace dialog box, enter a Workspace name.

    Each workspace is unique to each user, each stream depot, and each computer. You can use a naming convention of username_computer_project. For example, auser_auserMac_StellarPlaza.

  3. Set the Workspace root, which is the directory on your computer where versioned assets that you are working on are stored.

    Use a new, empty folder on your computer with the same name as the workspace. By default, the workspace root folder is in the user’s home directory in the Perforce folder. To select a different location, click Browse.

  4. Check the Stream to make sure the correct one is selected for the workspace. To change the stream, click Browse and select the stream to connect the workspace to.

  5. Optionally set the following File Options based on your preferences. Click the Advanced tab. Under File Options, select any of the following options. As best practice, set Modtime, Rmdir, and Revert unchanged files.

    File option Description
    Allwrite

    Leaves all workspace files writable when getting revisions.

    If you set this option without setting other options to prevent overwrites, you might inadvertently overwrite changes or cause syncs to fail.

    Clobber Overwrites writable workspace files when getting revisions.
    Compress Speeds up slow connections by compressing files when submitting or getting revisions.
    Modtime Sets the modification times to what they were in the submitter's workspace when they submitted files. This makes some functions run faster.
    Rmdir Cleans up empty folders in the workspace.
    Altsync Gives file metdata when getting revisions.
    Revert unchanged files In the On Submit field: Prevents you from creating new versions of files when no changes are made to them.
  6. Select Switch to new workspace immediately.

  7. If you want the latest file revisions saved to your computer as you work, select Automatically get all revisions. When you populate the workspace, the latest revisions will automatically be synced.

  8. Click OK to create the workspace and switch to it.

  9. Click the Workspace tab in the left pane. The workspace you created is selected in the list and displayed in the window's title bar.

    If you have multiple workspaces associated with different folders on the computer, you can access the most recent ones in the list.

To see all your workspaces, choose View > Workspaces to open the Workspaces tab in the right pane.

After you create a workspace, you can add and work with versioned assets.

What's next

It is best practice to ignore (not version) some files for security or performance reasons. You can specify ignored paths at the stream level or by using a p4ignore file.

Next, go to Step 10: Configure ignored files.