Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Pega Sales Automation procedures

Updated on September 20, 2021

Complete the procedures in this section to adopt features after an update to Pega Sales Automation version 8.7.

Pega Customer Relationship Management for Insurance 8.7 Post-update Tasks for Pega Cloud services Environments Pega Customer Relationship Management for Insurance 8.7 Post-update Tasks for Pega Cloud services Environments Pega Customer Relationship Management for Insurance 8.7 Post-update Tasks for Pega Cloud services Environments Pega Customer Relationship Management for Insurance 8.7 Post-update Tasks for Pega Cloud services Environments Pega Customer Relationship Management for Insurance 8.7 Post-update Tasks for Pega Cloud services Environments

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.

  1. Review your access groups to determine whether you use any of the access roles that have been updated to include the new privilege:
    Access rolePrivilege
    PegaCRM:User4crmCanSAUserRunActivity, crmCanCRMUserRunActivity
    PegaCRM-SFA:SysAdmincrmCanSAUserRunActivity, crmCanCRMUserRunActivity
    PegaSFA-EmailServicescrmCanSAUserRunActivity, crmCanCRMUserRunActivity
    PegaCRMBase:GuestcrmCanGuestUserRunActivity
  2. 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:

Migrating data table values to field values

In Pega Sales Automation for Insurance 8.7, rules using the D_TaskCategories and D_ManageLossReasons data pages are changed to use field values to display Type on the Task screen, and Loss Reason on the Opportunity close screen.

Modify the overridden rules in your implementation layer that are using the D_TaskCategories and D_ManageLossReasons data pages to display their values in the UI by performing the following steps:
  1. Log in to Dev Studio as an administrator for your implementation layer.
  2. In the navigation pane of Dev Studio, click Records TechnicalActivities.
  3. Search for and open the CreateFieldValuesFromDataTable activity.
  4. Edit this activity by entering the following values:
    1. In the FieldName field, enter TaskType.
    2. In the FVAppliesToClass field, enter PegaCRM-Work-Task.
    3. In the DataTableDP field, enter D_TaskCategories.
    4. In the PropertyToCompare field, enter Name.
  5. Click Save.
  6. Run the activity by clicking Actions Run.
  7. Search for and open the CreateFieldValuesFromDataTable activity.
  8. Edit this activity by entering the following values:
    1. In the FieldName field, enter LossReason.
    2. In the FVAppliesToClass field, enter PegaCRM-.
    3. In the DataTableDP field, enter D_ManageLossReasons.
    4. In the PropertyToCompare field, enter Name.
  9. Click Save.
  10. Run the activity by clicking Actions Run.

Configuring Federated Case Management case types for web mashup

If your Pega Customer Service for Insurance or Pega Sales Automation for Insurance application uses out-of-the-box Federated Case Management case types, configure your application to pass the web mashup channel ID. The channel ID is required to avoid URL tampering and to load web mashup in a secure way. For information, see Adding support for Federated Case Management case types and Pega Sales Automation for Insurance 8.5 and Pega Underwriting for Insurance 8.5 integration.

Updating from Pega Sales Automation for Insurance 7.22 or 7.31

After an update to the current version of Pega Sales Automation for Insurance, perform the following post-update tasks if you are upgrading from Pega Sales Automation for Insurance 7.22 or 7.31.

  1. Update access groups and application instances to reference the SalesAutomationForInsurance 08.40 application.
  2. User defined functions (UDFs) are no longer supported for Cloud deployments. Existing objects and instances referencing UDFs in the 8.4 application will generate missing value errors for unexposed columns. If your customized application rules used properties that relied on UDFs, you must optimize the affected properties after the update by running the column population job to repopulate these properties. To obtain the list of the properties you must optimize after the update, review the DDL SQL file to find the altered database tables.
  3. Unique ID prefixes might be altered during the update. Review the Unique ID prefixes to ensure that they are still appropriate for the environment.

    Unique ID prefixClass reference
    BTPegaCRM-Data-BusinessTerritory
    DF-Pega-DM-DDF-Work
    HH-

    PegaCRM-Entity-RelationshipGroup-Household

    PegaInsCRM-Work-RelationshipGroup-Household

    PRPegaCRM-Data-Product
    RT-PegaCRM-Data-RelationShipTypes
    TP-PegaCRM-Data-TimePeriod

Migrating data from Pega Sales Automation for Insurance 7.22 or 7.31

Review the following information to migrate data from Pega Sales Automation for Insurance 7.22 or 7.31.

