1  Instances of the form date input element are created using the new constructor with provided parameters that include the identifying key, an optional menu label (title), and an optional default date value for the field. The result of the constructor is a new instance that is stored in the variable: dateFieldInput

 2  The date input is assigned a unique identifying key (string) that is used to extract the current displayed date object when the form is validated or processed.

 3  The optional text to use as the label for the menu.

 X  An optional date object to be used as the value for the date input field.

 02-04  Create a new date object to use as the default target date and use the setDate(…), getDate(…), and setHours(…) JavaScript methods to set its day and time values to tomorrow at 8:30 AM

 06-10  The creation of a new instance of the Form.Field.Date (date input) class. Note the inclusion of the identifying key string "dateInput" that is used elsewhere in the script to retrieve the current input value of the form element.

 12  A new empty instance of the Form class is created and stored in the variable: inputForm

 14  The created date entry field is added to the form using the addField(…) method of the Form class.

 16  The form is displayed to the user by passing string values for the dialog prompt and button title into the show(…) method called on the created form instance. Note that the result of the form display is a JavaScript Promise object which will contain the form results when the form dialog has either been approved or declined by the user.

 17-21  Although no representation for the JavaScript Promise is displayed, the then(…) method is called on the implied promise resulting from the previous show(…) method. Placing .then(…) on a new line is simply a connivence for displaying the code. Functionally, it is the same as appending to the previous method, like this: inputForm.show(…).then(…)

 18  The callback function within the then(…) method is passed the form object as its parameter.

 19  Using the date input’s identifying key, the current input value of the field is retrieved from the record returned as the value of the passed form’s values property. Any processing of the retrieved data by the script would be placed in the scrpt statements following this one. Note: the resulting value is a JavaScript date object.

 15  Store a reference to the current canvas is the global variable: cnvs

 17  Create a new empty form object, and store in variable: inputForm

 19-23  Create a new text input field using the name of the current canvas for the default field value.

 24-28  Create a new text input field for the task notes.

 29-33  Create a new date input field using the current date as the default date value.

 35-37  Add the created fields to the empty form object using the addField(…) method of the Form class.

 39  Use the show(…) method to display the form dialog and store the resulting JavaScript promise object in the variable: formPromise

 41-46  The form validation function receives the form object as its passed parameter.

 42  A ternary operator returns a value of true if text has been entered in the name text field.

 43  A ternary operator returns a value of true if a date has been entered in the date input field.

 44  A ternary operator returns a value of true if text has been entered in the name field and a date has been chosen or entered in the date input field.

 45  Return the validation status. If true, the approval button in the form dialog will be enabled.

 48-69  The stored JavaScript promise object is processed using the then(…) function that includes the form object as its passed-in parameter.

 49  The URL-encoded name of the exported canvas image is based upon the name of the current canvas appended with the “.png” file extension.

 50-51  A virtual export of the current canvas is created as image data, which is then encoded in base64 format for inclusion in the url for generating a new OmniFocus task.

 53  The contents of the task name text input field is extracted from the passed form object and then encoded for inclusion in the OmniFocus url.

 54  The contents of the task notes text input field is extracted from the passed form object and then encoded for inclusion in the OmniFocus url.

 55  The input date object is extracted from the passed-in form object and stored in a variable.

 57-58  The numeric value that represets the hours of the date time is extracted and converted into a string. If the value is a single digit, it is preceded with a leading zero.

 59-60  The numeric value that represets the minutes of the date time is extracted and converted into a string. If the value is a single digit, it is preceded with a leading zero.

 61  The hours and minutes strings are combined into a single string delineated by a colon character.

 63  The attributes and corresponding values for the OmniFocus URL are combined into a single string.

 64  A URL instance is created by appending the attributes/values string to the protocol targeting the creation of a new task in OmniFocus application. The fromString(…) method of the URL class is then used to convert the string into a url instance.

 65-68  The URL instance is called and a resulting link to the new task is passed into the callback function.

 67  The link to the new task is written into the metadata table for the current OmniGraffle canvas.

 76-80  The validation function for the action determines if the menu item is active in the OmniGraffle Automation menu.

 82  The completed action object is returned to the enclosing function which is called on the new line ().