Creating an Anchor Hierarchy for a Companion

Use

You use this procedure to create a business anchor hierarchy at the business component level in a mobile client companion.

We recommend that you must understand how to model business anchor hierarchies for a mobile client application thoroughly before performing this procedure. This topic is intended for the users who have expert knowledge in modeling business anchor hierarchies for a mobile client application using Mobile Application Studio (MAS). For more information, see Creating an Anchor Hierarchy for a Business Component.

You must create an anchor hierarchy between business anchors that are created at the tile level to fulfill the following requirements:

·        Requirement 1: To allow navigation from one tile set to another tile set in different scenarios as indicated below.

¡        Scenario 1: The hyperlinks you create for navigation work only if you create a hierarchy between the source and target business anchors at the business component level.

You have created the hNotes hyperlink source for the PDABPDetails tile. You have mapped this hyperlink source to the PDABPNotelist hyperlink target via the PDABPtoNotes hyperlink. In this case, you must create a hierarchy between the source anchor (BOCAPGENTile) of the PDABPDetails tile and the target anchor (BONOTE) used in the PDABPNotelist hyperlink target.

¡        Scenario 2: You must create separate anchor hierarchies each time you use the same tile in different tile sets. This is required for creating an anchor hierarchy for the business component used in a companion.

You want to use the Note List tile in both the Business Partners tile set and the Contact Persons tile set. The business anchors created for the tile and tile sets are BONOTE, BOCONGEN and BOCAPGEN respectively. During runtime, to allow navigation from the:

§         Business Partnerstile set to the Note List tile, you must create a hierarchy between the BOCONGEN and BONOTE business anchors.

§         Contact Persons tile set to the Note List tile, you must create a hierarchy between the BOCAPGEN and BONOTE business anchors.

·        Requirement 2: To allow synchronization of business data in specific cases during runtime.

You have added specific additional controls to a tile by using properties of a different data source and do not want to display these controls on the tile. In this case, you must create an additional hierarchy between the business anchor of the data source and the parent business anchor of the tile. Otherwise, data provided by these additional controls cannot be synchronized on the PDA device.

Prerequisites

You have identified the:

·        Parent and child business anchors for which you want to create a hierarchy, depending on the requirements indicated in the Use section

·        Business object relationships between the business objects referenced by each of the parent and child business anchors

·        Business component that you have modeled for the mobile client companion

Procedure

       1.      From the Object Browser, open the specific business component in the edit mode.

The business component design area appears.

       2.      In the Business Component pane, expand the specific tile set containing a parent business anchor.

       3.      Copy the parent business anchor on to the Business Anchors pane using drag and drop.

       4.      In the Business Component pane, expand the specific tile set containing a child business anchor.

       5.      Copy the child business anchor under the parent business anchor using drag and drop.

       6.      In the Properties window, enter necessary values for the child business anchor by performing the following substeps.

                            a.      In the Supply Type field, choose By Relationship.

                            b.      In the Supply Relation field, specify the name of the business object relationship.

To create a hierarchy with more than one child anchor, repeat steps 4, 5 and 6.

       7.      Save the business component.