Adding a Connection to Microsoft Project

To add a connection to Microsoft Project:

1. In the application console, navigate to the Connections page.
2. At the Add Connections panel, select the icon for the connection you want to add.
3. If the Microsoft Project icon is not available, click the Add More icon to download and install the Microsoft Project connector from the CData site.

For required properties, see the Settings tab.

For connection properties that are not typically required, see the Advanced tab.

Connecting to Microsoft Project

To connect to the Microsoft Project data source, set these connection properties:

• Url: A valid Microsoft Project Web App URL, such as http://contoso.com/sites/pwa/.
• Schema: Either ODataV1 or ODataV2 (default). While ODataV2 can be used for full CRUD operations, ODataV1, which provides more granular data and exposes the custom fields, is superior for reporting purposes. For more information about the available functionality in each Schema, see Data Model.
• ProjectId (optional): If the Schema is ODataV2, you can use this property to specify a default Project Id for all the operations that require one.

Authenticating to Microsoft Project

There are several authentication methods available for connecting to Microsoft Project, including the SharePoint Online Cookie Service, ADFS, OAuth, and SSO. The supported SSO identity providers are Azure AD, OneLogin, and OKTA.

SharePoint Online Cookie Service

To use your login credentials to connect to Microsoft Project on SharePoint Online, set the AuthScheme to SharePointOnlineCookies, User to your user login, and Password to your user login password.

OAuth

To enable this authentication from all Microsoft Project OAuth flows, you must create a custom OAuth application, and set AuthScheme to OAuth.

The following subsections describe how to authenticate to Microsoft Project from three common authentication flows. For information about how to create a custom OAuth application, see Creating a Custom OAuth Application. For a complete list of connection string properties available in Microsoft Project, see Connection.

Automatic refresh of the OAuth access token:

To have the Sync App automatically refresh the OAuth access token:

1. Before connecting to data for the first time, set these connection parameters:
   • InitiateOAuth: REFRESH.
   • OAuthClientId: The client Id in your application settings.
   • OAuthClientSecret: The client secret in your application settings.
   • OAuthAccessToken: The access token returned by GetOAuthAccessToken.
   • OAuthSettingsLocation: The path where you want the Sync App to save the OAuth values, which persist across connections.
2. On subsequent data connections, set:
   • InitiateOAuth
   • OAuthSettingsLocation

Manual refresh of the OAuth access token:

The only value needed to manually refresh the OAuth access token is the OAuth refresh token.

1. To manually refresh the OAuthAccessToken after the ExpiresIn period (returned by GetOAuthAccessToken) has elapsed, call the RefreshOAuthAccessToken stored procedure.
2. Set these connection properties:
   • OAuthClientId: The Client Id in your application settings.
   • OAuthClientSecret: The Client Secret in your application settings.

3. Call RefreshOAuthAccessToken with OAuthRefreshToken set to the OAuth refresh token returned by GetOAuthAccessToken.
4. After the new tokens have been retrieved, set the OAuthAccessToken property to the value returned by RefreshOAuthAccessToken. This opens a new connection.

Store the OAuth refresh token so that you can use it to manually refresh the OAuth access token after it has expired.

ADFS

To connect to ADFS, set the AuthScheme to ADFS, and set these properties:

• User: The ADFS user.
• Password: The ADFS user's password.
• SSOLoginURL: The SSO provider's login url.

Example connection string:

AuthScheme=ADFS;User=username;Password=password;SSOLoginURL='https://sts.company.com';

ADFS Integrated

The ADFS Integrated flow indicates you are connecting with the currently logged in Windows user credentials. To use the ADFS Integrated flow, do not specify the User and Password, but otherwise follow the same steps in the ADFS guide above.

Supported SSO Providers

Okta

To connect to Okta, set the AuthScheme to Okta, and set these properties:

• User: The Okta user.
• Password: The Okta user's password.
• SSOLoginURL: The SSO provider's login URL.

If you are using a trusted application or proxy that overrides the Okta client request OR configuring MFA, you must use combinations of SSOProperties to authenticate using Okta. Set any of the following, as applicable:

• APIToken: When authenticating a user via a trusted application or proxy that overrides the Okta client request context, set this to the API Token the customer created from the Okta organization.
• MFAType: If you have configured the MFA flow, set this to one of the following supported types: OktaVerify, Email, or SMS.
• MFAPassCode: If you have configured the MFA flow, set this to a valid passcode.
  If you set this to empty or an invalid value, the Sync App issues a one-time password challenge to your device or email. After the passcode is received, reopen the connection where the retrieved one-time password value is set to the MFAPassCode connection property.
• MFARememberDevice: True by default. Okta supports remembering devices when MFA is required. If remembering devices is allowed according to the configured authentication policies, the Sync App sends a device token to extend MFA authentication lifetime. If you do not want MFA to be remembered, set this variable to False.

Example connection string:

AuthScheme=Okta;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;

OneLogin

To connect to OneLogin, set the AuthScheme to OneLogin, and set these properties:

• User: The OneLogin user.
• Password: The OneLogin user's password.

To authenticate to OneLogin, set these SSOProperties:

• OAuthClientId: The OAuthClientId, which can be obtained by selecting Developers > API Credentials > Credential > ClientId.
• OAuthClientSecret: The OAuthClientSecret, which can be obtained by selecting Developers > API Credentials > Credential > ClientSecret.
• Subdomain: The subdomain of the OneLogin user accessing the SSO application. For example, if your OneLogin URL is splinkly.onelogin.com, splinkly is the subdomain value.
• AppId: The Id of the SSO application.
• Region (optional): The region your OneLogin account resides in. Legal values are US (default) or EU.

The following example connection string uses an API key to connect to OneLogin:

AuthScheme=OneLogin;User=OneLoginUserName;Password=OneLoginPassword;SSOProperties='OAuthClientID=3fc8394584f153ce3b7924d9cd4f686443a52b;OAuthClientSecret=ca9257fd5cc3277abb5818cea28c06fe9b3b285d73d06;Subdomain=OneLoginSubDomain;AppId=1433920';

