Develpment Wrkbench- Screen Develpment II Oracle FLEXCUBE Universal Banking Release 12.2.0.0.0 1
Cntents 1 Preface... 3 1.1 Audience... 3 1.2 Related Dcuments... 3 2 Intrductin... 4 3 Generated Files... 4 3.1 Frnt-End Files... 5 3.2 System Packages... 6 3.3 Hk Packages... 7 3.4 Meta Data... 8 3.5 Others... 10 4 Deplyment... 10 4.1 Prerequisites:... 10 4.2 Deply Files:... 12 5 Release... 13 5.1 SVN Integratin... 13 2
1 Preface This dcument describes the generatin, deplyment and release f units frm Oracle FLEXCUBE Develpment Wrkbench fr Universal Banking. This dcument explains the prcess f generating and deplying files frm Develpment Wrkbench fr a functin id 1.1 Audience This dcument is intended fr FLEXCUBE Applicatin develpers/users that use Develpment Wrkbench t develp varius FLEXCUBE cmpnents. T Use this manual, yu need cnceptual and wrking knwledge f the belw: Prficiency FLEXCUBE Functinal Architecture Resurces Training prgrams frm Oracle Financial Sftware Services. FLEXCUBE Technical Architecture Training prgrams frm Oracle Financial Sftware Services. FLEXCUBE Object Naming cnventins Develpment Overview Guide Wrking knwledge f Web based applicatins Self Acquired Wrking knwledge f Oracle Database Oracle Dcumentatins Wrking knwledge f PLSQL & SQL Language Self Acquired Wrking knwledge f XML files Self Acquired Wrking Knwledge f Develpment Wrkbench fr Universal Banking User Manuals 1.2 Related Dcuments 04-Develpment_WrkBench _ Screen_Develpment-I.dcx 07-Develpment_WrkBench _ Ntificatins.dcx 3
2 Intrductin This dcument gives infrmatin n the fllwing tpics: Chapter 2, Intrductin Chapter 3, Generated Files" Chapter 4, Deplyment Chapter 5, "Release 3 Generated Files Develpment Wrkbench generates fllwing files as shwn in the figure belw. This screen can be launched by clicking n icn frm the functin generatin screen. This has t be dne after design f screen is cmpleted. Refer 04-Develpment_WrkBench _ Screen_Develpment-I.dcx fr detailed explanatin n screen develpment Fig 3.1: File Generatin Screen Fr actin New, Wrkbench autmatically selects the all files as shwn in figure. If functin ID has been laded.then hk packages will nt be checked Click n Generate buttn t generated the files selected 4
3.1 Frnt-End Files Fig 3.2: Files Generated message These files need t be cpied t applicatin server in respective flders. RADXML This file cntains the Data Used t Design screen. Radxml is Input t Wrkbench. File Name : <Functin_ID>_RAD.xml Screen Xml This file is an XML markup f presentatin details, fr the designed Functin ID specific t a language. XSL Transfrmatin is applied t this XML file by linking it t an XSL file. This results in HTML Markup which is displayed by the brwser. File name : <Functin_ID>.xml System JS This JavaScript file mainly cntains a list f declared variables used by FLEXCUBE Infra. msgxml: - This variable is used by the system t build FCUBS Request XML datasrclcatinarray: - This variable is an array f DATA BLOCKS relatinarray:-this array cntains relatin and relatin type details f blcks.this is used fr data binding retflds and bndflds:- These arrays cntains LOV infrmatin CallFrmArray, CallFrmRelat, CallRelatType:- These arrays cntains callfrm details, call frm relatin and relatin type 5
actinsammendarray: - This array cntains infrmatin fr enabling fields based n actins File name : <Functin_ID>_SYS.js Release Specific JS Nte: Release Specific JavaScript File will nt be generated by Wrkbench. This file, if required, has t be created by develper. This JavaScript file allws develper t add functinal cde and is specific t Release. The functins in this file are generally triggered by screen events. A develper wrking in KERNEL release wuld add functins based n tw categries: Functins triggered by screen lading events Eg: fnprelad_kernel(),fnpstlad_kernel() Functins triggered by screen actin events Eg: fnprenew_ KERNEL (),fnpstnew_ KERNEL () A develper wrking in CLUSTER release wuld add functins based n tw categries: Functins triggered by screen lading events Eg: fnprelad_cluster(),fnpstlad_cluster() Functins triggered by screen actin events Eg: fnprenew_ CLUSTER (),fnpstnew_ CLUSTER () In case if any functin in KERNEL JavaScript file has t be mdified, this can be achieved by verriding the functin in CLUSTER JavaScript file. The functins in this file are generally triggered by screen events. A develper wrking in CUSTOM release wuld add functins based n tw categries: Functins triggered by screen lading events Eg: fnprelad_custom(),fnpstlad_custom() Functins triggered by screen actin events Eg: fnprenew_ CUSTOM (),fnpstnew_ CUSTOM () In case if any functin either in KERNEL JavaScript file r CLUSTER JavaScript file has t be mdified, this can be achieved by verriding the respective functin in CUSTOM JavaScript file File name : <Functin_ID>_<RELEASE_TYPE>.js 3.2 System Packages Main Package Specificatin: The Main Package Spec Cntains all the Declaratins. Main Package Bdy: 6
Main Package wuld cntain the all the business lgic and persistence cde fr the functined. It will als cntain call t hk packages.different flavrs f main Package generated are 1) Maintenance FunctinId 2) Transactin FunctinId 3) Others Categry FunctinId 4) Reprt Parameter Screen 5) Ntificatin 6) Purge Entity The main package has the belw stages in case f a maintenance functin: Cnverting Ts t PL/SQL Cmpsite Type Checking fr mandatry fields Defaulting and validating the data Writing int Database Querying the Data frm database Cnverting the Mdified Cmpsite Type again t TS Each f these stages has a Pre and Pst hks in the Release Specific Packages. Nte : Main Package has the system-generated cde and shuld nt be mdified by the develper. Uplad Package Specificatin Uplad Package Bdy Uplad Packages wuld supprt adapter uplad flw f any Functin ID. The package will cntain cde t cnvert uplad table data t functin id specific PL/SQL cmpsite type. The main package f the functined wuld be called t uplad the data Ntificatin Triggers This will be generated nly fr ntificatin trigger screens. Refer 07- Develpment_WrkBench _ Ntificatins.dcx fr further reference 3.3 Hk Packages Kernel, Cluster and Custm Packages are the packages where the respective team can add business lgic in apprpriate functins using the Pre and Pst hks available. Kernel Package Spec Kernel Package Bdy 7
The Kernel package is slely fr the Kernel Team t mdify. The Main package has designated calls t the Kernel package fr executing any functinal checks r validatins included in the Kernel Package. All the user level validatins and cnditinal peratins shuld be included in Fn_Pst_Default_and_Validate. This functin is called frm the Main Package after the executin f Fn_Default_and_Validate. User shuld avid putting validatins r cde in any ther functin. In case user needs t add a separate functin, the existing Wrkbench generated structure shuld nt be changed. Instead the user can create a new package e.g. <MODULE>PKS_<FID>_UTILS package. The desired functin can be included in this package and the call can be made frm the Kernel Package. Cluster Package Spec Cluster Package Bdy The Cluster package is available t the Cluster Team t add any validatins r Checks specific t the Cluster Team ver and abve the Kernel Team. The Kernel Team r the Custm Team shuld nt mdify the cntents f this package. Custm Package Spec Custm Package Bdy The Custm package is available t the Custm Team nly t add any validatins r Checks ver and abve thse already present in the Kernel and Cluster Packages. 3.4 Meta Data Wrkbench generates INC files which cntains insert scripts. These are static data required fr the functining f the functin id. Develper needs t deply generated INC s in FLEXCUBE schema. Menu Details Under menu Details belw 4 table entry Insert Scripts will get generated. SMTB_MENU SMTB_FUNCTION_DESCRIPTION SMTB_ROLE_DETAIL SMTB_FCC_FCJ_MAPPING If any ne f table entry missing while designing new functin ID, FLEXCUBE wn t allw launching functin ID. Data surce Details Generates INC fr CSTB_FID_DATA_SOURCES. This data is required fr uplading data t FLEXCUBE fr the functin id thrugh excel. 8
Lv Details Generates INC fr CSTB_LOV_INFO. FLEXCUBE will be using this infrmatin t get data fr List f values prvided in the screen Blck Details Generates INC fr CSTB_FID_DATA_BLOCKS. This data is required fr uplading data t FLEXCUBE fr the functin id thrugh excel. Screen Details Generates INC fr CSTB_FID_SCREENS. Amendable details Generates INC fr belw table. These scripts prvides infrmatin regarding the amendable fields in the screen.entry has t be present fr the required field in these tables in rder t make that field amendable thrugh FLEXCUBE and gateway peratin. GWTM_AMEND_MASTER GWTM_AMEND_NODES GWTM_AMEND_FIELDS GWTB_AMEND_NODES GWTB_AMEND_FIELDS Call frm Details Generates INC fr CSTB_CALL_FORM_NODES. These will be generated nly if the screen is a Call Frm. It is required fr attaching the particular Call frm t any ther functin id. Summary Details Generates INC fr CSTB_SUMMARY_INFO. Dat in this table is required fr fetching recrds in the summary screen f the particular functin id. Label Details Generates INC fr CSTB_FIELD_LABELS and CSTB_OTHER_LABELS. Labels can be used fr Language translatin f screens. These scripts prvides infrmatin regarding the label cdes attached t each field. These are useful while develping language packs fr FLEXCUBE CSTB_FIELD_LABELS Cntains Field Label details. CSTB_OTHER_LABELS Cntains SCREEN, TAB, FIELDSET, BLOCK etc label details. Nte that Wrkbench des nt generate scripts fr CSTB_LABELS. Data in CSTB_LABELS is maintenance required fr the Tl. Blck Pk Clumns Generates INC fr STTB_AUDIT_PK_COLS. Functin Call Frms Generates INC fr CSTB_FID_CALLFORMS. This data is required fr uplading data t FLEXCUBE fr the functin id thrugh excel. Gateway Details Generates INC fr belw tables. Data in these tables are required fr gateway peratins (web services) fr the particular screen GWTM_FCJ_FUNCTIONS GWTM_OPERATIONS_MASTER Ntificatin Details Generates INC fr belw tables. Ntificatin INCs will get generated nly fr Ntificatin screens GWTM_NOTIFICATION_TRIGGERS GWTM_NOTIFICATIONS_MASTER 9
Functin parameters Generates INC fr belw tables. This INC gets generates nly fr Reprts screens (i.e. Functin Categry Reprt). AETB_FUNC_MASTER AETB_FUNC_DETAIL Purge Details Generates INC fr belw tables. These scripts will be generated nly fr Purge Entity Definitins screens STTM_PURGE_MASTER STTM_PURGE_TBL_DETAILS STTM_PURGE_FILTERS 3.5 Others Xsds The XSD files are used fr the creatin f xmls, which are in turn used during the executin f peratins thrugh Gateway. Xsds with Anntatin Xsds will be generated with anntatins. This can be used fr dcument creatin f any Web Service Screen html The HTML files are used t take screen shts by cnverting them t images, which in turn used fr Dcument preparatin. Uplad Table Trigger Trigger will be generated fr inserting recrds int adapter uplad prcess tables (CSTB_EXT_CONTRACT_STAT,STTB_UPLOAD_MASTER) frm uplad tables. Uplad Table definitin DDL fr uplad tables wuld be generated. If existing uplad tables are being re used, the generated DDL s can ignred Archive Table definitin DDL fr archival tables wuld be generated fr Purge Entity Radxml. Synnyms fr the tables wuld als be generated. Nte: Fr new screen all file ptins will be checked autmatically. Fr mdificatin nly system generated files will be checked, based n user requirement can pt fr ther file generatin. 4 Deplyment Wrkbench generated files can be deplyed directly t the applicatin server and schema. Frnt-end files get cpied t desired lcatin which user has maintained while adding envirnment details. Database files get cmpiled t FLEXCUBE schema which is specified in the wrking envirnment. 4.1 Prerequisites: The belw maintenance is required t use the deply ptin. In envirnment user has tw ptins t cpy files based n the perating system FLEXCUBE applicatin is running. 10
Windws : File Cpy / FileManager Unix : FileManager FileManager Servlet needs t deply in applicatin server where FLEXCUBE is running. Refer File manager sectin in 02-Develpment_WrkBench _Administratin.dcx t get mre details abut file manager. Fig 4.1: The Envirnment Details In envirnment creatin belw details are mandatry t use deply ptin. Applicatin Operating System Unix/Windws Applicatin Transfer Type Windws File Cpy/FileManager UNIX FileManager JS Directry Path : Enter the shared path f JS files. Uixml Directry Path: Enter Shared path f Language Xml files. Nte: If appliactin server is windws user can enter abslute path. 11
4.2 Deply Files: Click Deply buttn as shwn in belw image. 4.2: The deplyment Screen Fig Select required files t deply.click deply buttn. On success full deplyment user will get status as Deplyed. 12
5 Release Fig 4.3: Deplyment f selected files Release feature f Wrkbench is applicable nly fr develpers within Oracle Financials. It invlves the integratin the Tl with ther in huse tls (repsitry/versin cntrl tls) Oracle FLEXCUBE Develpment Wrkbench is integrated with SVN. 5.1 SVN Integratin Nw, Wrkbench prvides an interface t release the units generated t SVN The fllwing prerequisite shuld be adhered t befre attempting t release units t SVN 1) SVN Repsitry URL shuld be prvided in the Preferences Nde f Functin Id against field SVN Repsitry URL. Path till the mdule name has t be given. Example:- Fr an FT mdule RADXML path can be given as Z:\FCUBS_11.3.0\Sft\MAIN\FT 13
Fig 5.2.1: Preferences Screen highlighting SVN Repsitry URL The fllwing files can be released t SVN thrugh Develpment Wrkbench: 1) RADXML 2) Main Package(spc and sql) Frm the release screen check n the units t be released t SVN and click OK.SVN credentials has t be prvided in the screen. SFR number has t be prvided if it is nt a simple check in. If checked in successfully, status will be displayed as released. 14
[May] [2016] Versin 12.2.0.0.0 Oracle Financial Services Sftware Limited Oracle Park Off Western Express Highway Gregan (East) Mumbai, Maharashtra 400 063 India Wrldwide Inquiries: Phne: +91 22 6718 3000 Fax:+91 22 6718 3001 www.racle.cm/financialservices/ Cpyright 2007, 2016, Oracle and/r its affiliates. All rights reserved. Oracle and Java are registered trademarks f Oracle and/r its affiliates. Other names may be trademarks f their respective wners. U.S. GOVERNMENT END USERS: Oracle prgrams, including any perating system, integrated sftware, any prgrams installed n the hardware, and/r dcumentatin, delivered t U.S. Gvernment end users are "cmmercial cmputer sftware" pursuant t the applicable Federal Acquisitin Regulatin and agency-specific supplemental regulatins. As such, use, duplicatin, disclsure, mdificatin, and adaptatin f the prgrams, including any perating system, integrated sftware, any prgrams installed n the hardware, and/r dcumentatin, shall be subject t license terms and license restrictins applicable t the prgrams. N ther rights are granted t the U.S. Gvernment. This sftware r hardware is develped fr general use in a variety f infrmatin management applicatins. It is nt develped r intended fr use in any inherently dangerus applicatins, including applicatins that may create a risk f persnal injury. If yu use this sftware r hardware in dangerus applicatins, then yu shall be respnsible t take all apprpriate failsafe, backup, redundancy, and ther measures t ensure its safe use. Oracle Crpratin and its affiliates disclaim any liability fr any damages caused by use f this sftware r hardware in dangerus applicatins. This sftware and related dcumentatin are prvided under a license agreement cntaining restrictins n use and disclsure and are prtected by intellectual prperty laws. Except as expressly permitted in yur license agreement r allwed by law, yu may nt use, cpy, reprduce, translate, bradcast, mdify, license, transmit, distribute, exhibit, perfrm, publish r display any part, in any frm, r by any means. Reverse engineering, disassembly, r decmpilatin f this sftware, unless required by law fr interperability, is prhibited. The infrmatin cntained herein is subject t change withut ntice and is nt warranted t be errr-free. If yu find any errrs, please reprt them t us in writing. This sftware r hardware and dcumentatin may prvide access t r infrmatin n cntent, prducts and services frm third parties. Oracle Crpratin and its affiliates are nt respnsible fr and expressly disclaim all warranties f any kind with respect t third-party cntent, prducts, and services. Oracle Crpratin and its affiliates will nt be respnsible fr any lss, csts, r damages incurred due t yur access t r use f third-party cntent, prducts, r services. 15