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