• Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
    Dedicated community for Japanese speakers
  • 한국 커뮤니티
    Dedicated community for Korean speakers
Exit
0

Javascipt to abort code and return to dialog box

New Here ,
May 06, 2020 May 06, 2020

Copy link to clipboard

Copied

Hello,

 

I am working on automating and preparing a form for digital signature. For prior military, I am referring to an nonjudicial punishment form. The form will be passed back and forth between a commander and a service member and they will add their intitials next options and then digitally sign. I have added a javascript code to execute onblur when the digital signature field is pressed. A dialog box appears and has the commander type his/her initials into one of two options. (I realize that I could use a radio button and it would slove my problems, but its the military and we require physically typing initials into the box). After the commander presses OK, a second window for the digital signature appears. A second javascript is then executed upon signature (from the signed tab) that places the date and time into particular readonly fields in certain blocks on the form (again I realize the digital signature has this information but this is the military and if the block isn't completed the form isn't legally sufficient).

 

What I am trying to do is create an alternative to a radio button with the text fields in the dialog box. I have written code in the onblur to ensure that only one of the fields has text in it (typing text in 1 field clears the other). Where I am running into trouble is ensuring that at least one of the blocks contains initials. I can't have the commander digitally sign if he/she doesn't add intitials to one of the blocks. I have an if statement after OK is pressed that will check to make sure that both variables are not empty. What I want to do is stop the script prevent it from running the digital signature window and either "cancel out" forcing the commander to click the digital signature field again (or better) go back to the dialog box for the commander to enter his/her initials. 

 

I have seen a prior post where this problem was circumented by adding a button and hiding the digital signature until the "validation" is performed, but the form doesn't provide the space for a button nor can I add buttons to the form.

 

Most appreciated if someone knows of a viable option. 

 

PS I am an JAG and not a programmer by trade so forgive me if my question is impossible based upon how the code is executing or if it is something a child should know.

 

Thanks,

 

Mike

 

My code is:

 

var Offer =
{

result:"cancel",
DoDialog: function(){return app.execDialog(this);},
strOpt1:"",
strOpt2:"",
initialize: function(dialog)
{
var dlgInit =
{
"Opt1": this.strOpt1,
"Opt2": this.strOpt2,
};
dialog.load(dlgInit);
},
commit: function(dialog)
{
var oRslt = dialog.store();
this.strOpt1 = oRslt["Opt1"];
this.strOpt2 = oRslt["Opt2"];
},

"Opt1": function(dialog)
{
dialog.load({
"Opt2": this.strOpt2,
});
},
"Opt2": function(dialog)
{
dialog.load({
"Opt1": this.strOpt1
});
},

description:
{
name: "Offer of NJP",
elements:
[
{
type: "view",
elements:
[
{
type: "view",
char_height: 10,
elements:
[
{
type: "static_text",
item_id: "sta1",
height: 48,
name: "Type your initials next to the appropriate action. Then press OK and you will be \nprompted to digitally sign the AF Form 3070. Note, Fields in sections 1c and 1e will \nlock upon digitally signing in Block 2.",
char_width: 15,
alignment: "align_fill",
font: "dialog",
},

{
type: "view",
height: 28,
char_width: 8,
char_height: 8,
align_children: "align_row",
elements:
[
{
type: "edit_text",
item_id: "Opt1",
width: 50,
char_width: 8,
},
{
type: "static_text",
item_id: "txt1",
name: "I am considering punishing you under Art 15, UCMJ.",
},
]
},
{
type: "view",
height: 28,
char_width: 8,
char_height: 8,
align_children: "align_row",
elements:
[
{
type: "edit_text",
item_id: "Opt2",
width: 50,
char_width: 8,
},
{
type: "static_text",
item_id: "txt2",
name: "I am considering having the following person punish you under Art 15, UCMJ.",
},
]
},
]
},
{
type: "ok_cancel",
},
{
type: "static_text",
item_id: "stat",
name: "Designed and Coded by Lt Col Michael Hopkins",
char_width: 15,
alignment: "align_fill",
font: "dialog",
},
]
},
]
}
};

// Example Code
Offer.strOpt1 = "";
Offer.strOpt2 = "";
if("ok" == Offer.DoDialog())
{

if(Offer.strOpt1 == "" && Offer.strOpt2 == ''" {

app.alert("You must type initials in one of the fields.");

//Need code to cancel out of script, stop the execution of the digital signature, and return to dialog box for user input.

}

else

{

this.getField("01_1a1").value=Offer.strOpt1;
this.getField("01_1a2").value=Offer.strOpt2;

if (Offer.strOpt1 != "") this.getField("01_1a2_Commander").value = "";

var fieldsToLock = ["01_1a2_Commander"];
for (var i in fieldsToLock) this.getField(fieldsToLock[i]).readonly = true;

}

};

 

