Step 3: Create a workspace | Helix Core Cloud end users

A workspace links a local folder on your computer to a stream on the Helix Core Server. It lets you sync files in the stream to your computer so you can work on them and submit changes. You will create one workspace for now, but may 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 computer. For example, if you want to work on a project from your laptop and your desktop, create a workspace on each computer.

  1. Ask your administrator or project lead which Helix Core stream you will use for your project.

    Streams are the preferred way to handle branching and merging in Helix Core.

  2. In P4V, choose Connection > New Workspace.

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

    Each workspace is unique to each user and each computer. You may find it helpful to use a naming convention of <username>_<computer_name>_<project_name>. For example, auser_auserMac_StellarPlaza.

  2. Set the Workspace root, which is the folder on your computer where you will store files from Helix Core Server and add or edit files to submit to the server.

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

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

  4. Click the Advanced tab.

  5. In the File Options area, select Modtime and Rmdir.

    • Modtime sets the modification times to what they were in the submitter's workspace when they submitted them. This makes some functions run faster.

    • Rmdir cleans up empty folders in the workspace.

  6. In the On submit field, select Revert unchanged files.

    Selecting this option prevents you from creating new versions of files when no changes were made to them.

  7. Select Switch to new workspace immediately.

  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 workspace name is displayed in the title bar of the window. 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 of your workspaces, choose View > Workspaces to open the Workspaces tab in the right pane.

Learn more

Where to go next

Next, you can start adding files to Helix Core Server to version them or work with files that are already under version control.

Go to Step 4: Start versioning files | Helix Core Cloud end users.