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 Introduction

• Overview

2 Packaging Structure and Standards

• General Packaging Structure

3 Business Object Structure

• Base and Custom Directories
• Custom and Localization Directories and Namespaces

4 Versioning Artifacts

• Common Versioning Strategies
  • Strict Versioning
  • Flexible Versioning
  • Loose Versioning
  • Comparison Chart
  • Oracle Retail Versioning Strategy
• Reasons for Versioning an Artifact
  • Breaking Changes
  • Non-breaking Changes
• Versioning Retail Business Objects Schemas (XSDs)
  • Versioning Approach for XSDs
  • XSD Version Attribute
  • XSD Version Attribute Usage
  • XSD Namespace Versioning
  • Parent/Child Versioning
  • Multiple Versioning

5 XML Standards and Conventions

• XML Standards and Conventions
  • The underscore (_) must be used for readability in naming simple elements
  • Names must not contain special characters
  • UpperCamel case must be used for naming complex types
  • Avoid XML schema keywords as element names
  • Avoid Java keywords
  • Avoid PLSQL keywords
  • Avoid having numeric characters in the name
  • All XSD elements should be annotated
  • All XSDs should use the date type, xsd:dateTime, and the XML format, 2002-05-30T09:00:00
• Retail Business Objects Schema
  • Business Object (XSD) names should not contain names
  • Business Object (XSD) names should not contain CRUD operations
  • The Business Object (XSD) file must match the name of the top level element
  • Each Business Object (XSD) must have its own namespace
  • Each Business Object (XSD) namespace should not contain application identifiers
  • Each Business Object (XSD) root should be annotated
  • Avoid Business Object (XSD) to have maxOccurs="unbounded" for elements

6 Customizing and Extending Business Objects

• Business Object Customization Tools and Approaches
• Business Object Customization Standards

7 Localizing Retail Business Objects

• Business Objects Localization
  • Localization Hooks in Base Business Objects
  • Region Specific Placeholders
  • Localization Customization
  • Adding Localization Fields
  • Adding Localization Customization Fields

8 Importing Retail Business Objects

• Imports in Base Business Object (XSD)
• Imports in Custom Business Object (XSD)
• Imports in Localized Business Object (XSD)

A References

Glossary