AVLoop

Avloop creates an Application Version loop between any two versions of the Application on the stack, iterating through all the intervening versions.

NOTE: There is always an “implicit” avloop performed when deploying an Application Version to an Environment. In this case, the loop runs from the Application Version currently recorded as being on the target Environment to the Application Version being deployed. The variables ${dep.first}, ${dep.last}, ${dep.same}, ${dep.rollforward} and ${dep.rollback} are therefore available throughout the deployment process.

avloop has optional named parameters. These are:

If you are running a stand-alone action, then you must select an Application in order to push it onto the stack. Failure to do so will result in a run-time error (“No Application on the Stack”).

To use an Application other than that selected, you can put the avloop in a “using Application” statement. This will push the specified Application onto the stack.

Within the body of the loop, the following variables are set to indicate the status of the loop:

avloop will examine the Application Version graph to determine the route between the two Application Versions. There has to be a direct route between the from and to versions in order for the avloop to execute successfully. If there is no direct route then a runtime exception is thrown.

For example, consider the following version graph:

Example Using Application Objects:

using Application "ITguys" {

// Ensure DayOneApp is on the stack

set appfrom = getApplication("ITguys;1");

set appto = getApplication("ITguys;3");

if (${dep.rollforward}) {

echo "Rolling Forward";

} else {

echo "Rolling Back";

}

}

avloop(from: $appfrom, to: $appto)

{echo "${Application.name}}";

}//

// This will echo:

// Rolling Forward

// ITguys;1

// ITGuys;2

// ITGuys;3

//

Example Using Application Version Names:

using Application "ITGuys" {

// Ensure ITGuys is on the stack

avloop(from: "ITGuys;3", to: "ITGuys;1") {

if (${dep.rollforward}) {

echo "Rolling Forward";

} else {

echo "Rolling Back";

}

echo "${_Application_.name}";

}

}

//

// This will echo:

// Rolling Back

// ITguys;3

// Rolling Back

// ITGuys;2

// Rolling Back

// ITGuys;1

//

Example: No Direct Path - Error

using _Application_ "ITGuys" {

// There is not direct path between version 1a

// and version 3 as they are on different branches

//

avloop(from: "ITGuys;1a", to: "ITGuys;3") {

if (${dep.rollforward}) {

echo "Rolling Forward";

} else {

echo "Rolling Back";

}

echo "${_Application_.name}";

}

}

//

// This will throw a Runtime Exception:

// There is no path between "ITGuys;1a" and "ITGuys;3"

//