Progress
AppBuilder
Developer’s Guide


Placing and Configuring a SmartSender Instance

Once you have created a master object, placing an instance is a straightforward process. Follow these steps:

  1. Click the SmartSender tool icon on AppBuilder’s Palette:
  2. When the Choose dialog box opens, select the master object and click OK. Move your mouse cursor over your workspace and click to release the object.
  3. Save your work.

You are now ready to configure the instance. Follow these steps:

  1. Click the instance’s menu button and choose Properties. When the standard SmartObject Property Sheet opens, change the Object identifier (the instance handle) to more clearly reflect the role of this object in your application.
  2. If you wish to use this instance as a placeholder, set the Parameterize as Variable check box. For information about placeholders, see the "Creating a SmartObject Placeholder" in "Frequently Used Dialogs," and the Progress ADM 2 Guide .
  3. Click OK to close the Property Sheet. Click the menu button again and choose Instance Properties. The dialog box opens:
  4. Set the Destination property to the identifier or the SonicMQ Topic (Publish-and-Subscribe) or Queue (Point-to-Point) to which your message is to be sent.
  5. You can choose to set two other properties, if you wish:

    • Reply Required — Defaults to cleared. Setting this check box notifies the recipient that you wish a reply to your message. Your receiveReplyHandler routine must deal with any such reply.
    • Reply Selector — If you wish to filter incoming replies according to values in reply-header fields or properties, enter the expression here. The SmartConsumer object will perform the test on incoming replies and discard from the inbound queue/topic any messages that fail the test. Example: company_name = "ABC" AND priority >= 4. Any reply received from company ABC with a priority of 3 or less will be discarded without notice. The syntax is a subset of the syntax defined in SQL-92.
  6. Click OK to close the dialog box. Save your work.

Placing and configuring a SmartReceiver instance involves comparable steps. The major difference is that the SmartReceiver has no Instance Properties dialog box.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095