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.

Tip

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 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 and each computer. You can use a naming convention of <USERNAME>_<COMPUTER_NAME>_<PROJECT_NAME>. 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. To access the file options, click the Workspaces tab. Right-click the workspace you created and select Edit workspace. Click the Advanced tab. Under File Options, select any of the following options:

    • 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.

    • 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. Click OK to create the workspace and switch to it.

  8. 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.

    Tip

    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

Next, populate the stream with files.

Go to Step 10: Add and work with versioned files.