Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

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

\\FileServer\HR_Files\Employee

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

...

  1. Go to Account and click Manage Objects.

    Image Modified

  2. Click

...

  1. TARGETS > LAN File Target.

...


  1. Image Added

  2. Click CREATE

...

  1. LAN File Target.

...


  1. Image Added

  2. On Create

...

  1. LAN File Target screen, enter the name and description of the new

...

  1. LAN File Target in the textboxes Name and Description respectively.

...


  1. Image Added

  2. 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.

  3. Enter the name of the target file in textbox File Name.
  4. 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 

...

  1. Time Stamp.
  2. 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.
  3. File Extension
  4. Select the target file system, whether Windows or Unix from the drop-down list of File System.
  5. 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.
  6. If username and password is required to access the target location, select the Secure checkbox.
  7. Enter the username and password

...

  1. in the textboxes 

...

  1. User ID and Password

...

  1.  fields respectively. Then

...

  1. re-enter the password in the textbox Confirm Password.

...

  1. Click Advanced Properties to expand the hierarchy. All items in Advance Properties are displayed.


    Image Added

    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
  • The default delivery mode is persistent.

...

JMSExpiration = currenttime + timeToLive.

Info

You can override the following JMS Target Message Properties at runtime:

  • Delivery Mode
  • Correlation iD
  • Message Priority
  • Reply To
  • Time to Live
  • Message Properties

To know more on how to override these properties, refer to the Overriding JMS Target Message Properties section.

...

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.

...

      • 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.

  1. Select the project of the activity from the drop-down list

...

  1. of Project.

...

 

  1. Click

...

  1. Save

...

  1. .

...



  1. Info
    You can verify the

...

  1. LAN file target activity at design time. For this, click Test. This verifies the values

...

 

...

  1. in the 

...

  1. 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.