TOPICS
Acrobat SDK and JavaScript

Views

2.1K

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines

correct answers 1 Correct answer

Community Expert , May 10, 2020 May 10, 2020

+++ EDITED REPLY, FIXED SOME TYPOS

 

Hi,

 

It looks like in the governement the common name of the user, as it appears in the digital signature after it is applied, is taken from the Distinguished Name of the certificate.

 

This makes things easier for us to figure out because when you get the value from cert.subjectDN.cn that is contained in sigInfo.certificates OR Info.name that is contained in signatureInfo you will get the same result : SMITH.JOHN.UNK .

 

 

If this wasn't the case, then when you extr

...

Votes

Translate

Translate
Community Expert ,
May 06, 2020 May 06, 2020

Copy link to clipboard

Copied

Hey Mike,

 

I think you're complicating yourself too much.

 

You can get both the date and the distinguished name out of a digital certificate at signing time with this code:

 

 

var f = event.target;
var sigInfo = f.signatureInfo();
var cert = sigInfo.certificates[0];

	this.getField("Initials").value = cert.subjectDN.cn;
	this.getField("Date").value = util.printd ("yyyymmdd", Info.date);

 

 

If you notice the fifth and last line of code above, I used the  util.printd  method to format the output date to military format string.

 

Otherwise you'll get the long format which includes full year, month , day, and the Time with hours, minutes, seconds, and the UTC time zone, which is taken from the system clock at signature time.

 

So this aleviates that issue.

 

To get the last name and first name initials from the certificate's Distinguished Name, you're gonna need to use a combination of transposing strings and also using a .split  and .join methods as shown in the link below.

 

See here:   https://stackoverflow.com/questions/43192973/transpose-2-strings-in-an-array

 

I am posting that link because I haven't how to figure that one out yet. 

 

NOTE: To add the script that I posted, right-click on the signature field, select Properties from the context menu , and click on the "Sign" tab. Then tick the radio button below that says "Then tick This script executes when field is signed" and click on the "Edit" button to paste the script.

 

 

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
May 06, 2020 May 06, 2020

Copy link to clipboard

Copied

I forgot to add, that you need to set the properties of the date and the initials fields to readonly and lock those fields. This can also be done with a script.

 

These fields  will be autopopulated by the sign script and there is no need to have user intervention to fill them in.

 

To reset  these fields when the signature field is cleared, add a custom calculation script to each like so:

 

 

var s = this.getField("SignField").value;
if (s =="")  event.value="";

 

 

 

Just remember, this script can also be executed directly from the Signature field.

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
May 08, 2020 May 08, 2020

Copy link to clipboard

Copied

1s_rb1s,

 

Thanks for the reply. It was brilliant. I found Thom Parker's post (https://acrobatusers.com/tutorials/print/splitting-and-rebuilding-strings/) and using what you provided I was able to build the initials from the name. I was able to load them in an array and extract just the initials.Then I hit a snag that I don't think I can get around. I can't code it to account for hypenated last names and people with no middle initials. There is no consistency--some hyphenated last names use spaces, others are merged together, others have hyphens. For people with no middle name some list the middle as "UNK" (for unknown) such as SMITH.JOHN.UNK. There are just too many variables to account for by extracting from the signature name.

 

I greatly appreciate your thoughts and direction on this. 

 

Mike 

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
May 10, 2020 May 10, 2020

Copy link to clipboard

Copied

+++ EDITED REPLY, FIXED SOME TYPOS

 

Hi,

 

It looks like in the governement the common name of the user, as it appears in the digital signature after it is applied, is taken from the Distinguished Name of the certificate.

 

This makes things easier for us to figure out because when you get the value from cert.subjectDN.cn that is contained in sigInfo.certificates OR Info.name that is contained in signatureInfo you will get the same result : SMITH.JOHN.UNK .

 

 

If this wasn't the case, then when you extract this information to another text field it should read: John Unk Smith

 

The long answer to your issue is that you don't need to use an array to get this to work. Using the array method doesn't necessarily apply in your case because what you're dealing with is more related to international standards that are enforced with the use of digital signatures.

 

Some cultures use more than one first name, in other cultures the last name is also the surname, and in other cultures they have no last name at all.

 