Note:
  • Review the migration activities and check with any additional vertical implementation processes to determine if there are additional, required customization steps or configurations. If so, backup the system database before running the activities.
  • Review the code to ensure that the obj-browse / RDs retrieve the right amount of data in scale with the number of relevant records in your implementation and ensure environments and database parameters can handle the work load. Determine if any migration processes can be configured to process a limited number of instances and if the process can be run repeatedly to complete the migration.
  1. If you will use Attribute Based Access Control (ABAC) security, complete the following tasks:
    1. Run the PopulateTerritoryForQuotes Quote activity to update all quotes with the appropriate territory.
      ABAC security requires control attributes to be maintained and exposed on each object in order to provide acceptable performance. Quotes require the appropriate TerritoryID assigned to each instance.
    2. Run the PopulateTerritoryAccInsNameForPolicies activity to apply the appropriate territory for each policy.
      ABAC security requires control attributes to be maintained and exposed on each object to provide acceptable performance. Internal and external policies require the appropriate TerritoryID assigned to each instance.
  2. If your application used a custom version of an activity that was deprecated in version 7.4, refactor the activity.

    The following table describes deprecated activities, and the refactoring information for each.

    pyclassnameActivity RulenameUpdateAlternate Rule Name
    Code-Pega-ListBusinessPolicyByProductOrProductGroupD_ShowPoliciesByProduct DataPage Activity replaced by Report Definition and Data Transform rulesReport Definition: PolicyByAccountAndProducts Data Transform: ShowPoliciesByProduct
    Code-Pega-ListIndvPolicyByProductOrProductGroupD_ShowPoliciesByProduct DataPage Activity replaced by Report Definition and Data Transform rulesReport Definition: PolicyByContactAndProducts Data Transform: ShowPoliciesByProduct
    Code-Pega-ListGetClaimsDetailsByIDD_PolicyClaims DataPage Activity replaced by Report Definition and Data Transform rulesData Transform: GetClaims
    Code-Pega-ListLoadAllPoliciesThis activity in D_ShowPolicies DataPage replaced by Report DefinitionReport Definition: FetchPolicies
    Data-GetCaseD_OperatorLookup Datapage and related activity, GetCase withdrawn due to non-use.
    PegaCRM-Data-ProductFetchProductByIDD_ProductByProductId Datapage updated to use Lookup method, so activity withdrawnLookup for Product Class - same parameter used for activity is used to do the lookup.
    PegaCRM-Data-ProductFetchProductByNameD_ProductByProductName DataPage updated to use Data Transform rule and activity withdrawnData Transform: FetchProductByName
    PegaCRM-Portal GetSearchResultsActivity withdrawn due to non-use
    PegaInsCRM-Data-CustSearchGetObjCountThe FlowAction activity was replaced with Data Transform GetObjCount.Data Transform: GetObjCount Data Page: D_GetQuotesByContactID Rpt Definition: GetQuotesByContactId Leverages crmRelatedTasksForContact / crmRelatedTasksForContact
    PegaInsCRM-Data-ManageLossReasonsGetLossReasonsActivity withdrawn due to non-use
    PegaInsCRM-Data-ManageTaskCategoriesGetTaskCategoriesThe Section SFAPortal_Tools_Content has a Task categories Button that ran GetTaskCategories activity for the Harness action. The secion rule has been updated and no longer run an activity. The section, ManageTaskCategories, which had a grid layout with pxResults has been updated with D_ManageTaskCategories DataPage as a source. Section Updated: ManageTaskCategories DataPage: D_ManageTaskCategories
    PegaInsCRM-Work-DetermineSourceSystemActivity ran Decision Table, DetermineSourceSystem. Activities that referenced this activity were udpated to reference DT directly.Activities updated to use DT instead of calling activity: PegaInsCRM-Work-Policy crmBulkPostMerge (withdrawn) PegaInsCRM-Work-SFA-Quote crmBulkPostMerge (withdrawn) If these activities have been customized, they may need to be refactored to call DT: PegaInsCRM-Work-Policy crmPreProcessRecord PegaInsCRM-Work-SFA-Quote crmPreProcessRecord
    PegaInsCRM-Work-PercentageOfTop5SalesPrioritiesWas used in DataPage, D_PercentageOfTop5SalesPrioritiesData Page D_PercentageOfTop5SalesPriorities updated to use Data Transform PercentageOfTop5SalesPriorities
    PegaInsCRM-Work-Policy DetermineProductIdActivity ran Decision Table DetermineProductId. Activity GetPolicyDetailsByID was udpated to apply Data Transform DetermineProductIdData Transform: DetermineProductId
    PegaInsCRM-Work-SFA-OpportunityAddFeedbacktoPulseThis wrapper activity was withdrawn. FlowAction GetFeedback was updated to call pxPostMessage activity directly.N/A
    PegaInsCRM-Work-SFA-QuoteDetermineProductIdUpdated "GetQuoteDetails" activity to call decision tableData Transform: DetermineProductId
    PegaInsCRM-Work-Task GetWorkObjectsRelatedToTaskUpdated Datapage D_WorkObjectsRelatedToTask to use Report Definitions.Activity withdrawn and GetWorkObjectsRelatedToTask RD's created in account, contact, org, lead, opportunity classes
  3. If your application used a custom version of a quote section that was deprecated in version 7.4, convert to a new section.

    Two quote sections are deprecated and two new sections are added. The new sections conform to the Sales Automation for Insurance naming conventions. The sections are invoked when adding, reviewing, and editing an internal or external quote. Deprecated sections will be removed in a future release.

    The following tables shows the quote section changes from version 7.31 to version 7.4. An asterisk (*) denotes a value that is circumstanced for Internal/External quotes.

    Structure - Harness New

    UI Form7.317.4
    HarnessNewNew
    SectionpyNewWorkSummarypyNewWorkSummary
    SectionWorkSummary*CaptureWorkPrimaryDetails*
    SectionAddInternalQuote / AddExternalQuote
    SectionAddInternalQuote_ToWrap / AddExternalQuote_ToWrap

    Structure - Harness: Perform

    UI Form7.317.4
    FlowActioncrmEdit crmEdit
    SectionpyNewWorkSummarypyNewWorkSummary
    SectionWorkSummary*CaptureWorkPrimaryDetails*
    SectionAddInternalQuote / AddExternalQuote
    SectionAddInternalQuote_ToWrap / AddExternalQuote_ToWrap

    Structure - Harness: Review

    UI Form7.317.4
    HarnessReviewNew
    SectionpyCaseMain
    SectionpyWorkBody
    SectionpyWorkBodyLeft
    SectionpyWorkDetailspyWorkDetails
    SectionWorkSummary*workPrimaryDetails*
    SectionAddInternalQuote
    SectionAddInternalQuote_ToWrap

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us