installation & configuration guide release 8.0.7.0...this document describes the necessary steps...

Oracle Financial Services Data Management Pack (Reconciliation Framework) Language Patch

Installation & Configuration Guide

Release 8.0.7.0.0

July 2019

ORACLE FINANCIAL SERVICES DATA MANAGEMENT PACK (RECONCILIATION FRAMEWORK) LANGUAGE PATCH | 2

Oracle Financial Services Data Management Pack (Reconciliation Framework) Language Patch

Copyright © 2019 Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are “commercial computer software” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

For information on third party licenses, click here.

http://www.google.com/

http://www.google.com/

https://docs.oracle.com/cd/E61555_01/licensing.htm


Document Control

Version Number Revision Date Change Log

01 June 2019 Created document to capture OFS DM (Reconciliation Framework) Language Pack procedure.

OFS DATA MANAGEMENT (RECONCILIATION FRAMEWORK) LANGUAGE PACK

PRE INSTALLATION REQUIREMENTS


Table of Contents

1 OFS Data Management (Reconciliation Framework) Language Pack .................... 6

1.1 Pre Installation Requirements ............................................................................................................ 6

1.2 How to Apply this Language Pack Release? ..................................................................................... 6

1.3 Post Installation Configuration ........................................................................................................... 8

1.3.1 OBIEE Translation ........................................................................................................................ 8

1.4 User Desktop Settings ...................................................................................................................... 15

1.5 General Observations ...................................................................................................................... 18




1 OFS Data Management (Reconciliation Framework) Language Pack

This document describes the necessary steps to install and configure Oracle Financial Services Data Management (OFS DM) (Reconciliation Framework) Language Pack 8.0.7.0.1, 8.0.7.0.2, and enable the UI of OFS DM in different languages in addition to US-English. The language pack supported in this release are Spanish and Canadian French.

1.1 Pre Installation Requirements

The following must be successfully installed before proceeding with this installation:

The minimum version of Oracle Financial Services Reconciliation Framework on which this patch can be applied is 8.0.7.0.0

Install the following patches:

OFS AAI 8.0.7.1.0 (Bug ID 29002529)

OFS AAI One-off (Bug ID 29692893)

OFS AAI Language pack 8.0.7.0.0 (Bug ID 29646990)

Ensure that English (US) locale based on utf8 encoding is available in the server. To check the installed locale, execute the following command:

locale -a | grep -i 'en_US.utf'

Based on the operating system, the command output will be as follows:

Linux: en_US.utf8

AIX: EN_US.UTF-8

Solaris: en_US.UTF-8

1.2 How to Apply this Language Pack Release?

Refer to the following instructions to install the contents of this Language Pack.

1. Login to https://support.oracle.com/ search for the following bugs under the Patches & Updates tab.

a. Bug #29861179 (Spanish)

b. Bug # 29947826 (Canadian French)

2. Download the OFS DM (Reconciliation Framework) Language Pack 8.0.7.0.1 Release #1 for Spanish and OFS DM (Reconciliation Framework) Language Pack 8.0.7.0.2 Release #2 for Canadian French archive file from MOS and copy it to your OFSAA server in Binary mode.

3. Stop all the OFSAAI Services. For more information, refer to the Start/Stop Infrastructure Services section in Oracle Financial Services Data Management Installation Manual Release 8.0 available at OHC library.

4. If you have Unzip utility, skip to the next step. Download the Unzip utility (OS specific)

unzip_<os>.Z, copy it in Binary mode to the directory that is included in your PATH

https://support.oracle.com/

https://docs.oracle.com/cd/E60528_01/dmhome.htm


HOW TO APPLY THIS LANGUAGE PACK RELEASE?


variable, typically $HOME path or directory in which you have copied the language pack archive file.

Uncompress the unzip installer file using the command:

uncompress unzip_<os>.Z.

NOTE In case you notice an error message “uncompress: not found [No

such file or directory]” when the package is not installed, contact

your administrator.

Give Execute permission to the file using the command:

chmod 751 unzip_<os>.

For example, chmod 751 unzip_sparc.Z

5. Extract the contents of the OFS DM 8.0.7.0.1 LP and 8.0.7.0.2 LP archive file using the following command:

unzip <name of the file to be unzipped>

For example, “unzip 29861179_GENERIC.zip”

6. Grant permissions 755 to Installation and Download directory, using the below command:

chmod –R 755 OFS_DM

7. The configuration file params.conf must be updated with UPLOAD_MODEL=0 before triggering the Installation. The params.conf file is available in the path /OFS_DM/conf.

8. Navigate to <>/OFS_DM/bin and execute the command./install.sh. Check if the

patch is applied successfully (script would report errors if any).

9. Verify the patch installation logs in the location <>/OFS_DM/logs.

10. Delete the existing EAR/WAR file available in $FIC_HOME/ficweb folder.

11. Generate EAR/WAR file and redeploy the application onto your configured web application server. For more information, refer to the Post Installation Configuration section in the Oracle Financial Services Data Management Installation Manual Release 8.0 available at OHC library.

12. Once the OFS DM Language Pack has been installed successfully a restart all the OFSAAI services. For more information, refer to the Start/Stop Infrastructure Services section in the Oracle Financial Services Data Management Installation Manual Release 8.0.7 available at OHC library.

http://docs.oracle.com/cd/E60528_01/homepage.htm

http://docs.oracle.com/cd/E60528_01/homepage.htm


POST INSTALLATION CONFIGURATION


1.3 Post Installation Configuration

Post successful installation of OFS DM (Reconciliation Framework) Language Pack, you need to perform the following configurations.

NOTE Ensure to re-save the GL hierarchies (HGL001 to HGL013) with new

language.

1.3.1 OBIEE Translation

This section contains the following:

Catalog Configuration For Language Pack – OBIEE

RPD Configuration For Language Pack Implementation

1.3.1.1 Catalog Configuration for Language Pack – OBIEE

Prerequisite:

It is mandatory to have captions.xml for the catalog captions in all the desired languages before starting the catalog configuration.

Follow the below steps to configure the Catalog for Language Pack:

1. Navigate to the below OBIEE folder:

$ORACLE_INSTANCE/user_projects/domains/OBIEE12c/bidata/service_in

stances/ssi/metadata/content/msgdb

2. Create a folder structure for each of the languages as below

(For example, ‘l_es’ stands for Spanish and ‘l_fr_CA’ stands for Canadian French).

/msgdb/l_es/captions

/msgdb/l_fr_CA/captions

3. Place the reconciliation+frameworkcaptions.xml_es_ES.xml corresponding

to Spanish Language in the captions folder in the following folder structure.

4. Place the reconciliation+frameworkcaptions.xml_fr_CA.xml corresponding

to Canadian French Language in the captions folder in the following folder structure.




5. Restart the Presentation Services in Enterprises Manager.

6. Log in to analytics by selecting the language as Spanish or Canadian French.

7. Verify if the captions are translated in the dashboard reports.

1.3.1.2 RPD CONFIGURATION FOR LANGUAGE PACK IMPLEMENTATION

Prerequisite:

To implement the language pack successfully on RPD, it is mandatory to have a connection pool that provides external metadata strings corresponding to the RPD of the product.




In the below example, the source is a physical database table FSI_BI_MESSAGES_REPOSITORY_MLS with the relevant columns for the object ID and object name as message_id, message_text respectively.

Follow the below steps to configure the RPD for language pack:

1. Update LANGUAGE_ID column of FSI_BI_MESSAGES_REPOSITORY_MLS and replace the LANGUAGE_ID with corresponding values that will be recognized by OBIEE. Below are few examples :

fr_FR = FRA

es_WW = ESN

fr_CA=FRC

de_DE = DEU

ar_EG = ARA

zh_TW = CHT

zh_CN = CHS

pt_BR = PTG

ko_KR = KOR

ja_JP = JPN

it_IT = ITA

2. Open the RPD and navigate to the section Manage > Variables.

3. Create a new session Initialization block: LOCALE Init Block.




4. Add the connection pool which contains the External Metadata Strings as a Data Source.




5. Enter the following query as the default initialization string

select 'VALUEOF(NQ_SESSION.WEBLANGUAGE)' from dual

6. Create a new data target for the initialization block by the name LOCALE and initialize it to ‘en’ (for English). (Default Initializer: ‘en’)




7. Repeat step 2 to create another initialization block as: “External Metadata Strings” and select the same data source with the Default Initialization String as below :

SELECT message_id, message_text FROM fsi_bi_messages_repository_mls

WHERE upper(LANGUAGE_ID) = DECODE( upper('VALUEOF(NQ_SESSION.LOCALE)') , 'EN' , 'ENU', 'FR', 'FRA', 'DE' , 'DEU', 'ES', 'ESN', 'JA', 'JPN', 'PT-BR', 'PTB', 'IT', 'ITA',

'SV', 'SVE', 'DA', 'DAN', 'NL', 'NLD', 'ZH' , 'CHS', 'ZH-TW', 'CHT', 'IW', 'HEB', 'KO', 'KOR',

'CS', 'CSY', 'FI' , 'FIN', 'EL', 'ELL', 'PT', 'PTG', 'PL', 'POL', 'EL','GRC', 'HU','HUN',

'RO','ROM', 'SK','SKY', 'FR-CA','FRC', 'EN-CA','ENC', 'EN-GB','ENG', 'EN-NL','ENN',

'EN-IE','ENI', 'FR-CH','FRS', 'DE-CH','DES', 'DE-AT','DEA', 'FR-BE','FRB', 'NL-BE','NLB', 'TR','TRK', 'ENU')

UNION

SELECT 'A' AS MESSAGE_ID,'B' AS MESSAGE_TEXT FROM DUAL

8. Edit the Data Target and select Row-wise Initialization and Use Caching.

9. Edit Execution Precedence and add Locale Init Block.


USER DESKTOP SETTINGS


10. Right click on each Presentation Layer Subject Area and select Externalize Display Names > Generate Custom Name.

11. Check in the changes and save the RPD.

If you login to Analytics with a language which is supported in

fsi_bi_messages_repository_mls table, you can view all Presentation Layer

Objects in the corresponding language.

12. Restart the Presentation Services in Enterprises Manager.

1.4 User Desktop Settings

Post successful installation of Language Pack, you need to set the Operating System and Browser on every User Desktop, prior accessing the OFS DM application.

Follow these steps to enable the settings in Operating System level.

1. Navigate to Start; click Control Panel select Regional and Language Options.




2. Under the Formats tab, choose the desired language from the drop-down list for Language for non-Unicode programs.

For information on Language Pack Code and its Properties, refer to Supported Language Pack Details section.

3. Click Apply and click OK.

Follow these steps to enable the settings in Browser (Internet Explorer).

1. Navigate to Tools > Internet Options.

2. Under the General tab, Click Languages. The Language Preference window is displayed.




3. Click Add. The Add Language window is displayed.

4. Select the installed Language Pack from the list. You can press and hold Ctrl key for multiple selections. For information on Language Pack Code and its Properties, refer to section Supported Language Pack Details.

5. Click OK in the Language Preference window and again click OK in Internet Options window to save the settings and exit.

6. Restart the user machine for the above changes to take effect.


GENERAL OBSERVATIONS


1.5 General Observations

Some of the strings may not be present in all supported languages and will be displayed in English.

In some of the Run Management screens, few strings are displayed in Spanish/Canadian French when English locale is selected.


GENERAL OBSERVATIONS


OFSAAI Support Contact Details

Contact Infrastructure support at https://flexsupp.oracle.com if you have installed ERM and FCCM applications.

Raise an SR in https://support.oracle.com if you have any queries related to EPM applications.

https://flexsupp.oracle.com/

https://support.oracle.com/

OFS DATA MANAGEMENT (RECONCILIATION FRAMEWORK) LANGUAGE PACK | GENERAL OBSERVATIONS

ORACLE FINANCIAL SERVICES DATA MANAGEMENT PACK (RECONCILIATION FRAMEWORK) LANGUAGE PATCH| 20

Send Us Your Comments

Oracle welcomes your comments and suggestions on the quality and usefulness of this publication. Your input is an important part of the information used for revision.

Did you find any errors?

Is the information clearly presented?

Do you need more information? If so, where?

Are the examples correct? Do you need more examples?

What features did you like most about this manual?

If you find any errors or have any other suggestions for improvement, indicate the title and part number of the documentation along with the chapter/section/page number (if available) and contact the Oracle Support.

Before sending us your comments, you might like to ensure that you have the latest version of the document wherein any of your concerns have already been addressed. You can access My Oracle Support site which has all the revised/recently released documents.

installation & configuration guide release 8.0.7.0...this document describes the necessary steps...

Documents