Button to Fire IOL Script

  • 1
  • 1
  • Question
  • Updated 3 months ago
  • Answered
What are the first steps to setting up a formula URL button to fire an IOL script if clicked?

Photo of Tyler Parker

Tyler Parker

  • 860 Points 500 badge 2x thumb

Posted 1 year ago

  • 1
  • 1
Photo of Ⲇanom the ultimate (Dan Diebolt)

Ⲇanom the ultimate (Dan Diebolt), Champion

  • 30,224 Points 20k badge 2x thumb
The title of you post "Button to Fire IOL Script" suggests you may be misunderstanding what the IOL Technique does. The purpose of the IOL Technique is to inject user supplied JavaScript (saved in a code page) into a {new, view, edit, report or grid edit} page for the purpose of enhancing the behavior of the page. The injection is done when the page first loads and the code that is injected immediately executes without any user interaction. When using the IOL Technique there may or may not be buttons involved - it depends completely on what the purpose of the script is.

Now if you want a button the most convenient way to introduce it is by tacking it on to the image onload field as follows:

[iol] & "moduleTable1.js" & [/iol]
"<a class='QBU_Button Vibrant Success' " &
"  data-rid='" & [Record ID#] & "'" &
"  data-name='" & [Name] & "'" &
"  data-payment='" & [Payment] & "'" &

This will result in the following HTML being spliced into the page:


<img qbu="module" src="/i/clear2x2.gif" onload="if(typeof QBU=='undefined'){QBU={};$.getScript(gReqAppDBID+'?a=dbpage&amp;pagename=moduleTable1.js&amp;rand='+new Date().getTime())};">

<a class="QBU_Button Vibrant Success" data-rid="1" data-name="Dan" data-payment="100">Button</a>


The first part of this HTML is the standard IOL Technique script injection. The second part of this HTML is a button with Vibrant Success class and three data attributes with values reflecting the values of three fields, [Record ID#], [Name] and [Payment]. In the code page moduleTable1.js we listen for a click on the button with class QBU_Button and when it occurs extract the three data attributes and store them in variables rid, name and payment,

  $("a.QBU_Button").on("click", function(event) {
    var rid = this.dataset.rid;
    var name = this.dataset.name;
    var payment = this.dataset.payment;
    var message = `rid=${rid}\nname=${name}\npayment=${payment}`;

So the Button does not "FIre the IOL Script." Rather the script listens for the button being clicked.

Here is a demo:

IOL With Button ~ Table 1 Dashboard

Pastie Database
Photo of Tyler Parker

Tyler Parker

  • 860 Points 500 badge 2x thumb
Makes much more sense now