Jeremias Meister - Tools & Pipeline

Action Source Control

Perforce Status

Checks the status of a Perforce workspace and outputs lists of files by their status. Requires the 'p4' command-line tool to be in the system's PATH.

Node IDP4StatusAction

Parameters

ParameterTypeRequiredDefaultDescription
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.
Detection Method detection_method enum
  • status
  • opened
  • both
 Yes both How to detect changes. 'status' auto-detects local changes (like Git), 'opened' only shows files in pending changelists, 'both' combines them.
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.

Inputs

InputTypeRequiredDescription
Execute input0 object Yes An execution signal to trigger the status check.

Outputs

OutputTypeIdentifierDescription
Edited Files output0 object edited_files A list of absolute paths for files that have been opened for edit or modified locally.
Added Files output1 object added_files A list of absolute paths for files that have been opened for add or are new locally.
Deleted Files output2 object deleted_files A list of absolute paths for files that have been opened for delete or deleted locally.
Modified Files output3 object modified_files A list of absolute paths for files that have been modified locally but not opened.
All Changed Files output4 object all_changed_files A combined list of all files with any status change.