Troubleshoot errors when creating a Microsoft Project schedule from OnePlan (Teams/SharePoint storage)

  • Updated

This article explains the errors you might see when you create or open a Microsoft Project schedule from OnePlan in a group that stores its schedules in Teams/SharePoint, including "Object reference not set to an instance of an object", and how to fix each one.

Before you begin

When your OnePlan group stores Microsoft Project (.mpp) files in Teams, OnePlan uses two SharePoint document libraries on the site of your OnePlan group-level team:

Library name (exact) What it holds
Plans The connected .mpp file for each plan, one per plan. OnePlan saves files here automatically.
PlanTemplates The Microsoft Project templates (.mpp) that appear in the Select Template drop-down when you create a schedule from OnePlan.

You also need both the Project Professional and Microsoft Teams apps installed and configured for your OnePlan group. For the full setup, see How do I store Project schedules in Teams for my OnePlan group?

Important: This setup applies to each OnePlan group. If you have more than one group, such as Test and Production, you must complete it in every group. Groups can point to the same Team/SharePoint site if you prefer.

Error: "Error (Create Plan) Object reference not set to an instance of an object."

When you see it: In a plan, you select Connected Systems > Microsoft Project > Next, or you choose a template and select Create Plan. It usually affects every user and every plan in the group.

Cause: OnePlan found your group's Teams/SharePoint site, but the site has no document library named exactly PlanTemplates, so there's no template to create the schedule from. The library was either never created or was created under a different name, for example Plan Templates, PlanTemplate or ProjectTemplates.

Resolution:

  1. In Microsoft Teams, open your OnePlan group-level team (not a team linked to a single plan), then open Files.
  2. Select the ellipsis (...) > Open in SharePoint.
  3. Select Settings (gear icon) > Site contents, and look for the PlanTemplates and Plans document libraries.
  4. If either library is missing or named differently, add a new document library: New > Document library, or Settings > Add an app > Document Library. Name it exactly PlanTemplates or Plans, with no spaces and matching capitalization.
    • Tip: renaming an existing library in SharePoint changes only its display name, not its web address. If a library was created with the wrong name, create a new one with the correct name rather than renaming the old one, then move your files across.
  5. Upload your Microsoft Project template(s) to PlanTemplates.
  6. In OnePlan, open the plan and try Connected Systems > Microsoft Project again.

Error: "Error (Connect Project) Teams Site Error: accessDenied"

When you see it: When you start a new connection and OnePlan tries to load the list of templates.

Cause: The Teams/SharePoint setup is complete, but the person connecting doesn't have permission to the SharePoint site behind the group's team.

Resolution:

  • Ask the team or SharePoint site owner to give the user access to the site. At a minimum they need read access to the PlanTemplates library, then try again.
  • Users who work through Teams must be added to OnePlan with their Microsoft Entra ID account, using Search in the Resource Center. Accounts added with a username and password can't sign in to Teams.

Message: "Your Project Teams site has not been setup. Would you like to start a local copy of this file?"

Cause: The OnePlan group has no Teams/SharePoint site connected, so OnePlan can't find a template and offers to create a local copy instead.

Resolution: Complete the Teams setup for this group:

  1. A Microsoft 365 tenant administrator grants Teams permissions in OnePlan (Config > Microsoft Teams > Grant Permissions). This only needs to be done once per tenant.
  2. Create or open the OnePlan group-level team.
  3. Create the Plans and PlanTemplates libraries as described above.

If you only want to work with local files, you can select the option to start a local copy.

Error: "Project cannot open the file. Check that the file name and path are correct…"

When you see it: When you open a plan's schedule that was already created through Teams/SharePoint.

Cause: This message comes from Microsoft Project. The plan's .mpp file is no longer where OnePlan expects it in the Plans library. It may have been deleted, moved or renamed after the plan was connected. You can ignore the advice about older Project versions and the MPX format; the file version isn't the problem.

Resolution: Put the plan's .mpp file back in the Plans library, in its original location and with its original file name, then try again. If you can't find the file, check the library's recycle bin or version history.

Best practices

  • Use clean templates. Only upload templates to PlanTemplates that have never been connected to OnePlan. A file that was connected keeps its connection details even after you disconnect it, and those details are copied into every schedule created from it.
  • Don't rename or move files in the Plans library. OnePlan manages these files.
  • Keep permissions inherited. Let both libraries inherit permissions from the team's site so everyone who can access the team can use them.
  • Set up every group. Repeat the library setup in each OnePlan group that uses Microsoft Project.

Workaround

While you fix the Teams/SharePoint setup, you can still connect a schedule from Microsoft Project desktop: open the .mpp file, go to the OnePlan tab, select Connect, then Publish to the plan. See Use the OnePlan for Project Connector.

Still need help?

If the error continues after you've checked the steps above, contact OnePlan Support and include:

  • Your OnePlan environment URL and group name
  • The exact error message, and a screenshot of it
  • The SharePoint site URL of the group-level team
  • A screenshot of Site contents showing the Plans and PlanTemplates libraries
  • Whether the error happens for every user and every plan, or only some
  • The approximate time of the error, with your time zone

Related articles

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.