Working in the Cloud

By default, OmniGraffle stores files locally on your iOS device. As mentioned in Managing Files with the Document Browser, your files are saved in the Local Documents folder on the device. But now that OmniGraffle works across iOS devices, you should consider storing your files in the cloud. When you do, your files are accessible on your iPad, iPhone, iPod touch (5th Generation or later), and also on your Mac if you use OmniGraffle there, too.

You can add as many cloud accounts as you’d like. For example, you could add cloud accounts for personal- or work-use, a group-accessible account for your UX team...pretty much whatever you need. The only real limitation is the amount of available storage space on each device.

This chapter opens up the clouds by showing you how to create and connect to Omni Sync Server via OmniGraffle’s built-in OmniPresence. From there, you’ll learn how to connect to other Cloud Storage Providers using a new BETA service that allows you to connect to iCloud Drive, Box, Dropbox, and more.

What Does it Mean to Work in the Cloud?

Working in the cloud sounds kind of cool and futuristic, but what it really means is that your files are safely stored somewhere else with copies of those files stored locally on your iOS device.

Whenever you make a change to a file, the file in the cloud is updated when OmniGraffle performs its next sync operation. Of course, this assumes your iOS device is connected to the Internet. And if you aren’t, those changes will sync the next time you are.

Another benefit of storing files in the cloud is that, if you lose or misplace your iOS device, your documents are safe and secure on your cloud provider’s server. All you need to do to access your files is log in to your cloud account, change your password, sync the files with your new iPhone or iPad, and then you’re back in business.

Of course, your files are only as safe as the strength of your password—and this includes using a Passcode (and/or Touch ID) on your iOS device. Don’t use a simple, dictionary-derived password or something that would be easy for anyone to guess, such as the name of your dog whose name and photos are plastered all over Instagram and Facebook.

Choose a strong password—or look to other iOS and Mac apps such as 1Password and its built-in Password Generator—to help keep your cloud account secure. As an additional measure, if your cloud provider offers two-step verification, you should take them up on that, too.

And while most cloud services—including Omni Sync Server—maintain backups, you shouldn’t trust that your cloud provider will be able to help you out in a pinch. Just because you are storing your files in the cloud doesn’t absolve you from backing up your files—you totally should maintain backups of all your stuff! Be sure to regularly backup your iOS device (either to iCloud or to your Mac), and maintain a regular backup schedule for your Mac, too.

Syncing with OmniPresence

We’ll start your journey into the clouds with the path of least resistance; OmniPresence. We built OmniPresence from the ground up as a solution for our users to store files in the cloud. For you, there are two options for storage:

  • Omni Sync Server, which is a bank of servers we maintain so you can store files in the cloud. OmniPresence is built into our iOS apps (there’s a desktop app for your Mac, too), so there’s nothing additional to download. All you need to do is sign up for a free Omni Sync Server account.
  • WebDAV Connectivity is a hook we provide in OmniPresence so users who wish to maintain their own server can store and sync files. You can connect to your own WebDAV server, a third-party service that you trust, or you can even set up a WebDAV service on your local network using WebDAVNav Server.

Now that you know your choice of paths for using OmniPresence, let’s show you how to set them up in OmniGraffle.

Creating an Omni Sync Server Account

If you plan to use Omni Sync Server with OmniGraffle, you will need to set up a free account if you don’t already have one. You can create a free Omni Sync Server account online at:

Just go to that page, enter your email address, and click Sign Up. We’ll send you an email with instructions on how to set up your Omni Sync Server account.

When setting up your Omni Sync Server account, don’t forget to set a strong password; you do want to keep those nefarious SkrYpt K1dD0z3 from brute-forcing their way into your files, don’t you?

When everything is ready to go with your Omni Sync Server account, return to the Locations screen in OmniGraffle and then follow along.

Connecting to Omni Sync Server with OmniPresence

If you have an Omni Sync Server account, follow these steps to configure a cloud account:

  1. To start syncing to Omni Sync Server, start on the Locations screen and tap Add OmniPresence Account.
    Tap Add Cloud Account.
  2. Next, choose the type of cloud account you would like to use; you can choose between Add Omni Sync Server Account or Add WebDAV Server. The difference between the two is that we host and maintain Omni Sync Server, whereas you would need to find a third-party WebDAV server (or host your own) and entrust them to maintain the server.

    Tap Add Omni Sync Server Account.

    Choose from Omni Sync Server or a WebDAV server
  3. On the Account Info screen that appears:

    1. Enter your Account Name
    2. Enter the Password for your account
    3. Optionally, enter a Nickname to be used as the name for your synced folder
    4. Tap Save to authenticate with Omni Sync Server
    Enter the credentials for your Omni Sync Server account

