Versions Compared

Key

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

...

This structure contains the complete set of information about a resource. Resources are people who need to report time, report expenses, or be scheduled on a project.  The structure is used both to retrieve detailed resource information and to pass information about a resource back to the server to get updated.

...

Panel
titlePwsResourceDetail
  • PwsResourceDetail
    • ResourceDisplayName: String (30)
    • ResourceId: Int32
    • ResourceReferenceSystemId: String (20)
    • ResourceUid: Int64
    • EmailAddress: String (100)
    • FirstName: String (20)
    • LastName: String (20)
    • MiddleName: String (20)
    • InactiveFlag: Boolean
    • ExpenseApprovalUserIdentity: PwsUserRef
    • ExpenseEntryDelegateUserIdentity: PwsUserRef
    • Initials: String (10)
    • LatestHistoryRecord: PwsResourceHistoryRecord
    • LatestHistoryRecordBeginDate: DateTime
    • ManagerUserIdentity: PwsUserRef
    • RequestedTimeOffApprovalUserIdentity: PwsUserRef
    • SkillApprovalUserIdentity: PwsUserRef
    • TimeEntryDelegateUserIdentity: PwsUserRef
    • TimecardApprovalFlag: Boolean
    • TimecardApprovalUserIdentity: PwsUserRef
    • UserDefinedFields: PwsUserDefinedFieldDetail[1..100]
    • UserIdentity: PwsUserRef
    • VendorReferenceSystemId: String (50)

...

Element

Data Type

Required?

Default

Description

Sample Data
ResourceDisplayNameString (30)

On Insert: YesNo

On Update: One of ResourceDisplayName, ResourceReferenceSystemId , EmaillAddress or ResourceUid is required


The resource's display name is a unique identifier for a resource.Web Services
ResourceIdInt32No
The resource id is a unique identifier for a resource. For internal use only.
ResourceReferenceSystemIdString (20)

On Insert: YesNo

On Update: See ResourceDisplayName


The resource's reference system id is a unique identifier for a resource. Note this service cannot update the resource reference system id. Use PwsSaveUser to update the user reference system id, and the resource reference system id will be updated as well. When updating an existing resource, if you specify a non-null value for this field that does not match the existing value, the request will fail.WS01
ResourceUidInt64

On Insert: YesNo

On Update: See ResourceDisplayName


A unique and immutable Id for a resource1152921504607131538

EmailAddress

String (100)

On Insert: Yes

On Update: See ResourceDisplayNameNo


The resource's email address is a unique identifier for a resource.

webservices@revcorp.bb

FirstName

String (20)

On Insert: Yes 

On Update: No


The resource's first name name.

Web

LastName

String (20)

On Insert: Yes 

On Update: No


The resource's last name name.

Services

MiddleName

String (20)

On Insert: No 

On Update: No


The resource's middle name name.

Middle Name is in fact a User field (not a Resource field).  If needing to change a Middle Name see PwsUserDetail.


InactiveFlag

Boolean

Yes No

 false

If set to 'true', this resource has been defined as inactive inactive.

false

ExpenseApprovalUserIdentity

PwsUserRef

No


The identity of the user who approves this resource's expenses.


ExpenseEntryDelegateUserIdentity

PwsUserRef

No


The identity of the user who can enter expenses on behalf of this resource.


Initials

String (10)

No 


The resource's initials.

WS

LatestHistoryRecord

PwsResourceHistoryRecord

No


The resource's latest history record.


LatestHistoryRecordBeginDate

DateTime

No 


The begin date of the resource's latest history record.

2018-10-01T00:00:00Z

ManagerUserIdentity

PwsUserRef

On Insert: Yes 

On Update: No


The identity of the resource's manager manager.


RequestedTimeOffApprovalUserIdentity

PwsUserRef

No 


The identity of the user who approves this resource's requested time off.


SkillApprovalUserIdentity

PwsUserRef

No 


The identity of the user who approves this resource's skill levels.


TimeEntryDelegateUserIdentity

PwsUserRef

No 


The identity of the user who can enter time on behalf of this resource.


TimecardApprovalFlag

Boolean

No 


This flag affects the approval of time off cards and timecards on projects using "Designated time approver for resource or cost center". 

If this flag is set to '"true', this resource is allowed to approve his/her own time", timecards with a resource based approver are NOT automatically approved and must be approved by a designated approver. (The flag associated with the field "Automatically approve reported time ..." is not checked in the Resource UI).

If this flag is set to "false", timecards with a resource based approver are automatically approved upon submissions. (The flag on the field referenced above is checked in the Resource UI).

true

TimecardApprovalUserIdentity

PwsUserRef

No 


The identity of the user who approves this resource's time.


UserDefinedFields

PwsUserDefinedFieldDetail[1..100]

No 


The user defined fields associated with this resource record.


UserIdentity

PwsUserRef

On Insert: Yes 

On Update: No


The user identity associated with this resource record.


VendorReferenceSystemId

String

On Insert: Yes 

On Update: No


The vendor reference system id of the vendor associated with this resource record.

Web Services

Usage Example(s)

...