Skip to main content

Project Intake, Duplicates, and Merge

New projects feed plans, dashboards and reports from day one. Two things go wrong easily: a project is set up incompletely, or the same project exists twice, for example once created by hand and once arriving from an import. COMPASS has three tools for this.

ToolWhat it doesThink of it as
IntakeA new project shows Intake pending until someone has checked it and filled in what is missing.A second pair of eyes before everyone relies on the project
Duplicate detectionCOMPASS points out two projects that look like the same project.Finding two contact cards for the same person
MergeCombines the two projects into one. Nothing is deleted.Moving everything into one folder and archiving the empty one
The short version
  1. An administrator switches the tools on per project type: Projects → Blueprints → (project type) → Intake & duplicates.
  2. New projects of that type show Intake pending. A reviewer opens Projects → Intake, clicks Complete intake, fills in what is missing and completes it.
  3. Projects that look alike get a warning. A reviewer clicks Review and merge and merges them in three steps.

All three are off until an administrator switches them on. In COMPASS a project type is called a Project Blueprint.

Set It Up (Administrators)​

Open Projects → Blueprints, open the project type, and select the tab Intake & duplicates. You need the role capability Can Manage Blueprint Base. The tab has three cards. Change what you need and click Save.

Intake Review​

The Intake review card with the checklist builder: fields to fill in, facility details, generate tasks and statements to confirm.

OptionWhat it means
Intake review (switch)On: new projects of this type start as Intake pending. Projects that already exist get no intake.
Which projectsAll new projects, or Only projects that match conditions you set on the project's fields.
Fill in project fieldsFields the reviewer must fill in during the intake, for example the Primary Director or a target date. Done as soon as the field has a value.
Fill in facility detailsThe reviewer adds the project's facility details. Done as soon as one value is entered. Only available when the project type has facility fields. The link in the card takes you to the Facility Details tab to add them.
Generate tasksThe reviewer creates the project's tasks from a task catalog during the intake. Use it when the intake is also the moment to set up the task list. Done once the project has tasks from a task catalog.
ConfirmStatements the reviewer ticks off by hand, for example "Management agreement is signed". Drag the handle to change the order.
NotifyPeople, roles, or project fields that hold a person (for example Primary Director). They get an email and a notification for every new project that needs an intake.

A checklist can have up to 30 items. Without a checklist, completing the intake is a single click.

Duplicate Detection and Merging​

The Duplicate detection card with the match fields and the Merging card with one default.

OptionWhat it means
Duplicate detection (switch)On: COMPASS compares new and changed projects of this type with the other projects of the same type.
Match onUp to 5 fields. Two projects are flagged when all selected fields have the same value. Capital letters and extra spaces are ignored. An empty field never matches, so avoid External ID: a project created by hand has none.
NotifyWho gets an email and a notification for every potential duplicate.
Merging → DefaultsOptional. For a field, which value is preselected when two projects are merged: Project you keep, Merged project, Imported project, Manually created project, Most recently updated, Least recently updated, or Leave empty (custom fields only). The person merging can still change it.
Projects that already existed

Switching on duplicate detection checks projects when they are created or changed. To check all existing projects once, open Projects → Duplicates and click Scan for duplicates. Do the same after you change the Match on fields: pairs that were still waiting for review are removed then, because they were found with the old fields.

Who May Do What​

Open Users & Roles, open the role, then Module Permissions → Projects.

The Projects permissions of a role with the Merge column.

The role capability Complete or skip intake.

To do thisThe role needs
See the intake statusRead access to the project and the field permission Intake status
Complete or skip an intakeWrite access to the project and Complete or skip intake (on by default)
Merge two projectsMerge in the Projects row (None by default, also for Full Access) and write access to both projects
Mark a pair as Not a duplicateWrite access to the project
Open Projects → DuplicatesMerge, Can Manage Blueprint Base, or Has Access to Settings
Click Scan for duplicatesHas Access to Settings

Complete an Intake (Reviewers)​

Find the Projects That Wait​

The quickest way is the tab Projects → Intake. The number next to the tab shows how many intakes wait. Click Complete intake in a row.

The Intake tab with the list of pending intakes and a Complete intake button in each row.

The tab appears for people who may complete intakes, once intake review is switched on for a project type or intakes are still waiting.

You also find pending intakes here:

  • In any projects table: an amber dot next to the project name means Intake pending. Click the dot to open the intake. A warning triangle means Potential duplicate.
  • On the project page: next to the project name you see Intake pending, the progress, and the button Complete intake.

