Versions Compared

Key

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

This POST service will perform the same action found on the Build Request Form. It will initiate a request to build the project selected in the qualifiedProjectName. The service will return the workflowRequestId which can be used by the getWorkflowRequestStatus call to determine when the workflow is complete.

...

Full Project BuildSample JSON Request
Anchor
Full
Full


{

"authentication": { "userId":"fdadmin", "password":"password1" },

Opening bracket

Authentication section, used on all types of requests.

Required parameters for full deployment.

If building a partial deployment project, see the Partial deployment example instead.

"environmentCode":"DEV",

"qualifiedProjectName":"/FlexDeploy/folder1/myApp/SimpleProj",

"streamName": "trunk",

Build in the DEV environment.

The full path of the FlexDeploy project to build.

Build from stream trunk.

Optionally, include any of this information.

Verify that your json is valid; check for trailing commas if you don't include this section.

"workflowVersionOverride":"1.8",

"forceBuild": true,

"releaseName": "Demo Release",

"inputs": [
{

   "code":"input1","value": "xyz"

},
{

   "code":"inp2","value": 123

}],


"flexFields":[

{

   "code":"buildff", "value":"abcd"

}]

Version of the workflow to run. Defaults to the currently active version.

boolean equivalent to Force Build checkbox in the UI. Defaults to false.

Name of the release to which this build is related to. If specified, a new snapshot is going to be created.


List of workflow Input Codes to set

An input named "input1" is being set to "xyz"


An input named "inp2" is being set to 123




List of FlexField Codes to set

A build scoped FlexField named "buildff" is being set to "abcd"

}Closing bracket

...

Info
titleBuild All for Partial Deploy Project

If trying to build a Partial Deploy project with all of the files in the repository (equivalent to Build All button in the UI), then simply remove the "projectFiles" list, and the REST API will detect that the project is meant for partial deploys automatically and perform the build with all of the files.

Parameters

Parameter

Required

Type

Description

authentication

Y

Object

See Common Parameters below.

environmentCode

Y

String

This is the environment code, not the environment name that you see on most screens.

qualifiedProjectName

Y

String

The qualified project name starts with /FlexDeploy and includes any sub folder, then the application and finally the project.

streamName

Y

String

The name of the Stream.

forceBuild

N

Boolean

Values are true or false. Indicates that the build should occur even if there are not SCM changes. Defaults to false.

workflowVersionOverride

N

String

Optionally the version of the workflow can be overridden.

inputs

N

List

See Common Parameters below.

flexFieldsNStringSee Common Parameters below.
projectFilesN*List

Required for partial deployment builds.

A list of objects with 2 fields each: path and scmRevision.

     path
Y*StringFully qualified file path that is required inside the projectFiles parameter.
     scmRevision
NLong

Optionally include the revision number that you would like to use for the build.

If it is not indicated, then FlexDeploy will use the latest revision as the default.

packageNameNStringUnique name to identify a build for partial deployments project. Defaults to the project version if no value is provided.
releaseNameNStringName of the release to which this build is related to. If specified, a new snapshot is going to be created.

Insert excerpt
Workflow Execution REST API
Workflow Execution REST API
nopaneltrue

...