Versions Compared

Old Version 4

changes.mady.by.user Bob Swift

Saved on

compared with

New Version Current

changes.mady.by.user Elena Amandola (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel3
minLevel3
typeflat
separatorpipe

Workflow functions

  1. CLI action (validator) - check information from a CLI action before allowing a transition
  2. CLI action (post-function) - run a CLI action after the transition has completed

Both share similar parameters and capabilities.

Related documentation

Usage

Administrator authority is required to add or update workflow actions. This is required to use JCLIP. 

  1. Create a draft workflow
  2. Edit the workflow
  3. Find the workflow step
  4. Select Validators or Post Functions tab
  5. Select Add
  6. Find and select CLI action

Parameter input dialog

CLI action validators and post functions share the same parameters.

Table plus


FieldDescription
Condition 1

Conditions determine whether or not the CLI action should be run.

  • In the case of validators, a failed condition will fail the validator
  • In the case of post functions, a failed condition will prevent the CLI action from being attempted

Value, regex pattern for matching, and pattern options.

See How to use pattern matching conditioning.

Condition 2Another condition. Both conditions must be successful to proceed to run the CLI action
Product

Select the Atlassian product to be accessed

  • JIRA
  • Service Desk
  • Confluence
  • Bamboo
  • Bitbucket
  • HipChat
  • Crucible
  • FishEye
    • ActionProvide an action string valid for the product selected - same as what you would do from a command line
    DataSome CLI actions can input data from standard input or using the file parameter and this allows the input data to be provided directly
    • When using the file parameter, specify to use standard input: file -
    CLI find pattern 1A regex pattern that is used to find data on the result produced by running the CLI action
    • For a validator, if the pattern is not found, the validator will fail
    • Regex find groups are available as substitution variables using syntax like 
    %pattern1
    • %cli_pattern1_1%, 
    %pattern1
    • %cli_pattern1_2%, etc ...
    CLI find pattern 2A second regex pattern similar to find pattern1
    • Regex find groups are available as substitution variables using syntax like 
    %pattern2
    • %cli_pattern2_1%, 
    %pattern2
    • %cli_pattern2_2%, etc ...
    MessageValidator error message and workflow property value
    • If validator fails (action fails or one of the find patterns do not match), this error message will be shown as a transition error
    • Use text and substitution variables to construct a reasonable message
    • For both validators and post functions, this message is passed as a workflow property for access in subsequent CLI actions
    NotesThis provides administrators an opportunity to better document this workflow function


     


    Variable substitution

    A variety of substitution variables are available to use in text parameters.

    CategoryVariablesWhere UsedDiscussion
    Issue special values

    %issue_key%

    %issue_summary%

    %issue_description%

    %issue_affected_versions%

    %issue_fixed_versions%

    %project%

    Action, Data, Message

     


    Parent issue special values

    %parent_key%

    %parent_summary%

    %parent_description%

    %parent_affected_versions%

    %parent_fixed_versions%

    		Action, Data, MessageOnly available if issue is a subtask
    Issue field values%fieldname%Action, Data, Message

    Any JIRA defined field name.

    Like summary, description, environment, issueType, priority, resolution, versions, fixVersions, components, duedate, reporter, assignee, timetracking, id

    Issue custom field values%customfieldname%Action, Data, MessageIssue specific custom field name
    CLI values

    %base_url%

    %validator_message%

    %function_message%

    		Action, Data, Message

    URL of this JIRA instance - useful for local JIRA actions

    Message field from last run CLI action validator

    Message field from last run CLI post function

    Action result%cli_message%MessageResult message from running the CLI action
    Pattern replacements

    %pattern1_n%

    %pattern2_n%

    		Message

    Regex group value from evaluating find pattern1 or pattern2.

    n represents the regex group number (1, 2, ...) - equivalent of $n substitution in other regex based usage.

    Image Removed

    Image Removed

    Image Removed