Application Release REST Grid Widgets

The first two REST Grid widgets interact directly with the external tools to retrieve filter items and items to associate to the Application Release.

Note:

ServiceNow and JIRA provide single REST service calls to retrieve items. If you want to integrate with tools that require multiple REST calls or do not provide REST services, custom REST services must be created to wrap the tool's API for use in the REST Grid Widgets.

The filter REST Grid may or may not require pre-filtering, depending on how many items may be returned in the REST Grid. For the ServiceNow integration, the ServiceNow Configuration Items are used to filter the Change Requests. The list of Configuration Items is large and therefore requires pre-filtering. A Text control takes the pre-filter information and passes that to the first REST Grid to return a list of items used to filter the item list. The columns displayed in this REST Grid are not critical, except for the value needed to pass to the second REST Grid service. For example, ServiceNow needs the sys_id of the Configuration Item used to filter the Change Requests. This column may be hidden.

The item list REST Grid invokes the REST service to retrieve the actual external tool items using the selected row in the filter REST Grid. The columns contained in the Results property pane provide the data used to create a node in the Relationship Service and should include:

Name/Title (ServiceNow uses Short Description)
Description
Submitter/Creator
Submit/Create Date
Unique Identifier (may be hidden)

Optionally, the columns may include:

Item ID/Issue ID a item identifier similar to SBM's Issue ID (ServiceNow has the Number field)
URL

The final REST Grid contains a list of the currently associated external tool items for the Application Release. The list behavior is as follows:

A Cypher Query initially populates this list. The query is run against the Relationship Service to find tool-specific items associated to the Application Release.
Changes to the list are made only in the form and do not commit to the Relationship Service until Submit.
Loading the REST Grid does not use any of the Refresh options in the REST Grid's properties. Instead, the REST Grid is loaded programmatically using a JavaScript function invoked in the form's Form Load action. This programmatic load is needed to capture the original results from the REST Grid's request, which is modified by the Add and Remove links and redisplayed with the changes.