Desktop Integrators -

ou Mean I Can Load Data

Stra|ght from a Spreadsheet?
resenLed by: Lee 8rlggs
CoordlnaLor, Aul SlC
Cverv|ew
lnLroducuons
8ulldlng a CusLom lnLegraLor wlLh ueskLop lnLegraLor
C & A
About Lee 8r|ggs
Chalr of Lhe Aul SlC
ulrecLor, llnanclals ManagemenL racuce wlLh 8lz1ech
12 ?ears of Cracle Appllcauon lmplemenLauon experlence
llnanclals and Supply Chaln from 11.3.3 Lhrough 812.1.3
CusLom 8eporung uslng lSCs, C8lLL, and 8l ubllsher
Lxperlence wlLh cllenLs across all lndusLrles, wlLh a focus on
8uslness Servlces, rofesslonal Servlces and 8anklng
lndusLrles
Cracle Cerued SpeclallsL ln Ceneral Ledger and ayables
App||canon Desktop Integrator (ADI)
lnLegral parL of Cracle llnanclal Appllcauons
lnlually released as a sLand-alone appllcauon lnsLalled on a
cllenL pc
SpreadsheeL-based exLenslon of Ceneral Ledger and AsseLs
Lnables users Lo creaLe budgeLs, record nanclal
Lransacuons and run nanclal reporLs ln Mlcroso Lxcel
k12 - C||ent ADI |s De-Supported
Cracle SupporL noLe 377640.1 advlses LhaL CllenL/Server Aul
ls noL supporLed for 812
All lSC reporung wlLhln Cracle Appllcauons ls belng moved
Lo 8l ubllsher and 8eporL Manager
11.3.10 uocumenLauon for Ceneral Ledger no longer refers
Lo CllenL Aul, buL lnsLead dlrecLs users Lo use precongured
Web-Aul soluuons for !ournal uploads, 8udgeL uploads.
k12 - New Iuncnona||ty
Web Aul ls repackaged as ueskLop lnLegraLor
As well as pre-packaged lnLegraLors, provldes funcuonallLy
Lo now bulld cusLom lnLegraLors Lo load daLa Lo An?
lnLerface Lable or Al
S1L 1
kLAkA1ICN CI 1nL LNVIkCNMLN1
Creanng a Custom Integrator:
reparanon
8nL role Cpuons Prole Name Value
8nL Server Log Level 1race
8nL Server Log aLh $8nL_1C/log
8nL ServleL aLh /oa_servleLs/
8nL ulx 8ase aLh /CA_P1ML/cabo
8nL ulx hyslcal ulrecLory $CCMMCn_1C/webapps/oacore/hLml/cabo/
8nL upload lmporL ulrecLory $8nL_1C/upload/lmporL
8nL upload SLaglng ulrecLory $8nL_1C/upload
8nL upload 1exL ulrecLory $8nL_1C/upload
Creanng a Custom Integrator:
reparanon
8eplace $8nL_1C and $CCMMCn_1C wlLh Lhe acLual
values
WlLh u8A asslsLance, check Lhe followlng dlrecLorles exlsL
wlLh 777 permlsslons
$8nL_1C/log
$CCMMCn_1C/webapps/oacore/hLml/cabo
$8nL_1C/upload/lmporL
$8nL_1C/upload
Creanng a Custom Integrator:
reparanon
MosL lmporLanL preparauon up
Cnce Lhese prole opuons have been updaLed, bounce Lhe
Ln1l8L lnsLance (or use luncuonal AdmlnlsLraLor Lo clear
cache)
Asslgn your user Lwo responslblllues
ueskLop lnLegrauon Manager
ueskLop lnLegrauon
Creanng a Custom Integrator:
reparanon
Mlcroso Lxcel seLup
?ou must 1rusL Access Lo vlsual 8aslc ro[ecL
?ou must allow Macros Lo run
S1L 2
CkLA1L 1nL CUS1CM IN1LGkA1Ck
Creanng a S|mp|e Custom Integrator
no valldauon of daLa ln Lhe lnLegraLor
no look-ups
no conLenL
no cusLom upload parameLers
user enLers ALL daLa

Creanng a S|mp|e Custom Integrator
CreaLe Lhe lnLegraLor
uene Lhe lnLegraLor LayouL
SLarL Loadlng uaLa
Create the Integrator
8esponslblllLy: ueskLop lnLegrauon Manager
navlgauon: CreaLe lnLegraLor
Lnter Integrator Informanon
Lnter Integrator Informanon
lnLegraLor name
1he name of Lhe lnLegraLor as Lhe user wlll see lL
lnLernal name
1he name of Lhe lnLegraLor as Lhe sysLem sees lL
Appllcauon
1he name of Lhe module LhaL owns Lhe lnLerface Lable
Secur|ty ku|es
llrsL CoLcha (no menuon of SecurlLy 8ules ln
lmplemenLauon and AdmlnlsLrauon Manual)
Add Lwo SecurlLy luncuons
ueskLop lnLegrauon - CreaLe uocumenL (Code:
8nL_Aul_C8LA1L_uCCuMLn1)
CreaLe uocumenL (Code: 8nL_C8LA1L_uCCuMLn1)
Create the Interface
Create the Interface
lnLerface name
WhaL you wlll refer Lo Lhe lnLerface name as
lnLerface 1ype
SelecL from 1able, Al rocedure, Al luncuon
1able name
SelecL Lhe 1able name you wlll be populaung daLa
CC1CPA #2. Cllck on AL?!
Create the Interface
Create the Interface
Create the Interface
Cnce you've cllcked on Apply, every column from Lhe Lable
wlll be dlsplayed here
8est racnce - use forms personallzauon Lo lncrease
number of rows reLurned (23 per page by defaulL!)
8est racnce - ldenufy Lhe 8equlred llelds, and Lhe elds
you wanL.
8est racnce - SeL every oLher eld llsLed Lo noL dlsplay
Create Content
Create Up|oader L|st
Create Up|oader L|st
uploader LlsL (new ln 812.1.3) allows you Lo speclfy whaL
opuons are avallable Lo Lhe user upon upload
WhaL rows Lo upload (all, agged, eLc)
Pow Lhe rows are valldaLed
WheLher Lo lnvoke an lmporL process auLomaucally
Dehne Importer L|st
Dehne Importer L|st
lmporLer LlsL allows you Lo speclfy how Lo move uploaded
daLa from lnLerface Lables Lo base Lables
Allows you Lo apply valldauon rules Lo apply before lmporL
Lo base Lables
S1L 3
DLIINL 1nL SkLADSnLL1 LACU1
Dehne the Spreadsheet Layout
8esponslblllLy: ueskLop lnLegrauon Manager
navlgauon: uene LayouL
Dehne the Layout
Dehne the Layout
SelecL Lhe lnLegraLor for whlch you are denlng Lhe layouL
Cver 223 seeded lnLegraLors wlll also show ln Lhls llsL
Create the Layout
Create the Layout
LayouL name
?ou can have muluple ueskLop LayouLs for Lhe same
lnLegraLor
number of Peader 8ecords
uependenL on whaL you're Lrylng Lo accompllsh wlLh Lhe
daLa you're loadlng
Create the Layout
Create the Layout
Pere, you can conLrol where elds appear (Peader or llnes)
Lxample
A lnvolce Peaders lmporL
Cperaung unlL could be Lhe same for all lnvolce headers
lnvolce Currency could be Lhe same for all lnvolce headers
vendor would be dlerenL for each lnvolce header
Create the Layout
?ou can also defaulL lnformauon ln here, wheLher lLs
consLanL, derlved by SCL, on an envlronmenL varlable
uefaulL lnvolce currency Lo uSu
uefaulL user lnformauon
CreaLed 8y : lnu_CLC8AL.uSL8_lu
LasL updaLed 8y: lnu_CLC8AL_lu
LasL updaLe Logln: lnu_CLC8AL.LCCln_lu
Creauon uaLe: S?SuA1L
LasL updaLe uaLe: S?SuA1L
Create the Layout
CC1CPA #3
updaLes Lo Lhe layouL and lnLegraLors wlll noL always show
up once you've saved an re-querled Lhe layouL
u8A's wlll need Lo clear !ava cache on Lhe lnsLance aer
LvL8? change, or asslgn yourself luncuonal AdmlnlsLraLor
responslblllLy, and clear Lhe Cache yourself!!
S1L 4
S1Ak1 LCADING DA1A!
Start Load|ng Data!
8esponslblllLy: ueskLop lnLegrauon
navlgauon: CreaLe uocumenL
Start Load|ng Data - Se|ect the Integrator
Start Load|ng Data - Se|ect the V|ewer
Start Load|ng Data - Se|ect the V|ewer
vlewers lnclude varlous verslons of:
Mlcroso Lxcel
Mlcroso ro[ecL
Mlcroso Word
Moblle Sales ueploymenL for Wlndows
Start Load|ng Data - Se|ect the Layout
Start Load|ng Data - kev|ew your Cr|ter|a
Start Load|ng Data
MCkL 1nAN 1nL 8ASICS?
More than the 8as|cs - L|st of Va|ues
ComponenL
ComponenLs allow you Lo reLurn llsL of values for a eld
Lxample - LeL me presenL a llsL of all my A lnvolce 1ypes so l can
plck from Lhem, raLher Lhan havlng Lo Lype Lhe lnvolce 1ype (and geL
lL exacLly rlghL)
More than the 8as|cs - L|st of Va|ues
8esponslblllLy - ueskLop lnLegrauon Manager
navlgauon - Manage ComponenLs
More than the 8as|cs - L|st of Va|ues
More than the 8as|cs - L|st of Va|ues
Parameter Name Parameter Value
Table-column-alias INVOICE_TYPE_LOOKUP_CODE
Table-column-sort ASCENDING
Table-columns LOOKUP_CODE,MEANING,DESCRIPTI
ON
Table-headers Lookup Code,Meaning,Description
Table-select-column INVOICE_TYPE_LOOKUP_CODE
Window-caption Lookup Code,Meaning,Description
Window-height 500
Window-width 400
More than the 8as|cs - L|st of Va|ues
navlgauon - Manage lnLegraLors
SelecL Lhe lnLegraLor
SelecL Lhe lnLerface age
updaLe Lhe aurlbuLe for LlsL of values
More than the 8as|cs - L|st of Va|ues
More than the 8as|cs - L|st of Va|ues
Label Value
Validation Type Table
ID Column LOOKUP_CODE
Meaning Column LOOKUP_CODE
Desc Column DESCRIPTION
Validation Entity FND_LOOKUP_VALUES_VL
Where Clause (Nvl('', Territory_Code) = Territory_Code Or Territory_Code Is
Null) And Lookup_Type = 'INVOICE TYPE' And
(Lookup_Type='INVOICE TYPE') And (View_Application_Id=200)
And (Security_Group_Id=0) And Enabled_Flag = 'Y'
Component Name XXPC AP Invoice Type
LOV Type Standard
More than the 8as|cs - L|st of Va|ues
Any uesnons?
Lee 8r|ggs
Aul SlC CoordlnaLor
racuce ulrecLor, llnanclals
ManagemenL
L8r|ggsQ8|z1ech.com
1w|uer: Q81Lee8r|ggs
Coples of all Ceo/SlC 8esL of Weblnars" can be
found aL hup://oaug.org/communlues/weblnars