» Example Customizations

» Creating a Catalog Item with Pinned Variables

This example use case creates a Terraform catalog item for resources that limits user input to certain variables.

» Create Service Catalog Item

1. Enter the ServiceNow Studio.
2. Click "Create Application File" to raise a dialog box of options.
3. In the dialog, navigate to the "Service Catalog" section, select "Catalog Item", and click the "Create" button.
4. Name the new catalog item. (The rest of this example assumes an item named Example With Pinned Variables.)
5. Select Catalogs: "Terraform Catalog" > Select Categories: "Terraform Resources".
6. Add any other descriptions you may want.
7. Click "Submit".

» Create Variable Set

1. Click "Create Application File" to raise a dialog box of options.
2. In the dialog, navigate to the "Service Catalog" section, select "Variable Set", and click the "Create" button.
3. Name your variable set. (The rest of this example assumes a set named Example Pinned Variables, with a default "Internal Name" of example_pinned_variables.)
4. Click "Submit".
5. Under the "Variables" tab click "New".
   1. Create your variable:
   2. In this example we will create a field called tf_var_pet_name_length that will be for a Terraform variable that determines the number of words to use for the pet server name.
      • Question: Pet Name Length
      • Name: tf_var_pet_name_length
      • tf_var_ tells the Terraform ServiceNow SDK that this is a Terraform variable.
   3. Repeat variable creation as necessary for your use case.
   4. Click "Submit".

» Add Variable Set to Catalog Item

1. Go back to your Catalog Item.
2. Under the "Variable Sets" tab, click "New".
3. Search for and select the variable set you created (Example Pinned Variables).
4. Click "Submit".

» Create Flow

This example uses the "Provision Resources With Vars" flow, which is an example of flows with actions, included with the integration.

In the ServiceNow Studio:

1. Navigate to "Flow Designer" > "Flows" > "Provision Resources With Vars".
   1. This will be flow that can be used as an example.
2. Create a new flow by selecting "New" in Flow Designer
3. Name it "Example Flow" and click "submit"
4. Edit your example flow
   1. Trigger: Service Catalog
   2. 1st Action: Get Catalog Variables
      1. Drag "Requested Item Record" to "Submitted Request" field
      2. Template Catalog Item: This should be your example catalog item created above
      3. Catalog Variables: Move all of your variables to "Selected" side
      4. Select "Done" to finish this action
   3. Add another action and select the "Terraform Create Workspace with Var"
      1. Using the Flow "Provision Resources With Vars" as an example:
      2. Move the variables from the "Data" options on the right of the flow designer to match the example flow
      3. Select "Done" to save this flow
5. Click "Save" then "Activate" to enable your flow

» Set The Workflow for Catalog Item

In the ServiceNow Studio:

1. Select the "Example with Pinned Variables" catalog item. ("Service Catalog" > "Catalog Item" > "Example With Pinned Variables")
2. Select the "Process Engine" tab.
3. Set the "Flow" field by searching for the "Example Pinned Variables" flow and clicking "Update".

» Test the Catalog Item

The new item should be available in the Terraform Service Catalog. Once the new catalog item is confirmed to work, you can customize as needed.