{"id":4218,"date":"2017-01-05T16:09:58","date_gmt":"2017-01-05T10:39:58","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=4218"},"modified":"2017-01-05T16:09:58","modified_gmt":"2017-01-05T10:39:58","slug":"configure-booking-recurrence-pattern-based-on-custom-optionset","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2017\/01\/configure-booking-recurrence-pattern-based-on-custom-optionset\/","title":{"rendered":"Configure Booking Recurrence Pattern based on Custom OptionSet"},"content":{"rendered":"

Introduction<\/strong>:<\/p>\n

In the Field Service, we can provide preventive maintenance to the client, based on the recursive work order.<\/p>\n

To create recursive work order automatically based on certain date interval, we need to configure the Booking Recurrence pattern. To configure, we set the date interval and based on this date interval the Booking Date record is automatically created. Booking Date record in the Field Service describes at which date the Work Order record should be created for the customer. Based on the Booking Date records the work order is automatically created for the client.<\/p>\n

OOB Functionality to Configure the Booking Recurrence:<\/strong><\/p>\n

First, create an Agreement record for the customer.<\/p>\n

\"Create<\/p>\n

And, then create a Booking Setup record associated with this Agreement.<\/p>\n

\"create<\/p>\n

After creating the Booking setup record for the Agreement, we need to configure the Booking Recurrence. Once the user configures the Booking Recurrence pattern, then based on it, the Booking Date records is automatically created.<\/p>\n

Configure Booking Recurrence Pattern:<\/strong><\/p>\n

To configure the Booking Recurrence pattern, user needs to navigate to the Booking Setup record and click on the \u201cBOOKING RECURRENCE\u201d Button as shown in the below picture.<\/p>\n

\"3\"<\/p>\n

Once the user clicks on the \u201cBOOKING RECURRENCE\u201d button, the following window is opened, where the user provides the required information.<\/p>\n

\"Recurrence<\/p>\n

The above Booking Recurrence pattern is an example of quarterly basis, i.e. the booking dates are brought forth on the interval of 3 months, finally based on Booking Dates record the Work order is generated. To configure the Booking Recurrence Pattern, a User requires too many clicks and needs to provide the information based on his\/her requirement as shown in the above Booking Recurrence Pattern window, repeatedly, for each customer.<\/p>\n

One Click solution<\/strong>:<\/p>\n

To make the above process simple for a User, we can make a custom Option Set field \u201cBooking Recurrence<\/strong>\u201d on the Booking Setup form with the most commonly used option values like \u201cMonthly\u201d, \u201cQuarterly\u201d, \u201cBi-annually\u201d and \u201cAnnually\u201d as indicated in the below picture.<\/p>\n

\"Booking<\/p>\n

And by selecting any one option from the above option set, the Booking Recurrence pattern is automatically generated. Based on the Booking Recurrence pattern, the Booking Date record gets created.<\/p>\n

To develop the above functionality, follow the below steps.<\/p>\n

    \n
  1. We found that there is a \u201cRecurrence Setting<\/strong>\u201d field on the Booking Setup form, but Out of the box, this field is hidden. We need to set an XML string (format of XML string given below) in this field.<\/li>\n
  2. Once the XML string is set in this field, an OOB Field Service Workflow is triggered. It generates the Booking Date record based on value provided in the XML string.<\/li>\n<\/ol>\n

    The structure of the XML string for most commonly used Booking Recurrence Pattern is given below.<\/p>\n

    For Monthly:<\/strong><\/p>\n

    var recurrenceSettingXml = \n\"<root><pattern><period>monthly<\/period><option>every<\/option><months every='1'><day>1<\/day><\/months><\/pattern><range><start> AGREEMENTSTARTDATE <\/start><option>endBy<\/option><end> AGREEMENTENDDATE <\/end><\/range><datas\/><\/root>\"\n<\/pre>\n
    For Quarterly:<\/strong><\/p>\n
    var recurrenceSettingXml =\n\"<root><pattern><period>monthly<\/period><option>every<\/option><months every='3'><day>1<\/day><\/months><\/pattern><range><start> AGREEMENTSTARTDATE <\/start><option>endBy<\/option><end> AGREEMENTENDDATE <\/end><\/range><datas\/><\/root>\"\n<\/pre>\n
    For BI-Annually:<\/strong><\/p>\n
    var recurrenceSettingXml =\n\"<root><pattern><period>monthly<\/period><option>every<\/option><months every='6'><day>1<\/day><\/months><\/pattern><range><start> AGREEMENTSTARTDATE <\/start><option>endBy<\/option><end> AGREEMENTENDDATE <\/end><\/range><datas\/><\/root>\"\n<\/pre>\n
    For Annually:<\/strong><\/p>\n
    var recurrenceSettingXml =\n\"<root><pattern><period>yearly<\/period><option>every<\/option><years every='11'><day>1<\/day><\/years><\/pattern><range><start> AGREEMENTSTARTDATE <\/start><option>endBy<\/option><end> AGREEMENTENDDATE <\/end><\/range><datas\/><\/root>\"\n<\/pre>\n
    \u00a0Where,<\/p>\n