Using DOC1
Oracle Utilities Customer To Meter provides support for Pitney Bowes DOC1 for online/batch printing and online display, viewing of bills, letters, field orders, statements and quotes.
Please note that implementations can use either Oracle Documaker or DOC1 for their printing and display needs.
Supported DOC1 Version
At the time of release the supported version for Oracle Utilities Customer To Meter is:
Windows and Linux: DOC1 6.4.1.38
Prerequisite
Do not install DOC1 6.4.1.38 if Documaker 12.x already exists or installed on the same machine.
Configuring DOC1
1. Copy the Generate installer to DOC1 6.4.1.38 folder on the desired server.
Download the DOC1 software from the Piney Bowes website.
2. Uncompress the files to designated Generate folder.
Refer to folder hierarchy in UNIX:
• <SPL_BASE_FOLDER>/doc1_v6.4 > AppFiles
• <SPL_BASE_FOLDER>/doc1_v6.4 > generate
NOTE: Make sure you uncompress the contents under generate folder. Create the generate folder if does not exists.
UNIX:
cd <C2M_BASE_FOLDER>/doc1_v6.4/
unzip Generate_6.4Maint-lnx64-6.4.1.38.zip
cd "Generate Windows and UNIX 6.4 Maintenance 6.4.1.38"/lnx64/
cp -rp doc1lnx64host.tar <C2M_BASE_FOLDER>/doc1_v6.4/generate
cd <C2M_BASE_FOLDER>/doc1_v6.4/generate
tar xvf doc1lnx64host.tar
3. Uncompress using WinZip or 7zip to C:\spl\DOC1\generate.
4. Download the C2M configuration files from SVN and save it under DOC1 6.4.1.38 folder.
AppFiles should be at the same folder level of generate folder. For example:
UNIX:
/scratch/C2M/doc1_v6.4/AppFiles
Windows:
C:\spl\DOC1\AppFiles
NOTE: For Unix, make sure that you rename the AppFiles-Unix to AppFiles.
5. Make sure that FW_template_structure.xml under $SPLEBASE/structures has this entry.
<billdirfile.ini.template>
<dest_files>
<dest_file_1>@SPLEBASE@/etc/billdirfile.ini</dest_file_1>
</dest_files>
</billdirfile.ini.template>
<doc1dirfile.ini.template>
<dest_files>
<dest_file_1>@SPLEBASE@/etc/doc1dirfile.ini</dest_file_1>
</dest_files>
</doc1dirfile.ini.template>
6. Make sure that these two template files exists under $SPLEBASE/etc folder.
billdirfile.ini.template
doc1dirfile.ini.template
7. Make sure that the above templates files have the exact value.
#> cat billdirfile.ini.template
ONLINE BILL HOST=@ONLINE_DISPLAY_HOME@
ONLINE BILL TEMPLATE=@ONLINE_DISPLAY_HOME@@DIRSEP@AppFiles
BILL EXTRACT PATH=@SPLOUTPUT@@DIRSEP@
BILL IMAGE PATH=@SPLEBASE@@DIRSEP@splapp@DIRSEP@billView@DIRSEP@
BILL IMAGE SCRIPT=@ONLINE_DISPLAY_HOME@@DIRSEP@AppFiles@DIRSEP@@DOC1BILLSCRIPT@
URL PREFIX=/@WEB_CONTEXT_ROOT@/billView/
#> cat doc1dirfile.ini.template
ONLINE DOC HOST=@ONLINE_DISPLAY_HOME@
ONLINE DOC TEMPLATE=@ONLINE_DISPLAY_HOME@@DIRSEP@AppFiles
DOC EXTRACT PATH=@SPLOUTPUT@@DIRSEP@
DOC IMAGE PATH=@SPLEBASE@@DIRSEP@splapp@DIRSEP@billView@DIRSEP@
DOC IMAGE SCRIPT=@ONLINE_DISPLAY_HOME@@DIRSEP@AppFiles@DIRSEP@@DOC1SCRIPT@
URL PREFIX=/@WEB_CONTEXT_ROOT@/billView/
8. Make sure that the entries below are added to the WebLogic script setDomainEnv.sh.
# Setup display bill ini file - DOC1
ONLINEBILLINI=$SPLEBASE/etc/billdirfile.ini; export ONLINEBILLINI
ONLINEDOCINI=$SPLEBASE/etc/doc1dirfile.ini; export ONLINEDOCINI
ENVFILE=$SPLEBASE/etc/ENVIRON.INI; export ENVFILE
9. Declare the DOC1 6.4.1.38 base folder in the environment's ini file, $SPLEBASE/etc/ENVIRON.INI.
ONLINE_DISPLAY_HOME=/scratch/C2M/doc1_v6.4 # DOC1 6.4.1.38 base folder
10. Create the billView folder under $SPLEBASE/splapp
#> mkdir billView
#> chmod 777 billView
11. Update the license code of DOC1 6.4.1.38, keycode.ops, located under $DOC1HOSTDIR/AppFiles. (Example: /scratch/C2M/doc1_v6.4/AppFiles)
Enter all necessary information.
#> vi keycode.ops
Note: License code is different for each OS platform.
12. Initialize the environment to propagate the changes:
#> $SPLEBASE/bin/initialSetup.sh
#> %SPLEBASE%\bin\initialSetup.cmd
13. Reselect the environment in SPL Menu options or re-load the environment variables.
#> $SPLEBASE/bin/splenviron.sh -e $SPLENVIRON
14. Restart the Oracle Utilities Customer To Meter application/environment.
#> spl.sh -a stop
#> spl.sh -a start