Establishing a Connection

Adding a Connection to Microsoft Project

To add a connection to Microsoft Project:

In the application console, navigate to the Connections page.
At the Add Connections panel, select the icon for the connection you want to add.
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 SharePoint Add-in (Legacy OAuth Model). 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:

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.
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.

To manually refresh the OAuthAccessToken after the ExpiresIn period (returned by GetOAuthAccessToken) has elapsed, call the RefreshOAuthAccessToken stored procedure.
Set these connection properties:
- OAuthClientId: The Client Id in your application settings.
- OAuthClientSecret: The Client Secret in your application settings.
Call RefreshOAuthAccessToken with OAuthRefreshToken set to the OAuth refresh token returned by GetOAuthAccessToken.
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 these properties:

AuthScheme: ADFS.
User: The authenticating ADFS user.
Password: The authenticating 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 these properties:

AuthScheme: Okta.
User: The authenticating Okta user.
Password: The authenticating 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 these properties:

AuthScheme: OneLogin.
User: The authenticating OneLogin user.
Password: The authenticating 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

To authenticate using Microsoft Entra ID (formerly Azure Active Directory), set the AuthScheme to AzureAD. This method allows the Sync App to access your Project Web App (PWA) data through SharePoint Online on behalf of a signed-in user using delegated OAuth permissions.

You must create a custom OAuth application in the Azure Portal and configure it with a redirect URI and the necessary delegated permissions. For complete setup instructions, see Creating a Custom Entra ID (Azure AD) Application.

After registering the application, set the following connection properties:

AuthScheme: AzureAD
InitiateOAuth: GETANDREFRESH
OAuthClientId: The client Id assigned when you registered your custom OAuth application.
OAuthClientSecret: The client secret assigned when you registered your custom OAuth application.
URL: The project's web app URL.
CallbackURL: (optional) The redirect URI that was defined when you registered your application. For example, http://localhost:33333 (or your configured redirect URI)
AzureTenant: (optional) The Directory (tenant) ID

If you do not set a custom Scope, the Sync App automatically generates default scopes based on the URL:

https://yourtenant.sharepoint.com/ProjectWebApp.FullControl
https://yourtenant.sharepoint.com/AllSites.FullControl

You can override these by setting a custom Scope value

For example:

AuthScheme=AzureAD;
InitiateOAuth=GETANDREFRESH;
OAuthClientId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;
OAuthClientSecret=xxxxxxxxxxxxxxxxxxxx;
CallbackURL=http://localhost:33333;
URL=https://contoso.sharepoint.com/sites/pwa/;
AzureTenant=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;
Scope=https://contoso.sharepoint.com/ProjectWebApp.FullControl https://contoso.sharepoint.com/AllSites.Read

CSOM Deprecation

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.

Advanced Features

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

User Defined Views

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

SSL Configuration

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

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).

For further information, see Query Processing.

Logging

For an overview of configuration settings that can be used to refine CData logging, see Logging. Only two connection properties are required for basic logging, but there are numerous features that support more refined logging, which enables you to use the LogModules connection property to specify subsets of information to be logged.

SSL Configuration

Customizing the SSL Configuration

To enable TLS, set the following:

URL: Prefix the connection string with https://

With this configuration, the Sync App attempts to negotiate TLS with the server. The server certificate is validated against the default system trusted certificate store. You can override how the certificate gets validated using the SSLServerCert connection property.

To specify another certificate, see the SSLServerCert connection property.

Firewall and Proxy

Connecting Through a Firewall or Proxy

HTTP Proxies

To authenticate to an HTTP proxy, set the following:

ProxyServer: the hostname or IP address of the proxy server that you want to route HTTP traffic through.
ProxyPort: the TCP port that the proxy server is running on.
ProxyAuthScheme: the authentication method the Sync App uses when authenticating to the proxy server.
ProxyUser: the username of a user account registered with the proxy server.
ProxyPassword: the password associated with the ProxyUser.

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.

Data Model

Overview

The CData Sync App models Microsoft Project objects as relational tables and views. Microsoft Project objects have relationships with each other, which the Sync App expresses through foreign keys.

Connecting with the ODataV2 Schema

In the ODataV2 Data Model (default), column metadata is dynamically retrieved for each entity, but the schema is fixed and custom fields are not included.

Connecting with the ODataV1 Schema

In the ODataV1 Data Model, metadata is dynamically retrieved, including the custom fields for this schema. This schema is read-only.

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.

ODataV2 Data Model

The ODataV2 schema implements the ProjectServer service endpoints. Unlike the ODataV1 schema, which is entirely read-only, this schema contains both tables and views.

Tables

Tables represent Microsoft Project objects like Calendars, Phases, and TimeSheets. Tables support write operations (INSERT, UPDATE, and DELETE) and are retrieved dynamically from the authenticated Microsoft Project account.

Views

Views are table-like schema objects that represent read-only Microsoft Project objects like Events and TimeSheetPeriods. They 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 Limitations

In order to query some tables and views, such as DraftAssignments, DraftProjectResources, DraftTaskLinks and DraftTasks, you must specify the ProjectId column in the query's WHERE clause criteria or via the ProjectId connection property.
Custom fields are not exposed in this schema.

Published and Draft Objects

Several objects in the OData V2 data model come in pairs, including a draft version (having a name starting with "Draft") and a published version (having a name starting with "Published").

While they are exposed as views, data can be inserted indirectly into published objects using draft objects as an intermediary. See Published and Draft Objects for more details.

Published and Draft Objects

Several objects in the OData V2 data model come in pairs, with a draft version (having a name starting with "Draft") and a published version (having a name starting with "Published").

Draft Tables

In draft tables (with the exception of the DraftProjects table), INSERT, UPDATE, and DELETE queries can be executed directly:

INSERT INTO DraftTasks (ProjectId, Finish, IsManual, Name, Notes, Start) VALUES ('68dceb1d-adac-ef11-bbda-00155df00e08', '2025-04-22', 'true', 'My new Test Task', 'Test temp Notes', '2025-04-18');

Published Tables

Unlike draft tables, published tables (with the exception of the PublishedProjects table) do not support INSERT, UPDATE, or DELETE queries directly, and are listed in the data model as Views.

However, while published tables can't be updated directly, they can be updated indirectly using the corresponding draft table as an intermediary. To do this:

Execute the CheckOut stored procedure to check out a project.
Perform an INSERT, UPDATE, or DELETE query on the draft table corresponding to the published table you want to write to.
Execute the Publish stored procedure to publish the checked-out project.
Execute the CheckIn stored procedure to check in the changes.

For example:

EXEC CheckOut ProjectId = 'projectId'
INSERT INTO DraftTasks (Name, ProjectId) VALUES ('example', 'projectId')  
EXEC Publish ProjectId = 'projectId'
EXEC CheckIn ProjectId = 'projectId'

Tables

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
Calendars	Retrieve and modify calendars.
DraftAssignments	Retrieve and modify draft assignments.
DraftProjectResources	Retrieve and modify draft project resources.
DraftProjects	Retrieve and modify draft projects.
DraftTaskLinks	Retrieve and modify draft task links.
DraftTasks	Retrieve and modify draft tasks.
EnterpriseProjectTypes	Retrieve and modify project types.
EnterpriseResources	Retrieve and modify resources.
EventHandlers	Retrieve and modify project event handlers.
Phases	Retrieve and modify project phases.
PublishedProjects	Retrieve and modify published projects.
StageDetailPages	Retrieve and modify stage project detail pages.
Stages	Retrieve and modify project stages.
TimeSheetLines	Retrieve and modify timesheet lines.
TimeSheets	Retrieve and modify timesheets.

Calendars

Retrieve and modify calendars.

Table Specific Information

Insert

The following is an example of inserting into the Calendars table:

INSERT INTO Calendars (Name, OriginalId) VALUES ('New Calendar Name', 'ad1d248c-98dd-ef11-a65e-00155df0cb0b');

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

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

DraftAssignments

Retrieve and modify draft 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 DraftAssignments WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Insert

The following is an example of inserting into the DraftAssignments table:

INSERT INTO DraftAssignments (ProjectID, TaskId, ResourceID, Notes, Start, Finish) VALUES ('50ff2a89-98ac-ef11-bbda-00155df00e07', '1e95ac9d-6a2f-f011-819a-00155df0dd09', 'a6b7bfdc-df19-f011-92a0-00155df00d03', 'Test Notes', '2025-05-28', '2025-05-31');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
ActualCostWorkPerformed	Double	False		False
ActualOvertimeCost	Double	False		False
BaselineCost	Double	False		False
BaselineCostPerUse	Double	False		False
BaselineFinish	Datetime	False		False
BaselineStart	Datetime	False		False
BaselineWork	String	False		False
BaselineWorkMilliseconds	Int	False		False
BaselineWorkTimeSpan	Time	False		False
BudgetedCostWorkPerformed	Double	False		False
BudgetedCostWorkScheduled	Double	False		False
CostVariance	Double	False		False
CostVarianceAtCompletion	Double	False		False
Created	Datetime	False		False
CurrentCostVariance	Double	False		False
Finish	Datetime	False		False
FinishVariance	String	False		False
FinishVarianceMilliseconds	Int	False		False
FinishVarianceTimeSpan	Time	False		False
IsConfirmed	Bool	False		False
IsOverAllocated	Bool	False		False
IsPublished	Bool	False		False
IsResponsePending	Bool	False		False
IsUpdateNeeded	Bool	False		False
LevelingDelay	String	False		False
LevelingDelayMilliseconds	Int	False		False
LevelingDelayTimeSpan	Time	False		False
Modified	Datetime	False		False
Notes	String	False		False
OvertimeCost	Double	False		False
RemainingCost	Double	False		False
RemainingOvertimeCost	Double	False		False
Resume	Datetime	False		False
ScheduleCostVariance	Double	False		False
Start	Datetime	False		False
StartVariance	String	False		False
StartVarianceMilliseconds	Int	False		False
StartVarianceTimeSpan	Time	False		False
Stop	Datetime	False		False
WorkContourType	Int	False		False
WorkVariance	String	False		False
WorkVarianceMilliseconds	Int	False		False
WorkVarianceTimeSpan	Time	False		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
Owner_Id	Int	True		False
Parent_Id	String	True		False
Resource_Id	String	True		False
Task_Id	String	True		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. This column only supports equality (=) and IN filters.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

DraftProjectResources

Retrieve and modify draft 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 DraftProjectResources WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Insert

The following is an example of inserting into the DraftProjectResources table:

INSERT INTO DraftProjectResources (ProjectId, Email, Name, Notes) VALUES ('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', '[email protected]', 'Jane Doe', 'This is a test note');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
ActualCost	Double	False		False
ActualCostWorkPerformed	String	False		False
ActualCostWorkPerformedMilliseconds	Int	False		False
ActualCostWorkPerformedTimeSpan	Time	False		False
ActualOvertimeCost	Double	False		False
ActualOvertimeWork	String	False		False
ActualOvertimeWorkMilliseconds	Int	False		False
ActualOvertimeWorkTimeSpan	Time	False		False
ActualWork	String	False		False
ActualWorkMilliseconds	Int	False		False
ActualWorkTimeSpan	Time	False		False
AvailableFrom	Datetime	False		False
AvailableTo	Datetime	False		False
BaselineCost	Double	False		False
BaselineWork	String	False		False
BaselineWorkMilliseconds	Int	False		False
BaselineWorkTimeSpan	Time	False		False
BudetCostWorkPerformed	Double	False		False
BudgetedCost	Double	False		False
BudgetedCostWorkScheduled	Double	False		False
BudgetedWork	String	False		False
BudgetedWorkMilliseconds	Int	False		False
BudgetedWorkTimeSpan	Time	False		False
Cost	Double	False		False
CostVariance	Double	False		False
CostVarianceAtCompletion	Double	False		False
Created	Datetime	False		False
CurrentCostVariance	Double	False		False
Finish	Datetime	False		False
IsBudgeted	Bool	False		False
IsGenericResource	Bool	False		False
IsOverAllocated	Bool	False		False
Modified	Datetime	False		False
Notes	String	False		False
OvertimeCost	Double	False		False
OvertimeWork	String	False		False
OvertimeWorkMilliseconds	Int	False		False
OvertimeWorkTimeSpan	Time	False		False
PeakWork	String	False		False
PeakWorkMilliseconds	Int	False		False
PeakWorkTimeSpan	Time	False		False
PercentWorkComplete	Int	False		False
RegularWork	String	False		False
RegularWorkMilliseconds	Int	False		False
RegularWorkTimeSpan	Time	False		False
RemainingCost	Double	False		False
RemainingOvertimeCost	Double	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
ScheduleCostVariance	Double	False		False
Start	Datetime	False		False
Work	String	False		False
WorkMilliseconds	Int	False		False
WorkTimeSpan	Time	False		False
WorkVariance	String	False		False
WorkVarianceMilliseconds	Int	False		False
WorkVarianceTimeSpan	Time	False		False
EnterpriseResource_Id	String	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
DefaultAssignmentOwner_Id	Int	True		False
LinkedAssignments	String	False		False
LinkedDefaultAssignmentOwner	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent. This column only supports equality (=) and IN filters.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

DraftProjects

Retrieve and modify draft projects.

Table Specific Information

Unlike most draft tables, DraftProjects does not support INSERT or DELETE queries.

While UPDATE queries are supported, you must first execute the CheckOut stored procedure:

EXEC CheckOut ProjectId = 'projectId'
UPDATE DraftProjects SET MinutesPerWeek = 1800 WHERE ID = 'projectId'

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
ApprovedEnd	Datetime	False		False
ApprovedStart	Datetime	False		False
CalculateActualCosts	Bool	False		False
CalculatesActualCosts	Bool	False		False
CheckedOutDate	Datetime	False		False
CheckOutDescription	String	False		False
CheckOutId	String	False		False
CreatedDate	Datetime	False		False
CriticalSlackLimit	Int	False		False
DefaultFinishTime	Datetime	False		False
DefaultOvertimeRateUnits	Int	False		False
DefaultStandardRateUnits	Int	False		False
DefaultStartTime	Datetime	False		False
HasMppPendingImport	Bool	False		False
HonorConstraints	Bool	False		False
IsCheckedOut	Bool	False		False
LastPublishedDate	Datetime	False		False
LastSavedDate	Datetime	False		False
ListId	String	False		False
MoveActualIfLater	Bool	False		False
MoveActualToStatus	Bool	False		False
MoveRemainingIfEarlier	Bool	False		False
MoveRemainingToStatus	Bool	False		False
MultipleCriticalPaths	Bool	False		False
OptimizerDecision	Int	False		False
PercentComplete	Int	False		False
PlannerDecision	Int	False		False
ProjectSiteUrl	String	False		False
ProjectType	Int	False		False
SplitInProgress	Bool	False		False
SpreadActualCostsToStatus	Bool	False		False
SpreadPercentCompleteToStatus	Bool	False		False
SummaryTaskId	String	False		False
TaskListId	String	False		False
WebId	String	False		False
CheckedOutBy_Id	Int	True		False
EnterpriseProjectType_Id	String	True		False
Phase_Id	String	True		False
ProjectSummaryTask_Id	String	True		False
Stage_Id	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
Calendar_Id	String	True		False
IncludeCustomFields_Id	String	True		False
Owner_Id	Int	True		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

DraftTaskLinks

Retrieve and modify draft 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 DraftTaskLinks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Insert

The following is an example of inserting into the DraftTaskLinks table:

INSERT INTO DraftTaskLinks (ProjectID, DependencyType, LinkLagDuration, StartID, EndId) VALUES ('50ff2a89-98ac-ef11-bbda-00155df00e07', '1', '1D', '98f103ab-6a2f-f011-8198-00155df0ab12', 'b13ad7b5-6a2f-f011-8198-00155df1150b');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
DependencyType	Int	False		False
EndId	String	False		False
LinkLagDuration	String	False		False
PredecessorTaskId	String	False		False
StartId	String	False		False
SuccessorTaskId	String	False		False
End_Id	String	True		False
Start_Id	String	True		False
LinkedEnd	String	False		False
LinkedStart	String	False		False
ProjectId [KEY]	String	True		False	Id of the parent. This column only supports equality (=) and IN filters.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

DraftTasks

Retrieve and modify draft 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 DraftTasks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Insert

The following is an example of inserting into the DraftTasks table:

INSERT INTO DraftTasks (ProjectId, Finish, IsManual, Name, Notes, Start) VALUES ('68dceb1d-adac-ef11-bbda-00155df00e08', '2025-04-22', 'true', 'My new Test Task', 'Test temp Notes', '2025-04-18');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
ActualCostWorkPerformed	Double	False		False
ActualDuration	String	False		False
ActualDurationMilliseconds	Int	False		False
ActualDurationTimeSpan	Time	False		False
ActualOvertimeCost	Double	False		False
ActualOvertimeWork	String	False		False
ActualOvertimeWorkMilliseconds	Int	False		False
ActualOvertimeWorkTimeSpan	Time	False		False
BaselineCost	Double	False		False
BaselineDuration	String	False		False
BaselineDurationMilliseconds	Int	False		False
BaselineDurationTimeSpan	Time	False		False
BaselineFinish	Datetime	False		False
BaselineStart	Datetime	False		False
BaselineWork	String	False		False
BaselineWorkMilliseconds	Int	False		False
BaselineWorkTimeSpan	Time	False		False
BudgetCost	Double	False		False
BudgetedCostWorkPerformed	Double	False		False
BudgetedCostWorkScheduled	Double	False		False
Contact	String	False		False
CostPerformanceIndex	Double	False		False
CostVariance	Double	False		False
CostVarianceAtCompletion	Double	False		False
CostVariancePercentage	Int	False		False
Created	Datetime	False		False
CurrentCostVariance	Double	False		False
DurationVariance	String	False		False
DurationVarianceMilliseconds	Int	False		False
DurationVarianceTimeSpan	Time	False		False
EarliestFinish	Datetime	False		False
EarliestStart	Datetime	False		False
EstimateAtCompletion	Double	False		False
ExternalProjectUid	String	False		False
ExternalTaskUid	String	False		False
FinishSlack	String	False		False
FinishSlackMilliseconds	Int	False		False
FinishSlackTimeSpan	Time	False		False
FinishVariance	String	False		False
FinishVarianceMilliseconds	Int	False		False
FinishVarianceTimeSpan	Time	False		False
FreeSlack	String	False		False
FreeSlackMilliseconds	Int	False		False
FreeSlackTimeSpan	Time	False		False
IgnoreResourceCalendar	Bool	False		False
IsCritical	Bool	False		False
IsDurationEstimate	Bool	False		False
IsExternalTask	Bool	False		False
IsOverAllocated	Bool	False		False
IsRecurring	Bool	False		False
IsRecurringSummary	Bool	False		False
IsRolledUp	Bool	False		False
IsSubProject	Bool	False		False
IsSubProjectReadOnly	Bool	False		False
IsSubProjectScheduledFromFinish	Bool	False		False
IsSummary	Bool	False		False
LatestFinish	Datetime	False		False
LatestStart	Datetime	False		False
LevelingDelay	String	False		False
LevelingDelayMilliseconds	Int	False		False
LevelingDelayTimeSpan	Time	False		False
Modified	Datetime	False		False
Notes	String	False		False
OutlinePosition	String	False		False
OvertimeCost	Double	False		False
OvertimeWork	String	False		False
OvertimeWorkMilliseconds	Int	False		False
OvertimeWorkTimeSpan	Time	False		False
PercentWorkComplete	Int	False		False
PreLevelingFinish	Datetime	False		False
PreLevelingStart	Datetime	False		False
RegularWork	String	False		False
RegularWorkMilliseconds	Int	False		False
RegularWorkTimeSpan	Time	False		False
RemainingCost	Double	False		False
RemainingOvertimeCost	Double	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
Resume	Datetime	False		False
ScheduleCostVariance	Double	False		False
ScheduledDuration	String	False		False
ScheduledDurationMilliseconds	Int	False		False
ScheduledDurationTimeSpan	Time	False		False
ScheduledFinish	Datetime	False		False
ScheduledStart	Datetime	False		False
SchedulePerformanceIndex	Double	False		False
ScheduleVariancePercentage	Int	False		False
StartSlack	String	False		False
StartSlackMilliseconds	Int	False		False
StartSlackTimeSpan	Time	False		False
StartVariance	String	False		False
StartVarianceMilliseconds	Int	False		False
StartVarianceTimeSpan	Time	False		False
Stop	Datetime	False		False
ToCompletePerformanceIndex	Double	False		False
TotalSlack	String	False		False
TotalSlackMilliseconds	Int	False		False
TotalSlackTimeSpan	Time	False		False
WorkBreakdownStructure	String	False		False
WorkVariance	String	False		False
WorkVarianceMilliseconds	Int	False		False
WorkVarianceTimeSpan	Time	False		False
SubProject_Id	String	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
FixedCostAccrual	Int	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
Calendar_Id	String	True		False
Parent_Id	String	True		False
StatusManager_Id	Int	True		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. This column only supports equality (=) and IN filters.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

EnterpriseProjectTypes

Retrieve and modify project types.

Table Specific Information

When inserting into the EnterpriseProjectTypes table, at least one project details page is required to be specified.

Three of the GetDeepInsertableColumns stored procedure's resultset columns (IsCreate, Position, and Id) can be specified in a temporary table and referenced via the LinkedProjectDetailPages column when inserting into the EnterpriseProjectTypes table.

For example:

INSERT INTO ProjectDetailPages#Temp (Id, IsCreate) VALUES  ('98d9dc7f-b563-4276-8a60-df8fc4775301', true);

INSERT INTO EnterpriseProjectTypes (Name, Description, WorkspaceTemplateName, LinkedProjectDetailPages) VALUES ('Test EnterpriseProjectType', 'Test Description', 'ProjectSite#0', 'ProjectDetailPages#Temp');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
Departments	String	False		False
Description	String	False		False
ImageUrl	String	False		False
IsDefault	Bool	False		False
IsManaged	Bool	False		False
Name	String	False		False
Order	Int	False		False
PermissionSyncEnable	Bool	False		False
ProjectPlanTemplateId	String	False		False
SiteCreationOption	Int	False		False
SiteCreationURL	String	False		False
TaskListSyncEnable	Bool	False		False
WorkflowAssociationId	String	False		False
WorkflowAssociationName	String	False		False
WorkspaceTemplateLCID	Int	False		False
WorkspaceTemplateName	String	False		False
LinkedProjectDetailPages	String	False		False

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

EnterpriseResources

Retrieve and modify resources.

Table Specific Information

Insert

The following is an example of inserting into the EnterpriseResources table:

INSERT INTO EnterpriseResources (Name, IsBudget, IsGeneric, IsInactive, ResourceType) VALUES ('Testing', false, true, true, 1);

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
BaseCalendar_Id	String	True		False
DefaultAssignmentOwner_Id	Int	True		False
Self_Id	String	True		False
TimesheetManager_Id	Int	True		False
User_Id	Int	True		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

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

EventHandlers

Retrieve and modify project event handlers.

Table Specific Information

Insert

The following is an example of inserting into the EventHandlers table:

INSERT INTO EventHandlers ([Name], [Order], [Description], [ClassName], [AssemblyName]) VALUES ('TestEventHandler', 4, 'TestDescription', 'Namespace.YourCustomEventHandlerClass', 'YourCustomAssemblyName, Version=1.0.0.0, Culture=neutral, PublicKeyToken=abcdef1234567890');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
AssemblyName	String	False		False
ClassName	String	False		False
Description	String	False		False
EndpointUrl	String	False		False
EventId	Int	False		False
Name	String	False		False
Order	Int	False		False
Event_Id	Int	True		False
LinkedEvent	String	False		False

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

Phases

Retrieve and modify project phases.

Table Specific Information

Insert

The following is an example of inserting into the Phases table:

INSERT INTO Phases (Name, Description) VALUES ('My Phase', 'Phase Description');

Columns


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

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

PublishedProjects

Retrieve and modify published projects.

Table Specific Information

Unlike most published tables, PublishedProjects does support executing INSERT and DELETE queries directly without the four-step process described in Published and Draft Objects:

INSERT INTO PublishedProjects (Description, EnterpriseProjectTypeId, Name, Start) VALUES ('New Test Published Project', '74ef28dd-b9d5-ef11-a65b-00155df09101', 'My test Temp Project', '2025-04-18');

DELETE FROM PublishedProjects WHERE ID = 'projectId'

Columns


Name	Type	ReadOnly	References	Required	Description
Id [KEY]	String	False		False
ApprovedEnd	Datetime	False		False
ApprovedStart	Datetime	False		False
CalculateActualCosts	Bool	False		False
CalculatesActualCosts	Bool	False		False
CheckedOutDate	Datetime	False		False
CheckOutDescription	String	False		False
CheckOutId	String	False		False
CreatedDate	Datetime	False		False
CriticalSlackLimit	Int	False		False
DefaultFinishTime	Datetime	False		False
DefaultOvertimeRateUnits	Int	False		False
DefaultStandardRateUnits	Int	False		False
DefaultStartTime	Datetime	False		False
HasMppPendingImport	Bool	False		False
HonorConstraints	Bool	False		False
IsCheckedOut	Bool	False		False
LastPublishedDate	Datetime	False		False
LastSavedDate	Datetime	False		False
ListId	String	False		False
MoveActualIfLater	Bool	False		False
MoveActualToStatus	Bool	False		False
MoveRemainingIfEarlier	Bool	False		False
MoveRemainingToStatus	Bool	False		False
MultipleCriticalPaths	Bool	False		False
OptimizerDecision	Int	False		False
PercentComplete	Int	False		False
PlannerDecision	Int	False		False
ProjectSiteUrl	String	False		False
ProjectType	Int	False		False
SplitInProgress	Bool	False		False
SpreadActualCostsToStatus	Bool	False		False
SpreadPercentCompleteToStatus	Bool	False		False
SummaryTaskId	String	False		False
TaskListId	String	False		False
WebId	String	False		False
CheckedOutBy_Id	Int	True		False
EnterpriseProjectType_Id	String	True		False
Phase_Id	String	True		False
ProjectSummaryTask_Id	String	True		False
Stage_Id	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
EnterpriseProjectTypeId	String	False		False
FinishDate	Datetime	False		False
FiscalYearStartMonth	Int	False		False
IsEnterpriseProject	Bool	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
Calendar_Id	String	True		False
Draft_Id	String	True		False
IncludeCustomFields_Id	String	True		False
Owner_Id	Int	True		False
ProjectWorkflowInstance_Id	String	True		False
LinkedAssignments	String	False		False
LinkedCalendar	String	False		False
LinkedDraft	String	False		False
LinkedEntityLinks	String	False		False
LinkedIncludeCustomFields	String	False		False
LinkedOwner	String	False		False
LinkedProjectResources	String	False		False
LinkedProjectWorkflowInstance	String	False		False
LinkedTaskLinks	String	False		False
LinkedTasks	String	False		False

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

StageDetailPages

Retrieve and modify stage project detail pages.

Table Specific Information

Insert

The following is an example of inserting into the StageDetailPages table:

INSERT INTO StageDetailPages (StageId, Id, Position, Description) VALUES ('744fb99a-71d2-ef11-a659-00155df0b501', '6540cd17-6fc7-4483-ae02-fbc2ea262377', 1, 'Test description');

Columns


Name	Type	ReadOnly	References	Required	Description
StageId [KEY]	String	True		False	Id of the parent. This column only supports equality (=) and IN filters.
Id [KEY]	String	False		False
Description	String	False		False
Position	Int	False		False
RequiresAttention	Bool	False		False
LinkedPhase	String	True		False
LinkedStage	String	True		False

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

Stages

Retrieve and modify project stages.

Table Specific Information

Insert

When inserting into the Stages table, at least one stage project details page is required to be specified.

For example:

INSERT INTO StageDetailPages#Temp (Id, Description, Position) VALUES ('6540cd17-6fc7-4483-ae02-fbc2ea262377', 'Test StageDetailPages', 1);

INSERT INTO Stages (Name, Description, WorkflowStatusPageId, PhaseId, CheckInRequired, Behavior, LinkedProjectDetailPages) VALUES ('Testing Stage2', 'The Description', '18c3e7c0-62ed-4099-912e-0b8460832cbe', 'd374d895-bccc-ef11-bbda-00155df06d03', true, 1, 'StageDetailPages#Temp');

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
Phase_Id	String	True		False
WorkflowStatusPage_Id	String	True		False
LinkedCustomFields	String	False		False
LinkedPhase	String	False		False
LinkedProjectDetailPages	String	False		False
LinkedWorkflowStatusPage	String	False		False

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

TimeSheetLines

Retrieve and modify timesheet lines.

Table Specific Information

Insert

The following is an example of inserting into the TimeSheetLines table:

INSERT INTO TimeSheetLines (PeriodId, Comment, LineClass, TaskName) VALUES ('f13d5bef-efd3-ef11-bbe3-00155df02906', 'TestComment', 1, 'Testing Purposes');

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
Assignment_Id	String	True		False
TimeSheet_Id	String	True		False
LinkedAssignment	String	False		False
LinkedTimeSheet	String	False		False
LinkedWork	String	False		False
PeriodId [KEY]	String	True		False	Id of the parent. This column only supports equality (=) and IN filters.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.


Name	Type	Description
InsertMode	String	Determines the Insert Mode. Set to 'ADD' to use standard MSProject Add function. This is the default and is recommended. Set to 'ODATA' to use standard ODATA insert functionality. This input is only applicable during inserts. The value set in this input overrides the value set in the InsertMode connection property (see the documentation page for the InsertMode connection property for more information).

TimeSheets

Retrieve and modify timesheets.

Table Specific Information

Insert

The following is an example of inserting into the TimeSheets table:

INSERT INTO TimeSheets (PeriodId) VALUES ('f13d5bef-efd3-ef11-bbe3-00155df02906');

Columns


Name	Type	ReadOnly	References	Required	Description
Id [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
Creator_Id	Int	True		False
Manager_Id	Int	True		False
Period_Id	String	True		False
LinkedCreator	String	False		False
LinkedLines	String	False		False
LinkedManager	String	False		False
LinkedPeriod	String	False		False
PeriodId [KEY]	String	True		False	Id of the parent. This column only supports equality (=) and IN filters.

Views

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 project events.
ProjectDetailPages	Retrieve project detail pages.
PublishedAssignments	Retrieve published assignments.
PublishedProjectResources	Retrieve published project resources.
PublishedTaskLinks	Retrieve published task links.
PublishedTasks	Retrieve published tasks.
Tasks_Assignments	Retrieve and modify assignments.
Tasks_Calendar	Retrieve and modify assignments.
TimeSheetPeriods	Retrieve timesheets.
WorkflowActivities	Retrieve and modify workflow activities.
WorkflowDesigner	Retrieve workflow designers.

Assignment_Resource

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.

Assignment_Task

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.

Events

Retrieve project events.

Columns


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

ProjectDetailPages

Retrieve project detail pages.

Columns


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

PublishedAssignments

Retrieve published assignments.

Columns

References Description String Double Double Double Double Datetime Datetime String Int Time Double Double Double Double Datetime Double Datetime String Int Time Bool Bool Bool Bool Bool String Int Time Datetime String Double Double Double Datetime Double Datetime String Int Time Datetime Int String Int Time String Double Datetime String Int Time Datetime String Int Time Double String Int Time Double Int Int String Int Time Bool Bool String Int Time Int String Int Time String Int Time String Int Time Double String Int Time Int String String String String String String String [KEY] String />


Name	Type style="white-space:nowrap">Id
ActualCostWorkPerformed
ActualOvertimeCost
BaselineCost
BaselineCostPerUse
BaselineFinish
BaselineStart
BaselineWork
BaselineWorkMilliseconds
BaselineWorkTimeSpan
BudgetedCostWorkPerformed
BudgetedCostWorkScheduled
CostVariance
CostVarianceAtCompletion
Created
CurrentCostVariance
Finish
FinishVariance
FinishVarianceMilliseconds
FinishVarianceTimeSpan
IsConfirmed
IsOverAllocated
IsPublished
IsResponsePending
IsUpdateNeeded
LevelingDelay
LevelingDelayMilliseconds
LevelingDelayTimeSpan
Modified
Notes
OvertimeCost
RemainingCost
RemainingOvertimeCost
Resume
ScheduleCostVariance
Start
StartVariance
StartVarianceMilliseconds
StartVarianceTimeSpan
Stop
WorkContourType
WorkVariance
WorkVarianceMilliseconds
WorkVarianceTimeSpan
LinkedCustomFields
ActualCost
ActualFinish
ActualOvertimeWork
ActualOvertimeWorkMilliseconds
ActualOvertimeWorkTimeSpan
ActualStart
ActualWork
ActualWorkMilliseconds
ActualWorkTimeSpan
BudgetedCost
BudgetedWork
BudgetedWorkMilliseconds
BudgetedWorkTimeSpan
Cost
CostRateTable
DefaultBookingType
Delay
DelayMilliseconds
DelayTimeSpan
IsLockedByManager
IsWorkResource
OvertimeWork
OvertimeWorkMilliseconds
OvertimeWorkTimeSpan
PercentWorkComplete
RegularWork
RegularWorkMilliseconds
RegularWorkTimeSpan
RemainingOvertimeWork
RemainingOvertimeWorkMilliseconds
RemainingOvertimeWorkTimeSpan
RemainingWork
RemainingWorkMilliseconds
RemainingWorkTimeSpan
ResourceCapacity
Work
WorkMilliseconds
WorkTimeSpan
Owner_Id
Parent_Id
Resource_Id
Task_Id
LinkedOwner
LinkedParent
LinkedResource
LinkedTask
ProjectId	Id of the parent. This column only supports equality (=) and IN filters.

PublishedProjectResources

Retrieve published project resources.

Columns


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

PublishedTaskLinks

Retrieve published task links.

Columns


Name	Type	References	Description
Id [KEY]	String
DependencyType	Int
LinkLag	Int
LinkLagDuration	String
LinkLagFmt	Int
PredecessorTaskId	String
ProjUid	String
SuccessorTaskId	String
End_Id	String
Start_Id	String
LinkedEnd	String
LinkedStart	String
ProjectId [KEY]	String		Id of the parent. This column only supports equality (=) and IN filters.

PublishedTasks

Retrieve published tasks.

Columns


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

Tasks_Assignments

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.

Tasks_Calendar

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.

TimeSheetPeriods

Retrieve timesheets.

Columns


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

WorkflowActivities

Retrieve and modify workflow activities.

Columns


Name	Type	References	Description
Id [KEY]	String

WorkflowDesigner

Retrieve workflow designers.

Columns


Name	Type	References	Description
Id [KEY]	String
LinkedFields	String

Stored Procedures

Stored procedures are function-like interfaces that extend the functionality of the Sync App beyond simple SELECT/INSERT/UPDATE/DELETE operations with Microsoft Project.

Stored procedures accept a list of parameters, perform their intended function, and then return any relevant response data from Microsoft Project, along with an indication of whether the procedure succeeded or failed.

Microsoft Project Connector for CData Sync Stored Procedures


Name	Description
CheckIn	Check in the specified project.
CheckOut	Check out the specified project.
GetDeepInsertableColumns	Retrieves the insertable columns that can be specified during deep inserts when the InsertMode is 'ADD' for the specified table (and LinkedColumn).
GetOnlineCookies	Retrieves the cookies for authentication with SharePoint Online.
Publish	Publish the specified project.

CheckIn

Check in the specified project.

Input


Name	Type	Description
ProjectId	String	The Id of the project you are checking in.
Force	String	Set to true to force check in. Default is false.

Result Set Columns


Name	Type	Description
Success	String	The result of the operation.

CheckOut

Check out the specified project.

Input


Name	Type	Description
ProjectId	String	The Id of the project you are checking out.

Result Set Columns


Name	Type	Description
Success	String	The result of the operation.

GetDeepInsertableColumns

Retrieves the insertable columns that can be specified during deep inserts when the InsertMode is 'ADD' for the specified table (and LinkedColumn).

Procedure-Specific Information

For example:

EXECUTE GetDeepInsertableColumns TableName = 'EnterpriseProjectTypes';

Input


Name	Type	Description
TableName	String	Name of the table for which the deep insertable columns are being retrieved.
LinkedColumnName	String	Name of the linked column referencing the related table.

Result Set Columns


Name	Type	Description
LinkedColumnName	String	Name of the linked column referencing the related table.
DeepInsertColumnName	String	The name of the column that can be inserted into the temp table during deep inserts.

GetOAuthAccessToken

Gets an authentication token from Microsoft Project.

Input


Name	Type	Description
Scope	String	A comma-separated list of permissions to request from the user. Please check the Microsoft Project API for a list of available permissions.
CallbackUrl	String	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL you have specified in the Microsoft Project app settings. Only needed when the Authmode parameter is Web.
Verifier	String	The verifier returned from Microsoft Project after the user has authorized your app to have access to their data. This value will be returned as a parameter to the callback URL.
State	String	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the Microsoft Project authorization server and back. Uses include redirecting the user to the correct resource in your site, nonces, and cross-site-request-forgery mitigations.

Result Set Columns


Name	Type	Description
OAuthAccessToken	String	The access token used for communication with Microsoft Project.
OAuthRefreshToken	String	The OAuth refresh token. This is the same as the access token in the case of Microsoft Project.
ExpiresIn	String	The remaining lifetime on the access token. A -1 denotes that it will not expire.

GetOAuthAuthorizationURL

Gets the authorization URL that must be opened separately by the user to grant access to your application. Only needed when developing Web apps. You will request the OAuthAccessToken from this URL.

Input


Name	Type	Description
CallbackUrl	String	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL in the Microsoft Project app settings.
Scope	String	A comma-separated list of scopes to request from the user. Please check the Microsoft Project API documentation for a list of available permissions.
State	String	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the Microsoft Project authorization server and back. Uses include redirecting the user to the correct resource in your site, nonces, and cross-site-request-forgery mitigations.

Result Set Columns


Name	Type	Description
URL	String	The authorization URL, entered into a Web browser to obtain the verifier token and authorize your app.

GetOnlineCookies

Retrieves the cookies for authentication with SharePoint Online.

Input


Name	Type	Description
User	String	Your SharePoint Online username.
Password	String	Your SharePoint Online password.
STSURL	String	Your SharePoint Online STSURL. This only needs to be set if your organization uses a local ADFS server for authentication.

Result Set Columns


Name	Type	Description
Cookie	String	The cookies that will need to be entered in the AuthCookie connection string property.

Publish

Publish the specified project.

Input


Name	Type	Description
ProjectId	String	The Id of the project you are publishing.
CheckIn	String	Set to true to publish the proejct. Default value is false.

Result Set Columns


Name	Type	Description
Success	String	The result of the operation.

RefreshOAuthAccessToken

Refreshes the OAuth access token used for authentication with Microsoft Project.

Input


Name	Type	Description
OAuthRefreshToken	String	Set this to the token value that expired.

Result Set Columns


Name	Type	Description
OAuthAccessToken	String	The authentication token returned from Microsoft Project. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken	String	This is the same as the access token.
ExpiresIn	String	The remaining lifetime on the access token.

ODataV1 Data Model

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

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.

AssignmentBaselines

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

AssignmentBaselineTimephasedDataSet

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

Assignments

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

AssignmentTimephasedDataSet

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

BusinessDriverDepartments

Retrieve business driver departments.

Columns


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

BusinessDrivers

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

CostConstraintScenarios

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

CostScenarioProjects

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

Deliverables

Retrieve deliverables.

Columns


Name	Type	References	Description
DeliverableId [KEY]	String
ProjectId [KEY]	String
CreateByResource	String
CreatedDate	Datetime
Description	String
FinishDate	Datetime
IsFolder	Bool
ItemRelativeUrlPath	String
ModifiedByResource	String
ModifiedDate	Datetime
ProjectName	String
StartDate	Datetime
Title	String
LinkedDependentProjects	String
LinkedDependentTasks	String
LinkedParentProjects	String
LinkedParentTasks	String
LinkedProject	String

Engagements

Retrieve engagements.

Columns


Name	Type	References	Description
EngagementId [KEY]	String
CommittedFinishDate	Datetime
CommittedMaxUnits	Decimal
CommittedStartDate	Datetime
CommittedWork	Decimal
EngagementCreatedDate	Datetime
EngagementModifiedDate	Datetime
EngagementName	String
EngagementReviewedDate	Datetime
EngagementStatus	Int
EngagementSubmittedDate	Datetime
ModifiedByResourceId	String
ModifiedByResourceName	String
ProjectId	String
ProjectName	String
ProposedFinishDate	Datetime
ProposedMaxUnits	Decimal
ProposedStartDate	Datetime
ProposedWork	Decimal
ResourceId	String
ResourceName	String
ReviewedByResourceId	String
ReviewedByResourceName	String
SubmittedByResourceId	String
SubmittedByResourceName	String
LinkedComment	String
LinkedTimephasedInfo	String

EngagementsComments

Retrieve engagements comments.

Columns


Name	Type	References	Description
CommentId [KEY]	String
AuthorId	String
AuthorName	String
CommentCreatedDate	Datetime
CommentMessage	String
EngagementId	String
EngagementName	String
LinkedEngagement	String

EngagementsTimephasedDataSet

Retrieve engagements timephased dataset.

Columns


Name	Type	References	Description
EngagementId [KEY]	String
TimeByDay [KEY]	Datetime
CommittedMaxUnits	Decimal
CommittedWork	Decimal
EngagementModifiedDate	Datetime
EngagementName	String
ProjectId	String
ProjectName	String
ProposedMaxUnits	Decimal
ProposedWork	Decimal
ResourceId	String
ResourceName	String
LinkedEngagement	String

FiscalPeriods

Retrieve fiscal periods.

Columns


Name	Type	References	Description
FiscalPeriodId [KEY]	String
CreatedDate	Datetime
FiscalPeriodFinish	Datetime
FiscalPeriodModifiedDate	Datetime
FiscalPeriodName	String
FiscalPeriodQuarter	Int
FiscalPeriodStart	Datetime
FiscalPeriodYear	Int

Issues

Retrieve issues.

Columns


Name	Type	References	Description
IssueId [KEY]	String
ProjectId [KEY]	String
AssignedToResource	String
Category	String
CreateByResource	String
CreatedDate	Datetime
Discussion	String
DueDate	Datetime
IsFolder	Bool
ItemRelativeUrlPath	String
ModifiedByResource	String
ModifiedDate	Datetime
NumberOfAttachments	Int
Owner	String
Priority	String
ProjectName	String
Resolution	String
Status	String
Title	String
LinkedProject	String
LinkedRelatedRisks	String
LinkedSubIssues	String
LinkedTasks	String

IssueTaskAssociations

Retrieve issue-task associations.

Columns


Name	Type	References	Description
IssueId [KEY]	String
ProjectId [KEY]	String
RelationshipType [KEY]	Int
TaskId [KEY]	String
ProjectName	String
RelatedProjectId	String
RelatedProjectName	String
TaskName	String
Title	String
LinkedIssue	String
LinkedProject	String
LinkedRelatedProject	String
LinkedTask	String

PortfolioAnalyses

Retrieve portfolio analyses.

Columns


Name	Type	References	Description
AnalysisId [KEY]	String
AnalysisDescription	String
AnalysisName	String
AnalysisType	Int
BookingType	Int
CreatedByResourceId	String
CreatedByResourceName	String
CreatedDate	Datetime
DepartmentId	String
DepartmentName	String
FilterResourcesByDepartment	Bool
FilterResourcesByRBS	Bool
FilterResourcesByRBSValueId	String
FilterResourcesByRBSValueText	String
ForcedInAliasLookupTableId	String
ForcedInAliasLookupTableName	String
ForcedOutAliasLookupTableId	String
ForcedOutAliasLookupTableName	String
HardConstraintCustomFieldId	String
HardConstraintCustomFieldName	String
ModifiedByResourceId	String
ModifiedByResourceName	String
ModifiedDate	Datetime
PlanningHorizonEndDate	Datetime
PlanningHorizonStartDate	Datetime
PrioritizationId	String
PrioritizationName	String
PrioritizationType	Int
RoleCustomFieldId	String
RoleCustomFieldName	String
TimeScale	Int
UseAlternateProjectDatesForResourcePlans	Bool
LinkedAnalysisProjects	String
LinkedCostConstraintScenarios	String
LinkedCreatedByResource	String
LinkedModifiedByResource	String
LinkedPrioritization	String
LinkedResourceConstraintScenarios	String

PortfolioAnalysisProjects

Retrieve portfolio analysis projects.

Columns


Name	Type	References	Description
AnalysisId [KEY]	String
ProjectId [KEY]	String
AbsolutePriority	Double
AnalysisName	String
Duration	Decimal
FinishNoLaterThan	Datetime
Locked	Int
OriginalEndDate	Datetime
OriginalStartDate	Datetime
Priority	Double
ProjectName	String
StartDate	Datetime
StartNoEarlierThan	Datetime
LinkedAnalysis	String
LinkedProject	String

PrioritizationDriverRelations

Retrieve prioritization driver relations.

Columns


Name	Type	References	Description
BusinessDriver1Id [KEY]	String
BusinessDriver2Id [KEY]	String
PrioritizationId [KEY]	String
BusinessDriver1Name	String
BusinessDriver2Name	String
PrioritizationName	String
RelationValue	String
LinkedBusinessDriver1	String
LinkedBusinessDriver2	String
LinkedPrioritization	String

PrioritizationDrivers

Retrieve prioritization drivers.

Columns


Name	Type	References	Description
BusinessDriverId [KEY]	String
PrioritizationId [KEY]	String
BusinessDriverName	String
BusinessDriverPriority	Double
PrioritizationName	String
LinkedBusinessDriver	String
LinkedPrioritization	String

Prioritizations

Retrieve prioritizations.

Columns


Name	Type	References	Description
PrioritizationId [KEY]	String
ConsistencyRatio	Double
CreatedByResourceId	String
CreatedByResourceName	String
DepartmentId	String
DepartmentName	String
ModifiedByResourceId	String
ModifiedByResourceName	String
PrioritizationCreatedDate	Datetime
PrioritizationDescription	String
PrioritizationIsManual	Bool
PrioritizationModifiedDate	Datetime
PrioritizationName	String
LinkedCreatedByResource	String
LinkedModifiedByResource	String
LinkedPrioritizationDriverRelations	String
LinkedPrioritizationDrivers	String

ProjectBaselines

Retrieve project baselines.

Columns


Name	Type	References	Description
BaselineNumber [KEY]	Int
ProjectId [KEY]	String
ProjectBaselineBudgetCost	Decimal
ProjectBaselineBudgetWork	Decimal
ProjectBaselineCost	Decimal
ProjectBaselineDeliverableFinishDate	Datetime
ProjectBaselineDeliverableStartDate	Datetime
ProjectBaselineDuration	Decimal
ProjectBaselineDurationString	String
ProjectBaselineFinishDate	Datetime
ProjectBaselineFinishDateString	String
ProjectBaselineFixedCost	Decimal
ProjectBaselineModifiedDate	Datetime
ProjectBaselineStartDate	Datetime
ProjectBaselineStartDateString	String
ProjectBaselineWork	Decimal
ProjectName	String
TaskId	String
LinkedProject	String

Projects

Retrieve projects.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
EnterpriseProjectTypeDescription	String
EnterpriseProjectTypeId	String
EnterpriseProjectTypeIsDefault	Bool
EnterpriseProjectTypeName	String
OptimizerCommitDate	Datetime
OptimizerDecisionAliasLookupTableId	String
OptimizerDecisionAliasLookupTableValueId	String
OptimizerDecisionID	Int
OptimizerDecisionName	String
OptimizerSolutionName	String
ParentProjectId	String
PlannerCommitDate	Datetime
PlannerDecisionAliasLookupTableId	String
PlannerDecisionAliasLookupTableValueId	String
PlannerDecisionID	Int
PlannerDecisionName	String
PlannerEndDate	Datetime
PlannerSolutionName	String
PlannerStartDate	Datetime
ProjectActualCost	Decimal
ProjectActualDuration	Decimal
ProjectActualFinishDate	Datetime
ProjectActualOvertimeCost	Decimal
ProjectActualOvertimeWork	Decimal
ProjectActualRegularCost	Decimal
ProjectActualRegularWork	Decimal
ProjectActualStartDate	Datetime
ProjectActualWork	Decimal
ProjectACWP	Decimal
ProjectAuthorName	String
ProjectBCWP	Decimal
ProjectBCWS	Decimal
ProjectBudgetCost	Decimal
ProjectBudgetWork	Decimal
ProjectCalculationsAreStale	Bool
ProjectCalendarDuration	Int
ProjectCategoryName	String
ProjectCompanyName	String
ProjectCost	Decimal
ProjectCostVariance	Decimal
ProjectCPI	Decimal
ProjectCreatedDate	Datetime
ProjectCurrency	String
ProjectCV	Decimal
ProjectCVP	Decimal
ProjectDepartments	String
ProjectDescription	String
ProjectDuration	Decimal
ProjectDurationVariance	Decimal
ProjectEAC	Decimal
ProjectEarlyFinish	Datetime
ProjectEarlyStart	Datetime
ProjectEarnedValueIsStale	Bool
ProjectEnterpriseFeatures	Bool
ProjectFinishDate	Datetime
ProjectFinishVariance	Decimal
ProjectFixedCost	Decimal
ProjectIdentifier	String
ProjectKeywords	String
ProjectLastPublishedDate	Datetime
ProjectLateFinish	Datetime
ProjectLateStart	Datetime
ProjectManagerName	String
ProjectModifiedDate	Datetime
ProjectName	String
ProjectOvertimeCost	Decimal
ProjectOvertimeWork	Decimal
ProjectOwnerId	String
ProjectOwnerName	String
ProjectPercentCompleted	Int
ProjectPercentWorkCompleted	Int
ProjectRegularCost	Decimal
ProjectRegularWork	Decimal
ProjectRemainingCost	Decimal
ProjectRemainingDuration	Decimal
ProjectRemainingOvertimeCost	Decimal
ProjectRemainingOvertimeWork	Decimal
ProjectRemainingRegularCost	Decimal
ProjectRemainingRegularWork	Decimal
ProjectRemainingWork	Decimal
ProjectResourcePlanWork	Decimal
ProjectSPI	Decimal
ProjectStartDate	Datetime
ProjectStartVariance	Decimal
ProjectStatusDate	Datetime
ProjectSubject	String
ProjectSV	Decimal
ProjectSVP	Decimal
ProjectTCPI	Decimal
ProjectTimephased	String
ProjectTitle	String
ProjectType	Int
ProjectVAC	Decimal
ProjectWork	Decimal
ProjectWorkspaceInternalUrl	String
ProjectWorkVariance	Decimal
ResourcePlanUtilizationDate	Datetime
ResourcePlanUtilizationType	Int
WorkflowError	String
WorkflowErrorResponseCode	Int
WorkflowInstanceId	String
WorkflowOwnerId	String
WorkflowOwnerName	String
LinkedAssignmentBaselines	String
LinkedAssignments	String
LinkedDeliverables	String
LinkedDependencies	String
LinkedIssues	String
LinkedRisks	String
LinkedStagesInfo	String
LinkedTasks	String

ProjectWorkflowStageDataSet

Retrieve project workflow stage dataset.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
StageId [KEY]	String
LastModifiedDate	Datetime
LCID	Int
PhaseDescription	String
PhaseName	String
ProjectName	String
StageCompletionDate	Datetime
StageDescription	String
StageEntryDate	Datetime
StageInformation	String
StageLastSubmittedDate	Datetime
StageName	String
StageOrder	Int
StageStateDescription	String
StageStatus	Int
LinkedProject	String

ResourceConstraintScenarios

Retrieve resource constraint scenarios.

Columns


Name	Type	References	Description
ScenarioId [KEY]	String
AllocationThreshold	Decimal
AnalysisId	String
AnalysisName	String
ConstraintType	Int
ConstraintValue	Decimal
CostConstraintScenarioId	String
CostConstraintScenarioName	String
CreatedByResourceId	String
CreatedByResourceName	String
CreatedDate	Datetime
EnforceProjectDependencies	Bool
EnforceSchedulingConstraints	Bool
HiringType	Int
ModifiedByResourceId	String
ModifiedByResourceName	String
ModifiedDate	Datetime
RateTable	Int
ScenarioDescription	String
ScenarioName	String
LinkedAnalysis	String
LinkedCostConstraintScenario	String
LinkedCreatedByResource	String
LinkedModifiedByResource	String
LinkedResourceScenarioProjects	String

ResourceDemandTimephasedDataSet

Retrieve resource demand timephased dataset.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
ResourceId [KEY]	String
TimeByDay [KEY]	Datetime
FiscalPeriodId	String
ProjectName	String
ResourceDemand	Decimal
ResourceDemandModifiedDate	Datetime
ResourceName	String
ResourcePlanUtilizationDate	Datetime
ResourcePlanUtilizationType	Int
LinkedProject	String
LinkedResource	String
LinkedTime	String

Resources

Retrieve resources.

Columns


Name	Type	References	Description
ResourceId [KEY]	String
CostType	String
RBS	String
ResourceBaseCalendar	String
ResourceBookingType	Int
ResourceCanLevel	Bool
ResourceCode	String
ResourceCostCenter	String
ResourceCostPerUse	Decimal
ResourceCreatedDate	Datetime
ResourceDepartments	String
ResourceEarliestAvailableFrom	Datetime
ResourceEmailAddress	String
ResourceGroup	String
ResourceHyperlink	String
ResourceHyperlinkHref	String
ResourceInitials	String
ResourceIsActive	Bool
ResourceIsGeneric	Bool
ResourceIsTeam	Bool
ResourceLatestAvailableTo	Datetime
ResourceMaterialLabel	String
ResourceMaxUnits	Decimal
ResourceModifiedDate	Datetime
ResourceName	String
ResourceNTAccount	String
ResourceOvertimeRate	Decimal
ResourceStandardRate	Decimal
ResourceStatusId	String
ResourceStatusName	String
ResourceTimesheetManageId	String
ResourceType	Int
ResourceWorkgroup	Int
TypeDescription	String
TypeName	String
LinkedAssignments	String
LinkedResourceDemandTimephasedInfo	String
LinkedTimephasedInfoDataSet	String

ResourceScenarioProjects

Retrieve resource scenario projects.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
ScenarioId [KEY]	String
AbsolutePriority	Double
AnalysisId	String
AnalysisName	String
CostConstraintScenarioId	String
CostConstraintScenarioName	String
ForceAliasLookupTableId	String
ForceAliasLookupTableName	String
ForceStatus	Int
HardConstraintValue	Decimal
NewStartDate	Datetime
Priority	Double
ProjectName	String
ResourceCost	Decimal
ResourceWork	Decimal
ScenarioName	String
Status	Int
LinkedAnalysis	String
LinkedCostConstraintScenario	String
LinkedProject	String
LinkedResourceConstraintScenario	String

ResourceTimephasedDataSet

Retrieve resource timephased dataset.

Columns


Name	Type	References	Description
ResourceId [KEY]	String
TimeByDay [KEY]	Datetime
BaseCapacity	Decimal
Capacity	Decimal
FiscalPeriodId	String
ResourceModifiedDate	Datetime
ResourceName	String
LinkedResource	String
LinkedTime	String

Risks

Retrieve risks.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
RiskId [KEY]	String
AssignedToResource	String
Category	String
ContingencyPlan	String
Cost	Double
CostExposure	Double
CreateByResource	String
CreatedDate	Datetime
Description	String
DueDate	Datetime
Exposure	Double
Impact	Double
IsFolder	Bool
ItemRelativeUrlPath	String
MitigationPlan	String
ModifiedByResource	String
ModifiedDate	Datetime
NumberOfAttachments	Int
Owner	String
Probability	Double
ProjectName	String
Status	String
Title	String
TriggerDescription	String
TriggerTask	String
LinkedProject	String
LinkedRelatedIssues	String
LinkedSubRisks	String
LinkedTasks	String

RiskTaskAssociations

Retrieve risk task associations.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
RelationshipType [KEY]	Int
RiskId [KEY]	String
TaskId [KEY]	String
ProjectName	String
RelatedProjectId	String
RelatedProjectName	String
TaskName	String
Title	String
LinkedProject	String
LinkedRelatedProject	String
LinkedRisk	String
LinkedTask	String

TaskBaselines

Retrieve task baselines.

Columns


Name	Type	References	Description
BaselineNumber [KEY]	Int
ProjectId [KEY]	String
TaskId [KEY]	String
ProjectName	String
TaskBaselineBudgetCost	Decimal
TaskBaselineBudgetWork	Decimal
TaskBaselineCost	Decimal
TaskBaselineDeliverableFinishDate	Datetime
TaskBaselineDeliverableStartDate	Datetime
TaskBaselineDuration	Decimal
TaskBaselineDurationString	String
TaskBaselineFinishDate	Datetime
TaskBaselineFinishDateString	String
TaskBaselineFixedCost	Decimal
TaskBaselineModifiedDate	Datetime
TaskBaselineStartDate	Datetime
TaskBaselineStartDateString	String
TaskBaselineWork	Decimal
TaskName	String
LinkedProject	String
LinkedTask	String
LinkedTaskBaselineTimephasedDataSet	String

TaskBaselineTimephasedDataSet

Retrieve task baseline timephased dataset.

Columns


Name	Type	References	Description
BaselineNumber [KEY]	Int
ProjectId [KEY]	String
TaskId [KEY]	String
TimeByDay [KEY]	Datetime
FiscalPeriodId	String
ProjectName	String
TaskBaselineBudgetCost	Decimal
TaskBaselineBudgetWork	Decimal
TaskBaselineCost	Decimal
TaskBaselineFixedCost	Decimal
TaskBaselineModifiedDate	Datetime
TaskBaselineWork	Decimal
TaskName	String
LinkedProject	String
LinkedTask	String
LinkedTaskBaselines	String
LinkedTime	String

Tasks

Retrieve tasks.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
TaskId [KEY]	String
FlagStatus	Bool
Health	String
ParentTaskId	String
ParentTaskName	String
ProjectName	String
TaskActualCost	Decimal
TaskActualDuration	Decimal
TaskActualFinishDate	Datetime
TaskActualFixedCost	Decimal
TaskActualOvertimeCost	Decimal
TaskActualOvertimeWork	Decimal
TaskActualRegularCost	Decimal
TaskActualRegularWork	Decimal
TaskActualStartDate	Datetime
TaskActualWork	Decimal
TaskACWP	Decimal
TaskBCWP	Decimal
TaskBCWS	Decimal
TaskBudgetCost	Decimal
TaskBudgetWork	Decimal
TaskClientUniqueId	Int
TaskCost	Decimal
TaskCostVariance	Decimal
TaskCPI	Decimal
TaskCreatedDate	Datetime
TaskCreatedRevisionCounter	Int
TaskCV	Decimal
TaskCVP	Decimal
TaskDeadline	Datetime
TaskDeliverableFinishDate	Datetime
TaskDeliverableStartDate	Datetime
TaskDuration	Decimal
TaskDurationIsEstimated	Bool
TaskDurationString	String
TaskDurationVariance	Decimal
TaskEAC	Decimal
TaskEarlyFinish	Datetime
TaskEarlyStart	Datetime
TaskFinishDate	Datetime
TaskFinishDateString	String
TaskFinishVariance	Decimal
TaskFixedCost	Decimal
TaskFixedCostAssignmentId	String
TaskFreeSlack	Decimal
TaskHyperLinkAddress	String
TaskHyperLinkFriendlyName	String
TaskHyperLinkSubAddress	String
TaskIgnoresResourceCalendar	Bool
TaskIndex	Int
TaskIsActive	Bool
TaskIsCritical	Bool
TaskIsEffortDriven	Bool
TaskIsExternal	Bool
TaskIsManuallyScheduled	Bool
TaskIsMarked	Bool
TaskIsMilestone	Bool
TaskIsOverallocated	Bool
TaskIsProjectSummary	Bool
TaskIsRecurring	Bool
TaskIsSummary	Bool
TaskLateFinish	Datetime
TaskLateStart	Datetime
TaskLevelingDelay	Decimal
TaskModifiedDate	Datetime
TaskModifiedRevisionCounter	Int
TaskName	String
TaskOutlineLevel	Int
TaskOutlineNumber	String
TaskOvertimeCost	Decimal
TaskOvertimeWork	Decimal
TaskPercentCompleted	Int
TaskPercentWorkCompleted	Int
TaskPhysicalPercentCompleted	Int
TaskPriority	Int
TaskRegularCost	Decimal
TaskRegularWork	Decimal
TaskRemainingCost	Decimal
TaskRemainingDuration	Decimal
TaskRemainingOvertimeCost	Decimal
TaskRemainingOvertimeWork	Decimal
TaskRemainingRegularCost	Decimal
TaskRemainingRegularWork	Decimal
TaskRemainingWork	Decimal
TaskResourcePlanWork	Decimal
TaskSPI	Decimal
TaskStartDate	Datetime
TaskStartDateString	String
TaskStartVariance	Decimal
TaskStatusManagerUID	String
TaskSV	Decimal
TaskSVP	Decimal
TaskTCPI	Decimal
TaskTotalSlack	Decimal
TaskVAC	Decimal
TaskWBS	String
TaskWork	Decimal
TaskWorkVariance	Decimal
LinkedAssignments	String
LinkedAssignmentsBaselines	String
LinkedAssignmentsBaselineTimephasedData	String
LinkedBaselines	String
LinkedBaselinesTimephasedDataSet	String
LinkedIssues	String
LinkedProject	String
LinkedRisks	String
LinkedTimephasedInfo	String

TaskTimephasedDataSet

Retrieve task timephased dataset.

Columns


Name	Type	References	Description
ProjectId [KEY]	String
TaskId [KEY]	String
TimeByDay [KEY]	Datetime
FiscalPeriodId	String
ProjectName	String
TaskActualCost	Decimal
TaskActualWork	Decimal
TaskBudgetCost	Decimal
TaskBudgetWork	Decimal
TaskCost	Decimal
TaskIsActive	Bool
TaskIsProjectSummary	Bool
TaskModifiedDate	Datetime
TaskName	String
TaskOvertimeWork	Decimal
TaskResourcePlanWork	Decimal
TaskWork	Decimal
LinkedProject	String
LinkedTask	String
LinkedTime	String

TimeSet

Retrieve timeset.

Columns


Name	Type	References	Description
TimeByDay [KEY]	Datetime
FiscalPeriodId	String
FiscalPeriodModifiedDate	Datetime
FiscalPeriodName	String
FiscalPeriodStart	Datetime
FiscalPeriodYear	Int
FiscalQuarter	Int
TimeDayOfTheMonth	Int
TimeDayOfTheWeek	Int
TimeMonthOfTheYear	Int
TimeQuarter	Int
TimeWeekOfTheYear	Int

TimesheetClasses

Retrieve timesheet classes.

Columns


Name	Type	References	Description
DepartmentId [KEY]	String
TimesheetClassId [KEY]	String
DepartmentName	String
Description	String
LCID	Int
TimesheetClassName	String
TimesheetClassType	Int

TimesheetLineActualDataSet

Retrieve timesheet line actual dataset.

Columns


Name	Type	References	Description
AdjustmentIndex [KEY]	Int
TimeByDay [KEY]	Datetime
TimesheetLineId [KEY]	String
ActualOvertimeWorkBillable	Decimal
ActualOvertimeWorkNonBillable	Decimal
ActualWorkBillable	Decimal
ActualWorkNonBillable	Decimal
Comment	String
CreatedDate	Datetime
LastChangedResourceName	String
PlannedWork	Decimal
ResourceName	String
TimeByDay_DayOfMonth	Int
TimeByDay_DayOfWeek	Int
TimesheetLineModifiedDate	Datetime
LinkedLastChangedByResource	String
LinkedTime	String
LinkedTimesheetLine	String

TimesheetLines

Retrieve timesheet lines.

Columns


Name	Type	References	Description
TimesheetLineId [KEY]	String
ActualOvertimeWorkBillable	Decimal
ActualOvertimeWorkNonBillable	Decimal
ActualWorkBillable	Decimal
ActualWorkNonBillable	Decimal
AssignmentId	String
CreatedDate	Datetime
LastSavedWork	Decimal
LCID	Int
ModifiedDate	Datetime
PeriodEndDate	Datetime
PeriodStartDate	Datetime
PlannedWork	Decimal
ProjectId	String
ProjectName	String
TaskHierarchy	String
TaskId	String
TaskName	String
TimesheetApproverResourceId	String
TimesheetApproverResourceName	String
TimesheetClassDescription	String
TimesheetClassId	String
TimesheetClassName	String
TimesheetClassType	Int
TimesheetId	String
TimesheetLineComment	String
TimesheetLineStatus	String
TimesheetLineStatusId	Int
TimesheetName	String
TimesheetOwner	String
TimesheetOwnerId	String
TimesheetPeriodId	String
TimesheetPeriodName	String
TimesheetPeriodStatus	String
TimesheetPeriodStatusId	Int
TimesheetStatus	String
TimesheetStatusId	Int
LinkedActuals	String
LinkedApproverResource	String
LinkedTimesheet	String
LinkedTimesheetClass	String

TimesheetPeriods

Retrieve timesheet periods.

Columns


Name	Type	References	Description
PeriodId [KEY]	String
Description	String
EndDate	Datetime
LCID	Int
PeriodName	String
PeriodStatusId	Int
StartDate	Datetime

Timesheets

Retrieve timesheets.

Columns


Name	Type	References	Description
TimesheetId [KEY]	String
Comment	String
Description	String
EndDate	Datetime
ModifiedDate	Datetime
PeriodId	String
PeriodName	String
PeriodStatusId	Int
StartDate	Datetime
StatusDescription	String
TimesheetName	String
TimesheetOwner	String
TimesheetOwnerId	String
TimesheetStatusId	Int
LinkedLines	String
LinkedPeriods	String

Stored Procedures

Stored procedures are function-like interfaces that extend the functionality of the Sync App beyond simple SELECT/INSERT/UPDATE/DELETE operations with Microsoft Project.

Stored procedures accept a list of parameters, perform their intended function, and then return any relevant response data from Microsoft Project, along with an indication of whether the procedure succeeded or failed.

Microsoft Project Connector for CData Sync Stored Procedures


Name	Description
GetOnlineCookies	Retrieves the cookies for authentication with SharePoint Online.

GetOAuthAccessToken

Gets an authentication token from Microsoft Project.

Input


Name	Type	Description
Scope	String	A comma-separated list of permissions to request from the user. Please check the Microsoft Project API for a list of available permissions.
CallbackUrl	String	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL you have specified in the Microsoft Project app settings. Only needed when the Authmode parameter is Web.
Verifier	String	The verifier returned from Microsoft Project after the user has authorized your app to have access to their data. This value will be returned as a parameter to the callback URL.
State	String	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the Microsoft Project authorization server and back. Uses include redirecting the user to the correct resource in your site, nonces, and cross-site-request-forgery mitigations.

Result Set Columns


Name	Type	Description
OAuthAccessToken	String	The access token used for communication with Microsoft Project.
OAuthRefreshToken	String	The OAuth refresh token. This is the same as the access token in the case of Microsoft Project.
ExpiresIn	String	The remaining lifetime on the access token. A -1 denotes that it will not expire.

GetOAuthAuthorizationURL

Gets the authorization URL that must be opened separately by the user to grant access to your application. Only needed when developing Web apps. You will request the OAuthAccessToken from this URL.

Input


Name	Type	Description
CallbackUrl	String	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL in the Microsoft Project app settings.
Scope	String	A comma-separated list of scopes to request from the user. Please check the Microsoft Project API documentation for a list of available permissions.
State	String	Indicates any state which may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the Microsoft Project authorization server and back. Uses include redirecting the user to the correct resource in your site, nonces, and cross-site-request-forgery mitigations.

Result Set Columns


Name	Type	Description
URL	String	The authorization URL, entered into a Web browser to obtain the verifier token and authorize your app.

GetOnlineCookies

Retrieves the cookies for authentication with SharePoint Online.

Input


Name	Type	Description
User	String	Your SharePoint Online username.
Password	String	Your SharePoint Online password.
STSURL	String	Your SharePoint Online STSURL. This only needs to be set if your organization uses a local ADFS server for authentication.

Result Set Columns


Name	Type	Description
Cookie	String	The cookies that will need to be entered in the AuthCookie connection string property.

RefreshOAuthAccessToken

Refreshes the OAuth access token used for authentication with Microsoft Project.

Input


Name	Type	Description
OAuthRefreshToken	String	Set this to the token value that expired.

Result Set Columns


Name	Type	Description
OAuthAccessToken	String	The authentication token returned from Microsoft Project. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken	String	This is the same as the access token.
ExpiresIn	String	The remaining lifetime on the access token.

Data Type Mapping

Data Type Mappings

The Sync App maps types from the data source to the corresponding data type available in the schema. The table below documents these mappings.


Microsoft Project (OData V3)	CData Schema
Edm.Binary	binary
Edm.Boolean	bool
Edm.DateTime	datetime
Edm.Decimal	decimal
Edm.Double	double
Edm.Guid	guid
Edm.Int32	int
Edm.String	string
Edm.TimeOfDay	time

Connection String Options

The connection string properties are the various options that can be used to establish a connection. This section provides a complete list of the options you can configure in the connection string for this provider. Click the links for further details.

For more information on establishing a connection, see Establishing a Connection.

Authentication

Property	Description
AuthScheme	Specifies the authentication scheme used to connect to Microsoft Project.
URL	Specifies the URL of the MS Project Web App site collection.
User	Specifies the authenticating user's user ID.
Password	Specifies the authenticating user's password.

Connection

Property	Description
ProjectId	Specifies the default project identifier. The provider uses this value for operations that require a project context. You can override this value by specifying a ProjectId filter in the query.
AuthCookie	Specifies the authentication cookie to use when connecting to the SharePoint Online server.

Azure Authentication

Property	Description
AzureTenant	Identifies the Microsoft Project tenant being used to access data. Accepts either the tenant's domain name (for example, contoso.onmicrosoft.com ) or its directory (tenant) ID.
AzureEnvironment	Specifies the Azure network environment to which you will connect. Must be the same network to which your Azure account was added.

SSO

Property	Description
SSOLoginURL	The identity provider's login URL.
SSODomain	Specifies the domain to use when authenticating through a Single Sign-On (SSO) service.
SSOProperties	Additional properties required to connect to the identity provider, formatted as a semicolon-separated list.

OAuth

Property	Description
OAuthClientId	Specifies the client ID (also known as the consumer key) assigned to your custom OAuth application. This ID is required to identify the application to the OAuth authorization server during authentication.
OAuthClientSecret	Specifies the client secret assigned to your custom OAuth application. This confidential value is used to authenticate the application to the OAuth authorization server. (Custom OAuth applications only.).
Scope	Specifies the OAuth scopes requested during authentication. Multiple scopes must be separated by whitespace.
State	Optional value for representing extra OAuth state information.

SSL

Property	Description
SSLServerCert	Specifies the certificate to be accepted from the server when connecting using TLS/SSL.

Firewall

Property	Description
FirewallType	Specifies the protocol the provider uses to tunnel traffic through a proxy-based firewall.
FirewallServer	Identifies the IP address, DNS name, or host name of a proxy used to traverse a firewall and relay user queries to network resources.
FirewallPort	Specifies the TCP port to be used for a proxy-based firewall.
FirewallUser	Identifies the user ID of the account authenticating to a proxy-based firewall.
FirewallPassword	Specifies the password of the user account authenticating to a proxy-based firewall.

Proxy

Property	Description
ProxyAutoDetect	Specifies whether the provider checks your system proxy settings for existing proxy server configurations, rather than using a manually specified proxy server.
ProxyServer	Identifies the hostname or IP address of the proxy server through which you want to route HTTP traffic.
ProxyPort	Identifies the TCP port on your specified proxy server that has been reserved for routing HTTP traffic to and from the client.
ProxyAuthScheme	Specifies the authentication method the provider uses when authenticating to the proxy server specified in the ProxyServer connection property.
ProxyUser	Provides the username of a user account registered with the proxy server specified in the ProxyServer connection property.
ProxyPassword	Specifies the password of the user specified in the ProxyUser connection property.
ProxySSLType	Specifies the SSL type to use when connecting to the proxy server specified in the ProxyServer connection property.
ProxyExceptions	Specifies a semicolon-separated list of destination hostnames or IPs that are exempt from connecting through the proxy server set in the ProxyServer connection property.

Logging

Property	Description
LogModules	Specifies the core modules to include in the log file. Use a semicolon-separated list of module names. By default, all modules are logged.

Schema

Property	Description
Location	Specifies the location of a directory containing schema files that define tables, views, and stored procedures. Depending on your service's requirements, this may be expressed as either an absolute path or a relative path.
BrowsableSchemas	Optional setting that restricts the schemas reported to a subset of all available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC .
Tables	Optional setting that restricts the tables reported to a subset of all available tables. For example, Tables=TableA,TableB,TableC .
Views	Optional setting that restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC .
Schema	Specifies the schema type used when interacting with Microsoft Project.

Miscellaneous

Property	Description
InsertMode	Specifies the insert method that the provider uses when writing data to Microsoft Project.
MaxProjectionLength	Set this to override the maximum length of characters supported in the $select system query option by the Microsoft Project API service.
MaxRows	Specifies the maximum number of rows returned for queries that do not include either aggregation or GROUP BY.
Other	Specifies advanced connection properties for specialized scenarios. Use this property only under the guidance of our Support team to address specific issues.
Pagesize	Specifies the maximum number of records per page the provider returns when requesting data from Microsoft Project.
PseudoColumns	Specifies the pseudocolumns to expose as table columns, expressed as a string in the format 'TableName=ColumnName;TableName=ColumnName'.
Timeout	Specifies the maximum time, in seconds, that the provider waits for a server response before throwing a timeout error.
UserDefinedViews	Specifies a filepath to a JSON configuration file that defines custom views. The provider automatically detects and uses the views specified in this file.
UseSimpleNames	Specifies whether or not simple names should be used for tables and columns.

Authentication

This section provides a complete list of the Authentication properties you can configure in the connection string for this provider.

Property	Description
AuthScheme	Specifies the authentication scheme used to connect to Microsoft Project.
URL	Specifies the URL of the MS Project Web App site collection.
User	Specifies the authenticating user's user ID.
Password	Specifies the authenticating user's password.

AuthScheme

Specifies the authentication scheme used to connect to Microsoft Project.

Remarks

This property determines the mechanism that Sync App uses to authenticate to Microsoft Project. If omitted, the default is SharePointOnlineCookies.

Authentication options:

SharePointOnlineCookies: Uses browser-based cookies obtained from a SharePoint Online session. Set User and Password to perform cookie-based authentication to your SharePoint Online server.
OAuth: Uses OAuth-based authentication. Select this value to authenticate using an OAuth flow supported by SharePoint Online or your identity provider.
ADFS: Uses Active Directory Federation Services for Single Sign-On authentication in on-premise or hybrid environments.
OKTA: Uses Single Sign-On authentication through OKTA as the identity provider.
OneLogin: Uses Single Sign-On authentication through OneLogin as the identity provider.
AzureAD: Uses Azure Active Directory for authentication.

URL

Specifies the URL of the MS Project Web App site collection.

Remarks

This property defines the base URL of the Microsoft Project Web App site that Sync App connects to. The value must point to the Project Web App (PWA) site collection for your environment. For example: https://MyOrganization.sharepoint.com/sites/pwa/.

User

Specifies the authenticating user's user ID.

Remarks

The authenticating server requires both User and Password to validate the user's identity.

Password

Specifies the authenticating user's password.

Remarks

The authenticating server requires both User and Password to validate the user's identity.

Connection

This section provides a complete list of the Connection properties you can configure in the connection string for this provider.

Property	Description
ProjectId	Specifies the default project identifier. The provider uses this value for operations that require a project context. You can override this value by specifying a ProjectId filter in the query.
AuthCookie	Specifies the authentication cookie to use when connecting to the SharePoint Online server.

ProjectId

Specifies the default project identifier. The provider uses this value for operations that require a project context. You can override this value by specifying a ProjectId filter in the query.

Remarks

This property defines the default project that Sync App uses when performing operations that require a ProjectId.

This property applies only when using the ODataV2 schema. In the ODataV1 schema, the ProjectData endpoints return data for all available projects, and no ProjectId value is required.

Setting a default ProjectId can reduce the need for project-level filtering in each query and may simplify request construction when repeatedly working with the same project.

AuthCookie

Specifies the authentication cookie to use when connecting to the SharePoint Online server.

Remarks

This property supplies the authentication cookie that Sync App uses when establishing a session with SharePoint Online. The cookie must be obtained from a valid browser session for the SharePoint site.

To retrieve the cookie, sign in to https://yourdomain.sharepoint.com/TeamSite and select the option to stay signed in so that the authentication cookie is generated and persisted.

Set this property when using the SharePointOnlineCookies authentication scheme. Provide the full authentication cookie string captured from your browser session.

Azure Authentication

This section provides a complete list of the Azure Authentication properties you can configure in the connection string for this provider.

Property	Description
AzureTenant	Identifies the Microsoft Project tenant being used to access data. Accepts either the tenant's domain name (for example, contoso.onmicrosoft.com ) or its directory (tenant) ID.
AzureEnvironment	Specifies the Azure network environment to which you will connect. Must be the same network to which your Azure account was added.

AzureTenant

Identifies the Microsoft Project tenant being used to access data. Accepts either the tenant's domain name (for example, contoso.onmicrosoft.com ) or its directory (tenant) ID.

Remarks

A tenant is a digital container for your organization's users and resources, managed through Microsoft Entra ID (formerly Azure AD). Each tenant is associated with a unique directory ID, and often with a custom domain (for example, microsoft.com or contoso.onmicrosoft.com).

To find the directory (tenant) ID in the Microsoft Entra Admin Center, navigate to Microsoft Entra ID > Properties and copy the value labeled "Directory (tenant) ID".

This property is required in the following cases:

When AuthScheme is set to AzureServicePrincipal or AzureServicePrincipalCert
When AuthScheme is AzureAD and the user account belongs to multiple tenants

You can provide the tenant value in one of two formats:

A domain name (for example, contoso.onmicrosoft.com)
A directory (tenant) ID in GUID format (for example, c9d7b8e4-1234-4f90-bc1a-2a28e0f9e9e0)

Specifying the tenant explicitly ensures that the authentication request is routed to the correct directory, which is especially important when a user belongs to multiple tenants or when using service principal–based authentication.

If this value is omitted when required, authentication may fail or connect to the wrong tenant. This can result in errors such as unauthorized or resource not found.

AzureEnvironment

Specifies the Azure network environment to which you will connect. Must be the same network to which your Azure account was added.

Remarks

Required if your Azure account is part of a different network than the Global network, such as China, USGOVT, or USGOVTDOD.

SSO

This section provides a complete list of the SSO properties you can configure in the connection string for this provider.

Property	Description
SSOLoginURL	The identity provider's login URL.
SSODomain	Specifies the domain to use when authenticating through a Single Sign-On (SSO) service.
SSOProperties	Additional properties required to connect to the identity provider, formatted as a semicolon-separated list.

SSOLoginURL

The identity provider's login URL.

Remarks

The identity provider's login URL.

SSODomain

Specifies the domain to use when authenticating through a Single Sign-On (SSO) service.

Remarks

This property applies when using SSO and the domain portion of the User value differs from the domain configured in the SSO service. For example, specify this property if the user is formatted as [email protected], but the SSO service expects [email protected].

This property is applies when using ADFS, OneLogin, or OKTA authentication flows and it is used only when UseSSO is set to true.

Set this property when the user’s email domain does not match the domain expected by the selected SSO provider. Leave this value unset when both domains match.

SSOProperties

Additional properties required to connect to the identity provider, formatted as a semicolon-separated list.

Remarks

Additional properties required to connect to the identity provider, formatted as a semicolon-separated list.

This is used with the SSOLoginURL.

SSO configuration is discussed further in .

OAuth

This section provides a complete list of the OAuth properties you can configure in the connection string for this provider.

Property	Description
OAuthClientId	Specifies the client ID (also known as the consumer key) assigned to your custom OAuth application. This ID is required to identify the application to the OAuth authorization server during authentication.
OAuthClientSecret	Specifies the client secret assigned to your custom OAuth application. This confidential value is used to authenticate the application to the OAuth authorization server. (Custom OAuth applications only.).
Scope	Specifies the OAuth scopes requested during authentication. Multiple scopes must be separated by whitespace.
State	Optional value for representing extra OAuth state information.

OAuthClientId

Specifies the client ID (also known as the consumer key) assigned to your custom OAuth application. This ID is required to identify the application to the OAuth authorization server during authentication.

Remarks

This property is required in two cases:

When using a custom OAuth application, such as in web-based authentication flows, service-based authentication, or certificate-based flows that require application registration.
If the driver does not provide embedded OAuth credentials.

(When the driver provides embedded OAuth credentials, this value may already be provided by the Sync App and thus not require manual entry.)

OAuthClientId is generally used alongside other OAuth-related properties such as OAuthClientSecret and OAuthSettingsLocation when configuring an authenticated connection.

OAuthClientId is one of the key connection parameters that need to be set before users can authenticate via OAuth. You can usually find this value in your identity provider’s application registration settings. Look for a field labeled Client ID, Application ID, or Consumer Key.

While the client ID is not considered a confidential value like a client secret, it is still part of your application's identity and should be handled carefully. Avoid exposing it in public repositories or shared configuration files.

For more information on how this property is used when configuring a connection, see Establishing a Connection.

OAuthClientSecret

Specifies the client secret assigned to your custom OAuth application. This confidential value is used to authenticate the application to the OAuth authorization server. (Custom OAuth applications only.).

Remarks

This property (sometimes called the application secret or consumer secret) is required when using a custom OAuth application in any flow that requires secure client authentication, such as web-based OAuth, service-based connections, or certificate-based authorization flows. It is not required when using an embedded OAuth application.

The client secret is used during the token exchange step of the OAuth flow, when the driver requests an access token from the authorization server. If this value is missing or incorrect, authentication fails with either an invalid_client or an unauthorized_client error.

OAuthClientSecret is one of the key connection parameters that need to be set before users can authenticate via OAuth. You can obtain this value from your identity provider when registering the OAuth application.

Notes:

This value should be stored securely and never exposed in public repositories, scripts, or unsecured environments.
Client secrets may also expire after a set period. Be sure to monitor expiration dates and rotate secrets as needed to maintain uninterrupted access.

For more information on how this property is used when configuring a connection, see Establishing a Connection

Scope

Specifies the OAuth scopes requested during authentication. Multiple scopes must be separated by whitespace.

Remarks

This property defines the set of permissions that the Sync App requests when authenticating with OAuth or AzureAD. Scopes determine which operations can be performed after authentication. Set this property when you need to request additional permissions or limit the permissions for a specific authentication flow. Scopes must be separated with a space. If omitted, the Sync App applies the defaults required for the selected AuthScheme.

OAuth Defaults

When using OAuth, the Sync App requests the SharePoint add-in scopes required for Microsoft Project access. The default set includes scopes such as ProjectAdmin.Manage, Projects.Write, ProjectResources.Write, and ProjectReporting.Read.

For a complete list of available OAuth scopes and aliases, see SharePoint Add-in Authorization and Scope Aliases.

AzureAD Defaults

When using AzureAD, the Sync App requests standard Microsoft identity platform scopes. The default values include offline_access and the SharePoint resource scope for your organization, typically expressed as https://YourOrganization.sharepoint.com/.default.

You can find a list of the available Azure scopes under API Permissions > SharePoint when customizing any app in the Azure Portal's App Registrations page.

State

Optional value for representing extra OAuth state information.

Remarks

Optional value for representing extra OAuth state information.

SSL

This section provides a complete list of the SSL properties you can configure in the connection string for this provider.

Property	Description
SSLServerCert	Specifies the certificate to be accepted from the server when connecting using TLS/SSL.

SSLServerCert

Specifies the certificate to be accepted from the server when connecting using TLS/SSL.

Remarks

If you are using a TLS/SSL connection, use this property to specify the TLS/SSL certificate to be accepted from the server. If you specify a value for this property, all other certificates that are not trusted by the machine are rejected.

This property can take the following forms:


Description	Example
A full PEM Certificate (example shortened for brevity)	`-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----`
A path to a local file containing the certificate	C:\cert.cer
The public key (example shortened for brevity)	`-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----`
The MD5 Thumbprint (hex values can also be either space- or colon-separated)	`ecadbdda5a1529c58a1e9e09828d70e4`
The SHA1 Thumbprint (hex values can also be either space- or colon-separated)	`34a929226ae0819f2ec14b4a3d904f801cbb150d`

Note: It is possible to use '*' to signify that all certificates should be accepted, but due to security concerns this is not recommended.

Firewall

This section provides a complete list of the Firewall properties you can configure in the connection string for this provider.

Property	Description
FirewallType	Specifies the protocol the provider uses to tunnel traffic through a proxy-based firewall.
FirewallServer	Identifies the IP address, DNS name, or host name of a proxy used to traverse a firewall and relay user queries to network resources.
FirewallPort	Specifies the TCP port to be used for a proxy-based firewall.
FirewallUser	Identifies the user ID of the account authenticating to a proxy-based firewall.
FirewallPassword	Specifies the password of the user account authenticating to a proxy-based firewall.

FirewallType

Specifies the protocol the provider uses to tunnel traffic through a proxy-based firewall.

Remarks

A proxy-based firewall (or proxy firewall) is a network security device that acts as an intermediary between user requests and the resources they access. The proxy accepts the request of an authenticated user, tunnels through the firewall, and transmits the request to the appropriate server.

Because the proxy evaluates and transfers data backets on behalf of the requesting users, the users never connect directly with the servers, only with the proxy.

Note: By default, the Sync App connects to the system proxy. To disable this behavior and connect to one of the following proxy types, set ProxyAutoDetect to false.

The following table provides port number information for each of the supported protocols.


Protocol	Default Port	Description
TUNNEL	80	The port where the Sync App opens a connection to Microsoft Project. Traffic flows back and forth via the proxy at this location.
SOCKS4	1080	The port where the Sync App opens a connection to Microsoft Project. SOCKS 4 then passes theFirewallUser value to the proxy, which determines whether the connection request should be granted.
SOCKS5	1080	The port where the Sync App sends data to Microsoft Project. If the SOCKS 5 proxy requires authentication, set FirewallUser and FirewallPassword to credentials the proxy recognizes.

To connect to HTTP proxies, use ProxyServer and ProxyPort. To authenticate to HTTP proxies, use ProxyAuthScheme, ProxyUser, and ProxyPassword.

FirewallServer

Identifies the IP address, DNS name, or host name of a proxy used to traverse a firewall and relay user queries to network resources.

Remarks

A proxy-based firewall (or proxy firewall) is a network security device that acts as an intermediary between user requests and the resources they access. The proxy accepts the request of an authenticated user, tunnels through the firewall, and transmits the request to the appropriate server.

Because the proxy evaluates and transfers data backets on behalf of the requesting users, the users never connect directly with the servers, only with the proxy.

FirewallPort

Specifies the TCP port to be used for a proxy-based firewall.

Remarks

A proxy-based firewall (or proxy firewall) is a network security device that acts as an intermediary between user requests and the resources they access. The proxy accepts the request of an authenticated user, tunnels through the firewall, and transmits the request to the appropriate server.

Because the proxy evaluates and transfers data backets on behalf of the requesting users, the users never connect directly with the servers, only with the proxy.

FirewallUser

Identifies the user ID of the account authenticating to a proxy-based firewall.

Remarks

A proxy-based firewall (or proxy firewall) is a network security device that acts as an intermediary between user requests and the resources they access. The proxy accepts the request of an authenticated user, tunnels through the firewall, and transmits the request to the appropriate server.

Because the proxy evaluates and transfers data backets on behalf of the requesting users, the users never connect directly with the servers, only with the proxy.

FirewallPassword

Specifies the password of the user account authenticating to a proxy-based firewall.

Remarks

A proxy-based firewall (or proxy firewall) is a network security device that acts as an intermediary between user requests and the resources they access. The proxy accepts the request of an authenticated user, tunnels through the firewall, and transmits the request to the appropriate server.

Because the proxy evaluates and transfers data backets on behalf of the requesting users, the users never connect directly with the servers, only with the proxy.

Proxy

This section provides a complete list of the Proxy properties you can configure in the connection string for this provider.

Property	Description
ProxyAutoDetect	Specifies whether the provider checks your system proxy settings for existing proxy server configurations, rather than using a manually specified proxy server.
ProxyServer	Identifies the hostname or IP address of the proxy server through which you want to route HTTP traffic.
ProxyPort	Identifies the TCP port on your specified proxy server that has been reserved for routing HTTP traffic to and from the client.
ProxyAuthScheme	Specifies the authentication method the provider uses when authenticating to the proxy server specified in the ProxyServer connection property.
ProxyUser	Provides the username of a user account registered with the proxy server specified in the ProxyServer connection property.
ProxyPassword	Specifies the password of the user specified in the ProxyUser connection property.
ProxySSLType	Specifies the SSL type to use when connecting to the proxy server specified in the ProxyServer connection property.
ProxyExceptions	Specifies a semicolon-separated list of destination hostnames or IPs that are exempt from connecting through the proxy server set in the ProxyServer connection property.

ProxyAutoDetect

Specifies whether the provider checks your system proxy settings for existing proxy server configurations, rather than using a manually specified proxy server.

Remarks

When this connection property is set to True, the Sync App checks your system proxy settings for existing proxy server configurations (no need to manually supply proxy server details).

This connection property takes precedence over other proxy settings. If you want to configure the Sync App to connect to a specific proxy server, set ProxyAutoDetect to False.

To connect to an HTTP proxy, see ProxyServer. For other proxies, such as SOCKS or tunneling, see FirewallType.

ProxyServer

Identifies the hostname or IP address of the proxy server through which you want to route HTTP traffic.

Remarks

The Sync App only routes HTTP traffic through the proxy server specified in this connection property when ProxyAutoDetect is set to False.

If ProxyAutoDetect is set to True (the default), the Sync App instead routes HTTP traffic through the proxy server specified in your system proxy settings.

ProxyPort

Identifies the TCP port on your specified proxy server that has been reserved for routing HTTP traffic to and from the client.

Remarks

The Sync App only routes HTTP traffic through the ProxyServer port specified in this connection property when ProxyAutoDetect is set to False.

If ProxyAutoDetect is set to True (the default), the Sync App instead routes HTTP traffic through the proxy server port specified in your system proxy settings.

For other proxy types, see FirewallType.

ProxyAuthScheme

Specifies the authentication method the provider uses when authenticating to the proxy server specified in the ProxyServer connection property.

Remarks

Supported authentication types :

BASIC: The Sync App performs HTTP basic authentication.
DIGEST: The Sync App performs HTTP digest authentication.
NTLM: The Sync App retrieves an NTLM token.
NEGOTIATE: The Sync App retrieves an NTLM or Kerberos token based on the applicable protocol for authentication.
NONE: Signifies that the ProxyServer does not require authentication.

For all values other than NONE, you must also set the ProxyUser and ProxyPassword connection properties.

If you need to use another authentication type, such as SOCKS 5 authentication, see FirewallType.

ProxyUser

Provides the username of a user account registered with the proxy server specified in the ProxyServer connection property.

Remarks

The ProxyUser and ProxyPassword connection properties are used to connect and authenticate against the HTTP proxy specified in ProxyServer.

After selecting one of the available authentication types in ProxyAuthScheme, set this property as follows:


ProxyAuthScheme Value	Value to set for ProxyUser
BASIC	The username of a user registered with the proxy server.
DIGEST	The username of a user registered with the proxy server.
NEGOTIATE	The username of a Windows user who is a valid user in the domain or trusted domain that the proxy server is part of, in the format `user@domain` or `domain\user`.
NTLM	The username of a Windows user who is a valid user in the domain or trusted domain that the proxy server is part of, in the format `user@domain` or `domain\user`.
NONE	Do not set the ProxyPassword connection property.

Note: The Sync App only uses this username if ProxyAutoDetect is set to False. If ProxyAutoDetect is set to True (the default), the Sync App instead uses the username specified in your system proxy settings.

ProxyPassword

Specifies the password of the user specified in the ProxyUser connection property.

Remarks

The ProxyUser and ProxyPassword connection properties are used to connect and authenticate against the HTTP proxy specified in ProxyServer.

After selecting one of the available authentication types in ProxyAuthScheme, set this property as follows:


ProxyAuthScheme Value	Value to set for ProxyPassword
BASIC	The password associated with the proxy server user specified in ProxyUser.
DIGEST	The password associated with the proxy server user specified in ProxyUser.
NEGOTIATE	The password associated with the Windows user account specified in ProxyUser.
NTLM	The password associated with the Windows user account specified in ProxyUser.
NONE	Do not set the ProxyPassword connection property.

For SOCKS 5 authentication or tunneling, see FirewallType.

Note: The Sync App only uses this password if ProxyAutoDetect is set to False. If ProxyAutoDetect is set to True (the default), the Sync App instead uses the password specified in your system proxy settings.

ProxySSLType

Specifies the SSL type to use when connecting to the proxy server specified in the ProxyServer connection property.

Remarks

This property determines when to use SSL for the connection to the HTTP proxy specified by ProxyServer. You can set this connection property to the following values :


AUTO	Default setting. If ProxyServer is set to an HTTPS URL, the Sync App uses the TUNNEL option. If ProxyServer is set to an HTTP URL, the component uses the NEVER option.
ALWAYS	The connection is always SSL enabled.
NEVER	The connection is not SSL enabled.
TUNNEL	The connection is made through a tunneling proxy. The proxy server opens a connection to the remote host and traffic flows back and forth through the proxy.

ProxyExceptions

Specifies a semicolon-separated list of destination hostnames or IPs that are exempt from connecting through the proxy server set in the ProxyServer connection property.

Remarks

The ProxyServer is used for all addresses, except for addresses defined in this property. Use semicolons to separate entries.

Note: The Sync App uses the system proxy settings by default, without further configuration needed. If you want to explicitly configure proxy exceptions for this connection, set ProxyAutoDetect to False.

Logging

This section provides a complete list of the Logging properties you can configure in the connection string for this provider.

Property	Description
LogModules	Specifies the core modules to include in the log file. Use a semicolon-separated list of module names. By default, all modules are logged.

LogModules

Specifies the core modules to include in the log file. Use a semicolon-separated list of module names. By default, all modules are logged.

Remarks

The Sync App writes details about each operation it performs into the logfile specified by the Logfile connection property.

Each of these logged operations are assigned to a themed category called a module, and each module has a corresponding short code used to labels individual Sync App operations as belonging to that module.

When this connection property is set to a semicolon-separated list of module codes, only operations belonging to the specified modules are written to the logfile. Note that this only affects which operations are logged moving forward and doesn't retroactively alter the existing contents of the logfile. For example: INFO;EXEC;SSL;META;

By default, logged operations from all modules are included.

You can explicitly exclude a module by prefixing it with a "-". For example: -HTTP

To apply filters to submodules, identify them with the syntax <module name>.<submodule name>. For example, the following value causes the Sync App to only log actions belonging to the HTTP module, and further refines it to exclude actions belonging to the Res submodule of the HTTP module: HTTP;-HTTP.Res

Note that the logfile filtering triggered by the Verbosity connection property takes precedence over the filtering imposed by this connection property. This means that operations of a higher verbosity level than the level specified in the Verbosity connection property are not printed in the logfile, even if they belong to one of the modules specified in this connection property.

The available modules and submodules are:


Module Name	Module Description	Submodules
INFO	General Information. Includes the connection string, product version (build number), and initial connection messages.	Connec – Information related to creating or destroying connections. Messag – Generic label for messages pertaining to connections, the connection string, and product version. These messages are typically specific to the Sync App, rather than being received and passed along directly from the service.
EXEC	Query Execution. Includes execution messages for user-written SQL queries, parsed SQL queries, and normalized SQL queries. Success/failure messages for queries and query pages appear here as well.	Messag – Messages pertaining to query execution. These messages are typically specific to the Sync App, rather than being received and passed along directly from the service. Normlz – Query normalization steps. Query normalization is when the product takes the user-submitted query and rewrites the query to get the same results with optimal performance. Origin – This label applies to any messages recording a user's original query (the exact, unaltered, non-normalized query executed by the user). Page – Messages related to query paging. Parsed – Query parsing steps. Parsing is the process of converting the user-submitted query into a standardized format for easier processing.
HTTP	HTTP protocol messages. Includes HTTP requests/responses (including POST messages), as well as Kerberos related messages.	KERB – HTTP requests related to Kerberos. Messag – Messages pertaining to HTTP protocols. These messages are typically specific to the Sync App, rather than being received and passed along directly from the service. Unpack – This label applies to messages about zipped data being returned from the service API and unpacked by the product. Res – Messages containing HTTP responses. Req – Messages containing HTTP requests.
WSDL	Messages pertaining to the generation of WSDL/XSD files.	—
SSL	SSL certificate messages.	Certif – Messages pertaining to SSL certificates.
AUTH	Authentication related failure/success messages.	Messag – Messages pertaining to authentication. These messages are typically specific to the Sync App, rather than being received and passed along directly from the service. OAuth – Messages related to OAuth authentication. Krbros – Kerberos-related authentication messages.
SQL	Includes SQL transactions, SQL bulk transfer messages, and SQL result set messages.	Bulk – Messages pertaining to bulk query execution. Cache – Messages related to reading row data from and writing row data to the product's cache for better performance. Messag – Messages pertaining to SQL transactions. These messages are typically specific to the Sync App, rather than being received and passed along directly from the service. ResSet – Query resultsets. Transc – Messages related to handling transactions, including information about the number of jobs executed and backup table handling.
META	Metadata cache and schema messages.	Cache – Messages related to reading from and modifying column and table definitions in the product's cache for better performance. Schema – Messages related to retrieving metadata from or modifying the service schema. MemSto – Messages related to writing to or reading from in-memory metadata cache. Storag – Messages relating to storing metadata on disk or in an external data store, rather than in memory.
FUNC	Information related to executing SQL functions.	Errmsg – Error messages related to executing SQL functions.
TCP	Incoming and outgoing raw bytes on TCP transport layer messages.	Send – Raw data sent via the TCP protocol. Receiv – Raw data received via the TCP protocol.
FTP	Messages pertaining to the File Transfer Protocol.	Info – Status messages related to communication in the FTP protocol. Client – Messages related to actions taken by the FTP client (the product) during FTP communication. Server – Messages related to actions taken by the FTP server during FTP communication.
SFTP	Messages pertaining to the Secure File Transfer Protocol.	Info – Status messages related to communication in the SFTP protocol. To_Server – Messages related to actions taken by the SFTP client (the product) during SFTP communication. From_Server – Messages related to actions taken by the SFTP server during SFTP communication.
POP	Messages pertaining to data transferred via the Post Office Protocol.	Client – Messages related to actions taken by the POP client (the product) during POP communication. Server – Messages related to actions taken by the POP server during POP communication. Status – Status messages related to communication in the POP protocol.
SMTP	Messages pertaining to data transferred via the Simple Mail Transfer Protocol.	Client – Messages related to actions taken by the SMTP client (the product) during SMTP communication. Server – Messages related to actions taken by the SMTP server during SMTP communication. Status – Status messages related to communication in the SMTP protocol.
CORE	Messages relating to various internal product operations not covered by other modules.	—
DEMN	Messages related to SQL remoting.	—
CLJB	Messages about bulk data uploads (cloud job).	Commit – Submissions for bulk data uploads.
SRCE	Miscellaneous messages produced by the product that don't belong in any other module.	—
TRANCE	Advanced messages concerning low-level product operations.	—

Schema

This section provides a complete list of the Schema properties you can configure in the connection string for this provider.

Property	Description
Location	Specifies the location of a directory containing schema files that define tables, views, and stored procedures. Depending on your service's requirements, this may be expressed as either an absolute path or a relative path.
BrowsableSchemas	Optional setting that restricts the schemas reported to a subset of all available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC .
Tables	Optional setting that restricts the tables reported to a subset of all available tables. For example, Tables=TableA,TableB,TableC .
Views	Optional setting that restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC .
Schema	Specifies the schema type used when interacting with Microsoft Project.

Location

Specifies the location of a directory containing schema files that define tables, views, and stored procedures. Depending on your service's requirements, this may be expressed as either an absolute path or a relative path.

Remarks

The Location property is only needed if you want to either customize definitions (for example, change a column name, ignore a column, etc.) or extend the data model with new tables, views, or stored procedures.

Note: Since this Sync App supports multiple schemas, custom schema files for Microsoft Project should be structured such that:

Each schema should have its own folder, named for that schema.
All schema folders should be contained in a parent folder.

Location should always be set to the parent folder, and not to an individual schema's folder.

If left unspecified, the default location is %APPDATA%\\CData\\MicrosoftProject Data Provider\\Schema, where %APPDATA% is set to the user's configuration directory:


Platform	%APPDATA%
Windows	The value of the APPDATA environment variable
Linux	~/.config

BrowsableSchemas

Optional setting that restricts the schemas reported to a subset of all available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC .

Remarks

Listing all available database schemas can take extra time, thus degrading performance. Providing a list of schemas in the connection string saves time and improves performance.

Tables

Optional setting that restricts the tables reported to a subset of all available tables. For example, Tables=TableA,TableB,TableC .

Remarks

Listing all available tables from some databases can take extra time, thus degrading performance. Providing a list of tables in the connection string saves time and improves performance.

If there are lots of tables available and you already know which ones you want to work with, you can use this property to restrict your viewing to only those tables. To do this, specify the tables you want in a comma-separated list. Each table should be a valid SQL identifier with any special characters escaped using square brackets, double-quotes or backticks. For example, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Note: If you are connecting to a data source with multiple schemas or catalogs, you must specify each table you want to view by its fully qualified name. This avoids ambiguity between tables that may exist in multiple catalogs or schemas.

Views

Optional setting that restricts the views reported to a subset of the available tables. For example, Views=ViewA,ViewB,ViewC .

Remarks

Listing all available views from some databases can take extra time, thus degrading performance. Providing a list of views in the connection string saves time and improves performance.

If there are lots of views available and you already know which ones you want to work with, you can use this property to restrict your viewing to only those views. To do this, specify the views you want in a comma-separated list. Each view should be a valid SQL identifier with any special characters escaped using square brackets, double-quotes or backticks. For example, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Note: If you are connecting to a data source with multiple schemas or catalogs, you must specify each view you want to examine by its fully qualified name. This avoids ambiguity between views that may exist in multiple catalogs or schemas.

Schema

Specifies the schema type used when interacting with Microsoft Project.

Remarks

This property determines which Microsoft Project OData schema the Sync App uses when retrieving or modifying data. Each schema exposes different capabilities and field structures.

Available options:

ODataV1: Provides read-only access. Schemas are generated dynamically, and custom fields are exposed. Use this option when you need access to all available fields or when working with custom metadata.
ODataV2: Supports read, insert, update, and delete operations. Schemas are static, and main fields are retrieved dynamically, but custom fields are not exposed. Use this option when performing write operations.

Select ODataV2 to perform CRUD operations. Select ODataV1 when you require dynamic schema capabilities or need access to custom fields.

Miscellaneous

This section provides a complete list of the Miscellaneous properties you can configure in the connection string for this provider.

Property	Description
InsertMode	Specifies the insert method that the provider uses when writing data to Microsoft Project.
MaxProjectionLength	Set this to override the maximum length of characters supported in the $select system query option by the Microsoft Project API service.
MaxRows	Specifies the maximum number of rows returned for queries that do not include either aggregation or GROUP BY.
Other	Specifies advanced connection properties for specialized scenarios. Use this property only under the guidance of our Support team to address specific issues.
Pagesize	Specifies the maximum number of records per page the provider returns when requesting data from Microsoft Project.
PseudoColumns	Specifies the pseudocolumns to expose as table columns, expressed as a string in the format 'TableName=ColumnName;TableName=ColumnName'.
Timeout	Specifies the maximum time, in seconds, that the provider waits for a server response before throwing a timeout error.
UserDefinedViews	Specifies a filepath to a JSON configuration file that defines custom views. The provider automatically detects and uses the views specified in this file.
UseSimpleNames	Specifies whether or not simple names should be used for tables and columns.

InsertMode

Specifies the insert method that the provider uses when writing data to Microsoft Project.

Remarks

Set this property to control how the Sync App performs insert operations. Leave the value as ADD unless your scenario requires OData-specific behavior.

Available options:

ADD (recommended): Uses the standard Microsoft Project Add functions for insert operations. This mode performs validation based on Microsoft Project’s object model and is appropriate for most write scenarios.
ODATA: Uses the service’s OData insert functionality. This mode provides more direct write access, but does not validate that the insert was successful and does not support deep inserts. Use this option only when you are certain a column is writable and inserting into fields that cannot be written using ADD mode.

The ODATA mode may result in incomplete or partially written data if the service cannot validate inserts. In such cases, in the status-indicating resultset the Sync App returns after executing an INSERT, the AffectedRows column returns a value of "-1" to indicate that the success of the operation couldn't be verified. The ODATA mode is also unable to verify the success of UPDATE queries.

ADD mode generally provides more reliable write operations and reduces the likelihood of inconsistent data states.

MaxProjectionLength

Note: Deprecated in favor of automatically calculating the largest set of columns allowed per request.

Set this to override the maximum length of characters supported in the $select system query option by the Microsoft Project API service.

Remarks

In case the set MaxProjectionLength is exceeded when selecting multiple columns, the Sync App will split the query into multiple requests, each of them containing a subset of the selected columns. Decreasing the value can help in cases when the API might not return all the columns in the response or might throw an error because the value specified in $select is too long. On the other hand, increasing it can result in better performance because fewer HTTP requests are sent. Set the value to -1 to send all selected columns in one request regardless of the length.

MaxRows

Specifies the maximum number of rows returned for queries that do not include either aggregation or GROUP BY.

Remarks

The default value for this property, -1, means that no row limit is enforced unless the query explicitly includes a LIMIT clause. (When a query includes a LIMIT clause, the value specified in the query takes precedence over the MaxRows setting.)

Setting MaxRows to a whole number greater than 0 ensures that queries do not return excessively large result sets by default.

This property is useful for optimizing performance and preventing excessive resource consumption when executing queries that could otherwise return very large datasets.

Other

Specifies advanced connection properties for specialized scenarios. Use this property only under the guidance of our Support team to address specific issues.

Remarks

This property allows advanced users to configure hidden properties for specialized situations, with the advice of our Support team. These settings are not required for normal use cases but can address unique requirements or provide additional functionality. To define multiple properties, use a semicolon-separated list.

Note: It is strongly recommended to set these properties only when advised by the Support team to address specific scenarios or issues.

Integration and Formatting


Property	Description
DefaultColumnSize	Sets the default length of string fields when the data source does not provide column length in the metadata. The default value is 2000.
ConvertDateTimeToGMT=True	Converts date-time values to GMT, instead of the local time of the machine. The default value is False (use local time).
RecordToFile=filename	Records the underlying socket data transfer to the specified file.

Pagesize

Specifies the maximum number of records per page the provider returns when requesting data from Microsoft Project.

Remarks

When processing a query, instead of requesting all of the queried data at once from Microsoft Project, the Sync App can request the queried data in pieces called pages.

This connection property determines the maximum number of results that the Sync App requests per page.

Note: Setting large page sizes may improve overall query execution time, but doing so causes the Sync App to use more memory when executing queries and risks triggering a timeout.

PseudoColumns

Specifies the pseudocolumns to expose as table columns, expressed as a string in the format 'TableName=ColumnName;TableName=ColumnName'.

Remarks

This property allows you to define which pseudocolumns the Sync App exposes as table columns.

To specify individual pseudocolumns, use the following format:

Table1=Column1;Table1=Column2;Table2=Column3

To include all pseudocolumns for all tables use:

*=*

Timeout

Specifies the maximum time, in seconds, that the provider waits for a server response before throwing a timeout error.

Remarks

The timeout applies to each individual communication with the server rather than the entire query or operation. For example, a query could continue running beyond 60 seconds if each paging call completes within the timeout limit.

Timeout is set to 60 seconds by default. To disable timeouts, set this property to 0.

Disabling the timeout allows operations to run indefinitely until they succeed or fail due to other conditions such as server-side timeouts, network interruptions, or resource limits on the server.

Note: Use this property cautiously to avoid long-running operations that could degrade performance or result in unresponsive behavior.

UserDefinedViews

Specifies a filepath to a JSON configuration file that defines custom views. The provider automatically detects and uses the views specified in this file.

Remarks

UserDefinedViews allows you to define and manage custom views through a JSON-formatted configuration file called UserDefinedViews.json. These views are automatically recognized by the Sync App and enable you to execute custom SQL queries as if they were standard database views. The JSON file defines each view as a root element with a child element called "query", which contains the SQL query for the view.

For example:

{
	"MyView": {
		"query": "SELECT * FROM Projects WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

You can use this property to define multiple views in a single file and specify the filepath. For example:

UserDefinedViews=C:\Path\To\UserDefinedViews.json

When you specify a view in UserDefinedViews, the Sync App only sees that view.

For further information, see User Defined Views.

UseSimpleNames

Specifies whether or not simple names should be used for tables and columns.

Remarks

Microsoft Project tables can include special characters in their names that are typically not allowed in standard databases. This property makes the Sync App easier to use with traditional database tools.

Setting UseSimpleNames to True simplifies the names of the columns that are returned. It enforces a naming scheme where only alphanumeric characters and underscores are valid for displayed column names.

Notes:

Any non-alphanumeric characters are converted to underscores.
If the column or table names exceed 128 characters in length they are truncated to 128 characters to comply with SQL Server standards.

Third Party Copyrights

LZMA from 7Zip LZMA SDK

LZMA SDK is placed in the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original LZMA SDK code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

LZMA2 from XZ SDK

Version 1.9 and older are in the public domain.

Xamarin.Forms

Xamarin SDK

The MIT License (MIT)

Copyright (c) .NET Foundation Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NSIS 3.10

Copyright (C) 1999-2025 Contributors THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

1. DEFINITIONS

"Contribution" means:

a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor:

i) changes to the Program, and

ii) additions to the Program;

where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.

"Contributor" means any person or entity that distributes the Program.

"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.

"Program" means the Contributions distributed in accordance with this Agreement.

"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.

2. GRANT OF RIGHTS

a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.

b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.

c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.

d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.

3. REQUIREMENTS

A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:

a) it complies with the terms and conditions of this Agreement; and