The digital certificate standards that define the 'common name' schemas are not for the user(s) to choose a preferred method of signing, but an international standard as defined in RFC 1485 and the X.509 specifications for public key infrastructure certificates, cryptographic keypair association, and the Internet Engineering Task Force ( IETF ) Request For Comments (RFC) specifications.

 

These standards also encourage users to keep it as close as possible within the defined schemas of the international standards to aviod these problems when customizing a common name that will be used in a self-signed certificate.

 

For example, in order to get a specific string of text that is contained in a digital signing certificate, those special characters is what we use as guides to perform ".split" or ".join" methods from the Distinguished Name public component or from the user's identity key attributes.

 

Therefore, the employment of special characters, such as spaces (" "), dashes ("-"), periods(".") or less than / greater than ("<", ">") symbols, just make make our life easier.

 

See slide below:

 

 

digitalsign-split.png

 

See key attributes here: https://datatracker.ietf.org/doc/rfc1485/?include_text=1


Basics of Digital Certificates:
https://www.sites.google.com/site/ddmwsst/digital-certificates#TOC-CA-Hierarchy

 

Examples of key attributes:
http://certificate.fyicenter.com/717_Distinguished_Names_on_Certificates.html

 

 

Short Anwser:

 

You'll be fine just taking the first character strings from the First and Last name in order to compose the initials.

 

However, I did spotted some errors in my initial reply. Use the following instead:

 

 

 

 

 

 

 

 

var f = event.target;
var sigInfo = f.signatureInfo();
var cert = sigInfo.certificates[0];
var firstName = cert.subjectDN.cn.split(".")[1];
var lastName = cert.subjectDN.cn.split(".")[0];
   

//THIS LINE OF CODE WILL TRANSPOSE LAST AND FIRST NAME STRINGS

    this.getField("FULL NAME").value = cert.subjectDN.cn.split(".")[1]+" "+ cert.subjectDN.cn.split(".")[0];


//THIS LINE OF CODE WILL PULL THE INITIALS AS DECLARED IN THE firstName AND lastName VARIABLES ABOVE

    this.getField("INITIALS").value = (firstName.charAt(0)) + (lastName.charAt(0));


//THIS LINE WILL GET THE SAME DATE AS THE SIGNING TIME. IT WILL AVOID PROBLEMS WITH INCORRECT SYNCHRONIZATION BETWEEN THE SYSTEM CLOCK AND BROWSER TIME ZONES WHEN USING Info.date, USE new Date() INSTEAD

    this.getField("Date").value = util.printd ("yyyymmdd", new Date());


// AND THIS LINE WILL GET THE CORRECT TIME AS DISPLAYED IN THE SIGNED CERTIFICATE. AS MENTIONED THIS WILL AVOID TIME ZONE SYNCHRONIZATION PROBLEMS IF YOU USE Info.date. USE new Date() INSTEAD 

    this.getField("TIME").value = util.printd("hh:MM:ss", new Date());


//AND SOMETHING LIKE THIS SHOULD GET THE EMAIL BUT I MAY BE WRONG

      this.getField("EMAIL").value = Info.name.split(" <").join("<");

 

 

 

 

 

NOTE: These scripts should be executed as an action during signing time and only from the signature field. If you run these scripts independently on spearate text fields, keep in mind that  you'll need to include a signature status validation to meet a condition. The signature security properties of a blank signature field are different before a signature is applied on it,  it will change its status and also the properties of the signature field once the digital signature is applied and the document is saved.

 

Last, to resolve your other issue, about how the user will interact with the initial boxes, if you prefer to autopopulate the Initials text fields programatically, then you may want to consider an listening event with an on-click getAction method.

 

This would allow the user to click on the text fields to enter the initials but it will trigger the signature field. Signing the signature field will  populate the initials text field.

 

The trick is how to make this work when the user have to initial more that one text field before signing; but this is just another idea that then you should consider implementing with the array methods as explained in Thom Parker's excellent tutorials.

 

 

 

 

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
May 11, 2020 May 11, 2020

Copy link to clipboard

Copied

1s_rb1s,

 

