Install and Provision Licenses
  • 27 Jul 2022
  • 6 Minutes to read
  • Dark
    Light

Install and Provision Licenses

  • Dark
    Light

Are you having trouble installing or upgrading Events from the Candy Shop?

If you are having trouble installing Events from the Candy Shop, please click here for additional information.

Welcome to Blackthorn! To simplify the installation process, Blackthorn has adopted the Candy Shop. If you are installing Events for the first time, the installer will automatically install the Base Package first, then Payments, and lastly Events.

If either Base Package or Payments are already installed, the installer will make sure the correct versions are either installed or upgraded before installing Events.

Start Here

1. Go to the Blackthorn Candy Shop.

2. Click Blackthorn Events.

Events Install new icons

3. Click Install Blackthorn Events - Click Here for Details.

Events Click here for Details New image

4. If you are not logged into Salesforce, you will be prompted to do so now. 

5. Click Allow to allow Blackthorn to access the following information.

Allow Access

6. Click Install.

As each step is completed, a green checkmark will appear in the Install column.

During Events Install new image

7. For new installs, the Candy Shop will take care of the following configuration steps for Events.

     * Install BasePackage

     * Install Blackthorn Payments

     * Install Blackthorn Events

     * Assign Blackthorn | Events (Admin) and Blackthorn | Payments (Admin) permission sets to the installing user

     * Automatically schedule Events Scheduled jobs

     * Authorize the Event App as the installing user

8. The installing user will receive the following email alerts.

     * BasePackage install successful

     * Payments Package install successful

     * Events Package install successful

     * Payment Gateway Customer Matching Rule activated

     * Attendee Matching Rule activated

Successful Install new image


  1. Click View Org to go to your Salesforce Org.

Configure Events for Use

Before Events can be used, a multi-step configuration process must be completed. In addition to authorizing the Events app, the Configuration tab on the Blackthorn | Events Admin page allows users to set up Events for first time users. The additional tabs on the Blackthorn | Events Admin page give users an easy way to deploy and make automatic updates.

Recommendation

Before configuring the Events app or activating Scheduled Jobs, we recommend logging as an integration user. This can help reduce issues related to configuration and authorization and individual employee user access.

Provision Licenses

After you have purchased Blackthorn licenses, perform the following steps to assign them to the designated users. To transfer licenses between users, repeat the process.

This step does not apply if you are using the free trial. However, you will need to complete this step after purchasing Blackthorn licenses in order to give designated users access to the app.

Assign Users to the Payments Application

Requirement for Events Customers

An Events authorization user must be assigned a Payments license. This prerequisite applies even if you are only offering Free Events.

  1. From Setup, navigate to: 
    • Lightning: Apps > Packaging > Installed Packages
    • Classic: Build > Installed Packages
  2. Click Manage Licenses next to Blackthorn | Payments.
  3. Click Add Users.
  4. Select the users you want to add.
  5. Click Add.

Assign Users to the Events Application

  1. From Setup, navigate to:
    • Lightning: Apps > Packaging > Installed Packages
    • Classic: Build > Installed Packages
  2. Click Manage Licenses next to Blackthorn | Events.
  3. Click Add Users.
  4. Select the users you want to add.
  5. Click Add.

Events Permission Sets

When a user installs Blackthorn Events via Candy Shop, we automatically assign the Blackthorn Events Admin and Blackthorn Payments Admin Permission Sets to the installing user.

Access to Events is managed by permission sets. After installation, it is necessary to assign permission sets to designated users to ensure that they have the necessary level of access.

  • To automatically assign all non-system admin users the Blackthorn | Events (Admin) Permission Set, click the Assign Events Permission Sets to All Users button.
  • To assign/remove multiple Blackthorn permission sets at once, click the Advanced Permissions Assignments button.

Event Admin Configuration Tab_Assign ET Permission Set to All Users Button

Pre-configured Permission Sets

