Calling events from scripts in UIX

Question

Hi,
I am able to call the ordinary events in the UIX from the script. But I am not able to call the
<ctrl:event .. >
from the script.
Could anyone please tell me how to call them.
Thank you
Velpandian

Answer 1

Velpandian -
Assuming your page contains a form, you can trigger an event on the server from a JavaScript handler by calling submitForm(). The following sample shows how to send an event both by using the ctrl:event attribute as well as from a JavaScript handler:
<?xml version="1.0" encoding="UTF-8"?>
<page xmlns="http://xmlns.oracle.com/uix/controller"
      xmlns:ui="http://xmlns.oracle.com/uix/ui"
      xmlns:data="http://xmlns.oracle.com/uix/ui"
      xmlns:ctrl="http://xmlns.oracle.com/uix/controller">
<content>
  <form name="foo" xmlns="http://xmlns.oracle.com/uix/ui">
  <contents>
    <!-- Import the submitForm() function -->
    <importScript names="submitForm()"/>
    <stackLayout>
    <contents>
      <!-- This link sends an event using a ctrl:event attribute -->
      <link text="Send Event" ctrl:event="test"/>
      <!-- This link sends an event using a JavaScript event handler.
           We use submitForm() and specify the event name using
           a parameter.  Note that this means that we need to be
           sure that we also have an "event" hidden field - which
           we add via a formParameter element below -->
      <link text="Send Event from JavaScript"
            onClick="if (confirm('Send event')) submitForm(0, 0, {'event':'test'}); else return false;"
            destination="#"/>
      <!-- Need a form value to contain the event name -->
      <formParameter name="event"/>
    </contents>
    </stackLayout>
  </contents>
  </form>
</content>
<handlers>
  <!-- Use a null event handler to set up a session variable -->
  <event name="test">
    <go name="nextPage"/>
  </event>
</handlers>
</page>I couldn't find the documentation for submitForm() online anywhere... Here is a copy of the documentation from our source code:
* Attempts to submits the form, potentially firing validation and notifying
* any Cabo onSubmit handlers registered on the form, returning
* <code>true</code> if the submission actually occurred.
* <p>
* If the <code>doValidate</code> parameter is false, no validation will
* be performed, and the form is guaranteed to be submitted.  Otherwise,
* the form will be submitted if both the validation succeeds and any
* registered Cabo onSubmit handlers do not return <code>false</code>.
* <p>
* @param form The form to submit.  This can either be the name of the form
*             in the current <code>document</code>, the index of the form
*             in the current <code>document</code> or the form itself.
* @param doValidate boolean value specifying whether validation should
*   occur before the form is submitted.  (As per a common Javascript
*   idiom, it is acceptable to pass true/false as well as 0/1).  If
*   this parameter is ommitted, it defaults to true.
* @param parameters a single Javascript object that specifies
*   all the additional key-value pairs to submit.  There must be
*   pre-existing &lt;input type="hidden"&gt; elements as targets
*   for each of these parameters.
function submitForm(
  form,
  doValidate,
  parameters
  )Andy