Project API Create

This POST service will create a new project with the same attributes as the given JSON object.

API URLs

http://host:port/flexdeploy/rest/v1/project

Request

POST will receive a project input JSON object and return a project JSON object. Project input JSON objects for the request can have the following attributes:

Parameter
Required
Type
Description
projectNameYesStringUnique name of the project.
applicationIdNo*Long

Id of the application the project is in. 

*Either applicationId or projectPath is required

projectPathNo*String

Fully qualified project path.

*Either applicationId or projectPath is required

isActiveNoBooleanBoolean that tracks whether or not the project is active. Null input defaults to true.
descriptionNoStringDescription of the project.
partialDeploymentNoBooleanWhether the project allows partial deployments. Null input defaults to false.
priorityNoIntegerDeploy priority of the project. Default value is 1.
projectTypeNo*ProjectTypeEnum

Type of project. Possible values are GENERAL, EBS, PARTIAL_FILE, PARTIAL_JDBC, OracleForms, ORACLE_DB, ORACLE_BI, ORACLE_APEX, MFT, SALESFORCE, UTILITY, MDS, or GENERIC.

*Required for partial deployment projects

scmTypeNoSCMTypeEnum

This specifies the source control management system used by this project. Must be a valid source control management system. Possible values are SVN, GIT, CVS, TFVC, PERF, CCUCM, PVCS, FILE, or NONE.

Note: If scmType is specified, at least one SCM source must be provided.

priorityScopeNoStringThis specifies the priority scope of the current project. Either Global, Folder, or Application. Defaults to Application.
buildInfoNoProjectBuildInfoBuild info for the project. See more info about the ProjectBuildInfo object below.
deployInfoNoProjectDeployInfoDeploy info for the project. See more info about the ProjectDeployInfo object below.
utilityExecutionInfoNoUtilityProjectExecutionInfoExecution info for a utility project. See more info about the UtilityProjectExecutionInfo object below.
mainStreamNameNoStringName of the main stream for the project. Defaults to master.
scmConfigurationNoProjectSCMPojoSCM configuration for the project. See more info about the ProjectSCMPojo object below.

ProjectBuildInfo

AttributeRequiredTypeDescription
buildWorkflowIdYesLongId of the build workflow used by this project.
buildInstanceIdYesLongId of the instance where this project is built.

ProjectDeployInfo

AttributeRequiredTypeDescription
deployWorkflowIdYesLongId of the deployment workflow used by this project.
deployInstanceIdsYesList<Long>Id of each of the instances where the project can be deployed.

UtilityProjectExecutionInfo

AttributeRequiredTypeDescription
utilityWorkflowIdYesLongId of the utility workflow used by this project.
utilityInstanceIdsYesList<Long>Id of each of the utility instance where this project can be run.

ProjectSCMPojo

AttributeRequiredTypeDescription
sourcesYesList<ProjectSCMConfig>List of SCM configuration sources. See more info about the ProjectSCMConfig object below.

ProjectSCMConfig

AttributeRequiredTypeDescription
instanceIdYesLongSCM instance id for this source.
configValuesNoList<ProjectSCMConfigValue>Configuration values for each SCM source. See more info about the ProjectSCMConfigValue object below.
sourceNumberNoIntegerNumber for the source. Source numbers start at 1 and increment for each source after that.

ProjectSCMConfigValue

AttributeRequiredTypeDescription
configNameYesStringName of the configuration attribute.
configValueNoStringValue of the configuration attribute.

SCM Configuration Names by Type

All values not provided are defaulted. All defaults are configured from the Administration > Defaults page.

 Subversion SCM Configuration Names
Attribute NameDescription
TrunkScriptPath for the trunk within selected repository.
BranchScriptPath for the branches within selected repository. Use StreamName variable to identify branch name used at runtime.
TagScriptPath for the tag within the selected repository. Use ProjectVersion variable to specify identifier of current build.
CheckoutFolderScript

Optional sub-folder to use for export/checkout operations during build workflow execution.

 Git SCM Configuration Names
