PwsExpenseEntryProject

Overview


This structure contains information about a project that is relevant to expense entry and expense management.

Format


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

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

A unique and immutable identifier for a project.

1152921504607413030

BookedResourcesOnlyFlag

Boolean

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)


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