Oracle® Healthcare Transaction Base Implementation Guide Release 11i Part No. B10976-01 September 2003 Oracle Healthcare Transaction Base Implementation Guide, Release 11i Part No. B10976-01 Copyright © 2003 Oracle Corporation. All rights reserved. Primary Author: Mike Cowan Contributing Author: Marita Isidore Contributors: Joyce Abrams, Shengi Cheng, Sandy Hoang, Ravi Hothur, Anand Inumpudi, Flora Kidani, Valerie Kirk, Rondi Mertes, Tom Oniki, Trim Pershad, Shelly Qian, Cindy Satero, Pauline Troiano The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and JInitiator, OracleMetaLink, Oracle9i, PL/SQL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners. Contents List of TablesFigures Send Us Your Comments ................................................................................................................... xi Preface........................................................................................................................................................... xiii Intended Audience ............................................................................................................................... xiii How To Use This Guide ..................................................................................................................... xiv Typographic Conventions .................................................................................................................. xvi Documentation Accessibility .............................................................................................................. xx Other Information Sources.................................................................................................................. xx Related Healthcare Industry Publications ...................................................................................... xxv Do Not Use Database Tools to Modify Oracle Applications Data ............................................ xxvii About Oracle ..................................................................................................................................... xxviii Part I Getting Started 1 Introduction 1.1 Introduction............................................................................................................................ 1-2 1.2 Overview ................................................................................................................................ 1-4 2 Before You Begin 2.1 Software Prerequisites .......................................................................................................... 2-2 Part II Implementing Oracle Healthcare Transaction Base 3 Implementation Overview 3.1 Implementation Process Description.................................................................................. 3-2 3.2 Implementation Tasks .......................................................................................................... 3-4 iii 4 Implementation Tasks 4.1 Implementing Security Services .......................................................................................... 4-2 4.2 Implementing Person Services .......................................................................................... 4-24 4.3 Implementing Organizations............................................................................................. 4-47 4.4 Implementing Profile Option Services ............................................................................. 4-56 4.5 Implementing Enterprise Terminology Services ............................................................ 4-68 4.6 Implementing Audit Services .......................................................................................... 4-114 4.7 Implementing Administrative Business Services ......................................................... 4-123 4.8 Implementing Clinical Business Services....................................................................... 4-167 4.9 Implementing Inbound Message Processing Services ................................................. 4-179 4.10 Implementing ID Type Services ...................................................................................... 4-196 4.11 Implementing Cross-Referencing ................................................................................... 4-200 Part III Appendixes iv A Navigation Paths B HTB Session Service C ETS Terminology D Seeded Users, Responsibilities, Roles E Seeded Profile Options F Seeded Audit Events G Predefined Concept Lists H Seeded ID Types I Error Messages J Minimum Implementation Steps K Abbreviations & Acronyms Glossary v List of Figures 1–1 HTB Architecture................................................................................................................... 1-4 1–2 HTB Usage Model ................................................................................................................. 1-6 3–1 Implementation Task Process ............................................................................................ 3-11 4–1 Implementation Process: Security Services........................................................................ 4-4 4–2 Protected Objects: Person and Patient Services............................................................... 4-14 4–3 Protected Objects: Organization and Staff Services........................................................ 4-15 4–4 Protected Objects: Encounter Service ............................................................................... 4-16 4–5 Protected Objects: ClinicalAct Service.............................................................................. 4-17 4–6 Protected Objects: Scheduling and Wait List Services ................................................... 4-18 4–7 Implementation Process: Person Services........................................................................ 4-25 4–8 Implementation Process: Organizations .......................................................................... 4-49 4–9 Implementation Process: Profile Option Services........................................................... 4-58 4–10 Implementation Process: ETS ............................................................................................ 4-71 4–11 ETS Cross Mapping Relationship ..................................................................................... 4-87 4–12 Conceptual View of Generic Terminology for Concept List Concepts ..................... 4-110 4–13 Implementation Process: Audit Services........................................................................ 4-115 4–14 Implementation Process: Administrative Business Services....................................... 4-124 4–15 Implementation Process: Clinical Business Services .................................................... 4-168 4–16 Typical Application Topology......................................................................................... 4-179 4–17 Implementation Process: Inbound Message Processing Services............................... 4-182 vi List of Tables 2–1 HTB Technology Foundation Components...................................................................... 2-2 2–2 Server-Side Libraries...........................................................................................................