[Bug] az boards iteration project create path parameter

[ishitam8]

Reference az cli issue here

Issue details
Currently parameter has exmple of: ProjectNameIterationIterationName. Please give more detailed example what is the syntax here.

Here is example of working syntax:

az boards iteration project create --name "S01" --start-date "2020-01-01"
--finish-date "2020-01-14" --path "\MyProject\Iteration\ParentIterarionPath"
--org $org --project $project

There needs to be always hardcoded path part ...\Iteration... between your Azure DevOps project name and the parent iteration.

[ishitam8]

hi @oulasvirta,

Thanks for reporting this.

When you look at command help text, its accurate
[i.e Example:\ProjectName\Iteration\IterationName.].

But doc is not rendering the help text as is.

[geverghe]

Dropping bug label since the text is rendered properly on command help and this is a pure documentation issue.

[mitch-b]

Hi, the same issue exists in Area Path docs as well. Please see: Azure/azure-cli-extensions#1253

[dairik111]

Please note that I am experiencing an issue with the --path parameter as it is described in the help documentation.
Error: az : --path parameter is expected to be absolute path.

Version: azure-cli 2.5.1
command-modules-nspkg 2.0.3
core 2.5.1
nspkg 3.0.4
telemetry 1.0.4
Extensions: azure-devops 0.18.0

Statement:
az boards iteration project create --name $name --org https://dev.azure.com/ --project "$ToProject" --path $iterationPath --start-date "$startDate" --finish-date "$finishDate" --only-show-errors

->where $iterationPath = <projectName>\Iteration\PIP 3

Note that I have tried removing the leading slash.

Please advise if there are other formatting hints that I should attempt to work around the issue.

[mitch-b]

@dairik111 are you running as:

$name = 'PIP 3'
$iterationPath = '\<Team Project>\Iteration'
az boards iteration project create --name "$name" --org "https://dev.azure.com/myorg" --project "<Team Project>" --path "$iterationPath" --start-date "$startDate" --finish-date "$finishDate" --only-show-errors

[dairik111]

Negative. The entire iteration path is being copied from a different project json value as a string. The $name is not specified separately.

[dairik111]

Modifying the $iterationPath to emulate the example by @mitch-b did work. I had to drop the \IterationName portion of the path. I have children under that iteration, so now I need it to work for sub-iterations. Assumption is that the parent has to exist first, before creating the child.

[mitch-b]

You're right on with parent existing before children. Glad it's working!

[dairik111]

@mitch-b Thanks for the suggestion! It wasn't obvious to me what was happening there.