Overview #
This article guides you through the steps required to configure and use the Flosum Integration package with Quality Clouds. This integration enables feature branch scan execution and issue visualization from within the Flosum environment in Salesforce.
Prerequisites #
Before proceeding with the configuration setup, ensure the following prerequisites are met:
-
The Flosum package must be installed in your Salesforce Org.
Install from AppExchange - Quality Clouds for Flosum Package must be installed in your Salesforce Org. Install from AppExchange
- Flosum Org must be connected to QC Admin Portal, following this steps. Flosum Integration
Before You Start #
1. Assign the Quality Clouds Permission Set #
To allow users to interact with the Quality Clouds App:
-
Go to Setup > Permission Sets
-
Assign the Quality Clouds permission set to all users who will use the integration.
Step 1: Create a New Public Site #
We’ll configure a Salesforce Site to enable the OAuth flow between Salesforce and Quality Clouds.
🔧 Instructions:
-
Go to Setup and search for Sites.
-
If not already enabled, click Register My Salesforce Site Domain.
Choose a simple domain name (e.g.,mycompany).🔗 Example result:
https://mycompany.force.com -
In the Sites section, click New:
-
Site Label:
QCLogin -
Site Name:
QCLogin -
Default Web Address:
qccallback -
Active: ✅ Checked
-
Active Site Home Page:
InMaintenance -
Clickjack Protection Level: Allow framing by the same origin only (Recommended)
-
-
Click Save.
✅ Your final site URL will look like:https://mycompany.force.com/qccallback
Step 2: Secure Guest User Profile Access #
The integration relies on exposing specific REST resources. You must enable access for the guest profile of your Site.
🔧 Instructions:
-
Go to Setup > Sites and locate your newly created site.
-
Click the Site Label (QCLogin).
-
Click Public Access Settings.
-
You are now editing the Guest User Profile.
🔸 Grant Access to Apex Classes:
-
Scroll to Apex Class Access > click Edit
-
Add the following classes:
-
QClouds4Flosum.ExternalOAuthCallback -
QClouds4Flosum.VFOAuthRedirectController
-
Click Save to apply changes.
🔸 Allow Read access to the Object and its fields
- Navigate to the Public Access Settings
- Click on Object Settings and search for QCStates
- Access the QCStates > Edit and enable Read permissions at the Object and Field level
- Then Save
Customizations #
You can enhance your Flosum experience by embedding Quality Clouds functionality directly into the Branch Lightning page.
🔧 Lightning Page Enhancements:
-
Open the Lightning page editor for the Flosum Branch object.
-
In the Highlight Panel, add a custom button to launch branch scans.
-
Create a new tab labeled
Quality Clouds. -
Add the following custom components:
-
scansRelatedList -
issuesRelatedList
-
These components display scan and issue data related to the Flosum branch.
🧩 Global Apex Class for Automation
We provide a global Apex class that you can use in automations or custom logic to launch scans.
Usage:
-
Input:
Flosum__Branch__crecordId -
Output: A wrapper object:
-
isSuccess(Boolean) -
message(String) – Includes error messages if applicable
-
Using the Integration #
🔑 Authentication
On first use, each user must authenticate with their Quality Clouds credentials.
-
You will be redirected to log in with Quality Clouds.
-
Upon authentication, your connected instances will appear.
#
🚀 Launching Feature Branch Scans
You can now:
-
Launch scans directly from the Instance View Details screen.
-
Review results via the Scan Details page.
-
Or run scans from the Branch Lightning Page for quick access to scan status and related issues.
Summary #
Once fully set up, this integration allows Quality Clouds to analyze Flosum branches and provide scan feedback seamlessly within your Salesforce environment.
Need help? Contact your Quality Clouds Customer Success representative for additional guidance.
