Adding a BizComponent reference

BizDocument and BizComponent files typically contain references to other BizView files using the xa:bizdoc, xa:bizcomp, and xa:bizdriver attributes. The value of these attributes is a path and file name of the referenced file. Relative paths are supported and encouraged. When you add a file reference, you can add it as an attribute on a selected element or add it as a child element.

See the following options:

• Adding a BizComponent reference as an attribute

  You can add a BizComponent reference to a BizView file using the New Attribute dialog box.

  Use these steps.

  1. With the XML file open in Designer, right-click the element to which the BizComponent reference will be added and select Add attribute.

     The Add Attribute dialog box opens.

  2. Select bizcomp in the Name field.
  3. Type the path and BizComponent file name (including the .xbc file extension) in the Value field.

     The path and file name you type will be converted to the value of the xa:bizcomp attribute and stored in the BizView file.

  4. Click OK.

  The xa:bizcomp attribute and value are added to the selected element.

  Next step: Add a BizDocument Reference to this element

• Adding a BizComponent reference as a child element

  Use these steps.

  1. Right-click the element to which you want to add the BizComponent reference and select BizComponent Reference|Insert as child.

     The BizComponent Reference dialog box opens.

  2. Type the full path and file name of the BizComponent file in the BizComponent File field or select the file and path using the Browse button.
  3. Click OK.

     The BizComponent Reference dialog box opens.

  4. Fill out the BizComponent Reference dialog box, as necessary.
  5. Click OK when you are finished.

  A new child element appears in the selected element. The name of the new element is the name of the file you selected to reference. For example, if you selected a BizComponent called reference.xbc, the new child element would look like this: <reference xa:bizcomp="reference.xbc">. The xa:bizcomp attribute and value define the referenced file.

  Next step: Add a BizDocument reference to this element

• Adding a BizComponent reference on the element

  In Designer, you can add a BizComponent reference directly on an element. These instructions are useful when the BizComponent already exists in your project. To start a new BizComponent, use these steps instead.

  Use these steps.

  1. To identify the document to be referenced, you have two options. You can:
     1. Right-click the element to which you want to add the BizComponent reference and select BizComponent Reference|Apply on selected element. The BizComponent Reference dialog box opens.
     2. Type the full path and file name of the BizComponent file in the BizComponent File field or select the file and path using the Browse button. Click OK when finished.

        OR, you can:

     3. Select the document to be referenced from the Project Navigator tree, drag it to the element in an open document, and release it.

        The BizComponent Reference dialog box opens.

  2. Complete the fields and selections in this dialog box, as necessary.
  3. Click OK when finished.

  The xa:bizcomp attribute and value are added to the element you selected along with other, related attributes, such as xa:input, necessary to complete the reference.

  Next step: Add a BizDocument reference to this element

Did this topic help you? Send us your feedback. Last modified on: 6/16/2009 3:03:35 PM
Copyright © 2009 XAware, Inc. All rights reserved.