applications.md

title	linkTitle	weight	description
Application APIs	Applications APIs	10	APIs for Applications.

Get a List Applications

This call returns an array of JSON objects representing each Application to which the logged-in User has access.

If the "all" parameters is not specified then only the Applications associated with the User's home Domain are listed. If the "all" parameter is specified by setting it to "y" then the result includes the Applications in all accessible Sub-domains.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/applications

Parameters

Name	Located in	Value	Required	Schema
all	query	y or n	No	string

{{% include "userguide/reusable/Model Application Result.md" %}} {{% include "userguide/reusable/Model Application.md" %}} {{% include "userguide/reusable/Model Application Version.md" %}}

Retrieve specific Application or Application Version

This call returns a JSON object representing the specified Application. The resulting JSON will vary slightly depending on whether the specified Application is an Application Base Version or an Application Version.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/application/{identifier}

Parameters

Name	Located in	Value	Required	Schema
latest	query	If latest is set to "Y" then the latest version of the Application is returned. To use this flag, the specified identifier must refer to a Application Base Version, otherwise the flag has no effect.	No	string
branch	query	If branch is set along with latest then the latest version on the specified branch name is returned.	Yes	string
identifier	path	Is the identifier of the Application. Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	string

{{% include "userguide/reusable/Model Application Version Result.md" %}} {{% include "userguide/reusable/Model Application Version.md" %}}

Create New Application Version

This call creates a new Application Version. The new Application Version inherits all the attributes of the predecessor Application. In order for this to work through the permission model, there has to be a Create Version Task either in the Domain in which the specified Application is located or in any of the parent Domains as long as the Create Version Task is set to be "available" to Sub-domains.

This mechanism ensures that the invoking user has permission to create a new version of the Application (since the permissions are checked against the Task) and also the target Domain (i.e. the Domain in which the new Application is created) is determined from the Task. Also, by specifying the Task to execute, any pre and post link Actions are executed just as if the Task had been invoked via the Web UI.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/new/appver/{app_id}

Parameters

Name	Located in	Value	Required	Schema
app_id	path	Is the ID of the Application which will be the parent of the new Application Version. Either its name, its qualified name with its parent Domains included in dot notation (i.e. GLOBAL.products) or its internal ID. The newly created Application Version will inherit all the attributes from this Application.	Yes	integer
task	query	Is the identifier of a Task to execute in order to create the new Application Version. Either its name, its qualified name with its Domain and any parent Domains included in dot notation (i.e. GLOBAL.Product) or its internal ID. If the Task is not specified, the first accessible Create Version Task within the Application's Domain is used (or any Create Version Task in parent Domains as long as they are set to be "available" to Sub-domains).	No	string

{{% include "userguide/reusable/Model Success.md" %}}

Replace Component

Replace a Component within an Application. This call replaces a specific Component within an Application. You can use this to update the version of a Component within an Application by replacing the old Component Version with the new.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/new/replace/{app_id}/{old_comp_id}/{new_comp_id}

Parameters

Name	Located in	Value	Required	Schema
app_id	path	Is the ID of the Application with which the old Component ID (Comp_id) is associated. Either its name, its qualified name with its parent Domains included in dot notation, (i.e GLOBAL.Product) or its internal ID.	Yes	integer
old_comp_id	path	Is the ID of the Component (Comp_id) which is to be replaced. Either its name, its qualified name with its parent Domains included in dot notation (i.e. GLOBAL.Products) or its internal ID.	Yes	integer
new_comp_id	path	Is the ID of the Component which will replace old Component ID (comp_id). Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	integer

{{% include "userguide/reusable/Model Success.md" %}}

Approving an Application

This call allows the API to approve/reject an Application for a specified Domain. In order for this to work through the permission model, there has to be an Approve Task either in the Domain in which the specified Application is located or in any of the parent Domains as long as the Approve Task is set to be "available" to Sub-domains.

This mechanism ensures that the invoking user has permission to approve the Application (since the permissions are checked against the named Task) and also the target Domain (i.e. the Domain to which the Application is being approved/rejected) is determined from the Task. Also, by specifying the Task to execute, any Pre and Post Actions are executed just as if the Task had been invoked via the Web UI.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/approve/{app_id}

Parameters

Name	Located in	Description	Required	Schema
app_id	path	Is the identifier of the Application to be approved/rejected. Either its name, its qualified name with its parent Domains included in dot notation (i.e.GLOBAL.Products) or its internal ID.	Yes	integer
task	query	Is the identifier of a task to execute in order to approve the Application. Either its name, its qualified name with its Domain and any parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID. If the Task is not specified, the first accessible Approve Task within the Application's Domain is used or any Approve task in the parent Domains as long as they are set to be "available" to Sub-domains.	No	string
approve	query	Is optional. If specified and set to N for "no," then the Application is rejected. If this parameter is not specified or is set to Y for "yes," then the Application is approved.	No	string
notes	query	Any free-text notes that should be associated with the approval/rejection.	No	string

{{% include "userguide/reusable/Model Success.md" %}}

Associate an Application to an Environment

This call associates an existing Application with an Environment. This association allows the Application (or any of its Versions) to be deployed to that Environment. An Application needs to be assigned to an Environment before it can be deployed to that Environment.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/approve/{app_id}

Parameters

Name	Located in	Value	Required	Schema
app_id	path	Is the identifier of the Application to be assigned. Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	integer
env_id	path	Is the identifier of the Environment to which the Endpoint should be assigned. Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	string

{{% include "userguide/reusable/Model Success.md" %}}

Disassociates an Application from an Environment

This call removes, or disassociates, an Application from an Environment. Once the Application has been disassociated from the Environment neither it nor any of its Versions can be deployed to that Environment.

Disassociating an Application from an Environment does not physically remove the Application from the Environment. It simply prevents deploying any Version of the Application to the Environment.

REST Api Endpoint

HTTP Verb	URL
GET	/dmadminweb/API/unassign/application/{app_id}/{env_id}

Parameters

Name	Located in	Description	Required	Schema
app_id	path	Is the identifier of the Application to be assigned. Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	integer
env_id	path	Is the identifier of the Environment to which the server should be assigned. Either its name, its qualified name with its parent Domains included in dot notation (i.e GLOBAL.Product) or its internal ID.	Yes	string

{{% include "userguide/reusable/Model Success.md" %}}