Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Select the Files Tab. Context-click on Filesystem
  2. Select Checkout Project
  3. Under General Tab, select Perforce
  4. Enter 999pxEnter the Server URI, username, and password. Note that the URI starts with p4jrpc://
  5. Choose the first radio button to select an existing Perforce client workspace
Perforce - Connecting - Select CheckoutImage Removed

Image Added

Perforce - Connecting - Existing WorkspaceImage Removed

Image Added

Perforce Connecting
Select Checkout
Perforce Connecting
Existing Workspace

Create a new Perforce Workspace with Aqua Data Studio

  1. Select the Files Tab. Context click Filesystem
  2. Select Checkout Project
  3. Under General Tab, select Perforce
  4. Enter the Server URI, username, and password. Note that the URI starts with p4jrpc://
  5. Choose the second radio button to Create a new Perforce client workspace
Perforce - Create New WorkspaceImage Removed

Image Added

Perforce Create
New Workspace

Syncing your Workspace

To populate your workspace with the depot files, do a Version Control --> Update(Sync)

  1. Select the Perforce workspace you mounted in ADS
  2. Right-click and select Update(Sync)
Perforce - Syncing your WorkspaceImage Removed

Image Added

Perforce Syncing
your Workspace

Once all the files are updated, you will see a message Completed, which indicates displaying the completion of the updates and that you have the most updated files in your workspace

...

  1. Create new text or SQL files or copy the files you require to be in version control to the Perforce Repository created using Aqua Data Studio
  2. Multi-Select the files, right-click and select Version Control --> Mark for Add. If you see a '+' sign before the files, these are added to version control
  3. To Commit the files, right-click on the directory and select Commit.
Perforce - Add Files - Mark for AddImage Removed

Image Added

Perforce - Add Files - SubmitImage Removed

Image Added

Perforce Add Files
Mark for Add
Perforce Add Files
Submit

Once all the files are committed, you will see a green tick mark to indicate that the files are now versioned.

...

  1. Select the file you need to edit.
  2. Right-click and select Version Control > Check Out. Notice that the Green Tick mark now turns red. This indicates it is Versioned and can be modified now.
  3. Next, right-click and select Open
  4. Make the necessary changes
Perforce - Checkout - FileImage Removed

Image Added

Perforce - Checkout - Edit - FileImage Removed

Image Added

Perforce Checkout
File
Perforce Checkout
Edit File

If you are required to Edit many files, Select them all, right-click and select Check Out

...

  1. Select the file you need to Check-in
  2. Right-click and select Version Control > Submit. Notice that the icon changes to the Green Tick
Perforce - Check In - FileImage Removed

Image Added

Perforce Check In Files

Revert unwanted changes

Suppose you want to restore the copy of your file to the revision last synced to your workspace, how will you proceed with the operation?

  1. Select the file you need to edit.
  2. Right-click and select Version Control > Revert. Notice that the icon changes to match the file's previous state.
Perforce - Revert FilesImage Removed

Image Added

Perforce Revert Files

If at all you are required to Revert entire files inside a folder, you can do so by just selecting the Folder and right-click and selecting Version Control > Revert, instead of selecting each file individually.

...

  1. Under Filesystem, select your Perforce repository. Right-click and select Version Control > Browse Depots
  2. You can see the available Depots.
  3. Expand the nodes and you can see the different folders and files
Perforce - View DepotImage Removed

Image Added

Perforce - View Depot - Navigate FilesImage Removed

Image Added

Perforce View Depot
 
Perforce View Depot
Navigate Files

Another way is

  1. Under Filesystem, select your Perforce repository. Right-click and select Version Control > Properties
  2. In the Perforce Properties dialog, click Depots
  3. You can see the available Depots.
  4. Expand the nodes and you can see the different folders and files

...

  1. Under Filesystem, select your Perforce repository. Right-click and select Version Control > Edit Workspace Client
  2. Click on the View Tab
  3. Expand the depot
  4. Right-click on the Folder you are interested in
  5. Select from options Exclude Tree, Include Tree, Include Files, Exclude Files, Include Special .. and Exclude Special...
Perforce - Edit WorkspaceImage Removed

Image Added

Perforce - Edit Workspace - View TabImage Removed

Image Added

Perforce - Edit Workspace - Form TabImage Removed

Image Added

Perforce
Edit Workspace

 
Perforce
Edit Workspace
View Tab
Perforce
Edit Workspace
Form Tab

Notice corresponding Client Expression is generated on the right most tab. If you click on the Form Tab and navigate to the bottom you can see View with all the client expressions for the Depot

...

  1. The upper left pane shows the series of revision number
  2. The Changelist is the basic unit which consists of a list of files, their revision numbers, the changes you made to the files, and a comment
  3. You can view the comments for each commit under the header description 
  4. Select a commit and right-click. Now select Show Changes and you can see the list of files impacted for this particular commit.
  5. The lower panel shows the commit details, including the full diff
Perforce - Show HistoryImage Removed

Image Added

Perforce - Show History - Show ChangesImage Removed

Image Added

Perforce Show History
 
Perforce Show History
Changes

Depot Browser

The Aqua Data Studio Depot Browser is a convenient way to view all of the contents of the Perforce Server. While the Depot Browser shows details on item history, it does not show the status of local working versions. It is more for exploring the remote repository and its contents than managing the local versions of files.

...