Azure AD

This configuration requires two separate Azure AD applications:

• The "Microsoft Project" application used for single sign-on, and
• A custom OAuth application with user_impersonation permission on the "Microsoft Project" application. (See Creating a Custom OAuth Application.)

To connect to Azure AD, set the AuthScheme to AzureAD, and set these properties:

• OAuthClientId: The application Id of the connector application, listed in the Overview section of the app registration.
• OAuthClientSecret: The client secret value of the connector application. Azure AD displays this when you create a new client secret.
• CallbackURL: The redirect URI of the connector application. For example: https://localhost:33333.

To authenticate to Azure AD, set these SSOProperties:

• Resource: The application Id URI of the Microsoft Project application, listed in the app registration's Overview section. In most cases this is the URL of your custom Microsoft Project domain.
• AzureTenant: The Id of the Azure AD tenant where the applications are registered.

Example connection string:

AuthScheme=AzureAD;OAuthClientId=3ea1c786-d527-4399-8c3b-2e3696ae4b48;OauthClientSecret=xxx;CallbackUrl=https://localhost:33333;SSOProperties='Resource=;AzureTenant=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';

There have been some changes made to the Sync App in the 2020 edition that should be taken into consideration.

CSOM Support Discontinued

Prior to the 2020 edition of the Sync App, connections to Microsoft Project using both the CSOM and OData interface were supported, which lead to difficulties in maintaining the two schemas concurrently.

By removing support for the CSOM, connections to Microsoft Project are streamlined due to the lack of special connection properties made specifically for each schema. Also, the OData interface can now perform all of the same CRUD operations that the CSOM is capable of. Lastly, the CSOM is poorly documented and more error-prone than OData.

For these reasons, the decision was made to deprecate support for the CSOM in favor of exclusively supporting the OData interface.

This section details a selection of advanced features of the Microsoft Project Sync App.

User Defined Views

The Sync App allows you to define virtual tables, called user defined views, whose contents are decided by a pre-configured query. These views are useful when you cannot directly control queries being issued to the drivers. See User Defined Views for an overview of creating and configuring custom views.

SSL Configuration

Use SSL Configuration to adjust how Sync App handles TLS/SSL certificate negotiations. You can choose from various certificate formats; see the SSLServerCert property under "Connection String Options" for more information.

Firewall and Proxy

Configure the Sync App for compliance with Firewall and Proxy, including Windows proxies and HTTP proxies. You can also set up tunnel connections.

Query Processing

The Sync App offloads as much of the SELECT statement processing as possible to Microsoft Project and then processes the rest of the query in memory (client-side).

See Query Processing for more information.

Logging

See Logging for an overview of configuration settings that can be used to refine CData logging. For basic logging, you only need to set two connection properties, but there are numerous features that support more refined logging, where you can select subsets of information to be logged using the LogModules connection property.

Customizing the SSL Configuration

By default, the Sync App attempts to negotiate SSL/TLS by checking the server's certificate against the system's trusted certificate store.

To specify another certificate, see the SSLServerCert property for the available formats to do so.

Connecting Through a Firewall or Proxy

HTTP Proxies

To connect through the Windows system proxy, you do not need to set any additional connection properties. To connect to other proxies, set ProxyAutoDetect to false.

In addition, to authenticate to an HTTP proxy, set ProxyAuthScheme, ProxyUser, and ProxyPassword, in addition to ProxyServer and ProxyPort.

Other Proxies

Set the following properties:

• To use a proxy-based firewall, set FirewallType, FirewallServer, and FirewallPort.
• To tunnel the connection, set FirewallType to TUNNEL.
• To authenticate, specify FirewallUser and FirewallPassword.
• To authenticate to a SOCKS proxy, additionally set FirewallType to SOCKS5.

Overview

The CData Sync App models Microsoft Project objects as relational tables and views. A Microsoft Project object has relationships to other objects; in the tables, these relationships are expressed through foreign keys.

Connecting with the ODataV2 Schema

The ODataV2 Data Model (default) can be used for full CRUD operations. Main columns metadata is dynamically retrieved for each entity, but the schema is fixed and custom fields are not included.

Tables and Views describe a sample the tables available in the ODataV2 API.

Connecting with the ODataV1 Schema

The ODataV1 Data Model can only be used for reading data. Metadata is dynamically retrieved, including the custom fields for this schema.

Views describe a sample the views available in the ODataV1 API.

Key Features

• The Sync App models Microsoft Project entities as relational tables and views, allowing you to write SQL to query Microsoft Project data.
• Stored procedures allow you to execute operations to Microsoft Project.
• Live connectivity to these objects means any changes to your Microsoft Project account are immediately reflected when using the Sync App.

The ODataV2 schema implements the ProjectServer service endpoints, which has support for full CRUD operations.

Tables

Tables are retrieved dynamically from the authenticated Microsoft Project account.

Views

Read-only Views are retrieved dynamically from the authenticated Microsoft Project account.

Stored Procedures

Stored Procedures are function-like interfaces to Microsoft Project. Stored procedures allow you to execute operations to Microsoft Project.

ODataV2 advantages compared to ODataV1

• Supports write operations (INSERT, UPDATE and DELETE) on the exposed tables.

ODataV2 limitations

• In order to query some tables and views, such as Assignments, ProjectResources, TaskLinks and Tasks, the ProjectId must be specified either in the query's WHERE clause criteria or via the ProjectId connection property.
• The custom fields are not exposed.

The Sync App models the data in Microsoft Project as a list of tables in a relational database that can be queried using standard SQL statements.

Microsoft Project Connector for CData Sync Tables

Name	Description
Assignments	Retrieve and modify assignments.
Calendars	Retrieve and modify calendars.
EnterpriseResources	Retrieve and modify resources.
Phases	Retrieve and modify project phases.
ProjectResources	Retrieve and modify project resources.
Projects	Retrieve and modify projects.
Stages	Retrieve and modify project stages.
TaskLinks	Retrieve and modify task links.
Tasks	Retrieve and modify tasks.
TimeSheetLines	Retrieve and modify timesheets.
TimeSheets	Retrieve and modify timesheets.

