How Do I Implement a Web Services Trigger? (Magic xpi 4.13)

This How To topic will guide you through building a Magic xpi project that will be a Web service provider. The service will receive two numeric arguments from a Web services consumer (client). Magic xpi will receive the request, calculate the sum of the two numbers, and return it to the consumer.

1. Open the Settings dialog box's Resources section and define a new Web Services Server resource, with Magic SOAP server connection details. The default connection values are:

   • Server URL: http://localhost:6443/webserviceprovider

   • User name: admin

   • Password: changeit

2. Open the Settings dialog box's Services section and define a new Web Services service, named SumService.

3. In the Service Setting dialog box, select the previously created Web Service Server resource as the Web Service Provider. Enter a Web Service Name and use the default values for the remainder of the parameters, and click the Operations button, as shown below.

4. In the Operations dialog box, you should now define the Add operation and its arguments. Click the Add button to create a new operation, and name it Add.

5. In the Arguments section of the Operations dialog box, change the return value name to Sum, and change the type to Numeric.

6. Add two more arguments and name them Num1 and Num2. Set their Direction to In, and their Data Type to Numeric, as shown below.

Click OK to return to the Settings dialog box.

7. In the Settings dialog box, click the Management button to open the deployment Management dialog box.

8. In the deployment Management dialog box, you can generate the Magic xpi service. When you check the Deploy Web Service box, the service is deployed to the Magic SOAP server, enabling it to function.

9. Click the Generate button to deploy the new service.

You should see a confirmation message if the service was successfully deployed, or an error message with details if something went wrong.

If you get an error message, or a Not Authorized 404 message, you should check that the connection details in the Web Service Server resource are correct. You should also try to log in to the Magic SOAP server with the same user name and password.

If the generation and deployment of the service was successful, you can use the new service in a flow. To do this, follow these steps:

1. In the Solution Explorer, select the business process in which you want to insert the flow.

2. From the Project menu, click Add and then Flow. Name your new flow AddFlow.

3. Under the new flow in the Solution Explorer, double-click Flow Variables to open the Flow Variables repository. Create the following flow variables:

Variable Name	Type	Description
F.num1	Numeric	The first number.
F.num2	Numeric	The second number.
F.num	Numeric	The sum of the two numbers.

3. Drag a Web Services utility to the flow trigger area.

4. In the Web Services utility's Properties pane, select SumService from the Service Name drop-down list.

5. Double-click or right-click on the Web Services utility and select Configuration from the context menu to open the Web Services Trigger Configuration dialog box.

6. In the Web Services Trigger Configuration dialog box, select Add from the Operation Name drop-down list.

7. In the Return expression, use the F.num variable.

8. For parameters Num1 and Num2, use the F.num1 and F.num2 variables respectively, as seen below.

9. Click OK to exit the configuration of the component.

10. Next, drag a Flow Data utility to the flow area, and update the F.num expression with the sum of F.num1+F.num2, as seen below.

The resulting flow should look like this:

11. From the Build menu, select Build Solution to generate the flow for deployment.