The following macros are not currently supported in the header:
  • style

deployApplication

This POST service will perform the same action found on the Deployment Request Form off the application screen. It will initiate a request to deploy the application selected in the qualifiedApplicationName. The service will return the applicationRequestId which can be used by the getApplicationRequestStatus call to determine when the workflow is complete.

API URL

http://host:port/flexdeploy/rest/workflow/deployApplication

Application Deploy Sample JSON Request


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

Opening bracket


Authentication section, used on all types of requests.

Required parameters for application deployment.

"environmentCode":"DEV",
"qualifiedApplicationName":"/FlexDeploy/folder1/myApp",

Build in the DEV environment.

The full path of the FlexDeploy project to deploy.


Optionally include this information.

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

"forceDeploy": true,

"startTime": "2017-03-16T23:17:52-06:00",
"exceptionToWindow": "true",
"applicationVersion": "1.5",
"projectSettings": [
    {
      "projectName": "SimpleProj",
      "inputs": [
       {
          "name": "inp1", "value": "value1"
       },
       {
          "name": "inp2", "value": "value2"
       }]
    }],

"flexFields": [
{
"name": "CHANGE_NUMBER","value": "xyz"
},
{
"name": "field2","value": 123
}]

boolean equivalent to "Force Deploy" checkbox in the UI. Defaults to false.

Start the deployment at this time.

The application will be deployed outside any configured windows.

Version "1.5" of the application will be deployed.

List of projects in the application


SimpleProj will be deployed using the two listed input codes.



Any other projects in the application which do not need inputs will still be deployed, even if they are not listed in the JSON.


List of FlexField display names to set

Set CHANGE_NUMBER to "xyz"


Set field2 to 123.

}Closing bracket


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.

qualifiedApplicationName

Y

String

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

applicationVersion
NStringVersion of the application to be deployed. Defaults to the last successful build.

exceptionToWindow

N

Boolean

Values are true or false. Indicates that the deployment is an exception to the deployment window.

forceBuild

N

Boolean

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

startTime

N

DateTime

The time when the deployment will be started.

projectSettings

N

List

The project settings is a list of the projects by name and includes the 2 sub-parameters below. If all values can be defaulted, the project setting for that project does not need to be included.

     projectName

N

String

The project to assign inputs into

     inputs

N

List

See Common Parameters below.

flexFields

N

List

See Common Parameters below.

Common Parameters

Authentication

The authentication parameter is comprised of 2 fields.

  • userId – a valid user id for FlexDeploy
  • password – the associated password

Inputs

This is a list of name/value pairs for the inputs. Not all inputs need to be supplied. If an input has a default value that is acceptable for the Workflow to run, it does not need to be supplied.

FlexFields

Applicable only for deployProject and deployApplication. This is a list of name (Display Name of FlexField)/value pairs for the Flexfields. Not all FlexFields need to be supplied. If a FlexField has a default value or options that are acceptable for the workflow to run, it does not need to be changed. Read more about FlexFields.

The following macros are not currently supported in the footer:
  • style