Web Client Extension Creator

Previous  Next |  Direct link to this topic

WARNING: The Web Client Extension Creator only works on SAP Business One 10 FP2202 and Higher. More information about this requirement here

 

With the Web Client Extension Creator it is possible via B1 Usability Package to make Extensions for the SAP Business One Web Client. Below is an example of 2 such extensions.

 

clip0306

 

Define a new Extensions

In order to create an extensions you need to go to Tools > Web Client Extension Creator

 

clip0305

 

This will open you Extension Overview Screen

clip0307

Out of the box, the Extension Creator comes with a sample extension called "Boyum Cloud Apps" that showcase the system and can be installed with customers running our Cloud Apps.

 

In order to make an new extension, Press the "New Extension" (or highlight an existing one to edit it). This will open the Extension Editor

 

clip0308

 

Field

Description

Name

Here you define the name of your Extension (Will only be shown in the extension manager, not to the user). Please note that the name is also the ID of the extension so in can only have ASCII chars and if you change the name it is seen as a new extension by the system

Tiles

Here you define one or more tiles that you want your extension to have. In the sample at the top the Boyum Cloud Apps have 5 tiles while the "My tile" extension only have one. You need at least one time for an extension to be valid

Title and Sub Title

Here you define the Title and Sub Title of the currently selected Tile.

clip0309

URL

Here you define the URL that the tile need to navigate to when you press it. Only https:// prefixed urls are allowed by SAP.

Link Type

Here you choose if the URL defined should open in a new window/browser tab, or it should be opened as a sub-page inside the SAP Web Client (Only web-pages that allow iFrames can do this (If not supported, the screen will be blank when pressed))

Icon Type

Here you choose what icon your tile should have. You have 3 options here:

 

A SAP Icon (you can find the various icons on this webpage)

An external URL (where you host the Icon)

An Embedded image file (that will be embedded into the B1 Web Client as BASE64)

Active

Here you define if the current Tile is active or now (Inactive Tiles will not be included in you create the Extension)

 

 

Building the Extension

Once you have defined your Extension, you can from the overview Build the extension. All you need to do is to is highlight the extension you wish to build and press the "Build Extension" button.

clip0310

 

An extension is a .mtar file, so you need to choose what folder you wish to save the extension in. In our case here the output file will look like this

 

clip0311

 

First part of the filename is the name of the extension with any ascii chars replaced by underscores

Second part is the version number (The version in automatically generated as <year>.<month>.<build>. (<build> is 0 the first time you build the extension, then 1, then 2 if it happens the same year/month))

 

 

 

Deploying The Extension

NB: Deployment of extensions are 100% controlled by SAP's Extension Manager. Boyum Solutions offer no support using this tool

 

Tip: Importing an Extension for the First time and upgrading an existing extension with a higher version is the same process

 

In order to deploy the Extension you need to do the following

 

Go to the SAP Extension Manager by pressing the "Extension Manager" button on the overview screen or go to it via the SLD (Warning: the URL in below screen will be different from yours)

clip0312

Press the Import Button, choose "Browse" and choose you mtar file you built in previous step, and finally press the "Upload" button

You extension should now appear in the Extensions List

clip0313

Now go to the "company Assignment Tab" and assign the Extension to the Company you wish to use it in

clip0314

 

Once the Extension is assigned you simply need to refresh the Web Client (F5) and your extension tiles should be present under the extension section

clip0315

 

Should that not be the case, then check your Sidebar in the client to find them under "Extensions"

clip0316

 

From there you can then via the "Edit Home Page" button add them to the home screen

clip0318

 

clip0319

 

 

clip0320