Sharing Reports and Projects

Modified on Wed, 06 Oct 2021 at 11:10 AM

You can share a project link (link to workflow + visualisations), or a Report link (data visualisation only), both of which are hosted on your Server. You need to make sure that your server is accessible to the intended recipients, who might be inside or outside of your company or firewall. You may need to contact your network/system administrator to arrange this.

It is important that your Server is set up to run as a Web Server - instructions can be found in this article.

Project links

A link to the .iox file takes another user to your project, giving them access to both the data workflow and reports created inside (see the blue blocks). You can generate this link by copy/pasting the url from the browser address bar, when you open any existing project. It allows multiple users to collaboratively work on the same project, or utilise a single workflow to generate multiple customised reports/dashboards for different purposes. They do not have to have Omniscope installed on their machine or mobile device. Their access is controlled by the permissioning system in the Admin section.

Report links

These are links to the individual Reports within the project. To generate a link - open the report you wish to share, then from the 

Report Settings menu (Preview edit mode, cog icon on the main toolbar) > Sharing (see image)

From here you can create four different types of links:

  • Private (report only accessible within the workflow)

  • Link where access authentication is managed via the Server permissioning.

  • Link with username/ password protection for each recipient (multiple users/passwords can be created to customise access permissions.) This option allows you to control the user experience and decide what the report recipient can do with the interactive report.

  • Public link - access to the report via this link is without restrictions, but subject to company’s server access settings (enabling external users to access the server location)

All links, apart from the ‘Private’, can give the recipients option to download report data in csv format, or edit the report and save the changes. Report administrator controls distribution of these rights, as well as the option that report edits are synchronised with the master version and saved.

QR codes
Sharing links are also accompanied by QR codes. Useful on a large screen or at a show, and when consuming reports on mobile devices.

Shareable link as Report Viewer

End-users can filter a Report and share their findings with others using a shareable URL. Read more here.

Advanced - Embedded report hiding toolbar

If you wanted to share a particular tab within the report and hide the toolbar - you can do so by adding /#tab=[TAB_NAME] where [TAB_NAME] is the name of the tab within your report.

For example:

Portable formats

These are different file formats the whole project or its components can be saved in, so you can send them to other users, or save as files on a shared location.


IOZ is a portable project file, which contains all the data, plus the workflow and reports.  

On open it will require the users to ‘import the project’. After that they will be able to access the workflow and all reports you have created, including the data you have executed in the workflow. Download is available from the File/project list page, as well as from the Workflow app toolbar (under the 3-dot menu).


IOD is Omniscope's portable data file format. It only contains the raw data and is a scalable streaming-based data format, used in a scenario where the user wants to preserve the data for later use in Omniscope. 

While relatively small in storage size, the IOD file is fast to process in an Omniscope workflow as a source block.

To save the data in IOD format select the IOD file type in the File output block (green block in the workflow).



IOR is Omniscope portable Report file. This file only contains an individual report, along with the data needed to power the visualisations. Because this is a proprietary format, the recipients will have to have Omniscope installed on their machine.

Use this if you wish to share report with others, send it as an attachment, or store it in a file format.  It is a useful way of dealing with the server access issues (e.g. recipient is outside the company’s firewall), or a method of preserving the report for consumption on a device without the internet connection. 

To create: Open the report you want to share in the workflow, then from the Report Settings dialogue (cog icon on the main toolbar of the report) go to “Sharing” tab and click on the option ‘Save as IOR’ (see image above). File password protection is optional.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article