Getting Started

This page provides a guide to Establishing a Connection to Microsoft Project in CData Cloud, as well as information on the available resources, and a reference to the available connection properties.

Connecting to Microsoft Project

Establishing a Connection shows how to authenticate to Microsoft Project and configure any necessary connection properties to create a database in CData Cloud

Accessing Data from CData Cloud Services

Accessing data from Microsoft Project through the available standard services and CData Cloud administration is documented in further details in the CData Cloud Documentation.

Establishing a Connection

Connect to Microsoft Project by selecting the corresponding icon in the Database tab. Required properties are listed under Settings. The Advanced tab lists connection properties that are not typically required.

Connecting to Microsoft Project

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

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

Authenticating to Microsoft Project

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

SharePoint Online Cookie Service

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

OAuth

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

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

Automatic refresh of the OAuth access token:

To have the Cloud 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 Cloud 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 the AuthScheme to ADFS, and set these properties:

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

Example connection string:

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

ADFS Integrated

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

Supported SSO Providers

Okta

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

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

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

APIToken: When authenticating a user via a trusted application or proxy that overrides the Okta client request context, set this to the API Token the customer created from the Okta organization.
MFAType: If you have configured the MFA flow, set this to one of the following supported types: OktaVerify, Email, or SMS.
MFAPassCode: If you have configured the MFA flow, set this to a valid passcode.
If you set this to empty or an invalid value, the Cloud 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 Cloud sends a device token to extend MFA authentication lifetime. If you do not want MFA to be remembered, set this variable to False.

Example connection string:

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

OneLogin

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

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

To authenticate to OneLogin, set these SSOProperties:

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

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

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

Azure AD

This configuration requires two separate Azure AD applications:

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

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

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

To authenticate to Azure AD, set these SSOProperties:

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

Example connection string:

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

Creating a Custom OAuth Application

For users who will authenticate via OAuth, you must create a custom OAuth application to deliver the required OAuth-specific credentials, then add the scope permissions required to access the Microsoft Project API.

Create the Application

