OmniGraffle Extras

In addition to import/export, this section touches on some of the following advanced features of OmniGraffle:

• AppleScript support (requires OmniGraffle Pro)
• LinkBack support
• Using Regular Expressions in OmniGraffle

PDF files (.pdf)

There are two ways to import a PDF file into OmniGraffle:

• Use File ▸ Open and choose the PDF file you would like to work with. OmniGraffle attempts to import the PDF file as editable shapes.
• Drag a PDF file onto the Canvas. This places the PDF file as an image, over which you can add notes, annotations, and other standard OmniGraffle objects.

DOT files (.dot)

OmniGraffle understands a subset of the DOT language used by Graphviz. This isn’t a full implementation of DOT, but it can be quite useful.

Diagram! 2 documents (.diagram2 and .dpalette2)

Diagram is a NeXTSTEP/OPENSTEP application similar to OmniGraffle. OmniGraffle can import the objects in a Diagram file, but not attached EPS images, sounds, or links.

OmniOutliner Documents (.ooutline and .oo3)

When you open an OmniOutliner file, the items of the outline are interpreted as a diagram. A dialog appears; use it to indicate exactly how to interpret the outline: Use the pop-up list to choose a diagram style.

EOModeler files (.eomodeld)

OmniGraffle creates a diagram of the database relationships described by the file.

Folder structures

Drag a folder from the Finder and drop it on OmniGraffle’s application icon to map out the folder’s contents as a diagram.

The available file formats are:

• BMP bitmap image — A legacy graphics format.
• EPS vector image — Encapsulated PostScript. This is a common format in professional printing.
• GIF bitmap image — A legacy graphics format prevalent on the web.
• HTML image map — A hypertext file and a JPEG, PNG, or GIF image. URL actions in the original OmniGraffle document are coded into the image map as links so that the image can be clicked to follow them. (Note that actions on lines aren’t included, but actions on line labels are.)
• JPEG bitmap image — a popular compressed image format. You can lower the image quality to get a smaller file size.

• OmniGraffle Stencil, OmniGraffle Template — Resources for OmniGraffle.
• OmniOutliner 3 — Represent the diagram as a text outline, using the connection lines between shapes to create a hierarchy. This doesn’t work as well for diagrams that don’t have strictly tree-like structures.
• PDF vector image — Portable Document Format. This is a nice cross-platform format that has good support for both vector components and bitmaps.
• PNG bitmap image — Portable Network Graphics, a popular format for the Web. This format uses lossless compression to retain the details of an image while decreasing its file size. It supports transparency.

• TIFF bitmap image — Tagged Image File Format. This format supports transparency.

Depending on the file format you choose, you have different options. Most offer an Export Area option, with which you can choose how much of the document to export.

• Current Selection — Only export the objects that are selected right now.
• All Objects — Export all of the objects on the canvas, but not the empty areas.
• Specific Region — Specify a precise region of the canvas to export.
• Current Canvas — Export the entire canvas.
• Entire Document — Export everything, creating one image file for each canvas.

Depending on the format you choose, you can also choose a scale for exporting smaller or larger than actual size, the resolution, the compression level, and whether to make the background transparent.

For lots of information about LinkBack, and a list of applications that support it, check the LinkBack repository on GitHub.

To embed OmniGraffle content in another LinkBack application, just copy and paste the content like you would normally. The same goes for embedding other applications’ content in OmniGraffle diagrams.

To embed OmniGraffle content inside a single object in OmniGraffle, select all of the objects on your canvas (Command-A), choose Edit ▸ Copy As ▸ PDF from the menu bar, and then Paste (Command-V). The objects you copied become a single image; double-clicking the object opens a new OmniGraffle window in which you can edit the objects to your heart’s content.

To edit OmniGraffle content embedded in another application:

• Double-click the OmniGraffle content in the other application’s document; an OmniGraffle window appears containing the content.

• Edit the content in the OmniGraffle window, just as you normally would.

• In OmniGraffle, choose File ▸ Save; the content in the other application updates automatically.

• To edit other LinkBack applications’ content embedded in an OmniGraffle diagram, just double-click it. When you save in the other application, the content in the OmniGraffle diagram updates.

• a* — zero or more instances of a (matches the longest string possible)
• a*? — zero or more instances of a (matches the shortest string possible)
• a+ — one or more instances of a (matches the longest string possible)
• a+? — one or more instances of a (matches the shortest string possible)
• a? — zero or one instance of a
• ^ — beginning of a line
• $ — end of a line
• . — any character
• [a-z] — all characters between a and z
• [abc-] — a, b, c, or -
• (abc) — matches abc and stores it as a group. Use the Select or Replace pop-up menu in the Find dialog to select or replace only one of these groups rather than the whole expression.
• \1 — text of first matched group
• a|b — a or b
• \n — newline
• \r — carriage return
• \t — tab character
• \d — digit
• \D — non-digit
• \w — word character (alphanumeric or underscore)
• \W — non-word character
• \s — whitespace
• \S — non-whitespace
• \ — escape the next character

Regular expressions are very popular, so you should be able to find plenty of information about them on the internet or in a good library or bookstore. Here are a few examples to get you started:

• &\s*$ — matches whitespace at the end of a line.
• <.*?> — matches strings that begin with < and end with >, such as XML tags.
• &\S+@\S+ — very liberally matches things that resemble email addresses (anything@anything).
• (19|20)\d\d-\d\d?-\d\d? — matches dates in the format YYYY-MM-DD, between 1900 and 2099