XpressDox Help Center

Use Google To Find Help Fast, e.g. xpressdox choosefromlist


Press Getting Started in the XpressDox toolbar for basic template development
Watch the tutorial videos
View command help from list of commands
Press F1 for help on a command in the Command Editor
Email support@xpressdox.com for assistance

Interview Integration – JavaScript and iFrame


Interview Integration – JavaScript and iFrame

Over and above the API (Server to Server Communication), XpressDox also offers Interivew Integration. (3rd Party Server to Browser to XpressDox Server Communication).

Integration Information

The XpressDox Server provides code snippets to make integration of interviews really easy for you. To access these snippets:

  • Sign in to your XpressDox Cloud or Server account
  • Click to view any interview
  • Click the Include Interview in your Page link on the left hand side of the page
  • Set your preferences and click the Show Me How button
  • JavaScript and iFrame code snippets (including explanatory comments) you need to integrate the template interview with your page will be generated automatically for you

We recommend you use the JavaScript integration so that you have more control over the interview in your page. We supply the following JavaScript methods once the interview is loaded:

  • xdInterview.mask(message);This adds the loading overlay to the interview with the custom message text
  • xdInterview.unmask();This removes the loading overlay
  • xdInterview.getInterviewData();This method returns the interview data in xml format
  • xdInterview.getInterviewDataBase64();This method returns the interview data in base64 format
  • xdInterview.navigatetoURL(navigateURL);This method redirects the page, without the “leaving page message”, to the provided URL

We supply the following JavaScript event/hooks once the interview is loaded:

  • function xdox_OnCustomClick() { }XpressDox will call this method when the custom button is clicked. Used with this command: SetWebCustomButton
  • function xdox_OnTabShown(totalNumberOfTabs, currentTabIndex) { }XpressDox will call this method when a tab is clicked. Please note currentTabIndex is 1 based.
  • function xdox_OnAssembleClick() { }XpressDox will call this method when the Assemble button is clicked. If your implementation returns false, the XpressDox code will no longer assemble the document and redirect to another page.

An example of these methods being implemented is as follows: function xdox_OnCustomClick() {console.log("The user clicked the custom web button"); }