Versions Compared

Version Old Version 1 New Version Current
Changes made by

Bettina Borces

Luke Wright

Saved on

Key

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

Overview


This structure contains the complete set of information about a project associated with a cost cardthat is relevant to expense entry and expense management.

Format


Panel
titlePwsExpenseEntryProject
  • PwsExpenseEntryProject
    • ProjectCode: String (24)
    • ProjectId: Int32
    • ProjectUid: Int64
    • BookedResourcesOnlyFlag: Boolean
    • EarliestRoleStartDate: DateTime
    • EngagementDescriptor: PwsEngagementDescriptor
    • LatestRoleEndDate: DateTime
    • LocationIdentity: PwsLocationRef
    • OpenForCostFlag: Boolean
    • ProjectCloseDate: DateTime
    • ProjectDescription: String (1000)
    • ProjectManager: PwsUserSummary
    • ProjectName: String (255)
    • ProjectOpenDate: DateTime
    • ProjectStageIdentity: PwsProjectStageRef
    • RoleCount: Int32
    • Udf1InactiveFlag: Boolean
    • Udf1Values: String
    • Udf2InactiveFlag: Boolean
    • Udf2Values: String
    • AllowBookingFlag: Boolean
    • Udf1DefaultValue: String
    • Udf2DefaultValue: String
    • ExpenseTypeIdentities: PwsExpenseTypeRef

Elements


Element

Data Type

Required?

Default

Description

Sample Data

ProjectCode

String (24)

 

 

 

 

The project code is a unique identifier for a project.

P001407-001

ProjectId

Int32

 

 

 

 

The project Id is a unique identifier for a project. For internal use only.


ProjectUid

Int64

 

 

 

 

ExpenseTypeIdentities

PwsExpenseTypeRef[]

 

 

 

 

A unique and immutable identifier for a project.

1152921504607413030

BookedResourcesOnlyFlag

Boolean

 

 

 

 

EarliestRoleStartDate

DateTime

 

 

 

 

EngagementDescriptor

PwsEngagementDescriptor

 

 

 

 

LatestRoleEndDate

DateTime

 

 

 

 

LocationIdentity

PwsLocationRef

 

 

 

 

OpenForCostFlag

Boolean

 

 

 

 

ProjectCloseDate

DateTime

 

 

 

 

ProjectDescription

String

 

 

 

 

ProjectManager

PwsUserSummary

 

 

 

 

ProjectName

String

 

 

 

 

ProjectOpenDate

DateTime

 

 

 

 

ProjectStageIdentity

PwsProjectStageRef

 

 

 

 

RoleCount

Int32

 

 

 

 

Udf1InactiveFlag

Boolean

 

 

 

 

Udf1Values

String[]

 

 

 

 

Udf2InactiveFlag

Boolean

 

 

 

 

Udf2Values

String[]

 

 

 

 

AllowBookingFlag

Boolean

 

 

 

 

Udf1DefaultValue

String

 

 

 

 

Udf2DefaultValue

String

 

 

 

 

If set to 'true', only resources booked to a role can enter expenses against the project.

false

EarliestRoleStartDate

DateTime

The earliest role start date (if there are no roles, or no roles have a start date, this field will take on the value of the ProjectStartDate).

2018-01-01T00:00:00Z

EngagementDescriptor

PwsEngagementDescriptor

Basic information about the engagement this project resides under.


LatestRoleEndDate

DateTime

The latest role end date (if there are no roles, or no roles have an end date, this field will take on the value of the ProjectCloseDate – and may be null if the project has no close date).

2018-02-28T00:00:00Z

LocationIdentity

PwsLocationRef

The location associated with the project.


OpenForCostFlag

Boolean

If set to 'true', the project is open for cost.

true

ProjectCloseDate

DateTime

The project close date.

2018-02-28T00:00:00Z

ProjectDescription

String

The project description.


ProjectManager

PwsUserSummary

The project manager.


ProjectName

String

The project name.

Project A

ProjectOpenDate

DateTime

The project open date.

2018-01-01T00:00:00Z

ProjectStageIdentity

PwsProjectStageRef

The project stage.


RoleCount

Int32

The number of active project roles.

1

Udf1InactiveFlag

Boolean

If set to 'true', the first cost card user defined field (UDF) is inactive (taking enterprise configuration into account).

false

Udf1Values

String

A complete list of valid values for the first user defined field (UDF).


Udf2InactiveFlag

Boolean

If set to 'true', the second cost card user defined field (UDF) is inactive (taking enterprise configuration into account).

false

Udf2Values

String

A complete list of valid values for the second user defined field (UDF).


AllowBookingFlag

Boolean

If set to 'true', the project allows permissioned users to report expenses against the project.

true

Udf1DefaultValue

String

The default value for the first cost card user defined field (UDF).


Udf2DefaultValue

String

The default value for the second cost card user defined field (UDF).


ExpenseTypeIdentities

PwsExpenseTypeRef

