Skip to main content

Installing the Archive Package

Table of Contents​

  1. Prerequisites
  2. Install the package
  3. Create a new Named Credential
  4. Create and assign a new Permission Set
  5. Create a new Archive Object
  6. Sync Archive Objects
  7. Configure an Archive Object
  8. Widget Administration

Prerequisites​

Before you begin, make sure you have the following:

  • A link and a password to install the package: These will be provided by Bluefactory after you purchase the Archive Module.
  • A login and a password to access the external data source: These will also be provided by Bluefactory.

1. Install the package​

To install the package, follow these steps:

  1. Use the password provided by Bluefactory to install the package.
  2. Select an option for installation: Admins Only. This option allows only admins to install the package.
  3. Click on the "Install" button.

If you encounter any errors during installation, check the Troubleshooting section below.

2. Create a new Named Credential​

Named Credentials are a safe way to store authentication data for external services. In this step, you'll create a Named Credential for the Bluefactory Connector.

In the Salesforce Setup, search for "Named Credentials" and click on "New Named Credential":

Create a Legacy Named Credential, with the following parameters:

  • Label: Bluefactory Connector
  • Name: Bluefactory_Connector
  • URL: https://bluefactory-connector.herokuapp.com/
  • Identity Type: Named Principal
  • Authentication Protocol: Password Authentication
  • Username & Password: Provided by Bluefactory

3. Create and assign a new Permission Set​

Permission sets are used to grant specific access levels to different users. In this step, you'll create a permission set for the admins.

You need to create at least one permission set for the admins. The permission sets are used to show a list of specific list for the users who have the assigned permission.

  1. Create a new permission set (example: Bluefactory Archive Admin)
  2. Assign the permission set to your user

In the section Configure an Archive Object, you will see how to use the permission set to configure the access policy.

4. Create a new Archive Object​

An Archive Object is a specific set of data that you want to archive. Follow these steps to create a new Archive Object:

  1. Login to your bluefactory account
  2. On the header, click on the “Backups”
  3. Click on “New Archive”

Configure the data you want to archive:

  • Name: Archive Name
  • Data location: Where your data will be stored
  • Data retention (years): For how many years the data will be stored
  • Organization: Select your Salesforce organization
  • Select Object: Select the object you want to archive
  • SOQL Condition: Select the scope of the data you want to archive using an soql condition

5. Sync Archive Objects​

After creating an Archive Object, you need to synchronize it with the Bluefactory Archive Package. Follow these steps to do so:

  1. Select the “Bluefactory Archive” App
  2. Click on the Sync button
  3. Refresh the list.

You should see all your archived objects. If the list is empty, check if you have already created a archived object.

6. Configure an Archive Object​

Once your Archive Object is synced, you can configure it. Here's how:

  1. select an archive object, example “Account Demo”

  2. Enable the archive object

  3. Configure the access policy: The access policy lets you define which group of users can see which fields. Create a different permission set for each group of users, and select the fields that you want to show to each user within the permission.

    • Select a Permission set
    • Select the fields that will be displayed in the list mode
    • Select the fields that will be displayed in the detail mode
    • Save

7. Widget Administration​

Widgets are Lightning Web Components that help you interact with your archived data. This section explains how to use the Global Search Widget and the Global Query Widget.

Global Search Widget​

The Global Search Widget allows you to search through all indexed fields (id, string ,textarea, email ,combobox ,picklist ,multipicklist ,phone ,picklist ,reference ,url).

  1. Select Global Search
  2. Select the archive object and the search term
  3. See the search result
  4. Click on an archived record to see the detail

Global Query Widget​

The Global Query Widget allows you to use a sql query to find archived records.

  1. Select Global Query
  2. Select the archive object and the sql query
  3. See the query result
  4. Click on an archived record to see the detail

Adding the Widget to Lightning Page​

The Archive Table widget allows end users to display the archived records in their chosen view.

  1. From the left menu, select the Archive Table component
  2. Drag and drop the component to the desired location.
  3. On the Archive Table menu, Select the archive object Name (example Opportunity Demo) and use the Filter field as a sql query with the record data as variable inside double brackets. For example: "AccountId = {{Id}} order by amount desc" : This filter means that the component will search for all records that have AccountId equals to the Id of the current record and order the result by amount.

Troubleshooting​

If you encounter any issues during the installation process, check the following:

  • Make sure you have created a permission set and assign it to your user.
  • Check that you have entered the correct Named Credential information.
  • If you're having trouble syncing Archive Objects, make sure you have created an Archive Object first.

If you're still having trouble, contact Bluefactory support for assistance.