{"type":"doc","content":[{"type":"paragraph","content":[{"text":"We have covered setting up simple Resource Titles to display fields of your resource records (or other dimensions) on the calendar. It is also possible to calculate dynamic values on the fly, using your own Apex logic. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"For configuring simple Resource Titles, see: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gomeddo.atlassian.net/wiki/spaces/BPD/pages/315457537"}},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"One example use case for dynamic titles is summing values of reservations visible in the current view, as shown in the screenshot below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":611,"id":"f7f80983-8eb4-495a-8032-cbcb07eb55b6","collection":"contentId-315686922","type":"file","height":150}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Only use dynamic titles on the multi resource calendar when there is no other way to achieve the same functionality (by using a formula field for example).","type":"text"},{"type":"hardBreak"},{"text":"The multi resource calendar could potentially display a large number of resources, and dynamically recalculating the values every time the users view changes can negatively impact the user experience. This is of less concern on the single resource calendar but other options are almost always faster.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create an Apex class","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Write a ","type":"text"},{"text":"global","type":"text","marks":[{"type":"strong"}]},{"text":" apex class that implements the ","type":"text"},{"text":"B25.Util_PluginManager.DynamicResourceTitles","type":"text","marks":[{"type":"strong"}]},{"text":" interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the following method: ","type":"text"},{"text":"Map calculateResourceTitles(B25.Util_PluginManager.DynamicResourceTitleData dataObj);","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"See the Interface Reference section below for more details.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the class.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a Resource Title record","type":"text"}]},{"type":"paragraph","content":[{"text":"Activate your implementation on a calendar by creating a Resource Title record for it.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the ","type":"text"},{"text":"Calendars tab","type":"text","marks":[{"type":"strong"}]},{"text":" and find the calendar that you want to apply the dynamic titles on.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the Related subtab, find the ","type":"text"},{"text":"Resource Titles related list","type":"text","marks":[{"type":"strong"}]},{"text":" and click New.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure to select ","type":"text"},{"text":"Resource Title","type":"text","marks":[{"type":"strong"}]},{"text":" when prompted for the record type.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the ","type":"text"},{"text":"Title Name","type":"text","marks":[{"type":"strong"}]},{"text":", enter the name of the class you created in the previous section.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Dynamic","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Interface Reference","type":"text"}]},{"type":"paragraph","content":[{"text":"The DynamicResourceTitles interface enforces one method: calculateResourceTitles. This method takes a B25.Util_PluginManager.DynamicResourceTitleData object as input. This object contains the following information:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"27c7354c-843e-4a45-9506-60cf2ef58b43"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"viewName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the current view that the user sees on the calendar.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"startDatetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"Datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"The start of the current view that the user sees on the calendar.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"endDatetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"Datetime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"The end of the current view that the user sees on the calendar.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"resourceToVisibleReservations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"Map>","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"Map of resource ids to a list of the ids of the reservations that are currently visible to the user. This list will also contain any unshared reservations that are visible to the user (if \"","type":"text"},{"text":"Show greyed out blocks on the calendar for unshared reservations","type":"text","marks":[{"type":"strong"}]},{"text":"\" is enabled). If you want to query the unshared reservations as well as the shared ones the implementation class needs to be without sharing.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[238.0]},"content":[{"type":"paragraph","content":[{"text":"resourceToHiddenReservations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"Map>","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[732.0]},"content":[{"type":"paragraph","content":[{"text":"Map of resource ids to a list of the ids of the reservations that are currently hidden from the user by reservation filters on the calendar.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Using this information the method should calculate the values for each resource and return a Map containing a mapping of the resource to the value that should be displayed on the calendar.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example displays the number of currently visible reservations in each resource.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"global with sharing class DynamicTitleImplementation implements B25.Util_PluginManager.DynamicResourceTitles {\n\n\tglobal Map calculateResourceTitles(B25.Util_PluginManager.DynamicResourceTitleData dataObj) {\n\n\t\t// all the reservations that are currently visible to the user, mapped to their resource\n\t\tMap> visibleReservations = dataObj.resourceToVisibleReservations;\n\n\t\t// the values we are going to return, mapped by resource\n\t\tMap output = new Map();\n\t\t\n\t\t// loop over each resource\n\t\tfor (Id resourceId : visibleReservations.keySet()) {\n\t\t\t\n\t\t\t// get the visible reservations in the current resource\n\t\t\tList reservationIds = visibleReservations.get(resourceId);\n\t\t\t\n\t\t\t// how many are there?\n\t\t\tInteger numberOfReservations = reservationIds.size();\n\t\t\t\n\t\t\t// add the result to the output map\n\t\t\toutput.put(resourceId, String.valueOf(numberOfReservations));\n\t\t}\n\t\treturn output;\n\t}\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Unit testing dynamic resource titles","type":"text"}]},{"type":"paragraph","content":[{"text":"To unit test your implementation you can construct a B25.Util_PluginManager.DynamicResourceTitleData set the parameters required by your implementation and call your calculateResourceTitles implementation.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@IsTest\npublic with sharing class TestDynamic {\n \n @IsTest\n\tpublic static void calculateResourceTitles() {\n\t\t// Create a new data object and set the data required by your implemetation\n\t\tString fakeId = '000000000000000000';\n B25.Util_PluginManager.DynamicResourceTitleData data = new B25.Util_PluginManager.DynamicResourceTitleData();\n data.resourceToVisibleReservations = new Map>();\n data.resourceToVisibleReservations.put('000000000000000001', new List{fakeId, fakeId, fakeId});\n data.resourceToVisibleReservations.put('000000000000000002', new List{fakeId, fakeId});\n \n // Call the implementation\n DynamicTitleImplementation implementation = new DynamicTitleImplementation();\n Map result = implementation.calculateResourceTitles(data);\n System.assertEquals('3', result.get('000000000000000001'));\n System.assertEquals('2', result.get('000000000000000002'));\n\t}\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Related articles","type":"text"}]},{"type":"paragraph","content":[{"type":"placeholder","attrs":{"text":"Related articles appear here based on the labels you select. Click to edit the macro and add or change labels."}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"max":{"value":"5"},"spaces":{"value":"com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@101b6"},"sort":{"value":"modified"},"showSpace":{"value":"false"},"reverse":{"value":"true"},"type":{"value":"page"},"cql":{"value":"label in ( \"resource-layout\" , \"calendar\" ) and type = \"page\" and space = \"BPD\""},"labels":{"value":"calendar resource-layout"}},"macroMetadata":{"macroId":{"value":"b49b4d92-e337-4c48-9249-1e25cc80ffd5"},"schemaVersion":{"value":"4"},"title":"Content by Label"}},"localId":"88242b99-676e-442c-9b2e-fc4ed0deafc2"}},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","localId":"d1ff508a-a0a3-450a-8dc1-191ba5f66761"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1160.0]},"content":[{"type":"paragraph","content":[{"text":"Related issues","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported