GeneXus For SAP Systems Launchpad Object

Official Content

With the Fiori Pattern comes the Launchpad that provides a simple and easy way to keep your objects organized using tiles.

GeneXusForSAPSystems_Launchpad_Launchpad_png

The Launchpad is a Web Panel object that calls the ListFioriPrograms procedure to load the tiles.

The data returned by the ListFioriProgram procedure for each tile is marked in the image below:

GeneXusForSAPSystems_Launchpad_Tile_png

You can customize each tile by setting properties. The properties available to be set can be found under the corresponding pattern instance of the linked object and appear only if the Include in Launchpad property is set to true.

There are three kinds of Tiles:

  • Information Tile:
    This is the default tile. It is a plain white tile that displays information regarding the associated Transaction or SD Panel.

InformationTile_2018823103550_1_png

  • Image Tile:
    This tile has a background image and a label with information.

          ImageTile_png

  • Web Component Tile:
    This tile has a background component and a title.

WebComponentTile_png

Below are described the tiles parts you can modify (and if the update implies to set properties, they are mentioned):

  1. The description:
    It can be modified by editing the Description property on the pattern tab.
  2. A link to the object.
  3. The icon for the tile:
    An icon is set by default. You can set another icon to show by editing the Tile Icon Unicode property and selecting one from the SAP Icon Explorer.
  4. The tile indicator:
    The tile indicator by default shows how many records (count) are available associated with the object. You can choose if you want to use it, change its definition or not using it at all, by setting the Tile Indicator property offered by the pattern. If you leave it blank you mean that you don't want to show it.
  5. The tile information:
    The tile information is used to give an extra description for your tile. By default is empty. To update it you have to set the Tile Information property
  6. The tile Size:
    The tile Size determines your tile size. It can be simple One Block or Two Blocks.
  7. The Tile Type:
    The tile type sets the kind of tile to be used.
  8. The Tile Image(Only for Image Tile Type):
    The tile image sets the image to be used as the background of the tile.
  9. The Tile Web Component(Only for Web Component Tile Type):
    The tile web component sets the component to be used by the tile. To make the web component fit the tile you need to set the web component width to 350px and height 130px(for a Two Block sized tile).

To select if you want to display an object on the Launchpad or not, you can use the Include In Launchpad property on the pattern tab.
GeneXusForSAPSystems_Launchpad_IncludeInLaunchpad_png

If you want to add objects, you need to edit the ListFioriPrograms procedure. To do this, you have to open the procedure. Once being in the source section, you have to copy one of the tile's code. Then paste it outside of the code generated by GeneXus (to prevent it from being overwritten by GeneXus). Finally, don't forget to edit the pasted code to call the object you want to add.

/* Generated by GeneXus Fiori Pattern [Start] - Do not change */
...
/* Generated by GeneXus Fiori Pattern [End] - Do not change */

Use the code below to insert an Information Tile

&name = !"SalesOrderListReport"
&description = "Sales Order"
&link = SalesOrderListReport.Link()
&TileType = TileType.Information
&TileSize = TileSize.TwoBlocks
&iconUnicode = !""
&information = ""
&Count = 0
For Each SalesOrder
       &Count += 1
EndFor
&indicator = trim(&Count.ToFormattedString())
&sessionKey = !"SalesOrderListReportGridState"
&orderIndex = 0
Do 'AddProgram'

 

Use the code below to insert an Image Tile (The variable information is used to load the image)

&name = !"ProductListReport"
&description = "Product"
&link = ProductListReport.Link()
&TileType = TileType.Image
&TileSize = TileSize.TwoBlocks
&information = comics.Link()
&sessionKey = !"ProductListReportGridState"
&orderIndex = 0
Do 'AddProgram'

 

Use the code below to insert a Web Component Tile (The information variable is used to load the web component)

&name = !"CustomerListReport"
&description = "Customer"
&link = CustomerListReport.Link()
&TileType = TileType.WebComponent
&TileSize = TileSize.TwoBlocks
&information = "CustomerGeneral"
&sessionKey = !"CustomerListReportGridState"
&orderIndex = 0
Do 'AddProgram'

How to customize your Launchpad

To customize the title of your Launchpad, open the FioriLaunchpad Web Panel and go to the Events section.

EventsLaunchpad_png

Lastly, add the code below to the Start Event:

AppHeader.Caption = <Insert the new title here>

 

How to create your own customized Launchpad.

To create your own customized Launchpad, follow the next steps:

  1. Make a copy of the FioriLaunchpad web panel and the ListFioriPrograms procedure, by saving and renaming them.
     
  2. Modify your customized Launchpad to make it look like you want to. To modify the tiles you want to load, there are two ways to do it: 
    • From the grid load event on the web panel, you can add a filter to select which tiles you want to add.
    • From the customized ListFioriPrograms you can add/delete/modify tiles.
       
  3. If you want your customized Launchpad to be organized into different sections you have to make a copy of the existing grid on your web form and create a new Load event to customize the tiles to be added to this new grid (remember to rename everything on this new grid and to hide the variable's grid). Also to make the tiles fully functional, you need to create the click events for them (you only have to copy the click event for the original tiles and update it to use the new variables).

 

 

Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.