This POST service will perform the same action found on the Properties tab on a Project or an Environment-Instance definition. It will initiate a request to update a property selected from the propertyName. Each JSON request can update any number of properties across multiple Projects and Environment-Instances.

API URL

http://host:port/flexdeploy/rest/properties/updateProperties

Note that you must provide either the qualifiedProjectName OR the environmentCode AND instanceCode.

Sample JSON Request for Project Properties

{
   "authentication":
    {
       "userId": "fdadmin",
       "password": "password1"
    },
   "properties": [
    {
       "qualifiedProjectName": "/FlexDeploy/EBS/EBSPartial/Partial1",
       "propertyName": "FDEBS_APPLICATION_SHORT_NAME",
       "updatedValue": "FD_PROJECT_NAME",
       "isExpression": "true"
    },
    {
       "qualifiedProjectName": "/FlexDeploy/EBS/EBSPartial/Partial2",
       "propertyName": "FDEBS_JAVA_ROOT_SOURCE_DIR",
       "updatedValue": "java",
       "isExpression": "false"
    }]
}

Sample JSON Request for Environment-Instance Properties

{
   "authentication":
    {
       "userId": "fdadmin",
       "password": "password1"
    },
   "properties": [
    {
       "environmentCode": "BLD",
       "instanceCode": "BUILDADF",
       "propertyName": "FDJDEV_INSTALL_HOME",
       "updatedValue": "'/oracle/Middleware/Oracle_Home/' + FD_ENVIRONMENT_CODE",
       "isExpression": "true"
    },
    {
       "environmentCode": "BLD",
       "instanceCode": "BUILDEBS",
       "propertyName": "FDEBS_DB_USER",
       "updatedValue": "apps",
       "isExpression": "false"
    }]
}

Sample JSON Request for Different Scoped Properties

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

    {
       "environmentCode": "BLD",
       "instanceCode": "BUILDADF",
       "propertyName": "FDJDEV_INSTALL_HOME",
       "updatedValue": "'/oracle/Middleware/Oracle_Home/' + FD_ENVIRONMENT_CODE",
       "isExpression": "true"
    },
    {
       "qualifiedProjectName": "/FlexDeploy/EBS/EBSPartial/Partial1",
       "propertyName": "FDEBS_JAVA_ROOT_SOURCE_DIR",
       "updatedValue": "java",
       "isExpression": "false"
    }]

}

Parameters

Parameter	Required	Type	Description
`authentication`	Y	String	See Common Parameters below.
`properties`	Y	List
`environmentCode`	N	String	This is the environment code, not the environment name that you see on most screens.
`instanceCode`	N	String	This is the instance code, not the instance name that you see on most screens.
`qualifiedProjectName`	N	String	The qualified project name starts with /FlexDeploy and includes any sub folder, then the application and finally the project.
`propertyName`	Y	String	See Common Parameters below.
`updatedValue`	Y	String	See Common Parameters below.
`isExpression`	Y	Boolean	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

PropertyName

This is the Property Name (code), and not the Key Name that you see on most screens, that the request will update the value for. To copy the Property Name to your clipboard click on the clipboard icon to the right of any property.

UpdatedValue

This is the new value that will be assigned to the respective property.

IsExpression

This is a required, boolean value indicating whether or not the updatedValue is an expression (true) or a literal value. On the FlexDeploy screens the properties have a button that toggles to indicate whether a value is an expression or a literal value .