Creating a SOAP service using the Service Wizard

You run the Service Wizard to create all the records needed to expose your application as a service. The Service Wizard walks you through entering the settings required to create the service. The Service Wizard does not create XML mappings for inherited properties, so you must add those properties as needed.

1. In Dev Studio, select Configure > Integration > Services > Service Wizard to start the Service Wizard.

2. Complete the Select Service Purpose section:

   1. Set the Service Purpose to Create and manage work.
   2. Set the Service Type to SOAP.
   3. Click Next.
      
   Note: Create and manage work is the most common reason to create a service. You invoke an existing service activity if you have created the activity previously. The Process input or output data provides an empty activity that you configure to get or process the desired data. The options in the Wizard differ based on the Service Purpose selected.

3. Complete the Provide Service Details — Select Work Properties section:

   1. Set Work Type to TGB-HRApps-Work-Onboarding.
   2. Set Flow Type to pyStartCase.
   3. Select Create Work and set the Organization to TGB.
   4. Click Next.
      

4. Click Next.

   Note: The pyStartCase flow does not have any flow actions that you want to consider a service to execute.

5. Select Use XML for data mapping to allow for list structures in the request.

   Note: Only properties defined directly in the TGB-HRApps-Work-Candidate case type are displayed. Inherited properties are not displayed and need to be added manually after the Wizard has been completed.

6. Select the following input properties:

   • .Employee.Manager
   • .Employee.StartDate

7. Click Next to confirm the properties to use.

8. Set the Ruleset Name to HRApps, and set the Ruleset Version to the version in which you are working.

9. From the Service Package Options drop-down list, select Configure a new service package, then click Next.

   

10. Keep the default settings in the Configuration Data Records screen. Click Next.

    Note: Requires authentication is selected by default. This means that you need to provide an operator and password when you call your service.
11. The Review and Save screen displays the records that will be created by the Wizard. Click Finish to create the records.

    The final page displays the records created by the Wizard.

    

1. Open the CreateNewWorkResponse XML parse rule generated by the Wizard.

2. Click Add Element to add the required input parameter that was not available for selection in the Wizard.

   

3. Double-click the new property to configure it.

4. Enter a Node Name and specify the Property to map the value.

   
5. Click OK to update your changes.

1. Open the service rule.

   Tip: You can access the service rule from the final screen of the Service Wizard. If you have closed this screen, you can open the Records Explorer and navigate to Integration-Services > Service SOAP to access it.
2. Click Actions > Run to test the service rule.
3. Select Supply SOAP request envelope to enter values for the test.

4. Update the request and enter values for each option. In the following screenshot, you see values have been entered for Employee, SSN, and FirstName.

   
5. Click Execute to test the service.
6. Your response will vary based on what you are attempting to do. If there is an error, you see a SOAPFault exception produced.