Attribute NameDescription
BranchScriptPath for the branches within selected repository. Use StreamName variable to identify branch name used at runtime.
TagScriptPath for the tag within the selected repository. Use ProjectVersion variable to specify identifier of current build.
SparseCheckoutFoldersScript

This is very useful when you have many folders in your Git repository, but your project only needs few folders for build. This can be specified as one more values by using comma. 

CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
 CVS SCM Configuration Names
Attribute NameDescription
ModuleNamesScriptModule Names or Module subdirectories to be selected from repository. Module subdirectories should traverse starting at the Module Name. Multiple Modules may be selected by separating the names/paths with commas.
BranchNameScriptPath for the branches within selected repository. Use StreamName variable to identify branch name used at runtime.
TagScript

Tag script to be used when creating tags for the project in the repository. Use ProjectVersion variable to specify identifier of current build.

CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
 TFVC SCM Configuration Names
Attribute NameDescription
MainScriptMain Path to a project in the selected repository.
BranchScriptPath for the branches within selected repository. Use StreamName variable to identify branch name used at runtime.
LabelNameScript

Label script to be used when creating labels for the project in the repository. Use ProjectVersion variable to specify identifier of current build.

GetFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
 PVCS SCM Configuration Names
Attribute NameDescription
ProjectPathScriptProject Path Script to be used to get files from.  This will be a path present in the Project Database configured on the instance.  Use "/" to get all files in the Project Database.
PromotionGroupScriptPromotion Group name to be used.  Use StreamName variable to identify Promotion Group name at runtime.
UsingPGScript

Whether the Promotion Group script should be used to identify the stream.  If false, then the branch script will be used.

BranchScriptBranch name to be used within selected repository. Use StreamName variable to identify branch name used at runtime.
LabelScriptLabel script to be used when creating labels for the project in the repository. Use ProjectVersion variable to specify identifier of current build.
CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
 PERF SCM Configuration Names
Attribute NameDescription
MainScriptMain Path to a project in the selected repository.
BranchScriptBranch name to be used within selected repository. Use StreamName variable to identify branch name used at runtime.
LabelNameScriptLabel script to be used when creating labels for the project in the repository. Use ProjectVersion variable to specify identifier of current build.
CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
 CCUCM SCM Configuration Names
Attribute NameDescription
ProjectVobScriptProject versioned object base script.
VobPathsScriptScript for versioned object base path.
LabelNameScriptLabel script to be used when creating labels for the project in the repository. Use ProjectVersion variable to specify identifier of current build.
CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.
StreamScriptScript for stream.
 FILE SCM Configuration Names
Attribute NameDescription
MainFolderScriptMain Path to a project in the selected repository.
BranchFolderScriptBranch name to be used within selected repository. Use StreamName variable to identify branch name used at runtime.
CheckoutFolderScriptOptional sub-folder to use for clone operation during build workflow execution.

Response

AttributeTypeDescription

projectId

Long

Id of the project.

projectName

String

Unique name of the project.

applicationId

String

Id of the application the project is in.

projectPath

String

Fully qualified project path.

isActive

Boolean

Boolean that tracks whether or not the project is active. Null input defaults to true.

description

String

Description of the project.

partialDeployment

Boolean

Whether the project allows partial deployments. Null input defaults to false.

priority

Integer

Deploy priority of the project.

projectType

ProjectTypeEnum

Type of project. Possible values are GENERAL, EBS, PARTIAL_FILE, PARTIAL_JDBC, OracleForms, ORACLE_DB, ORACLE_BI, ORACLE_APEX, MFT, SALESFORCE, UTILITY, MDS, or GENERIC.

scmType

SCMTypeEnum

This specifies the source control management system used by this project. Must be a valid source control management system. Possible values are SVN, GIT, CVS, TFVC, PERF, CCUCM, PVCS, FILE, or NONE.

priorityScope

String

This specifies the priority scope of the current project. Either Global, Folder, or Application.

buildInfo

ProjectBuildInfo

Build info for the project. See more info about the ProjectBuildInfo object below.

deployInfo

ProjectDeployInfo

Deploy info for the project. See more info about the ProjectDeployInfo object below.

utilityExecutionInfo

UtilityProjectExecutionInfo

