Show TOC

Procedure documentationCreating an OBN Source Locate this document in the navigation structure

 

When a control in a runtime application contains an OBN hyperlink, clicking on it initiates object-based navigation. This application is an OBN source. In runtime, OBN searches for a target iView or page that has a matching business object, operation, and system alias. You can use portal content modeling in Visual Composer to create an OBN source application.

Prerequisites

  • A composite view application is open on the Layout board in Visual Composer

  • The application contains one or more of the OBN-supported navigational controls. The supported controls are:

    • Links

    • Buttons

    • Images

  • A portal system containing business objects with operations, or a development component containing modeled business objects with operations, is available.

Procedure

  1. In the Search or Browse task panel, select a business object and expand it to view its operations.

    • If you are using the Browse task panel, expand the Business Objects folder and browse the business objects in the portal to which Visual Composer is configured.

    • If you are using the Search task panel, search for business objects as follows:

      1. Select Business Objects in the Search in field.

      2. If you want a specific business object, enter a search parameter in the Search for field. Asterisks (*) may be used as wildcards.

      3. In the Type field, select either Business Object, to search in the portal, or Modeled Business Object, to search in the model repository.

      4. Click Search. The search returns a flat list of business objects.

  2. Select and drag an operation on to a control in the open composite view on the Layout board. This associates an OBN hyperlink to the control.

    Note Note

    If you use an operation from a modeled business object, it must be from the same development component as the application.

    If you use a modeled operation from the DTR, it can be from any development component.

    End of the note.

    You can repeat this step for additional controls in the application, but only once for each control. These controls will initiate object-based navigation when activated in runtime.

  3. Save the model, deploy it to the portal, and, if relevant, check it into the DTR.

Adding Parameters to OBN Hyperlinks

  1. Right-click a control that has an OBN hyperlink and choose Action. The Define Action dialog box opens. It shows the OBN hyperlink action and the action properties.

    The OBN URL property contains the parameters needed to find a target in runtime.

  2. To add parameters to the target search, you can edit the OBN URL using dynamic expressions. (More information: See the sections on dynamic expressions in this guide.)

Note Note

When adding parameters to the OBN URL, take care not to change the original, automatically created URL in any way. Doing so will adversely affect navigation in runtime.

End of the note.
Changing OBN Hyperlinks

If you want to change the OBN hyperlink, which you added to a control, you can delete it and replace it with a new one.