Action Source Control

Perforce Operations

Performs basic Perforce operations like Edit, Add, Delete, Revert, Submit, and Sync. Requires the 'p4' command-line tool.

Node IDP4OperationsAction

Parameters

Parameter	Type	Required	Default	Description
P4 Workspace/Client `p4_client`	`string`	Yes	—	The Perforce workspace (client) name to use.
Workspace Root Path `workspace_root`	`file_picker`	Yes	—	The local file system path to the workspace root directory (e.g., C:/path/to/workspace). Commands will be executed from this directory.
Operation `operation`	`enum` `Edit` `Add` `Delete` `Revert` `Submit` `Sync`	Yes	`Edit`	The Perforce operation to perform.
P4 Server (Optional) `p4_port`	`string`	No	`localhost:1666`	Perforce server address (e.g., ssl:server:1666). If not provided, uses P4PORT from environment or P4 config.
P4 User (Optional) `p4_user`	`string`	No	—	Perforce username. If not provided, uses P4USER from environment or P4 config.
P4 Password Vault Key (Optional) `p4_password_key`	`string`	No	`P4PASSWD`	Vault key for the Perforce password. Only needed if not already authenticated via P4TRUST.
Asset Paths `asset_paths`	`array_string`	No	—	The files to act on. Required for Edit, Add, Delete, and Revert operations. Leave empty for Sync to sync entire workspace.
Submit Description `submit_description`	`textarea`	No	—	The description for the changelist. Required for Submit operation.
Changelist (Optional) `changelist`	`string`	No	—	The changelist number to operate on. If not provided, uses 'default' changelist.
Force Operation `force`	`boolean`	No	`false`	Force the operation (e.g., 'p4 sync -f' or 'p4 revert -a'). Use with caution.

Inputs

Input	Type	Required	Description
Execute `input0`	`object`	Yes	An execution signal. Can carry a list of file paths for operations that need them.

Outputs

Output	Type	Identifier	Description
Result `output0`	`object`	`p4_result`	Emits a data object with details from the operation, like a changelist number or command status.