Develop a Custom Control Handler

PHP or any other programming technology can be used to implement the required custom control handler for Custom Controls.

Custom controls can also be used with JavaScript that has been included for use by Intelligent Advisor interview screens. The JavaScript will be automatically loaded during the Intelligent Advisor interview and will appear as separate <script> tags at the top of each page. The web service which renders the custom control can then utilize this content. For more information, see Add JavaScript to screens.

Note that for Intelligent Advisor Cloud Service, if the secure HTTPS protocol is used for the custom control URL, the server must support Transport Layer Security (TLS) 1.1 or later. TLS 1.0 is not supported. TLS 1.2 is recommended. Also be sure to understand the security considerations for custom control handlers.

This topic gives more information on the HTTP POST used to invoke the page for custom styling when a control on an Intelligent Advisor interview screen has been defined as a custom control.

When the Intelligent Advisor interview reaches a screen containing a custom control, Intelligent Advisor:

• calls the content at the specified location via an HTTP POST, and
• inserts that content inline in the HTML page of the Intelligent Advisor interview, in place of the control itself.

The HTTP POST will contain the following information:

• the interview language
• whether the control is an input or a label
• the caption of the control being displayed after any substitutions have been applied
• the HTML id for the control on the Intelligent Advisor interview screen HTML page
• whether the control is read-only
• (for input controls) the name of the attribute as defined in the policy model
• (for input controls) the current value of the attribute
• the current values of all attributes in the Intelligent Advisor interview
• any custom properties that are attached to the control

For further information on the HTTP POST parameters used to call the custom content, see Custom Control Parameter Reference.

Note that the HTML content returned will be incorporated into a larger HTML page, so is not a full HTML page in its own right.

Tip: There is an alternate version of Emergency Response using custom controls. This project is installed with custom control files implemented using PHP. To view instructions for configuring these files to work in an Oracle B2C Service interview, see Example: Custom Control Project. These instructions are also available on the first interview screen of the project itself.

The following is a sample HTTP POST: