This topic is covers additional permissions and guidance for the Ironclad Workflow Launch. It is not required for basic integration use cases. However, it is highly recommended for users with more advanced integration needs.
If you want to learn about the basics of managing permissions, refer to Salesforce Integration - Getting Started and Salesforce Permissions.
In addition to the basic tools for managing workflow launch form access such as: Ironclad user and group permissions, Salesforce permission sets, Salesforce Component Visibility filters, and more, version 2.30 and above include the following options:
Review Managed Package Version
The Download AppExchange Package permission is needed in order to show the managed package version number in Ironclad. This is only needed for the service account. You can safely disable it, but if you do you will not be able to see in Ironclad what version of the managed package you are using (it is still possible to check the version within Salesforce).
Show a Subset of Workflows
In previous versions, the Ironclad Workflows Component would show all mapped workflows for each source object. Beginning with version 2.30+, you can now filter mapped workflows to only show a subset of workflows through the use of workflow launch groups.
Add Custom Help Text
Multiple Instances of an Ironclad Workflow Component
Configure Workflow Help Text
- Navigate to the Salesforce object you want to update. Click Setup indicated by a gear icon in the top right, and then click Edit Page.
- Select the Ironclad Workflows component to see the configuration options. You can configure a help message specific to when a certain number of workflows is available. This functionality is often used with workflow launch groups and component visibility filters.
- If you are using multiple Ironclad Workflow components on the same source object page, you must configure each component’s help text separately.
- Select Hide Card Body to hide the help text option altogether and only display the primary button.
- Click Save.
Workflow Launch Group Configurations
The term ‘Group’ here is distinct from Ironclad User Groups, Salesforce Groups, etc., and has no relation to these terms (or others). In this context, the term ‘Group’ refers to a grouping of workflow launch configurations. It is helpful to think of a workflow launch group as a cluster or a batch of workflows.
In earlier package versions, the Ironclad Workflows Component showed all mapped workflows for each source object. Beginning with version 2.30 and beyond, you can now configure the component to only show a subset of workflows at each time through the use of workflow launch groups.
A workflow launch group can contain as many, or as few, workflows as you want. This includes as few as zero or one workflow. This does NOT replace the Ironclad Workflow Configurations object. You must create an Ironclad Workflow Configuration (and corresponding Ironclad mapping) for every workflow before you can add it to the workflow launch group.
The default launch group for the Ironclad Workflows Component is ‘All Workflows’. No additional action is required if you do not need more granular filtering for your embedded workflow launch forms.
Create a Workflow Launch Group
- For each workflow you want to view or edit, map the fields in Ironclad settings and then add to Ironclad Workflow Configurations.
- In Salesforce, click on the App Launcher indicated by a grid of dots. Search for "Ironclad Workflow Launch Group Options", and then click on Ironclad Workflow Launch Group Options. Click on the Ironclad workflow configuration or custom button you want to edit.
- Click New. Enter a name for the new launch group. This name is not displayed on the source object page. It is only used when configuring the Ironclad Workflows component on the page layout menu.
- In the Source Object field, paste the API Name. To find this, go to Settings > Object Manager, and then select your source object and paste it in the Source Object field. Use the format of the name exactly as it appears. For example, if the Object Manager says Contact, make sure you don’t accidentally say Contacts instead.
- Click Save. On the new launch group’s page, you can now add individual workflows to your configuration.
- In the Ironclad Workflow Launch Group Options section, click New.
- If you want to create an empty launch group, skip this step. Select the workflow that you want to add to the launch group from the dropdown. The workflow launch configuration must have the same source object as the launch group.
- Click Save.
- Repeat this step for each workflow that you want to add to the launch group.
View and Edit a Workflow Launch Group
- For each workflow you want to view or edit, map the fields in Ironclad settings and then add them to Ironclad Workflow Configurations.
- In Salesforce, click on the App Launcher indicated by a grid of dots. Search for "Ironclad Workflow Launch Group Options", and then click on Ironclad Workflow Launch Group Options. Click on the Ironclad workflow configuration or custom button you want to edit.
- A list of all of your launch groups and their workflows is displayed. From here, you can edit or delete each assignment using the standard Salesforce options
Update Source Object Page
After you create your Salesforce launch groups, you must configure the Ironclad Workflows Component to use them.
- Navigate to the Salesforce object you want to update. Click Setup indicated by a gear icon in the top right, and then click Edit Page.
- If you have not yet done so, add the Ironclad Workflows component to your page layout.
- Select a launch group from the Ironclad Workflow Launch Group dropdown.
- If you have multiple launch groups for the same source object, add multiple instances of the Ironclad Workflows component to your page layout. Set each instance to use a different launch group, and edit the help text options accordingly.
- Use Salesforce’s component visibility filters, page layout options, and permissions to set the conditions that ensure that only the correct instances of the Ironclad Workflows component are displayed. Refer to Salesforce support for additional guidance on how to use component visibility filters.