NEOAUG

Custom Integrators

Web ADI

Agenda
Agenda Web ADI Custom Integrators
0 Creating an Integrator Creating an API Defining the Interface Defining an Importer 0 Wor ing around the bugs 0 Adding the Integrator to a !enu 0 !igrating 0 "roub#eshooting

Web ADI
%ots of he#pfu# error messages

&

O'er'ie(
An O'er'ie( of the Process from the End Users Point of
)ie( Access from a menu Item

O'er'ie(
Enter In'oice %ines (ith %O)+s for Important fie#ds

O'er'ie(
Up#oad data (ith )a#idation and AP Interface #aunch

O'er'ie(
A## of this from an E.ce# /preadsheet0

Integrator O'er'ie(

Custom Integrator for AP In'oice creation %oad In'oice %ines from spreadsheet
)a#idate and #oad interface tab#e Ca## AP Interface Import

P%3/4% API

Create a P%3/4% pac age to (or (ith the integrator

P%3/4% API

"he APIn' (i## 'a#idate each #ine of the spreadsheet6 and #oadprocedure the #ine into the interface tab#e0
Errors are communicated to the spreadsheet 'ia

7ou get &0 chars per #ine for an error message 7ou can define 8our o(n custom messages 7ou can a#so put p#ain te.t in p#ace of 9WE: ADI E;;O;+

<0

P%3/4% API
"he procedure (i## ca## the AP In'oice Interface6;unImport from the #ast step of the integrator0

<<

Integrator Integrator Information = Indicates re>ui?ed field Enter Int rator Information
= Integrator Name lxx AP In'oice %oad lxx_AP@IN)OICE@%OAD = Interna#Name

#n#erfaces

,...,_should COI"'bWW only upperase darxters'A-r, nl.mbers '0-9' and = App Aaoon yables I o@0
;eporting On#8 Enab#ed 7es

Ir :::J

J7 Disp#a8 in Create Document Page l::i:i!!Jtegrator parameters Up#oad /er'er Parameter Document Parameter /ession Parameter L ================ ================ O( nerA

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" 12

nerA O(nerA I Add I ]

!e"#rity $#les Bunction /e#ected Bunctions I

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" 1%

Integrator

0--------0---------- ---------- Interfaces Contents Up#oader

Importer

Integrator A CC@WE:ADI PDG

Interfa"es: &reate Interfa"e

I &an"el I I 'a"( I !tep 2 of ) I *

I I !#bmit I

== Interfa"e Interfa"e*ame 0ype

I +,,_AP_I*-.I&E_L.A/ API Pro"ed #re ::::J

:

= Pro"ed #re45#n"tion pin6 *ame lar lxx_1E'A/I_P23 = Pa"(age

*ame API $et#rns EAppFi G:&an"e"9

5*/ 7essage &ode 88:89

I &an"el I

'a"( I !tep 2 of ) I *

!#bmit O;AC%E? Plat in#m Partner

MONUMENT

DA"A /O%U"ION/

<&

Interface A A4H00@PDG AP;I eturns IBND !essage Code :::J EFInterface Attributes EAdd Attribute ##'ie( Groups I Attribute Name Prompt %eft Attribute "8pe P@BAOU"7 IBAOU"7
P@"O"A%@B;EIGI" IG%@CODE I"O"A%@B;EIGI"

Data "8pe Enab#ed Update De#ete strni g 5 5

strni g

Disp#a8ed Defau#t "8pe Defau#t )a#ue

:::J :::J
:::J

;ea#
;ea#

P@G@#CODE

/tr ng
strni g /trni g

5
5 5

5
5 5

;ea#
;ea# ;ea#

h
l/J

P@"O"A%@"AC P@UNE@B;EIGI"

I"O"A%@"AC #uNE@B;EIGI" IUNE@"AC IUNE@A!"

.&
.1&

ni#
#iF

P@UNE@"AC
P@UNE@A!"

strni g strni g
.t&

5 5
#iF
5 5

5 5 string
5 5

P@I"E!@DE/C;IP"ION
;ea# P@IN)OICE@A!OUN" ACCOUN"ING@DA"E

II"E!@DE/C;IP"ION

P@IN)OICE@UNE@NU!:E;

:::J 5 5 IIN)OICE@UNE@NU!:E strni g

;ea#

;ea# ;ea#

;
5 Jots 5 5
g

:::J IIN)OICE@A!OUN"
ICOUN"ING@DA"E

;ea#
strni g string

MONUMENT
Platinum Partner

P@IN)OICE@NU!:E;

IIN)OICE@NU!:E;

:::J

;ea#

/trni g

ni# 5

DA"A /O%U"ION/

ORACLE" 1<

;ea#
P@)ENDO;@/I"E@CODE P@)ENDO;@NA!E P@)ENDO;@NU!:E; I)ENDO;@/I"E@CODE #'ENDO;@NA!E I)ENDO;@NU!:E;

=8>
/trni g

#iF 5

:::J
:::J

;ea#

811?!1

u
ni#

strni g
strni g

5
5

5
5

;ea#
;ea#

.t& .1&

EAdd Attribute ##'ie( Groups I

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" 17

Integrator J /tep$
Bi. the Prompt Names0 Define defau#ts and 'a#idation ru#es for each co#umn0 C#ic /ubmit from here6 NO" Ne.t or 8ou+## most #i e#8 #ose e'er8thing to a Nu## pointer e.ception0 7ou can go bac and update this #ater0

<,

/preadsheet E.amp#e
"he spreadsheet so far

<-

Integrator J /tep$
)a#idating Co#umns %ets 'a#idate the )endor Name before it reaches the P%3/4% API

