Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Request Elements

Element

Data Type

Required?

Default

Description

Example Data

RequestId

Int32

No

Click here for more information

SessionTicket

String

Yes

Click here for more information

AfCYcj5TI7kC06MRlX2MZQ==

ExcludeReadNotesFlag

Boolean

No

false

If true, notes that have been marked as read by the current user are excluded from the data returned. Applies only when FullDetailFlag is true.

false

Mode

String

Yes

Applies if FullDetailFlag is set to true:

A to retrieve booked data for roles

R to retrieve requested data for roles

E to retrieve effective data for roles (booked data for booked roles, requested data for requested roles)

A

ProjectRoleIdentities

PwsProjectRoleRef [1-100]

This structure represents the unique key fields associated with identifying a project role. A role represents demand for labor. This demand is then supplied by a resource assigned to the role. For example, project X needs a social media director which will be staffed by Henry. Roles are booked hours so that the resource and you know who is working on what and when. Project roles can be identified by an ExternalSystemIdentifier or ProjectRoleUid. When specifying a PwsProjectRoleRef as an input to a web service, you may specify one or both the ExternalSystemIdentifier and ProjectRoleUid. However, if you do specify both, they must both refer to the same project role or the project role reference will not be considered valid. When a PwsProjectRoleRef is returned in the response to a web service, both the ExternalSystemIdentifier and ProjectRoleUid will be populated, and guaranteed to refer to a single project role.

...

Response Elements

Element

Data Type

Description

Sample Data

Messages

PwsMessage [1-100]

The web service response status and message. Click here for more information.

ResponseId

Int32

Click here for more information

0

Status

RequestStatus

Click here for more information.

Ok

ServerTimestampUtc

DateTime

Click here for more information.

2024-10-10T20:49:16.8718067Z

ProjectRoles

PwsProjectRoleElement [1-100]

This structure contains an instance of PwsProjectRoleDetail which completely defines a project role.

ProjectSummaries

PwsProjectRoleProjectSummary[1-100]

The basic information of a project role.

...