The next message you’ll see is Testing Server for Compatibility along with a progress bar. If everything checks out okay, OmniGraffle lets you know that it has successfully connected to Omni Sync Server.

Testing Server for Compatibility

When your credentials have authenticated, you’re taken back to OmniGraffle’s Locations screen where you’ll see a new folder for your synced files.

After syncing, the Omni Sync Server folder shows up on your home screen

To access the files within a document folder, just tap the folder of your choice, and then tap the file you would like to work on.

Connecting to WebDAV Servers with OmniPresence

On the Account Info screen that appears, follow these steps:

  1. Enter the URL for the Location of your WebDAV Server
  2. Enter your Account Name
  3. Enter the Password for your account
  4. Optionally, enter a Nickname to be used as the name for your synced folder
  5. Tap Save to authenticate with the WebDAV server
Enter the credentials for your WebDAV account

As with connecting to Omni Sync Server, OmniGraffle informs you that it is Testing Server for Compatibility, and displays the Connected screen when it has connected to the WebDAV server successfully.

When you expose files and folders on your iOS device to the Internet (even with strict password protection), you assume some risk. Make sure you understand this risk before setting up a server, and be sure to keep your server up to date with the latest security patches. If you’d prefer not to host your own server, you can sign up for a free Omni Sync Server account or use another standards-compliant WebDAV host to sync files with OmniGraffle.

Monitoring OmniPresence

When you have configured OmniGraffle to use either type of cloud account (Omni Sync Server or WebDAV), you’ll notice an OmniPresence icon in the toolbar.

OmniPresence icon in the toolbar

Keep an eye on this icon to monitor OmniPresence’s sync status:

  • — denotes that OmniPresence is active and ready to sync files to the server.
  • — denotes that a sync is currently in progress.
  • — denotes that your iOS device does not have access to an active Wi-Fi or cellular network.
  • — denotes that there was an error when trying to sync your files. You may see this icon if someone else is working on the same file, or if a connection cannot be made to the sync server you are using. Try tapping the OmniPresence icon again and if you get the same error icon, please contact our Support Humans for assistance.

OmniPresence checks in with your active sync servers every minute or so, and saves any updates you’ve made to the server. OmniPresence also saves a version of your file to the server whenever you close a file or switch from OmniGraffle to another app on your device. Alternately, you can tap the OmniPresence icon to force an update to the server at any time.

Using Cloud Storage Providers BETA

OmniGraffle makes it easy for you to store and work on files in the cloud. A new BETA feature that we are introducing with OmniGraffle v2.2, Cloud Storage Providers, lets you save the things you draw in OmniGraffle to your choice of cloud service, including but not limited to the following:

  • Omni Sync Server (via OmniPresence)
  • iCloud Drive
  • Box
  • Dropbox
  • Google Drive
  • OneDrive
  • and more!

Please be aware that the ability to use Cloud Storage Providers is in BETA, which in software terms means that it probably isn’t stable or reliable. As such, we haven’t turned on this feature by default. If you are okay with taking a little risk in testing out this new feature, see the next section.

If you encounter any problems with accessing your OmniGraffle files stored in the cloud, please let us know. Please be sure to let us know on which service your files are stored, and describe what happened as best as you can.

Turning on Cloud Storage Providers

If you would like to turn on access to Cloud Storage Providers, start from the Locations screen by tapping The Gear icon, and then tap Settings:

  1. Tap Use Cloud Storage Providers
    Tap Use Cloud Storage Providers to proceed
  2. Tap the switch next to Use Cloud Storage Providers to turn on the service
    Read the text beneath the switch before turning on the Use Cloud Storage Providers option

The switch turns green to let you know that the Cloud Storage Providers service has been turned on. Tap Settings and then Done to close the windows and return to the Local Documents folder.

Cloud Storage Providers option turned on

If you tap Locations in the toolbar, you’re taken back to the Locations screen, where you’ll now see an Other Documents folder; this is where you access files you store in the cloud.

The Locations screen now lists an Other Documents folder for working in the cloud

With Cloud Storage Providers turned on in OmniGraffle, there’s one more switch you’ll need to flip if you want to use iCloud Drive from Apple. Let’s do that next.

Using iCloud Drive with OmniGraffle

