Welcome Guest! Log in
Stambia versions 2.x, 3.x, S17, S18, S19 and S20 are reaching End of Support January, 15th, 2024. Please consider upgrading to the supported Semarchy xDI versions. See Global Policy Support and the Semarchy Documentation.

The Stambia User Community is moving to Semarchy! All the applicable resources have already been moved or are currently being moved to their new location. Read more…


Stambia Published Web Services support defining and retrieving URL Path Parameters at invocation.

URL Path parameters correspond to dynamic information values which are part of a URL Path.

For instance, with the following URL, "id", and "2" are URL Path Parameters: http://stambia:42200/rest/StambiaDeliveryService/2/myDelivery/id/3

They can be defined, retrieved at invocation and used in web service flow as explained below

Prerequisites:
  • This is only available for the HTTP REST API
  • Stambia DI Runtime S17.3.0 or higher


Configuration of the Web Service Process

Creation of Process Parameters

 

First, create a Process Parameter that will receive the value which will be sent when invoking the web service.

Specify a default value to avoid the case where it wouldn't be provided at invocation.

1.parameterCreation

 

Then specifies that this is an Input Parameter in Publication tab:

 

set as input

 

Configuration of the META-INF

 

Next, lead to the Process Properties, and open Meta-Inf tab.

This is where we are going to specify that previously created Process Parameter will receive the value which will be sent at invocation at a particular position in URL.

There are two methods to configure this.

 

Method 01 - through dedicated nodes

 

Add in Meta-Inf tab the following sample of code and replace it with your own settings:

<httpRestWebServiceProperties>
     <urlPartMapper urlPartPosition="1" parameterName="My_Url_Parameter_01"/>
</httpRestWebServiceProperties>

 

Attribute Description Example
urlPartPosition Position of the Process Parameter in the URL. In provided URL example, a position of '1' would retrieve the 'id' value, and a position of the '2' the '3' value.
parameterName Name of the Process Parameter which will receive the value. My_Url_Parameter_01

 

You can put as many <urlPartMapper /> node as needed:

<httpRestWebServiceProperties>
    <urlPartMapper urlPartPosition="1" parameterName="My_Url_Parameter_01"/>
    <urlPartMapper urlPartPosition="2" parameterName="My_Url_Parameter_02"/>
    <urlPartMapper urlPartPosition="3" parameterName="My_Url_Parameter_03"/>
</httpRestWebServiceProperties>

 

Method 02 - through a mask in invocation path

 

Process Parameter name created before is defined directly in invocation path at expected position and surrounded with brackets.

Add in Meta-Inf the following sample of code and replace it with your own settings:

<httpRestWebServiceProperties path="user/defined/path/{My_Url_Parameter_01}">
</httpRestWebServiceProperties>

 

You can put as many parameters as you want:

<httpRestWebServiceProperties path="user/defined/path/{My_Url_Parameter_01}/{My_Url_Parameter_01}/{My_Url_Parameter_03}">
</httpRestWebServiceProperties>

 

Prerequisites:
  • Stambia DI Runtime S17.6.6 or higher

 

For further information about path attribute, refer to following article.

 

Using the parameters in the Process

 

From now at each invocation defined Process Parameters will be filled with values sent by the user invoking the web service.

You can then use those values through corresponding Process Parameters, as you would do for any other Process Parameter.

For further information about syntaxes to use Process Parameters, refer to following article.

 

Articles

Suggest a new Article!