Creating Bookmarks
This document explains how you create bookmarks in H5 and how to test bookmark parameters.
Outcome
A bookmark is created in H5 which lets you open a specific Business Engine program.
Create a bookmark in H5
Follow these steps to create a bookmark using M3 Business Engine in the H5 client:
-
Open the M3 BE program you want to bookmark, for example, 'Item. Open' (MMS001).
-
Select Tools > Add Start Page Shortcuts.
-
Specify a shortcut name and click OK.
Add the bookmark widget
Follow these steps to add the shortcut widget on your Start Page in the H5 client:
-
On the Start Pages, click 'Add Widget'.
-
Select the 'Shortcuts' widget.
Bookmark parameters
Developers can use (MTS043/A) to test how the bookmark parameters settings change the BE program behavior, for example, when working with Mashups.
Specify the required field values as described in the table with parameters to set and click Next to test calling on the program using the bookmark settings.
A bookmark contains several parameter values. The parameter values decide how the BE program will behave when it is started from a bookmark. This table shows how to set these parameters:
Parameter | Description | Value (example) |
---|---|---|
Program | The BE program to start, does not need to be a program in the menu. | MMS002 |
Table | The table name, reference to the key values. | MITBAL |
Key value 1 | Key value 1 according to primary key | 573 |
Key value 2 | Key value 2 according to primary key | A11 |
Key value 3 | Key value 3 according to primary key | BOOK-TESTS |
Key values 4-16 | Key values 4-16 according to primary key | (Leave these blank for MITBAL table. The primary key only has three fields.) |
This table shows the optional parameters to set for a bookmark:
Parameter | Description | Value (example) |
---|---|---|
Option |
The option to perform, for example 2='Edit' or 5='Display'. Note that you also can use all related options. Set a blank value to display the start panel. |
2 |
Panel |
Where to position in the panel sequence. Set a blank value to display the first panel in the user's default sequence. |
F |
Focus field | The field to set focus on. You can only set focus on a field if a panel has been specified. | WBSCGR |
Panel sequence |
The panel sequence to use. Set a blank value to display the user's default sequence. |
F |
Include start panel | Indicate if the user should return to the start panel, after walking through the panel sequence, or after processing the option. | true |
Start panel |
To use A or B panel as start panel. Set a blank value to use the user's default start panel. |
B |
Sorting order |
Sorting order (inquiry type) to use on the B panel. Set a blank value to use the user's default sorting order. |
1 |
View |
The view (panel version) to use (only relevant if a view is used by the list program). Set a blank value to use the user's default view. |
STD01-01 |
Start panel fields | Any start panel field. The field name should be the name with six positions used on the panel, for example, 'W2POTK' or 'WWFACI'. | (No B panel fields needed in this example) |
Parameters |
Extra parameters for the bookmark. Not all programs have extra parameters. In Metadata Publisher, you can see if a program has extra parameters for a bookmark. |
(No parameters for (MMS002)) |
The example values above will open the F panel in 'Item. Connect Warehouse' (MMS002) for item 'BOOK-TESTS' in warehouse A11. The F panel will be in change mode, focusing on the WBSCGR field. After leaving the F panel, the user will return to the B panel of the program.
Limitations
Not all programs are enabled for bookmarks.
In Metadata Publisher, you can get a list of which programs that support bookmarks. It also provides information for each program regarding:
- If it supports bookmarks
- What tables are used for the bookmark
- What parameters the bookmark has.