-----------------------------------------------------------------------------------------------
-- CLEAN_Address() Oracle Forms Integration v1.0.0.0 November 13, 2013
--
-- Description:
-- Integration Package, Scripts, and Reports for address and telephone verification with Oracle
-- forms.  This is a functional guide to assist clients with implementing CLEAN_Address with 
-- Oracle forms
-- 
--
-- NOTE: To download the latest version of this package, paste this link into a web browser:
--       http://ftp.runnertech.com/ftpcln/patches/clnaddr_oracle_forms_package.zip
--
--
-- Oracle Forms is a trademark of Oracle Corporation
-- CLEAN_Address() is a trademark of Runner Technologies, Inc.
--
-----------------------------------------------------------------------------------------------
-- Copyright (c) 2004-2013 Runner Technologies, Inc.  All Rights Reserved.
-- www.RunnerTechnologies.com   sales@RunnerTechnologies.com   877-784-0003  561-395-9322
-----------------------------------------------------------------------------------------------

-----------------------------------------------------------------------------------------------
Pre-Installation Requirements
-----------------------------------------------------------------------------------------------

Follow the CLEAN_Address installation instructions to install the CLEAN_Address server and
CLNADDR schema.  See the readme.txt in the root of the CLEAN_Address CD for more details.

-----------------------------------------------------------------------------------------------
Installation
-----------------------------------------------------------------------------------------------

1) Grant access from the CLNADDR schema to your application schema:

   clnaddr:SQL> grant execute on CLEAN_Address    to <YOUR APP> with grant option;
   clnaddr:SQL> grant execute on CLN$Lookup       to <YOUR APP> with grant option;
   clnaddr:SQL> grant select  on CLN_Postal_Codes to <YOUR APP> with grant option;

2) Load the CLEAN_Address_APP package found under the pkg folder into <YOUR APP> schema after 
   CLEAN_Address is installed.Ignore any package erros if installing for the first time because the 
   CLEAN_Address_APP package is dependent on the User Exit package in step 3 below.

   From the "pkg" directory, run:

   <YOUR APP>:SQL> @loadpkg.sql

   NOTES:
     A) * Please make sure you have CLEAN_Address 3.6.0 or greater installed before installing
          the CLEAN_Address_APP package.  You can check the current version of the server
          by starting clnaddrd.exe from the command line or opening up the log file.
        * Also confirm the CLEAN_Address package in the database is at 3.6.0 or greater by
          looking at the package spec
        * If running a version of clnaddrd below 3.6.0, please contact Runner Technologies
          support for an updated version.

3) Load the User Exit package for custom business rules: CLEAN_Address_APP_UE
   * You can modify the default parameters and standards for address and telephone verification
     within the CLEAN_Address_Advance_UE package body.

   NOTE: The user exit package should ONLY be loaded ONCE since this contains your custom
         settings and business rules.

  <YOUR APP>:SQL> @loadpkg_user_exit.sql

4) Create a public synonym for "CLEAN_Address_APP"

  <YOUR APP>:SQL> create public synonym CLEAN_Address_APP for <YOUR APP>.CLEAN_Address_APP;