<1

Integrator J /tep$
An in'a#id 'a#ue (i## get 8ou the fo##o(ing on the spreadsheet0

%ets a#so add an %O) Go to Des top Integration !anagerKLCreate Component

<2

Integrator J /tep$

"ab#eKse#ectKco#umn te##s e.ce# (here to p#ace the 'a#ue 8ou se#ect in the spreadsheet0 7ou reference the name of the co#umn6 from the parameter name6 not the name 8ou put in the

spreadsheet0

<5

Integrator J /tep$
:ac into the Integrator definition6 /tep $6 c#ic update on the )endor Name fie#d

$0

Integrator J /tep$
Adding a Ca#endar %O) to the Accounting Date fie#d Create another component

$<

Integrator J /tep$
Adding a Ca#endar %O) to the Accounting Date fie#d Change the height from ,00 to &006 other(ise the dia#og (i## contain A %O" of (hitespace0 Go bac to the definition6 choose update for Accounting Date

$$

Integrator J /tep$

Bor Component name6 enter the e.act name6 this fie#d doesn+t (or (ith (i#d cards0

$&

Integrator J /tep$
:ac to the spreadsheet

$*

Integrator J /tep*
/tep * Create an Up#oader0 Fust ta e defau#ts0

$,

Up#oad Page

U load Parameters

r- A## ;o(s ;o(s to Up#oad (' B#agged ;o(s

)a#idate :efore Up#oad

w- r0lmport AAM AiH#A i@ill Ii7A0be A0NA a#tomati"ally AiH#A0iAA -AP0A s#bmitted on s#""essf#l "ompletion of tAe #pload
Mpload I I I Cop8nght $00,6 Orade CO#poOation

lose

OE,er'ed

A## rights

MONUMENT
DA"A /O%U"ION/

26

ORACLE"

Platinum Partner

Integrator J /tep,
/tep , define an up#oader We#come to the :uggiest /creen E'erH Depending on 8our #e'e# of #uc 6 8ou+## get through this step0 If 8ou didn+t 8ou+## need to ha'e the end user schedu#e the import process manua##80

$1

Integrator J /tep,

NoteA (hen 8ou ma e a se#ection from the importer t8pe dropdo(n the importer ru#es section shou#d sho( up0 If it doesn+t6 start patching0

$2

Integrator ACC WE:ADI PDG ImporterAConcurrent Program ;e>uest /ubmission API"8peP%3/4% Bunction Pac age Name ..@(ebadi@p g Procedure3Bunction runimport I
;eturn Name )a#ue

Cance#

I :ac

I /tep , of ,

/ubmit I

-A$&BA$2

I ;eturns error information

API ;eturns

BND !essage Code 00AF

No0Name Data "8pe /iPe Access

No resu#ts found0 E AppF7G De#ete?FI Canc??c#G

Erro Defau r #t !essag )a#ue e

!odifi er /ource )a#ue%oo up C#ause

MONUMENT
DA"A /O%U"ION/

29

O;AC%E?

P#atinum Par tner

Integrator J /tep,
"r8 /8nchronous or As8nchronous and 8ouQ## end up (ith this error from e.ce#

&0

%a8out
Create a #a8out for ho( this #oo s in E.ce#

&<

ptiona#Bie#ds

/e#ect the optiona# fie#ds to inc#ude in 8our document and their p#acement0 /e#ect A## I/e#ect None
/e#ect Bie#d Name P#acement Defau#t )au# e

Defau#t "8pe

IEG $;; )ENDO;@NA!E

)ENDO;@NU!:E;

I%ine
I%ine

rKKKKKKKKKINone

::J
88:J

$;; )ENDO;@/I"E@CODE I%ine 00AF IN)OICE@NU!:E; I%ine

00AF 00AF
$;;

H Non e H Non e H Non e

88:J

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" CD

$;; COUN"ING@DA"E

I%ine

$;; IN)OICE@A!OUN" $;; IN)OICE@##NE@NU!:E; I%ine $;; I"E!@DE/C;IP"ION

I%ine I%ine
I%ine I
%ine I%ine

00AF

INone

::J

88:J

$;;

# #NE@A!"

00AF 88:J 00AF 88:J 00AF 0KKKKKKKKKK6None

$;; # #NE@"AC $;; ##NE@B;EIGI" $;; "O"A%@"AC $;; "O"A%@B;EIGI"

88:J

$;;

G%@CODE

I I%ine I %ine
%ine I%ine

88:J 0KKKKKKKKKKHNone
00AF

::J
88:881
E

$;; BAO##"7

88:J ::J

r1

None

I Cance# IIH#ac I I Ne.t I I App8# I

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" CF

Adding to a !enu
"o /imp#if8 na'igation for user6 add the ne( integrator direct#8 to a menu
/(itch to the RDes top IntegrationS responsibi#it8 Choose Create Document and se#ect the integrator that 8ou created

&&

J---------------{f--------------4 ------------)
)ie(er %a8out Content ;e'ie(

/e#ect the app#ication on 8our des top that (i## be used to 'ie( the document0If;eporting lnt. is chec z.ns ed6the document 8ou create (i## not a##o( up#oad0
)ie(er

r ;eporting

I cance# I I

I I 0HHe.t I

;e'ie(

) Integr ator