Retrieve and modify assignments.

Table Specific Information

To query this table, the ProjectId must be specified either in the query's WHERE clause criteria or via the ProjectId connection property.

SELECT * FROM Assignments WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	True		False
ActualCostWorkPerformed	Double	True		False
ActualOvertimeCost	Double	True		False
BaselineCost	Double	True		False
BaselineCostPerUse	Double	True		False
BaselineFinish	Datetime	True		False
BaselineStart	Datetime	True		False
BaselineWork	String	True		False
BaselineWorkMilliseconds	Int	True		False
BaselineWorkTimeSpan	Time	True		False
BudgetedCostWorkPerformed	Double	True		False
BudgetedCostWorkScheduled	Double	True		False
CostVariance	Double	True		False
CostVarianceAtCompletion	Double	True		False
Created	Datetime	True		False
CurrentCostVariance	Double	True		False
Finish	Datetime	True		False
FinishVariance	String	True		False
FinishVarianceMilliseconds	Int	True		False
FinishVarianceTimeSpan	Time	True		False
IsConfirmed	Bool	True		False
IsOverAllocated	Bool	True		False
IsPublished	Bool	True		False
IsResponsePending	Bool	True		False
IsUpdateNeeded	Bool	True		False
LevelingDelay	String	True		False
LevelingDelayMilliseconds	Int	True		False
LevelingDelayTimeSpan	Time	True		False
Modified	Datetime	True		False
Notes	String	True		False
OvertimeCost	Double	True		False
RemainingCost	Double	True		False
RemainingOvertimeCost	Double	True		False
Resume	Datetime	True		False
ScheduleCostVariance	Double	True		False
Start	Datetime	True		False
StartVariance	String	True		False
StartVarianceMilliseconds	Int	True		False
StartVarianceTimeSpan	Time	True		False
Stop	Datetime	True		False
WorkContourType	Int	True		False
WorkVariance	String	True		False
WorkVarianceMilliseconds	Int	True		False
WorkVarianceTimeSpan	Time	True		False
LinkedCustomFields	String	False		False
ActualCost	Double	False		False
ActualFinish	Datetime	False		False
ActualOvertimeWork	String	False		False
ActualOvertimeWorkMilliseconds	Int	False		False
ActualOvertimeWorkTimeSpan	Time	False		False
ActualStart	Datetime	False		False
ActualWork	String	False		False
ActualWorkMilliseconds	Int	False		False
ActualWorkTimeSpan	Time	False		False
BudgetedCost	Double	False		False
BudgetedWork	String	False		False
BudgetedWorkMilliseconds	Int	False		False
BudgetedWorkTimeSpan	Time	False		False
Cost	Double	False		False
CostRateTable	Int	False		False
DefaultBookingType	Int	False		False
Delay	String	False		False
DelayMilliseconds	Int	False		False
DelayTimeSpan	Time	False		False
IsLockedByManager	Bool	False		False
IsWorkResource	Bool	False		False
OvertimeWork	String	False		False
OvertimeWorkMilliseconds	Int	False		False
OvertimeWorkTimeSpan	Time	False		False
PercentWorkComplete	Int	False		False
RegularWork	String	False		False
RegularWorkMilliseconds	Int	False		False
RegularWorkTimeSpan	Time	False		False
RemainingOvertimeWork	String	False		False
RemainingOvertimeWorkMilliseconds	Int	False		False
RemainingOvertimeWorkTimeSpan	Time	False		False
RemainingWork	String	False		False
RemainingWorkMilliseconds	Int	False		False
RemainingWorkTimeSpan	Time	False		False
ResourceCapacity	Double	False		False
ResourceId	String	False		False
TaskId	String	False		False
Work	String	False		False
WorkMilliseconds	Int	False		False
WorkTimeSpan	Time	False		False
LinkedOwner	String	False		False
LinkedParent	String	False		False
LinkedResource	String	False		False
LinkedTask	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent.

Retrieve and modify calendars.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
Created	Datetime	False		False
IsStandardCalendar	Bool	False		False
Modified	Datetime	False		False
Name	String	False		False
OriginalId	String	False		False
LinkedBaseCalendarExceptions	String	False		False

Retrieve and modify resources.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
CanLevel	Bool	False		False
Code	String	False		False
CostAccrual	Int	False		False
CostCenter	String	False		False
Created	Datetime	False		False
DefaultBookingType	Int	False		False
Email	String	False		False
ExternalId	String	False		False
Group	String	False		False
HireDate	Datetime	False		False
HyperlinkName	String	False		False
HyperlinkUrl	String	False		False
Initials	String	False		False
IsActive	Bool	False		False
IsBudget	Bool	False		False
IsCheckedOut	Bool	False		False
IsGeneric	Bool	False		False
IsTeam	Bool	False		False
MaterialLabel	String	False		False
Modified	Datetime	False		False
Name	String	False		False
Phonetics	String	False		False
RequiresEngagements	Bool	False		False
ResourceIdentifier	Int	False		False
ResourceType	Int	False		False
TerminationDate	Datetime	False		False
LinkedAssignments	String	False		False
LinkedBaseCalendar	String	False		False
LinkedCostRateTables	String	False		False
LinkedCustomFields	String	False		False
LinkedDefaultAssignmentOwner	String	False		False
LinkedEngagements	String	False		False
LinkedResourceCalendarExceptions	String	False		False
LinkedSelf	String	False		False
LinkedTimesheetManager	String	False		False
LinkedUser	String	False		False
LinkedUserPermissions	String	False		False

Retrieve and modify project phases.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
Description	String	False		False
Name	String	False		False
LinkedStages	String	False		False

Retrieve and modify project resources.

Table Specific Information

To query this table, the ProjectId must be specified either in the query's WHERE clause criteria or via the ProjectId connection property.

