SMS Invocation Application

The SMS Invocation Application allows to send SMS with Process Data.

You can perform the following operations on an SMS Invocation Application.

• Viewing and Editing Properties
  • Parameters
  • Configuration
  • Connection
  • Comments
• Example
• Dependency

Viewing and Editing Properties

Following properties should be specified:

Figure: Properties - SMS Invocation Application

• Application Name - Specify name of the application
• Description - Specify the description
• Public Visibility - By default, this check box is selected. It indicates that the element is visible and available for reference from any other model.

In case you switch to the Integrator profile, UUID and ID options are displayed additionally.

• UUID - A unique identifier ID gets generated as an identifier for client server communication
• ID - An ID generated automatically based on the application name. If element with the same name exists then during ID generation, a numerical suffix gets added to the ID. If the element is renamed, the ID gets regenerated.

Figure: UUID and UI Properties

Parameters

Only Input Parameters can be created. These objects can be accessed by ID from within the SMS editor.

• Parameter Definition - To define input parameters, click the Add icon. The parameter gets added to parameter definition table.

  
  Figure: Parameter Mapping

• Name - Specify name for the new parameter
• Direction - Only In option is provided:
  • In - For read access
• Data Type - Following data types are supported:
  • Primitive - If you select Primitive data type, you need to provide Primitive Type.

    
    Figure: Primitive Data

  • Structured Data - If you select structured data, you need to provide Structure Type. It also lists structured types from other models.

    
    Figure: Structured Data

Configuration

The configuration tab contains the text message to be sent. The Auto Startup check box specifies whether to auto startup the Camel route for this application.

Figure: Configuration - SMS

Connection

In the Connection tab, enter the details related to the SMS server host, port, system ID, password, sender and destination message address (directory number of the recipient)

Figure: Connection - SMS

Comments

Click the Comments tab to add comments for the application. To add the comment, specify the comment in the text box and click Submit. The newest comment gets displayed at the top of the table. To delete the comment, select the comment and click the Delete icon. The user, who has submitted the comment, can delete that comment. If the other user selects the comment or no comment is selected, the Delete icon remains in disabled state.

Figure: Comments

Example

This process shows how to send a text message using SMS Invocation Application.

The input entered manually by the user is a structured data Person that contains two string variables (firstName and lastName).

In this case, the delivered message will be generated with dynamic customer details(firstName/lastName).

After deploying the model and starting the process, enter customer details. Once you complete the activity the message will be sent to the customer.

The received message is displayed as below:

Dependency

To use SMS application, the following dependencies should be added to your pom.xml file:

<dependency>
	<groupId>org.apache.camel</groupId>
	<artifactId>camel-smpp</artifactId>
	<scope>runtime</scope>
	<exclusions>
		<exclusion>
			<groupId>org.apache.camel</groupId>
			<artifactId>camel-core</artifactId>
		</exclusion>
		<exclusion>
			<groupId>commons-codec</groupId>
			<artifactId>commons-codec</artifactId>
		</exclusion>
	</exclusions>
</dependency>
<dependency>
	<groupId>org.apache.servicemix.bundles</groupId>
	<artifactId>org.apache.servicemix.bundles.jsmpp</artifactId>
	<scope>runtime</scope>
</dependency>