A list of all the valid expense types.


Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
                   <a:PwsExpenseEntryProject>
                     <ProjectCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">P001407-001</ProjectCode>
                     <ProjectId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <ProjectUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607413030</ProjectUid>
                     <a:BookedResourcesOnlyFlag>false</a:BookedResourcesOnlyFlag>
                     <a:EarliestRoleStartDate>2018-01-01T00:00:00Z</a:EarliestRoleStartDate>
                     <a:EngagementDescriptor>
                        <EngagementCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">E001407</EngagementCode>
                        <EngagementId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <EngagementUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607325242</EngagementUid>
                        <a:ClientDescriptor>
                           <ClientId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ClientNumber xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">PR-PSA</ClientNumber>
                           <ClientUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606961482</ClientUid>
                           <a:ClientName>Projector PSA</a:ClientName>
                           <a:ParentClientDescriptor i:nil="true"/>
                        </a:ClientDescriptor>
                        <a:EngagementManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                           <b:UserId i:nil="true"/>
                           <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                           <b:UserUid>1152921504607112369</b:UserUid>
                           <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                           <b:FirstName>Jack</b:FirstName>
                           <b:LastName>Spratt</b:LastName>
                           <b:MiddleName i:nil="true"/>
                        </a:EngagementManager>
                        <a:EngagementName>Engagement A</a:EngagementName>
                        <a:EngagementTypeDescriptor>
                           <EngagementTypeId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <EngagementTypeName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">Billable - Time and Materials</EngagementTypeName>
                           <EngagementTypeShortName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">TandM</EngagementTypeShortName>
                           <EngagementTypeUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606863884</EngagementTypeUid>
                           <a:BillableFlag>true</a:BillableFlag>
                        </a:EngagementTypeDescriptor>
                        <a:EngagementCurrencyDecimalDigits>2</a:EngagementCurrencyDecimalDigits>
                        <a:EngagementCurrencyIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:CurrencyCode>USD</b:CurrencyCode>
                           <b:CurrencyId i:nil="true"/>
                           <b:CurrencyUid>1152921504606851838</b:CurrencyUid>
                        </a:EngagementCurrencyIdentity>
                     </a:EngagementDescriptor>
                     <a:LatestRoleEndDate>2018-02-28T00:00:00Z</a:LatestRoleEndDate>
                     <a:LocationIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:LocationId i:nil="true"/>
                        <b:LocationName>USA</b:LocationName>
                        <b:LocationUid>1152921504606855985</b:LocationUid>
                     </a:LocationIdentity>
                     <a:OpenForCostFlag>true</a:OpenForCostFlag>
                     <a:ProjectCloseDate>2018-02-28T00:00:00Z</a:ProjectCloseDate>
                     <a:ProjectDescription i:nil="true"/>
                     <a:ProjectManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                        <b:UserId i:nil="true"/>
                        <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                        <b:UserUid>1152921504607112369</b:UserUid>
                        <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                        <b:FirstName>Jack</b:FirstName>
                        <b:LastName>Spratt</b:LastName>
                        <b:MiddleName i:nil="true"/>
                     </a:ProjectManager>
                     <a:ProjectName>Project A</a:ProjectName>
                     <a:ProjectOpenDate>2018-01-01T00:00:00Z</a:ProjectOpenDate>
                     <a:ProjectStageIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ProjectStageId i:nil="true"/>
                        <b:ProjectStageName>Delivery</b:ProjectStageName>
                        <b:ProjectStageShortName>Delivery</b:ProjectStageShortName>
                        <b:ProjectStageUid>1152921504606853304</b:ProjectStageUid>
                     </a:ProjectStageIdentity>
                     <a:RoleCount>1</a:RoleCount>
                     <a:Udf1InactiveFlag>false</a:Udf1InactiveFlag>
                     <a:Udf1Values xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                     <a:Udf2InactiveFlag>false</a:Udf2InactiveFlag>
                     <a:Udf2Values xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                        <b:string>Celebration</b:string>
                        <b:string>Team Building</b:string>
                        <b:string>Client Meeting</b:string>
                        <b:string>Other</b:string>
                     </a:Udf2Values>
                     <a:AllowBookingFlag>true</a:AllowBookingFlag>
                     <a:Udf1DefaultValue i:nil="true"/>
                     <a:Udf2DefaultValue i:nil="true"/>
                     <a:ExpenseTypeIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:PwsExpenseTypeRef>
                           <b:ExpenseTypeId i:nil="true"/>
                           <b:ExpenseTypeName>Meals</b:ExpenseTypeName>
                           <b:ExpenseTypeUid>1152921504606878415</b:ExpenseTypeUid>
                        </b:PwsExpenseTypeRef>
                        <b:PwsExpenseTypeRef>
                           <b:ExpenseTypeId i:nil="true"/>
                           <b:ExpenseTypeName>Other/Misc Billable</b:ExpenseTypeName>
                           <b:ExpenseTypeUid>1152921504606879705</b:ExpenseTypeUid>
                        </b:PwsExpenseTypeRef>
                        <b:PwsExpenseTypeRef>
                           <b:ExpenseTypeId i:nil="true"/>
                           <b:ExpenseTypeName>Meals and Entertainment</b:ExpenseTypeName>
                           <b:ExpenseTypeUid>1152921504606881279</b:ExpenseTypeUid>
                        </b:PwsExpenseTypeRef>
                        <b:PwsExpenseTypeRef>
                           <b:ExpenseTypeId i:nil="true"/>
                           <b:ExpenseTypeName>Travel</b:ExpenseTypeName>
                           <b:ExpenseTypeUid>1152921504606881280</b:ExpenseTypeUid>
                        </b:PwsExpenseTypeRef>
                     </a:ExpenseTypeIdentities>
                  </a:PwsExpenseEntryProject>