PDF hostContainer callback

Question

Following this SO solution here to notify clients of a click event in a PDF document, how is it possible to notify the client when the PDF gets submitted by the client using

Answer 1

The FDF response you used was unknown to me, so I've learned something new from your question. I've studied the AcroJS Reference and the FDF specification in the PDF Reference, and now I have a better understanding of what your code does. Thank you for that.

I assume that you already know how to trigger a JavaScript message in an HTML file using a JavaScript call from a PDF. See the createMessageHandler() in the JavaScript Communication between HTML and PDF article.

I interpret your question as: "How to I invoke this method after a successful submission of the data?"

If there's a solution to this question, it will involve JavaScript. I see that one can add JavaScript in an FDF file, but I'm not sure if that JavaScript can 'talk to' HTML. I'm not sure if you can call a JavaScript function in your initial PDF from the FDF response. If it's possible, you should add a JavaScript entry to your PDF similar to the /Status entry.

The value of this entry is a dictionary, something like:

<<
/Before (app.alert\("before!"\))
/After (app.alert\("after"\))
/Doc [/MyDocScript1, (myFunc1\(\)),
      /MyDocScript2, (myFunc2\(\))
>>

In your case, I would remove the /Before and /Doc keys. I don't think you need them, I'd reduce the dictionary to:

<<
/After (talkToHtml\(\))
>>

Where talkToHtml() is a method already present in the PDF:

function talkToHtml() {
    var names = new Array();
    names[0] = "Success!";
    try{
        this.hostContainer.postMessage(names);
    }
    catch(e){
        app.alert(e.message);
    }
}

I don't know if this will work. I've never tried it myself. I'm basing my answer on the specs.

I don't know if you really need to use FDF. Have you tried adding JavaScript to your submitForm() method? Something like:

this.myPDF.submitForm({
    cURL: "http://localhost/Handler.ashx?EmpNo=12345",
    cSubmitAs: "FDF",
    oJavaScript: {
        Before: 'app.alert("before!")',
        After: 'app.alert("after")',
        Doc: ["MyDocScript1", "myFunc1()",
              "MyDocScript2", "myFunc2()" ]
    }
});

This will only work if you submit as FDF. I don't think there's a solution if you submit an HTML query string.

In case you're wondering what MyDocScript1 and MyDocScript2 are:

Doc defines an array defining additional JavaScript scripts to be added to those defined in the JavaScript entry of the document’s name dictionary. The array contains an even number of elements, organized in pairs. The first element of each pair is a name and the second is a text string or text stream defining the script corresponding to that name. Each of the defined scripts is added to those already defined in the name dictionary and then executed before the script defined in the Before entry is executed. (ISO-32000-1 Table 245)

I'm not sure if all of this will work in practice. Please let me know either way.