Microsoft Project Version Support

Enabling bidirectional SQL access to Project Server, the connector models Microsoft Project's CSOM and OData APIs as a relational database. The Jitterbit Connector for Microsoft Project can connect to both the cloud and local versions of Project Server.

Connecting to Microsoft Project

In order to connect to the Microsoft Project data source, you will first need to specify the below connection properties.

• URL: (Required) Set this to a valid Microsoft Project Web App URL. For example:

  http://contoso.com/sites/pwa/

• Schema: (Optional) There are two available schemas, "ODataV1" and "ODataV2". The "ODataV2" schema (default) can be used for full CRUD operations. However, for reporting purposes, the "ODataV1" schema is superior, since it provides more granular data and exposes the custom fields. See Data Model for more information about the available functionality in each Schema.
• ProjectId: (Optional) If the "ODataV2" schema is specified, you can additionally set this property to a specific Project Id, in order to define the default project for all the operations that require one.

Authenticating to Project Online

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

Authenticating with SharePoint Online Cookie Service

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

Authenticating with OAuth

To use the OAuth 2.0 authentication standard you should first create a custom OAuth app to obtain the OAuthClientId, OAuthClientSecret. In addition to those properties, set CallbackURL. See Using OAuth2 Authentication for more information.

You should set the AuthScheme to OAuth to enforce the OAuth Authentication scheme.

Authenticating with ADFS

Set the AuthScheme to ADFS. The following connection properties need to be set:

• User: Set this to the ADFS user.
• Password: Set this to ADFS password for the user.
• SSOLoginURL: Set this to the login URL used by the SSO provider.

Below is an 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, simply do not specify the User and Password, but otherwise follow the same steps in the ADFS guide above.

Authenticating with Okta

Set the AuthScheme to Okta. The following connection properties are used to connect to Okta:

• User: Set this to the Okta user.
• Password: Set this to Okta password for the user.
• SSOLoginURL: Set this to the login URL used by the SSO provider.

The following SSOProperties are needed to authenticate to Okta:

• APIToken (optional): Set this to the API Token that the customer created from the Okta org. It should be used when authenticating a user via a trusted application or proxy that overrides OKTA client request context.
• MFAType (optional): Set this only in case you have configured MFA flow. Currently we support only the follwoing types: OktaVerify,Email and SMS.
• MFAPassCode (optional): Set this only in case you have configured MFA flow. If this is set to empty/invalid the driver will initially issue a MFA challenge which will trigger the platform to send you an one-time password on your device or email, based on the configured MFA type. You need to re-issue another connection where the retrieved one-time password value is passed to MFAPassCode connection property.

The following is an example connection string:

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

Authenticating with OneLogin

Set the AuthScheme to OneLogin. The following connection properties are used to connect to OneLogin:

• User: Set this to the OneLogin user.
• Password: Set this to OneLogin password for the user.

The following SSOProperties are needed to authenticate to OneLogin:

• OAuthClientId: Set to the OAuthClientId, which can be obtained by selecting Developers > API Credentials > Credential > ClientId.
• OAuthClientSecret: Set to the OAuthClientSecret, which can be obtained by selecting Developers > API Credentials > Credential > ClientSecret.
• Subdomain: Set to the subdomain of the OneLogin user accessing the SSO app. For example, if your OneLogin URL is splinkly.onelogin.com, enter splinkly as the subdomain value.
• AppId: Set to the ID of the SSO app.
• Region (optional): Set to the region your OneLogin account resides in. The OneLogin API operates in multiple regions and this property is used to find the correct domain. It can take one of the following values:
  • US (default)
  • EU

The following is an example connection string: The following 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';

OAuth 2.0 requires the authenticating user to interact with Microsoft Project using the browser. The connector facilitates this in various ways as described below.

Custom Credentials

You can register an app to obtain the OAuthClientId and OAuthClientSecret.

When to Create a Custom OAuth App

You need to create a custom OAuth app in the desktop flow.

When to Use a Custom OAuth App

Desktop Authentication with a Custom OAuth App

Follow the steps below to authenticate with the credentials for a custom OAuth app. See Creating a Custom OAuth App for more information.