SELECT * FROM ProjectResources WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	True		False
ActualCost	Double	True		False
ActualCostWorkPerformed	String	True		False
ActualCostWorkPerformedMilliseconds	Int	True		False
ActualCostWorkPerformedTimeSpan	Time	True		False
ActualOvertimeCost	Double	True		False
ActualOvertimeWork	String	True		False
ActualOvertimeWorkMilliseconds	Int	True		False
ActualOvertimeWorkTimeSpan	Time	True		False
ActualWork	String	True		False
ActualWorkMilliseconds	Int	True		False
ActualWorkTimeSpan	Time	True		False
AvailableFrom	Datetime	True		False
AvailableTo	Datetime	True		False
BaselineCost	Double	True		False
BaselineWork	String	True		False
BaselineWorkMilliseconds	Int	True		False
BaselineWorkTimeSpan	Time	True		False
BudetCostWorkPerformed	Double	True		False
BudgetedCost	Double	True		False
BudgetedCostWorkScheduled	Double	True		False
BudgetedWork	String	True		False
BudgetedWorkMilliseconds	Int	True		False
BudgetedWorkTimeSpan	Time	True		False
Cost	Double	True		False
CostVariance	Double	True		False
CostVarianceAtCompletion	Double	True		False
Created	Datetime	True		False
CurrentCostVariance	Double	True		False
Finish	Datetime	True		False
IsBudgeted	Bool	True		False
IsGenericResource	Bool	True		False
IsOverAllocated	Bool	True		False
Modified	Datetime	True		False
Notes	String	True		False
OvertimeCost	Double	True		False
OvertimeWork	String	True		False
OvertimeWorkMilliseconds	Int	True		False
OvertimeWorkTimeSpan	Time	True		False
PeakWork	String	True		False
PeakWorkMilliseconds	Int	True		False
PeakWorkTimeSpan	Time	True		False
PercentWorkComplete	Int	True		False
RegularWork	String	True		False
RegularWorkMilliseconds	Int	True		False
RegularWorkTimeSpan	Time	True		False
RemainingCost	Double	True		False
RemainingOvertimeCost	Double	True		False
RemainingOvertimeWork	String	True		False
RemainingOvertimeWorkMilliseconds	Int	True		False
RemainingOvertimeWorkTimeSpan	Time	True		False
RemainingWork	String	True		False
RemainingWorkMilliseconds	Int	True		False
RemainingWorkTimeSpan	Time	True		False
ScheduleCostVariance	Double	True		False
Start	Datetime	True		False
Work	String	True		False
WorkMilliseconds	Int	True		False
WorkTimeSpan	Time	True		False
WorkVariance	String	True		False
WorkVarianceMilliseconds	Int	True		False
WorkVarianceTimeSpan	Time	True		False
LinkedCustomFields	String	False		False
LinkedEnterpriseResource	String	False		False
CanLevel	Bool	False		False
Code	String	False		False
CostAccrual	Int	False		False
CostCenter	String	False		False
CostPerUse	Double	False		False
DefaultBookingType	Int	False		False
Email	String	False		False
Group	String	False		False
Initials	String	False		False
MaterialLabel	String	False		False
MaximumCapacity	Double	False		False
Name	String	False		False
OvertimeRate	Double	False		False
OvertimeRateUnits	Int	False		False
Phonetics	String	False		False
StandardRate	Double	False		False
StandardRateUnits	Int	False		False
LinkedAssignments	String	False		False
LinkedDefaultAssignmentOwner	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent.

Retrieve and modify projects.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	True		False
ApprovedEnd	Datetime	True		False
ApprovedStart	Datetime	True		False
CalculateActualCosts	Bool	True		False
CalculatesActualCosts	Bool	True		False
CheckedOutDate	Datetime	True		False
CheckOutDescription	String	True		False
CheckOutId	String	True		False
CreatedDate	Datetime	True		False
CriticalSlackLimit	Int	True		False
DefaultFinishTime	Datetime	True		False
DefaultOvertimeRateUnits	Int	True		False
DefaultStandardRateUnits	Int	True		False
DefaultStartTime	Datetime	True		False
HasMppPendingImport	Bool	True		False
HonorConstraints	Bool	True		False
IsCheckedOut	Bool	True		False
LastPublishedDate	Datetime	True		False
LastSavedDate	Datetime	True		False
ListId	String	True		False
MoveActualIfLater	Bool	True		False
MoveActualToStatus	Bool	True		False
MoveRemainingIfEarlier	Bool	True		False
MoveRemainingToStatus	Bool	True		False
MultipleCriticalPaths	Bool	True		False
OptimizerDecision	Int	True		False
PercentComplete	Int	True		False
PlannerDecision	Int	True		False
ProjectSiteUrl	String	True		False
ProjectType	Int	True		False
SplitInProgress	Bool	True		False
SpreadActualCostsToStatus	Bool	True		False
SpreadPercentCompleteToStatus	Bool	True		False
SummaryTaskId	String	True		False
TaskListId	String	True		False
WebId	String	True		False
LinkedCheckedOutBy	String	False		False
LinkedCustomFields	String	False		False
LinkedEngagements	String	False		False
LinkedEnterpriseProjectType	String	False		False
LinkedPhase	String	False		False
LinkedProjectSummaryTask	String	False		False
LinkedQueueJobs	String	False		False
LinkedStage	String	False		False
LinkedUserPermissions	String	False		False
CurrencyCode	String	False		False
CurrencyDigits	Int	False		False
CurrencyPosition	Int	False		False
CurrencySymbol	String	False		False
CurrentDate	Datetime	False		False
DaysPerMonth	Int	False		False
DefaultEffortDriven	Bool	False		False
DefaultEstimatedDuration	Bool	False		False
DefaultFixedCostAccrual	Int	False		False
DefaultOvertimeRate	Double	False		False
DefaultStandardRate	Double	False		False
DefaultTaskType	Int	False		False
DefaultWorkFormat	Int	False		False
Description	String	False		False
FinishDate	Datetime	False		False
FiscalYearStartMonth	Int	False		False
MinutesPerDay	Int	False		False
MinutesPerWeek	Int	False		False
Name	String	False		False
NewTasksAreManual	Bool	False		False
NumberFiscalYearFromStart	Bool	False		False
OwnerId	String	False		False
ProjectIdentifier	String	False		False
ProtectedActualsSynch	Bool	False		False
ScheduledFromStart	Bool	False		False
ShowEstimatedDurations	Bool	False		False
StartDate	Datetime	False		False
StatusDate	Datetime	False		False
TrackingMode	Int	False		False
UtilizationDate	Datetime	False		False
UtilizationType	Int	False		False
WeekStartDay	Int	False		False
WinprojVersion	Decimal	False		False
LinkedAssignments	String	False		False
LinkedCalendar	String	False		False
LinkedIncludeCustomFields	String	False		False
LinkedOwner	String	False		False
LinkedProjectResources	String	False		False
LinkedTaskLinks	String	False		False
LinkedTasks	String	False		False

