Perforce · Schema
Perforce Helix Swarm Review
A code review in Perforce Helix Swarm (P4 Code Review), representing a set of changelists under review with participants, votes, state transitions, and test/deploy status.
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | The unique review identifier assigned by Swarm. |
| author | string | The Perforce username of the review author. |
| changes | array | List of changelist IDs associated with this review. |
| commits | array | List of committed changelist IDs resulting from this review. |
| commitStatus | array | Status details for commit operations on this review. |
| created | integer | Unix timestamp when the review was created. |
| deployDetails | array | Details of deployment operations triggered by this review. |
| deployStatus | stringnull | The current deployment status for the review. |
| description | string | The review description, typically derived from the changelist description. |
| groups | array | Reviewer groups assigned to the review. |
| participants | object | Map of participant usernames to their participation details, including votes and required status. |
| pending | boolean | Whether the review is associated with a pending (shelved) changelist. |
| projects | object | Map of Swarm project IDs to the branch names affected by this review. |
| roles | object | Map of role names to lists of usernames holding those roles. |
| state | string | The current state of the review in its lifecycle. |
| stateLabel | string | A human-readable label for the current state. |
| testDetails | array | Details of test runs executed against this review. |
| testStatus | stringnull | The overall test status for the review, such as pass or fail. |
| type | string | The review type. Default reviews are standard; personal reviews are private to the author. |
| updated | integer | Unix timestamp when the review was last updated. |
| updateDate | string | ISO 8601 formatted date-time when the review was last updated. |
| versions | array | History of review versions, each representing an update to the shelved changelist. |