Go to primary content
Oracle® Retail POS Suite Implementation Guide, Volume 2 – Extension Solutions
Release 14.1
E54476-02
Index
Next
Contents
Title and Copyright Information
Send Us Your Comments
Preface
Audience
Documentation Accessibility
Related Documents
Customer Support
Review Patch Documentation
Improved Process for Oracle Retail Documentation Corrections
Oracle Retail Documentation on the Oracle Technology Network
Conventions
1
Extracting Source Code
2
Development Environments
Back Office and Central Office Development Environment
Using the Apache Ant Build Tool
Prerequisites for the Development Environment
Install Weblogic Application Server
Build the Back Office or Central Office Application
Point-of-Service Development Environment
Preparation
Setup
Install Point-of-Service
Build the Database
Create a Sandbox
Configure the Version Control System
Run Point-of-Service
3
General Development Standards
Basics
Java Recommendations
Avoiding Common Java Bugs
Formatting
Javadoc
Naming Conventions
SQL Guidelines
Unit Testing
Architecture and Design Guidelines
AntiPatterns
Designing for Extension
Common Frameworks
Internationalization
Translation
Logging
Guarding Code
When to Log
Writing Log Messages
Exception Messages
Heartbeat or Life Cycle Messages
Debug Messages
Exception Handling
Types of Exceptions
Avoid java.lang.Exception
Avoid Custom Exceptions
Catching Exceptions
4
Point-of-Service Development Standards
Screen Design and User Interface Guidelines
Tour Framework
Tour Architectural Guidelines
General Tour Guidelines
Foundation
Tours and Services
Sites
Managers and Technicians
Roads
Aisles
Signals
Choosing Among Sites, Aisles, and Signals
Renaming Letters
Shuttles
Cargo
Log Entry Format
Log Entry Description
Fixed Length Header
Additional Logging Information
Example Log Entry
5
Point-of-Service Extension Guidelines
Conventions
Terms
Filename Conventions
Modules
Directory Paths
POS Package
Tour
Tour Map
Tour Scripts
Site
Lane—Road or Aisle
Shuttle
Signal
Cargo
UI Framework
Default UI Config
UI Script
Bean Model and Bean
Other
Internationalization
Conduit Scripts
PLAF
Reports
Creating new receipts (BPT and SER)
Domain Package
Retail Domain
DomainObjectFactory
Retail Domain Object (RDO)
Database
Data Manager and Technician Scripts
Data Actions and Operations
Data Transactions
6
Back Office and Central Office Extension Guidelines
Audience
Application Layers
User Interface
Application Manager
Commerce Service
Algorithm
Entity
Data Access Objects
Database
Extension and Customization Scenarios
Style and Appearance Changes
Additional Information Presented to User
Changes to Application Flow
Access Data From a Different Database
Access Data From External System
Change an Algorithm Used By a Service
Extension Strategies
Extension with Inheritance
Replacement of Implementation
Service Extension with Composition
Data Extension Through Composition
7
Returns Management Extension Guidelines
Element Location and Schema Definition
Element Usage and Retrieval
8
Coding Your First Back Office or Central Office Feature
Before You Begin
Extending Transaction Search
Item Quantity Example in Central Office
Search by Login ID in Back Office
Web UI Framework in Central Office
Create a New JSP file
Add Strings to Properties Files
Configure the sideNav Tile
Web UI Framework in Back Office
Modify the JSP File
Externalize Strings
Action Mapping
Action Form
Action Modification
Configure Action Mapping in Central Office
Add Code to Handle New Fields to Search Transaction Form
Create a Struts Action Class
Add Method to Base Class
Application Services in Back Office
Verify Application Manager Implementation in Central Office
Commerce Services in Back Office
Add Business Logic to Commerce Service in Central Office
Create a Class to Create the Criteria Object
Add New Criteria to the Service
Handle SQL Code Changes in the Service Bean
9
Frameworks
Frameworks
Manager/Technician
User Interface
Business Object
Data Persistence
Tour
Tourmap
10
Manager/Technician Framework
New Manager/Technician
Manager Class
Manager Configuration
Technician Class
Technician Configuration
Valet Class
Sample Code
Configuration
Tour Code
Manager
Valet
Technician
Manager/Technician Reference
Parameter Manager/Technician
UI Manager/Technician
Journal Manager/Technician
Internationalizing EJournal Messages
Internationalizing Static Texts
Internationalizing Transaction Data
Internationalization of Data Modification Event Messages
Persisting EJournal in UTF8 format
Retrieve EJournal from Point-of-Service
Display EJournal from Central Office
11
User Interface Framework
Screens
Beans
PromptAndResponseBean
Bean Properties and Text Bundle
Tour Code
DataInputBean
Bean Properties and Text Bundle
Tour Code
NavigationButtonBean
Bean Properties and Text Bundle
Tour Code
DialogBean
Bean Properties and Text Bundle
Tour Code
Field Types
Multi-byte Support For Input Fields
UI Framework Architecture for Input Fields
Updating MaxLength and Size of Multi-byte Fields
Allowing or Disallowing UI Fields to Accept UTF8 Characters
Connections
ClearActionListener
DocumentListener
ValidateActionListener
Text Bundles
parameterText
12
Oracle Retail Tour Framework
Tour Components
Tour Metaphor
Service and Service Region
Bus
Cargo
Sites
System Sites
Letters
Roads
Common Roads
Aisles
Stations and Shuttles
Signals
Exception Region
Role of Java Classes
Tour Cam
Attributes
Letter Processing
Cargo Restoration
Tender Tour Reference
13
Point-of-Service COMMEXT Framework
Point-of-Service Connector Framework
BaseManager/BaseTechnician
ServiceManager/ServiceTechnician
MessageDispatcher
MessageRouter
RouterConnector
ConnectorIfc
FormatterIfc
RoutingRuleIfc
MessageIfc
MessageResponseIfc
Message Routing
Connectors
COMMEXT Patterns to Support Interaction Behavior
Store and Forward
Attempt, Store and Forward on Failure
14
Oracle Retail Returns Management Extensibility Framework
Adding a New Rule
Adding a New KPI Calculator
The Calculator Class
Database Configuration
Creating the JSP
15
Retail Domain
New Domain Object
Domain Object in Tour Code
Domain Object Reference
CodeListMap
Currency
Transaction
16
Extending Intra Store Data Distribution
Intra Store Data Distribution Extensibility
Adding New Table To Existing DataSet
Adding More Tables To Existing DataSet Types
Adding a Table to an Existing Data Set Using the Stores Build Scripts
Adding a New DataSet
Adding a New DataSet Using the Stores Build Scripts
Configuring Schedule for DataSet Producer and Consumer
Configure DataSet Producer
Configure DataSet Consumer
Adding New DataSet Type
Adding a New DataSet Type Using the Stores Build Scripts
Changing Oracle Retail Point-of-Service Client Database Vendor
Index