Progress
AppBuilder
Developer’s Guide


Configuring a SmartB2BObject Instance

If you have already created the map file, configuring a SmartB2BObject instance is straightforward. To begin the configuration process, click the instance’s menu button and choose Properties. This dialog box appears:

Then follow these steps:

  1. Change the Object identifier to more clearly reveal the role of this object in your application.
  2. If you wish to use this object as a placeholder, set the Parameterize as Variable check box. For information about using instances as placeholders, see the "Creating a SmartObject Placeholder" in "Frequently Used Dialogs."
  3. Choose OK and save your work.

You are now ready to configure the instance properties. The SmartB2BObject’s instance properties vary depending on whether the object will process incoming or outgoing documents. In either case, begin by clicking the menu button and choosing Instance Properties from the menu that opens.

Outgoing Instance Properties

If you have already linked this object to a SmartProducer, the dialog box should open with the Producer tab selected. If not, select it now:

Then follow these steps:

  1. At a minimum, configure these fields to use XML:
    • XML Mapping File — Type in the path to the file that this object will use when transforming documents.
    • Destination — The logical identifier of the outbound document’s destination. At present this must be a Queue or Topic served by the Progress SonicMQ system.
    • If you prefer to use a DTD (Document Type Definition) file, set the Use DTD checkbox. This will enable the Public ID and System ID fields. Fill them in.

    • Public ID (DTD) — (Optional) Enter the global public identifier of the DTD document.
    • System ID (DTD) — (Mandatory) Enter the path to the actual DTD file. Click the Browse button if you wish to search for the file.
  2. Examine these fields and change those that do not meet your needs:
    • Reply Required — Defaults to cleared. Setting this check box will notify recipients that you wish a reply sent to you whenever they receive a document of this type. You must add code to handle these replies.
    • Reply Selector — If you wish to filter incoming replies according to values in reply-header fields or properties, enter the expression here. The SmartProducer object will perform the test on incoming replies and discard from the inbound Queue/Topic any messages that fail the test. Example: company_name = "Smith" AND priority > 4. A reply from the Smith company with priority of 4 or less would be discarded without notice. The syntax is a subset of the syntax defined in SQL-92.
  3. If this SmartB2BObject will create different documents from the same data stream, or send to different real-world or JMS destinations, choose the Multiple Producers pushbutton. Additional fields come into view:
  4. For each document type/destination pair, fill in the fields identified in Step 1 and Step 2.
  5. To specify where to find the name reference at run time, set the Document Name Data check box. Three additional fields activate themselves. Change their values as appropriate:
    • Data Object — Select the SmartDataObject or other data-handling object that handles the data for the new document type.
    • Column, Function — Defaults to Column. Selecting Function means that the Document/Direction Name value is returned by a function in the data object rather than by one of its columns.
    • Column/Function — [The label on this fill-in reflects the current radio-button selection.] Select the column or function in the data object that will return the Document/Direction Name.
  6. Choose the Save button to add the new document information to the list in the browser widget.
  7. NOTE: If you decide not to add this entry, choose Cancel instead of Save. If you decide you made a mistake in saving an entry, choose the Delete button.

  8. To add an additional entry, click the Add button and repeat Step 4 through Step 6.
  9. When you have added all the document types/destinations you desire, save your work.
Incoming Instance Properties

If you have already linked this object to a SmartConsumer, the dialog box should open with the Consumer tab selected. If not, select it now:

To configure this object for consuming, follow these two steps:

  1. Identify the mapping file.
  2. Save your work.

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