Add custom buttons to the Reservation Form

GoMeddo allows you to add your own buttons to the reservation form.

The screenshot below shows a reservation form with two custom buttons:

• View in Salesforce is a custom button that is added when GoMeddo is installed.

• Run Flow is a custom button that has been added by an admin.

Ways of adding custom buttons

There are two ways to add custom buttons to the reservation form:

1. Through configuration
   This is the easiest way as it does not require any code. This is supported on both VisualForce and Lightning calendars.

2. Through Apex code
   This way requires some code but also allows you to do more. This is only supported on Lightning calendars.

This article explains how to add custom buttons through configuration. Adding custom buttons through code is an advanced topic and requires you to understand how to use Custom Form Logic.

Adding custom buttons through configuration

Custom buttons added through configuration can do the following things:

• Run a Flow

• Execute Apex code

• Redirect to a VisualForce page

The next sections will explain how to configure buttons to do these things.

Run an Autolaunched Flow

1. Click on Setup and search for Custom Settings

2. Click on Manage next to Custom Buttons

3. Click New

4. Fill in an appropriate Name and Label

5. Fill in Flow Name. This needs to be the name of a flow that takes a reservation as input and gives a reservation back as output. To easily create such a flow, you can clone the ‘Default Reservation Flow Template’ included in GoMeddo.

6. Click Save

When the button is clicked, the flow will be executed. Keep in mind that if the reservation is modified by the flow, these changes are not visible unless the form is in edit mode. Make sure that all the fields referenced by the flow are either present on the form, or query the reservation from the database in your flow to get the field value (this is not possible for new reservations that have not been saved yet).

Redirecting to a custom VisualForce page

1. Click on Setup and search for Custom Settings

2. Click on Manage next to Custom Buttons

3. Click New

4. Fill in an appropriate Name and Label

5. Fill in /apex/c__{vfpagename}?id= in the URL field where {vfpagename} is the name of your visualforce page

6. Click Save

This button will now be added to the reservation form. On click, it will perform the logic in the VisualForce page's controller on the reservation record.

Defining a custom apex class

1. Create a global Apex class that implements the B25.ExecutableCustomButton interface. For an example, see the code below.

2. Click on Setup and search for Custom Settings

3. Click on Manage next to Custom Buttons

4. Click New

5. Fill in an appropriate Name and Label

6. Fill in the name of the apex class in the Executable Class Name field

7. Click Save

This button will now be added to the Reservation Form. On click, it will perform the logic in the Apex class and update the form according to any changes made.

Implementing the B25.ExecutableCustomButton interface

The B25.ExecutableCustomButton requires you to implement one method public void execute(B25.ExecutableCustomButtonContext context).

This method is called when the user clicks the button on the Reservation Form.

The ExecutableCustomButtonContext object contains the following data:

Below is a sample implementation that moves the Reservation forward by one hour. It updates both the B25__StartLocal__c and B25__Start__c fields, as otherwise a 'time mismatch error' may occur. 

Code example

global with sharing class ExampleImplementation implements B25.ExecutableCustomButton {

   public void execute(B25.ExecutableCustomButtonContext context) {
      context.reservation.B25__StartLocal__c = context.reservation.B25__StartLocal__c.addHours(1);
      context.reservation.B25__EndLocal__c = context.reservation.B25__EndLocal__c.addHours(1);
      context.reservation.B25__Start__c = context.reservation.B25__Start__c.addHours(1);
      context.reservation.B25__End__c = context.reservation.B25__End__c.addHours(1);
      Database.update(context.reservation);
   }
}

Related articles

• Page:
  Add custom buttons to the Reservation Form
• Page:
  Displaying Dimension Junctions on the Reservation Form
• Page:
  Add custom fields to the Reservation form