Versions Compared

Key

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

Overview


This service is used to retrieve alerts for a specified resource. Alerts indicate that the resource has outstanding activity in need of attention, and include Draft, Missing and/or Rejected Time Alerts, Draft and/or Rejected Expense Alerts and Rejected Requested Time Off alerts.

...

Panel
titlePwsGetAlerts Request
  • PwsGetAlerts
    • serviceRequest: PwsGetAlertsRq
      • RequestId: Int32
      • SessionTicket: String
      • CountOnlyFlag: Boolean
      • IncludeDraftTimeFlag: Boolean
      • IncludeMissingTimeFlag: Boolean
      • IncludeRejectedExpenseFlag: Boolean
      • IncludeRejectedOrIncompleteTimeFlag: Boolean
      • IncludeUnsubmittedExpenseFlag: Boolean
      • MinAlertsDate: DateTime
      • ResourceIdentity: PwsResourceRef
      • AlertsPeriodType: String
      • MissingTimeCalculateDailyFlag: Boolean
      • IncludeRejectedOrIncompleteTimeoffFlag: Boolean

Request Elements


Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.

1

SessionTicket

String

Yes


Click here for more information.

ASRSfTVqwiAveqJtZvLffA==

CountOnlyFlag

Boolean

No

false

If set to 'true', the web service will return only the count of time, cost and time off alerts; if set to 'false' the web service will return full information about each alert

false

IncludeDraftTimeFlag

Boolean

One of IncludeDraftTimeFlag, IncludeMissingTimeFlag, IncludeRejectedExpenseFlag, IncludeRejectedOrIncompleteTimeFlag or IncludeUnsubmittedExpenseFlag or IncludeRejectedOrIncompleteTimeoffFlag is required

No

false

If set to 'true', draft time card alerts will be returned

true

IncludeMissingTimeFlag

Boolean

See IncludeDraftTimeFlag

No

false 

If set to 'true', missing time alerts will be returned.

false

IncludeRejectedExpenseFlag

Boolean

See IncludeDraftTimeFlag

No

false 

If set to 'true', rejected expense alerts will be returned.

false

IncludeRejectedOrIncompleteTimeFlag

Boolean

See IncludeDraftTimeFlag

No

false 

If set to 'true,  rejected or incomplete time card alerts will be returned.

true

IncludeUnsubmittedExpenseFlag

Boolean

See IncludeDraftTimeFlag

No

false 


false

MinAlertsDate *** deprecated ***

DateTime

 *** deprecated ***

 *** deprecated ***

 *** deprecated ***

 

ResourceIdentity

PwsResourceRef

No


The resource identity when acting on behalf of, if not specified, the authenticated resource identity will be used.


AlertsPeriodType

String

No

 'W' for weekly

The alerts period type:

"D" for day,

"W" for week

"M" for month

"A" for accounting period

M

MissingTimeCalculateDailyFlag

Boolean

No

false

If set to 'true', missing time will be determined on a daily basis. That is, a missing time alert will be generated for any day on which the reported hours are exceeded by the working hours, even if for the week as a whole, the working hours were met.

false

IncludeRejectedOrIncompleteTimeoffFlag

Boolean

See IncludeDraftTimeFlag

No

false

If set to 'true', rejected or incomplete time off alerts will be returned.

true

Note: At least one of IncludeDraftTimeFlag, IncludeMissingTimeFlag, IncludeRejectedExpenseFlag, IncludeRejectedOrIncompleteTimeFlag or IncludeUnsubmittedExpenseFlag or IncludeRejectedOrIncompleteTimeoffFlag must be 'true'.

Request Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsGetAlerts>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>ASRSfTVqwiAveqJtZvLffA==</req:SessionTicket>
            <tim:CountOnlyFlag>false</tim:CountOnlyFlag>
            <tim:IncludeDraftTimeFlag>true</tim:IncludeDraftTimeFlag>
            <tim:IncludeMissingTimeFlag>false</tim:IncludeMissingTimeFlag>
            <tim:IncludeRejectedExpenseFlag>false</tim:IncludeRejectedExpenseFlag>
            <tim:IncludeRejectedOrIncompleteTimeFlag>true</tim:IncludeRejectedOrIncompleteTimeFlag>
            <tim:IncludeUnsubmittedExpenseFlag>false</tim:IncludeUnsubmittedExpenseFlag>
            <tim:AlertsPeriodType>M</tim:AlertsPeriodType>
            <tim:MissingTimeCalculateDailyFlag>false</tim:MissingTimeCalculateDailyFlag>
            <tim:IncludeRejectedOrIncompleteTimeoffFlag>true</tim:IncludeRejectedOrIncompleteTimeoffFlag>
         </pws:serviceRequest>
      </pws:PwsGetAlerts>
   </soapenv:Body>
</soapenv:Envelope>

...