{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"9dc1e2da-9e4d-48d5-afed-1aa6ae3ea801"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"349f7074-3680-42b0-94f9-bdecc22d3dd7"},"content":[{"type":"paragraph","content":[{"text":"Finds available time slots for a given reservation.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For each dimension that a reservation can be related to (through either a lookup or a junction), this class supports two use cases:","type":"text"}]},{"type":"paragraph","content":[{"text":"Simple ","type":"text","marks":[{"type":"strong"}]},{"text":"- The exact related record is already known. I.e. the resource lookup has already been populated with the id of room one.","type":"text"}]},{"type":"paragraph","content":[{"text":"Complex ","type":"text","marks":[{"type":"strong"}]},{"text":"- The related record can be any out of a pool of records. I.e. we have a pool of resources (let’s say all rooms in building one), for which we want to know all the possible time slots.","type":"text"}]},{"type":"paragraph","content":[{"text":"These use cases can be mixed in a single call to the method. For example the resource is fixed but the staff can be any from a pool of staff members.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example use cases for lookups","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Simple use case","type":"text"}]},{"type":"paragraph","content":[{"text":"The reservation I want to make has to be in room one, with staff Alex. I pass this reservation to the method, with the resource and staff lookups populated. The method result gives me a simple list of time slots when both the room and the staff are available.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Complex use case","type":"text"}]},{"type":"paragraph","content":[{"text":"The reservation I want to make has to be in building one (so in ","type":"text"},{"text":"any","type":"text","marks":[{"type":"strong"}]},{"text":" of the rooms there), with ","type":"text"},{"text":"any","type":"text","marks":[{"type":"strong"}]},{"text":" of the staff that work at building one. I pass the reservation to the method, ","type":"text"},{"text":"without","type":"text","marks":[{"type":"strong"}]},{"text":" the resource and staff lookups populated. I separately pass the allowed room ids and staff ids. The method result gives me a more complex list of time slots, each with all the possible room and staff combinations available at that time.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"We have some handy utilities for finding the ids to pass to this method!","type":"text"}]},{"type":"paragraph","content":[{"text":"To get all the room ids in a specific building, use the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3586457603"}},{"text":" global class.","type":"text"}]},{"type":"paragraph","content":[{"text":"To get all the staff that work in building one (defined through availability records), use the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3586785284"}},{"text":" global class.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example use cases for junctions","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Simple use case","type":"text"}]},{"type":"paragraph","content":[{"text":"The reservation I want to make has to have two reservation contacts: John and Alex. I pass this reservation to the method, with two reservation contact records (one for John, one for Alex) in the separate ","type":"text"},{"text":"junctions ","type":"text","marks":[{"type":"strong"}]},{"text":"property. The method result gives me a simple list of time slots when both John and Alex are available.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Complex use case","type":"text"}]},{"type":"paragraph","content":[{"text":"The reservation I want to make has to have two participants (reservation contacts) out of five possible participants. I pass ","type":"text"},{"text":"five ","type":"text","marks":[{"type":"strong"}]},{"text":"reservation contact records (one for each possible participant) in the ","type":"text"},{"text":"junctions ","type":"text","marks":[{"type":"strong"}]},{"text":"property. In the ","type":"text"},{"text":"requestedNumberOfJunctions","type":"text","marks":[{"type":"strong"}]},{"text":" property, I specify that I need ","type":"text"},{"text":"two ","type":"text","marks":[{"type":"strong"}]},{"text":"reservation contacts to be available. The method result gives me a complex list of time slots, each with all the possible combinations of participants available at that time.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Methods","type":"text"}]},{"type":"expand","attrs":{"title":"findTimeSlots"},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This method returns the times that a given reservation (optionally with junctions) is possible.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Signature","type":"text"}]},{"type":"codeBlock","content":[{"text":"global static B25.TimeSlotFinder.Result findTimeSlots(B25.TimeSlotFinder.Context)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotFinder.Context","type":"text"}]},{"type":"paragraph","content":[{"text":"Contains the reservation, its junctions, and a definition of what the resulting series of time slots should look like (such as slot duration and interval ).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Return Type","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotFinder.Result","type":"text"}]},{"type":"paragraph","content":[{"text":"Contains a ","type":"text"},{"text":"List timeSlots","type":"text","marks":[{"type":"code"}]},{"text":" property with the available time slots.","type":"text"}]}]},{"type":"expand","attrs":{"title":"findTimeSlotsBulkified"},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"Bulkified version of ","type":"text"},{"text":"findTimeSlots","type":"text","marks":[{"type":"code"}]},{"text":". At the time of writing, this method is for convenience only and does not do anything more efficient than calling the unbulkified method multiple times.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Signature","type":"text"}]},{"type":"codeBlock","content":[{"text":"global static List findTimeSlotsBulkified(List contexts)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameters","type":"text"}]},{"type":"codeBlock","content":[{"text":"List","type":"text"}]},{"type":"paragraph","content":[{"text":"A list of request contexts.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Return Type","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotFinder.Result","type":"text"}]},{"type":"paragraph","content":[{"text":"A list of results.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Inner Classes","type":"text"}]},{"type":"expand","attrs":{"title":"Context"},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This class wraps the request context.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Properties","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotGenerator.Context timeSlotContext","type":"text"}]},{"type":"paragraph","content":[{"text":"Contains the definition of what the resulting series of slots should look like, such as the date range, slot duration and slot interval. For more details see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3477766153"}}]},{"type":"codeBlock","content":[{"text":"B25__Reservation__c reservation","type":"text"}]},{"type":"paragraph","content":[{"text":"The reservation to find available time slots for. Make sure all fields that can influence conflict checking are populated. If you are applying the simple use case for lookups (explained here), make sure any lookups to dimensions (resource/staff/etc) that need to be available are populated. Start and end times are not necessary and will be ignored.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Map> fieldIds","type":"text"}]},{"type":"paragraph","content":[{"text":"Optional.","type":"text","marks":[{"type":"strong"}]},{"text":" If you are applying the ","type":"text"},{"text":"complex use case for lookups","type":"text","marks":[{"type":"link","attrs":{"href":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3475996673/TimeSlotFinder#Complex-use-case"}}]},{"text":", populate this with the possible ids mapped by the api name of the corresponding lookup field.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Map> junctions","type":"text"}]},{"type":"paragraph","content":[{"text":"Optional.","type":"text","marks":[{"type":"strong"}]},{"text":" If you need any junctions to be available, add them here mapped by relationship name. Applies to both the simple and the complex use case.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Map requestedNumberOfJunctions","type":"text"}]},{"type":"paragraph","content":[{"text":"Optional.","type":"text","marks":[{"type":"strong"}]},{"text":" If you are applying the ","type":"text"},{"text":"complex use case for junctions","type":"text","marks":[{"type":"link","attrs":{"href":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3475996673/TimeSlotFinder#Complex-use-case.1"}}]},{"text":", populate this with the required numbers of available junctions, mapped by relationship name.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Result"},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This class wraps the result, which contains a list of available time slots.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Properties","type":"text"}]},{"type":"codeBlock","content":[{"text":"List timeSlots","type":"text"}]},{"type":"paragraph","content":[{"text":"The time slots when the given reservation (and junctions) are available. Each time slot has a ","type":"text"},{"text":"startDateTime","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"endDateTime","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are applying the complex use case for at least one lookup or junction, this property will contain additional data. Each B25.TimeSlot entry in this list will be castable to B25.TimeSlotWithReservations, which have an additional property:","type":"text"}]},{"type":"codeBlock","content":[{"text":"List reservations","type":"text"}]},{"type":"paragraph","content":[{"text":"This property will contain all the reservations that are possible during that time slot. The B25.Reservation data type is a wrapper around a reservation and its child records. It has the following properties:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Reservation__c reservation","type":"text"}]},{"type":"paragraph","content":[{"text":"The actual reservation record.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Map> childRecords","type":"text"}]},{"type":"paragraph","content":[{"text":"The child records of the reservation (mapped by relationship name). When applying the ","type":"text"},{"text":"complex use case for junctions","type":"text","marks":[{"type":"link","attrs":{"href":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/3475996673/TimeSlotFinder#Complex-use-case.1"}}]},{"text":", this will contain the available junctions at the given time slot.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Simple use case","type":"text"}]},{"type":"paragraph","content":[{"text":"This example shows the simple use case (both for lookups and junctions).","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotFinder.Context context = new B25.TimeSlotFinder.Context();\n\n// set the reservation to find time slots for\ncontext.reservation = new B25__Reservation__c(\n // make sure to populate all fields that are relevant for conflict checking\n // and link this reservation to all dimensions that need to be available\n B25__Resource__c = someResourceId\n // note that start and end times are not necessary\n);\n\n// if you need any junctions to be available, map them by relationship name\ncontext.junctions = new Map>{\n 'B25__Reservation_Contacts__r' => new List{\n new B25__ReservationContact__c(\n B25__Contact__c = someContactId\n // note that a reservation id is not necessary\n )\n }\n};\n\n// the time slot context defines what the resulting series of slots should look like\ncontext.timeSlotContext = new B25.TimeSlotGenerator.Context();\ncontext.timeSlotContext.startOfRange = System.now();\ncontext.timeSlotContext.endOfRange = System.now().addDays(7);\ncontext.timeSlotContext.duration = 60;\ncontext.timeSlotContext.interval = 15;\n\n// call the method and do something with the result\nB25.TimeSlotFinder.Result result = B25.TimeSlotFinder.findTimeSlots(context);\nfor (B25.TimeSlot timeSlot : result.timeSlots) {\n System.debug('available time slot from ' + timeSlot.startDatetime\n + ' until ' + timeSlot.endDatetime);\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Complex use case","type":"text"}]},{"type":"paragraph","content":[{"text":"This example shows the complex use case for lookups:","type":"text"}]},{"type":"codeBlock","content":[{"text":"B25.TimeSlotFinder.Context context = new B25.TimeSlotFinder.Context();\n\n// the time slot context defines what the resulting series of slots should look like\ncontext.timeSlotContext = new B25.TimeSlotGenerator.Context();\ncontext.timeSlotContext.startOfRange = System.now();\ncontext.timeSlotContext.endOfRange = System.now().addHours(2);\ncontext.timeSlotContext.duration = 60;\ncontext.timeSlotContext.interval = 15;\n// specify all the potential resource ids\n// NOTE: replace these with resource ids that exist in your org!\ncontext.fieldIds = new Map>{\n\t'B25__Resource__c' => new List{'a0eJX000000hnL7YAI', 'a0eJX000000hnL8YAI'}\n};\n\n// call the method and do something with the result\nB25.TimeSlotFinder.Result result = B25.TimeSlotFinder.findTimeSlots(context);\nfor (B25.TimeSlot timeSlot : result.timeSlots) {\n\tSystem.debug('available time slot from ' + timeSlot.startDatetime\n\t\t+ ' until ' + timeSlot.endDatetime);\n\tB25.TimeSlotWithReservations timeSlotWithReservations = (B25.TimeSlotWithReservations) timeSlot;\n\tSystem.debug(timeSlotWithReservations.reservations);\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"GoMeddo Rest API","type":"text"}]},{"type":"paragraph","content":[{"text":"In the GoMeddo Rest API, there is a similar function called ","type":"text"},{"text":"/timeSlots","type":"text","marks":[{"type":"strong"}]},{"text":" that displays available timeslots based on a given reservation.","type":"text"}]},{"type":"paragraph","content":[{"text":"https://apidocs.gomeddo.com/#/availability/post_timeSlots","type":"text","marks":[{"type":"link","attrs":{"href":"https://apidocs.gomeddo.com/#/availability/post_timeSlots"}}]},{"text":" ","type":"text"}]},{"type":"paragraph"}],"version":1}