Creating and maintaining BODs

Business Object Document (BOD) elements are often mapped to objects in system tables or collections, although certain elements might be specified as literals or calculated values that are not tied to any table or collection. Generally, you can create elements and attributes of existing replication documents (including BODs) and modify them. In some cases, however, elements and attributes are editable only by someone with the same Access As identifier under which the replication document was originally created. In cases like this, you can create a copy of the replication document and customize the copy. For more information, see Copying a replication document.

Use this process to build or change an XML-formatted BOD file using metadata defined in system forms:

  1. Use the Replication Documents form to specify the general structure and conventions used by the BOD.
    1. Specify a Document Name for the BOD.
      This name is used only for internal reference. The actual BOD document name is formed by the values in the BOD Noun field and the BOD Verb field. These values are set on the Replication Document Outbound Cross-References form or the Replication Document Inbound Cross-References form.
    2. From the IDO drop-down list, select the IDO to be used to build the BOD.
      Alternatively, use the Custom Load Method field, the Filter field (for outbound BODs), and the Ins Upd Del Overrides field (for inbound BODs) to define a new IDO collection or a custom load method specifically for the BOD.
  2. To provide for the tags needed by the BOD, add elements to the body of the BOD, use this subprocedure:
    1. On the Replication Documents form, click Elements.
      This action opens the Replication Document Elements form. This form provides options to add elements to the body of the BOD, and to create the XML tags needed by the BOD.
    2. At a minimum, provide values for these fields and options:
      Sequence
      The system automatically provides a sequence number for each element. You can manually specify a different sequence number here, or use the Move After button and field to select the element that the current element should follow.

      This affects the order in which elements are displayed both on this form and in the XML document.

      Value Type
      From the drop-down list on the Primary tab, select the type of value to be used by the element tag in the XML.
      Attribute
      On the Attributes tab, provide a name for the attribute to be assigned to the element.
      Value Type
      From the drop-down list on the Attributes tab, select the type of value to be used by the attribute tag in the XML.

      Use other active fields or options on this form (including other tabs) as needed to achieve the desired outcome. For information about the individual fields and options, see the context-sensitive help topics for the fields or options.

    3. Repeat the previous sub-step for each new element and attribute (tag) you want to add.
    4. Save your work and close the linked form.
  3. Optionally, specify BOD header elements and attributes to be added to and used by the BOD:
    Note:  This step applies only to BODs intended for applications that use the standard Infor BOD formats. Generic BOD XML documents intended for other applications do not require these BOD header elements.
    1. On the Replication Documents form, click Add BOD Header Elements.
      This opens the Replication Document Elements form in linked mode again. This form displays with the appropriate header elements and attributes already defined.

      You can use this form to further define the elements and the attributes of those elements, as well as to map new, additional elements and attributes as required.

    2. If this BOD is to be used to publish deleted data, on the Attributes tab, change the Value Expresson of the actionCode attribute from Replace to Change.

      Perform this action on the Replication Document Elements form. Make sure you are changing the actionCode attribute.

    3. Save your work and close the linked form.
  4. Based on the intended use of the BOD, provide instructions on how it is to be handled:
    • For outbound BODs, click Outbound Cross-Refs.

      This opens the Replication Document Outbound Cross-References form in linked mode. Use this form to specify information about how this BOD is to be triggered. At a minimum, provide this information:

      Note:  Do not use this option if your application is used only to facilitate integration with other applications.
      Applies to IDO
      From the drop-down list, select the IDO that contains the affected table, or enter one of these values:
      • For a base table replication operation, specify this value using this syntax: TABLE!tablename, where tablename is the name of the source table.
      • For a replication operation that invokes a method call, specify this value as SP!
      Applies to IDO Action

      From the drop-down list, select which type of action is to initiate generation of the BOD: UpdateCollection, LoadCollection, or Invoke.

      If the Applies To IDO field value is set to TABLE! tablename, select UpdateCollection. If the Applies To IDO field is set to SP!, select Invoke.

      BOD Noun
      Enter the "noun" to be used as part of the noun/verb combination that defines the BOD to process. This noun is used to specify the actual BOD document name.
      BOD Verb
      Enter the "verb" to be used as part of the noun/verb combination that defines the BOD to process.

      Use other active fields or options on this form (including other tabs) as needed to achieve the desired outcome. Depending on the options you select or specify, other fields or options might be required. For information about the individual fields and options, see the context-sensitive help topics for the fields or options.

    • For inbound BODs, click Inbound Cross-Refs.

      This opens the Replication Document Inbound Cross References form in linked mode. Use this form to specify information about which replication document to use when a BOD with a particular noun/verb combination is received. At a minimum, provide this information:

      BOD Noun
      Enter the "noun" to be used as part of the noun/verb combination that identifies the BOD to be processed. This noun is represented by the BOD document name.
      BOD Verb
      Enter the "verb" to be used as part of the noun/verb combination that defines the BOD to be processed.
  5. After you define the replication document mappings for a BOD, you must perform one of these actions:
    • Set up replication for it.
    • Define the BOD as a generic (non-Infor) XML-formatted document.
  6. If you are updating a replication document for a BOD that has been replicated previously, you must restart the Replication Queue Listener service to clear the cache of old metadata for the BOD.