M3 Search and List
Use this widget to search data in M3 based on the defined search query input and limited program transactions.
Additionally, you can perform these tasks:
- Perform a refined search on the widget to view only specific, existing data.
- Get the total count of records based on the widget configuration. If the total count exceeds the maximum records, a plus sign is only added to the count, for example, 100+.
- Drillback to M3 by running the configured bookmark.
Prerequisite
To require the widget to use an InforWidgetContext message, ensure that either M3 Information Viewer, M3 Information Monitor, or M3 Information Editor is added to your workspace.
Supported languages
The widget interface, labels, and configuration options are displayed in the user's preferred language. If the preferred language is not supported, the widget is displayed in English (en-US).
This widget supports these languages:
- Arabic (Saudi Arabia) - ar-SA
- Bulgarian (Bulgaria) - bg-BG
- Chinese (Simplified, China) - zh-CN
- Chinese (Traditional, Taiwan) - zh-TW
- Croatian (Croatia) - hr-HR
- Czech (Czech Republic) - cs-CZ
- Danish (Denmark) - da-DK
- Dutch (Netherlands) - nl-NL
- English (United States) - en-US
- Estonian (Estonia) - et-EE
- Finnish (Finland) - fi-FI
- French (France) - fr-FR
- German (Germany) - de-DE
- Hebrew (Israel) - he-IL
- Hungarian (Hungary) - hu-HU
- Italian (Italy) - it-IT
- Japanese (Japan) - ja-JP
- Korean (South Korea) - ko-KR
- Latvian (Latvia) - lv-LV
- Lithuanian (Lithuania) - lt-LT
- Norwegian Bokmål (Norway) - nb-NO
- Polish (Poland) - pl-PL
- Portuguese (Portugal) - pt-PT
- Romanian (Romania) - ro-RO
- Russian (Russia) - ru-RU
- Slovenian (Slovenia) - sl-SI
- Spanish (Spain) - es-ES
- Swedish (Sweden) - sv-SE
- Thai (Thailand) - th-TH
- Turkish (Turkey) - tr-TR
- Ukrainian (Ukraine) - uk-UA
- Vietnamese (Vietnam) - vi-VN
Widget management
| Task | Description |
|---|---|
|
Configuring the widget |
Use the topic to prepare the widget for usage. Define the search criteria, display settings, output fields, and bookmark options for retrieving and viewing records. |
Configuring the widget
Use this procedure to configure the data to search in M3. The values for each field shows an example configuration for which you use the widget to search for customers and view existing records in H5 using a bookmark.
- Click the menu icon on the widget title bar and select ..
- On the Settings window, specify this information:
- Title
- Click the unlock button and specify a widget title.
- Program
- Click the look-up icon in this required field and search for a program, for example CRS610MI, for which you will add and execute the search query on widget load. Click .
- Transaction
-
Click the look-up button and search for a transaction, for example SearchCustomer, to get the action required for the program when you execute search on widget load. Click .
Note: Field value must be SQRY.
- Default query (SQRY)
- Provide the default search query. For example, specify the asterisk symbol to perform a wildcard search by retrieving words that are related to the exact record that you need. Another example is CUNM:1000 which means that you are searching for all records with customer name that contains the value of 1000. This field also receives InforWidgetContext messages which you can enable by adding an entity using this format: {<EntityType.idx>}, for example CUNO:{InforCustomerPartyMaster.id1}.
- Returned records (maximum 100 returned)
- Specify less than the maximum count of records to return upon loading of widget.
- Execute search on widget load
- Select this check box to perform the search automatically on widget load.
- Output configuration
-
Click to configure the display of data on the widget. Provide the required data or action item for each column:
- Selected: Select this check box to indicate which field should be displayed on the widget. For example, select the Customer number (CUNO), Name (CUNM), and Status (STAT) fields
- View Order: Provide a number to indicate the order by which the field is displayed on the widget. The lowest number places the field on the top order. Optionally, you can leave this column as blank.
- Style: Select the applicable label style for the field. Header fields are emphasized with a bold attribute. For example, select Header for CUNO and select Regular field for both CUNM and STAT.
- Entity type: Specify an entity type. When you click a record on the search list result, the widget uses this entity type value and ID to create an InforWidgetContext message. The context message is then sent to other widgets that listen and retrieve the required values.
- Entity ID: Select the variable ID of the entity in a business context message, for example, id1.
- Translate: Click the icon to translate a field name.
- On the Translations dialog, click .
- On the Add Translation dialog, select a language and specify the translated text for the field name.
- Click .
- Bookmark configuration
-
Click Bookmark configuration to configure bookmarks to be displayed on the M3 Search and List widget for every row of searched record.
- On the Bookmark Configuration dialog, specify this information:
- Display bookmark icon
- This field is only disabled when the Saved bookmarks field contains a value. Select this check box to add the bookmark icon on the widget display.
- Saved bookmarks
- Select from the list of available bookmarks. Optionally, you may leave this field blank.
- Bookmark URL
- Copy a raw bookmark from M3 or provide a URL that is updated manually.
- Variable validation
- This functionality automatically validates any changes to a bookmark URL. It displays a warning symbol if the change is invalid or displays the exact change with a check mark if acceptable.
- Click .
- On the Bookmark Configuration dialog, specify this information:
- From the widget's main configuration display, click .