Retrieve and modify project stages.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
Behavior	Int	False		False
CheckInRequired	Bool	False		False
Description	String	False		False
Name	String	False		False
SubmitDescription	String	False		False
LinkedCustomFields	String	False		False
LinkedPhase	String	False		False
LinkedProjectDetailPages	String	False		False
LinkedWorkflowStatusPage	String	False		False

Retrieve and modify task links.

Table Specific Information

To query this table, the ProjectId must be specified either in the query's WHERE clause criteria or via the ProjectId connection property.

SELECT * FROM TaskLinks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	True		False
DependencyType	Int	False		False
EndId	String	False		False
LinkLagDuration	String	False		False
StartId	String	False		False
LinkedEnd	String	False		False
LinkedStart	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent.
PredecessorTaskId	String	True		False	Id of the preceding task.
SuccessorTaskId	String	True		False	Id of the succeeding task.

Retrieve and modify tasks.

Table Specific Information

To query this table, the ProjectId must be specified either in the query's WHERE clause criteria or via the ProjectId connection property.

SELECT * FROM Tasks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	True		False
ActualCostWorkPerformed	Double	True		False
ActualDuration	String	True		False
ActualDurationMilliseconds	Int	True		False
ActualDurationTimeSpan	Time	True		False
ActualOvertimeCost	Double	True		False
ActualOvertimeWork	String	True		False
ActualOvertimeWorkMilliseconds	Int	True		False
ActualOvertimeWorkTimeSpan	Time	True		False
BaselineCost	Double	True		False
BaselineDuration	String	True		False
BaselineDurationMilliseconds	Int	True		False
BaselineDurationTimeSpan	Time	True		False
BaselineFinish	Datetime	True		False
BaselineStart	Datetime	True		False
BaselineWork	String	True		False
BaselineWorkMilliseconds	Int	True		False
BaselineWorkTimeSpan	Time	True		False
BudgetCost	Double	True		False
BudgetedCostWorkPerformed	Double	True		False
BudgetedCostWorkScheduled	Double	True		False
Contact	String	True		False
CostPerformanceIndex	Double	True		False
CostVariance	Double	True		False
CostVarianceAtCompletion	Double	True		False
CostVariancePercentage	Int	True		False
Created	Datetime	True		False
CurrentCostVariance	Double	True		False
DurationVariance	String	True		False
DurationVarianceMilliseconds	Int	True		False
DurationVarianceTimeSpan	Time	True		False
EarliestFinish	Datetime	True		False
EarliestStart	Datetime	True		False
EstimateAtCompletion	Double	True		False
ExternalProjectUid	String	True		False
ExternalTaskUid	String	True		False
FinishSlack	String	True		False
FinishSlackMilliseconds	Int	True		False
FinishSlackTimeSpan	Time	True		False
FinishVariance	String	True		False
FinishVarianceMilliseconds	Int	True		False
FinishVarianceTimeSpan	Time	True		False
FixedCostAccrual	Int	True		False
FreeSlack	String	True		False
FreeSlackMilliseconds	Int	True		False
FreeSlackTimeSpan	Time	True		False
IgnoreResourceCalendar	Bool	True		False
IsCritical	Bool	True		False
IsDurationEstimate	Bool	True		False
IsExternalTask	Bool	True		False
IsOverAllocated	Bool	True		False
IsRecurring	Bool	True		False
IsRecurringSummary	Bool	True		False
IsRolledUp	Bool	True		False
IsSubProject	Bool	True		False
IsSubProjectReadOnly	Bool	True		False
IsSubProjectScheduledFromFinish	Bool	True		False
IsSummary	Bool	True		False
LatestFinish	Datetime	True		False
LatestStart	Datetime	True		False
LevelingDelay	String	True		False
LevelingDelayMilliseconds	Int	True		False
LevelingDelayTimeSpan	Time	True		False
Modified	Datetime	True		False
Notes	String	True		False
OutlinePosition	String	True		False
OvertimeCost	Double	True		False
OvertimeWork	String	True		False
OvertimeWorkMilliseconds	Int	True		False
OvertimeWorkTimeSpan	Time	True		False
PercentWorkComplete	Int	True		False
PreLevelingFinish	Datetime	True		False
PreLevelingStart	Datetime	True		False
RegularWork	String	True		False
RegularWorkMilliseconds	Int	True		False
RegularWorkTimeSpan	Time	True		False
RemainingCost	Double	True		False
RemainingOvertimeCost	Double	True		False
RemainingOvertimeWork	String	True		False
RemainingOvertimeWorkMilliseconds	Int	True		False
RemainingOvertimeWorkTimeSpan	Time	True		False
RemainingWork	String	True		False
RemainingWorkMilliseconds	Int	True		False
RemainingWorkTimeSpan	Time	True		False
Resume	Datetime	True		False
ScheduleCostVariance	Double	True		False
ScheduledDuration	String	True		False
ScheduledDurationMilliseconds	Int	True		False
ScheduledDurationTimeSpan	Time	True		False
ScheduledFinish	Datetime	True		False
ScheduledStart	Datetime	True		False
SchedulePerformanceIndex	Double	True		False
ScheduleVariancePercentage	Int	True		False
StartSlack	String	True		False
StartSlackMilliseconds	Int	True		False
StartSlackTimeSpan	Time	True		False
StartVariance	String	True		False
StartVarianceMilliseconds	Int	True		False
StartVarianceTimeSpan	Time	True		False
Stop	Datetime	True		False
ToCompletePerformanceIndex	Double	True		False
TotalSlack	String	True		False
TotalSlackMilliseconds	Int	True		False
TotalSlackTimeSpan	Time	True		False
WorkBreakdownStructure	String	True		False
WorkVariance	String	True		False
WorkVarianceMilliseconds	Int	True		False
WorkVarianceTimeSpan	Time	True		False
LinkedCustomFields	String	False		False
LinkedSubProject	String	False		False
ActualCost	Double	False		False
ActualFinish	Datetime	False		False
ActualStart	Datetime	False		False
ActualWork	String	False		False
ActualWorkMilliseconds	Int	False		False
ActualWorkTimeSpan	Time	False		False
AddAfterId	String	False		False
BudgetWork	String	False		False
BudgetWorkMilliseconds	Int	False		False
BudgetWorkTimeSpan	Time	False		False
Completion	Datetime	False		False
ConstraintStartEnd	Datetime	False		False
ConstraintType	Int	False		False
Cost	Double	False		False
Deadline	Datetime	False		False
Duration	String	False		False
DurationMilliseconds	Int	False		False
DurationTimeSpan	Time	False		False
Finish	Datetime	False		False
FinishText	String	False		False
FixedCost	Double	False		False
IsActive	Bool	False		False
IsEffortDriven	Bool	False		False
IsLockedByManager	Bool	False		False
IsManual	Bool	False		False
IsMarked	Bool	False		False
IsMilestone	Bool	False		False
LevelingAdjustsAssignments	Bool	False		False
LevelingCanSplit	Bool	False		False
Name	String	False		False
OutlineLevel	Int	False		False
ParentId	String	False		False
PercentComplete	Int	False		False
PercentPhysicalWorkComplete	Int	False		False
Priority	Int	False		False
RemainingDuration	String	False		False
RemainingDurationMilliseconds	Int	False		False
RemainingDurationTimeSpan	Time	False		False
Start	Datetime	False		False
StartText	String	False		False
TaskType	Int	False		False
UsePercentPhysicalWorkComplete	Bool	False		False
Work	String	False		False
WorkMilliseconds	Int	False		False
WorkTimeSpan	Time	False		False
LinkedAssignments	String	False		False
LinkedCalendar	String	False		False
LinkedParent	String	False		False
LinkedPredecessors	String	False		False
LinkedStatusManager	String	False		False
LinkedSuccessors	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent.

