Interface objects

//change F_SingleLine to the ID of the desired field 
BO.F_SingleLine.setValue(app.getCurrentUser());

var form = app.getForm('F_Form1');
     var service = form.getServiceConfiguration('SC_ServiceConfig0');

     service.connectEvent('onCallFinished', function(pSuccess)
     {
     alert('call finished');
     });

app.getLocation(callbackFunction, highAccuracy)

Allows the form designer to get the current user's location.

callbackFunction - the callback that occurs after the location request finishes. The designer must define the function to have one argument which will be assigned a Position object if the location request was successful, or null if the request was unsuccessful. Inside the function the designer can assign location attributes to different fields. Five values can be accessed:

• position.coords.latitude
• position.coords.longitude
• position.coords.accuracy
• position.coords.altitude
• position.coords.altitudeAccuracy

More information in https://developer.mozilla.org/en-US/docs/Web/API/Position/.

highAccuracy - a boolean value that requests a high accuracy location from the browser if true. See https://developer.mozilla.org/en-US/docs/Web/API/PositionOptions/enableHighAccuracy.

Set the value of F_SingleLine1 to the current location:

var highAccuracy = true;
var myCallbackFunction = function (position) {
  if (position !== null) {
    BO.F_SingleLine1.setValue(position.coords.latitude+", "+position.coords.longitude);
  } else {
    alert("Location request failed");
  }
};
app.getLocation(myCallbackFunction,highAccuracy);

app.getSharedData().titleToShow = 'Welcome Form';
     app.getSharedData().addTwoValues = function(v1,v2)
     {
     return v1 + v2;
     };

BO.F_SingleLine.setValue(app.getSharedData().titleToShow);
BO.F_Number.setValue(app.getSharedData().addTwoValues(5, 5));

var suppressWarning = app.getSuppressWarning();
if(suppressWarning === false)
  app.setSuppressWarning(true);

page.F_StaticWebLink.setLinkValue(BO.F_ServerURL.getValue() + '/apps/secure/1/app/' + app.getUID() + '/launch/index.html?form=F_Form2'));

var param= app.getUrlParameter('debug')
if(param === 'true')
   alert('Shown only when debug param is present');

var params = app.getUrlParameters();
     if(params.CustomWarning)
     alert(params.CustomWarning);

app.setSuppressWarning(true);

app.showMessage(title, message, type, subtitle)

title: The title to display in the dialog title bar.

message: The message text to display.

type (optional): can be one of "info", "success", "warn", or "error" and results in appropriate icon being displayed. If type is absent or not one of these values, then no icon will be displayed.

subtitle (optional): Heading text for the message.

app.showMessage
("Error found in data",
 "The booking date cannot be after the event.",
 "error",
 "Please change the booking or event date, then re-submit.");

form.addClasses(emphasized error);

form.backwardPage();

var hndl = form.connectEvent('onLoad', function()
     {
     if(form.getBO().F_CurrentUser)
form.getBO().F_CurrentUser.setValue(app.getCurrentUser());
     }
     });

form.disconnectEvent(hndl);

form.forwardPage();

var myForm = app.getForm('F_Form1');
var formBO = myForm.getBO();
formBO.F_SingleLine.setValue('setting the value using code!');

var pageShown = form.getCurrentPage();
if(pageShown === 'F_Page1')
  pageShown.F_Text.setContent('Changing the text of this text item when this page is shown.');

 var thePage = form.getPage('F_Page1');

if(thePage !== null) 
  form.selectPage('thePage')

var serviceConfigs = form.getServiceConfigurationIds();

var service = form.getServiceConfiguration('SC_ServiceConfig');
     service.callService();

var actions = form.getStageActions():
for(var i=0; i<actions.length; i++)
     {
     if(get(actions,i).getId() === 'S_Submit')
     {
     get(actions,i).activate();
     break;
     }
     }

form.removeClasses(emphasized);

if(BO.F_Check.getValue)
  form.removePageFromNavigation('P_Page2');

 if(!BO.F_Check.getValue)
  form.restorePageNavigation('P_Page2');

 var thePage = form.getPage('F_Page1');

if(thePage !== null) 
  form.selectPage(thePage);

form.sendData(BO.F_ServerURL.getValue() + "/apps/secure/org/app/b5806ef1-b784-4c85-8844-653cd4064201/launch/index.html?form=F_FormA"); 

page.F_NextButton.setVisible(false);

page.addClasses(emphasized error);

var theBO = page.getBO();
theBO.F_SingleLine.setValue('new Value');

var list = page.getChildren();
     for(var i=0; i<list.getLength(); i++)
     {
     if(list.get(i).getType() === 'button')
     list.get(i).setVisible(false);
     }

page.removeClasses(emphasized);

item.addClasses(emphasized error);

var hndl = item.connectEvent('onItemChange', function()
     {
     if(item.getBOAttr().getValue() === 'Yes')
form.getBO().F_SectionA.setVisible(true);
     }
     });

If you connect an item event, you must also disconnect it in the same event. Otherwise, multiple versions of the connected code are attached every time the event is triggered.

item.disconnectEvent(hndl);

item.getBOAttr().setValue(45);

var list = item.getChildren();
     for(var i=0; i<list.getLength(); i++)
     {
     if(list.get(i).getType() === 'number')
     list.get(i).getBOAttr().setValue(0);
     }

var form = item.getPage().getForm();

item.removeClasses(emphasized);

item.getColumnHeaders()

Returns a JSON object that contains the id, title and width of each header displayed for the table.

[{id:"F_Currency1",title:"La Currency",width:20},
{id:"F_Date1",title:"La Date"}]

var headers =  page.F_Table1.getColumnHeaders();
for(var h in headers) {
  alert("ID=" + get(headers,h).id +
  ", title=" + get(headers,h).title + 
  ", width=" + get(headers,h).width);
}

item.setColumnHeaders(headers)

Function accepts a JSON object that can be used to set the id, title and width of each column in the table.

This is helpful, for example, to change the language of the column header displayed.

var headers = new Array();
set(headers, 0, {id: "F_Currency1",
	title: "La Currency", width: 20});
set(headers, 1, {id: "F_Date1", title: "La Date"});
page.F_Table1.setColumnHeaders(headers);