Purpose/Use Case

To request an appropriate number of instances for the Deployment and/or the Machine Component from ServiceNow Connector (includes vRA Nested Blueprint Scenario)

1. As a ServiceNow Catalog Item Admin, I want the requester to specify the number of Deployments the requester needs during request time of the ServiceNow Catalog
   1. vRA will provision the correct number of deployments requested
2. As a ServiceNow Catalog Item Admin, I want the requester to specify the number of instances of the Machine Component the requester needs during request time of the ServiceNow Catalog
   1. vRA will provision the correct number of VMs requested within the vRA Deployment

Supported Versions

All

• Please note, that during a vRA Nested Blueprint scenario, fields were hidden on the nested/child blueprint view starting from ServiceNow Connector 2018.3.0.3.

Solution

Pre-requisite in vRA for the vRA Blueprint of interest that will be requested from ServiceNow

1. Verify that the vRA Blueprint's Deployment limit is not set
   1. If the vRA Blueprint's Deployment limit is set, an error occurs (vRO is unable to create the request in vRA)
      1. Sample Exception message if a Deployment limit is set and user specifies Number of Instances of the deployment: 

[Rest Composite Exception]: ( [Rest Error]: {Status code: 400}, {Error code: 20117} , {Error Source: null}, {Error Msg: The data specified within the request is invalid.}, {System Msg: The data specified within the request is invalid.} ) ( [Rest Error]: {Status code: 400}, {Error code: 900188} , {Error Source: null}, {Error Msg: New maximum value [3] for field [_number_of_instances] cannot be larger than the overridden maximum value [1].}, {System Msg: New maximum value [3] for field [_number_of_instances] cannot be larger than the overridden maximum value [1].} ) 

Import Catalog Item

1. Fill out the form:
   1. ServiceNow Catalog Item Name
   2. ServiceNot Catalog Item Description
   3. Default Number of Deployments
   4. Select a ServiceNow Catalog
   5. Select a ServiceNow Category
   6. Select a ServiceNow Workflow
   7. Select a vRO Server
   8. Select a vRA Business Group
   9. Business Group Override
   10. Select a vRA Catalog Item
2. Click Load Request Form
   1. A representation of the vRA Blueprint will appear below

Specify the number of vRA Deployments

1. Select the checkbox for number_of_instances
   1. This will create a ServiceNow variable in which the ServiceNow admin can update (set as Mandatory, update the type and set restrictions (min/max))
2. Update the ServiceNow Label as desired

Specify the number of a specific Machine Component

1. Select the checkbox for _cluster
   1. This will create a ServiceNow variable in which the ServiceNow admin can update (set as Mandatory, update the type and set restrictions (min/max))
2. Update the ServiceNow Label as desired

Modify Catalog Item Mapping

1. Create appropriate ServiceNow variables on the ServiceNow Catalog
2. Click on Modify Catalog Item Mapping
3. Update the Catalog Item accordingly, selecting the appropriate ServiceNow Variable
   1. Follow references above in the Import Catalog Item section

Appendix

Unable to locate JIRA server for this macro. It may be due to Application Link configuration.

After specifying _number_of_instances for a Nested Blueprint

Verified via Administration > Request History and viewing the request

After specifying _cluster for a Nested Blueprint