Technical blog

You'll find below a list of technical articles and white papers, sorted by date.

Inserting Convertigo Widgets in

Posted by Olivier Picciotto
Olivier Picciotto
Olivier Picciotto has not set their biography yet
User is currently offline
on Wednesday, 25 July 2012 in Convertigo

In this article Olivier Picciotto explains how to insert Convertigo widgets in the CRM product. In this way users can display some valuable data from existing applications embedded in SalesForce pages.

Convertigo widgets

Convertigo widgets are components created with Convertigo studio providing a user interface to interact with existing SOA or non SOA enterprise applications. See Convertigo Legacy Publisher, Legacy Integrator, or Convertigo Web Integrator getting started tutorials for more info about building widgets.

In this article we are using an existing Convertigo project providing a widget based on Convertigo Legacy Publisher. This widget uses the dynamic on the fly webization capabilities of Convertigo legacy publisher to make users interact with legacy AS/400 (iSeries) applications. This article applies to any type of Convertigo widget, but uses the AS/400 as a sample.

Inserting a widget in SalesForce

We use in this example a SalesForce developer edition.  This process is based on the salesforce’s Page objects inserted in specific display layout. First of all we will have to create our Convertigo salesforce’s Page.

  • Log in your SalesForce developer edition
  • Choose “Setup” in the user menu


  • In the left menu, choose Develop->Pages


  • Click “New” button to create a new page


  • Fill in the fields as shown.


Use the name you want for the label and the name. The magic comes from the apex code. If you know about SalesForce Visualforce pages you know that the page should specify a controller. In our case, as this page is to be inserted in a Contact display, we use the “Contact” standardController. As you see, this code will only insert an IFrame holding the Convertigo widget. This IFrame will load the widget from a specific url of this form:


  • Servername is the IP address or DNS name of the Convertigo server. In this sample, as we use demo Convertigo Cloud, we have “”
  • Convertigo_app_name is the application name. For Cloud server it is always “cems”, for on-premises it is usually “convertigo”
  • Project_name is the name of the convertigo project holding your widgets. In our case “KALO_demo”
  • Start_sequence is the name of the sequence used to start the project. In our case “start”.  In our demo, the start sequence needs a user parameter to authenticate the current logged user to the underlying AS/400 system.
  • Logged_user_name is the value of the user variable needed by our start sequence. In our sample, we use the visual force language to specify it dynamically by using this syntax: {!$User.FirstName}, representing the current SalesForce logged user’s first name.
Click “Save” to create your VF page.
  • Now we have to modify the layout of the Contact page. Choose “AppSetup->Customize->Contact-Page Layouts”
  • Click “Edit” on the layout you want to customize. 


  • Click on the “Visualforce Pages” link, you should see your previously created Visualforce page, here highlighted in blue.



  • You will just now have to drag and drop your VF page to one of the space in your contact details. Then place you mouse on the VF page, you should see a configuration tool.

  • Click on it to adjust the VF page’s width and height.

  • Click ok, and we are all set! When a user will display a contact, he will immediately have a section of his contact details filled with a Convertigo widget getting data from an existing   and allowing dynamic real time interactions with the AS/400.



0 votes
Tags: Untagged
Olivier Picciotto has not set their biography yet


Please login first in order for you to submit comments

btn developerNetwork_home

If you are a developer, an architect and more generally someone looking for technical information about our Mobile Enterprise Application Platform, Composite Applications, MBaaS and Convertigo, this is the right place for you.

btn downloadC8O_home

Get Convertigo Studio for Windows. This is our Eclipse based development tool for our Mobile Application Development Platform. You can get also Convertigo Servers for Windows and Linux directly on sourceforge

btn documentation_home

Find our official documentations for Convertigo Mobile Application Development Platform and Mobile Server, including the Reference Manual, the Programming Guide, and the Installation Guide, in both HTML and PDF formats.