{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"fdbcb4fb-0652-4057-839f-9ba4a491a89c"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"0bf2ac4b-f9c6-4bdc-989f-d870c742af0c"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Salesforce Validation Rules","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Pulsar directly supports evaluating Salesforce validation rules both online and offline.","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Supports most Salesforce formulas (see more information about ","type":"text"},{"text":"formula fields","type":"text","marks":[{"type":"link","attrs":{"href":"https://luminix.atlassian.net/wiki/spaces/PD/pages/10158120"}}]},{"text":")","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the processing steps on the ","type":"text"},{"text":"Pulsar Settings Manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://luminix.atlassian.net/wiki/spaces/PD/pages/625803269"}}]},{"text":" tab (NOTE: this is currently a limitation of the Salesforce platform, as we cannot directly sync validation rule metadata, but have to use the processing steps).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"pulsar.validation.enableSFDCValidationRules","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" Pulsar Setting to ","type":"text"},{"text":"TRUE","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to enable this functionality in the Pulsar mobile app","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NOTE: If a ","type":"text"},{"text":"PSL BeforeSave","type":"text","marks":[{"type":"em"}]},{"text":" setting exists on an object, it will be run ","type":"text"},{"text":"BEFORE","type":"text","marks":[{"type":"em"}]},{"text":" saving the object ","type":"text"},{"text":"and BEFORE","type":"text","marks":[{"type":"em"}]},{"text":" processing any Salesforce ValidationRules for that record.","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"PSL Validation Rules and Triggers","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Pulsar originally did not support running Salesforce validation rules, and instead offered similar functionality through logic implemented in ","type":"text"},{"text":"Pulsar Settings Language (PSL).","type":"text","marks":[{"type":"link","attrs":{"href":"https://luminix.atlassian.net/wiki/spaces/PD/pages/10158083"}}]},{"text":" Because PSL leverages the power of raw SQL, you can create complex validation logic that exceeds what Salesforce formula validation rules can perform. Despite (or frankly because of) the power of PSL validation rules and triggers, ","type":"text"},{"text":"we recommend that you use Salesforce validation rules if possible","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" before bringing PSL to bear on a thorny problem.","type":"text"}]},{"type":"paragraph","content":[{"text":"Admins can use Pulsar Settings to implement validation rules and triggers for the following execution points:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BeforeView (available in 14.0+)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BeforeEdit","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BeforeSave","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BeforeDelete","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OnCreate","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OnSave","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OnDelete","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"onBarcodeScan","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AfterSave (similar to OnSave, but is only run when the online save has been successfully pushed to Salesforce)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AfterLogin","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Validation Rules and Trigger execution points are composed of four \"post-action\" execution points, OnCreate, OnSave, AfterSave, and OnDelete, where the create, save, or delete action has occurred or is certain to occur, and four \"pre-action\" execution points, BeforeView, BeforeEdit, BeforeSave, and BeforeDelete, where conditions can be validated before the actions occur. The differences between Validation Rules and Triggers actually have to do with the actions taken within the setting. Validation Rules will contain Alert actions that inform the user of a failed condition. Triggers will often update the current record or other records with no user interaction. Validation Rules and Triggers can be combined in Pulsar, and all of the logic for a particular object type and execution point can be contained in a single setting. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"A Note about Save Triggers","type":"text"}]},{"type":"paragraph","content":[{"text":"To avoid issues with saving your data, we recommend using the SyncNow action only with the AfterSave trigger and not with the BeforeSave or OnSave triggers. In fact, the primary use case for the AfterSave trigger is to be able to run a SyncNow action.","type":"text"}]},{"type":"paragraph","content":[{"text":"The difference between OnSave and AfterSave is that OnSave executes after a successful local write and always executes. The AfterSave trigger only executes after Pulsar sends the record create/update via an online write and has received a success response from Salesforce. ","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Usage","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Pulsar Setting Format","type":"text"}]},{"type":"paragraph","content":[{"text":"The Validation Rules and Triggers are defined using ","type":"text"},{"text":"Pulsar Settings Language (PSL)","type":"text","marks":[{"type":"link","attrs":{"href":"https://luminix.atlassian.net/wiki/spaces/PD/pages/10158083"}}]},{"text":". The general format for such a setting is as follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"Name:","type":"text","marks":[{"type":"strong"}]},{"text":"