2186261 - SAP HANA Rules Framework 1.0 SPS05 Release Note

Symptom

This is the SAP release note for SAP HANA Rules Framework 1.0 SPS05 (1.005).

Other Terms

SAP HANA rules framework; HRF; release note; SPS05

Reason and Prerequisites

You are installing SAP HANA rules framework 1.0 SPS05 add-on on top of SAP HANA platform.

Solution

Solution Highlights
SAP HANA rules framework (HRF) is a native decision management framework for SAP HANA, which enables developers to easily add intelligent real-time decision making to SAP HANA applications and empowers business users to define and manage decisions in dynamic scenarios.
In this release, we have added a rule management application that runs in a web browser. Using the web application, users can view, create, edit, test, and run rules and rule services. The web application is a standalone Fiori UI5 application that saves you the effort of integrating our Rule Builder UI controls into your custom application.
Minimal Revisions Requirements of SAP HANA for SAP HRF 1.0 SPS05:

• SAP HRF 1.0 SP05 without SAP HRF modeling tools:
• SAP HANA SPS 09 rev. 97
• SAP HANA SPS 10 rev. 100
• SAP HRF 1.0 SP05 Patch 0 with SAP HRF modeling tools:
• SAP HANA SPS 09 rev. 97
• SAP HRF 1.0 SP05 Patch 1-3 with SAP HRF modeling tools:
• SAP HANA SPS 10 rev. 100
• SAP HRF 1.0 SP05 Patch 4+ with SAP HRF modeling tools:
• SAP HANA SPS 10 rev. 102.1

For information about the SAP HANA components and the respective SAP HANA hardware requirements, go to the SAP HANA Product Availability Matrix (PAM) on SAP Support Portal at https://apps.support.sap.com/sap/support/pam (search for: SAP HANA PLATFORM).
For information about browser support, see the "Supported Web Browsers" attachments in this note. Note that while SAP HANA rules framework runs on all desktop browsers and operating systems that are supported by SAP UI5 controls, this version of SAP HANA rules framework currently does not support mobile devices.
Documentation:
Documentation for SAP HANA Rules Framework 1.0 SPS 05 can be found on SAP Service Marketplace at http://service.sap.com/~form/sapnet?_SHORTKEY=00200797470000103845.
Late documentation corrections:

• As of SAP HRF 1.0 SPS05 Patch Level 3, use the "http://<hostname>:80<instance_number>/sap/hrf/" repository path instead of "http://<hostname>:80<instance_number>/sap/hrf/updatesite" when deploying the SAP HRF modeling tools. See the topic "Deploying the SAP HANA Rules Framework Modeling Tools (Optional)" in the "SAP HANA Rules Framework - Installation & Upgrade Guide".

Installation and Upgrade Information:
For instructions, refer to the "SAP HANA Rules Framework - Installation and Upgrade Guide" at https://service.sap.com/~sapidb/012002523100011988892015E.
Important notes for upgrade customers:

• Customers that until now used SAP HANA rules framework with the runtime plug-in disabled must enable the runtime plug-in following the upgrade to this release. To do so, run the provided configuration script as described in the "SAP HANA Rules Framework - Installation and Upgrade Guide".
• The namespace of the UI library has changed from "hrf.controls" to "sap.hrf.ui.uilib". For more information, see "Embedding the Rule Builder UI Control" in the "SAP HANA Rules Framework - Development and Implementation Guide".
• If you made custom changes directly in the .xsaccess file prior to the upgrade, you need to reconfigure those changes, since the .xsaccess file is overwritten whenever the delivery unit of SAP HANA rules framework is redeployed. Unless instructed otherwise in the documentation, if you need to customize application runtime settings in SAP HANA based on SAP HANA rules framework recommendations or requirements, you should make your changes using the SAP HANA XS Administration UI Tool.

New Features in the SAP HRF 1.0 SPS 05 Release:
These are the main highlights of this release:

• Installation and Upgrade:
  • As of SAP HANA rev. 97, a restart is no longer required after enabling the SAP HRF runtime plug-in. Additionally, the SAP HRF post-installation/upgrade configuration script can be executed in a single step (previously two runs were required to complete the activation of resources).
• Web Application for Business and Expert Users:
  • Business users can view all rules in the system. The UI also provides search, filter and sort capabilities.
  • Business users can create rule instances from scratch and edit existing rules.
  • Expert users can view all rule services in the system. The UI also provides search, filter and sort capabilities.
  • Expert users can create and edit rule services directly in the web app. The rule service editor also allows users to configure the attributes and parameters of rule services.
  • Expert users can configure the basic settings of the rule framework. This includes setting the time zone and also references to SAP HANA packages that store all rules and rule services.
• Rule Expression Language:
  • The REL has been enriched with 'any of the following' and 'all of the following' phrases that simplify the way in which business users can write complex text rules as structured conditions. For example, instead of writing the condition 'gender of the customer is equal to 'm' and first_name of the customer starts with 'J' and last_name of the customer does not contain 'Gold' and age of the customer is greater than 18', you could write the following:

all of the following conditions are true:• gender of the customer is equal to 'm'• first_name of the customer starts with 'J'• last_name of the customer does not contain 'Gold’• age of the customer is greater than 18;

• Business users can now create conditions based on a root object collection with 'all' as a part of a term. For example:
• 'level of all customers' (instead of the current behavior: 'all level of the customer')
• 'amount of all purchaseOrders of all customers' (instead of the current behavior: 'all amount of all purchaseOrders of a customer')
• Business user can now use the 'is not' operator in Boolean expressions. For example:
  
  • 'payment is not paid' (which is identical to the expression: 'payment is paid = false')
  • 'number of payments where payment is not paid is greater than 10'
• Vocabulary:
  • To improve the runtime performance of results whereby a one-to-one association exists in the vocabulary's data objects, the implementer can now choose either of the following cardinality settings:
    • (Existing) OneToOne (1..1): This indicates that for every record in one object there exists exactly one record in the associated object.
    • (New) oneToZeroToOne (1-0..1): This indicates that for every tuple in one object there may be one tuple in the associated object, but not necessarily.

For further details and to be aware of additional changes that may require further action from you, especially if you are performing an upgrade, make sure you also review the "Documentation History" topics in each of the guides.
SP05 Patch Level 1 Corrections:

• [UPDATE] Added System privileges "SERVICE ADMIN" to default Hrfadmin role.
  
• [FIXED] SAP HRF web application configuration UI does not open after running post-installation/upgrade script.
  
• [FIXED] SAP HRF web application configuration UI does not open after skipping post-installation/upgrade script.
  
• [FIXED] Users on SAP HANA XS apps are unable to connect via redirect functionality to the SAP HRF web application and/or embedded Rule Builder UI control.
  
• [FIXED] SAP HANA rules framework modeling tools does not run after an upgrade to SAP HANA SPS 10.
  
• [FIXED] When updating settings in the SAP HRF web application configuration UI, user's changes are still saved after clicking Cancel or closing the window.
  

SP05 Patch Level 2 and 3 Corrections:

• [FIXED] Installation issues due to mismatch between manifest and configuration files in the deployment unit.
  

SP05 Patch Level 4 Corrections:

• [FIXED] Mass activation and deployment of delivery unit not working on SAP HANA SPS 10 rev 102.1.

IMPORTANT: As of SAP HRF 1.0 SPS 05 Patch Level 4, customers using the SAP HRF modeling tools must upgrade to SAP HANA SPS 10 rev. 102.1.

Header Data

Released On	09.12.2015 13:09:07
Release Status	Released for Customer
Component	HAN-AS-RUL SAP HANA Rules Framework
Priority	Recommendations / Additional Info
Category	Upgrade information