.)
)ie(er

%a8out

Content

;e'ie(

Document Creation ;e'ie( "he fo##o(ing parameters (i## be used to create 8our document0 "he )ie(er (i## automatica##8 #aunch (hen 8ou press the Create Document button0Press the :ac button to ma e changes0Press the /a'e button to sa'e these se#ections to a Create Document /hortcut0 Integrator CC AP In'oice %oad )ie(er E.ce# $001 ;eporting##o

MONUMENT

Platinum Partner

DA"A /O%U"ION/

ORACLE" )1

%a8out "est
Content #Oi#E

I cance# I I c II
Choose Sa e

'e

I ICreate Document

MONUMENT
Platinum Partner

DA"A /O%U"ION/

ORACLE" )2

/a'e 8our se#ections to a shortcut that (i## appear at the beginning of the Create Document Page B#o(0 /teps in the page f#o( containing these se#ections (i## be s ipped (hen the shortcut is used0 Short!ut "ame Enter the name of 8our shortcut0 /hortcutName ArPi n'ioec%oadKKKKKKKKKKK KKKKKK Short!ut Lo!ations 7our shortcut can be sa'ed to a shortcut #ist that appears on the first page of the Create Document Page B#o(0 f 8ou ha'e the s8stem administrator responsibi#it868ou can sa'e these se#ections to a form function that can be attached to /e#f /er'ice menu0 r /a'e to /hortcut %ist P" /Ao'e to Borm Bunction settin#s Choose the /ettings to be sa'ed0 /ettings not sa'ed (i## need to be chosen in the page f#o( (hen the shortcut is used0 Integrator P" $$ AP %n oi!e Load

)ie(er ;eporting P" llo %a8out Test Content *) IIONE Do Not Disp#a8 ;e'ie( Page P"

P" E&!el '(()

P"

I !an!el I I !-I I Apply I

MONUMENT
DA"A /O%U"ION/

+,

ORACLE"

Platinum Partner

Adding to a !enu

Bind it in the database (ith

&-

Adding to a !enu
%ets add it to Pa8ab#es Uses !enu AP@NA)IGA"E@GUI<$

&1

(.ra"le Appli"ations B.B0E!0 17 !ep 2?1? Ei#e dit TUie( Bo#der "oo#s TQHindo( tHe#p G
HI

.o!uments Pro!esses AP In'oice %oad

V %n oi!es

"o "en %ist

V Pa8ments V !!ount "n# V /upp#iers V Credti Cards V /etup V Wor f#o( V Other AP #n'orce %oad
V Emp#o8ees

18 %n oi! es

28 ;e>uestsA /ubmit
&0 In'oic e :atche s

C8 /uppi#ers

,0 Pa8ab#es Pa8ment !anager Iome -0 Orac#e Pa8ments /etup Page

78 :an and :an :ranch !aintenance

20 Pa8ments

ta.!om/0(((1 (A234r56L1 0ne emplateRedlre!tSer e

!e le At1p:44mo888 P AAAF WI t . rnondata8"om

A file (i## be do(n#oaded to 8our des top0 When prompted6choose to open the fie and to enab#e macros0If no prompt appears6ensure 8our bro(ser securit8 settings a#o( fles to be do(n#oaded0 ;eturn Copyn#ht '((,7 Ora!le CorporatiOn A%n#hts reser ed Do 8ou (ant to open or sa'e WebAO0.I#s U&1$ D:X from monhost0mondata0comY
XZ

!a6

B
ORACLE"
Platinum Partner

MONUMENT
DA"A /O%U"ION/

%D

!igrating
!igrating Do(n#oad BND%OAD apps3apps 0 7 DOWN%OAD N:NE@"OP3admin3import3bneint0#ct ..@ap@in'@#d0#dt IN"EG;A"O;@A/N[/4%AP IN"EG;A"O;@CODE[CC@WE:ADI@PDG@CIN"G

:NE@IN"EG;A"O;/

Up#oad BND%OAD apps3apps 0 7 UP%OAD N:NE@"OP3admin3import3bneint0#ct ..@ap@in'@#d0#dt 7ou (on+t be ab#e to edit the integrator0

&5

!igrating
!igrating "his on#8 get+s 8ou some of the integrator0 to #oad the Components and the %a8out definitions separate#80 "he Up#oader step is missing0 7ou a#so need

Orac#e is mo'ing to(ards using #ct+s at N:NE@"OP3patch3<<,3import3= bneintegrators0#ct doesn+t function in m8 instance0 /ee patchA

Patch <0&2,5,,A BND%OAD U/ING :NEIN"EG;A"O;0%C" DOE/ NO" INC%UDE :NE@IN"EG;A"O;/@:0/OU;CE

*0

"roub#eshooting
Change %og %e'e# to R";ACES6 noteA no %O) here0 ;estart the Apache /er'er or 8ou+## ne'er see an8thing\ "hat+s NAD!IN@/C;IP"/@IO!E3adoacorect#0sh stop 7ou can 'ie( the #og from the front end atA httpA33hostnameAportnumber3OA@I"!%3:ne Admin/er'#et %ogin as s8sadmin first

*<

"roub#eshooting
"he /er'#et ma8 not recogniPe 8ou+re the s8sadmin

/eems 'er8 sensiti'e to user s(itching #ogins0

A#so seeA Ora!le 8eb Appli!ations .es-top %nte#rator 98eb A.%: 4ips *or 4roubleshootin# 9.o! %. +;(<)=.6:

*$

"roub#eshooting
Don+t be (hat+s going on afraid to open the !acro itse#f to see
Brom E.ce#6 choose )ie(KL!acrosKLEdit

*&

"roub#eshooting
A#though 8ou are the interface definition6 it (on+t (or a##o(ed to de#ete co#umns from

"here it is0 Into the bac end to remo'e the Co#umns that I de#eted through the GUI0 Bind the ;ecords in bne@param@#ist@items6 and remo'e them

**

4uestions

Ans(ers

Discussion

Don :ro(ne Don0:ro(ne^monumentdata0com -0&05,$0*-*< (((0monumentdata0com

*,