Inserting an HTML frame into a Model

This article provides steps on how you can insert an HTML frame within a model so that you can create access to a third party application from within your published model.

1. Create a General Diagram and place a shape on it.

General Diagram.jpg

2. Insert an HTML frame in your shape by double clicking on the shape and selecting Insert Control.


3. Click on the ellipsis next to the Control field and select Html Frame from the list. 


4. You can resize the HTML frame to your requirement by editing the Height and Width in the Design Dimensions field. 

Frame Size.png

5. Add the URL for the HTML frame by clicking on the Options icon and then entering the URL of the application that will be accessed from the HTML frame you are creating. This URL can be provided in the URL field. 

Note:  If you want to add JIRA issue collectors, then you must use the following URL:       

 <JIRA URL including http or https>/rest/collection/1.0/template/form/<JIRA Issue Collector ID>?os_authType=none#

Save and check in the library. Once you publish the library, the third party application can be accessed via the General Diagram you created above. 

Restricted access permissions on Model Libraries

This article provides steps on how you can create a new library (that uses an existing library as the prerequisite library) and restrict access permissions on the newly created library.

1. In your repository explorer, create a new Content Area.

New Content Area A.png
New Content Area B.png

2. Right click on the Content Area you created in the previous step and click on New Library.

New Library.png

3. Select the Advanced folder and select Blank Library.


4. Provide a name for the library in the Name field and click on the option Edit Properties & Create.


5. To make an already existing library the prerequisite library for this new library, select the Prerequisites tab. Add a layer and select the required prerequisite library by clicking on the ellipsis in the Library field.  


This way any changes made in the prerequisite library can be seen when you access the new library you created. 

Let's now look at how you can define the restricted access permissions.

6. Let's take an example as seen in the image below. "Main Area" is the Content Area that you want available to all users and "Private Area" is the Content Area that has the restricted access library.  


       a. At the highest level (Content Area named "Instructions"), remove the access                       permission for All Users.

       b. In the Content Area "Main Area" assign access permission to All Users.

       c. In the Content Area "Private Area" assign the restricted access permissions. Grant             permission only to the specific user group.

Note: For details on assigning permissions to users/user groups, see the Administration Guide.

Now you have two Content Areas and within those areas, two libraries. The library "Main Area Library" can be accessed by All Users. The Library "Private Area Library" has restricted access permission but will always load the contents of "Main Area Library". 

Publishing with RMU enabled in BMS 3.1.3

When enabling RMU in BMS 3.1.3, you will not be able to compare with a version that has been published prior to BMS 3.1.3. 

To overcome this, you must re-publish in BMS 3.1.3 the previous final version that you want to compare with. 

To do this,

1. Expand the published models list to determine the previous final version of the published model (i.e. the model version that was published in a version prior to BMS 3.1.3). 


2. Right click on the model library and select Properties...


3. Select the Version History tab and locate the model with the same version as the previously published Final model. Right click on the model and click on Check Out as Latest Version...


4. Once the library has been completely checked out, save and check in the library. When checking in, select the option to publish the library and in the next window that appears and click on Publishing Options... 


5. In the window that appears, select Draft as the release version and ensure RMU and notifications are disabled as shown below. 


6. Complete the publishing.

7. Once the publishing is completed, right click on the published model and select Properties...


8. Change the release version to Final and click on Save.


9. Repeat steps 3 to 5 for the current Final model version, but this time publish the model as Final with RMU and notifications enabled as shown below. 


The model will now be published with RMU enabled and you can compare with the previous final version of the model library. 

Setting the optimal screen resolution for Modeler

Using high DPI display settings on your screen can result in a change of the layout of BPAD and BPD diagrams, specifically with the appearance of the text size and arrow spacing in these diagrams. To resolve this issue you must change the Windows display settings for your screen.

To do this,

1. Open Windows Settings (click the Windows button on your desktop and type Settings).

2. Select the Display tab  and change the setting for Change the size of text, apps and other items to 100%.

Display Settings.jpg

Note: In some screens, setting this to 100% may result in the text being too small. In such cases, please ensure you change the settings for the Resolution to a lower value.  

3.   Log out and log back in the issue should now be resolved.


  • It is important that you sign out and sign in again for the Windows display setting to be applied. If you are using terminal services such as Remote Desktop, you must ensure that you log out of your terminal service session rather than closing the session. 
  • If you are using Windows 7, follow the instruction here to change the DPI settings. 

Handling the error message: Client broker not running

At times, new installations of Modeler will get the following error message when attempting to connect to a server:

“Client broker not running – cannot make connections.”

This is because the Windows feature “.Net Framework 3.5” is not enabled. To resolve the issue navigate to Control Panel -> Turn Windows features on or off. Then select the relevant checkbox next to .NET Framework 3.5 as follows:


Create an Ad-hoc Task

Sometimes there is a need to send out ad-hoc tasks to BMS users for them to complete. Tasks that can be assigned to users are of the below types:

  • Approval Task: Approval Tasks require the assigned users to approve the related items, then provide a comment and an affirmative or negative response. Once a response has been received, the task is considered complete.
  • Confirmation Task: Confirmation tasks can be used to ask questions of assigned users. A user must answer affirmative or negative to the question posed, and once the user has done so, the task is complete.
  • Feedback Task: Feedback tasks require a text input from the assigned users before they can be submitted. Once submitted, the tasks are considered complete.
  • Information Task: Creating information tasks provides messages to the assigned users, which they can acknowledge. Acknowledged tasks are considered complete. No other action can be taken on an information task.
  • Review Task: Review Tasks require the assigned users to examine the related items, then provide a comment and an affirmative or negative response. Once a response has been received, the task is considered complete. 

To create a new ad-hoc task for an item:

1. In Modeler, access the properties of the item to which you want to link the task

2. Click the General tab (1) and then the Tasks sub-tab

3. Click the ‘Add New Tasks’ button to the right of the tasks sub-tab and select the task type you wish to create. 

4. Complete the details for the task as appropriate and click OK


  • Only one assignee is allowed per task
  • For Release: You can create the task against libraries that are in particular published release states (Draft, Proposed, or Final) or all three published release state
  • Required publishing before available: If checked, the task will only become active following the next publication of the library (of the nominated release state). Leaving the box unchecked makes the task appear in the selected published library immediately.
  • Start, Due and Reminder Dates: The dates the task becomes active, is due, and if required when a reminder email will be sent (if the task has not been completed) 
  • Description of work: The description of the work you require the assignee to perform
  • Enable escalation, Escalate (period), and Escalate to:  If required, you can choose to have the BMS escalate the task to an appointed person if the task has not been actioned within the chosen timeframe
  • An item can have more than one task at any one time. Tasks only appear on the item’s task sub-tab until they have been completed. At that point they are automatically removed and can be accessed in Modelpedia under the ‘My Completed’ tab of your Task List

Managing your own Favourites List

You can add items to your own favourites list. This list is available to you from device to device – be it desktop, iPad or iPhone.

To add an item to your favourites list:

  • Click the favourite icon located on the item’s context menu

Result: The favourite icon for that item displays as black  and the item is added to your favourites for that library

To review all of the items that you have added to your favourites:

  • Click the hamburger menu at the top right of the published model to expand it

Result: Any items you have added to your favourites appear in an alphabetical list grouped under the ‘Favorites’ heading.