Provisioning Reference Guide › SPML Service › SPML Service Configuration › Using the SPML Manager's Templating Functionality › Create an SPML Template Request

Previous Topic: Download the SPML Manager

Next Topic: Using Velocity Templates
Create an SPML Template Request

To create an SPML Template request, perform the following steps:

  1. Create an XML file containing some sample data.

    You can find a sample in the SPMLManager\sample Templates directory.

  2. Using the SPML Manager, connect to an SPML service.

  3. Use one of the tabs (Add, Modify, Delete, or Extended) to construct an SPML request that conforms to the schema of the SPML service.

    The name given to the Exploder Velocity context is REC_, so whenever you want to refer to a variable in the data file, use the syntax ${REC_.variable}.

    To hard-code a constant in the generated requests, type the data you want into the attribute fields.

  4. Click the Raw XML tab to see the SPML Request in XML format.
  5. Click the Add to Batch Request button when you are happy with your simple variable replacement.

    Note: The Add to Batch Request button is only available when viewing the tab in Request mode and is therefore not available in Raw <XML> mode.

  6. Use the Batch tab to see the addition to batch.

    A batch request can contain as many individual requests as you like.

  7. Save the SPML Batch Request Template to a file.
  8. Click the Template tab and load your simple SPML Template from your saved Batch Request File.
  9. Click the Raw <XML> tab to edit your SPML Template:
  10. In the XML code, insert a velocity directive for each loop at the point in your batch request where you want the request to cycle through loading each row in the CSV into the context and put a #end statement where you want the cycling to end. The format of the syntax for each loop is #foreach ( $REC_ in $RECS_.
  11. Click Save Template to save your modified template file.
  12. Load the XML data file that will fill in the data in your request.
  13. Click the Save button if you want to Save the resulting batch request to a file for inspection or click Submit if you want to submit the resulting Batch Request to the SPML Service.

For each XML record in the data file, a corresponding SPML Request will be generated to initiate a provisioning operation inside the Provisioning Server.

The example files used in this tutorial are in the SPMLManager/sampleTemplates/simple directory.