Help With apex.server.process

Question

Hello,
I am trying to use the new apex.server.process function to and I seem to be having some issues with it. The call itself seems to be working fine as in firebug it returns what I expect. Its just that I am returning the json string into an object and that is what is causing the problem.
Here is my on-demand process:
DECLARE
  lv_json             VARCHAR2(4000 CHAR);
  lv_score            NUMBER(12);
BEGIN
    --Will get the score from the database...
    lv_score := round(fm_apex.events_api.get_percent_complete(:P40_EVENT_ID,'TOTAL'));
    IF lv_score = 100 THEN
      lv_json := '{"success":true}';
    ELSE
      lv_json := '{"success":false}';
    END IF;
    htp.p(lv_json);
END;
And this is my javascript function:
function checkScore(pThis)
    var getScore = apex.server.process(
        'IS_SCORE_COMPLETE_JSON',
            pageItems: "#P40_EVENT_ID"
    if ( eval(getScore.success) )  {
        alert('This is successful');
        //doSubmit(pThis.id);       
    } else {
        openModal('notScoredFully');
What is happening is when the response is {"success":false} and in firebug it is still evaluating it to true? Can anybody see what I am doing wrong?
Cheers,
Paul.

Answer 1

1/ apex.server.process is asynchronous. You are handling it as if it is not. You fire the call and it is gone, unlike htmldb_get which works synchronously (=makes the browser wait for the return). You need to use the success function.
JavaScript APIs apex.server.process
The return value of the server.process call is a jqXHR object, documentation on which you can find here: jQuery.ajax() | jQuery API Documentation
I would just use success though, as demonstrated in the example of the documentation.
apex.server.process ( "MY_PROCESS", {
  x01: "test",
  pageItems: "#P1_DEPTNO,#P1_EMPNO"
success: function( pData ) { ... do something here ... }
Thus something along these lines:
apex.server.process(   'IS_SCORE_COMPLETE_JSON'
                     , { pageItems: "#P40_EVENT_ID" }
                     , { success: function( pData ) {
                                    if(pData.success){
                                      alert('This is successful');
                                    } else {
                                      alert('This is NOT successful');
2/ apex.server.process by default handles the return value as a json datatype. You would not need to "eval" it.