Event Registration Submission Process
  • 25 Jun 2024
  • 4 Minutes to read
  • Dark
    Light

Event Registration Submission Process

  • Dark
    Light

Article summary

ERS Job Update

The Event Registration Submission job will not be scheduled automatically in a sandbox after production is refreshed. Event Registration Submission (ERS) records will not process until this is resolved. To solve this, click the Schedule Batch Event Registration Submission Job button. Click here to learn more about the Blackthorn | Batch Event Registration Submission scheduled job.

The Event Registration Submission (ERS) object is a container that holds a large amount of Attendee registration information until the system is ready to process everything in the object.

This object is important because if an ERS fails, you will be able to figure out why and be able to fix the problem, so your Attendee(s) receives their confirmation email.

There are multiple benefits for using the ERS object.
• Provides a better user experience for your Attendees.
• Prevents the loss of registration data or payments.
• Helps troubleshoot issues.

  1. Click on the App Launcher icon.
  2. Type "Events (Admin)" and select the Events (Admin) app.
  3. Click the Event Registration Submission (ERS) tab.

The registration records from every Event are located here. If you haven’t run any Events yet, you won’t see a record yet. To see an example, register for one of the sample Events and then come back.

Here is an example of an Event Registration Submission (ERS) record. All Attendee data will be saved here including names, emails, tickets selected, etc.

ers process 1

Fix a Failed ERS Record

Here is an example of a failed Event Registration Submission (ERS) record.

ers process 2


To fix the problem, complete the steps below.

  1. Identify and fix the issue defined in the Error Message field.
  2. Update the Status field from “Failed” to “To Process”.
  3. Empty the Error Message and Attendee JSON fields.
  4. Set the Process field to "True" (checked).
  5. Click Save.

This will reprocess the Event Registration Submission (ERS) record and create the Attendee record.

ers process 4

Limitation

You may run into a Salesforce limit for the ERS Payload when registering more than 20 Attendees simultaneously for an Event with more than 10 Form Elements/Questions. (String maximum length exceeded) This is likely to happen for Form Elements Type = “Text (30,000),”  but having 20 Form Elements with Type = "Text" and 20 Attendees in one registration will also cause it. 

To prevent this error, reduce the number of Attendees added in one registration or avoid using Form Elements with Type = “Text (30,000).”

Batch Processing

Since we fire several batch/queue jobs simultaneously, we can’t guarantee which one will be the last to finish. The following list includes jobs as they are added to the queue.

  • Populate some Attendee fields based on Account/Contact.
  • Event Item quantities rollup to Events.
  • Add Attendees to the webinar, when needed.
  • Create a Campaign Member, when needed.
  • Send registration emails.
  • Recalculate Session capacities.
  • Session Attendee rollup to Session/Event.
  • Blackthorn Events Form Submission processing.
  • Capture and update Transactions, if already authorized.

To prevent issues with Event Registration Submission (ERS) processing during times of high concurrent registrations, automatically scheduled ERS batch processing from the Blackthorn | Events Admin page will occur.

The Blackthorn | Batch Event Registration Submission job will run every one minute. Since the ERS records are processed in batches, there may be a delay of up to one minute before a record is processed.

A protected custom setting with a default value at "Off" was added and can only be changed from the Blackthorn | Events Admin page. (The public custom setting has been deprecated.)

Turn Custom Setting On

  1. Return to Blackthorn | Events Admin page.
  2. Click Scheduled Jobs and view the available jobs, including "Process Event Registration in Batches".

EventAdminTabScheduledJob_ERSBatchProcessing

Email Alert for Failed Registrations

By default, we have enabled this workflow to send the user who authorized the Events app an email when an ERS record fails.

If you want to change who receives the notification, complete the steps below.

  1. Navigate to Setup.
  2. In the Quick Find, search for and select "Workflow Rules."
  3. Select the "Blackthorn | Events ERS Failed" workflow.
  4. Click Email Alert.
  5. Click the Edit button.
  6. Update the recipients or enter an additional email.

Order of Execution

When an Attendee checks out for an Event, many records are created and updated automatically. The flow below provides insight into the execution order, so you know when to interact with the Attendee object for your custom processes and flows.

Attendee Data

  1. An Attendee record is created.
    • The Attendee record relates to the Contact, Lead, or Person Account and the Event.
    • Registration Status is set to "Registered".
  2. Answers to custom questions are processed through the Blackthorn Events Form Submission object and related to the Attendee.
  3. Invoice & Line Item are created.
  4. The Contact, Lead, Person Account, Status field, Subject Line field, and additional fields are set on the Invoice.

Paid Events

  1. The card information is sent immediately to the Payment Gateway. A token is received (PCI compliant).
  2. The completed Transaction and Payment Method are saved in Salesforce. Initially, they are orphan records because the Event Registration Submission (ERS) hasn't processed to connect the payment with the registration Invoice.
  3. Once the ERS is processed, the Transaction is updated with the related Invoice.

ERS Record Statuses

  • "Draft" = This is used when the Attendee has not completed checkout.
    Draft records are created in two scenarios: running a validation and entering a discount code. The draft can then be updated for submission if the user completes the checkout process.
  • "To Process" = This is used when checkout is complete and the record is submitted for processing.
  • "Failed" = This is used when there is an issue submitting the ERS record.
  • "Completed" = This is used when the ERS record is processed successfully.