1/16

Contents

Title and Copyright Information

Preface

• Finding More Information
• Documentation Accessibility
• Where to Find Oracle Documentation
• Conventions

1 HDR Components

• Services
  • Service Categories
• Java APIs
  • Client-side Service Classes
• Integrating the Healthcare Enterprise (IHE)
• Messaging Interface
  • Inbound Messaging Services
• Concurrent Program Service for Scheduling Jobs
• Enterprise Terminology Services
• Profile Option Services
  • Create, Set, and Update Profile Options
  • Create and Update New Profile Option Values
• Audit Services
  • Enabling Audit Services
• RIM Service

2 Design Recommendations

• Use Version-Aware References
• Follow J2EE Best Practices
• Choose an Appropriate Deployment Model
• Package Custom Server-side Code in its Own EAR File
• Design Your Own Business Level Services on Top of HDR
• Design Your Own Domain Model to Take Full Advantage of GUI Frameworks
• Consider Threading Issues
• Avoid Treatment of Your ServiceLocator as a Handle to a Session
• Avoid Deprecated Methods
• Use Oracle Identity Manager for Single Sign-On
• Use HTTP Form Authentication

3 Set Up Client-side Libraries

• Client-side Libraries

4 Use the Service Locator to Create HDR Sessions

• The Service Locator
• Configure Service Locator
• Create a New Session
• Set the Client Mode
• Authorization Considerations
  • ServiceLocator.login
• JAAS Authentication in WebLogic Server
  • JAAS and the ServiceLocator

5 Audit Events and Log Errors

• HDR Audit Services
  • Initializing Existing Audit Event Types
  • Creating New Audit Event Types
  • Invoking HDR Audit Services
  • Attribute Values in Audit Events
• Log Error Messages
  • Teminology
  • Log4j Logging Configuration
  • Log Configuration Parameters

6 ID and Profile Option Services

• HDR OID Service
  • HDR Object Identifiers
• HDR Profile Option Service
  • Define Profile Options
  • Create Profile Options
  • Set Profile Option Values
  • Retrieve Profile Option Values

7 RIM Services

• Submit a Query
• HDR HL7 Domain Constants
• HDR Factories
  • Factories
  • Data Type Factory
  • RIM Object Factories
  • Reference Modifiers
• HDR Query
  • Scenario
  • Fetches
  • Criteria
  • Navigate the Result Graph
  • HDR RIM Extensions
• DCTB Subqueries
  • -DCTB_SUBQRY_OPT_METHOD=NONE
  • -DCTB_SUBQRY_OPT_METHOD=EXISTS
  • -DCTB_SUBQRY_OPT_METHOD=JOIN
• HDR RIM Services
  • Use RIM Services
  • Use The RIM Service
  • Reference Modifiers
  • Exception Handling
• Use Master Catalog API
  • Master Catalog Entries
  • Focal Class State Transitions
• HDR HL7 Data Types
  • Use the DataTypeFactory
  • HL7 Null Flavors
  • Unsupported Operations
  • Coded Types
  • Collections (SET, BAG, LIST, IVL)
  • HL7 Timing Specification (GTS, PIVL, EIVL, IVL<TS>, TS)
• RIM Service Examples
  • Use CD Qualifiers
  • Query Based on Observation Value Attribute
• Constraints on the HL7 V3 RIM Model
  • HL7 V3 Datatype Constraints
  • RIM Query API Constraints

8 Merge, Unmerge, Link and Unlink Person Data in HDR

9 Enterprise Terminology Server (ETS)

• Generic Terminology Model
  • Verify Different Terminology Versions Using Change Files
• Loading and Activating Coding Scheme Versions
  • Preparing Terminology Content and Control Files
  • Creating New Generic Coding Schemes
  • Loading a Coding Scheme Version
  • Using Oracle Database Scheduler (DBMS_SCHEDULER)
  • Publishing a Coding Scheme Version
  • Using Oracle Database Scheduler (DBMS_SCHEDULER)
  • Activating a New Terminology Version
• Interterminology Mapping
  • Interterminology Mapping Using Cross Maps
• ETS Object Model
  • ETS Concept Lists
  • ETS Editable Terminologies
  • ETS Classifications
  • ETS Equivalence
  • HDR Terminology Jobs
  • ETS Multiple Language Support (MLS)
  • Understanding Language (Locale) Mappings
  • Locale Enabled APIs

10 HDR Messaging Services

• HDR Inbound Message Processor
  • Configuring Interactions
  • Configuring Sender, Sender Interaction, and Side Effect
  • Invoke Inbound Messaging Services
  • IMP Configuration API Usage
  • Side Effect Configuration Rules
• HDR Message Submission Unit
  • Message Submission Unit
  • Submission Unit Interface
  • Submission Unit Service Interface Methods
• HDR RIM Service Hook
  • Event and Subscription
  • Subscription Code Sample
• HDR Messaging Toolkit
  • MTK Workflow
  • Messaging Toolkit (MTK) Services
  • HL7 Message Development Process
  • Implement a New Message Type
  • Procedure
  • Test a New Message Type
  • Verify the Test Files
  • Set Up Message Types
  • Configure IMP and OMP
  • Use the MTK Services
  • Sample Exercise Using MTK Services
  • Generating Custom Message Types
  • Logic for Instance Generation
  • Master Catalog and Side Effect Configuration Reports
  • MTK Message Types Construct Processing
  • XML Snippets of Seeded Data
  • Expected Differences in Instances

11 HDR Exception Handling

• Optimistic Locking Exceptions
• Bundled Exceptions

12 Integrating the Healthcare Enterprise

• Cross-Enterprise Document Sharing-b (XDS.b)
  • IHE Actors
  • Affinity Domain
• Integrating the Healthcare Enterprise Cross-Enterprise Document Sharing-b Web Service
  • HDR's IHE XDS.b Solution Overview
  • Supported IHE XDS.b Transactions
  • Synchronous Provide and Register Document Set-b
  • Document Storage Mode
  • Synchronous Retrieve Document Set
  • Asynchronous XDS.b Web Services
  • Audit Trail and Event Logs

13 HDR Clinical Document Architecture (CDA) Persistence

• Overview
• WSDL CDA Persistence Implementation
• WS-Security for CDA Persistence Web Service