A JMS Target activity enables you to send messages to JMS server, such as Apache MQ Server, Oracle AQ Server and Oracle WebLogic using JMS provider. JMS target is used to post the target data in a topic or to post the data in the queue of a JMS Server.LAN File Target provides the ability to specify a target file location that is accessible on the network.
This section describes how to create a JMS LAN Target activity using the following details of a message to be sent to JMS server, as an example:
...
Connection Type
...
File Name | Employee_PersonalDetails.xls |
File Path | |
Transfer Type | SecureQueue |
NameFile System | ReceiveMessageWindows |
User NameId | MyUserName |
Password | Mypassword |
Delivery Mode | Delivery Mode |
Correlation ID | EmpDetails |
Prerequisites
JMS Provider activity must be created before creating JMS Target activity
Steps to create a JMS LAN File Target Activity
...
- Go to Account and click Manage Objects.
- Click
...
- TARGETS > LAN File Target.
...
- Click CREATE
...
- LAN File Target.
...
- On Create
...
- LAN File Target screen, enter the name and description of the new JMS Target in the textboxes Name and Description respectively.
...
- Enter the network path of the folder where you want the target file to be created in the textbox File Path field in the following format:
\\hostname\folder name
However, if the respective drive does not contain the folder mentioned in the path then the creation of the new folder will depend on the value of the system property abpm.target.createFolder and on the option value selected from the new drop-down list Auto folder Creation added in the Advanced Properties section. - Enter the name of the target file in textbox File Name.
- If you want to append date and time stamp in the target file name, then select the date and time stamp from the drop-down list of
...
- Time Stamp.
- If you want that each target file created by this activity should have unique name, then select the Create Unique File checkbox. When this option is enabled, a 30 digit random number is appended in the file name.
- File Extension
- Select the target file system, whether Windows or Unix from the drop-down list of File System.
- When Adeptia Connect is installed on Windows Operating System, LAN File Target uses windows service to connect to remote machine. It just connects once and uses the same connection with the same User ID and Password (which is stored in the cache) every time. If you want to enforce the validation of User ID and Password every time while accessing the remote machine, select the Use VFS checkbox.
- If username and password is required to access the target location, select the Secure checkbox.
- Enter the username and password
...
- in the textboxes
...
- User ID and Password
...
- fields respectively. Then
...
- re-enter the password in the textbox Confirm Password.
...
Enter the name, type, and default value for JMS message parameters in the Message Properties table.For example, enter the following values:
Name | Type | Default Value |
EmpId | Plain Text | 101 |
EmpSalary | PlainText | $$var$$ |
| Info |
|---|
| You can also add and delete rows in the Message Properties table as per your requirements. |
...
Click Advanced Properties to expand the hierarchy. All items in Advance Properties are displayed.
A new drop-down list Auto Folder Creation has been added. This drop-down list has the following three options:
- Persistent: Persistent messages are stored in the persistent storage to be delivered at a later date if a client is unavailable. Persistent Message is retained, even if the JMS Server is restarted.
Non-Persistent: Non-Persistent messages are not stored in persistent storage. The non-persistent messages are lost, in case the JMS Server is restarted.
| Info |
|---|
|
...
JMSExpiration = currenttime + timeToLive.
| Info |
|---|
You can override the following JMS Target Message Properties at runtime:
To know more on how to override these properties, refer to the Overriding JMS Target Message Properties section. |
- None
- Yes
- No
By default, the option None is selected.
When the value of the system property abpm.target.createFolder is set to Yes and if the option value selected from the drop-down list New Folder is:- Yes, then the new folder will be created.
- No, then the new folder will not be created and an error message will be displayed.
When the value of the system property abpm.target.createFolder is set to No and if the option value selected from the drop-down list New Folder is:- Yes, then the new folder will be created.
- No, then the new folder will not be created and an error message will be displayed.
If the option value selected from the drop-down list New Folder is None. In this case, None indicates that the folder will be created depending only on the value of the property abpm.target.createFolder.
If abpm.target.createFolder is set to Yes then the folder will be created and if abpm is set to No then the folder will not be created irrespective of the option value selected from the drop-down list New Folder.Select the project of the activity from the drop-down list
...
of Project.
...
Click
...
Save
...
.
...
Info You can verify the
...
LAN file target activity at design time. For this, click Test. This verifies the values
...
...
in the
...
File Path, User ID and Password fields and checks whether the file actually exists in the specified location. To test this activity, fill up all the required fields and click Test. If the file specified in this activity is present in the specified folder, the test will be successful otherwise it will give an error.