Execution info for a utility project. See more info about the UtilityProjectExecutionInfo object below.

streams

List<Long>

List of ids which identify the project streams associated with this project.

mainStreamName

String

Name of the main stream for the project.

scmConfiguration

ProjectSCMPojo

SCM configuration for the project. See more info about the ProjectSCMPojo object below.

ProjectBuildInfo

AttributeTypeDescription
buildWorkflowIdLongId of the build workflow used by this project.
buildInstanceIdLongId of the instance where this project is built.

ProjectDeployInfo

AttributeTypeDescription
deployWorkflowIdLongId of the deployment workflow used by this project.
deployInstanceIdsList<Long>Id of each of the instances where the project can be deployed.

UtilityProjectExecutionInfo

AttributeTypeDescription
utilityWorkflowIdLongId of the utility workflow used by this project.
utilityInstanceIdsList<Long>Id of each of the utility instance where this project can be run.

ProjectSCMPojo

AttributeTypeDescription
sourcesList<ProjectSCMConfig>List of SCM configuration sources. See more info about the ProjectSCMConfig object below.

ProjectSCMConfig

AttributeTypeDescription
instanceIdLongSCM instance id for this source.
configValuesList<ProjectSCMConfigValue>Configuration values for each SCM source. See more info about the ProjectSCMConfigValue object below.
sourceNumberIntegerNumber for the source. Source numbers start at 1 and increment for each source after that.

ProjectSCMConfigValue

AttributeTypeDescription
configNameStringName of the configuration attribute.
configValueStringValue of the configuration attribute.

Response Codes

HTTP CodeDescription
200Projects were found and returned
400Bad request
401Authentication failure
403Authorization failure (no access to resource)
500Unexpected internal server error

Example

If a POST request is sent to http://host:port/flexdeploy/rest/v1/project receiving the following JSON project object, 

POST JSON
{
    "projectName": "Example Project",
    "projectPath": "FlexDeploy/Testing/Example Project",
    "description": "Project created with API",
    "partialDeployment": true,
    "priority": 2,
    "projectType": "EBS",
    "scmType": "GIT",
    "mainStreamName": "master",
    "buildInfo": {
        "instanceId": 15925,
        "workflowId": 43164
    },
    "deployInfo": {
        "instanceIds": [80524, 93048],
        "workflowId": 34540
    },
    "scmConfiguration": {
        "sources": [
            {
                "instanceId": 16465,
                "configValues": [
                    {
                        "configName": "SparseCheckoutFoldersScript",
                        "configValue": "\"mainfolder/main\""
                    }
                ],
                "sourceNumber": 1
            },
			{
                "instanceId": 46947,
                "configValues": [
                    {
                        "configName": "SparseCheckoutFoldersScript",
                        "configValue": "\"EBS\""
                    }
                ],
                "sourceNumber": 2
            }
        ]
    }
}

the following project object will then be created in FlexDeploy:

POST JSON
{
    "projectName": "Example Project",
	"projectId": 10002,
    "projectPath": "FlexDeploy/Testing/Example Project",
    "description": "Project created with API",
    "isActive": true,
    "partialDeployment": true,
    "priority": 2,
    "projectType": "EBS",
    "priorityScope": "Application",
    "applicationId": 14852,
    "scmType": "GIT",
    "mainStreamName": "master",
	"streams": [73419],
    "buildInfo": {
        "instanceId": 15925,
        "workflowId": 43164
    },
    "deployInfo": {
        "instanceIds": [80524, 93048],
        "workflowId": 34540
    },
	"utilityExecutionInfo": null,
    "scmConfiguration": {
        "sources": [
            {
                "instanceId": 16465,
                "configValues": [
                    {
                        "configName": "SparseCheckoutFoldersScript",
                        "configValue": "\"mainfolder/main\""
                    }
                ],
                "sourceNumber": 1
            },
			{
                "instanceId": 46947,
                "configValues": [
                    {
                        "configName": "SparseCheckoutFoldersScript",
                        "configValue": "\"EBS\""
                    }
                ],
                "sourceNumber": 2
            }
        ]
    }
}
The following macros are not currently supported in the footer:
  • style