Workflow.yaml #2

# This is the config file for various workflow triggers:
# - CreateSwarmReview.py
# - CheckSubmitHasReview.py
# - DefaultSwarmReviewDesc.py
# - RequireJob.py
# In an SDP installation the default location is /p4/common/config
# But it can be specified on the command line (so in trigger table entry)
# It is a standard Yaml format - when in doubt put quotes around string values!

# api: API version for Swarm. "api/v6" is 2017.2
api: "api/v6"

# user: Perforce user name to access Swarm as
user: p4swarm

# ticket: P4 Ticket for the above user - generate with:
#   p4 -u <username> login -ap
ticket: AA1233C0FD5EF69605B08070AFB86711

# review_description: The default review description.
# Can be a single quoted string (with embedded '\n' for newlines, or an array of quoted strings.
# The values $jobDescription and $changeDescription if found will be expanded as
# appropriate.
review_description:
  - "$jobDescription"
  - ""
  - "<Please edit these fields as desired>"
  - "Review type: Delta/Full"

# ------------------------------------------
# For CheckFixes.py

# fix_state_field: the name of the field in the Perforce job spec
fix_state_field: "JiraStatus"

# link_allowed_states: An array of values for fix_state_field in which links are allowed to be created
# or deleted between jobs and changelists
fix_allowed_states:
  - "Accepted"

# msg_cant_link_jobs: An array of lines for the message
# For legibility it is good to have the first line blank
msg_cant_link_jobs:
  - ""
  - "You are not allowed to link changes to or unlink changes from these jobs"
  - "because of the state of their associated JIRA issues."
  - "Please change the state first in JIRA and try again."

# ------------------------------------------
# For CheckSubmitHasReview.py

# msg_submit_requires_review: An array of lines for the message
# For legibility it is good to have the first line blank
msg_submit_requires_review:
  - ""
  - "You are not allowed to submit a change without a review."
  - "Please shelve the change for Swarm review first."
  - "Jenkins will build the change and if successful submit on your behalf."
# ------------------------------------------


# Projects - an array of project entries
# Each project expected to have entries for:
# require_job:  y/n   - for pre-submit or pre-shelve trigger - whether a job is required or not
# post_submit_create_review: y/n  - whether to create a review on submit
# pre_submit_require_review: y/n - read by CheckSubmitHasReview.py to avoid bypassing pre-submit review
# update_review: y/n  - if y then try and update the first review found associated with linked job
# depot_paths: an array of values for which to process other fields
#     Controlling here allows you to not have to update the trigger table entry every
#     time you wish to adjust. Also, it is possible to have this file be updated by ordinary
#     users and not just superusers. You can even auto-sync this file if required via trigger.
#     Use quotes if spaces in the path, or if you have an exclude mapping ("-//some/path/...")
# default_reviewers: an array of user ids - reviewers to be added by by default for reviews for this project
projects:
  - name:                       ProjectA
    post_submit_create_review:  y
    pre_submit_require_review:  y
    require_job:                y
    update_review:              n
    depot_paths:
      - //depot/inside/A/...
      - //depot/inside/A1/...
      - "-//depot/inside/....c"
    default_reviewers:
      - user1
      - user2

  - name:                       ProjectB
    post_submit_create_review:  n
    pre_submit_require_review:  n
    require_job:                y
    update_review:              n
    depot_paths:
      - //depot/inside/B/...
      - //depot/inside/B2/...
    default_reviewers:
      - user1
      - user2