DayBack URLs

Manipulating DayBack with URL Parameters

DayBack can be controlled by altering its URL, adding new parameters as part of a custom action or button. In Salesforce Classic this is often done by adding buttons to your Salesforce layouts. And in Lightning, it's usually done when adding DayBack to a custom tab.

In FileMaker, you can pass URLs to DayBack using a FileMaker Script, or by setting global variables. Details below: passing URLs to FileMaker.

Options are passed as parameters in the URL. Here's an example URL that will deselect all sources (source=null), select the calendar named "Events" and switch to month view:

https://app.dayback.com/#/?source=null&source=Events&view=month

Available Options

Here's a reference for the URL parameters you can include. Please note that all of these are case sensitive.

Source	The simple example above included the source as a url parameter so that DayBack knows to turn on the calendar you're interested in. Without this parameter, the event you're looking of could be in a source that is currently filtered off: without a source specified the "Events" calendar may not be on when you arrive a DayBack. Note that the source parameter doesn't turn off any other calendars: it just makes sure that the one you specified is turned on. Format: `source=Events` where "Events" is the name of your calendar in Administrator Settings / Calendar Sources. Only a single source is accepted. To deselect all sources use `source=null`.
Date	Similar to the source, sending the date tells DayBack to navigate to the date you're interested in. Without this, DayBack could be focussed on another month and you wouldn't see what you're looking for. Format: `date=2016-04-11` where the date is in the form YYYY-MM-DD. Only a single date is accepted.
View	This is the name the DayBack tab you'd like to land on, like "Month". Format: `view=month` from this list of possible view names: Name of view -- Corresponding tab in DayBack basicDay -- Simple Day View agendaDay -- Day view with times down the left side basicWeek -- Simple Week View agendaWeek -- Week view with times down the left side month -- Month view basicResourceDays -- Resource tab, "Daily" with days down the left side agendaResourceVert -- Resource tab, "Schedule" with times down the left side agendaResourceHor -- Resource tab, "Pivot Schedule" with times across the top basicResourceVert -- Resource tab, "List" list view basicResourceHor -- Resource tab, "Pivot" list view basicHorizon -- Horizon view (Gantt Chart)
resourceDays	Sets the number of days in resource view. Format: resourceDays=2
sidebarShow	Determines if the left-hand sidebar is shown by default or not. Format: `sidebarShow=false`.
filterStatuses	Acts like clicking a status in the Status Filters sections of DayBack's sidebar Format: `filterStatuses=done`. Multiple values are accepted like this: `filterStatuses=Done&filterStatuses=Ready`.
filterResources	Acts like clicking a resource in the Resource Filters sections of DayBack's sidebar. Format: `filterResources=Admin%20User`. Multiple values are accepted like this: `filterResources=Admin%20User&filterResources=Beth%20Reynolds`. You can not pass a folder name this way.
filterContacts	Adds a "Contact Filters" section to the filters tab of the DayBack sidebar containing any people's names passed in. Use the name of the contact here, not their id. Format: `filterContacts=Lauren%20Boyle`. Multiple values are accepted like this: `filterContacts=Lauren%20Boyle&filterContacts=Andy%20Young`. To remove the "Contact Filters" section use `filterContacts=null`.
contactID	When a contact ID is passed in, any new calendar records created will be linked to this contact (as their "Related Who"). This is independent of filtering the calendar and requires the contactName URL parameter to be passed as well. Format: `contactID=W67YGT55623SC56`. Only a single value is permitted.
contactName	Required as part of passing in a contactID to be used when making new records on the calendar. Format: `contactName=Lauren%20Boyle`. Multiple values are not accepted.
filterProjects	Adds a "Project Filters" section to the filters tab of the DayBack sidebar containing any names passed in. You can send in any name that's the related "what" of a calendar item (a campaign, account, case, etc.). Format: `filterProjects=University%20of%20Arizona`. Multiple values are accepted like this: `filterProjects=University%20of%20Arizona&filterProjects=GenePoint`. To remove the "Project Filters" section use `filterProjects=null`.
projectID	When a project ID is passed in, any new calendar records created will be linked to this record (as their "Related What"). This is independent of filtering the calendar and requires the projectName URL parameter to be passed as well. Format: `projectID=F4560I88GTDw7889QeT`. Only a single value is permitted.
projectName	Required as part of passing in a projectID to be used when making new records on the calendar. Format: `projectName=Pegasus%20Installation`. Multiple values are not accepted.
filterText	Sets the text filter section of the filters tab in the DayBack sidebar containing the value passed in. Format: `filterText=Some%20Text%20I%20Like`. Multiple values are not accepted (a single string), however, your filter text can use operators. Should be URL Encoded. To remove the text filter, use `filterText=null`.

These headings that get added to the Filters tab of the sidebar--like "Contact Filters"--can be changed to suit your business vocabulary. Learn more in the article on translation.

Kiosk Mode

DayBack supports "kiosk mode" as a URL parameter for folks who want the calendar to run unattended on a large monitor as a whiteboard replacement. For example, this URL will refresh the calendar and update the focus to today every 10 minutes:

https://app.dayback.com/?kiosk=10#/

Changing URLs in FileMaker

In FileMaker, devs are often making custom sidebars and manipulating DayBack using scipts and buttons placed there. The easiest way to change DayBack's filters or views from these buttons is to manuipulate DayBack's URL using the syntaxt above. Use the FileMaker script "Show Project in Calendar - DayBack" that comes with DayBack. That script only works when you're ON the same layout/tab as DayBack.

If you want to set the URL when you're on a different tab/layout, before you arrive at DayBack, set the variable $$DBk_UrlParameters and then navigate to the calendar: see the last two lines of the script "Show Project in Calendar - DayBack" for an example.