Info |
---|
This API is available starting with version @5.2.0.1 |
...
Parameter | Type | Required | Description |
---|---|---|---|
projectId | URL | Yes | This is a URL parameter for the Id of the project which the package is in |
packageName | URL | Yes | Name of the package to retrieve. This is case sensitive |
Response
Attribute | Type | Description |
---|---|---|
name | String | Name of the package |
description | String | Description of the package |
files | List<PackageFile> | All files in the package. More info on the PackageFile object is included below. |
...
packageType |
String | Type |
Response Codes
...
...
...
Example
If we had a package with the name ALM-150 in a project with id 14935, when we run a GET request at the URL
http://host:port/flexdeploy/rest/v1/project/14935/package/ALM-150,
the GET request would return the following JSON package object:
...
theme | Eclipse |
---|---|
title | Package GET Return JSON |
...
of the package (USER_MANAGED or DYNAMIC). | ||
packageStatus | String | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. |
includePath | String | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Description |
---|---|---|
filePath | String | Fully qualified path of the file |
objectType | String | Type of the object |
sequenceNumber | Integer | Order placement of this file in the package |
Response Codes
HTTP Code | Description |
---|---|
200 | Project Package was found and returned |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project or Package not found |
500 | Unexpected internal server error |
Example
If we had a package with the name ALM-150 in a project with id 14935, when we run a GET request at the URL
http://host:port/flexdeploy/rest/v1/project/14935/package/ALM-150,
the GET request would return the following JSON package object:
Code Block | ||||
---|---|---|---|---|
| ||||
{ "name": "ALM-150", "description": null, "files": [ { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pls", "objectType": "DB Objects (SQLs)", "sequenceNumber": 1 }, { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb", "objectType": "DB Objects (SQLs)", "sequenceNumber": 2 } ] } |
POST
This POST service will create a new package with the same attributes as the given JSON object.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package |
Request
...
,
"packageType": "USER_MANAGED",
"packageStatus": "ACTIVE",
"includePath" : null,
"excludePath" : null,
"tests": null,
"testLevel": "NoTestRun",
"versionSyntax": null
} |
...
POST
This POST service will create a new package with the same attributes as the given JSON object.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package |
Request
Attribute | Type | Required | Description |
---|---|---|---|
name | String | Yes | Name of the package |
description | String | No | Description of the package |
sortAll | Boolean | No | Whether or not the files in the package should be sorted by type. If this is true, sequence numbers for files will be ignored. This will default to false |
addFileFilter | String | No | A filter to add all files containing this string |
files | List<PackageFile> | No | All files in the package. More info on the PackageFile object is included below. |
...
packageStatus |
String |
Response
No | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. Defaults to Active. | ||
packageType | String | No | Type of the package to create (DYNAMIC or USER_MANAGED). Default is USER_MANAGED if not specified. |
includePath | String | No | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | No | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | No | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | No | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | No | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Required | Description |
---|---|---|---|
filePath | String | Yes | Fully qualified path of the file |
as it appears on the Project Files and Packages screens | |||
sequenceNumber | Integer | No | Order placement of this file in the package |
Response Codes
...
...
...
Example
If the POST request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{
"description": "Creating a package using the Package REST API",
"name": "REST_Package",
"sortAll": true,
"addFileFilter": "XXHR_BIPUB_REP_PKG",
"files": [
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java"
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml"
}
]
} |
The following package object will then be created:
...
theme | Eclipse |
---|---|
title | POST JSON |
...
. Sequence numbers must be provided for all or none of the files in the package JSON. If sequence numbers aren't provided, the order of the files will be based on either object type, if the sortAll flag is true, or based on the order of the files in the request. |
Response
Attribute | Type | Description |
---|---|---|
name | String | Name of the package |
description | String | Description of the package |
files | List<PackageFile> | All files in the package. More info on the PackageFile object is included below. |
packageStatus | String | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. Defaults to ACTIVE. |
packageType | String | Type of the package (DYNAMIC or USER_MANAGED). |
includePath | String | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Description |
---|---|---|
filePath | String | Fully qualified path of the file |
objectType | String | Type of the object |
sequenceNumber | Integer | Order placement of this file in the package |
Response Codes
HTTP Code | Description |
---|---|
200 | Project Package was created successfully |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project or Package not found |
500 | Unexpected internal server error |
Example
If the POST request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{ "description": "Creating a package using the Package REST API", "name": "REST_Package", "sortAll": true, "addFileFilter": "XXHR_BIPUB_REP_PKG", "files": [ { "filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java" }, { "filePath": "/java/sql/XXHR_BIPUB_REP_PKG.pls",xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml" } "objectType": "DB Objects (SQLs)", "sequenceNumber": 3 },] } |
The following package object will then be created:
Code Block | ||||
---|---|---|---|---|
| ||||
{ "description": "Creating a package using the Package REST API", "name": "REST_Package", "files": [ { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java", "objectType": "DBOracle Application ObjectsFramework (SQLsOAF) JAVA", "sequenceNumber": 41 }, ] } |
PUT
This PUT service will replace all attributes of a given package with the attributes of the provided JSON request.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package/{packageName} |
Request
...
PackageFile
...
Response
...
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 2
}
],
"packageStatus": "ACTIVE",
"pacageType": "USER_MANAGED",
"includePath": null,
"excludePath": null,
"tests": null,
"testLevel": "NoTestsRun",
"versionSyntax": null
} |
...
PUT
This PUT service will replace all attributes of a given package with the attributes of the provided JSON request.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package/{packageName} |
Request
Attribute | Type | Required | Description |
---|---|---|---|
packageName | String (URL) | Yes | Name of the package, used to identify the package being updated. The name cannot be modified after the package is created |
packageStatus | String | Yes | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. |
description | String | No | Description of the package |
sortAll | Boolean | No | Whether or not the files in the package should be sorted by type. If this is true, sequence numbers for files will be ignored. This will default to false |
addFileFilter | String | No | A filter to add all files containing this string |
files | List<PackageFile> | No | All files in the package. Any files in the package before this request will be deleted and replaced by the files in the request. More info on the PackageFile object is included below. |
packageType |
...
String |
No | Type |
Response Codes
...
...
...
Example
If we had an package in a project with id 14935 with the following attributes:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"description": "Creating a package using the Package REST API",
"name": "REST_Package",
"files": [
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pls",
"objectType": "DB Objects (SQLs)",
"sequenceNumber": 1
},
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb",
"objectType": "DB Objects (SQLs)",
"sequenceNumber": 2
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 3
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 4
}
]
} |
When we run a PUT request at the URL http://host:port/flexdeploy/rest/v1/project/14935/package/REST_Package, and the PUT request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{
"description": "This is the updated package",
"sortAll": false,
"addFileFilter": null,
"files": [
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java"
},
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb"
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml"
}
]
} |
The PUT request would then update the package and return the following JSON package object:
...
theme | Eclipse |
---|---|
title | Package PUT Return JSON |
...
of the package (DYNAMIC or USER_MANAGED). The default is USER_MANAGED if not specified. | |||
includePath | String | No | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | No | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | No | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | No | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | No | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Required | Description |
---|---|---|---|
filePath | String | Yes | Fully qualified path of the file as it appears on the Project Files and Packages screens |
sequenceNumber | Integer | No | Order placement of this file in the package. Sequence numbers must be provided for all or none of the files in the package JSON. If sequence numbers aren't provided, the order of the files will be based on either object type, if the sortAll flag is true, or based on the order of the files in the request. |
Response
Attribute | Type | Description |
---|---|---|
name | String | Name of the package |
description | String | Description of the package |
files | List<PackageFile> | All files in the package. More info on the PackageFile object is included below. |
packageStatus | String | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. |
packageType | String | Type of the package (DYNAMIC or USER_MANAGED). |
includePath | String | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
versionSyntax | String | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
tests | String | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Description |
---|---|---|
filePath | String | Fully qualified path of the file |
objectType | String | Type of the object |
sequenceNumber | Integer | Order placement of this file in the package |
Response Codes
HTTP Code | Description |
---|---|
200 | Project Package was found and updated |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project or Package not found |
500 | Unexpected internal server error |
Example
If we had an package in a project with id 14935 with the following attributes:
Code Block | ||||
---|---|---|---|---|
| ||||
{ "description": "Creating a package using the Package REST API", "name": "REST_Package", "descriptionfiles": "This is the updated package", "files": [ { "filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.javasql/XXHR_BIPUB_REP_PKG.pls", "objectType": "OracleDB ApplicationObjects Framework (OAFSQLs) JAVA", "sequenceNumber": 1 }, { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb", "objectType": "DB Objects (SQLs)", "sequenceNumber": 2 }, { "filePath": "/java/xxt/oracle/apps/ak/xxperson/serverwebui/xxPersonAMmanagePersonCO.xmljava", "objectType": "Oracle Application Framework (OAF) JAVA", "sequenceNumber": 3 }, ] } |
PATCH
This PATCH service will update an existing package with the information passed through a JSON object. If an attribute of the JSON is null, it will not be updated in the package. Any new files included in the request will be appended to the list of files already in the package.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package/{packageName} |
Request
...
PackageFile
...
Response
...
PackageFile
...
Response Codes
...
...
...
Example
...
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 4
}
],
"packageStatus": "ACTIVE",
"packageType": "USER_MANAGED",
"includePath": null,
"excludePath": null,
"tests": null,
"testLevel": "NoTestsRun",
"versionSyntax": null
} |
When we run a PUT request at the URL http://host:port/flexdeploy/rest/v1/project/14935/package/REST_Package, and the PUT request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{
"description": "This is the updated package",
"sortAll": false,
"addFileFilter": null,
"files": [
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java"
},
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb"
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml"
}
],
"packageStatus": "ACTIVE"
} |
The PUT request would then update the package and return the following JSON package object:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"name": "REST_Package",
"description": "This is the updated package",
"files": [
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 1
},
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb",
"objectType": "DB Objects (SQLs)",
"sequenceNumber": 2
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 3
}
],
"packageStatus": "ACTIVE",
"packageType": "USER_MANAGED",
"includePath": null,
"excludePath": null,
"tests": null,
"testLevel": "NoTestsRun",
"versionSyntax": null
} |
...
PATCH
This PATCH service will update an existing package with the information passed through a JSON object. If an attribute of the JSON is null, it will not be updated in the package. Any new files included in the request will be appended to the list of files already in the package.
Info | ||
---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{projectId}/package/{packageName} |
Request
Attribute | Type | Required | Description |
---|---|---|---|
packageName | String (URL) | Yes | Name of the package, used to identify the package being updated. The name cannot be modified after the package is created |
description | String | No | Description of the package |
sortAll | Boolean | No | Whether or not the files in the package should be sorted by type. If this is true, sequence numbers for files will be ignored. This will default to false |
addFileFilter | String | No | A filter to add all files containing this string |
files | List<PackageFile> | No | All files in the package. Any new files will be appended to files already in the package. More info on the PackageFile object is included below |
packageStatus | String | No | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. |
packageType | String | No | Type of the package (DYNAMIC or USER_MANAGED). |
includePath | String | No | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | No | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | No | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | No | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | No | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Required | Description |
---|---|---|---|
filePath | String | Yes | Fully qualified path of the file as it appears on the Project Files and Packages screens |
sequenceNumber | Integer | No | Order placement of this file in the package. Sequence numbers must be provided for all or none of the files in the package JSON. If sequence numbers aren't provided, the order of the files will be based on either object type, if the sortAll flag is true, or based on the order of the files in the request |
Response
Attribute | Type | Description |
---|---|---|
name | String | Name of the package |
description | String | Description of the package |
files | List<PackageFile> | All files in the package. More info on the PackageFile object is included below. |
packageStatus | String | Package Status. Possible values (ACTIVE, COMPLETED, INACTIVE). Completed packages can not be modified and only active packages can be added to a release. |
packageType | String | Type of the package (DYNAMIC or USER_MANAGED). |
includePath | String | Comma separated list of regular expressions that define which project files will be included. Applicable for DYNAMIC packages only. |
excludePath | String | Comma separated list of regular expressions that define which project files will be excluded. Applicable for DYNAMIC packages only. |
tests | String | Salesforce Tests. Only applies to Salesforce type partial deployment projects. |
testLevel | String | Salesforce Test Level. Only applies to Salesforce type partial deployment projects. |
versionSyntax | String | Version syntax of the package. Only applies to Salesforce type partial deployment projects. |
PackageFile
Attribute | Type | Description |
---|---|---|
filePath | String | Fully qualified path of the file |
objectType | String | Type of the object |
sequenceNumber | Integer | Order placement of this file in the package |
Response Codes
HTTP Code | Description |
---|---|
200 | Project Package was found and updated |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project or Package not found |
500 | Unexpected internal server error |
Example
If we had an package in a project with id 14935 with the following attributes:
Code Block | ||||
---|---|---|---|---|
| ||||
{
"name": "REST_Package",
"description": "This is the updated package",
"files": [
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 1
},
{
"filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb",
"objectType": "DB Objects (SQLs)",
"sequenceNumber": 2
},
{
"filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml",
"objectType": "Oracle Application Framework (OAF) JAVA",
"sequenceNumber": 3
}
],
"packageStatus": "ACTIVE",
"packageType": "USER_MANAGED",
"includePath": null,
"excludePath": null,
"tests": null,
"testLevel": "NoTestsRun",
"versionSyntax": null
} |
When we run a PATCH request at the URL http://host:port/flexdeploy/rest/v1/project/14935/package/REST_Package, and the PATCH request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{ "name": "REST_Package", "description": "This is the updated package", "files": [ { "filePath": "/java/xxt/oracle/apps/ak/xxperson/webui/managePersonCO.java", "objectType": "Oracle Application Framework (OAF) JAVA", "sequenceNumber": 1 }, { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pkb", "objectType": "DB Objects (SQLs)", "sequenceNumber": 2 },sql/XXHR_BIPUB_REP_PKG.pls", "sequenceNumber": 2 } ], "packageStatus": "ACTIVE", "packageType": "USER_MANAGED", "includePath": null, "excludePath": null } |
The PATCH request would then update the package and return the following JSON package object:
Code Block | ||||
---|---|---|---|---|
| ||||
{ "name": "REST_Package", "description": "This is the updated package", "files": [ { "filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml", "objectType": "Oracle Application Framework (OAF) JAVAwebui/managePersonCO.java", "sequenceNumberobjectType": 3 } ] } |
When we run a PATCH request at the URL http://host:port/flexdeploy/rest/v1/project/14935/package/REST_Package, and the PATCH request receives the following JSON package object,
Code Block | ||||
---|---|---|---|---|
| ||||
{ "files": ["Oracle Application Framework (OAF) JAVA", "sequenceNumber": 1 }, { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pls", "sequenceNumber": 2 }, ] } |
The PATCH request would then update the package and return the following JSON package object:
Code Block | ||||
---|---|---|---|---|
| ||||
{ "name { "filePath": "REST_Package/sql/XXHR_BIPUB_REP_PKG.pkb", "descriptionobjectType": "ThisDB is the updated packageObjects (SQLs)", "filessequenceNumber": [3 }, { "filePath": "/java/xxt/oracle/apps/ak/xxperson/webuiserver/managePersonCOxxPersonAM.javaxml", "objectType": "Oracle Application Framework (OAF) JAVA", "sequenceNumber": 1 }, { "filePath": "/sql/XXHR_BIPUB_REP_PKG.pls JAVA", "sequenceNumber": 24 } ], { "filePath "packageStatus": "/sql/XXHR_BIPUB_REP_PKG.pkbACTIVE", "objectTypepackageType": "DB Objects (SQLs)", "sequenceNumber": 3 }, { "filePath": "/java/xxt/oracle/apps/ak/xxperson/server/xxPersonAM.xml", "objectType": "Oracle Application Framework (OAF) JAVA", "sequenceNumber": 4 } ]USER_MANAGED", "includePath": null, "excludePath": null "tests": null, "testLevel": "NoTestsRun", "versionSyntax": null } |
...
DELETE
This method will delete a package with the given name in the given project. There is no response message. If package is not present (was already deleted), no error code will be returned.
...