Thanks for that response. I had been debating where to add the code. Whether to place all the code in the upmouse so that the initials and date and time would be entered prior to digital signing (potentially leading to the time field being a minute earlier than the digital signature block) and the ability to save the form only once on digitally signing the document. The other option being to place it under the "sign tab" of the digital signature (I then get an accurate time but it requires 2 Save  As--1 for the digital signature and 1 for saving the date and time block since app.ExecMenu("Save"); won't run outside a trusted script). I opted to execute the code after the digital signing so the time and date field will match the digital signature. Unfortunately, due to security and the way the form will be deployed, I can't add any trusted javascript to the user computer and I don't have the ability to add it on a server-side. 

 

I like your thoughts on clicking the box to trigger the signature. I may hold that for a revision to the format of the form. My hangup right now is what you pointed out, accounting for multiple initials. In one instant, there are 5 sets of initials needed, if someone marks a participle block on the second set, they don't need to mark the remaining 3 sets. For that reason and time limitations I will press with the typing of initials for now. 

 

Thanks again for all help. It has been tremendous.

 

Mike

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Jun 27, 2020 Jun 27, 2020

Copy link to clipboard

Copied

LATEST

+++QUICK UPDATE

 

Hey Mike, 

 

So I was able to figure out how to get the middle initial out of the digital certiifcate.

 

This only applies for your type of work organization, where the use of common access cards cards (not smart cards)  include a 10 digit combination of number characters together with  the name of the individual in that digital certificate.

 

For example, in a certificate name like this:

 

  • smith.john.u.1234567890@<john.smith.u.56.civ@testing.net> <<<--with middle initial

 

  • or

 

  • smith.john.u.1234567890@<john.smith.56.civ@testing.net>    <<<---- without middle initial

 

 

you can actually use this script:

 

 

var f = event.target;
    var sigInfo = f.signatureInfo();
    var date = util.printd("yyyymmdd", new Date());
    var sigInfo = f.signatureInfo();
    var cert = sigInfo.certificates[0];

    var firstName = cert.subjectDN.cn.split(".")[1];
    var lastName = cert.subjectDN.cn.split(".")[0];
    var middleName = cert.subjectDN.cn.split(".")[2];
    var dodNum = cert.subjectDN.cn.split("'.")[3];
    var c = middleName.charAt(0);
    var d = c.toUpperCase()+".";

var first = firstName.charAt(0).toUpperCase() + firstName.substring(1).toLowerCase();
var last = lastName.charAt(0).toUpperCase() + lastName.substring(1).toLowerCase();



if (f.valueAsString !=="") {
  

 if ((c == "1")|| (c == "2")||(c == "3")||(c == "4")||(c == "5")||(c == "6")||(c == "7")||(c == "8")||(c == "9")||(c == "0")){ 

 this.getField("Approver Name").value = first+" "+ last;
}

else if ((c !== "1")||(c !== "2")||(c !== "3")||(c !== "4")||(c !== "5")||(c !== "6")||(c !== "7")||(c !== "8")||(c !== "9")||(c !== "0")) {

this.getField("Approver Name").value =  first+" "+ d+" "+last;
  }
}

else f.value ="";

 

 

The script above could be simplified to test for numbers instead of text strings using something like !isNan or isNaN but since you're only dealing  numbers from 0 throuh 9 here, using isNaN  wasn't giving me the expected results, so I decided to just treat the whole thing as a conditional statement to verify for those charachters as text strings.

 

I am working on similar forms like yours and now my users don't need to type in their names anymore in addition to manually applying digital signatures on each signature field next to the name text field. Just signing the digital signature  field will auto-populate the name field with first name, middle initial(if included in the certificate- if it is not included it will just grab the first and last name from the certificate), and the last name.

 

I also figured out to work around  a little bit on how to automate process of initialing  the Initial Fields that user should select.

 

For example, once the user types in his/her initials on the first initial field,you can add this line of code as a javascript mouse up action to all other subsequent initial fields : 

 

 

event.target.value =this.getField("INITIALS").value;

 

 

All the user have to do is to continue to point and click once inside and once outside of that box and continue to work with the next fields.

 

Last, I also observed that a listening event may not be necessary as I suggested earlier. 

 

I was able to work around a similar problem that you're having by  using a combination of setFous()  , app  alerts, and conditional statements. 

 

For example, you can add a script that checks if the signature field is signed before it allows the user to  fill in and/or work with other sections of that document.

 

What is working for me is a small script that executes after a signature field is signed by the approving authority and setFocus() on the next field that I want to redirect my user to continue to work with.

 

If the user tries to click or type-in in any other section an alert will notify the user that the previous signature field was missed and automatically bring the user back to that field  before continuing any further.

 

After the signing action is applied in that signature I use setFocus() again to execute after the signature is applied which  will bring back the user to the next  field that you want them to continue to work on  .... Just additional food for thought.

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines