Please note: This content is intended for Practifi System Administrators and is technical in nature. The steps described in this article may not be able to be completed without System Administrator permissions. |
Overview
The flow outlined in this article will allow a Practifi System Administrator to click a New User button and generate a Standard user by entering information about the new user in your Practifi organization. This article outlines the steps to create this flow and the New User button within your organization. These steps are highly technical in nature. If you have any questions or concerns about implementing this flow in your organization, please contact Practifi Support or your firm's CSM for assistance.
- Create the New User Button
Create the New User Creation Flow
Access Flow Builder
To create the New User Creation flow, you will be working in Flow Builder. To access Flow Builder:
- Navigate to Salesforce Setup by selecting the cog icon in the upper right-hand corner and then selecting Setup from the drop-down menu.
- Use the Quick Find search bar on the left-hand side to search for Flows and select the Flows option under the Process Automation header.
- Select the New Flow button in the upper right-hand corner. A new window will open in your browser.
Select Flow Type
- In the new Flow Builder window in your browser, you will be asked how you would like to start building your flow. The Start From Scratch option is highlighted by default. Leave this option selected and click Next to proceed.
- Select the Screen Flow option, if not already selected by default, and then click Create to proceed with the flow creation process.
Add Get Records Elements
In the New User Creation flow, you will need to add multiple Get Records elements. These elements get information from within your organization to create the user and provide them with the permission sets and packages needed to access your Practifi instance successfully.
Steps for each Get Records element are provided in individual sections below, which are collapsible for ease of viewing. Select each collapsed section to expand it and display the steps.
Get Division Data
Get Division Data Get Records Element
This Get Records element looks for the Division data within your firm so that it can be assigned to the user later in the flow.
- To add an element to your flow, select the + icon below the Start icon.
- In the drop-down menu that opens, scroll down to locate the Data header and select the Get Records option.
- Type Get Division Data into the Label field. Then click into the API Name field to have the system auto-generate this information.
- In the Object field, begin typing Division. Locate and select the Division (practifi__Division__c) object from the drop-down menu.
- In the Filter Division Records section, click on Search fields... and type Id and select the Id (Record ID) field from the drop-down menu.
- Leave the Operator set to Equals.
- Click into the Value field and select New Resource.
- Select Variable as the Resource Type.
- Enter recordId in the API Name field.
-
Please note: For this resource to function properly, the API Name must be entered exactly as recordId. This field is case-sensitive.
-
Please note: For this resource to function properly, the API Name must be entered exactly as recordId. This field is case-sensitive.
- Select Text from the drop-down menu for the Data Type field.
- Under Availability Outside the Flow, check the Available for input box.
- Select the Done button to finalize the creation of the new resource. Your condition requirements should look like the screenshot below.
Get Practifi Profiles
Get Practifi Profiles Get Records Element
This Get Records element looks for the Standard User Practifi Profile data so that it can be assigned to the user later in the flow.
- Select the + icon below the Get Division Data Get Records element.
- In the drop-down menu that opens, scroll down to locate the Data header and select the Get Records option.
- Type Get Practifi Profiles into the Label field. Then click into the API Name field to have the system auto-generate this information.
- In the Object field, search for and select the Profile object from the drop-down menu.
- In the Filter Profile Records section, click on Search fields... and type Name and select the Id (Name) field.
- Leave the Operator set to Equals.
- Type Practifi User - Salesforce Platform in the Value field. Your condition requirements should look like the screenshot below.
Get Practifi Package
Get Practifi Package Get Records Element
This Get Records element will get information about the Practifi Package so that it can be assigned to the user later in the flow. This is essential for them to access your Practifi instance successfully.
- Select the + icon below the Get Practifi Profiles Get Records element.
- In the drop-down menu that opens, scroll down to locate the Data header and select the Get Records option.
- Type Get Practifi Package into the Label field. Then click into the API Name field to have the system auto-generate this information.
- In the Object field, search for and select the Package License object from the drop-down menu.
- In the Filter Profile Records section, click on Search fields... and type NamespacePrefix and select the NamespacePrefix (NamespacePrefix) field.
- Leave the Operator set to Equals.
- Type practifi in the Value field. This value is case-sensitive. Your condition requirements should look like the screenshot below.
Get Permission Set Groups
Get Permission Set Groups Get Records Element
This Get Records element will get information for the Standard User permission set group in your Practifi organization so that it can be assigned later in the flow.
- Select the + icon below the Get Practifi Package Get Records element.
- In the drop-down menu that opens, scroll down to locate the Data header and select the Get Records option.
- Type Get Permission Set Groups into the Label field. Then click into the API Name field to have the system auto-generate this information.
- In the Object field, search for and select the Permission Set Group object from the drop-down menu.
- In the Filter Profile Records section, click on Search fields... and type DeveloperName and select the DeveloperName (API Name) field.
- Leave the Operator set to Equals.
- Type Standard_User in the Value field. Your condition requirements should look like the screenshot below.
Add Screen Elements
In the New User Creation flow, you will need to create two Screen elements. These elements display when the new user is being created. First, you will create a User Creation Wizard screen, which will display for your firm's users before they enter information for the new user's profile. Then you will create a User Details screen where the information about the user will be entered to create their profile.
Steps for each Screen element are provided in individual collapsible sections below for ease of viewing. Select each collapsed section to expand it and display the steps.
User Creation Wizard Screen
User Creation Wizard Screen Element
The next step in the flow is to create a screen for users to see before they enter information for the new user. In the following steps, you'll create a screen that gives users information about what they need to fill in to ensure that the user is created successfully. To create this screen:
- Select the + icon below the Get Permission Set Groups Get Records element.
- In the drop-down menu that opens, locate the Interaction header and select the Screen option.
- Use the Search components... search bar on the left-hand side to search for Display Text.
- Drag and drop the Display Text component from that menu onto the screen in the center.
- Enter an API Name for this Display Text component on the right-hand side. We recommend screenUserWizardIntro as an API name.
-
Please note: API names must be one word with no spaces. A best practice when creating API names is to capitalize the first letter of each word, except for the first word in the API name.
-
Please note: API names must be one word with no spaces. A best practice when creating API names is to capitalize the first letter of each word, except for the first word in the API name.
- Enter any information that you would like to use to guide the user about the user creation process in the rich text box below the API Name. For example:
Create a New User
This wizard will guide you through the creation of a new user under the {!Get_Division_Data.Name} division. If this is not their primary division, please exit out and launch the action from the correct division record page. Before proceeding, you should confirm:
- The new user's full name
- The new user's email address (we will use this for their login credentials)
- Their email matches their login credentials for 3rd Party Integration Platforms
- The permissions/record access they will need
Note: If you exit the flow before the final success screen, there may be steps you need to complete in Setup to finalize permission allocation and licensing.
- Click into the gray space of the screen to return to the Screen Properties menu. To remove the Header for this screen, select the Configure Header option on the right-hand side and then uncheck the Show Header box.
- Type User Creation Wizard into the Label field. Then click into the API Name field to have the system auto-generate this information.
- Select Done to finalize the creation of this screen. Your flow should look like the screenshot below.
User Details Screen
Get User Details Screen Element
The next screen in this flow is where users will fill in the information for the new user. To create this screen:
- Select the + icon below the User Creation Wizard Screen element.
- In the drop-down menu that opens, locate the Interaction header and select the Screen option.
- Use the Search components... search bar on the left-hand side to search for Section. Sections allow you to add additional columns to a screen, so this component is helpful for the organization of data.
- Drag and drop the Section component from that menu onto the screen in the center.
- Select the + Add Column button under the Configure Columns section on the right-hand side.
- Use the Search components... search bar on the left-hand side to search for Text, and drag and drop this component into both columns.
- Click on the Text component in the left column. Enter First Name in the Label field. Then click into the API Name field so that the system can auto-generate this value.
- Check the Require box.
- Click on the Text component in the right column. Enter Last Name in the Label field. Then click into the API Name field so that the system can auto-generate this value.
- Check the Require box.
- Use the Search components... search bar on the left-hand side to search for Email, and drag and drop this component below the name columns so that it is in its own section.
- In the Email component settings, enter newUserEmail in the API Name field.
- Edit the Required field from {!$GlobalConstant.False} to {!$GlobalConstant.True}. This will set this field to be required.
- Use the Search components... search bar on the left-hand side to search for Checkbox, and drag and drop this component below the Email field.
- Enter Alternate Username Required in the Label field for the Checkbox component. Then click into the API Name field so that the system can auto-generate this value.
-
Please note: Salesforce will automatically use the user's email address as their username. In Salesforce, you must have a unique username across all organizations. This means that if the email being entered for the new user as part of this flow has already been used in a Salesforce organization elsewhere, the flow and creation of the user will fail. This checkbox and the subsequent text field you will build allow for a user to enter an alternative username to be entered as needed for the new user as a way to prevent this failure.
-
Please note: Salesforce will automatically use the user's email address as their username. In Salesforce, you must have a unique username across all organizations. This means that if the email being entered for the new user as part of this flow has already been used in a Salesforce organization elsewhere, the flow and creation of the user will fail. This checkbox and the subsequent text field you will build allow for a user to enter an alternative username to be entered as needed for the new user as a way to prevent this failure.
- Use the Search components... search bar on the left-hand side to search for Text, and drag and drop this component below the Alternate Username Required checkbox.
- Enter Alternate Username in the Label field for the Text component. Then click into the API Name field so that the system can auto-generate this value.
- Check the Require box.
- Select the Set Component Visibility menu to expand the available options. Here, you can set this field to only display when the Alternative Username Required checkbox is checked.
- Change the When to Display Component drop-down to All Conditions Are Met (AND).
- In the Resource field, begin typing Alternate and select the Alternate_Username_Required (Checkbox) option from the results.
- Leave the operator set to Equals.
- In the Value field, type True and select the $GlobalConstant.True option from the results.
- Select Done to add this condition.
- Use the Search components... search bar on the left-hand side to search for Picklist, and drag and drop this component below the Alternate Username field.
-
Please note: Two picklist options will display in the component menu. Select the option under the Input header and not the Custom header.
-
Please note: Two picklist options will display in the component menu. Select the option under the Input header and not the Custom header.
- Enter Time Zone in the Label field for the Picklist component. Then click into the API Name field so that the system can auto-generate this value.
- Check the Require box.
- In the Configure Choices section, click on the Choice field and then select New Choice Resource.
- Select Picklist Choice Set from the Resource Type drop-down menu.
- Type pcsTimeZone in the API Name field.
- In the Object field, type User and locate and select the User (User) object from the results.
- Select Picklist from the Data Type drop-down menu.
- In the Field field, type Time and select the TimeZoneSidKey (Time Zone) option from the results.
- Select Done to finalize the creation of this Choice resource. This Choice resource will now populate this picklist with all available time zones when creating the new user.
- Click in the gray space on the screen to bring back the Screen Properties menu. In the Label field, enter User Details Screen. Then click into the API Name field to allow the system to auto-generate this value.
- Select Done to finalize the creation of this Screen element.
Assign Values to User Record
Now that you've created two Screen elements for this flow, the next step is to create an Assignment element that takes the information entered into the screen and then adds this information to a container variable that will then create the user. To create this Assignment element:
- Select the + icon below the User Details Screen element.
- In the drop-down menu that opens, locate the Logic header and select the Assignment option.
- Enter Assign Values to User Record in the Label field for the Assignment element. Then click into the API Name field so that the system can auto-generate this value.
- Click into the Search variables... search bar for the Variable field and select New Resource.
- Select Variable from the Resource Type picklist.
- Enter vUserToCreate in the API Name field.
- Select Record from the Data Type picklist field.
- In the Object field, type User and locate and select the User (User) object from the results.
- Select Done to finalize the creation of this resource.
You must now set variables and value information within this Assignment element. For ease of viewing, steps for setting each field's variable and value information are provided in individual collapsible sections below. Select each collapsed section to expand it and display the steps.
First Name Variable Value
First Name Variable Value Steps
- Click on vUserToCreate in the Variable field.
- Under the Record Variables header, select vUserToCreate.
- Begin typing First and select First Name from the drop-down menu.
- Leave the Operator set to Equals.
- Click into the Value field and then select the User Details Screen.
- Select First Name from the Screen Components list.
Last Name Variable Value
Last Name Variable Value Steps
- Select the Add Assignment button.
- Click in the Variable field, select vUserToCreate from the drop-down menu, begin typing Last and select Last Name.
- Leave the Operator set to Equals.
- In the Value field, select the User Details Screen option and then select Last Name.
Email Variable Value
Email Variable Value Steps
- Select the Add Assignment button.
- Click in the Variable field, select vUserToCreate from the drop-down. Begin typing Email and select Email.
- Leave the Operator set to Equals.
- In the Value field, select the User Details Screen option and then select newUserEmail. Then select Value.
Username Variable Value
Username Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Username and select Username.
- Leave the Operator set to Equals.
- Click on the Value field and then select New Resource.
- Select Formula as the Resource Type.
- Enter vfUserName in the API Name field.
- Select Text as the Data Type.
- In the Formula box, click on the Insert a function... search bar.
- Type IF into this search bar and select the IF option from the results.
- Highlight logical_test and then click the Insert a resource... search bar.
- Select User Details Screen and then click Alternate User Name Checkbox.
- Type = true to the left of the comma beside {!Alternate_User_Name_Required}.
- Highlight value_if_true and then click the Insert a resource... search bar.
- Select User Details Screen and then click Alternate User Name.
- Highlight value_if_false and then click the Insert a resource... search bar.
- Select User Details Screen. Click newUserEmail and select Value.
- Click Check Syntax to verify your formula is written correctly, and then select Done. Your formula should look like the screenshot below.
Time Zone Variable Value
Time Zone Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Time Zone and select Time Zone.
- Leave the Operator set to Equals.
- Click on the Values field. Type User Details Screen and select User Details Screen from the results.
- Select Time Zone from the picklist.
Active Checkbox Variable Value
Active Checkbox Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Active and select Active.
- Leave the Operator set to Equals.
- Click on the Value field, begin typing True and select True.
Locale Variable Value
Locale Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Locale and select Locale.
- Leave the Operator set to Equals.
- Click on the Value field, type en_US and select English (United States).
-
Please note: If the user is not located in the United States, another option may be selected from this drop-down. For example, you can type en_AU to select English (Australia) from the picklist.
-
Please note: If the user is not located in the United States, another option may be selected from this drop-down. For example, you can type en_AU to select English (Australia) from the picklist.
Alias Variable Value
Alias Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Alias and select Alias.
- Leave the Operator set to Equals.
- Click on the Values field and then select New Resource.
- Select Formula as the Resource Type.
- Enter vfAlias in the API Name field.
- Select Text as the Data Type.
- In the Formula box, copy and paste LEFT({!First_Name},1) + LEFT({!Last_Name},4) into the box. Ensure no extra spaces have been pasted when copying this formula.
- Click Check Syntax to verify your formula is pasted correctly, then select Done. Your formula should look like the screenshot below.
Profile ID Variable Value
Profile ID Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down menu. Begin typing Profile and select Profile ID.
- Leave the Operator set to Equals.
- Click into the Value field and type Get and select Profile from Get Practifi Profiles.
- Type Profile and select Profile ID from the results.
Email Encoding Variable Value
Email Encoding Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down menu. Begin typing Email and select Email Encoding.
- Click into the Value field and select General US & Western Europe.
Language Variable Value
Language Variable Value Steps
- Select the Add Assignment button.
- Click into the Variable field and select vUserToCreate from the drop-down. Begin typing Language and select Language.
- Click into the Value field and select English.
Once completed, the list of variable values should look like the screenshot below.
Create Records Elements
Now you'll need to create two Create Records elements to create the actual user from all the information entered and mapped to fields.
Steps for each Create Records element are provided in individual sections below, which are collapsible for ease of viewing. Select each collapsed section to expand it and display the steps.
Create New User
Create New User Create Records Element
- Select the + icon below the Assign Values to User Record Assignment element.
- In the drop-down menu that opens, search for and select the Create Records element.
- Enter Create New User in the Label field for the Create Records element. Then click into the API Name field so that the system can auto-generate this value.
- Select vUserToCreate in the Record field.
Create Division Member Record
Create Division Member Create Records Element
- Select the + icon below the Create New User Create Records element.
- In the drop-down menu that opens, search for and select the Create Records element.
- Enter Create Division Member Record in the Label field for the Create Records element. Then click into the API Name field so that the system can auto-generate this value.
- Select Manually from the How to set record field values picklist.
- Search for and select Division Member (practifi__Division_Member__c) in the Object field.
- Click the Add Field button in the Set Field Values for the Division Member section.
- Select Team Member in the Field drop-down menu.
- In the Value field, select vUserToCreate under the Record Variables header.
- Then type ID and locate and select User ID.
-
Please note: You will need to scroll to locate this option; it will likely be the last option displayed.
-
Please note: You will need to scroll to locate this option; it will likely be the last option displayed.
- Click the Add Field button.
- Select Division in the Field drop-down menu.
- In the Value field, type Get and select Division from Get Division Data.
- Type Id and then click away from this field. The system will then locate the Record ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the Record ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the Record ID field.
- Click the Add Field button.
- Select Primary in the Field drop-down menu.
- In the Value field, type True and select True.
- Click the Add Field button.
- Select Owner ID in the Field drop-down menu.
- In the Value field, begin typing Running User and select Running User from the results.
- Type Id and then click away from this field. The system will then locate the Id field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the field.
Add a Success Screen
The next step in this flow is to create a Screen element to notify System Administrators that they have successfully created the user and added them to your Practifi instance. This element also serves a dual purpose, as there is a limitation that some records related to the new user cannot be created at the same time as other objects. This screen allows the separation between these records and allows the system to create the user successfully.
To create the success Screen element:
- Select the + icon below the Create Division Member Record Create Records element.
- In the drop-down menu that opens, locate the Interaction header and select the Screen option.
- Use the Search components... search bar on the left-hand side to search for Display Text.
- Drag and drop the Display Text component from the menu onto the screen in the center.
- Click on the Insert a resource... search bar and search for and select First Name.
- Search for and select Last Name from the same search bar.
- Complete your success message with additional text to suit your firm's needs. For example, {!First_Name}{!Last_Name} has been successfully created as a user.
- Enter successMessage in the API Name field.
- Click into the gray space on the screen to bring back the Screen Properties menu. In the Label field, enter Success Screen. Then click into the API Name field to allow the system to auto-generate this value.
- Select Done to finalize the creation of this Screen element.
Create Records Elements
Next, you'll need to create two more Create Records elements to complete the information assignment for the new user.
The steps for each Create Records element are provided in individual sections below, which are collapsible for ease of viewing. Select each collapsed section to expand it and display the steps.
Create Package
Create Package Create Records Element
- Select the + icon below the Success Screen element.
- In the drop-down menu that opens, search for and select the Create Records element.
- Enter Create Package in the Label field for the Create Records element. Then click into the API Name field so that the system can auto-generate this value.
- Select Manually from the How to set record field values picklist.
- Search for and select User Package License (UserPackageLicense) in the Object field.
- Click the Add Field button in the Set Field Values for the User Package License section.
- Select Assigned User ID in the Field drop-down menu.
- In the Value field, select vUserToCreate under the Record Variables header.
- Type Id and then click away from this field. The system will then locate the User ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the User ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the User ID field.
- Click the Add Field button.
- Select Package License ID in the Field drop-down menu.
- In the Value field, type Get and select Package License from Get Practifi Package.
- Type Id and then click away from this field. The system will then locate the Package License ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the Package License ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the Package License ID field.
Create Permission Set
Create Permission Set Create Records Element
- Select the + icon below the Create Package Create Records element.
- In the drop-down menu that opens, search for and select the Create Records element.
- Enter Create Permission Set in the Label field for the Create Records element. Then click into the API Name field so that the system can auto-generate this value.
- Select Manually from the How to set record field values picklist.
- Search for and select Permission Set Assignment (PermissionSetAssignment) in the Object field.
- Select Assigned User ID in the Field drop-down menu.
- In the Value field, select vUserToCreate under the Record Variables header.
- Type Id and then click away from this field. The system will then locate the User ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the User ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the User ID field.
- Click the Add Field button.
- Select PermissionSetGroup ID in the Field drop-down menu.
- In the Value field, type Get and select Permission Set Group from Get Permission Set Groups.
- Type Id and then click away from this field. The system will then locate the PermissionSetGroup ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the PermissionSetGroup ID field.
-
Please note: Id is case-sensitive. Entering ID or id will not locate the PermissionSetGroup ID field.
- Your flow should now look like the screenshot below.
Create Fault Screens
You'll need to create two Fault Screen elements in the flow. These elements will alert users if there is an error in the user creation process.
Steps for each Fault Screen element are provided in individual collapsible sections below for ease of viewing. Select each collapsed section to expand it and display the steps.
New User Fault Screen
New User Fault Screen Element
- Select the Create New User Create Records element. This will open a drop-down menu.
- Select Add Fault Path from the drop-down menu.
- Select the + icon below Fault.
- In the drop-down menu that opens, locate the Interaction header and select the Screen option.
- In Screen Properties, enter Error in the Label field.
- Enter errorScreen as the API Name in the API Name field.
- Use the Search components... search bar on the left-hand side to search for Display Text.
- Drag and drop the Display Text component from the menu onto the screen in the center.
- Enter $flowinterview.error in the rich text editor.
- Enter newUserError in the API Name field.
- Select Done to finalize the creation of this Fault Screen element.
- Your flow should now look like the screenshot below.
Create Package Fault Screen
Create Package Fault Screen Element
- Select the Error Screen element you just created. This will open a drop-down menu.
- Click Copy Element in the drop-down.
- Select the Create Package Create Records element. This will open a drop-down menu.
- Select Add Fault Path from the drop-down menu.
- Select the + icon below Fault.
- Select Paste 1 Element from the drop-down menu.
- Your flow should look like the screenshot below.
Saving the Flow
Once your elements are entered into the flow, you must save the flow to be able to use it. To save the flow:
- Select the Save button in the upper right-hand corner. A pop-up box will display.
- Enter a Flow Label and then click into the Flow API Name field to have the system auto-generate the API name. We recommend New User Creation Flow as a Flow Label.
- Click Save.
- The flow must be activated to be used. Once all elements are entered and the flow is saved, click the Activate button to activate it and make it available for use.
Create the New User Button
Locate the Flow's API Name
- Navigate to Salesforce Setup by selecting the cog icon in the upper right-hand corner and then selecting Setup from the drop-down menu.
- Use the Quick Find search bar on the left-hand side to search for Flows and select the Flows option under the Process Automation header.
- In the All Flows table, locate the flow you created above and select the caret in the far right-hand column. Then, select View Details and Versions from the drop-down menu.
- Locate the Flow API Name field and copy and paste the API Name for your flow somewhere readily accessible. You will need this information later.
- Please note: If you have created the flow above using the recommended name, New_User _Creation_Flow will likely be the API name. Please confirm this information before using this API name in the following steps.
Create a New Component
- Navigate to the Settings app by selecting the App Launcher in the upper left-hand corner and searching for and selecting Settings from the drop-down menu.
- Click the caret and select the Components option from the drop-down menu.
- Click the New button to begin creating a new component in your Practifi instance.
- Select the Action Menu radio button and then click Next to proceed.
- Enter a Component Name and proceed to the following section of this article to enter JSON code for this component.
-
Please note: We recommend naming the component Practifi - Create User Button, but the component name may be anything that suits your firm.
-
Please note: We recommend naming the component Practifi - Create User Button, but the component name may be anything that suits your firm.
Add JSON Code
After entering the new component's name, copy and paste the following JSON code into the JSON field:
{
"component":{
"attributes":{
"version":"1.0",
"componentType":"actionMenu"
},
"properties":{
"title":"Team Members",
"visibleButtons":2,
"actions":[
{
"actionType":"new",
"label":"Add Existing User",
"params":{
"objectName":"practifi__Division_Member__c",
"relatedField":"practifi__Division__c"
}
},
{
"actionType":"flow",
"label":"Create New User",
"params":{
"flowName":"New_User_Creation_Flow",
"hideToast":true,
"flowParams":{
"recordId":"[RECORDID]"
}
}
}
]
}
}
}
After pasting, the JSON field should look like the screenshot below. However, the JSON field will remain small even after information is added to it. To facilitate viewing and editing this information in the following step, we recommend expanding the field. To do so, select the lower right-hand corner of the field and drag your cursor to expand it.
Edit JSON Code
Please note: You will only need to complete this section's steps if your firm has chosen to name the flow something other than New User Creation Flow. The above JSON code already includes an API name of New_User_Creation_Flow.
If this API name does not match your firm's flow, the JSON will need to be modified using the following steps. If your firm's flow has New_User_Creation_Flow as the API name, you can proceed to the next section of this article.
- With the JSON code, locate the "flowName" line towards the bottom of the code. This code contains a placeholder flow name to account for your firm choosing a custom flow name. In order for this button to work, you must replace this information.
- Delete the placeholder flow name located between the quotation marks, but retain the quotation marks.
- Paste the flow API name that you located earlier in the Locate the Flow's API Name section above between the quotation marks.
-
Please note: For the component to work, the information pasted into the JSON code must be the flow's API name. This is not the same as the name you've given the flow.
-
Please note: For the component to work, the information pasted into the JSON code must be the flow's API name. This is not the same as the name you've given the flow.
- Select Save to finalize the creation of the component.
Add Component to the Page Layout
- Navigate to the Divisions page by using the App Launcher to search for and select Divisions.
- Select a division's hyperlinked name from the list of divisions to open a Division record.
- Click the cog icon in the upper-right corner and select Edit Page from the drop-down menu.
- Scroll down the page to locate the Team Memberssection and select the Team Members header.
- Click the + Add Filter button under the Set Component Visibility section.
- For the Filter Type, select Advanced.
- Click the Select button under Field.
- Click into the search bar and select User from the drop-down menu.
- In the next search bar that displays, begin typing Profile and select Profile from the results.
- In the next search bar that displays, select Name from the drop-down menu.
- Select Done.
- Set the Operator to Not Equal from the drop-down menu.
- Type System Administrator in the Value field.
- Select Done to finalize adding this condition.
- Scroll down the list of Components on the left-hand side to locate the Practifi - Action Menu component.
- Drag and drop this component from the list to under the Team Members header.
- Enter the name of the component you created previously into the Action Menu Name field.
-
Please note: If you used the recommended value from before, Practifi - Create User Button will be the value needed for this field. If your firm used another name, you will need to verify this by looking at the component where you entered the JSON information.
-
Please note: If you used the recommended value from before, Practifi - Create User Button will be the value needed for this field. If your firm used another name, you will need to verify this by looking at the component where you entered the JSON information.
- Click the + Add Filter button under the Set Component Visibility section.
- For the Filter Type, select Advanced.
- Click into the search bar and select User from the drop-down menu.
- In the next search bar that displays, begin typing Profile and select Profile from the results.
- In the next search bar that displays, select Name from the drop-down menu.
- Select Done.
- Leave the Operator set to Contains.
- Type System Administrator in the Value field.
- Select Done to finalize adding this condition.
- Click the Save button in the top-right corner to finalize your changes.
- System Administrators will now be able to click the New User button on the Division page under the Team Member heading in your Practifi organization.
Comments
Article is closed for comments.