Pega Sales Automation procedures
Complete the procedures in this section to adopt features after an update to Pega Sales Automation version 8.7.
Adding access roles (Pega Sales Automation)
Pega Sales Automation for Healthcare 8.7 comes with new access roles and privileges. Update your access groups with the new access roles.
Existing access group | New access role | New privilege | Purpose |
Underwriter | PegaHCSPM:Underwriter | spmCanAccessUnderwriter | To restrict underwriting access |
Fulfillment | PegaHCSPM:Fulfillment | spmCanAccessFulfillment | To restrict Fulfillment access |
Sales manager | PegaHCSPM:ApproveCPR | spmCanApproveCPR | To restrict custom plan approval access |
- In Dev Studio, navigate to .
- From the Access Group tab, select the access group that
corresponds to the underwriter.
- On the underwriter tab, in the Available roles area, click on Add role.
- In the new empty field, enter PegaHCSPM:Underwriter and click on Save.
- From the Access Group tab, select the access group that
corresponds to the fulfillment user.
- On the fulfillment user tab, in the Available roles area, click on Add role.
- In the new empty field, enter PegaHCSPM:Fulfillment and click on Save.
- From the Access Group tab, select the access group that
corresponds to the sales manager.
- On the sales manager tab, in the Available roles area, click on Add role.
- In the new empty field, enter PegaHCSPM:ApproveCPR and click on Save.
Modifying individual lead stages (Pega Sales Automation)
In Pega Sales Automation for Healthcare 8.7, the stages of the individual lead case type are different than in the previous versions. Modify your settings to reflect the updates.
- In Dev Studio, navigate to Case types
- Hover over Individual Lead and from the More actions menu (three dots), select Open.
- Click on Stages.
- In the Primary Stages section, remove the following
stages:
- Merged
- New
- Qualified
- Closed
- Add Converted as a new primary stage by clicking on add primary stage and entering Converted.
- Add Closed as an alternate stage by clicking on add alternate stage in the Alternate Stages section, and entering Closed.
- Click on the Assigned stage and, in the
Settings section, modify the settings as follows:
- Set Skip stage to Never
- Set When all processes in this stage are complete to Wait for a user action.
- Use the same settings as in step 7 for the Marketing Qualified and Sales Qualified stages.
- Click on the Converted stage, and set When all processes in this stage are complete to Automatically move to the next stage.
- Click on the Closed stage, and set When all processes in this stage are complete to Wait for a user action.
Creating individual accounts for organization contacts (Pega Sales Automation)
Run the spmCreateB2CC2AForAllContacts activity to create individual accounts for all contacts associated with organizations.
Contacts associated with organizations are designated with a C2O (contact-to-organization) relationship type code. In Pega Sales Automation for Healthcare version 8.7, when you create a contact associated with an organization, you automatically also create an individual (B2C) account for that contact. The relationship between the contact and the individual account is called C2A (contact-to-account).
In the Pega Sales Automation for Healthcare releases prior to 8.7, individual accounts were not created for contacts associated with organizations. To create the individual accounts for contacts imported from pre-8.7 versions, run the spmCreateB2CC2AForAllContacts activity.
- In Dev Studio, in the search field, type spmCreateB2CC2AForAllContacts, and then click on the search icon.
- In the results list, click on the spmCreateB2CC2AForAllContacts activity.
- On the activity tab, from the Actions drop down list, select Run.
Checking your Pega Sales Automation access roles for the required privileges
In Pega Sales Automation versions 7.4 and later, security enhancements on several rules require that an operator have new privileges to access the rules. Without the new privileges, an operator cannot access the rules required to run the application. After you update, complete the following steps to check if you need to add the new privileges to any of your access roles.
If you update from an earlier version, and your application uses the out-of-the-box access roles, your operators acquire the required privilege after the update.
- Review your access groups to determine whether you use any of the access roles
that have been updated to include the new privilege:
Access role Privilege PegaCRM:User4 crmCanSAUserRunActivity, crmCanCRMUserRunActivity PegaCRM-SFA:SysAdmin crmCanSAUserRunActivity, crmCanCRMUserRunActivity PegaSFA-EmailServices crmCanSAUserRunActivity, crmCanCRMUserRunActivity PegaCRMBase:Guest crmCanGuestUserRunActivity - If an access group does not include an access role with the required
privileges, ensure that your operators can access the rules that are required to
run your application:
If you use out-of-the-box access roles, add the access role to the access group.
For information, see Adding a role to an access group.
If you use custom access roles, modify the custom access role to include the privilege.
For information, see Granting privileges to an access role.
Updating quote requests in Pega Sales Automation for Healthcare
When you are updating Pega Sales Automation for Healthcare from any previous version, you need to update the quote request work objects. Perform this task so that you can see the quote requests that correspond to the accounts under the process of renewal for any renewal batches that were created in previous versions.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, to update the quote request, select the QuoteRequestUpdate check box.
- Repeat these steps until all of the work objects are updated.
Updating the account data model in Pega Sales Automation for Healthcare
In version 8.2, the Account data model has been changed to categorize enrollment records by plan type. To ensure that your accounts display in the renewal search, follow the steps to update the account data model.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, in the AccountUpgrade field, select the Value check box to update the Account data model structure.
- Repeat these steps until you update all the work objects.
Updating the opportunities table and Medicare selling mode in Pega Sales Automation for Healthcare
If you are updating from 7.4 or earlier, create a single table for saving Medicare, Individual, Small Group, and Large Group opportunities. Previously the application provided two tables.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, to change the Selling mode and Market segment of Medicare opportunities, select MedicareOpp and click Run.
- Repeat these steps until the market segment for all Medicare opportunities have been changed.
Saving the lead source value with one property in Pega Sales Automation for Healthcare
If you are updating from 7.4 or earlier, copy the value of the MedicareLeadSource property to the LeadSource property so that you can see the lead source.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, to copy the value of the MedicareLeadSource property to the LeadSource property, select MedicareLeadSource.
- Repeat these steps until all the leads are updated.
Setting the owner as the team member for opportunities in Pega Sales Automation for Healthcare
If you are updating from 7.4 or earlier, set the owner as the team member for the opportunity so that opportunities owned by the operator display on the landing page.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, to update the owner of the opportunity as sales team, select SalesTeamForOpp.
- Repeat these steps until all of the opportunities in the system are updated.
Updating the billing address work objects in Pega Sales Automation for Healthcare
If you are updating from 7.4 or earlier, update the billing address work objects so that you do not get an error.
- In the header of Dev Studio, search for and click the spmUpgradeUtility activity.
- Click .
- On the Run page, to update the address type from Billing to Billing Address, select BillingAddressType.
- Repeat these steps until all of the work objects are updated.
Updating the Market segment and Selling mode properties for Medicare case types
Run the MedicareUpgradeUtility activity to update the Market segment and Selling mode properties so that they are compatible with Pega Sales Automation for Healthcare 7.4.
- Log in to Pega Sales automation for Healthcare with the administrative credentials.
- In the header of Dev Studio, enter and search for the MedicareUpgradeUtility activity, and click it to open it.
- Click .
Updating the Medicare class group
Previously, the Medicare case type was using the PegaHCSPM-Work-Opportunity-Ind-Medicare class group. In SAHC 7.4, the PegaHCSPM-Work-Opportunity class group will be used instead.
- Log in to Pega Sales automation for Healthcare with the administrative operator.
- In the header of Dev Studio, enter and search for the MedicareUpgradeUtility activity, and click it to open it.
- Click .
Making Small Group, Large Groups, and Medicare opportunities accessible
After you update your application, the Small Group, Large Group, and Medicare opportunities that were created in 7.31 are not visible in the application stage. Run the spmUpgradeSalesTeamForOpp activity to repopulate the owner of the opportunity. The owner is now defined as part of the sales team of the opportunity.
- Log in to Pega Sales automation for Healthcare with the administrative operator.
- In the header of Dev Studio, enter and search for the spmUpgradeSalesTeamForOpp activity, and click it to open it.
- Click .
Preventing duplicate entries in the Lead source widget
- Log in to Designer Studio by entering the SPMSysAdmin operator and the password that you previously specified.
- Search for and select the spmUpgradeUtilityForLeadSourceMedicare activity in the PegaHCSPM-Work-Lead class.
- Click .
Previous topic Pega Customer Service procedures