Before you can sync OmniGraffle files with iCloud Drive or another cloud-based storage system, there are some initial things that you need to do on your iOS device. Fortunately, OmniGraffle has OmniPresence built-in so all you need is a free Omni Sync Server account (see Creating an Omni Sync Server Account for details), and iOS gives you access to iCloud Drive out of the box. All you need to do is flip a few switches, and iCloud Drive is ready to go.

Turning on iCloud Drive on iOS 8

On your iOS device, open Settings, and then choose iCloud ▸ iCloud Drive, and make sure that iCloud Drive is On.

The Settings screen with iCloud Drive turned On

In the list of apps that use iCloud Drive, make sure that the switch next to OmniGraffle is also On. This allows OmniGraffle to open and save files stored on iCloud Drive.

The iCloud Drive screen, showing the list of apps storing documents and data in iCloud

Turning on iCloud Drive on iOS 9

If you have recently updated to iOS 9, you may have been asked during the initial setup if you would like to install the iCloud Drive app on your device. If you said “Why yes, I think I would!” to that, you already have the iCloud Drive app ready and waiting on your iPhone or iPad. However, if you did’t accept that when setting up iOS 9, you can still install iCloud Drive on your iOS 9-bearing device.

On your iOS device, open Settings, and then choose iCloud ▸ iCloud Drive, and make sure that iCloud Drive and Show on Home Screen are switched on.

Adding the iCloud Drive app on iOS 9

The iCloud Drive app lets you see, organize, and remove files that you have saved to iCloud. For example, you can create a separate folders for storing the things you create with OmniGraffle or the outlines you create with OmniOutliner.

You can also log in to to manage your files.

When working with files stored on iCloud Drive, you can add files to OmniGraffle’s Other Documents folder, or you can copy them from iCloud Drive into the Local Documents folder from the iCloud Drive app. See Opening and Working on Files in the Cloud for instructions on how to add files stored in the cloud to the Other Documents folder. Or, to work with files stored on iCloud Drive, follow these steps:

  1. Tap iCloud Drive to open the app on your iOS device.
  2. Locate the OmniGraffle file you would like to open:
    A listing of files stored on iCloud Drive
  3. When you tap to select the file, iCloud Drive offers the option to download it to your device. Tap Download to proceed.
    Tap to Download the OmniGraffle file to your iOS device.
  4. When the file has finished downloading, you will see a screen similar to the following:
    The My Level Styles file has been downloaded from iCloud Drive, but what next?

If you switch to OmniGraffle at this point, the file you tapped won’t be ready for use. Instead, the file has only been downloaded from Apple’s servers to the iCloud Drive app on your device. At the bottom of this screen, you’ll see the following three options:

  • Tap The Share icon on the lower-left to open or send the file to another app.
  • Tap The Trash can icon, at center-bottom to delete the file from iCloud Drive. Be careful here, as this permanently removes the file from iCloud Drive. If you don’t have a backup of the file and you select this, the file won’t be recoverable.
  • Tap The Folder icon to move the file to another folder on iCloud Drive.

Since you want to work on the file in OmniOutliner, tap The Share icon on the lower-left and then tap Copy to OmniGraffle. This does two things: first, it saves a copy of the file in OmniGraffle’s Local Documents folder; and the file automatically opens in OmniOutliner.

iCloud Drive lets you choose an app in which you can share or open the file

This is very different from adding files to the Other Documents folder from the cloud. When you download a copy of the file from iCloud using the iCloud Drive app, you have just that—a copy. The file still resides on iCloud Drive, but the file you copied to your iOS device is no longer connected to the file on iCloud Drive. This means that any changes you make to the file copied to Local Documents won’t be saved back up to the cloud. Be careful.

Finally, if you tap Documents in OmniGraffle when you have finished working on the file, you will see Back to iCloud Drive along the top of the screen on the left. If you tap that, you are taken out of OmniGraffle and back to the iCloud Drive app on your device.

To push your changes you made to the copied file in Local Documents back up to iCloud Drive, do the following:

  1. Tap Select.
  2. Tap to select the file you want to move to iCloud Drive; a blue border is placed around the selected file.
  3. At the top of the screen, tap The Share Button, and then tap Export to... in the menu that opens.
  4. Choose the file format to export; for example, OmniGraffle (which produces a file that ends with a .graffle file extension).
  5. Choose the the location. By default, the export window opens to iCloud Drive; that’s mighty convenient.
  6. Tap Done.

The file still resides in the Local Documents folder, but now you can safely delete that file from your device with the knowledge that your changes have been stored on iCloud Drive.

Saving Files to the Cloud

