...
Custom Form Logic for a high level overview
Quick Start Guide to help you get your first implementation up and running
API Reference for details on the methods and objects you can use
Detailed Code Samples
This section currently contains some quick examples without much explanation. For a more thoroughly detailed example, seea few detailed code samples intended as tutorials to give you more guidance:
...
...
Quick and Dirty Code Samples
This section contains some quick examples without much explanation, intended to give you some more ideas of what is possible.
| Expand |
|---|
| title | Add the Account name to all Contact searches |
|---|
|
This example adds the Account name to each Contact appearing in the Contact lookup and Contact related list. | Code Block |
|---|
global class MyFormLogic implements B25. |
|
...
...
Customizer {
global void customize(B25.Form form) {
|
|
...
form.getLookup(B25__Reservation__c.B25__Contact__c).onSearch(new ContactSearchHandler());
|
|
...
...
...
...
...
...
ContactSearchHandler());
}
global |
|
...
...
...
...
...
...
...
SearchResultCollection getSearchResults(B25. |
|
...
...
...
searchContext.setMetaTemplate('{0}', new List<String>{'Account.Name'});
|
|
...
return searchContext.getDefaultResults();
}
|
|
...
| title | Add extra options to the Reservation Contact search to add all Contacts of the current Account to the related list |
|---|
...
...
| Expand |
|---|
| title | Immediately add all group members as reservation contacts when selecting a group. |
|---|
|
| Code Block |
|---|
global with sharing class MyFormLogic implements B25.Form.Customizer {
global void customize(B25.Form form) {
// Trigger MyGroupHandler |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
form.getField(B25__Reservation__c.B25__Group__c).onUpdate(new MyGroupHandler());
}
global with |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
void handleEvent(B25.FormEvent event, B25.Form form) {
|
|
...
...
...
...
...
// Get all members that belong to the group
|
|
...
Id newGroupId = (Id) event.getNewValue();
|
|
...
List<B25__Group_Membership__c> groupMembers = [SELECT B25__Contact__c FROM B25__Group_Membership__c WHERE B25__Group__c = :newGroupId];
// Loop through the members and add the |
|
...
...
reservation contacts
for(B25__Group_Membership__c groupMember : groupMembers){
|
|
...
B25__ReservationContact__c reservationContact = new B25__ReservationContact__c();
|
|
...
reservationContact.B25__Contact_Lookup__c = groupMember.B25__Contact__c;
|
|
...
...
...
...
...
...
...
...
...
...
form.getRelatedList(B25__ReservationContact__c.SObjectType).addRecord(reservationContact);
|
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
__Reservation__c.B25__Quantity__c).updateValue(groupMembers.size());
|
|
...
| Expand |
|---|
| title | Add an extra option to the reservation contact search that adds all contacts linked to the selected account as reservation contacts |
|---|
|
| Code Block |
|---|
| global class ReservationContactAddedHandler extends B25.FormEventHandler {
global override void handleEvent(B25.FormEvent event, B25.Form form) {
B25__Reservation__c reservation = form.getReservation(); |
|
...
if (reservation.B25__Account__c |
|
...
== null || event.getNewValue() != 'all-contacts') {
|
|
...
...
...
...
...
...
...
...
...
}
for (Contact contact : [SELECT Id FROM Contact WHERE AccountId = :reservation.B25__Account__c]) {
|
|
...
form.getRelatedList(B25__ReservationContact__c.SObjectType).addRecord(new B25__ReservationContact__c(
|
|
...
B25__Contact_Lookup__c = contact.Id
));
|
|
...
...
ReservationContactSearchHandler extends B25.SearchHandler {
global override B25.SearchResultCollection getSearchResults(B25.SearchContext searchContext) |
|
...
...
| title | Add an extra option to the reservation contact search that adds all contacts linked to the selected account as reservation contacts |
|---|
...
B25.SearchResultCollection searchCollection = searchContext.getDefaultResults();
|
|
...
...
...
...
...
SearchResultCollection updatedCollection = new B25. |
|
...
SearchResultCollection();
|
|
...
if (searchContext.getForm().getReservation().B25__ |
|
...
...
!= null) {
updatedCollection.addSearchResult(
|
|
...
...
...
...
...
...
...
SearchResult('all-contacts', 'Add all contacts linked to current account')
.setPreventDefault(true)
|
|
...
.setIcon('standard:contact_list')
|
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
addSearchResults(searchCollection.getSearchResults());
return updatedCollection;
}
} |
|
| Expand |
|---|
| title | Update the status to the status with the same name as the reservation title |
|---|
|
|
...
class ReservationTitleUpdateHandler extends B25.FormEventHandler {
global override void handleEvent(B25.FormEvent event, |
|
...
...
...
...
(String) event.getNewValue();
List<B25__Reservation_Status__c> matchingStatus = [SELECT Id FROM B25__Reservation_Status__c WHERE Name = :newTitleValue];
if |
|
...
(!matchingStatus.isEmpty()) {
|
|
...
...
...
getField(B25__Reservation__c.B25__ |
|
...
...
).updateValue(matchingStatus[0].Id);
}
|
|
...
| Expand |
|---|
| title | Remove all reservation contacts if the account field is cleared |
|---|
|
| Code Block |
|---|
global class ReservationAccountChangeHandler extends B25.FormEventHandler {
global override void |
|
...
handleEvent(B25.FormEvent event, B25. |
|
...
Form form) {
String newAccountValue = (Id) event.getNewValue();
if |
|
...
...
...
newAccountValue)) {
for(B25.RelatedListItem item |
|
...
: form.getRelatedList(B25__ReservationContact__c.SObjectType).getItems()) {
|
|
...
...
...
...
...
...
| Set all reservation contacts to checked in if the status |
|
...
...
ReservationStatusChangeHandler extends B25.FormEventHandler {
global override void handleEvent(B25 |
|
...
.FormEvent event, B25.Form form) {
Id newStatus |
|
...
...
...
...
.B25__Status__c;
List<B25__Reservation_Status__c> reservationStatus = [SELECT Id, Name FROM |
|
...
...
...
...
...
...
...
(reservationStatus.isEmpty()) {
return;
|
|
...
...
...
...
...
reservationStatus[0].Name == 'Completed') {
for(B25.RelatedListItem item : form.getRelatedList(B25__ReservationContact__c.SObjectType).getItems()) {
|
|
...
item.getField(B25__ReservationContact__c.B25__CheckedIn__c).updateValue(true);
}
} |
|
...
| title | Set all reservation contacts to checked in if the status is set to completed |
|---|
...
...
for(B25.RelatedListItem item : form. |
|
...
...
...
...
.SObjectType).getItems()) {
|
|
...
...
...
...
...
...
...
...
ReservationContact__c.B25__CheckedIn__c).updateValue(false);
|
|
...
...
...
...
| Expand |
|---|
| title | Adds the reservation contact back into the list when removed if the contact is the same as the selected contact on the reservation |
|---|
|
| Code Block |
|---|
| global class ReservationContactRemoveHandler extends |
|
...
B25.FormEventHandler {
global override void |
|
...
handleEvent(B25.FormEvent event, B25.Form form) {
B25__ReservationContact__c removedReservationContact = |
|
...
...
__ReservationContact__c) form.getRelatedList(B25__ReservationContact__c.SObjectType). |
|
...
getItemByGuid(event.getGuid()) |
|
...
...
(form.getReservation().B25__ |
|
...
Contact__c == removedReservationContact.B25__ |
|
...
...
...
...
form.getRelatedList(B25__ReservationContact__c.SObjectType). |
|
...
...
removedReservationContact);
|
|
...
| Expand |
|---|
| title | Randomise the icons on the resource lookup search results |
|---|
|
| Code Block |
|---|
global class ResourceLookupSearchHandler extends |
|
...
B25.SearchHandler {
global override B25.SearchResultCollection getSearchResults(B25.SearchContext searchContext) {
B25.SearchResultCollection searchCollection |
|
...
= searchContext.getDefaultResults();
|
|
...
for (B25.SearchResult result |
|
...
| title | Adds the reservation contact back into the list when removed if the contact is the same as the selected contact on the reservation |
|---|
...
...
: searchCollection.getSearchResults()) {
|
|
...
...
...
...
...
this.getRandomIconName());
}
|
|
...
...
...
...
return searchCollection;
}
|
|
...
private String getRandomIconName() {
return 'custom:custom' + |
|
...
...
valueOf(Math.Round(Math.Random() * (113-1) + 1));
}
} |
|
...
...
| Set the title of any newly created reservation to New Reservation |
|
| Code Block |
|---|
| global class FormInitHandler extends B25.FormEventHandler {
global override void handleEvent(B25.FormEvent event, B25.Form form) {
|
|
...
...
...
(form.getReservation().Id == null) {
form.getField(B25 |
|
...
__Reservation__c.B25__Title__c).updateValue('New Reservation');
|
|
...
...
...
...
| Expand |
|---|
| title | Toggle the checked in checkbox based on if the notes field contains checked in or checked out |
|---|
|
| Code Block |
|---|
global class ReservationContactNotesChangeHandler extends B25.FormEventHandler {
|
|
...
global override void handleEvent(B25.FormEvent event, B25.Form form) {
|
|
...
...
...
(String) event.getNewValue();
|
|
...
...
.isBlank(newNotesValue)) {
|
|
...
...
...
...
...
...
containsIgnoreCase('Checked In')) {
|
|
...
...
| title | Set the title of any newly created reservation to New Reservation |
|---|
...
...
form.getRelatedList(B25__ReservationContact__c.SObjectType).getitembyGuid(event.getGuid()).getField(B25__ReservationContact__c.B25__CheckedIn__c).updateValue(true);
} else if (newNotesValue.containsIgnoreCase('Checked Out')) {
|
|
...
form.getRelatedList(B25__ReservationContact__c.SObjectType).getitembyGuid(event.getGuid()).getField(B25__ |
|
...
...
B25__CheckedIn__c).updateValue( |
|
...
...
| Display two contact names linked to the account as meta text on the search result |
|
|
...
AccountLookupSearchHandler extends B25. |
|
...
SearchHandler {
global override |
|
...
...
SearchResultCollection getSearchResults(B25. |
|
...
...
...
B25.SearchResultCollection collection = |
|
...
new B25.SearchResultCollection();
|
|
...
for (Account account : [SELECT Id, Name, (SELECT Name |
|
...
FROM Contacts LIMIT 2) FROM Account LIMIT 20]) {
List<String> |
|
...
metaTextArray = new List<String>();
for (Contact contact : account.Contacts) {
metaTextArray.add(contact.Name);
}
|
|
...
...
...
collection.addSearchResult(new B25.SearchResult(account.Id, account.Name).setMetaText(String.join(metaTextArray, ', ')));
}
return collection;
}
} |
|
...
...
| If the status of the reservation is "completed" hide the title field, otherwise show |
|
| Code Block |
|---|
| global with sharing class MyFormLogic implements B25.Form.Customizer {
global |
|
...
...
...
...
we will add our handlers to the form
form |
|
...
...
...
...
onUpdate(new MyStatusHandler()); |
|
...
...
...
...
global with sharing class MyStatusHandler extends B25.FormEventHandler {
global override void |
|
...
...
.FormEvent event, B25.Form form) {
Id newStatusId = |
|
...
(Id) event.getNewValue();
|
|
...
...
| title | Display two contact names linked to the account as meta text on the search result |
|---|
...
...
B25__Reservation_Status__c status = [
|
|
...
...
...
...
...
...
...
...
...
...
...
...
FROM B25__Reservation_Status__c
WHERE Id = :newStatusId
|
|
...
...
...
...
...
...
...
status.Name == 'Completed') {
form.getField(B25__Reservation__c.B25__Title__c).hide();
|
|
...
...
...
...
...
...
B25__Reservation__c.B25__Title__c).show();
}
|
|
...