b) its license agreement:

i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;

ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;

iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and

iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.

When the Program is made available in source code form:

a) it must be made available under this Agreement; and

b) a copy of this Agreement must be included with each copy of the Program.

Contributors may not remove or alter any copyright notices contained within the Program.

Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.

4. COMMERCIAL DISTRIBUTION

Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.

For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.

5. NO WARRANTY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.

6. DISCLAIMER OF LIABILITY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

7. GENERAL

If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.

If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.

All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.

Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.

This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.

Microsoft Project Connector for CData Sync

Microsoft Project Connector for CData Sync

Overview

Microsoft Project Version Support

Establishing a Connection

Adding a Connection to Microsoft Project

Connecting to Microsoft Project

Authenticating to Microsoft Project

SharePoint Online Cookie Service

OAuth

ADFS

ADFS Integrated

Supported SSO Providers

Okta

OneLogin

Azure AD

CSOM Deprecation

CSOM Support Discontinued

Advanced Features

User Defined Views

SSL Configuration

Firewall and Proxy

Query Processing

Logging

SSL Configuration

Customizing the SSL Configuration

Firewall and Proxy

Connecting Through a Firewall or Proxy

HTTP Proxies

Other Proxies

Data Model

Overview

Connecting with the ODataV2 Schema

Connecting with the ODataV1 Schema

Key Features

ODataV2 Data Model

Tables

Views

Stored Procedures

ODataV2 Limitations

Published and Draft Objects

Published and Draft Objects

Draft Tables

Published Tables

Tables

Microsoft Project Connector for CData Sync Tables

Calendars

Table Specific Information

Insert

Columns

Pseudo-Columns

DraftAssignments

Table Specific Information

Insert

Columns

Pseudo-Columns

DraftProjectResources

Table Specific Information

Insert

Columns

Pseudo-Columns

DraftProjects

Table Specific Information

Columns

DraftTaskLinks

Table Specific Information

Insert

Columns

Pseudo-Columns

DraftTasks

Table Specific Information

Insert

Columns

Pseudo-Columns

EnterpriseProjectTypes

Table Specific Information

Columns

Pseudo-Columns

EnterpriseResources

Table Specific Information