Sie sind auf Seite 1von 110

Oracle EBS Design Document

CardConnect

Oracle Personalizations

Author: Ravi Musuku


Creation Date: September 17th, 2015
Last Updated: August 31, 2016
Version: 1.3

1
Change Record110

Date Author Versio Change Reference


n

17-Sep-2015 Ravi Musuku 1.0 No Previous Document


05-Aug-2016 Thomas 1.1 Added Ingenico Device setups
McCullough
30-Aug-2016 Thomas 1.2 Added function call to derive web
McCullough tokenizer url
04-Oct-2016 Thomas 1.3 Added Card Validation
McCullough personalizations

Reviewers

Name Position

Distribution

Copy No. Name Location

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.

The allowed values are:

 Manual Card Entry


o This setting will allow for the credit card to be entered into the tokenizer via a
keyboard or other human input device.
 PanPad
o This setting will allow for the credit card to only be entered via a SRED swipe
device.
 Ingenico
o This setting will allow for the credit card to only be entered via an Ingenico device.
o In order to communicate with the Ingenico device, the Ingenico web tokenizer
utilizes a small Active X application. This requires that Internet Explorer be used
with Active X enabled to access the Ingenico Web Tokenizer. The web tokenizer
for Ingenico devices has been designed for and tested on Internet Explorer 11
and is not certified for versions below IE11.
o Since the Ingenico devices require 2-way communication, the devices comm port
needs to be communicated to the Ingenico Web Tokenizer. This is accomplished
via the XXPPS: Tokenizer Ingenico Comm Port profile option. This profile
option will need to be set to the comm port being used by the Ingenico device.
This profile option may be set at the user level. Or, if your organization will force
the same comm port for every installation of an Igenico device, it can be set at
the site level. Since the comm port will change if the device is moved to a new
USP port, it is recommended once a device is setup on a machine, it is always
used in the same USP port. To determine the port being used by the Ingenico
device, please see Appendix A of this document.
o For credit cards manually keyed into the Ingenico device, the signature
requirement may be bypassed by setting the XXPPS: Require Signature with
Ingenico Keypad Entry profile option to “No”. If left blank, or set to “Yes”,
a signature will be required for credit cards manually keyed into the Ingenico
device. Swiped or inserted cards will always require a signature.

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.

To disable please set the profile option value as 'No'.

6
Order Management -Sales Orders

