OmniGraffle: eMail

Integrated eMail Support

Using Omni Automation you can construct and manipulate outline documents, apply styles and import data from a variety of sources. And with integrated scripting support for creating and sending email, it becomes easy to automate the sending of outline content and documents. The following documentation demonstrate how to access and use this ability, beginning with a set of parameters for generating an email.

Constructor

Omni Automation in OmniGraffle supports an Email class, design for creating and sending electronic mail messages. To instantiate an instance of this class, it is preceded by the new constructor.

new Email() --> Email • Creates a new eMail object.

Instance Properties

As with most scriptable objects, an instance of the Email class has properties that define its design and usage. Here is the list of properties for this class:

blindCarbonCopy (String or nil) • Blind carbon copy allows the sender of a message to conceal the person entered in the Bcc: field from the other recipients. This concept originally applied to paper correspondence and now also applies to email. (Wikipedia)
body (String or nil) • The main text content of the mail message.
carbonCopy (String or nil) • In the past, a carbon copy was the under-copy of a document created when carbon paper was placed between the original and the under-copy during the production of a document. Nowadays "carbon copy" is often used metaphorically to refer simply to an exact copy or the inclusion of a recipient of an electronic message.
fileWrappers (Array of FileWrapper) • A Filewrapper is a representation of a node (a file, directory, or symbolic link) in the file system. File wrappers represent a file system node as an object that can be displayed as an image (and possibly edited in place), saved to the file system, or transmitted to another application. In Omni Automation they are used during export to identify the format in which the outline document is to saved to file and added to the outgoing message as an attachment.
receiver (String or nil) • The person or identity to receive the mail message, represented by a standard email address string.
subject (String or nil) • The title of the mail message.

Instance Functions

The Email class contains a single command generate() for processing instances of the class.

generate() • Presents the generated email to the user for them to send (or discard). NOTE: on iOS, any included attachment FileWrappers that are directories will be converted to Zip files.

var email = new Email() email.subject = "Omni Automation" email.body = "Greetings!\n\nHere are my suggestions regarding Omni Automation:" email.receiver = "support@omnigroup.com" email.generate()

omnigraffle://localhost/omnijs-run?script=try%7Bvar%20email%20%3D%20new%20Email%28%29%0Aemail%2Esubject%20%3D%20%22Omni%20Automation%22%0Aemail%2Ebody%20%3D%20%22Greetings%21%5Cn%5CnHere%20are%20my%20suggestions%20regarding%20Omni%20Automation%3A%22%0Aemail%2Ereceiver%20%3D%20%22support%40omnigroup%2Ecom%22%0Aemail%2Egenerate%28%29%7Dcatch%28err%29%7Bconsole%2Elog%28err%29%7D

Basic eMail Script

var email = new Email()

email.subject = "Omni Automation"

email.body = "Greetings!\n\nHere are my suggestions regarding Omni Automation:"

email.receiver = "support@omnigroup.com"

email.generate()

Including Attachments

The following are examples of creating and sending mail messages whose contents are derived from the current document.

NOTE: The image attachment in the following example is created using the current document export settings.

var docName = document.name var fileTypeID = 'public.png' var wrapperPromise = document.makeFileWrapper(docName, fileTypeID) wrapperPromise.then(function(wrapper){ var email = new Email() email.subject = "PNG of “" + docName + "”" email.body = "Here is the exported canvas for you!\n\n" email.fileWrappers = [wrapper] email.generate() }) wrapperPromise.catch(function(err){ console.error(err.message) })

omnigraffle://localhost/omnijs-run?script=try%7Bvar%20docName%20%3D%20document%2Ename%0Avar%20fileTypeID%20%3D%20%27public%2Epng%27%0Avar%20wrapperPromise%20%3D%20document%2EmakeFileWrapper%28docName%2C%20fileTypeID%29%0A%0AwrapperPromise%2Ethen%28function%28wrapper%29%7B%0A%09var%20email%20%3D%20new%20Email%28%29%0A%09email%2Esubject%20%3D%20%22PNG%20of%20%E2%80%9C%22%20%2B%20docName%20%2B%20%22%E2%80%9D%22%0A%09email%2Ebody%20%3D%20%22Here%20is%20the%20exported%20canvas%20for%20you%21%5Cn%5Cn%22%0A%09email%2EfileWrappers%20%3D%20%5Bwrapper%5D%0A%09email%2Egenerate%28%29%0A%7D%29%0A%0AwrapperPromise%2Ecatch%28function%28err%29%7B%0A%09console%2Eerror%28err%2Emessage%29%0A%7D%29%7Dcatch%28err%29%7Bconsole%2Elog%28err%29%7D

