Beruflich Dokumente
Kultur Dokumente
CardConnect
Oracle Personalizations
1
Change Record110
Reviewers
Name Position
Distribution
2
Contents
Prerequisites ............................................................................................................................. 4
Oracle Personalizations ........................................................................................................... 5
Order Management -Sales Orders......................................................................................... 7
Order Management -Quick Sales Orders............................................................................ 24
Payments ................................................................................................................................ 43
Receivables - Transactions ................................................................................................... 52
Receivables - Receipts .......................................................................................................... 65
Service Contracts ................................................................................................................... 78
Advanced Collections ............................................................................................................ 92
Appendix A – Determining Ingenico Device Comm Port ............................................ 106
Appendix B - Internet Explorer Settings .......................................................................... 109
Open and Closed Issues & Action Items .......................................................................... 110
Open Issues/Action Items ........................................................................................... 110
Closed Issues/Action Items......................................................................................... 110
References ..................................................................................................................... 110
3
Prerequisites
To utilize the personalizations below, you must first perform all steps in the MD120 supplied
during the CardConnect implementation. In addition to these steps, you must set the XXPPS:
Tokenizer Mode profile option to the desired value. These may be set at the Site,
Responsibility, and/or User level. We recommend that you set a default at the site level.
4
Oracle Personalizations
Form Personalization is a feature in Oracle EBS that allows us to change the behavior of Forms-
based screens, including changing properties, executing built-ins, displaying messages, and
adding menu entries.
This document defines the steps to setup the personalization’s that needed for Order
Management and Receivable modules in Oracle EBS. The Personalizations to oracle EBS forms
other than the sales order and transactions forms would follow a similar procedure.
To enable access to forms personalization function we need to set below profile option.
Utilities:Diagnostics -> Yes / No
It determines the diagnostics option is enabled for a user / responsibility or site, depending on
the level profile option is set.
Navigate to System Administrator -> Profile -> System
Query for your user / responsibility for which you want to provide access.
5
Set the value to ‘Yes', if you want allow access to forms personalization.
6
Order Management -Sales Orders
Please navigate to Order Management Super User responsibility and access Sales Orders
form (Navigation: Order Management Super UserSales Orders)
7
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
8
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
9
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
10
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
11
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:ORDER.INVOICE_TO_CUSTOMER_ID,:ORDER.INVOICE_TO_ORG_
ID,:ORDER.TOTAL) from dual
12
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
13
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
14
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): ORDER
15
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation message
Level: Form
Enabled: Checked
16
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT xxppsutil.get_validation_message(:order.invoice_to_org_id,ex.instr_assignment_id,
p.receipt_method_id) from oe_payments p, iby_fndcpt_tx_extensions ex where header_id =
:ORDER.HEADER_ID and line_id is null and payment_level_code = 'ORDER' and
p.payment_type_code = 'CREDIT_CARD' and p.payment_collection_event = 'INVOICE' and
p.trxn_extension_id = ex.trxn_extension_id
17
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
18
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
19
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message - save required
Level: Form
Enabled: Checked
20
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Warn
Message Text: =select 'Card validation unavailable. Please save the record prior to
validation. Would you like to save now?' from dual
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: DO_KEY
Argument: COMMIT_FORM
21
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=select 'Record Not Saved' from dual where :SYSTEM.RECORD_STATUS != 'QUERY' union
SELECT xxppsutil.get_validation_message(:order.invoice_to_org_id,ex.instr_assignment_id,
p.receipt_method_id) from oe_payments p, iby_fndcpt_tx_extensions ex where header_id =
:ORDER.HEADER_ID and line_id is null and payment_level_code = 'ORDER' and
p.payment_type_code = 'CREDIT_CARD' and p.payment_collection_event = 'INVOICE' and
22
p.trxn_extension_id = ex.trxn_extension_id and :SYSTEM.RECORD_STATUS = 'QUERY'
23
Order Management -Quick Sales Orders
Please navigate to Order Management Super User responsibility and access Quick Sales
Orders form (Navigation: Order Management Super UserSales Orders)
24
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
25
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
26
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
27
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
28
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:ORDER.INVOICE_TO_CUSTOMER_ID,:ORDER.INVOICE_TO_ORG_
ID,:ORDER.TOTAL) from dual
29
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
30
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
31
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): ORDER
32
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation Message
Level: Form
Enabled: Checked
33
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT xxppsutil.get_validation_message(:order.invoice_to_org_id,ex.instr_assignment_id,
p.receipt_method_id) from oe_payments p, iby_fndcpt_tx_extensions ex where header_id =
:ORDER.HEADER_ID and line_id is null and payment_level_code = 'ORDER' and
p.payment_type_code = 'CREDIT_CARD' and p.payment_collection_event = 'INVOICE' and
p.trxn_extension_id = ex.trxn_extension_id
34
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
35
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
36
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message - save required
Level: Form
Enabled: Checked
37
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Warn
Message Text: =select 'Card validation unavailable. Please save the record prior to
validation. Would you like to save now?' from dual
38
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: DO_KEY
Argument: COMMIT_FORM
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
39
Message Text:
=select 'Record Not Saved' from dual where :SYSTEM.RECORD_STATUS != 'QUERY' union
SELECT xxppsutil.get_validation_message(:order.invoice_to_org_id,ex.instr_assignment_id,
p.receipt_method_id) from oe_payments p, iby_fndcpt_tx_extensions ex where header_id =
:ORDER.HEADER_ID and line_id is null and payment_level_code = 'ORDER' and
p.payment_type_code = 'CREDIT_CARD' and p.payment_collection_event = 'INVOICE' and
p.trxn_extension_id = ex.trxn_extension_id and :SYSTEM.RECORD_STATUS = 'QUERY'
40
Create a new record and enter the following,
Seq: XXXXX
Description: Tokens Only! Display message when clear text credit card is entered
Level: Form
Enabled: Checked
41
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Error
Message Text:
=select 'Please be sure you have entered a token value!'
from dual
42
Payments
Please navigate to Order Management Super User responsibility and access Sales Orders
form (Navigation: Order Management Super UserSales Orders). Query an existing order or
create a new order and save. Click on action button and select “Payments”
43
44
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
45
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
46
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
47
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
48
Create a new record and enter the following,
Seq: XXXXX
Description: Tokens Only! Display message when clear text credit card is entered
Level: Form
Enabled: Checked
49
50
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Error
Message Text:
=select 'Please be sure you have entered a token value!'
from dual
51
Receivables - Transactions
52
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
53
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
54
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
55
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: From
Enabled: Checked
56
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:TGW_HEADER.BILL_TO_CUSTOMER_ID,:TGW_HEADER.BILL_TO_
SITE_USE_ID,:TLIN_CONTEXT.TRX_TOTAL) from dual
57
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
58
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
59
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): TGW_HEADER
60
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation message
Level: Form
Enabled: Checked
61
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT
xxppsutil.get_validation_message(:TGW_HEADER.BILL_TO_SITE_USE_ID,ex.instr_assignment
_id, :TGW_HEADERS.RECEIPT_METHOD_ID) from iby_fndcpt_tx_extensions ex where
ex.trxn_extension_id = :TGW_HEADERS.PAYMENT_TRXN_EXTENSION_ID
62
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
63
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
64
Receivables - Receipts
65
66
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
67
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
68
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
69
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:RGW_FOLDER.CUSTOMER_ID,:RGW_FOLDER.CUSTOMER_SITE_
USE_ID,:RGW_FOLDER.M_AMOUNT_DSP) from dual
70
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
71
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
72
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): RGW_FOLDER
73
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation message
Level: Form
Enabled: Checked
74
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT
xxppsutil.get_validation_message(:RGW_FOLDER.CUSTOMER_SITE_USE_ID,ex.instr_assignme
nt_id, :TGW_HEADERS.RECEIPT_METHOD_ID) from iby_fndcpt_tx_extensions ex where
ex.trxn_extension_id = :RGW_FOLDER.PAYMENT_TRXN_EXTENSION_ID
75
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
76
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
77
Service Contracts
Please navigate to a Service Contracts responsibility and access the Launchpad under
Contract Administration (Navigation example: Service Contracts AdministrationContract
AdministrationLaunchpad)
Create a new contract or access an existing one to access the Service Contracts Authoring
form.
78
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
79
80
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
81
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
82
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
83
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:OKS_HEADER.BILL_TO_CUST_ACCT_ID1,:OKS_HEADER.BILL_TO
_SITE_USE_ID,:OKS_HEADER.TOTAL) from dual
84
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
85
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
86
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): OKS_HEADER
87
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation message
Level: Form
Enabled: Checked
88
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT xxppsutil.get_validation_message(:OKS_HEADER.BILL_TO_SITE_USE_ID,
:OKS_HEADER.INSTR_ASSIGNMENT, null) from dual
89
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
90
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
91
Advanced Collections
Query an existing customer with open transactions, select a transaction, and click Payment
Processing to access the Processing Payment form.
92
Navigate to Help -> Diagnostics -> Custom Code -> Personalize
93
94
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked
95
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU1
Menu Label: CardConnect Tokenizer
Render line before menu: Checked
Icon Name: cards
Enabled in Block(s): Leave Blank
96
Create a new record and enter the following,
Seq: XXXXX
Description: CardConnect Tokenizer Response
Level: Form
Enabled: Checked
97
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Property
Description: Leave Blank
Language: All
Enabled: Yes
Object Type: Global Variable
Target Object: XXPPS_LAUNCH_URL
Property Name: VALUE
Value:
=SELECT
xxppsutil.get_tokenizer_url(:IEXPYPRS_INV_LIST.CUSTOMER_ID,:IEXPYPRS_INV_LIST.CUSTO
MER_SITE_USE_ID,:IEXPYPRS_INV_COMMON.PAYMENT_AMOUNT) from dual
98
Seq: XXXXXX
Type: Builtin
Description: Leave Blank
Language: All
Enabled: Yes
Builtin Type: Launch URL
Argument: =:GLOBAL.XXPPS_LAUNCH_URL
Target: CardConnect
99
Create a new record and enter the following,
Seq: XXXXX
Description: Display CardConnect Card Validator
Level: Form
Enabled: Checked
100
Go to Actions tab and enter the following,
Seq: XXXXX
Type: Menu
Language: All
Enabled: Yes
Menu Entry: MENU2
Menu Label: CardConnect Card Validator
Render line before menu: Unchecked
Icon Name: Leave Blank
Enabled in Block(s): IEXPYPRS_CC
101
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation message
Level: Form
Enabled: Checked
102
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text:
=SELECT xxppsutil.get_validation_message(:IEXPYPRS_INV_LIST.CUSTOMER_SITE_USE_ID,
:IEXPYPRS_CC.CC_ASSIGNMENT_ID, :IEXPYPRS_CC.CC_PMT_METHOD_ID) from dual
103
Create a new record and enter the following,
Seq: XXXXX
Description: Display Validation not available message
Level: Form
Enabled: Checked
104
Go to Actions tab and enter the following,
Seq: XXXXXX
Type: Message
Description: Leave Blank
Language: All
Enabled: Yes
Message Type: Show
Message Text: =select 'Card validation unavailable. Please select a credit card and save.' from
dual
105
Appendix A – Determining Ingenico Device Comm Port
To determine the port currently being used by your Ingenico device, first navigate to the Device
Manager.
106
Once you have opened the device manager, find your Inengico device under the Ports (COM & LPT)
section. Please note, your device may be named differently than the print screen below.
107
Double click on the device to open the properties dialog box. Then, navigate to the Port Settings tab
and click on the “Advanced…” button.
The resulting screen will tell you the comm port being used by the device.
108
Appendix B - Internet Explorer Settings
To avoid internet explorer hiding the Oracle java window when the Tokenizer is deployed, please
change the internet options “When a pop-up is encountered” setting to “Always open pop-ups
in a new window”. This setting can be found by clicking on the “Tabs” button of the Internet
Options “General” tab.
109
Open and Closed Issues & Action Items
1 NA
2
3
4
1 NA
2
3
4
References
NA
110