Welcome to Smile CDR
- Table of Contents 1.0
- Changelog (2021 Releases) 1.1
- Changelog (2020 Releases) 1.2
- Changelog (2019 Releases) 1.3
- Changelog (2018 Releases) 1.4
- Changelog (2017 Releases) 1.5
Getting Started
Installation
- Installing Smile CDR 3.0
- Docker Container Installation 3.1
- Unix Service Installation 3.2
- Tuning your Installation 3.3
- Message Brokers 3.4
- Message Broker Failure Management 3.5
- Message Broker: ActiveMQ 3.6
- Message Broker: Kafka 3.7
- Pre-Seeding Configuration and Data 3.8
- Upgrading Smile CDR 3.9
Tutorial and Tour
- Preamble and Setup 4.0
- FHIR Basics 4.1
- FHIR Search Queries 4.2
- FHIR CRUD Operations 4.3
- SMART on FHIR Apps 4.4
- Processing HL7 v2.x Feeds 4.5
- FHIRPath Expressions 4.6
- Federated OAuth2/OIDC Setup 4.7
FHIR Storage
- Concepts in Smile CDR 5.0
- FHIR Storage (Relational) Module 5.1
- FHIR Storage (MongoDB) Module 5.2
- FHIR Endpoint Module 5.3
- FHIRWeb Console 5.4
- OpenAPI / Swagger Support 5.5
- Lucene Indexing 5.6
- Performance and Caching 5.7
- Resource IDs 5.8
- Search Parameters 5.9
- Search Parameter Features 5.10
- Phonetic Search Parameters 5.11
- Custom Search Parameters 5.12
- Search Parameter Tuning 5.13
- Partitioning and Multitenancy 5.14
- Searching for Data 5.15
- Creating Data 5.16
- Reading Data 5.17
- Updating Data 5.18
- Deleting Data 5.19
- Binary Data 5.20
- Request Tracing and Provenance 5.21
- FHIR Versions 5.22
- Versioned Resource References 5.23
- Tags, Profiles, and Security Labels 5.24
- Clinical Quality Language (CQL) 5.25
Validation and Conformance
- Introduction 6.0
- Validation Support Repository 6.1
- Validation Support Repository Options 6.2
- Conformance Data 6.3
- Repository Validation 6.4
- Repository Validation: Java 6.5
- Repository Validation: Javascript 6.6
- Repository Validation: Validation Bean 6.7
- Endpoint Validation 6.8
- Packages and Implementation Guides 6.9
- Remote Terminology Services 6.10
- Suppressing Messages 6.11
Terminology
- Terminology Introduction 7.0
- Uploading Codes 7.1
- Terminology and Lucene Indexing 7.2
- ValueSet Expansion 7.3
- FHIR Response Terminology Mapping 7.4
Subscription
Interceptors
- Interceptors 9.0
- Starter Project 9.1
- Examples: FHIR Endpoints 9.2
- Examples: FHIR Storage 9.3
- Examples: FHIR Gateway 9.4
Channel Import
Realtime Export
- Realtime Export Overview 11.0
- Realtime Export Rules Definition 11.1
- Using FHIRPath 11.2
- Debezium 11.3
Security
- Security in Smile CDR 12.0
- Authentication Protocols 12.1
- Authorization and Consent 12.2
- Inbound Security Module 12.3
- Local Inbound Security Module 12.4
- LDAP Inbound Security Module 12.5
- Scripted Inbound Security Module 12.6
- SAML Inbound Security Module 12.7
- Trusted Client Mode 12.8
- Roles and Permissions 12.9
- Callback Scripts 12.10
- Anonymous Access 12.11
- Consent Service 12.12
- Security Recipes 12.13
- Two Factor Authentication 12.14
- Troubleshooting Security 12.15
SMART on FHIR
- SMART on FHIR: Introduction 13.0
- SMART: Scopes 13.1
- SMART: Auth Flows 13.2
- SMART: Endpoints 13.3
- Client Management 13.4
- SMART: Smile CDR Support 13.5
- SMART Outbound Security: Module 13.6
- SMART Outbound Security: Skinning 13.7
- SMART Outbound Security: Context Selection 13.8
- SMART: Federated OAuth2/OIDC Login 13.9
- SMART: Application Approval/Consent 13.10
- SMART Inbound Security Module 13.11
- SMART: Session Management 13.12
- SMART: Assigning Permissions 13.13
- SMART: Access Tokens 13.14
- SMART: User Profile Information 13.15
- FHIR Client Authentication 13.16
App Management Tools
- Introduction 14.0
- Getting Started 14.1
- Associated Module Configurations 14.2
- Client Creation and Configuration 14.3
- Other Configurations 14.4
- Developer Portal 14.5
- App Management Console 14.6
- App Gallery 14.7
- Appendix 14.8
FHIR Gateway
FHIR Hybrid Providers
LiveBundle
- LiveBundle Overview 17.0
- LiveBundle API 17.1
- LiveBundle Rule Definition 17.2
- LiveBundle Keepers 17.3
CDS-Hooks
Master Data Management
Clustering
Logging
HL7 v2.x Support
- Introduction 22.0
- Inbound Messaging 22.1
- Outbound Messaging 22.2
- Transactions 22.3
- Structure Definitions 22.4
- Segment Definitions 22.5
- Table Definitions 22.6
- Naming System Mapping 22.7
- Processing Results Feeds 22.8
- Protocol 22.9
CDA Exchange Module
- Introduction 23.0
- JavaScript Templates 23.1
- Rest API Operations 23.2
- Available Document and Section Types 23.3
- Further Reading 23.4
Bulk Operations
Monitoring
Product Administration
JSON Admin Endpoints
- JSON Admin API 27.0
- Audit Log Endpoint 27.1
- Batch Job Endpoint 27.2
- Bulk Import Endpoint 27.3
- CDA Exchange Endpoint 27.4
- Metrics Endpoint 27.5
- Module Config Endpoint 27.6
- OpenID Connect Clients Endpoint 27.7
- OpenID Connect Servers Endpoint 27.8
- OpenID Connect Sessions Endpoint 27.9
- Runtime Status Endpoint 27.10
- System Config Endpoint 27.11
- Transaction Log Endpoint 27.12
- User Management Endpoint 27.13
Product Configuration
Java Execution Environment
JavaScript Execution Environment
- Introduction 30.0
- Specifying JavaScript in Configuration File 30.1
- Converter API 30.2
- Environment API 30.3
- Exceptions API 30.4
- OAuth2 Exceptions API 30.5
- FHIR REST API 30.6
- FHIR Model API 30.7
- HL7 v2.x Mapping API 30.8
- HTTP API 30.9
- LDAP API 30.10
- Log API 30.11
- Composition Resource API 30.12
- Composition Section API 30.13
- TransactionBuilder API 30.14
- Util API 30.15
- UUID API 30.16
- XML API 30.17
- Callback Models 30.18
Database Administration
- Database Design 31.0
- Database Connection Pool 31.1
- Setting Up PostgreSQL 31.2
- Troubleshooting PostgreSQL 31.3
- Setting Up MySQL 31.4
- Setting Up MariaDB 31.5
- Setting Up Oracle 31.6
- Setting Up SQL Server (MSSQL) 31.7
Localization
Smile CDR CLI (smileutil)
- Introduction 33.0
- Execute Script Function 33.1
- Create FHIR Package 33.2
- Export ConceptMap to CSV 33.3
- HL7 v2.x Analyze Flat File 33.4
- HL7 v2.x Transmit Flat File 33.5
- Import CSV to ConceptMap 33.6
- Map and Upload CSV Bulk Import File 33.7
- Migrate Database 33.8
- Synchronize FHIR Servers 33.9
- Upload Bundle Files 33.10
- Upload CSV Bulk Import File 33.11
- Upload Sample Dataset 33.12
- Upload Terminology 33.13
- Validate FHIR Resources 33.14
Modules
- JSON Admin API 34.0
- Web Admin Console 34.1
- CDA Exchange 34.2
- Channel Import 34.3
- Cluster Manager 34.4
- Enterprise Master Patient Index 34.5
- CDS Hooks Endpoint 34.6
- FHIR Gateway Endpoint 34.7
- FHIR REST Endpoint (DSTU2) 34.8
- FHIR REST Endpoint (DSTU3) 34.9
- FHIR REST Endpoint (R4) 34.10
- FHIRWeb Console 34.11
- HL7 v2.x Listening Endpoint 34.12
- HL7 v2.x Sending Endpoint 34.13
- Hybrid Providers Endpoint 34.14
- Package Registry Endpoint 34.15
- Subscription Websocket Endpoint 34.16
- ETL Importer 34.17
- MDM 34.18
- Narrative Generator 34.19
- FHIR Storage (DSTU2 Relational) 34.20
- FHIR Storage (R3 Relational) 34.21
- FHIR Storage (Mongo) 34.22
- FHIR Storage (R4 Relational) 34.23
- Realtime Export 34.24
- LDAP Inbound Security 34.25
- Local Inbound Security 34.26
- SAML Inbound Security 34.27
- Scripted Inbound Security 34.28
- SMART Inbound Security 34.29
- SMART Outbound Security 34.30
- SMART App Host 34.31
- Subscription Matcher (All FHIR Versions) 34.32
- Subscription Matcher (DSTU2 - Deprecated) 34.33
- Subscription Matcher (DSTU3 - Deprecated) 34.34
- Subscription Matcher (R4 - Deprecated) 34.35
- App Management Tools 34.36
Configuration Categories
- Web Admin Console Settings 35.0
- App Management Tools 35.1
- Initial App Management Tools Seeding 35.2
- App Management Tools Email Server 35.3
- App Management Tools Payer Configuration 35.4
- Authentication Callback Scripts 35.5
- Auth: General for APIs 35.6
- User Authentication 35.7
- Auth: HTTP Basic 35.8
- Auth: OpenID Connect 35.9
- Browser Syntax Highlighting 35.10
- Capability Statement (metadata) 35.11
- CDA Generation 35.12
- CDS Hooks 35.13
- Channel Import 35.14
- Channel Retry 35.15
- Cluster Manager Maintenance 35.16
- Cluster Manager Message Broker 35.17
- Cluster Manager Kafka 35.18
- Credentials 35.19
- Cross-Origin Resource Sharing (CORS) 35.20
- Database 35.21
- ETL Import: CSV Properties 35.22
- ETL Import: Source 35.23
- FHIR Binary Storage 35.24
- FHIR Bulk Operations 35.25
- FHIR Configuration 35.26
- FHIR Capability Statement 35.27
- FHIR Consent Service 35.28
- FHIR Endpoint Terminology 35.29
- FHIR LiveBundle Service 35.30
- FHIR Endpoint Conversion 35.31
- FHIR Endpoint Security 35.32
- Interceptors 35.33
- FHIR Endpoint Partitioning and Multitenancy 35.34
- FHIR Gateway Config 35.35
- FHIR MDM Server 35.36
- FHIR Storage Partitioning and Multitenancy 35.37
- FHIR Storage Package Registry 35.38
- Versioned References 35.39
- FHIR Performance 35.40
- FHIR Performance Tracing 35.41
- FHIR Storage Scheduled Tasks 35.42
- FHIR Realtime Export 35.43
- FHIR Resource Types 35.44
- FHIR REST Endpoint 35.45
- FHIR Search 35.46
- FHIR Interceptors 35.47
- FHIR Repository Validation 35.48
- FHIR Subscription Persistence 35.49
- FHIR Subscription Delivery 35.50
- FHIR Validation Services 35.51
- HL7 v2.x to FHIR Mapper - Forced Namespace Mode 35.52
- HL7 v2.x to FHIR Mapper - General 35.53
- HL7 v2.x Mapper - Medications 35.54
- HL7 v2.x Mapper - Contained Resource 35.55
- HL7 v2.x to FHIR Mapper - OBR 35.56
- HL7 v2.x to FHIR Mapper - OBSERVATION Group 35.57
- HL7 v2.x to FHIR Mapper - ORDER_OBSERVATION Group 35.58
- HL7 v2.x to FHIR Mapper - PV1 35.59
- HL7 v2.x to FHIR Mapper - PID 35.60
- HL7 v2.x Listener Script 35.61
- HL7 v2.x MLLP Listener 35.62
- FHIR to HL7 v2.x Mapper Script 35.63
- HL7 v2.x Outbound Mapping 35.64
- HL7 v2.x MLLP Sender 35.65
- HTTP Access Log 35.66
- HTTP Listener 35.67
- HTTP Request Pool 35.68
- HTTP Security 35.69
- Hybrid Providers Definitions 35.70
- Initial User Seeding 35.71
- JSON Web KeySet (JWKS) 35.72
- LDAP Authentication 35.73
- Lucene FullText Indexing 35.74
- Narrative Generator 35.75
- Master Data Management 35.76
- OpenID Connect (OIDC) 35.77
- Realtime Export 35.78
- Request Validating 35.79
- Search Parameter Seeding 35.80
- Security Inbound Script 35.81
- Inbound SMART on FHIR Authentication 35.82
- Inbound SMART on FHIR Endpoints 35.83
- OpenID Connect Token Validation 35.84
- SAML Provider 35.85
- OAuth2/OIDC Federation 35.86
- SMART Authorization 35.87
- SMART Definitions Seeding 35.88
- Sessions 35.89
- SMART Outbound Security: Callback Script 35.90
- SMART Outbound Security: CODAP 35.91
- SMART Outbound Security: Login Skin 35.92
- SMART Outbound Security: Terms of Service 35.93
- Two Factor Authentication 35.94
- TLS / SSL (Encryption) 35.95
- Trusted Client 35.96
- Transaction Log 35.97
- User Self Registration 35.98
Product Reference
Appendix
Table of Contents
FHIR Gateway Introduction
15.0FHIR Gateway Endpoint
The FHIR Gateway Endpoint module creates a FHIR server that acts as a proxy for one or more target FHIR servers.
The FHIR Gateway provides the benefits of a Smile CDR FHIR endpoint over top of the target servers. This includes:
- Complete authentication/authorization services, including support for SMART on FHIR
- Audit and Transaction logs
- Automatic request/response conversion between XML/JSON/RDF
- FHIR response manipulation including support for FHIR features such as the
_elementsand_fhirpathparameters - Automatic FHIR version conversion if Versioned API Mode is enabled
When the FHIR Gateway is placed in front of multiple target servers, it can be used to present a collection of servers as a single unified FHIR endpoint. This can be particularly useful when implementing APIs for SMART on FHIR applications, since these applications will often expect a single endpoint through which all data flows.
The FHIR Gateway is also designed to avoid revealing details about the internal FHIR servers. Internal server addresses, paging URLs, etc. are all obscured by the FHIR Gateway in its responses to clients.
15.0.1Smile CDR 2020.02 Gateway Redesign
The FHIR Gateway was completely redesigned and rewritten for the Smile CDR 2021.02 (Odyssey) release. While the rewrite introduces the ability to proxy multiple target servers, and is designed for much better performance, it does not yet have complete feature parity with the previous version. Please let us know if there are specific features you need from the previous version.