Log into the Project Web App Site through your site's UI, or by entering your site's Create App link into your browser: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/appregnew.aspx.
Fill in the required fields. When specifying the application's Callback URL (a website page where you want users to land after they grant permission to your custom OAuth application), do one of the following:
- Specify a secure URL for the page (should begin with https://).
  OR
- Specify https://oauth.cdata.com/oauth/ as the callback URL, then add an extra state connection property that contains the actual redirect callback.
Record the ClientID and ClientSecret for later use.

Add Scope Permissions

In order to access the Microsoft Project API, you must give the new OAuth application scope permissions.

Log in at https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/AppInv.aspx.
In the App Id field, enter the ClientID you obtained when creating the application.
Click Lookup. The other fields should automatically populate with application details like Title, App Domain and Redirect URL.

To specify the default permissions needed for full API access, enter the following text in the permissions request XML box:

  <AppPermissionRequests>
    <AppPermissionRequest Scope="http://sharepoint/projectserver" Right="Manage"/>
    <AppPermissionRequest Scope="http://sharepoint/projectserver/projects" Right="Write"/>
    <AppPermissionRequest Scope="http://sharepoint/projectserver/enterpriseresources" Right="Write"/>
    <AppPermissionRequest Scope="http://sharepoint/projectserver/reporting" Right="Read"/>
  </AppPermissionRequests>

Note: The logged in user should also have the appropriate permissions to access the API.

Granting User Access to Web Services

There are two different ways to give users access to web services, depending on whether your Project Web Applicat (PWA) is in Project permission mode or SharePoint permission mode.

Project Permission Mode

If your PWA is in Project Permission mode, you can grant users access to Web Services by editing their global permissions. For each user you want to add, do the following:

Open the PWA's PWA Settings page.
In the Security section, click Manage Users.
Find the user name of the interested user. Click their name. The PWA displays an Edit User box.
Expand the Global Permissions section.
Under Access Project Server Reporting Service, check Allow.

SharePoint Permission Mode

If your PWA is in SharePoint permission mode, you can grant user access to Web Services by adding them to one of four Security Groups that have at least "Access Project Server Reporting Service" access. For each user you want to add, do the following:

Open the PWA's PWA Settings page.
In the Security section, click Manage Users.
Find the user name of the interested user. Click their name. The PWA displays an Edit User box.
Under the Security Groups section, select one of the groups with the required access permissions, such as Portfolio Viewers, Portfolio Managers, and Administrators.
To add the user, click > .

CSOM Deprecation

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

CSOM Support Discontinued

Prior to the 2020 edition of the Cloud, 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.

SSL Configuration

Customizing the SSL Configuration

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

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

Firewall and Proxy

Connecting Through a Firewall or Proxy

HTTP Proxies

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

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

Other Proxies

Set the following properties:

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

Data Model

Overview

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

Connecting with the ODataV2 Schema

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

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

Connecting with the ODataV1 Schema

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

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

Key Features

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

ODataV2 Data Model

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

Tables

Tables are retrieved dynamically from the authenticated Microsoft Project account.

Views

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

Stored Procedures

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

ODataV2 advantages compared to ODataV1

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

ODataV2 limitations

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

Tables

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

CData Cloud - Microsoft Project Tables


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

Assignments

Retrieve and modify assignments.

Table Specific Information

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

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

Columns


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

Calendars

Retrieve and modify calendars.

Columns


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

EnterpriseResources

Retrieve and modify resources.

Columns


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

Phases

Retrieve and modify project phases.

Columns


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

ProjectResources

Retrieve and modify project resources.

Table Specific Information

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

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

Columns


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

Projects

Retrieve and modify projects.

Columns


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

Stages

Retrieve and modify project stages.

Columns


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

TaskLinks

Retrieve and modify task links.

Table Specific Information

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

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

Columns


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

Tasks

Retrieve and modify tasks.

Table Specific Information

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

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

Columns


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

TimeSheetLines

Retrieve and modify timesheets.

Columns


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

TimeSheets

Retrieve and modify timesheets.

Columns


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

Views

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.

CData Cloud - Microsoft Project Views


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

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

Columns


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

ProjectDetailPages

Retrieve project details.

Columns


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

StageDetailPages

Retrieve project details..

Columns


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

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

Columns


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

Stored Procedures

Stored procedures are function-like interfaces that extend the functionality of the Cloud 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.

CData Cloud - Microsoft Project Stored Procedures


Name	Description
CheckIn	Check in the specified project.
CheckOut	Check out the specified project.
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.

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.

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.

CData Cloud - Microsoft Project 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

References Description String [KEY] Int [KEY] String Decimal Decimal Decimal Decimal Datetime Decimal Datetime Datetime Decimal Int String String String String String String String />


Name	Type style="white-space:nowrap">AssignmentId
BaselineNumber
ProjectId
AssignmentBaselineBudgetCost
AssignmentBaselineBudgetMaterialWork
AssignmentBaselineBudgetWork
AssignmentBaselineCost
AssignmentBaselineFinishDate
AssignmentBaselineMaterialWork
AssignmentBaselineModifiedDate
AssignmentBaselineStartDate
AssignmentBaselineWork
AssignmentType
ProjectName
TaskId
TaskName
LinkedAssignment
LinkedAssignmentBaselineTimephasedDataSet
LinkedProject
LinkedTask

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

CData Cloud - Microsoft Project Stored Procedures


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

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.

System Tables

You can query the system tables described in this section to access schema information, information on data source functionality, and batch operation statistics.

Schema Tables

The following tables return database metadata for Microsoft Project:

sys_catalogs: Lists the available databases.
sys_schemas: Lists the available schemas.
sys_tables: Lists the available tables and views.
sys_tablecolumns: Describes the columns of the available tables and views.
sys_procedures: Describes the available stored procedures.
sys_procedureparameters: Describes stored procedure parameters.
sys_keycolumns: Describes the primary and foreign keys.
sys_indexes: Describes the available indexes.

Data Source Tables

The following tables return information about how to connect to and query the data source:

sys_connection_props: Returns information on the available connection properties.
sys_sqlinfo: Describes the SELECT queries that the Cloud can offload to the data source.

Query Information Tables

The following table returns query statistics for data modification queries, including batch operations::

sys_identity: Returns information about batch operations or single updates.

sys_catalogs

Lists the available databases.

The following query retrieves all databases determined by the connection string:

SELECT * FROM sys_catalogs

Columns


Name	Type	Description
CatalogName	String	The database name.

sys_schemas

Lists the available schemas.

The following query retrieves all available schemas:

          SELECT * FROM sys_schemas

Columns


Name	Type	Description
CatalogName	String	The database name.
SchemaName	String	The schema name.

sys_tables

Lists the available tables.

The following query retrieves the available tables and views:

          SELECT * FROM sys_tables

Columns


Name	Type	Description
CatalogName	String	The database containing the table or view.
SchemaName	String	The schema containing the table or view.
TableName	String	The name of the table or view.
TableType	String	The table type (table or view).
Description	String	A description of the table or view.
IsUpdateable	Boolean	Whether the table can be updated.

sys_tablecolumns

Describes the columns of the available tables and views.

The following query returns the columns and data types for the Projects table:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Projects'

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the table or view.
SchemaName	String	The schema containing the table or view.
TableName	String	The name of the table or view containing the column.
ColumnName	String	The column name.
DataTypeName	String	The data type name.
DataType	Int32	An integer indicating the data type. This value is determined at run time based on the environment.
Length	Int32	The storage size of the column.
DisplaySize	Int32	The designated column's normal maximum width in characters.
NumericPrecision	Int32	The maximum number of digits in numeric data. The column length in characters for character and date-time data.
NumericScale	Int32	The column scale or number of digits to the right of the decimal point.
IsNullable	Boolean	Whether the column can contain null.
Description	String	A brief description of the column.
Ordinal	Int32	The sequence number of the column.
IsAutoIncrement	String	Whether the column value is assigned in fixed increments.
IsGeneratedColumn	String	Whether the column is generated.
IsHidden	Boolean	Whether the column is hidden.
IsArray	Boolean	Whether the column is an array.
IsReadOnly	Boolean	Whether the column is read-only.
IsKey	Boolean	Indicates whether a field returned from sys_tablecolumns is the primary key of the table.

sys_procedures

Lists the available stored procedures.

The following query retrieves the available stored procedures:

          SELECT * FROM sys_procedures

Columns


Name	Type	Description
CatalogName	String	The database containing the stored procedure.
SchemaName	String	The schema containing the stored procedure.
ProcedureName	String	The name of the stored procedure.
Description	String	A description of the stored procedure.
ProcedureType	String	The type of the procedure, such as PROCEDURE or FUNCTION.

sys_procedureparameters

Describes stored procedure parameters.

The following query returns information about all of the input parameters for the SelectEntries stored procedure:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the stored procedure.
SchemaName	String	The name of the schema containing the stored procedure.
ProcedureName	String	The name of the stored procedure containing the parameter.
ColumnName	String	The name of the stored procedure parameter.
Direction	Int32	An integer corresponding to the type of the parameter: input (1), input/output (2), or output(4). input/output type parameters can be both input and output parameters.
DataTypeName	String	The name of the data type.
DataType	Int32	An integer indicating the data type. This value is determined at run time based on the environment.
Length	Int32	The number of characters allowed for character data. The number of digits allowed for numeric data.
NumericPrecision	Int32	The maximum precision for numeric data. The column length in characters for character and date-time data.
NumericScale	Int32	The number of digits to the right of the decimal point in numeric data.
IsNullable	Boolean	Whether the parameter can contain null.
IsRequired	Boolean	Whether the parameter is required for execution of the procedure.
IsArray	Boolean	Whether the parameter is an array.
Description	String	The description of the parameter.
Ordinal	Int32	The index of the parameter.

sys_keycolumns

Describes the primary and foreign keys.

The following query retrieves the primary key for the Projects table:

         SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Projects'

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the key.
SchemaName	String	The name of the schema containing the key.
TableName	String	The name of the table containing the key.
ColumnName	String	The name of the key column.
IsKey	Boolean	Whether the column is a primary key in the table referenced in the TableName field.
IsForeignKey	Boolean	Whether the column is a foreign key referenced in the TableName field.
PrimaryKeyName	String	The name of the primary key.
ForeignKeyName	String	The name of the foreign key.
ReferencedCatalogName	String	The database containing the primary key.
ReferencedSchemaName	String	The schema containing the primary key.
ReferencedTableName	String	The table containing the primary key.
ReferencedColumnName	String	The column name of the primary key.

sys_foreignkeys

Describes the foreign keys.

The following query retrieves all foreign keys which refer to other tables:

         SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the key.
SchemaName	String	The name of the schema containing the key.
TableName	String	The name of the table containing the key.
ColumnName	String	The name of the key column.
PrimaryKeyName	String	The name of the primary key.
ForeignKeyName	String	The name of the foreign key.
ReferencedCatalogName	String	The database containing the primary key.
ReferencedSchemaName	String	The schema containing the primary key.
ReferencedTableName	String	The table containing the primary key.
ReferencedColumnName	String	The column name of the primary key.
ForeignKeyType	String	Designates whether the foreign key is an import (points to other tables) or export (referenced from other tables) key.

sys_primarykeys

Describes the primary keys.

The following query retrieves the primary keys from all tables and views:

         SELECT * FROM sys_primarykeys

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the key.
SchemaName	String	The name of the schema containing the key.
TableName	String	The name of the table containing the key.
ColumnName	String	The name of the key column.
KeySeq	String	The sequence number of the primary key.
KeyName	String	The name of the primary key.

sys_indexes

Describes the available indexes. By filtering on indexes, you can write more selective queries with faster query response times.

The following query retrieves all indexes that are not primary keys:

          SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columns


Name	Type	Description
CatalogName	String	The name of the database containing the index.
SchemaName	String	The name of the schema containing the index.
TableName	String	The name of the table containing the index.
IndexName	String	The index name.
ColumnName	String	The name of the column associated with the index.
IsUnique	Boolean	True if the index is unique. False otherwise.
IsPrimary	Boolean	True if the index is a primary key. False otherwise.
Type	Int16	An integer value corresponding to the index type: statistic (0), clustered (1), hashed (2), or other (3).
SortOrder	String	The sort order: A for ascending or D for descending.
OrdinalPosition	Int16	The sequence number of the column in the index.

sys_connection_props

Returns information on the available connection properties and those set in the connection string.

When querying this table, the config connection string should be used:

jdbc:cdata:microsoftproject:config:

This connection string enables you to query this table without a valid connection.

The following query retrieves all connection properties that have been set in the connection string or set through a default value:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columns


Name	Type	Description
Name	String	The name of the connection property.
ShortDescription	String	A brief description.
Type	String	The data type of the connection property.
Default	String	The default value if one is not explicitly set.
Values	String	A comma-separated list of possible values. A validation error is thrown if another value is specified.
Value	String	The value you set or a preconfigured default.
Required	Boolean	Whether the property is required to connect.
Category	String	The category of the connection property.
IsSessionProperty	String	Whether the property is a session property, used to save information about the current connection.
Sensitivity	String	The sensitivity level of the property. This informs whether the property is obfuscated in logging and authentication forms.
PropertyName	String	A camel-cased truncated form of the connection property name.
Ordinal	Int32	The index of the parameter.
CatOrdinal	Int32	The index of the parameter category.
Hierarchy	String	Shows dependent properties associated that need to be set alongside this one.
Visible	Boolean	Informs whether the property is visible in the connection UI.
ETC	String	Various miscellaneous information about the property.

sys_sqlinfo

Describes the SELECT query processing that the Cloud can offload to the data source.

See SQL Compliance for SQL syntax details.

Discovering the Data Source's SELECT Capabilities

Below is an example data set of SQL capabilities. Some aspects of SELECT functionality are returned in a comma-separated list if supported; otherwise, the column contains NO.


Name	Description	Possible Values
AGGREGATE_FUNCTIONS	Supported aggregation functions.	AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT	Whether COUNT function is supported.	YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR	The opening character used to escape an identifier.	[
IDENTIFIER_QUOTE_CLOSE_CHAR	The closing character used to escape an identifier.	]
SUPPORTED_OPERATORS	A list of supported SQL operators.	=, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY	Whether GROUP BY is supported, and, if so, the degree of support.	NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
OJ_CAPABILITIES	The supported varieties of outer joins supported.	NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS
OUTER_JOINS	Whether outer joins are supported.	YES, NO
SUBQUERIES	Whether subqueries are supported, and, if so, the degree of support.	NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED
STRING_FUNCTIONS	Supported string functions.	LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS	Supported numeric functions.	ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS	Supported date/time functions.	NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES	Indicates tables skipped during replication.
REPLICATION_TIMECHECK_COLUMNS	A string array containing a list of columns which will be used to check for (in the given order) to use as a modified column during replication.
IDENTIFIER_PATTERN	String value indicating what string is valid for an identifier.
SUPPORT_TRANSACTION	Indicates if the provider supports transactions such as commit and rollback.	YES, NO
DIALECT	Indicates the SQL dialect to use.
KEY_PROPERTIES	Indicates the properties which identify the uniform database.
SUPPORTS_MULTIPLE_SCHEMAS	Indicates if multiple schemas may exist for the provider.	YES, NO
SUPPORTS_MULTIPLE_CATALOGS	Indicates if multiple catalogs may exist for the provider.	YES, NO
DATASYNCVERSION	The CData Data Sync version needed to access this driver.	Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY	The CData Data Sync category of this driver.	Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL	Whether enhanced SQL functionality beyond what is offered by the API is supported.	TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS	Whether batch operations are supported.	YES, NO
SQL_CAP	All supported SQL capabilities for this driver.	SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS	A string value specifies the preferred cacheOptions.
ENABLE_EF_ADVANCED_QUERY	Indicates if the driver directly supports advanced queries coming from Entity Framework. If not, queries will be handled client side.	YES, NO
PSEUDO_COLUMNS	A string array indicating the available pseudo columns.
MERGE_ALWAYS	If the value is true, The Merge Mode is forcibly executed in Data Sync.	TRUE, FALSE
REPLICATION_MIN_DATE_QUERY	A select query to return the replicate start datetime.
REPLICATION_MIN_FUNCTION	Allows a provider to specify the formula name to use for executing a server side min.
REPLICATION_START_DATE	Allows a provider to specify a replicate startdate.
REPLICATION_MAX_DATE_QUERY	A select query to return the replicate end datetime.
REPLICATION_MAX_FUNCTION	Allows a provider to specify the formula name to use for executing a server side max.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE	A list of tables which will skip dividing the replicate into chunks on the initial replicate.
CHECKCACHE_USE_PARENTID	Indicates whether the CheckCache statement should be done against the parent key column.	TRUE, FALSE
CREATE_SCHEMA_PROCEDURES	Indicates stored procedures that can be used for generating schema files.

The following query retrieves the operators that can be used in the WHERE clause:

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

Note that individual tables may have different limitations or requirements on the WHERE clause; refer to the Data Model section for more information.

Columns


Name	Type	Description
NAME	String	A component of SQL syntax, or a capability that can be processed on the server.
VALUE	String	Detail on the supported SQL or SQL syntax.

sys_identity

Returns information about attempted modifications.

The following query retrieves the Ids of the modified rows in a batch operation:

         SELECT * FROM sys_identity

Columns


Name	Type	Description
Id	String	The database-generated Id returned from a data modification operation.
Batch	String	An identifier for the batch. 1 for a single operation.
Operation	String	The result of the operation in the batch: INSERTED, UPDATED, or DELETED.
Message	String	SUCCESS or an error message if the update in the batch failed.

Data Type Mapping

Data Type Mappings

The Cloud 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	The scheme used for authentication. Accepted entries are Auto,OAuth,OKTA,ADFS, and OneLogin.
URL	URL to the MS Project Web App. For example, https://MyOrganization.sharepoint.com/sites/pwa/.
User	The Microsoft Project user account used to authenticate.
Password	The password used to authenticate the user.

Connection

Property	Description
ProjectId	The Id of the default project. This Id will be used by default for all the operations which require the project Id. Can be overridden by providing a query specific ProjectId filter.

Azure Authentication

Property	Description
AzureTenant	The Microsoft Online tenant being used to access data. If not specified, your default tenant is used.
AzureEnvironment	The Azure Environment to use when establishing a connection.

SSO

Property	Description
SSOLoginURL	The identity provider's login URL.
SSODomain	The domain of the user when using single sign-on (SSO).
SSOProperties	Additional properties required to connect to the identity provider in a semicolon-separated list.

OAuth

Property	Description
OAuthClientId	The client Id assigned when you register your application with an OAuth authorization server.
OAuthClientSecret	The client secret assigned when you register your application with an OAuth authorization server.
Scope	The scopes used for the OAuth or AzureAD flow. Should be separated with a whitespace. For the OAuth flow, it defaults to the following: ProjectAdmin.Manage Projects.Write ProjectResources.Write ProjectReporting.Read. A list of the available scopes and their aliases can be found here: https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/authorization-code-oauth-flow-for-sharepoint-add-ins?redirectedfrom=MSDN#permission-scope-aliases-and-the-oauthauthorizeaspx-page. For the AzureAD flow, it deafults to the following: offline_access https://MyOrganization.sharepoint.com/ProjectWebApp.FullControl https://MyOrganization.sharepoint.com/AllSites.FullControl. A list of the available Azure scopes can be found under API Permissions > SharePoint when customizing any app in the Azure Portal > App Registrations page.

SSL

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

Logging

Property	Description
Verbosity	The verbosity level that determines the amount of detail included in the log file.

Schema

Property	Description
BrowsableSchemas	This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Schema	The type of schema to use: ODataV1 or ODataV2.

Miscellaneous

Property	Description
MaxRows	Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses.
Pagesize	The maximum number of results to return per page from Microsoft Project.
PseudoColumns	This property indicates whether or not to include pseudo columns as columns to the table.
Timeout	The value in seconds until the timeout error is thrown, canceling the operation.
UseSimpleNames	Boolean determining if 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	The scheme used for authentication. Accepted entries are Auto,OAuth,OKTA,ADFS, and OneLogin.
URL	URL to the MS Project Web App. For example, https://MyOrganization.sharepoint.com/sites/pwa/.
User	The Microsoft Project user account used to authenticate.
Password	The password used to authenticate the user.

AuthScheme

The scheme used for authentication. Accepted entries are Auto,OAuth,OKTA,ADFS, and OneLogin.

Possible Values

Auto, SharePointOnlineCookies, OAuth, ADFS, OKTA, OneLogin, AzureAD

Data Type

string

Default Value

"Auto"

Remarks

This field is used to authenticate to Microsoft Project. Auto is the default option.

Auto: Lets the CData Cloud determine what to do based on other connection properties.
SharePointOnlineCookies: Set the User and Password to perform the cookie based authentication to your SharePoint Online server.
OAuth: Set this to use OAuth authentication.
ADFS: Set this to use Single Sign-On authentication with ADFS.
OKTA: Set this to use Single Sign-On authentication with OKTA.
OneLogin: Set this to use Single Sign-On authentication with OneLogin.
AzureAD: Set this to use Azure Active Directory authentication.

Connection

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

Property	Description
ProjectId	The Id of the default project. This Id will be used by default for all the operations which require the project Id. Can be overridden by providing a query specific ProjectId filter.

ProjectId

The Id of the default project. This Id will be used by default for all the operations which require the project Id. Can be overridden by providing a query specific ProjectId filter.

Data Type

string

Default Value

""

Remarks

The Id of the default project. This Id will be used by default for all the operations which require the project Id. Can be overridden by providing a query specific ProjectId filter.

Note: This property is applicable only for the "ODataV2" schema. For the "ODataV1" schema, no table requires the ProjectId to be specified, as the ProjectData endpoints return data for all the available projects.

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	The Microsoft Online tenant being used to access data. If not specified, your default tenant is used.
AzureEnvironment	The Azure Environment to use when establishing a connection.

AzureTenant

The Microsoft Online tenant being used to access data. If not specified, your default tenant is used.

Data Type

string

Default Value

""

Remarks

The Microsoft Online tenant being used to access data. For instance, contoso.onmicrosoft.com. Alternatively, specify the tenant Id. This value is the directory Id in the Azure Portal > Azure Active Directory > Properties.

Typically it is not necessary to specify the Tenant. This can be automatically determined by Microsoft when using the OAuthGrantType set to CODE (default). However, it may fail in the case that the user belongs to multiple tenants. For instance, if an Admin of domain A invites a user of domain B to be a guest user. The user will now belong to both tenants. It is a good practice to specify the Tenant, although in general things should normally work without having to specify it.

The AzureTenant is required when setting OAuthGrantType to CLIENT. When using client credentials, there is no user context. The credentials are taken from the context of the app itself. While Microsoft still allows client credentials to be obtained without specifying which Tenant, it has a much lower probability of picking the specific tenant you want to work with. For this reason, we require AzureTenant to be explicitly stated for all client credentials connections to ensure you get credentials that are applicable for the domain you intend to connect to.

AzureEnvironment

The Azure Environment to use when establishing a connection.

Possible Values

GLOBAL, CHINA, USGOVT, USGOVTDOD

Data Type

string

Default Value

"GLOBAL"

Remarks

In most cases, leaving the environment set to global will work. However, if your Azure Account has been added to a different environment, the AzureEnvironment may be used to specify which environment. The available values are GLOBAL, CHINA, USGOVT, 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	The domain of the user when using single sign-on (SSO).
SSOProperties	Additional properties required to connect to the identity provider in a semicolon-separated list.

SSOLoginURL

The identity provider's login URL.

Data Type

string

Default Value

""

Remarks

The identity provider's login URL.

SSODomain

The domain of the user when using single sign-on (SSO).

Data Type

string

Default Value

""

Remarks

This property is only applicable when using single sign-on (UseSSO is set to true) and if the domain of the User (e.g. [email protected]) is different than the domain configured within the SSO service (e.g. [email protected]).

This property may be required when using the ADFS, OneLogin, or OKTA SSO services.

SSOProperties

Additional properties required to connect to the identity provider in a semicolon-separated list.

Data Type

string

Default Value

""

Remarks

Additional properties required to connect to the identity provider in a semicolon-separated list. is used in conjunction 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	The client Id assigned when you register your application with an OAuth authorization server.
OAuthClientSecret	The client secret assigned when you register your application with an OAuth authorization server.
Scope	The scopes used for the OAuth or AzureAD flow. Should be separated with a whitespace. For the OAuth flow, it defaults to the following: ProjectAdmin.Manage Projects.Write ProjectResources.Write ProjectReporting.Read. A list of the available scopes and their aliases can be found here: https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/authorization-code-oauth-flow-for-sharepoint-add-ins?redirectedfrom=MSDN#permission-scope-aliases-and-the-oauthauthorizeaspx-page. For the AzureAD flow, it deafults to the following: offline_access https://MyOrganization.sharepoint.com/ProjectWebApp.FullControl https://MyOrganization.sharepoint.com/AllSites.FullControl. A list of the available Azure scopes can be found under API Permissions > SharePoint when customizing any app in the Azure Portal > App Registrations page.

SSL

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

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

SSLServerCert

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

Data Type

string

Default Value

""

Remarks

If using a TLS/SSL connection, this property can be used to specify the TLS/SSL certificate to be accepted from the server. Any other certificate that is not trusted by the machine is 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

If not specified, any certificate trusted by the machine is accepted.

Use '*' to signify to accept all certificates. Note that this is not recommended due to security concerns.

Logging

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

Property	Description
Verbosity	The verbosity level that determines the amount of detail included in the log file.

Verbosity

The verbosity level that determines the amount of detail included in the log file.

Data Type

string

Default Value

"1"

Remarks

The verbosity level determines the amount of detail that the Cloud reports to the Logfile. Verbosity levels from 1 to 5 are supported. These are detailed in the Logging page.

Schema

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

Property	Description
BrowsableSchemas	This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Schema	The type of schema to use: ODataV1 or ODataV2.

BrowsableSchemas

This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Data Type

string

Default Value

""

Remarks

Listing the schemas from databases can be expensive. Providing a list of schemas in the connection string improves the performance.

Schema

The type of schema to use: ODataV1 or ODataV2.

Possible Values

ODataV2, ODataV1

Data Type

string

Default Value

"ODataV2"

Remarks

The schemas available are ODataV2 (MS Project's static schema with full CRUD support) and ODataV1 (MS Project's dynamic schema with read-only capabilities).

The ODataV1 schema can only be used to read data, but schemas are read dynamically and the custom fields are exposed.
The ODataV2 schema can be used to perform read, INSERT, update, and delete operations, but schemas are fixed. Main fields are dynamically retrieved, however custom fields are not exposed.

Miscellaneous

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

Property	Description
MaxRows	Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses.
Pagesize	The maximum number of results to return per page from Microsoft Project.
PseudoColumns	This property indicates whether or not to include pseudo columns as columns to the table.
Timeout	The value in seconds until the timeout error is thrown, canceling the operation.
UseSimpleNames	Boolean determining if simple names should be used for tables and columns.

Remarks

If Timeout = 0, operations do not time out. The operations run until they complete successfully or until they encounter an error condition.

If Timeout expires and the operation is not yet complete, the Cloud throws an exception.

UseSimpleNames

Boolean determining if simple names should be used for tables and columns.

Data Type

bool

Default Value

false

Remarks

Microsoft Project tables and columns can use special characters in names that are normally not allowed in standard databases. UseSimpleNames makes the Cloud easier to use with traditional database tools.

Setting UseSimpleNames to true will simplify the names of tables and columns returned. It will enforce a naming scheme such that only alphanumeric characters and the underscore are valid for the displayed table and column names. Any nonalphanumeric characters will be converted to an underscore.

Cloud

Microsoft Project - CData Cloud

Overview

Key Features

Getting Started

Connecting to Microsoft Project

Accessing Data from CData Cloud Services

Establishing a Connection

Connecting to Microsoft Project

Authenticating to Microsoft Project

SharePoint Online Cookie Service

OAuth

ADFS

ADFS Integrated

Supported SSO Providers

Okta

OneLogin

Azure AD

Creating a Custom OAuth Application

Creating a Custom OAuth Application

Create the Application

Add Scope Permissions

Granting User Access to Web Services

Project Permission Mode

SharePoint Permission Mode

CSOM Deprecation

CSOM Support Discontinued

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 advantages compared to ODataV1

ODataV2 limitations

Tables

CData Cloud - Microsoft Project Tables

Assignments

Table Specific Information

Columns

Calendars

Columns

EnterpriseResources

Columns

Phases

Columns

ProjectResources

Table Specific Information

Columns

Projects

Columns

Stages

Columns

TaskLinks

Table Specific Information

Columns

Tasks

Table Specific Information

Columns

TimeSheetLines

Columns

TimeSheets

Columns

Views

CData Cloud - Microsoft Project Views

Assignment_Resource

Columns

Assignment_Task

Columns

Events

Columns