Developer Guide | PUBLIC Document Version: 1.0 – 2021-05-06 Developer Guide SAP Underwriting for Insurance 4.0 SP06 company. All rights reserved. All rights company. affiliate THE BEST RUN 2021 SAP SE or an SAP SE or an SAP SAP 2021 © Content 1 Introduction................................................................8 1.1 About This Document..........................................................8 1.2 Audience...................................................................8 1.3 Source Code Terms and Conditions................................................8 1.4 Supported Clients............................................................ 8 1.5 Product Name Abbreviations.....................................................9 2 Understanding Application Development in FS-QUO.................................10 2.1 Terminology................................................................10 2.2 Understanding the Difference Between Coverage-Based and Risk-Based Product Architectures .........................................................................12 2.3 Customer Views.............................................................13 2.4 Overview.................................................................. 15 2.5 References.................................................................18 2.6 Development Components......................................................19 2.7 Understanding How the Components Work Together...................................20 3 Working with the Development Toolkit...........................................22 3.1 Understanding the FS-QUO Development Toolkit Contents...............................22 3.2 Installing the FS-QUO Toolkit....................................................24 Prerequisites for Installing the FS-QUO Toolkit.....................................25 Creating the FS-PRO Designer Runtime Database...................................26 Installing and Configuring Eclipse..............................................26 Installing WildFly and Creating a New Server Profile..................................27 Generating the Keystore and Enabling SSL in WildFly................................ 27 Installing and Configuring the FS-QUO Toolkit......................................28 Copying and Deploying Insurance Product JAR Files from Product Configurator............. 35 Configuring the FS-QUO Toolkit for FS-QUO.......................................36 Installing and Configuring Standalone SAP JCo (Optional).............................37 Validating the Complete FS-QUO Toolkit Installation (Fiori)............................40 Validating the Complete FS-QUO Toolkit Installation (Sencha)..........................41 Copying the <csi_home> Artifacts to the Development Profile..........................41 Administrative Console Changes...............................................42 Debugging UI Changes......................................................42 Building the Custom FS-QUO SCA and <csi_home> Package..........................43 Updating the FS-QUO Toolkit................................................. 43 3.3 Additional Software Management Tools............................................ 45 Developer Guide 2 PUBLIC Content 3.4 Changing Default Error Report Settings............................................ 46 4 Extensibility Best Practices................................................... 47 4.1 Understanding Extensibility.....................................................47 4.2 Extensibility Best Practices (Version 3.0 and Later)....................................48 Understanding Design Time..................................................48 Customization Site Map.....................................................48 Extensibility Scenarios by Area................................................49 Adding a Custom Project.................................................... 57 4.3 Extensibility Best Practices (Legacy).............................................. 58 Understanding Extensibility.................................................. 58 Extension Compared to Customization.......................................... 59 Location of Configuration Changes.............................................59 Location of Extensions......................................................60 Changes Preserved After an Upgrade........................................... 60 Conflicts with New Functionality............................................... 61 Merging Changes in an Upgrade............................................... 61 Typical Extensibility Scenarios.................................................61 4.4 Unsupported Extension Types...................................................67 4.5 Understanding TransferObjectBase Usage in Risk-Based Architecture.......................68 5 Sencha-Based UI............................................................72 5.1 Modifying the User Interface.................................................... 72 Understanding the User Interface Development Components.......................... 73 Modifying a Screen or Section.................................................75 Modifying Buttons in the Button Bar............................................88 Extending the User Interface..................................................91 5.2 Understanding the JavaScript Classes.............................................92 Available Classes and Functions...............................................93 Available Control Classes....................................................98 5.3 Understanding Handlers and Handler Beans........................................102 Configuring Handlers......................................................102 Configuring Handler Beans..................................................109 Extending a Handler.......................................................110 Extending a Handler Bean................................................... 111 Preserving Extended Handlers After Upgrading....................................111 Example: Extended Handlers and Handler Beans...................................111 5.4 Working with the Validation Framework............................................112 Locating the Validation Framework.............................................113 Understanding the Screen Framework Folder....................................114 The Validation Folder....................................................120 Understanding Business Questions............................................127 Developer Guide Content PUBLIC 3 Using Validation Stems.....................................................131 5.5 Working with the Search Framework..............................................132 Locating the Search Framework...............................................132 The Search Framework Folder.............................................. 132 Search Component.......................................................132 SearchCriteriaItem Component........................................... 133 SearchCriteriaItemColumns Component.....................................135 SearchControlUIConfiguration Component..................................135 SearchGroupByColumns Component......................................... 136 SearchOrderByColumns Component......................................... 136 SearchResultItem Component............................................. 136 SearchColumns component.................................................137 Example: Configuring the Work List Search.......................................138 Modifying a Database View..................................................139 Understanding the Search Framework Methods................................... 140 5.6 Working with the Simplified Insurance Application Renderer............................. 141 Suppressing Error Information................................................142 Setting Up the Simplified Insurance Application Renderer............................ 143 Extending the Simplified Insurance Application Renderer.............................149 6 Core FS-QUO............................................................. 150 6.1 Working with Application Flows................................................. 150 Overriding a Flow.........................................................152 Modifying a Flow......................................................... 152 Example: Adding an Activity to a Flow...........................................158 Preserving Modified Flows After an Upgrade......................................159 6.2 Business Services...........................................................159 Accessing the javadoc..................................................... 160 Business Service Components and Methods..................................... 160 Understanding Business Validation............................................ 164 Understanding the Core Service Components.....................................166 Extending a Business Service................................................ 167 Preserving Extended Services After Upgrading....................................168 6.3 Underwriting Application Configuration............................................168 AppConfig Service Bean....................................................169 Locating the Standalone Underwriting Application Configuration.......................170 Extending the Underwriting Application Configuration Standalone Object................. 171 Modifying Application Configuration Settings.....................................172