Please navigate to Order Management Super User responsibility and access Sales Orders
form (Navigation: Order Management Super UserSales 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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :order.invoice_to_customer_id is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :SYSTEM.RECORD_STATUS = 'QUERY' and :ORDER.CREDIT_CARD_NUMBER_DSP
is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :ORDER.CREDIT_CARD_NUMBER_DSP is null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :SYSTEM.RECORD_STATUS != 'QUERY' and
:ORDER.CREDIT_CARD_NUMBER_DSP is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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'

Save your changes and close all forms.

23
Order Management -Quick Sales Orders

Please navigate to Order Management Super User responsibility and access Quick Sales
Orders form (Navigation: Order Management Super UserSales 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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :order.invoice_to_customer_id is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :SYSTEM.RECORD_STATUS = 'QUERY' and :ORDER.CREDIT_CARD_NUMBER_DSP
is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :ORDER.CREDIT_CARD_NUMBER_DSP is null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :SYSTEM.RECORD_STATUS != 'QUERY' and
:ORDER.CREDIT_CARD_NUMBER_DSP is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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'

Save your changes and close all forms.

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-VALIDATE-RECORD


Trigger Object: ORDER
Condition: :ORDER.PAYMENT_TYPE = 'Credit Card'
AND :ORDER.CREDIT_CARD_NUMBER_DSP IS NOT NULL
AND TO_CHAR(:ORDER.CREDIT_CARD_NUMBER_DSP) NOT LIKE '9%'
AND TO_CHAR(:ORDER.CREDIT_CARD_NUMBER_DSP) NOT LIKE 'X%'
Processing Mode: Both
Level: Site

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

Save your changes and close all forms.

42
Payments

Please navigate to Order Management Super User responsibility and access Sales Orders
form (Navigation: Order Management Super UserSales 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

Create a new record and enter the following,

Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition:
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-VALIDATE-RECORD


Trigger Object: OE_PAYMENTS
Condition: :OE_PAYMENTS.PAYMENT_TYPE_CODE_DSP = 'Credit Card'
and :OE_PAYMENTS.IDENTIFYING_NUMBER is not null
and to_char(:OE_PAYMENTS.IDENTIFYING_NUMBER) not like '9%'
and to_char(:OE_PAYMENTS.IDENTIFYING_NUMBER) not like 'X%'
Processing Mode: Both
Level: Site

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

Save your changes and close all forms.

51
Receivables - Transactions

Please navigate to Receivables Manager responsibility and access Transactions form


(Navigation: Receivables ManagerTransactions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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :tgw_header.bill_to_customer_id is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :TGW_HEADER.ARM_PAYMENT_CHANNEL_CODE = 'CREDIT_CARD' and
:TGW_HEADERS.PAYMENT_TRXN_EXTENSION_ID is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :TGW_HEADER.ARM_PAYMENT_CHANNEL_CODE != 'CREDIT_CARD' or
:TGW_HEADERS.PAYMENT_TRXN_EXTENSION_ID is null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Save your changes and close all forms.

64
Receivables - Receipts

Please navigate to Receivables Manager responsibility and access Receipts form


(Navigation: Receivables ManagerReceiptsReceipts)

Navigate to Help -> Diagnostics -> Custom Code -> Personalize

65
66
Create a new record and enter the following,

Seq: XXXXX
Description: Display CardConnect Web Tokenizer
Level: Form
Enabled: Checked

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :RGW_FOLDER.CUSTOMER_ID is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :RGW_FOLDER.PAYMENT_CHANNEL_CODE = 'CREDIT_CARD' and
:RGW_FOLDER.PAYMENT_TRXN_EXTENSION_ID is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :RGW_FOLDER.PAYMENT_CHANNEL_CODE!= 'CREDIT_CARD' or
:RGW_FOLDER.PAYMENT_TRXN_EXTENSION_ID is null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Save your changes and close all forms.

77
Service Contracts

Please navigate to a Service Contracts responsibility and access the Launchpad under
Contract Administration (Navigation example: Service Contracts AdministrationContract
AdministrationLaunchpad)

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :OKS_HEADER.BILL_TO_CUST_ACCT_ID1 is not null and
:OKS_HEADER.BILL_TO_SITE_USE_ID is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :OKS_HEADER.PAYMENT_TYPE = 'CCR' and :OKS_HEADER.INSTR_ASSIGNMENT
is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :OKS_HEADER.PAYMENT_TYPE != 'CCR' or :OKS_HEADER.INSTR_ASSIGNMENT is
null

Processing Mode: Not in Enter-Query Mode.


Level: Site

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

Save your changes and close all forms.

91
Advanced Collections

Please navigate to an Advanced Collections responsibility and access Collections (Navigation


example: Collections Leasing Agent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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: Leave Blank
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU1


Condition: :IEXPYPRS_INV_LIST.CUSTOMER_ID is not null and
:IEXPYPRS_INV_LIST.CUSTOMER_SITE_USE_ID is not null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: WHEN-NEW-FORM-INSTANCE


Condition: fnd_profile.value('XXPPS_CC_VALIDATION') in ('2','3')
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :IEXPYPRS_CC.CC_NUM is not null and :IEXPYPRS_CC.CC_ASSIGNMENT_ID is not
null
Processing Mode: Not in Enter-Query Mode.
Level: Site

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

Go to Condition tab and enter the following,

Trigger Event: MENU2


Condition: :IEXPYPRS_CC.CC_NUM is null or :IEXPYPRS_CC.CC_ASSIGNMENT_ID is null

Processing Mode: Not in Enter-Query Mode.


Level: Site

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

Save your changes and close all forms.

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.

1. Click Start, and then click Control Panel.


2. If your Control Panel is arranged by category, click Hardware and Sound.
3. Click Device Manager. One of the following may occur:
a. If you are logged on as the built-in Administrator account, Device Manager opens.
b. If you are logged on a user that is a member of the Administrators group, then the User
Account Control dialog appears and you must click Continue to open Device Manager.
c. If you are logged on as a standard user, a message appears indicating that you cannot
make any changes to the devices. Click OK to open the Device Manager in read-only
mode.

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

Open Issues/Action Items

ID Issue Resolution Responsibility Target Date

1 NA
2
3
4

Closed Issues/Action Items

ID Issue Resolution Responsibility Target Date

1 NA
2
3
4

References
NA

110

Das könnte Ihnen auch gefallen