Skip Navigation
Creating Service Requests about Capacity API behavior
Answer ID 8905   |   Last Review Date 11/07/2022

How can I properly create a customer Service Request about unexpected Capacity API behavior in Oracle Field Service?


Oracle Field Service (OFS)


To properly create a customer Service Requests about unexpected Capacity API behavior, we suggest you to follow these steps:

1)  Understanding Multiple Capacity categories requests

According to the Capacity API documentation, if an activity to be booked requires quota in multiple capacity categories, and some of these capacity categories are closed for a given capacity bucket and day, the 'get_capacity' function does not return quota for all the required categories. This constraint is applied only when the 'calculate_work_skill' flag is set and the list of capacity categories is determined by the 'get_capacity' function.

Depending on the capacity categories configuration, some capacity requests that used to provide available time slot will no longer respond anything. This could be the expected behavior according to the capacity category meaning.

For more details, go to the OFS documentation URL (OFS Documentation).

2)  Provide the capacity request XML

The OFS capacity request does not have any specific appointment number that would help support team find it on the OFS logs.

So, it will be helpful if the XML request and also the response be added as part of the Service Request.



<soapenv:Envelope xmlns:soapenv="" xmlns:urn="urn:toa:capacity">
         <!--1 or more repetitions:-->
         <!--Zero or more repetitions:-->
         <!--Zero or more repetitions:-->


<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="" xmlns:SOAP-ENV="" xmlns:xsd="" xmlns:xsi="" xmlns:SOAP-ENC="" xmlns:si="" xmlns:ns1="" xmlns:tns="NameSpace">
      <urn:get_capacity_response xmlns:urn="urn:toa:capacity">

3)  Explain the expected work skills for the input parameters of the capacity request

Work skills conditions configuration is something very specific of each customer. So, if you can provide the expected work skills for the capacity API request input parameters as part of the Service Request,  the response for your requirement could probably be provided faster and, because of that, the issue could probably be solved sooner.

e.g. For the previous Capacity Request, OFS should consider this work skill : Internet Installation(1/10) 

Explain the expected response and the reason

Finally, is very important for the Support Team to understand what the customer is expecting instead of the detected behavior, so, it would be great if you can provide the expected response and why you were expecting it.

e.g. considering that this Work Skill is part of the Capacity Category 'Internet Capacity', and this Capacity Category has been included on the bucket and it has available minutes, we expected that the capacity API would provide a list of available time slots.