Retrieve and modify timesheets.

Columns

Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
Comment	String	False		False
LineClass	Int	False		False
ProjectName	String	False		False
Status	Int	False		False
TaskName	String	False		False
TotalWork	String	False		False
TotalWorkMilliseconds	Int	False		False
TotalWorkTimeSpan	Time	False		False
ValidationType	Int	False		False
LinkedAssignment	String	False		False
LinkedTimeSheet	String	False		False
LinkedWork	String	False		False
PeriodId [KEY]	String	True		False	Id of the parent.

Retrieve and modify timesheets.

Columns

Name	Type	ReadOnly	References	Required	Description
PeriodId [KEY]	String	False		False
Comments	String	False		False
EntryMode	Int	False		False
IsControlledByOwner	Bool	False		False
IsProcessed	Bool	False		False
Name	String	False		False
Status	Int	False		False
TotalActualWork	String	False		False
TotalActualWorkMilliseconds	Int	False		False
TotalActualWorkTimeSpan	Time	False		False
TotalNonBillableOvertimeWork	String	False		False
TotalNonBillableOvertimeWorkMilliseconds	Int	False		False
TotalNonBillableOvertimeWorkTimeSpan	Time	False		False
TotalNonBillableWork	String	False		False
TotalNonBillableWorkMilliseconds	Int	False		False
TotalNonBillableWorkTimeSpan	Time	False		False
TotalOvertimeWork	String	False		False
TotalOvertimeWorkMilliseconds	Int	False		False
TotalOvertimeWorkTimeSpan	Time	False		False
TotalWork	String	False		False
TotalWorkMilliseconds	Int	False		False
TotalWorkTimeSpan	Time	False		False
WeekStartsOn	Int	False		False
LinkedCreator	String	False		False
LinkedLines	String	False		False
LinkedManager	String	False		False
LinkedPeriod	String	False		False

Views are similar to tables in the way that data is represented; however, views are read-only.

Queries can be executed against a view as if it were a normal table.

Microsoft Project Connector for CData Sync Views

Name	Description
Assignment_Resource	Retrieve and modify assignments.
Assignment_Task	Retrieve and modify assignments.
Events	Retrieve events.
ProjectDetailPages	Retrieve project details.
StageDetailPages	Retrieve project details..
Tasks_Assignments	Retrieve and modify assignments.
Tasks_Calendar	Retrieve and modify assignments.
TimeSheetPeriods	Retrieve timesheet periods.

Retrieve and modify assignments.

Columns

Name	Type	References	Description
Id [KEY]	String		The Id of the table.
Name	String		The name of the association.
ProjectId	String		The project Id.
AssignmentId	String		The assignment Id.

Retrieve and modify assignments.

Columns

Name	Type	References	Description
Id [KEY]	String		The Id of the table.
Name	String		The name of the association.
ProjectId	String		The project Id.
AssignmentId	String		The assignment Id.

Retrieve events.

Columns

Name	Type	References	Description
Id [KEY]	Int
EventName	String
SourceName	String

Retrieve project details.

Columns

Name	Type	References	Description
Id [KEY]	String
Name	String
PageType	Int
LinkedItem	String

Retrieve project details..

Columns