Get and Refresh the OAuth Access Token

After setting the following, you are ready to connect:

• OAuthClientId: Set this to the client ID assigned when you registered your app.
• OAuthClientSecret: Set this to the client secret assigned when you registered your app.
• CallbackURL: Set this to the Callback defined when you registered your app.
• URL: Set this to the URL of your service instance.
• InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken.

When you connect the connector opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The connector then completes the OAuth process:

1. Extracts the access token from the callback URL and authenticates requests.
2. Refreshes the access token when it expires.
3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.

Get an OAuth Access Token

Set the following connection properties to obtain the OAuthAccessToken:

• OAuthClientId: Set this to the Client ID in your app settings.
• OAuthClientSecret: Set this to the Client Secret in your app settings.
• CallbackURL: Set this to the Callback defined when you registered your app.
• URL: Set this to the URL of your service instance.

You can then call stored procedures* to complete the OAuth exchange:

1. Call the GetOAuthAuthorizationURL stored procedure. Set the CallbackURL input to the Callback you specified in your app settings.

   The stored procedure* returns the URL to the OAuth endpoint.

2. Open the URL, log in, and authorize the application. You are redirected back to the callback URL.
3. Call the GetOAuthAccessToken stored procedure. Set the Verifier input to the "code" parameter in the query string of the callback URL.

Refresh the OAuth Access Token

You can set InitiateOAuth to REFRESH to automatically refresh the OAuth access token when it expires, or you can call the RefreshOAuthAccessToken stored procedure* to refresh the token manually.

Automatic Refresh

To refresh the token with InitiateOAuth, set the following on the first data connection:

• OAuthAccessToken: Set this to the access token returned by GetOAuthAccessToken.
• InitiateOAuth: Set this to REFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken.
• OAuthSettingsLocation: Set this to the path where the connector will save the OAuth values, to be persisted across connections.
• OAuthClientId: Set this to the Client ID in your app settings.
• OAuthClientSecret: Set this to the Client Secret in your app settings.
• OAuthRefreshToken: Set this to the refresh token returned by GetOAuthAccessToken.
• URL: Set this to the URL of your service instance.

On subsequent data connections, set the following:

• InitiateOAuth
• OAuthSettingsLocation
• URL: Set this to the URL of your service instance.

Manual Refresh

You can use the RefreshOAuthAccessToken stored procedure* to manually refresh the OAuthAccessToken. Call the stored procedure* after the ExpiresIn parameter value returned by GetOAuthAccessToken has elapsed. You need the following connection properties to be set:

• OAuthClientId: Set this to the Client ID in your app settings.
• OAuthClientSecret: Set this to the Client Secret in your app settings.

You can then call RefreshOAuthAccessToken with the following parameter set:

• OAuthRefreshToken: Set this to the OAuthRefreshToken returned by GetOAuthAccessToken.

Using OAuth on a Headless Machine

To establish a connection to the Microsoft Project data source on headless servers or other machines on which the connector cannot open a browser, you need to authenticate from another machine. Authentication is a two-step process.

1. Instead of installing the connector on another machine, you can follow the steps below to obtain the OAuthVerifier value. Or, you can install the connector on another machine and transfer the OAuth authentication values, after you authenticate through the usual browser-based flow.
2. You can then configure the connector to automatically refresh the access token from the headless machine.

You can follow the headless OAuth authentication flow using the OAuth credentials for your custom OAuth app.

Using the Credentials for a Custom OAuth App

Create a Custom OAuth App

See Creating a Custom OAuth App for a procedure. You can then follow the procedures below to authenticate and connect to data.

Obtain a Verifier Code

Set the following properties on the headless machine:

• InitiateOAuth = OFF.
• OAuthClientId = Client Id.
• OAuthClientSecret = Client Secret.
• URL = The URL of your site (https://{site}.sharepoint.com/sites/pwa).

You can then follow the steps below to authenticate from another machine and obtain the OAuthVerifier connection property.

1. Call the GetOAuthAuthorizationURL stored procedure* with the CallbackURL input parameter set to the exact Redirect URI you specified in your app settings.
2. Open the returned URL in a browser. Log in and grant permissions to the connector. You are then redirected to the callback URL, which contains the verifier code.
3. Save the value of the verifier code. You will set this in the OAuthVerifier connection property.

On the headless machine, set the following connection properties to obtain the OAuth authentication values:

• OAuthClientId = Client Id.
• OAuthClientSecret = Client Secret.
• URL = The URL of your site (https://{site}.sharepoint.com/sites/pwa).
• OAuthVerifier: Set this to the verifier code.
• OAuthSettingsLocation: Set this to persist the encrypted OAuth authentication values to the specified file.
• InitiateOAuth: Set this to REFRESH.

Connect to Data

After the OAuth settings file is generated, set the following properties to connect to data:

• OAuthSettingsLocation: Set this to the file containing the encrypted OAuth authentication values. Make sure this file gives read and write permissions to the provider to enable the automatic refreshing of the access token.
• InitiateOAuth: Set this to REFRESH.

Transfer OAuth Settings

Follow the steps below to install the connector on another machine, authenticate, and then transfer the resulting OAuth values.

On a second machine, install the connector and connect with the following properties set:

• OAuthSettingsLocation: Set this to a writable text file.
• InitiateOAuth: Set this to GETANDREFRESH.
• OAuthClientId: Set this to the Client ID in your app settings.
• OAuthClientSecret: Set this to the Client Secret in your app settings.
• CallbackURL: Set this to the Callback URL in your app settings.
• URL = The URL of your site (https://{site}.sharepoint.com/sites/pwa).

Test the connection to authenticate. The resulting authentication values are written, encrypted, to the path specified by OAuthSettingsLocation. Once you have successfully tested the connection, copy the OAuth settings file to your headless machine. On the headless machine, set the following connection properties to connect to data:

• InitiateOAuth: Set this to REFRESH.
• OAuthSettingsLocation: Set this to the path to your OAuth settings file. Make sure this file gives read and write permissions to the connector to enable the automatic refreshing of the access token.

Authenticate using Custom OAuth Credentials

You can create an OAuth application through your site's UI, or by manually entering your site's create app link into your browser: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/appregnew.aspx.

After filling in the required fields, you may click "Create" and the following credentials will be displayed.

Note that while creating the OAuth application, you will be required to specify a Callback URL.

This is the URL you will be redirected to after explicitly granting access. Microsoft Project requires this callback to use 'https://'.

You can work around this restriction by supplying 'https://oauth.cdata.com/oauth/' as callback, and adding an extra state connection property which will contain the actual redirect callback. Copy the ClientID and ClientSecret which will be needed later.
In order to access the microsoft project api we have to give scope permissions to the created app. In order to do that go to the following URL: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/AppInv.aspx.
In the App ID field enter the ClientID obtained when creating the app and click on Lookup. The other fields should automatically be filled with the apps details like Title, App Domain and Redirect URL. In the permissions request XML enter the following:

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

These are the default permissions needed to have full access to the api. Also the logged in user should make sure they have the appropriate permissions to access the api. In case your Project Web App (PWA) is in Project permission mode, you can explicitly grant access to the Web Services for specified PWA users. To do this, you can follow the steps below.

1. Open the 'PWA Settings' page on your PWA.
2. Click on 'Manage Users' under the security section.
3. Click on the 'User Name' of the interested user.
4. On the 'Edit User' page expand the Global Permissions section.
5. Make sure the 'Allow' checkbox of the 'Access Project Server Reporting Service' option under the 'General' section is checked.

In case your PWA is in SharePoint permission mode, you will need to add the interested user in a group with at least the 'Access Project Server Reporting Service' permission enabled, such as: Portfolio Viewers, Portfolio Managers, and Administrators. To do this, you can follow the steps below.

1. Open the 'PWA Settings' page on your PWA.
2. Click on 'Manage Users' under the security section.
3. Click on the 'User Name' of the interested user.
4. On the 'Edit User' and under the 'Security Groups' select one of the groups with the required access permissions (such as: Portfolio Viewers, Portfolio Managers, and Administrators), and click on the '>' button to add the current user.

You can now use these credentials to connect to Microsoft Project by setting them as the following connection properties:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = Client Id.
• OAuthClientSecret = Client Secret.
• CallbackURL = Your callback URL.
• URL = The URL of your site (https://{site}.sharepoint.com/sites/{Project_Web_App_Site}).

Alternatively, to use the callback:

You can now use these credentials to connect to Microsoft Project by setting them as the following connection properties:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = Client Id.
• OAuthClientSecret = Client Secret.
• CallbackURL = https://oauth.cdata.com/oauth/.
• State = Your actual callback URL (for example http://localhost:3333).
• URL = The URL of your site (https://{site}.sharepoint.com/sites/{Project_Web_App_Site}).

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

CSOM Support Discontinued

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

Improved Performance with OData Bulk Operations

One additional advantage of using the Microsoft Project OData interface exclusively is the support for efficient bulk operations.

Microsoft Project data must be checked out, an INSERT/UPDATE/DELETE operation is performed, the changes are published, and finally the changes are checked in.

At times, the checkout step may fail, leading to numerous requests per single INSERT/UPDATE/DELETE operation.

With the connector's batch support, you can dramatically reduce the numbers of requests submitted, since several records can be submitted through the checkin/checkout process at a time.

See Batch Processing for details on batch operations.

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

User Defined Views

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

SSL Configuration

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

Proxy

To configure the connector using Private Agent proxy settings, select the Use Proxy Settings checkbox on the connection configuration screen.

The Jitterbit Connector for Microsoft Project allows you to define a virtual table whose contents are decided by a pre-configured query. These are called User Defined Views, which are useful in situations where you cannot directly control the query being issued to the driver, e.g. when using the driver from Jitterbit. The User Defined Views can be used to define predicates that are always applied. If you specify additional predicates in the query to the view, they are combined with the query already defined as part of the view.

There are two ways to create user defined views:

• Create a JSON-formatted configuration file defining the views you want.
• DDL statements.

Defining Views Using a Configuration File

User Defined Views are defined in a JSON-formatted configuration file called UserDefinedViews.json. The connector automatically detects the views specified in this file.

You can also have multiple view definitions and control them using the UserDefinedViews connection property. When you use this property, only the specified views are seen by the connector.

This User Defined View configuration file is formatted as follows:

• Each root element defines the name of a view.
• Each root element contains a child element, called query, which contains the custom SQL query for the view.

For example:

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

Use the UserDefinedViews connection property to specify the location of your JSON configuration file. For example:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema for User Defined Views

User Defined Views are exposed in the UserViews schema by default. This is done to avoid the view's name clashing with an actual entity in the data model. You can change the name of the schema used for UserViews by setting the UserViewsSchemaName property.

Working with User Defined Views

For example, a SQL statement with a User Defined View called UserViews.RCustomers only lists customers in Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

An example of a query to the driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resulting in the effective query to the source:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

That is a very simple example of a query to a User Defined View that is effectively a combination of the view query and the view definition. It is possible to compose these queries in much more complex patterns. All SQL operations are allowed in both queries and are combined when appropriate.

Customizing the SSL Configuration

By default, the connector 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.

Overview

The Jitterbit Connector for Microsoft Project 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 connector 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 connector.

Collaborative Query Processing

The connector offloads as much of the SELECT statement processing as possible to Microsoft Project and then processes the rest of the query in memory. See SupportEnhancedSQL for more information on how the connector circumvents API limitations with in-memory client-side processing.

SELECT statements for the main tables are mostly supported server-side. For example:

SELECT * FROM Tasks WHERE Id = '61a6cc2d-cff5-e911-b093-00155ddc7224'

will be run server-side.

Note: When executing SELECT statements on child tables, everything is processed client side.

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

NOTE: Stored procedures are not currently supported. See the above note for details.

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

ODataV2 advantages compared to ODataV1

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

ODataV2 limitations

• In order to query some tables and views, such as Assignments, ProjectResources, TaskLinks and Tasks,

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

• The custom fields are not exposed.

The connector models the data in Microsoft Project into a list of tables that can be queried using standard SQL statements.

Generally, querying Microsoft Project tables is the same as querying a table in a relational database. Sometimes there are special cases, for example, including a certain column in the WHERE clause might be required to get data for certain columns in the table. This is typically needed for situations where a separate request must be made for each row to get certain columns. These types of situations are clearly documented at the top of the table page linked below.

Jitterbit Connector for 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.

Retrieve and modify assignments.

Table Specific Information

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

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

Columns

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

Retrieve and modify calendars.

Columns

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

Retrieve and modify resources.

Columns

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

Retrieve and modify project phases.

Columns

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

Retrieve and modify project resources.

Table Specific Information

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

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

Columns

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

Retrieve and modify projects.

Columns

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

Retrieve and modify project stages.

Columns

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

Retrieve and modify task links.

Table Specific Information

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

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

Columns

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

Retrieve and modify tasks.

Table Specific Information

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

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

Columns

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

Retrieve and modify timesheets.

Columns

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

Retrieve and modify timesheets.

Columns

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

Views are composed of columns and pseudo columns. Views are similar to tables in the way that data is represented; however, views do not support updates. Entities that are represented as views are typically read-only entities. Often, a stored procedure* is available to update the data if such functionality is applicable to the data source.

Queries can be executed against a view as if it were a normal table, and the data that comes back is similar in that regard. To find out more about tables and stored procedures, please navigate to their corresponding entries in this help document.

Jitterbit Connector for 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.

Retrieve and modify assignments.

Columns

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

Retrieve and modify assignments.

Columns

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

Retrieve events.

Columns

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

Retrieve project details.

Columns

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

Retrieve project details..

Columns

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

Retrieve and modify assignments.

Columns

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

Retrieve and modify assignments.

Columns

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

Retrieve timesheet periods.

Columns

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

Stored procedures* are available to complement the data available from the Data Model. It may be necessary to update data available from a view using a stored procedure* because the data does not provide for direct, table-like, two-way updates. In these situations, the retrieval of the data is done using the appropriate view or table, while the update is done by calling a stored procedure. Stored procedures* take a list of parameters and return back a dataset that contains the collection of tuples that constitute the response.

Jitterbit Connector for Microsoft Project Stored Procedures

Name	Description
CheckIn	Check in the specified project.
CheckOut	Check out the specified project.
GetOAuthAccessToken	Gets an authentication token from Microsoft Project.
GetOAuthAuthorizationURL	Gets the authorization URL that must be opened separately by the user to grant access to your application. Only needed when developing Web apps. You will request the OAuthAccessToken from this URL.
GetOnlineCookies	Retrieves the cookies for authentication with SharePoint Online.
Publish	Publish the specified project.
RefreshOAuthAccessToken	Refreshes the OAuth access token used for authentication with Microsoft Project.
Search	Searches OData using the given URL.

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.

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.

Gets an authentication token from Microsoft Project.

Input

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

Result Set Columns

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

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

Input

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

Result Set Columns

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

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

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

Input

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

Result Set Columns

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

Searches OData using the given URL.

Input

Name	Type	Description
Url	String	Full URL to use while searching OData.

Result Set Columns

Name	Type	Description
*	String	Output will vary for each entity.

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

NOTE: Stored procedures are not currently supported. See the above note for details.

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

ODataV1 advantages compared to ODataV2

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

ODataV1 limitations

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

Views are composed of columns and pseudo columns. Views are similar to tables in the way that data is represented; however, views do not support updates. Entities that are represented as views are typically read-only entities. Often, a stored procedure* is available to update the data if such functionality is applicable to the data source.

Queries can be executed against a view as if it were a normal table, and the data that comes back is similar in that regard. To find out more about tables and stored procedures, please navigate to their corresponding entries in this help document.

Jitterbit Connector for 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.

Retrieve assignment baselines.

Columns

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

Retrieve assignment baseline timephased dataset.

Columns

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

Retrieve assignments.

Columns

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

Retrieve assignment timephased dataset.

Columns

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

Retrieve business driver departments.

Columns

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

Retrieve business drivers.

Columns

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

Retrieve cost constraint scenarios.

Columns

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