A projects table with the amber intake dot and its tooltip, next to the duplicate warning.

The project header with Intake pending, the progress 3 of 8 done and the Complete intake button.

Work Through the Intake​

Everything happens in one window. A green check mark means done, an empty circle means still open.

The Complete intake window with project fields, facility details, tasks and statements to confirm.

  1. Check the project at the top. You see its name, its project type, the key fields the project type shows in its header, and the progress.
  2. Fill in the open fields under Project Fields, right in the window.
  3. Add the facility details under Facility Details: click Add new Entry and fill in the values.
  4. Generate the tasks under Tasks: click Generate tasks. What you entered is saved first, because the task catalog reads the project's fields.
  5. Tick the statements under Confirm. A tick is saved at once, with your name and the date.
  6. Click Complete intake. The button works once every item is done or filled in. It saves what you entered and completes the intake. The project now shows Intake completed.

Not finished yet? Click Save and close. Your entries are saved and the intake stays pending.

A project that needs no intake

Click Skip intake… at the bottom left and confirm. The project shows Intake not required. You also find Skip intake… in the ⋮ menu on the project page.

StatusWhat it means
Intake pendingNobody has completed the intake yet.
Intake completedSomeone checked the project. The label shows who and when.
Intake not requiredSomeone decided the project skips the intake.

Completing and skipping are final. In the Projects table you can add the column Intake status and filter by it.

Review Duplicates and Merge (Reviewers)​

Find Potential Duplicates​

  • On the project: a yellow notice names the other project and the values both share.
  • On the Duplicates page: Projects → Duplicates lists every pair. Filter by Needs review, Not a duplicate, Merged, or All.
  • In any projects table: a warning triangle next to the project name.

The notice Potential duplicate of Riverside Plaza with the buttons Review and merge and Not a duplicate.

The Duplicates page with one pair that needs review.

For each pair you decide:

  • Not a duplicate: the two projects are different. COMPASS never flags this pair again.
  • Review and merge: the two projects are the same. The merge window opens.

To merge two projects that were not flagged, open one of them and choose ⋮ → Merge with another project…. Both projects must have the same project type.

Merge in Three Steps​

Step 1: Choose the project to keep. COMPASS suggests one. Each card shows where the project comes from (created manually or imported), when it was created and changed, and what it holds. Below the cards you read what will happen.

Step 1 of the merge: two project cards, one marked Suggested and Keep.

Step 2: Resolve differences. Only fields with different values are listed. Pick the value to keep in each row. Default marks a row preselected by the project type's defaults, Choose marks a row that still needs your choice. Use all from the project you keep and Use all from the other project fill every row at once.

Step 2 of the merge: four differing fields, one with a default, two waiting for a choice.

Step 3: Review and merge. Check the summary and click Merge projects.

Step 3 of the merge: the summary and the note that a merge can't be undone.

A merge can't be undone

Check step 3 carefully. Nothing is deleted, but the merge itself can't be reversed.

What Happens After a Merge​

  • Everything moves to the project you keep: tasks, budgets, notes, files and the other related data. A budget or document whose name already exists gets "(merged)" added to its name. A task whose name the kept project already has stays on the merged project.
  • The External ID moves too, so the next import updates the project you kept.
  • The merged project becomes read-only. It no longer shows in the Projects table, in pickers or in reports. A notice links to the project it was merged into. ⋮ → Merge history shows who merged, when, and which values were chosen.

A merged project with the notice that it was merged and is read-only.

Questions​

I don't see the Intake or Duplicates tab. The tabs appear only when the tool is switched on for at least one project type, or when items still wait there. Your role also needs the permissions listed in Who May Do What.

Complete intake is greyed out. Some items are still open. Look for empty circles and unticked statements. If you just ticked a statement, wait a second until it is saved.

I can't fill in a field in the intake. Either your role can't edit that field, or the field type can't be edited there (formula and upload fields). Use the link Edit in project details. The External ID comes from the import or from a merge and can't be typed in.

Two projects are the same but COMPASS doesn't flag them. Check that both have the same project type, that duplicate detection is on for it, and that every Match on field is filled in on both projects. A pair marked Not a duplicate is never flagged again. Projects that existed before detection was switched on are only checked after Scan for duplicates. When more than 5 projects share the same values, COMPASS skips that group.

I don't see Review and merge. Your role needs Merge in the Projects row and write access to both projects.

Do existing projects get an intake when I switch it on? No. Only projects created afterwards get an intake.