Name	Type	References	Description
Id [KEY]	String
Name	String
PageType	Int
LinkedItem	String
StageId [KEY]	String		Id of the parent.

Retrieve and modify assignments.

Columns

Name	Type	References	Description
Id [KEY]	String		The Id of the table.
ProjectId	String		The project Id.
TaskId	String		The task Id.

Retrieve and modify assignments.

Columns

Name	Type	References	Description
Id [KEY]	String		The Id of the table.
Name	String		The name of the association.
ProjectId	String		The project Id.
TaskId	String		The task Id.

Retrieve timesheet periods.

Columns

Name	Type	References	Description
Id [KEY]	String
End	Datetime
Name	String
Start	Datetime
LinkedTimeSheet	String

The ODataV1 schema implement the ProjectData service endpoints, which is read-only and can only be used for reporting.

Views

Read-only Views are retrieved dynamically from the authenticated Microsoft Project account.

Stored Procedures

Stored Procedures are function-like interfaces to Microsoft Project. Stored procedures allow you to execute operations to Microsoft Project.

ODataV1 advantages compared to ODataV2

• The custom fields are exposed as view columns.
• The ProjectId is not required to query any of the exposed views, since the ProjectData endpoints return data for all the available projects.

ODataV1 limitations

• No write operation is supported as this schema is read-only.

Views are similar to tables in the way that data is represented; however, views are read-only.

Queries can be executed against a view as if it were a normal table.

Microsoft Project Connector for CData Sync Views

Name	Description
AssignmentBaselines	Retrieve assignment baselines.
AssignmentBaselineTimephasedDataSet	Retrieve assignment baseline timephased dataset.
Assignments	Retrieve assignments.
AssignmentTimephasedDataSet	Retrieve assignment timephased dataset.
BusinessDriverDepartments	Retrieve business driver departments.
BusinessDrivers	Retrieve business drivers.
CostConstraintScenarios	Retrieve cost constraint scenarios.
CostScenarioProjects	Retrieve cost scenario projects.
Deliverables	Retrieve deliverables.
Engagements	Retrieve engagements.
EngagementsComments	Retrieve engagements comments.
EngagementsTimephasedDataSet	Retrieve engagements timephased dataset.
FiscalPeriods	Retrieve fiscal periods.
Issues	Retrieve issues.
IssueTaskAssociations	Retrieve issue-task associations.
PortfolioAnalyses	Retrieve portfolio analyses.
PortfolioAnalysisProjects	Retrieve portfolio analysis projects.
PrioritizationDriverRelations	Retrieve prioritization driver relations.
PrioritizationDrivers	Retrieve prioritization drivers.
Prioritizations	Retrieve prioritizations.
ProjectBaselines	Retrieve project baselines.
Projects	Retrieve projects.
ProjectWorkflowStageDataSet	Retrieve project workflow stage dataset.
ResourceConstraintScenarios	Retrieve resource constraint scenarios.
ResourceDemandTimephasedDataSet	Retrieve resource demand timephased dataset.
Resources	Retrieve resources.
ResourceScenarioProjects	Retrieve resource scenario projects.
ResourceTimephasedDataSet	Retrieve resource timephased dataset.
Risks	Retrieve risks.
RiskTaskAssociations	Retrieve risk task associations.
TaskBaselines	Retrieve task baselines.
TaskBaselineTimephasedDataSet	Retrieve task baseline timephased dataset.
Tasks	Retrieve tasks.
TaskTimephasedDataSet	Retrieve task timephased dataset.
TimeSet	Retrieve timeset.
TimesheetClasses	Retrieve timesheet classes.
TimesheetLineActualDataSet	Retrieve timesheet line actual dataset.
TimesheetLines	Retrieve timesheet lines.
TimesheetPeriods	Retrieve timesheet periods.
Timesheets	Retrieve timesheets.

Retrieve assignment baselines.

Columns

Name	Type	References	Description
AssignmentId [KEY]	String
BaselineNumber [KEY]	Int
ProjectId [KEY]	String
AssignmentBaselineBudgetCost	Decimal
AssignmentBaselineBudgetMaterialWork	Decimal
AssignmentBaselineBudgetWork	Decimal
AssignmentBaselineCost	Decimal
AssignmentBaselineFinishDate	Datetime
AssignmentBaselineMaterialWork	Decimal
AssignmentBaselineModifiedDate	Datetime
AssignmentBaselineStartDate	Datetime
AssignmentBaselineWork	Decimal
AssignmentType	Int
ProjectName	String
TaskId	String
TaskName	String
LinkedAssignment	String
LinkedAssignmentBaselineTimephasedDataSet	String
LinkedProject	String
LinkedTask	String

Retrieve assignment baseline timephased dataset.

Columns

Name	Type	References	Description
AssignmentId [KEY]	String
BaselineNumber [KEY]	Int
ProjectId [KEY]	String
TimeByDay [KEY]	Datetime
AssignmentBaselineBudgetCost	Decimal
AssignmentBaselineBudgetMaterialWork	Decimal
AssignmentBaselineBudgetWork	Decimal
AssignmentBaselineCost	Decimal
AssignmentBaselineMaterialWork	Decimal
AssignmentBaselineModifiedDate	Datetime
AssignmentBaselineWork	Decimal
FiscalPeriodId	String
ProjectName	String
ResourceId	String
TaskId	String
TaskName	String
LinkedAssignment	String
LinkedBaseline	String
LinkedProject	String
LinkedTasks	String
LinkedTime	String

Retrieve assignments.

Columns

