updating.md

Updating from v1 to v2

Breaking changes

• The format of the slash_command context has been changed to prevent an issue where named arguments can overwrite other properties of the payload.

  The following diff shows how the slash_command context has changed for the example command /deploy branch=master smoke-test dry-run reason="new feature".

    "slash_command": {
        "command": "deploy",
  -     "args": "branch=master smoke-test dry-run reason=\"new feature\"",
  -     "unnamed_args": "smoke-test dry-run",
  -     "arg1": "smoke-test",
  -     "arg2": "dry-run"
  -     "branch": "master",
  -     "reason": "new feature"
  +     "args": {
  +         "all": "branch=master smoke-test dry-run reason=\"new feature\"",
  +         "unnamed": {
  +             "all": "smoke-test dry-run",
  +             "arg1": "smoke-test",
  +             "arg2": "dry-run"
  +         },
  +         "named": {
  +             "branch": "master",
  +             "reason": "new feature"
  +         },
  +     }
    }

• The named-args input (standard configuration) and named_args JSON property (advanced configuration) have been removed. Named arguments will now always be parsed and added to the slash_command context.

• The client_payload.github.payload.issue.body and client_payload.pull_request.body context properties will now be truncated if they exceed 1000 characters.

New features

• Commands can now be dispatched via the new workflow_dispatch event. For standard configuration, set the new dispatch-type input to workflow. For advanced configuration, set the dispatch_type JSON property of a command to workflow. There are significant differences in the action's behaviour when using workflow dispatch. See workflow dispatch for usage details.

• Added a new input static-args (standard configuration), and a new JSON property static_args (advanced configuration). This is a list of arguments that will always be dispatched with commands.

  Standard configuration:

          static-args: |
            production
            region=us-east-1

  Advanced configuration:

          "static_args": [
            "production",
            "region=us-east-1"
          ]

• Slash command arguments can now be double-quoted to allow for argument values containing spaces.

  e.g.

  /deploy branch=master dry-run reason="new feature"
  

  /send "hello world!"
  

• The commands input can now be newline separated, or comma-separated.

  e.g.

          commands: |
            deploy
            integration-test
            build-docs