<sp:ApptOfferMultRequest>
|
|
|
|
|
| <RequestCount>?</RequestCount>
| Unsigned int
| The total number of individual appointments in the overall job. | Y |
|
| <MultOptions>
|
| See the "Offer/Book Options" for the definitions of the permitted MultOptions listed below.
| N | |
|
| <OfferBestOnlyPerEmp>?</OfferBestOnlyPerEmp>
|
|
| N | |
|
| <RestrictSearch>?</RestrictSearch>
|
|
| N |
|
| </MultOptions>
|
|
|
|
|
| <MinPartialMatchCount>?</MinPartialMatchCount>
| Unsigned int
| MinPartialMatchCount determines whether partial matches are to be returned. If, for example, RequestCount is 4 and MinPartialMatchCount is 2, and a set of 4 offers is not available for a particular employee, then partial offers containing 3 and 2 offers will be returned. In this case 4 offers will still be returned, but the ones where there is no match will be null, i.e. the first field of the SP_ApptOffer, ApptDate, will be an empty string (“”). If RequestCount and MinPartialMatchCount have the same value, no partial matches will be returned | Y |
|
| <OfferAppts>
|
| The OfferAppts structure is the same as the sp:ApptOfferRequest structure defined in the Request Appointments SOAP API, but with the following differences as listed below. |
|
|
|
| <start> |
|
|
|
|
|
|
| <date>?</date> | spDate | The value of the start date should be different for each OfferAppts supplied. The first OfferAppts should contain a start date as it would in the sp:ApptOfferRequest structure defined in the Request Appointments SOAP API. However, subsequent OfferAppts will contain a start date which should normally be specified in a relative way in either of the following formats: | Relative Whole Day Appointments | +n
| In this format, the start date is interpreted as being exactly n days (operative days) after the start date in the previous OfferAppts. For example, +1 means exactly one day after the start date in the previous OfferAppts. | >=n | In this format, the start date is interpreted as being at least n days after the start date in the previous OfferAppts. |
| As an example: to get offers for 3 contiguous days from a given date, the first start date should be that given date and the second and third start date values should both be +1. In both of the above cases, n must be 1 or greater, but not so great that the search isn’t within the memory horizon. | | Part Day Appointments |
| For part day appointments, where the promSet field is used, for example, to specify a set of half day TimeBands, a relative start date will contain a count of a number of TimeBands instead of a number of days. That is: | +n(TBT) | Here, the start date is exactly n TimeBands after (ordered by their start times) the start date in the previous OfferAppts, where TBT is the type of the TimeBands which n is counting, but is on the same day. For example, if, in the ServiceOptimizer database, there is a TimeBand type of “HD” for all half day timebands, then +1(HD) means one half day (HD) after the start date in the previous OfferAppts, but on the same day (i.e. the first appointment is in the morning, the second in the afternoon). | >=n(TBT) | Similar to the above, except that the start date is interpreted as being at least n time bands of type TBT after the start date in the previous OfferAppts, but not necessarily on the same day. |
|
|
|
|
| </start> |
|
|
|
|
|
| <end> |
|
|
|
|
|
|
| <date>?</date> | spDate | If the end date is supplied in the first OfferAppts but not in subsequent ones, those end date values will be defaulted to be the same number of days after their corresponding start date as the first end date value is after the first start date value. |
|
|
|
| </end> |
|
|
|
|
|
| <band></band>
|
| The entire band structure of the sp:ApptOfferRequest API method must not be used inside the OfferAppts structure for an sp:ApptOfferMultRequest API method call. |
|
|
|
| <displayCostBreakdown>?</displayCostBreakdown> | boolean | If true return the Schedule Cost Breakdown structure details as part of the response. When set to true for at least one OfferApts structure, then the Cost Breakdown structure will be returned for all responses. However, If either the forceOptions InTray or InTrayWithSkill options are set to true, then the Schedule Cost Breakdown structure will not be returned in the response. | N |
|
| </OfferAppts>
|
|
|
|
|
| <OfferCount>?</OfferCount>
|
|
| N |
|
</sp:ApptOfferMultRequest>
|
|
|
|
|