Name	Type	References	Description
AssignmentId [KEY]	String
ProjectId [KEY]	String
AssignmentActualCost	Decimal
AssignmentActualFinishDate	Datetime
AssignmentActualOvertimeCost	Decimal
AssignmentActualOvertimeWork	Decimal
AssignmentActualRegularCost	Decimal
AssignmentActualRegularWork	Decimal
AssignmentActualStartDate	Datetime
AssignmentActualWork	Decimal
AssignmentACWP	Decimal
AssignmentAllUpdatesApplied	Bool
AssignmentBCWP	Decimal
AssignmentBCWS	Decimal
AssignmentBookingDescription	String
AssignmentBookingId	Int
AssignmentBookingName	String
AssignmentBudgetCost	Decimal
AssignmentBudgetMaterialWork	Decimal
AssignmentBudgetWork	Decimal
AssignmentCost	Decimal
AssignmentCostVariance	Decimal
AssignmentCreatedDate	Datetime
AssignmentCreatedRevisionCounter	Int
AssignmentCV	Decimal
AssignmentDelay	Decimal
AssignmentFinishDate	Datetime
AssignmentFinishVariance	Decimal
AssignmentIsOverallocated	Bool
AssignmentIsPublished	Bool
AssignmentMaterialActualWork	Decimal
AssignmentMaterialWork	Decimal
AssignmentModifiedDate	Datetime
AssignmentModifiedRevisionCounter	Int
AssignmentOvertimeCost	Decimal
AssignmentOvertimeWork	Decimal
AssignmentPeakUnits	Decimal
AssignmentPercentWorkCompleted	Int
AssignmentRegularCost	Decimal
AssignmentRegularWork	Decimal
AssignmentRemainingCost	Decimal
AssignmentRemainingOvertimeCost	Decimal
AssignmentRemainingOvertimeWork	Decimal
AssignmentRemainingRegularCost	Decimal
AssignmentRemainingRegularWork	Decimal
AssignmentRemainingWork	Decimal
AssignmentResourcePlanWork	Decimal
AssignmentResourceType	Int
AssignmentStartDate	Datetime
AssignmentStartVariance	Decimal
AssignmentSV	Decimal
AssignmentType	Int
AssignmentUpdatesAppliedDate	Datetime
AssignmentVAC	Decimal
AssignmentWork	Decimal
AssignmentWorkVariance	Decimal
CostType_R	String
FlagStatus_T	Bool
Health_T	String
IsPublic	Bool
ProjectName	String
RBS_R	String
ResourceId	String
ResourceName	String
TaskId	String
TaskIsActive	Bool
TaskName	String
TimesheetClassId	String
TypeDescription	String
TypeName	String
LinkedBaseline	String
LinkedProject	String
LinkedResource	String
LinkedTask	String
LinkedTimephasedData	String

Retrieve assignment timephased dataset.

Columns

Name	Type	References	Description
AssignmentId [KEY]	String
ProjectId [KEY]	String
TimeByDay [KEY]	Datetime
AssignmentActualCost	Decimal
AssignmentActualOvertimeCost	Decimal
AssignmentActualOvertimeWork	Decimal
AssignmentActualRegularCost	Decimal
AssignmentActualRegularWork	Decimal
AssignmentActualWork	Decimal
AssignmentBudgetCost	Decimal
AssignmentBudgetMaterialWork	Decimal
AssignmentBudgetWork	Decimal
AssignmentCombinedWork	Decimal
AssignmentCost	Decimal
AssignmentMaterialActualWork	Decimal
AssignmentMaterialWork	Decimal
AssignmentModifiedDate	Datetime
AssignmentOvertimeCost	Decimal
AssignmentOvertimeWork	Decimal
AssignmentRegularCost	Decimal
AssignmentRegularWork	Decimal
AssignmentRemainingCost	Decimal
AssignmentRemainingOvertimeCost	Decimal
AssignmentRemainingOvertimeWork	Decimal
AssignmentRemainingRegularCost	Decimal
AssignmentRemainingRegularWork	Decimal
AssignmentRemainingWork	Decimal
AssignmentResourcePlanWork	Decimal
AssignmentWork	Decimal
FiscalPeriodId	String
ProjectName	String
ResourceId	String
TaskId	String
TaskIsActive	Bool
TaskName	String
LinkedAssignment	String
LinkedProject	String
LinkedTask	String
LinkedTime	String

Retrieve business driver departments.

Columns

Name	Type	References	Description
BusinessDriverId [KEY]	String
DepartmentId [KEY]	String
BusinessDriverName	String
DepartmentName	String
LinkedBusinessDriver	String

Retrieve business drivers.

Columns

Name	Type	References	Description
BusinessDriverId [KEY]	String
BusinessDriverCreatedDate	Datetime
BusinessDriverDescription	String
BusinessDriverIsActive	Bool
BusinessDriverModifiedDate	Datetime
BusinessDriverName	String
CreatedByResourceId	String
CreatedByResourceName	String
ImpactDescriptionExtreme	String
ImpactDescriptionLow	String
ImpactDescriptionModerate	String
ImpactDescriptionNone	String
ImpactDescriptionStrong	String
ModifiedByResourceId	String
ModifiedByResourceName	String
LinkedCreatedByResource	String
LinkedDepartments	String
LinkedModifiedByResource	String

Retrieve cost constraint scenarios.

Columns

Name	Type	References	Description
ScenarioId [KEY]	String
AnalysisId	String
AnalysisName	String
CreatedByResourceId	String
CreatedByResourceName	String
CreatedDate	Datetime
ModifiedByResourceId	String
ModifiedByResourceName	String
ModifiedDate	Datetime
ScenarioDescription	String
ScenarioName	String
SelectedProjectsCost	Decimal
SelectedProjectsPriority	Double
UnselectedProjectsCost	Decimal
UnselectedProjectsPriority	Double
UseDependencies	Bool
LinkedAnalysis	String
LinkedCostScenarioProjects	String
LinkedCreatedByResource	String
LinkedModifiedByResource	String
LinkedResourceConstraintScenarios	String

Retrieve cost scenario projects.

Columns

Name	Type	References	Description
ProjectId [KEY]	String
ScenarioId [KEY]	String
AbsolutePriority	Double
AnalysisId	String
AnalysisName	String
ForceAliasLookupTableId	String
ForceAliasLookupTableName	String
ForceStatus	Int
HardConstraintValue	Decimal
Priority	Double
ProjectName	String
ScenarioName	String
Status	Int
LinkedAnalysis	String
LinkedCostConstraintScenario	String
LinkedProject	String