Integration Settings

Navigating to Integration Settings

You can navigate to the integration settings by:

Log in using an Admin account.
Select the company settings in the bottom left of the page as indicated in the image below

Note: If you are not on an Admin account you will not see this. You will only see the bubble below which is personal settings, not company settings.

From there navigate to integrations on the side menu as shown here:

📘
The Integration page varies
Depending on the integration you have set up, the details of the next page will vary slightly.

If you have no integrations set up:

If you have no integrations set up, you will see a list of applications that we currently integrate with, or are working on. If you are interested in setting up an integration, please reach out to support via the support bubble in the bottom right:

If you have multiple integrations set up:

If you have multiple integrations you will see a list of your current integrations at the top of the screen. From here, you can select one to navigate to each integration's settings.

Integration Settings Overview

Once you navigate into your specific integration settings page, you will be able to import and link projects from that integrated application into Mosaic.

Manually Importing Data (e.g., a new project not in Mosaic):

In this example we are importing a project, although the steps are similar for other data types.

Select the Import tab from the tabs shown below.
Navigate to the Project you want to Import.
Select the checkbox to the right of the Project as shown by the arrow below.
(Optional) Select more Projects.
Select Import (1) as new.

This number will change to reflect however many Projects you selected.
That's it! Navigate to the 'Linked' tab to check that the project has been imported successfully.

Note: Depending on the integration you selected you may see a variety of data types you can select from and import, in the picture below we have the Asana integration which only has 'Projects' and 'Members' Data types, but expect to see different data types for others.

Manually Linking Data between Mosaic and Your Integrated Application (e.g., a project that already exists in Mosaic and your integrated application).

In this example we are importing a project, although the steps are similar for other data types.

Select the Link tab from the tabs shown above.
Navigate to the Project you want to Link.
Select the plus to the right of the Project as shown by the arrow below.
(Optional) Select more Projects.
Select a pre-existing project in Mosaic to link to.
Select Save.

There may be a pop up warning you about linked timesheets being imported. If there are timesheets linked that you would not like to bring over, then you should not link, otherwise select 'Yes, Link project'.
That's it! Navigate to the 'Linked' tab to check that the project has been imported successfully.

General Integration Settings

Auto Import Projects and Phases

The Auto Import feature allows projects to automatically link and upload into Mosaic without having to manually link each one as above. For companies with a large amount of projects, the importing and linking process can be long and tedious, the auto-import feature helps to streamline this process.

📘
Auto-Import allows for up to three project layers to be linked: Project, Phase, Work Category.
If your projects in your integrated application use more than 3 layers (eg. Ajera offers up to 6 layers) please contact your Customer Success Manager before trying to set up this feature.

Auto Import can be turned on in the Integrations tab as follows:

Select the cog next to the integration name as shown below:

Auto Importing Projects

Select All Projects in ____ (The example below says ‘Deltek’ but it can be other integrations).

Default Portfolio

Select the Portfolio you would like projects imported into
By default, Mosaic imports new projects into the Import portfolio.

Auto Import Phases

If you would like phases to be automatically imported (rather than linking each one manually) select the 'Import all Phases' option below

To exclude some Phases in Auto Import:

(Optional) If you have Phases that you would not like to automatically import, you can instead select Excluding some Phases”and add the phases you would like to exclude from the Auto Import.
For more information, please refer to the Phase Exclusions guide.

Auto Import Work Categories

This feature allows Work Categories to automatically link and upload into Mosaic without having to manually link each one.
For companies with a large amount of Work Categories - also know as Service Items (QuickBooks) or Labor Codes (Deltek), the importing and linking process can be long and tedious, the Auto import all timesheet feature helps to streamline this process.