Working with projects

Contents[Hide]

1. Overview

All of the work that you do in Dundas BI occurs within the context of a current or active project, which allows users to collaborate on the same dashboard or BI effort.

Current project in the Explore window
Current project in the Explore window

You typically work within one project at a time. The main menu creates or open files from the current active project, and the Explore window lists all of its files for you to work with while you edit an item.

2. Built-in projects

2.1. Global project

Dundas BI includes a built-in project named <GLOBAL>. You can use this project to store any items that are common to your other projects and reusable.

You can work with content from the global project by switching projects, but an easier way is to expand the Shared folders that appear under various folders in other projects, including Data Connectors, Metric Sets, Time Dimensions, Dashboards, and Themes. These act as shortcuts to the global project.

Data cubes, time dimensions, and metric sets shared from the global project
Data cubes, time dimensions, and metric sets shared from the global project

For example, when you install Dundas BI, a set of built-in maps, styles, and themes are included as part of the global project.

Built-in maps in the global project
Built-in maps in the global project

You can expand the Shared folder under Maps in any other project to access the built-in map resources from the global project.

Accessing the same maps from My Project
Accessing the same maps from My Project

Similarly, you can expand the Shared themes or styles folder from the Explore window or from dialogs when applying a theme or style.

2.2. My project

Every user in Dundas BI typically also gets a personal project automatically, named My Project. This is the current project when you first log in to Dundas BI. You are free to use My Project as your own workspace to create dashboards and other items for prototyping or quick analysis. But for actual production work, you'll probably want to use other projects that have been created specifically for that purpose.

By default, no one else has access to your personal project. However, you can use the Share option in the Dundas BI toolbar to give other users the ability to view a dashboard or report from your personal project. The permissions on the project can also be changed to grant other users or groups access.

3. Switch to another project

You can switch the current project in Dundas BI at any time from the main menu.

Click Projects, and then select a project from the list along the top of the screen.

Changing the current project
Changing the current project

Now you can create or open files in this project from the main menu, and the Explore window will update to list all of its items.

4. Create new projects

Dundas BI administrators have the ability to create new projects and configure which users or groups have access to them. For example, you can have a project that is internal to the Human Resources department only.

In general, you will want to set up new projects for collaboration or production efforts rather than use the global or personal projects.

For details on creating new projects, and on the option to duplicate existing projects, see Manage projects and the file system.

5. Publish a project or files

Publishing lets you copy the contents of a source project or files (such as dashboards or data cubes) to a target project, with the option to also copy referenced files so that any dependencies are also part of the target project.

For example, you can set up a project for testing, staging, or development work. Once you are happy with the resulting dashboards, you can publish them to a production project. Publishing allows you to use a single Dundas BI instance for both testing/development and production purposes.

Note
Publishing may cause the database indexes to become fragmented. See Monitoring system health for information for administrators on the Rebuild Indexes job.

To publish a project or a file, find it in the Explore window or in other file explorers such as an Open dialog from the main menu.

Right-click (or long-tap) on the project or file. From the context menu, select Publish (files must be checked in to see this option).

Publish a dashboard
Publish a dashboard

If you have multiple files within a project that you want to publish without publishing the entire project, use the Explore window or another file explorer with a toolbar, and click to enable checkboxes.

Show checkboxes next to files
Show checkboxes next to files

Select the files using the checkboxes, then choose the Publish button in the toolbar.

Publish multiple dashboards
Publish multiple dashboards

In the Publish dialog, click to select a project where the files should be published.

To access any of the following options, expand the Options section and enable them:

  • Ignore/suppress warning messages.
  • Copy any referenced/dependent items from the source project.
  • Copy the data from Data Input transforms.
  • Copy the data from contextual measures.
  • Copy any data files, such as Excel or CSV, which have been uploaded as a data connector.
  • Copy the data cube's storage type (you will be asked whether to build the cube after publishing).

Click the submit button at the bottom of the dialog to begin publishing.

Choose a destination project and select publishing options
Choose a destination project and select publishing options

5.1. Publish an item to a project that contains an item with the same name

When you are publishing an item to another project for the first time, the item is copied with the same name. If a file with the same name already exists, the published file will get a name with the suffix 1, or will increment by one if the name ends in a number.

Publishing creates a relationship between the source and published files. When you publish the same file to the same project more than once, the previously published file will be overwritten by the new version.

Note
Check Ignore Warnings if you want to proceed when publishing an item to another project that already includes an item with the same name.

6. See also

Dundas Data Visualization, Inc.
500-250 Ferrand Drive
Toronto, ON, Canada
M3C 3G8

North America: 1.800.463.1492
International: 1.416.467.5100

Dundas Support Hours:
Phone: 9am-6pm, ET, Mon-Fri
Email: 7am-6pm, ET, Mon-Fri