Out of the box, Blackthorn provides a set of pre-configured permission sets that can be assigned to users.

If you create a custom permission set, you will need to modify it after each new Events’ release to ensure that users with that custom permission set continue to have the appropriate access.

Blackthorn | Events (Admin)

The Events (Admin) permission set gives users full access to the Blackthorn | Events Admin tab and all objects, including custom objects. The user also has Read permission for Payment Gateways and Create/Read/Update permissions for several Payments features including Relationship Settings, the Data Dictionary, Codes, and Codes Eligibility.

Blackthorn | Events (Limited Access)

The Events (Limited Access) permission set provides users with Create/Read/Update permissions for the Event and Attendee objects. Users do not have access to the Event Settings object nor Delete access to any custom objects.

Blackthorn | Events (Read Only)

The Events (Read Only) permission set is for users who have a Read-Only license and provides Read-Only permission to the Events objects. This permission set is commonly given to users who need to review reports.

Blackthorn | Events (Community/Platform User)

The Events (Community/Platform User) permission set provides Create/Read/Update permissions for all Event objects. However, there is no access to Assigned Apps, Leads, and Opportunity fields so the permission set can be assigned to Community and Platform license users.

How to Assign a Permission Set

  1. From Setup, navigate to:
    • Lightning: Users > Permission Sets.
    • Classic: Administer > Manage Users > Permission Sets.
  2. Click on a permission set name (e.g. Blackthorn | Events (Admin)).
  3. Click Manage Assignments.
  4. Click Add Assignments.
  5. Select the users.
  6. Click Assign.
  7. Click Done.

If any of your users need access to financial data related to paid registrations or Discount Codes, they will need a Payments license and to be related to one of the packaged Payments permission sets or a custom permission set. Financial data includes data from Invoices, Discount Codes, Transactions, Payments Methods, and the Payment Gateway objects.

Payments Permission Sets

Payments access is managed by permission sets. After installation, it is necessary to assign permission sets to designated users to ensure they have the correct type of access.

Pre-configured Permission Sets

Out of the box, Blackthorn provides a set of pre-configured permission sets that can be assigned to users.

If you create a custom permission set, you will need to modify it after each new Payments’ release to ensure that users with that custom permission set continue to have the appropriate access.

Blackthorn | Payments (Admin)

The Payments Admin permission set is automatically given to Salesforce users with the System Administrator Profile. Users with Payments Admin permissions are able to access the Payments (Admin) app, Setup Wizard, and Payment Settings tabs and perform view all, modify all, and delete records tasks for custom objects.

Blackthorn | Payments (Manager)

The Payments Manager permission set is given to Salesforce users without a System Administrator profile. Users with this permission set only have Read permissions for the Payment Gateway and Webhook Event objects. All other custom objects have Delete permissions.

Blackthorn | Payments (User)

The Payments User permission set has Read permissions for Payment Gateway and Webhook Event objects and Read/Create permissions for the Blackthorn Log object. Users do not have Delete permissions on any custom objects.

Blackthorn | Payments (Community/Platform User)

The Payments Community/Platform User permission set is identical to the Blackthorn | Payments (User) permission set except that it does not have any of our Assigned Apps (a collection of tabs). This is because a permission set assigned to a Community user cannot have any Assigned Apps. Customers who want to give Community users access to Payments should use this permission set.

Blackthorn | Payments (Stripe Billing)

The Payments Stripe Billing permission set provides Admin permissions to all Stripe Billing objects and fields. This should be used by customers who want to give access to users who use the Stripe Billing feature.

How to Assign a Permission Set

  1. From Setup, navigate to:
    • Lightning: Users > Permission Sets.
    • Classic: Administer > Manage Users > Permission Sets.
  2. Click on a permission set name (e.g. Blackthorn | Payments (Admin)).
  3. Click Manage Assignments.
  4. Click Add Assignments.
  5. Select the users.
  6. Click Assign.
  7. Click Done.


What's Next