Rate Limiting

In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior.

Request

The service request contains:

Name	Data Type	Required?	Default Value	Discussion
LimitToOpenForTimeOnly	boolean	no	false	If true, then the export is limited to projects that are open for time entry.
LimitToOpenForCostOnly	boolean	no	false	If true, then the export is limited to projects that are open for cost entry.
EngagementType	string(15)	no		If supplied, then the export is limited to projects of the specified engagement type.
MaxRowsToReturn	int	no	1000	The maximum number of cards to be exported. Values greater than 1000 may fail due to system-enforced transaction time limits.
ProjectCodesAfter	string(24)	no		Export is limited to projects starting (alphabetically) with this project code. To avoid skipping or duplicating exported projects set this to the last ProjectCode from the previous result set.
OnlyCountRows	boolean	no	false	If true, then only the RowCount is returned.

Response

For each project in the result set the following data is returned:

Name	Data Type	Discussion
ProjectName	string
ProjectCode	string	Unique code identifying the project.
ClientName1	string	Client name at the highest level of your client hierarchy.
ClientNumber1	string	Unique code identifying the client.
ClientName2	string	Client name at the second level of your client hierarchy.
ClientNumber2	string	Unique code identifying the client.
ClientName3	string	Client name at the third level of your client hierarchy.
ClientNumber3	string	Unique code identifying the client.
ClientName4	string	Client name at the fourth level of your client hierarchy.
ClientNumber4	string	Unique code identifying the client.
EngagementName	string
EngagementCode	string	Unique code identifying the engagement.
EngagementMgrReferenceSystemId	string	Unique code identifying the engagement manager.
CostCenterReferenceSystemId	string	Unique code identifying the cost center.
EngagementType	string	Engagement Type Short Name
ProjectStageName	string	Name of the project's current stage
BillableFlag	boolean	True if billable, false otherwise.
CurrencyCode	string	Currency for the project (and for the associated engagement).
LocationName	string
ProjectMgrReferenceSystemId	string	Unique code identifying the project manager.
BeginDate	date	Begin date of project.
EndDate	date	End date of project. This can be null.
OpenForTimeFlag	boolean	True if the project is open for time, false otherwise.
OpenForCostFlag	boolean	True if the project is open for costs, false otherwise.
BookedResourcesOnlyTimeFlag	boolean	True if the project only accepts time from resources currently booked on the project.
BookedResourcesOnlyExpenseFlag	boolean	True if the project only accepts expenses from resources currently booked on the project.
BookedResources	list of Exported_BookedResource
ProjectTimeApprovers	list of Exported_ ProjectTimeApprover
ProjectCostApprovers	list of Exported_ ProjectCostApprover
ProjectUdfs	list of ProjectUdf
EngagementUdfs	list of EngagementUdf
PmModuleEnabledFlag	boolean
AssignedResourcesOnlyFlag	boolean
MinutesPerDay	short

Each Exported_BookedResource record consists of:

Name	Data Type	Discussion
DisplayName	string	Name of the resource
EmployeeId	string	Employee id of the resource

Each Exported_ProjectTimeApprover record consists of:

Name	Data Type	Discussion
DisplayName	string	Name of the approver
EmployeeId	string	Employee id of the approver

Each Exported_ProjectCostApprover record consists of:

Name	Data Type	Discussion
DisplayName	string	Name of the approver
EmployeeId	string	Employee id of the approver

Changelog

4.4

Parameter	Notes
PmModuleEnabledFlag	Added as a response parameter
AssignedResourcesOnlyFlag	Added as a response parameter
MinutesPerDay	Added as a response parameter

Browser not supported