KBEC-00349 - How to get the valid options for a given data type

Summary:

This article discusses how to get the valid options for a given data type.

Solution:

When you want to use the ElectricFlow/ElectricCommander API or DSL by referring to the online help for specific API call, you may find for some arguments the document provide a data type but you don't know what are valid options. For example, starting from ElectricFlow 6.4, an enhanced error handling option in the pipeline Stage task was introduced, Gate approvals and Deployer which is specified via "errorHandling" argument with data type of "FlowStateErrorHandling". You may wonder what are the valid options for that "FlowStateErrorHandling" when you hit the online document below.

http://docs.electric-cloud.com/eflow_doc/6_4/API/HTML/content/apipipelines.htm#createTask

Usually you can get such valid options via "ectool --help". For example in this case, you can find it below.

>ectool createTask --help
>Usage: createTask  
 [--actualParameter = [= ...]]
 [--advancedMode <0|1|true|false>]
 [--afterTask ]
 [--approvers approver1 approver2 ...]
 [--beforeTask ]
 [--description ]
 [--enabled <0|1|true|false>]
 [--environmentName ]
 [--environmentProjectName ]
 [--environmentTemplateName ]
 [--environmentTemplateProjectName ]
 [--errorHandling ]
 [--gateType ]
 [--instruction ]
 [--keepOnError <0|1|true|false>]
 [--notificationTemplate ]
 [--pipelineName ]
 [--skippable <0|1|true|false>]
 [--snapshotName ]
 [--stageName ]
 [--startTime ]
 [--subapplication ]
 [--subpluginKey ]
 [--subprocedure ]
 [--subprocess ]
 [--subproject ]
 [--subworkflowDefinition ]
 [--subworkflowStartingState ]
 [--taskProcessType ]
 [--taskType ]
 [--tierResourceCount = [= ...]]
 [--workspaceName ]

Then you can see the valid options for "FlowStateErrorHandling" are continueOnError and "stopOnError" via below line.

--errorHandling 

Applies to:

• Production version: All
• OS: All