“Saving” files to the cloud is a bit of a misnomer, mainly because there’s no way to directly create a new file in the Other Documents folder. Instead, you first need to create a document in either the Local Documents folder, or in a folder you are syncing with OmniPresence, and then export or move the file to one of the Cloud Storage Providers.

Let’s assume that you have a file in your Local Documents folder that you’d like to store on Dropbox instead. Here’s what you need to do:

  1. In the toolbar, tap Select. This lets you choose files in a folder so you can do something with them.
  2. Locate the file that you want to move to Dropbox, and then tap to select it. When you select the file, a blue border is placed around the file icon to indicate that it’s ready for action.
    A selected file with a blue border around the file icon
  3. In the toolbar, tap Share button to open the Sharing menu.
    The Sharing Menu
  4. In the Sharing menu, tap Export to....
  5. Choose the file format that you would like to save the document to. You can choose from OmniGraffle, PDF, PNG, or OmniOutliner, depending on your needs.
    The Choose Format window
  6. Tap Locations to open the Cloud Storage Providers’ menu, and then tap to choose Dropbox as the storage location.
    The Locations menu
  7. After you choose the cloud service, the window changes to show you the files and folders for your account on that service. Choose a Save Location and then tap Save to... at the bottom of the window.
    The Cloud Service window

When you export a file to one of the Cloud Storage Providers, the file you exported also remains in its original location. So, if you exported a file from Local Documents to Dropbox, that file is now in two places. If you want to continue working on the file while it’s stored on Dropbox, you might consider deleting the copy stored in Local Documents just to avoid confusion.

Opening and Working on Files in the Cloud

As with files stored on Omni Sync Server, you can edit files stored on iCloud Drive while they live in the cloud. You can even have the same file open on multiple iOS devices (or Macs) at the same time.

For example, to open a file that resides on iCloud Drive, follow these steps:

  1. On the Locations screen, tap Other Documents.

    The Locations screen, showing the Other Documents folder
  2. In the toolbar, tap The Add Button to add a document stored on iCloud Drive (or another service) to the Other Documents folder.

    By default, the file chooser reveals the files available on iCloud Drive. (If the file is on another cloud service, tap Locations, and then tap to choose your cloud provider.)

    The Locations screen lets you access files stored in the cloud

  3. Locate the file you want to work on, and then tap to choose and add the file to the Other Documents folder on your device.
    The file from iCloud Drive now appears in the Other Documents folder on your device; tap to open the file in OmniGraffle
  4. Finally, tap to open the file in OmniGraffle.

When you Open a file that’s stored on iCloud Drive, the file remains on iCloud Drive while you are making changes. When you close the file (by tapping Documents in the toolbar), the changes are saved to the file on iCloud Drive.

For optimum performance with iCloud Drive—and to prevent possible data loss—we recommend that you only open the file on one iOS device or Mac at a time.

Removing Files from the Other Documents Folder

When you’ve finished working on your diagram, tap Documents in the toolbar. This takes you back to the Other Documents folder. Now you have a decision to make: What to do with files in the Other Documents folder?

  • Do you leave them in the Other Documents folder?
  • Or do you remove them from your device?

There’s nothing wrong with leaving files there, especially if you have more work to do to your diagram. Files that you add to the Other Documents folder are shadow files of the original in the cloud. The two are linked for the purpose of synchronizing the changes you make, with the file in the cloud as the “one true source”.

Optionally, you can remove the file from the Other Documents folder. If you need to work on the file again, you can always add it back to your device. Removing the file from the Other Documents folder does not delete the file from iCloud Drive—your file is safe and secure in the cloud—it just removes the file from your device.

To delete a file from the Other Documents folder:

  1. In the toolbar, tap Select.
  2. Tap to choose the file (or files) you’d like to delete.
  3. Tap The Remove Document icon in the toolbar, and then tap Remove Document.

Files you remove from the Other Documents folder just disappear; they are not moved into a Trash folder. This is because files added to the Other Documents folder are just shadow files (for lack of a better term) of the actual files stored in the cloud.

Deleting a Cloud Account

To remove an account, tap Edit; a delete handle appears to the left of the account name. If you tap the delete handle, the account name slides to the left and a Delete button appears on the right edge; tap that to delete the account.

The delete handle, a red circle with a white dash inside, appears to the left of the account name.
Tap the delete handle to slide in the Delete button.

A quicker way to do this is to swipe left across the account name to bring up the Delete button. If you change your mind before deleting the account, tap Done and the Delete button goes away.

Undo does not restore an account that you have deleted. If you delete one (or all) of your Cloud Accounts, you will need to set those up all over again.