Resolve Validation Errors

When you publish an enterprise project plan that is mapped to a team project, the Team Foundation add-in from Visual Studio 2012 for Microsoft Project Professional performs several data validation checks. A data validation error occurs if you define or modify the values for a task that is set to publish to Team Foundation Server and one or more values violate a rule that is defined for the type of work item that is associated with the task.

Note

For information about how to resolve data validation errors in Microsoft Project for a non-enterprise project plan that is bound to a team project, see Resolve Data Validation Errors.

Validation rules are added to the enterprise project plan when it is mapped to a team project. If a data validation error occurs, the Validation Resolution dialog box appears. In the Unpublished work items list, the Issue column indicates the type of error that has occurred. The Status column indicates whether you must take a corrective action, Project has corrected it automatically, or you have corrected it. For issues that Project corrected automatically, you can click the entry to display the reason for the correction in the lower part of the dialog box.

The following table summarizes the types of errors that data validation identifies.

Issue

Status

Corrective action

One Team Foundation Owner Required

Action Required

In the Resource Names field, you must specify a valid contributor for a team project.

Note

You can assign only one active user to a task that is published to Team Foundation Server. However, multiple resources appear in Project for summary tasks that contain the rollup of child work items.

Invalid Value

Action Required

You must specify a valid value for each field that is required for the work item type to which the task is linked. In some instances, you must click Correct this error to access the work item form in which to make the corrections.

Invalid Work Item Type

Action Required

You must specify a work item type that has been configured to participate in synchronization for the enterprise project plan and the mapped team project.

Note

Project automatically corrects the field if only one work item type is mapped for the project plan and team project.

If you want to specify a type of work item that is valid for the mapped team project but not for the enterprise project plan, you can add it to the list of mapped types. For more information, see Specify the Work Item Types That Can Be Synchronized.

Important

Text30 is the default Project field that is associated with the Work Item Type column that is used in synchronizing tasks with work items. If you ever connect the project plan to Team Foundation Server by using the Choose Team Project option on the Team ribbon menu, an additional Project field, which is labeled Work Item Type, becomes available. This field, with a default Project field of Text24, supports mapping of project plans that are bound to Team Foundation but does not support synchronizing plans. The Text24-based field contains the full list of work item types for the team project. You can verify that you have the correct field by hovering over it and verifying that Text30 appears.

Invalid Work Item Type

Automatically Corrected

If you change the value that is assigned to the Work Item Type, Project reassigns the value that was defined when the task was first published. You cannot change the value of the work item type for a task after it has been published to Team Foundation Server.

Link error in Publish to Team Project

Automatically Corrected

Project changes the value of the Publish to Team Project field to Yes in the following instances:

  • After a work item has been submitted from Team Foundation Server, approved, and accepted into the plan, it must continue to be published.

  • After a task has been published to Team Foundation Server, it must continue to be published. You must delete a task from the project plan to stop publishing it.

  • If any child tasks of a published parent task are set to publish, all child tasks must be set to publish.

In addition to the errors that the previous table describes, you must resolve the following errors before you can publish the enterprise project plan.

Resolving a Data Validation Error

You can use the Validation Resolution dialog box to resolve the data validation errors that appear in the Unpublished work items list.

To correct an invalid work item type

  1. Click the row that contains the Invalid Work Item Type issue, click Choose Values, and then specify the type of work item that you want to associate with the task.

    Choose a valid work item type

    Note

    The add-in for Project Server Integration validates the task field assignments against the work item type rules when they are published.

  2. If no more issues occur, click Save and Publish.

To correct other data validation issues

  1. In the Unpublished work items list, click the row for each work item that you want to correct.

    1. Review the information that appears under Details, and then click Correct this error.

    2. In the work item form that appears, review the information, and correct the value.

    3. Click Close to save your changes and close the work item form.

  2. After you correct all data validation errors, click Save and Publish.

    Note

    This step publishes only the work items that you corrected. You cannot publish a plan until you resolve each data validation error.

  3. Click Close.

See Also

Concepts

Delete Tasks and Removing Work Items That Are No Longer Participating in Synchronization

Other Resources

Managing Projects Using Project Professional Mapped to a Team Project