Mail Image of Current Canvas

var docName = document.name

var fileTypeID = 'public.png'

var wrapperPromise = document.makeFileWrapper(docName, fileTypeID)

wrapperPromise.then(function(wrapper){

var email = new Email()

email.subject = "PNG of “" + docName + "”"

email.body = "Here is the exported canvas for you!\n\n"

email.fileWrappers = [wrapper]

email.generate()

})

wrapperPromise.catch(function(err){

console.error(err.message)

})

var docName = document.name var OGDwrapperPromise = document.makeFileWrapper(docName, "com.omnigroup.omnigraffle.graffle") var PNGwrapperPromise = document.makeFileWrapper(docName, "public.png") var promises = [PNGwrapperPromise,OGDwrapperPromise] Promise.all(promises).then(function(wrappers){ var email = new Email() email.subject = "Exports of “" + docName + "”" email.body = "Here are the exported canvas and file:\n\n" email.fileWrappers = wrappers email.generate() }).catch(function(err){ console.log("Error", err.message) })

omnigraffle://localhost/omnijs-run?script=try%7Bvar%20docName%20%3D%20document%2Ename%0Avar%20OGDwrapperPromise%20%3D%20document%2EmakeFileWrapper%28docName%2C%20%22com%2Eomnigroup%2Eomnigraffle%2Egraffle%22%29%0Avar%20PNGwrapperPromise%20%3D%20document%2EmakeFileWrapper%28docName%2C%20%22public%2Epng%22%29%0Avar%20promises%20%3D%20%5BPNGwrapperPromise%2COGDwrapperPromise%5D%0A%0APromise%2Eall%28promises%29%2Ethen%28function%28wrappers%29%7B%0A%09var%20email%20%3D%20new%20Email%28%29%0A%09email%2Esubject%20%3D%20%22Exports%20of%20%E2%80%9C%22%20%2B%20docName%20%2B%20%22%E2%80%9D%22%0A%09email%2Ebody%20%3D%20%22Here%20are%20the%20exported%20canvas%20and%20file%3A%5Cn%5Cn%22%0A%09email%2EfileWrappers%20%3D%20wrappers%0A%09email%2Egenerate%28%29%0A%7D%29%2Ecatch%28function%28err%29%7B%0A%09console%2Elog%28%22Error%22%2C%20err%2Emessage%29%0A%7D%29%7Dcatch%28err%29%7Bconsole%2Elog%28err%29%7D

Mail Canvas Image and Document

var docName = document.name

var OGDwrapperPromise = document.makeFileWrapper(docName, "com.omnigroup.omnigraffle.graffle")

var PNGwrapperPromise = document.makeFileWrapper(docName, "public.png")

var promises = [PNGwrapperPromise, OGDwrapperPromise]

Promise.all(promises).then(function(wrappers){

var email = new Email()

email.subject = "Exports of “" + docName + "”"

email.body = "Here are the exported canvas and file:\n\n"

email.fileWrappers = wrappers

email.generate()

}).catch(function(err){

console.log("Error", err.message)

})

UNDER CONSTRUCTION

This webpage is in the process of being developed. Any content may change and may not be accurate or complete at this time.

DISCLAIMER

Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. OMNI-AUTOMATION.COM assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. OMNI-AUTOMATION.COM provides this only as a convenience to our users. OMNI-AUTOMATION.COM has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and OMNI-AUTOMATION.COM assumes no responsibility in this regard. Please understand that a third-party site is independent from OMNI-AUTOMATION.COM and that OMNI-AUTOMATION.COM has no control over the content on that website. Please contact the vendor for additional information.