GET /rest/bpm/wle/v1/processApps
None
None
The default content type is application/json.
{ "description": "WLE Process Applications", "type": "object", "properties": { "processAppsList": {"type": "[object]", "description": "List of process apps installed in the system." [ { "ID": {"type": "string", "description": "The ProcessApp identifier." }, "shortName": {"type": "string", "description": "The ProcessApp short name." }, "name": {"type": "string", "description": "The ProcessApp name." }, "description": {"type": "string", "description": "The ProcessApp description." }, "defaultVersion": {"type": "string", "description": "For the Process Center, this is the name of the default workspace. For the Process Server, this is the name of the default snapshot." }, "installedSnapshots": {"type": "[object]", "description": "The list of installed snapshots associated with this ProcessApp." }, } ] } } }
{ "status":"200", "data":{ "processAppsList":[ { "shortName":"TWP", "name":"Process Portal", "description":"", "defaultVersion":"Main", "installedSnapshots":[ { "name":"7.5.0", "acronym":"7.5.0", "active":true, "activeSince":"2011-04-26T18:49:13Z", "ID":"2064.64bbda3f-b456-486a-9679-87d81c4366dd" } ], "ID":"2066.23d3ecec-6fdb-4033-9c57-e931aa13761f" }, { "shortName":"HSS", "name":"Hiring Sample", "description":"Hiring Sample", "defaultVersion":"Main", "installedSnapshots":[ { "name":"Hiring Sample 3", "acronym":"HS3", "active":true, "activeSince":"2011-04-26T18:50:06Z", "ID":"2064.30c63e29-aacd-4b3b-803f-a09ce65486d2" } ], "ID":"2066.9ab0d0c6-d92c-4355-9ed5-d8a05acdc4b0" } ] } }
<?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="http://rest.bpm.ibm.com/v1/data/system" elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://rest.bpm.ibm.com/v1/data/system" xmlns:pref="http://rest.bpm.ibm.com/v1/data/root" xmlns:common="http://rest.bpm.ibm.com/v1/data/common"> <import schemaLocation="Common.xsd" namespace="http://rest.bpm.ibm.com/v1/data/common"/> <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root"/> <!-- This type is used to return information about one or more IBM BPM installations (single server or a cluster). --> <complexType name="SystemMetadata"> <complexContent> <extension base="pref:Data"> <sequence> <!-- A list of IBM BPM installations --> <element name="systems" type="tns:Systems" minOccurs="0" maxOccurs="unbounded" /> </sequence> </extension> </complexContent> </complexType> <!-- This type contains information about a single IBM BPM installation. --> <complexType name="Systems"> <sequence> <!-- A unique ID associated with the IBM BPM installation --> <element name="systemID" type="string" /> <!-- A string representing the type of system (e.g. "SYSTEM_TYPE_WLE") --> <element name="systemType" type="string" /> <!-- A string representing the BPM installation's version --> <element name="version" type="string" /> <!-- A string representing the particular build of the IBM BPM product --> <element name="buildLevel" type="string" /> <!-- Indicates whether group work items can be used --> <element name="groupWorkItemsEnabled" type="boolean" /> <!-- Indicates whether substitution is enabled --> <element name="substitutionEnabled" type="boolean" /> <!-- Indicates whether or not substitution management is restricted to administrators --> <element name="substitutionManagementRestrictedToAdministrators" type="boolean" /> <!-- Indicates whether task history is enabled --> <element name="taskHistoryEnabled" type="boolean" /> <!-- Indicates whether work baskets are enabled --> <element name="workBasketsEnabled" type="boolean" /> <!-- Indicates whether business categories are enabled --> <element name="businessCategoriesEnabled" type="boolean" /> <!-- Indicates whether task search is enabled --> <element name="taskSearchEnabled" type="boolean" /> <!-- Indicates whether notifications are enabled --> <element name="notificationWebMessagingEnabled" type="boolean" /> <!-- Indicates whether automatic refresh for task list is enabled --> <element name="taskListWebMessagingEnabled" type="boolean" /> <!-- A string indicating the most recent version number of the BPM REST API --> <element name="apiVersion" type="string"/> <!-- A list of strings which represent features supported by the BPM REST API --> <element name="supports" type="string" minOccurs="0" maxOccurs="unbounded"/> <!-- A list of strings which represent resources supported by the BPM REST API --> <element name="resources" type="string" minOccurs="0" maxOccurs="unbounded"/> <!-- The fully-qualified hostname of the server --> <element name="hostname" type="string"/> <!-- A list of other environment variables that define the system --> <element name="environment" type="tns:EnvironmentVariable" minOccurs="1" maxOccurs="unbounded"/> <!-- Flag to indicate whether Task Filter service is enabled or not --> <element name="hostsTaskFilterService" type="boolean" /> </sequence> </complexType> <!-- This type is used to represent a list of DBA Application information. --> <complexType name="DBAApps"> <complexContent> <extension base="pref:Data"> <sequence> <!-- A list of zero or more DBA Apps --> <element name="dbaAppsList" type="tns:DBAAppsData" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType> <!-- This type contains the solution information associated with a Process App. --> <complexType name="DBAAppsData"> <sequence> <!-- The Process App identifier --> <element name="projectID" type="string"/> <!-- The name associated with the Process App --> <element name="projectName" type="string"/> <!-- The short name associated with the Process App --> <element name="projectShortName" type="string"/> <element name="projectDefaultBranchID" type="string"/> <element name="isTemplate" type="boolean"/> <!-- There should be one and only one application flow --> <element name="applicationFlowID" type="string"/> <!-- The Application Flow's description --> <element name="applicationFlowDescription" type="string"/> <element name="applicationFlowIconID" type="string"/> </sequence> </complexType> <!-- This type is used to represent a list of Process Applications. --> <complexType name="ProcessApps"> <complexContent> <extension base="pref:Data"> <sequence> <!-- A list of zero or more Process Apps --> <element name="processAppsList" type="tns:ProcessAppsData" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType> <!-- This type contains the information associated with a Process App. --> <complexType name="ProcessAppsData"> <sequence> <!-- The Process App identifier --> <element name="ID" type="string"/> <!-- The short name associated with the Process App --> <element name="shortName" type="string"/> <!-- The name associated with the Process App --> <element name="name" type="string"/> <!-- The Process App's description --> <element name="description" type="string"/> <element name="richDescription" type="string"/> <element name="lastModifiedBy" type="string"/> <element name="lastModified_on" type="dateTime"/> <!-- For the Process Center, this is the name of the default workspace. For the Process Server, this is the name of the default snapshot. --> <element name="defaultVersion" type="string"/> <element name="defaultBranchID" type="string"/> <!-- The list of installed snapshots associated with this Process App --> <element name="installedSnapshots" type="tns:InstalledSnapshotsData" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> <!-- This type contains information about an install snapshot. --> <complexType name="InstalledSnapshotsData"> <sequence> <!-- The name of the snapshot --> <element name="name" type="string"/> <!-- The snapshot ID --> <element name="ID" type="string"/> <!-- The snapshot Acronym --> <element name="acronym" type="string"/> <!-- Indicates whether this snapshot is active or not --> <element name="active" type="boolean"/> <!-- A timestamp when the snapshot was activated --> <element name="activeSince" type="dateTime"/> <!-- A timestamp when the snapshot was created --> <element name="createdOn" type="dateTime"/> <!-- The snapshot tip --> <element name="snapshotTip" type="boolean"/> <!-- The branch (track) ID --> <element name="branchID" type="string"/> <!-- The name of the branch (track) --> <element name="branchName" type="string"/> </sequence> </complexType> <!-- This type is used to return the list of items that are exposed to the end user. --> <complexType name="ExposedItems"> <complexContent> <extension base="pref:Data"> <sequence> <!-- A list of zero or more exposed items --> <element name="exposedItemsList" type="tns:ExposedItemData" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType> <!-- This type contains information about an exposed item. An exposed item could be a process, service, report, or scoreboard. --> <complexType name="ExposedItemData"> <sequence> <!-- The exposed ID of the item --> <element name="ID" type="string"/> <!-- The type associated with the exposed item. The type will be one of: "process", "service", "scoreboard", or "report". --> <element name="type" type="string"/> <!-- The sub-type associated with the exposed item. For type "service", it will be one of: "not_exposed", "administration_service", "startable_service", "dashboard" or "url". --> <element name="subtype" type="string"/> <!-- The exposed URL of the item; use this to view or run the item --> <element name="runURL" type="string"/> <!-- The item's ID; this will be based on the type of the item --> <element name="itemID" type="string"/> <!-- The item's reference; this will be based on the type of the item --> <element name="itemReference" type="string"/> <!-- The ID of the Process App associated with this item --> <element name="processAppID" type="string"/> <!-- The name of the Process App associated with this item --> <element name="processAppName" type="string"/> <!-- The acronym of the Process App associated with this item --> <element name="processAppAcronym" type="string"/> <!-- The ID of the snapshot associated with this item --> <element name="snapshotID" type="string"/> <!-- The name of the snapshot associated with this item --> <element name="snapshotName" type="string"/> <!-- A timestamp when the snapshot was created --> <element name="snapshotCreatedOn" type="dateTime"/> <!-- The display name of the item; this will be the name of the Process, Service, or Scoreboard --> <element name="display" type="string"/> <!-- The item's title if it exists. Such as a scoreboard title. --> <element name="title" type="string" /> <!-- Indicates if a tip--> <element name="tip" type="boolean"/> <!-- The branch (track) ID --> <element name="branchID" type="string"/> <!-- The name of the branch (track) --> <element name="branchName" type="string"/> <!-- If this exposed item cannot be started via a REST api, then this field is null Otherwise this field contains a relative URL that can be used to start the process. In such cases the caller may need to supply additional query parameters (parts, params) --> <element name="startURL" type="string"/> <!-- The acronym for the top level toolkit. Needed for task templates. --> <element name="topLevelToolkitAcronym" type="string"/> <!-- The name for the top level toolkit. Needed for task templates. --> <element name="topLevelToolkitName" type="string"/> <!-- Indication of the default snapshot. --> <element name="isDefault" type="boolean"/> <!-- Inidication if the item has been marked ready for mobile devices --> <element name="isMobileReady" type="boolean"/> <!-- BPD description is needed when exposed item REST API is called with ECM parameters, otherwise this element is not set. --> <element name="itemDescription" type="string" /> </sequence> </complexType> <!-- This type contains information about an Environment Variable item. Name value pair. --> <complexType name="EnvironmentVariable"> <complexContent> <extension base="pref:Data"> <sequence> <!-- Process Application shortname --> <element name="bpdShortname" type="string"/> <!-- variable name --> <element name="name" type="string"/> <!-- variable value --> <element name="value" type="string"/> <!-- updated or added --> <element name="success" type="string"/> </sequence> </extension> </complexContent> </complexType> <element name="EnvironmentVariable" type="tns:EnvironmentVariable" /> <!-- This type contains a list of Resource Environment Providers Available --> <complexType name="REPList"> <complexContent> <extension base="pref:Data"> <sequence> <!-- REPs --> <element name="providerList" type="common:StringList"/> </sequence> </extension> </complexContent> </complexType> <element name="REPList" type="tns:REPList" /> <!-- This type contains a list of properties contained in a Resource Environment Provider --> <complexType name="REPPropertiesListExhaustive"> <complexContent> <extension base="pref:Data"> <sequence> <!-- REP Properties --> <element name="propertyList" type="common:StringList"/> </sequence> </extension> </complexContent> </complexType> <element name="REPPropertiesListExhaustive" type="tns:REPPropertiesListExhaustive" /> <!-- Details of a REST ResourceEnvironmentProviderProperties api invocation --> <complexType name="REPPropertiesList"> <complexContent> <extension base="pref:Data"> <sequence> <!-- REP Property --> <element name="propertyList" type="common:Map"/> </sequence> </extension> </complexContent> </complexType> <element name="REPPropertiesList" type="tns:REPPropertiesList" /> <!-- This type contains a list of EnvironmentVariables used for Collaboration System Integration --> <complexType name="CollabSystemsData"> <complexContent> <extension base="pref:Data"> <sequence> <!-- A list of zero or more environment variables --> <element name="collabSystemsList" type="tns:EnvironmentVariable" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType> </schema>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <bpm:ResponseData xmlns:bpm="http://rest.bpm.ibm.com/v1/data"> <status>200</status> <data xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sys="http://rest.bpm.ibm.com/v1/data/system" xsi:type="sys:ProcessApps"> <processAppsList> <ID>2066.23d3ecec-6fdb-4033-9c57-e931aa13761f</ID> <shortName>TWP</shortName> <name>Process Portal</name> <description></description> <defaultVersion>Main</defaultVersion> <installedSnapshots> <name>7.5.0</name> <acronym>7.5.0</acronym> <ID>2064.64bbda3f-b456-486a-9679-87d81c4366dd</ID> <active>true</active> <activeSince>2011-04-26T18:49:13Z</activeSince> </installedSnapshots> </processAppsList> <processAppsList> <ID>2066.9ab0d0c6-d92c-4355-9ed5-d8a05acdc4b0</ID> <shortName>HSS</shortName> <name>Hiring Sample</name> <description>Hiring Sample</description> <defaultVersion>Main</defaultVersion> <installedSnapshots> <name>Hiring Sample 3</name> <acronym>HS3</acronym> <ID>2064.30c63e29-aacd-4b3b-803f-a09ce65486d2</ID> <active>true</active> <activeSince>2011-04-26T18:50:06Z</activeSince> </installedSnapshots> </processAppsList> </data> </bpm:ResponseData>
The default content type is application/json.
{ "description": "WLE Error Response", "type": "object", "properties": { "status": {"type": "string", "description": "The status of the previous API call." }, "exceptionType": {"type": "string", "description": "The classname associated with the exception." }, "errorNumber": {"type": "string", "description": "Message ID of the exception." }, "errorMessage": {"type": "string", "description": "Message text of the exception." }, "errorMessageParameters": {"type": ["string"], "optional": true, "description":"Message text parameters of the exception." }, "programmersDetails": {"type": "object", "optional": true, "description":"Additional exception details, for example, a stack trace." } } }
<?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="http://rest.bpm.ibm.com/v1/data/exception" elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://rest.bpm.ibm.com/v1/data/exception" xmlns:dat="http://rest.bpm.ibm.com/v1/data/root"> <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" /> <!-- This type represents an error response. --> <element name="RestRuntimeException"> <complexType> <sequence> <element name="status" type="string"/> <element name="Data" type="tns:ExceptionData"> </element> </sequence> </complexType> </element> <!-- This type contains detailed error information associated with an exception. --> <complexType name="ExceptionData"> <sequence> <element name="status" type="string"/> <!-- This specifies the java class name of the exception --> <element name="exceptionType" type="string"/> <!-- The message ID of the error message --> <element name="errorNumber" type="string" minOccurs="0"/> <!-- The complete error message --> <element name="errorMessage" type="string"/> <!-- The list of strings inserted into the error message --> <element name="errorMessageParameters" type="string" minOccurs="0" maxOccurs="unbounded"/> <!-- The stacktrace associated with the exception. Note that this will be omitted unless the "server-stacktrace-enabled" property is enabled in the server's 100Custom.xml file. --> <element name="programmersDetails" type="string"></element> <!-- Prior responses. Set if a bulk command was used --> <element name="responses" type="dat:BulkCommandResponses" minOccurs="0"></element> <element name="errorData" type="tns:ErrorData" minOccurs="0" /> </sequence> </complexType> <complexType name="ErrorData"> <sequence> <element name="code" type="string" /> <element name="data" type="string" minOccurs="0" /> </sequence> </complexType> </schema>
Code | Description |
---|---|
200 OK | Success completion. |
400 Bad Request | The parameters are not valid or they are missing. |
401 Unauthorized | The caller is not authorized for this request. |
406 Not Acceptable | The requested content type or content encoding is not supported. |
500 Internal Server Error | A severe problem has occurred, programmer's details are provided. |
7.5.0
Parent Topic: Process Applications Resource