Skip to main content

Learning
Documentation
Community
Open Exchange
Global Masters
Certification

Search:

InterSystems IRIS for Health 2021.1
Using Python Gateway Connections

InterSystems IRIS for Health 2021.1

Release Information

About...
InterSystems IRIS for Health Overview
Release Notes

New and Enhanced Features
General Upgrade Information
Upgrade Compatibility Checklist
Known Issues and Notes
Deprecated and Discontinued Features
Licensing and Use of InterSystems Web Server

Supported Platforms

Supported Technologies
Supported Languages
Discontinued Platforms and Technologies
Supported Version Interoperability
Cross-Product Technology Matrix

First Looks
Downloading Samples
Searching the Documentation

Deployment

About...
Containers

About...
First Look
Try a Community Edition Container
Running in Containers
InterSystems Cloud Manager

About...
InterSystems Cloud Manager
InterSystems Cloud Manager Guide

ICM Overview
Essential InterSystems Cloud Manager Elements
Using InterSystems Cloud Manager
ICM Reference
Containerless Deployment
Sharing ICM Deployments
Scripting with ICM
Using ICM with Custom and Third-Party Containers
Deploying on a Preexisting Cluster

InterSystems Kubernetes Operator

About...
Using the InterSystems Kubernetes Operator

Installation Kit

About...
Installation Basics
Installation Guide for InterSystems IRIS for Health

Installing InterSystems IRIS for Health
Post-Installation Tasks
Upgrading InterSystems IRIS for Health
Using the Installer Wizard
Running InterSystems IRIS for Health in a Docker Container: Special Considerations

Installation Guide

Preparing to Install InterSystems IRIS
Installing InterSystems IRIS on Microsoft Windows
Installing InterSystems IRIS on UNIX®, Linux, and macOS
Upgrading InterSystems IRIS
Creating and Using an Installation Manifest
Adding UNIX® Installation Packages to an InterSystems IRIS Distribution

Data Migration

About...
Server Migration
ISQL Migration Guide

Overview

Transact-SQL (TSQL) Migration Guide

Planning and Performing TSQL Migration
InterSystems TSQL Constructs
InterSystems TSQL Language Elements
TSQL Commands
TSQL Settings
TSQL Functions
TSQL Variables
TSQL System Stored Procedures

DataMove

Adding Compiled Code
Using Configuration Merge

Administration

About...
System Administration

Using the Management Portal
Configuring InterSystems IRIS
Managing InterSystems IRIS
Managing InterSystems IRIS Licensing
Using InterSystems IRIS on Windows
Using InterSystems IRIS on UNIX®, Linux, and macOS
Connecting to Remote Servers
Using Multiple Instances of InterSystems IRIS
Configuring Third-Party Software to Work in Conjunction with InterSystems Products
Feature Tracker Collects Usage Statistics

Monitoring

About...
Monitoring Guide

Monitoring InterSystems IRIS Using the Management Portal
Using the InterSystems Diagnostic Report
Using Log Monitor
Using System Monitor
Gathering Global Activity Statistics Using ^GLOSTAT
Monitoring System Performance Using ^PERFMON
Monitoring Routine Performance Using ^PROFILE
Examining Routine Performance Using ^%SYS.MONLBL
Monitoring Block Collisions Using ^BLKCOL
Monitoring Performance Using ^SystemPerformance
Monitoring Performance Using ^mgstat
Monitoring Processes Using ^PERFSAMPLE
History Monitor
Monitoring InterSystems IRIS Using SNMP
Monitoring InterSystems IRIS Using Web Services
Monitoring InterSystems IRIS Using REST API
Monitoring InterSystems IRIS Using the irisstat Utility

Error Reference

General Error Messages
SQL Error Messages
TSQL Error Messages
System Error Messages
Messages Related to Productions

System Alerting and Monitoring Application
InterSystems Reports

Registry Guide

Managing the Service Registry
Managing the OID Registry
Managing Assigning Authorities for Identifiers
Managing the Configuration Registry
Managing the XUA Registry
Managing the Trusted RSA Key Registry
Managing the Coded Entry Registry

HL7 Productivity Tools

Message Analyzer
Production Generator
Migration Tool

Configuration Parameters

Introduction to the Configuration Parameter File
[Actions]
[ComPorts]
[config]
[ConfigFile]
[Databases]
[Debug]
[Devices]
[DeviceSubTypes]
[ECP]
[ECPServers]
[Gateways]
[IO]
[Journal]
[LicenseServers]
[Map]
[MapMirrors]
[MirrorMember]
[Mirrors]
[Miscellaneous]
[Monitor]
[Namespaces]
[SQL]
[SqlSysDatatypes]
[SqlUserDatatypes]
[Startup]
[Telnet]

Specialized System Tools and Utilities

Introduction
Customizing the InterSystems IRIS System
Managing InterSystems IRIS Remotely
Process Management
Using cvendian for Byte Order Conversion

Architecture

About...
Mirroring and High Availability

About...
High Availability Solutions
High Availability Guide

Failover Strategies for High Availability
Mirroring Overview
Mirroring Architecture and Planning
Configuring Mirroring
Managing Mirroring
Mirror Outage Procedures

Scalability

About...
First Looks

Scaling for User Volume
Scaling for Data Volume

Scalability Guide

InterSystems IRIS Scalability Overview
Vertically Scaling InterSystems IRIS
Horizontally Scaling for User Volume with Distributed Caching
Horizontally Scaling for Data Volume with Sharding

Resiliency and Data Integrity

About...
First Look
Data Integrity Guide

Introduction to Data Integrity
Write Image Journaling and Recovery
Backup and Restore
Journaling
Data Consistency on Multiple Systems

Security

About...
About InterSystems Security
System Management & Security
Securing Your Instance

Security Strategy
Prepare for InterSystems Security
Tighten Security for an Instance
Security Advisor
Secure InterSystems Processes and Operating-System Resources
Checklist for Hardening Your Deployment

Security Tutorial

Authentication

Authentication Mechanisms
InterSystems Authentication Components and Process
Connection Tools and Access Modes
InterSystems Services
Specifying Authentication Mechanisms
Two-Factor Authentication
Users
Predefined Users
Cascading Authentication
Kerberos Authentication
Operating System Based Authentication
Instance Authentication
Example One: %Service_Console
Example One: %Service_Console (cont.)
Example One: %Service_Console (cont.)
Example One: %Service_Console (cont.)
Example Two: Web
Example Two: Web (cont.)
Delegated Authentication
Delegated Authentication Setup
ZAuthenticate
LDAP Authentication
LDAP Authentication Configuration
Recap

Authorization

Overview
Assets and Resources
Privileges
Public Privileges
Privileges, Roles, and Users
Database Resources
Namespaces
Example Setup
Example One: %Developer and %Operator Roles
Example Two: %Development Resource
Example Three: %DB_USER Resource
Example Four: $SYSTEM.Security.Check
Recap

Securing Applications

Overview
Three Types of Application Definitions
Properties of Application Definitions
Web Application Definitions
Example Setup
Example Setup (cont.)
Example One: Disabling an Application
Example Two: Protecting an Application with a Resource
Example Three: Application Roles
Example Four: Matching and Target Roles
Privileged Routine Applications
Example Setup
Example Setup (cont.)
Example: Creating a Privileged Routine Application Definition
Example: Adding a Routine
Example: Adding Application Roles
Example: Executing the Privileged Routine Application
Java, .NET, and Other Applications
Recap

Connection Tools, Access Modes, Services
Code for Authorization Example
Code for Authentication Example
Code for Privileged Routine Example
Creating a User
Creating a Resource
Creating a Role
Adding a User to a Role

Security for Developers

About...
SOAP Security

Introduction
Setup and Other Common Activities
Creating and Using Policies
WS-Policy Configuration Class Details
Adding Security Elements Manually
Adding Timestamps and Username Tokens
Encrypting the SOAP Body
Encrypting Security Header Elements
Adding Digital Signatures
Using Derived Key Tokens for Encryption and Signing
Combining Encryption and Signing
Validating and Decrypting Inbound Messages
Creating Secure Conversations
Using WS-ReliableMessaging
Creating and Adding SAML Tokens
Troubleshooting Security Problems
Details of the Security Elements

SQL Security
Command-Line Security Utilities

Authentication and Authorization

About...
First Looks

Role-Based Access Control
LDAP

Authentication Guide

Introduction
Kerberos Authentication
Operating System–Based Authentication
Instance Authentication
Delegated Authentication
Two-Factor Authentication
Services
Advanced Topics

Authorization Guide

About InterSystems Authorization
Assets and Resources
Privileges and Permissions
Roles
User Accounts
Applications
Using Delegated Authorization

LDAP Guide

LDAP and InterSystems IRIS®
LDAP Authentication
LDAP Authorization
Other LDAP Topics

OAuth 2.0 & OpenID Connect

Overview of OAuth 2.0 and OpenID Connect
How InterSystems IRIS Supports OAuth 2.0 and OpenID Connect
Using an InterSystems IRIS Web Application as an OAuth 2.0 Client
Using an InterSystems IRIS Web Application as an OAuth 2.0 Resource Server
Using InterSystems IRIS as an OAuth 2.0 Authorization Server
Creating Configuration Items Programmatically
Implementing DirectLogin()
Certificates and JWTs (JSON Web Tokens)

Encryption

About...
First Looks

Database Encryption
Public Key Infrastructure

Public Key Infrastructure
Encryption Guide

About Managed Key Encryption
Key Management Tasks
Using Encrypted Databases
Using Data-Element Encryption
Protecting Against Data Loss
Handling Emergency Situations
Additional Encryption Information
FIPS 140–2 Compliance for Database Encryption

Cryptographic Standards

TLS Guide

About TLS
About Configurations
Configuring the InterSystems IRIS Superserver to Use TLS
Configuring InterSystems IRIS Telnet to Use TLS
Configuring Java Clients to Use TLS with InterSystems IRIS
Configuring .NET Clients to Use TLS with InterSystems IRIS
Configuring Studio to Use TLS with InterSystems IRIS
Connecting from a Windows Client Using a Settings File
Configuring InterSystems IRIS to Use TLS with Mirroring
Configuring InterSystems IRIS to Use TLS with TCP Devices
Configuring the Web Gateway to Connect to InterSystems IRIS Using TLS
Establishing the Required Certificate Chain

Auditing Guide

Embedded Language Development

About...
Data Model
Orientation Guide

Introduction to InterSystems IRIS Programming
A Closer Look at ObjectScript
Classes
Objects
Persistent Objects and InterSystems IRIS SQL
Namespaces and Databases
InterSystems IRIS Security
Localization Support
Server Configuration Options
What’s That?
Rules and Guidelines for Identifiers
General System Limits
Numeric Computing in InterSystems Applications

Globals

About...
First Look
Multidimensional Data Access
Using Globals

Introduction
Global Structure
Using Multidimensional Storage (Globals)
SQL and Object Use of Multidimensional Storage
Managing Globals
Temporary Globals and the IRISTEMP Database

ObjectScript

About...
First Look
ObjectScript IDEs

About...
Connecting an IDE
About Visual Studio Code
Using Studio

Introduction to Studio
Creating Class Definitions
Adding Properties to a Class
Adding Methods to a Class
Adding Class Parameters to a Class
Adding Relationships to a Class
Adding Queries to a Class
Adding Indices to a Class
Adding Projections to a Class
Adding XData Blocks to a Class
Adding SQL Triggers and Foreign Keys to a Class
Adding Storage Definitions to a Class
Working with CSP Files
Working with Routines and Include Files
Using the Studio Debugger
Using Studio Templates
Studio Menu Reference
Setting Studio Options
Frequently Asked Questions About Studio

Source Control Integration

Using Terminal

Introduction to the Terminal
Using the Terminal Interactively
Controlling the Appearance and Behavior of the Terminal
Using Terminal Scripts
Script Command Reference
Connecting to Remote Hosts
Using the Terminal in Batch Mode
Advanced Topics

Object Data Access
Using ObjectScript

Introducing ObjectScript
Syntax Rules
Data Types and Values
Variables
Operators and Expressions
Regular Expressions
Commands
Callable User-defined Code Modules
ObjectScript Macros and the Macro Preprocessor
Embedded SQL
Multidimensional Arrays
String Operations
Lock Management
Transaction Processing
Error Processing
Command-line Routine Debugging

Class Definitions

About...
Defining & Using Classes

Basic Ideas in Class Programming
Defining and Compiling Classes
Package Options
Defining and Referring to Class Parameters
Defining and Calling Methods
Working with Registered Objects
Introduction to Persistent Objects
Working with Persistent Objects
Defining Persistent Classes
Defining and Using Literal Properties
Working with Collections
Working with Streams
Defining and Using Object-Valued Properties
Defining and Using Relationships
Other Options for Persistent Classes
Defining Method and Trigger Generators
Defining and Using Class Queries
Defining and Using XData Blocks
Defining Class Projections
Defining Callback Methods
Using and Overriding Property Methods
Defining Data Type Classes
Implementing Dynamic Dispatch
Object-Specific ObjectScript Features
Using the Populate Utility
Using the %Dictionary Classes
Using the Object Synchronization Feature

Class Definition Reference

Class Definitions
Class Keywords
Foreign Key Keywords
Index Keywords
Method Keywords
Parameter Keywords
Projection Keywords
Property Keywords
Query Keywords
Trigger Keywords
XData Keywords
Storage Keywords

Classes Page

ObjectScript Reference

Symbols and Abbreviations
ObjectScript Commands
Routine and Debugging Commands
ObjectScript Functions
ObjectScript Special Variables
Structured System Variables

ObjectScript Tutorial

The Basics

Introduction
Class Methods
Terminal
VS Code - ObjectScript
Do Command
Class Methods and Routines
Method Details
Passing Arguments by Reference
Return and Quit Commands
Write Command
Read Command
Set Command
Operator Precedence
Syntax
Common Errors
Write (again) and Kill Commands
If Construct
Simple Conditions
Complex Conditions
Hands-On Exercise 1
Class Compilation
Controlling Execution Flow
$Case Function
For Construct
While and Do/While Constructs
Try/Catch Construct, and Throw Command
Multiple Purpose Characters
Hands-On Exercise 2
Recap of Part 1

The Good Stuff

Strings
Storing a String
Concatenation Operator
Pattern Matching and Regular Expressions
Pattern Matching Examples
String Functions
String Functions, continued
Lists
Compare Pieces and Lists
Setting Substrings, Pieces, and List Items
More List Functions
Bitstrings
Dates
Hands-On Exercise 3
JavaScript Object Notation (JSON)
Arrays
Ordered Trees
Ordered Trees, continued
Value and Existence, and the $Data Function
Viewing and Killing Arrays
Globals
$Increment and $Sequence Functions
Storage Method
Storage Method, continued
Example of Globals
Hands-On Exercise 4
Recap of Part 2

Using Globals

$Order Function
$Order Function, continued
Working With Indexes
$Order Loop
Nested $Order Loops
Starting Focused $Order Loops
Ending Focused $Order Loops
Hands-On Exercise 5
Conversion Functions
$Get Function
Hands-On Exercise 6
Database Integrity
Lock Command
Lock Command, continued
Lock Command and $Test
Transaction Processing
Hands-On Exercise 7
InterSystems IRIS Objects and SQL
Object Methods
Object Storage
SQL Queries
Recap Of Part 3

RightTriangle Example Class and Exercise Solutions

Right Triangle Example Class
Exercise 1: First Data Entry Class
Exercise 2: Second Data Entry Class
Exercise 3: Third Data Entry Class
Exercise 4: Storage Method
Exercise 5: First Lookup Class
Exercise 6: Second Lookup Class
Exercise 7: Third Lookup Class

%Status Values
Try-Catch
Finding Class References

InterSystems API Manager (IAM)

About...
First Look
InterSystems API Manager (IAM)

SQL

About...
First Looks

InterSystems SQL
Optimizing SQL Performance

Using SQL

Introduction to InterSystems SQL
InterSystems SQL Basics
Language Elements
Identifiers
Defining Tables
Defining and Using Views
Relationships Between Tables
Modifying the Database
Querying the Database
Collation
Implicit Joins (Arrow Syntax)
Using Embedded SQL
Using Dynamic SQL
Using the SQL Shell Interface
Using the Management Portal SQL Interface
Importing SQL Code
Using Triggers
Defining and Using Stored Procedures
Storing and Using Stream Data (BLOBs and CLOBs)
Users, Roles, and Privileges
Importing and Exporting SQL Data

Optimizing SQL

Introduction to SQL Performance Optimization
Defining and Building Indices
Optimizing Tables
Cached Queries
Optimizing Query Performance
SQL Performance Analysis Toolkit
Interpreting an SQL Query Plan
SQL Statements
Frozen Plans

InterSystems SQL Reference

Symbols and Syntax Conventions
SQL Commands
SQL Commands for IntegratedML
SQL Predicate Conditions
SQL Aggregate Functions
SQL Window Functions
SQL Functions
SQL Unary Operators
SQL Reference Material

Using the InterSystems SQL Gateway

SQL Gateway Overview
Using the InterSystems SQL Gateway
Connecting the SQL Gateway via JDBC
Connecting the SQL Gateway via ODBC
Using the SQL Gateway Programmatically

Document Database

Introducing InterSystems IRIS Document Database (DocDB)
Managing Documents
REST Client Methods

XML

About...
XML Tools

Introduction to InterSystems XML Tools
Writing XML Output from Objects
Importing XML into Objects
Representing an XML Document as a DOM
Encrypting XML Documents
Signing XML Documents
Using %XML.TextReader
Evaluating XPath Expressions
Performing XSLT Transformations
Customizing How the InterSystems SAX Parser Is Used
Generating Classes from XML Schemas
Generating XML Schemas from Classes
Examining Namespaces and Classes
XML Background

XML Projections

Introduction to Object-XML Projections
Projecting Objects to XML
Controlling Transformations of Values
Handling Empty Strings and Null Values
Controlling the XML Element and Attribute Names
Specifying Namespaces for Elements and Attributes
Controlling the Projection to XML Schemas
Advanced Options for XML Schemas
Special Topics
Summary of XML Projection Parameters

Web Services

About...
Web Gateway Configuration Guide

Installing the Web Gateway
Web Application Architecture
Web Servers for Microsoft Windows
Web Servers for UNIX, Linux, and macOS
Web Gateway Operation and Configuration
Alternative Configurations for Microsoft Windows
Alternative Configurations for UNIX, Linux, and macOS
Apache Considerations UNIX, Linux, and macOS
Building Apache for IBM AIX®
IIS Technical Notes
Using Web Applications with a Remote Web Server

SOAP

About...
Creating SOAP Web Services and Clients

Introduction to Web Services and Web Clients in InterSystems IRIS
Creating SOAP Web Services
SOAP Message Variations
Creating Web Clients
SOAP Fault Handling
Using MTOM for Attachments
Using SOAP with Attachments
Adding and Using Custom Header Elements
Adding and Using WS-Addressing Header Elements
SOAP Session Management
Using the InterSystems IRIS Binary SOAP Format
Using Datasets in SOAP Messages
Fine-Tuning a Web Service in InterSystems IRIS
Fine-Tuning a Web Client in InterSystems IRIS
Troubleshooting SOAP Problems in InterSystems IRIS
Summary of Web Service URLs
Details of the Generated WSDLs
Details of the Generated Classes

REST and JSON

About...
First Look
REST Services

Introduction to Creating REST Services
Using the /api/mgmnt Service
Using the ^%REST Routine to Create REST Services
Using the %REST.API Class to Create REST Services
Modifying the Implementation Class
Modifying the Specification Class
Supporting CORS in REST Services
Using Web Sessions with REST
Securing REST Services
Discovering and Documenting REST APIs
Reference for the /api/mgmnt API
OpenAPI Properties in Use
Creating a REST Service Manually

REST API for Source Code

Introduction to the InterSystems IRIS Source Code File REST API
Source Code File REST API Tutorial
Source Code File REST API Reference

Using JSON

Introduction
Creating and Modifying Dynamic Entities
Iteration and Sparse Arrays
Working with Datatypes
Using the JSON Adaptor
Quick Reference for Dynamic Entity Methods

Internet Utilities

Introduction
Sending HTTP Requests
Sending and Receiving Email
Creating, Writing, and Reading MIME Messages
Using FTP
Sending and Receiving IBM WebSphere MQ Messages
Using SSH
Other InterSystems %Net Tools

I/O Device Guide

About I/O Devices
I/O Devices and Commands
Terminal I/O
Local Interprocess Communication
TCP Client/Server Communication
UDP Client/Server Communication
Sequential File I/O
Spool Device
Printers

Advanced Concepts

Locking & Concurrency
Bits & Bitstrings
Structured Logging
Semaphores
String Localization
Process Memory
Work Queue Manager
Secure Logins
Using %Library.File
%UnitTest Tutorial

Unit Testing Overview

What is a Unit Test?
Why Unit Test?
xUnit Testing Frameworks
Structure of %UnitTest and xUnit Frameworks
Test Automation
Test First Methodology
Red – Green – Refactor
Recap

Unit Testing with %UnitTest

What is %UnitTest?
Creating and Executing a Suite of Unit Tests
%UnitTest Classes
Assert Methods and Macros
Creating Classes to Use in the Examples
Example: Creating and Exporting a Test Class
Example: Executing a Test
Example: UnitTest Portal
Example: Viewing the Report in the Unit Test Portal
Setup and Tear Down
Example: Adding Setup and Tear Down Methods to a Test
Example: Executing a Test Using Setup and Tear Down Methods
Options for Executing Tests: Test Specs and Qualifiers
RunTest Examples
DebugRunTestCase
Exercises
Recap

API Index

Tools Index

Glossary

Complete Glossary of Terms

External Language Development

About...
Native APIs
Using InterSystems External Servers

Introduction to InterSystems External Servers
Working with External Languages
Managing External Server Connections
Customizing External Server Definitions
InterSystems External Server Requirements
Quick Reference for the ObjectScript $system.external Interface

Java

About...
First Looks

Java Gateway
Native API for Java
Java Object Persistence with XEP
JDBC and InterSystems Databases

Java Gateway

Introduction to the Java Gateway
Using Dynamic Object Gateways
Using the Java Gateway in a Production
Sample Code
Mapping Specification

Using Java with InterSystems Software

Document Overview
InterSystems Java Connectivity Options
Using the JDBC Driver
Configuration and Requirements
JDBC for Occasional Users
JDBC Quick Reference

Using the Native SDK for Java

Document Overview
Introduction to the Java Native SDK
Calling ObjectScript Methods and Functions
Using Java Inverse Proxy Objects
Working with Global Arrays
Transactions and Locking
Java Native SDK Quick Reference

Persisting Java Objects with InterSystems XEP

Introduction
Using XEP Event Persistence
XEP Quick Reference

Implementing Third Party APIs

Introduction
JDBC Driver Support
Apache Spark Support
Hibernate Support

Simple Data Transfer
JDBC

.NET

About...
First Looks

.NET Gateway
Native API for .NET
ADO.NET and InterSystems Products
.NET Object Persistence with XEP
ODBC and InterSystems IRIS

Using the Object Gateway for .NET

Object Gateway Architecture
Setting Object Gateway Server Properties
Running an Object Gateway Server
Using Dynamic Object Gateways
Creating Static Proxy Classes
Sample Code
Mapping Specification
Using the Object Gateway in a Production

Using .NET with InterSystems Software

Connecting to the InterSystems Database
Configuration and Requirements
ADO.NET Managed Provider for Occasional Users
Using the Entity Framework Provider
Quick Reference for the .NET Managed Provider

Using the Native API for .NET

Introduction to the Native API
Calling ObjectScript Methods and Functions
Using .NET Reverse Proxy Objects
Working with Global Arrays
Transactions and Locking
Native API for .NET Quick Reference

Persisting .NET Objects with InterSystems XEP

Introduction
Using XEP Event Persistence
XEP Quick Reference

ODBC

About...
Using the InterSystems ODBC Driver

Overview
Defining an ODBC Data Source on Windows
Defining an ODBC Data Source on UNIX®
ODBC Installation and Validation on UNIX® Systems
ODBC Support for Python and Node.js
Logging and Environment Variables

Python

About...
First Look
Using the Native API for Python

Introduction to the Native API
Working with Global Arrays
Calling ObjectScript Methods and Functions
Native API Quick Reference for Python

Node.js

About...
First Look
Using the Native API for Node.js

Introduction to the Native API
Working with Global Arrays
Calling ObjectScript Methods and Functions
Native API Quick Reference for Node.js

Callin

The Callin Interface
Using the Callin Functions
Callin Function Reference

Callout

Introduction
Running Programs or System Commands with $ZF(-100)
Creating an InterSystems Callout Library
Invoking Callout Library Functions
InterSystems Callout Quick Reference

Interoperability Productions

About...
First Look
Introducing Interoperability Productions

Introduction to Interoperability Productions
Connectivity Options
Business Processes and Business Logic
Other Production Options

Preparing to Create Productions

Road Map to Using InterSystems IRIS Productions
Planning an InterSystems IRIS Server Deployment

Best Practices

Best Practices for Production Development
Design Model for a Routing Production
Converting Interfaces to Production Elements

Developing Productions

About...
Developing Productions Using ObjectScript

Introduction
Programming Business Services, Processes and Operations
Defining Messages
Defining Business Services
Defining Business Processes
Defining Business Operations
Defining an Alert Processor
Defining Data Transformations
Defining Business Metrics
Defining an Enterprise Message Bank
Using the Record Mapper
Using the Complex Record Mapper
Handling Batches of Records Efficiently
Less Common Tasks
Testing and Debugging
Deploying a Production
Life Cycle of a Production and Its Parts

Developing Productions Using Java and .NET

Introduction
Getting Started
About Business Hosts and Adapters
Messaging
Inbound Adapters
Outbound Adapters
Business Services
Business Processes
Business Operations
Running the External Server
PEX API Reference

BPL and DTL

First Look
Developing BPL Processes

About BPL Processes
Using the Business Process Designer
Syntax Rules
List of BPL Elements
Handling Errors in BPL

Developing DTL Transformations

Introduction to DTL Tools
Creating Data Transformations
Syntax Rules
Adding Assign Actions
Adding Other Actions
Testing Data Transformations

BPL and DTL Reference

BPL Elements
DTL Elements

Using a Production as an ESB

Enterprise Service Bus and Registry Overview
Accessing the Public Service Registry through the Public REST API
Administering the Public Service and External Service Registries
Configuring an ESB
Configuring ESB Services and Operations
Configuring an InterSystems IRIS System and Creating a Namespace
Configuring a Web Application for a Pass-through Business Service
Pass-through Service and Operation Walkthrough
Service Registry Public API Reference

Configuring, Managing, and Monitoring Productions

About...
Configuring Productions

Introduction to Configuration Tasks
Creating a Production
Adding Business Hosts
Configuring Settings
Configuring Alerts
Defining Reusable Items for Use in Settings
Defining Other Options for Productions
Configuring the Enterprise Message Bank
Identifying Enterprise Systems for Viewing and Monitoring
Creating Dashboards
Settings in All Productions

Managing Productions

Introduction to Managing Productions
Starting and Stopping Productions
Purging Production Data
Using the Archive Manager
Managing Workflow Roles, Users, and Tasks
Defining Publish and Subscribe Message Routing
Controlling Data Storage for Productions
Controlling Access to Management Portal Functions
Finding Information on Menu Items

Monitoring Productions

Core Concepts
Monitoring All Namespaces
Monitoring a Production
Viewing, Searching, and Managing Messages
Viewing the Event Log
Enabling Tracing
Viewing the Business Rule Log
Viewing Business Process Instances
Viewing the I/O Archive for a Production
Viewing Messages from Multiple Productions
Using the Enterprise Message Viewer
Using the Enterprise Message Bank
Viewing Interface Maps
Finding Interface References
Monitoring Alerts
Monitoring Activity Volume
Managing Port Usage

Push Notifications

Push Notifications Overview
Configuring and Using Push Notifications

Defining Workflows

Overview of Workflow within Productions
Developing a Workflow
Including Custom Features in a Workflow
Testing a Workflow
Exploring the Workflow Sample
Available Workflow Metrics

Testing Productions

Testing Productions Tutorial
Testing Productions

TestControl
Callback Methods
Auxiliary Methods
Parameters and Properties
Creating a Test - Summary
Executing a Test
Example Overview
Example: Example Production
Example: Production Test
Example: OnAfterProductionStart
Example: CheckResults
Example: CheckErrors
Example: Executing the Test
Recap

Creating Tutorial.ExampleOperation

HealthCare Data Formats

FHIR Support in InterSystems Products

About FHIR
FHIR Server: An Introduction
Installing and Configuring a FHIR Server
Customizing a FHIR Server
Custom FHIR Operations
Supported Interactions and Operations
FHIR Profiles and Adaptations
FHIR Interoperability Adapter
Interoperability Productions
SDA-FHIR Transformations
FHIR Clients
ObjectScript Applications
Requests and Responses
FHIR Data
FHIRPath
Server Security
Server Debugging
Server Maintenance
Legacy FHIR Technology

Summary Document Architecture (SDA)

About SDA
SDA Documents
Customizing the SDA

CDA Interoperability with SDA

CDA Documents and XSL Transforms
Customizing CDA XSL Transformations
Preprocessing C-CDA 2.1 Documents
CDA and SDA Annotations

IHE Use Cases

Introduction
Supported IHE Transactions
Performing PIX and PDQ Queries Against an EMPI
Adding or Updating Demographic Data Held in an EMPI (PIX Add)
Querying an XDS Registry and Retrieving a Document from a Repository
Providing and Registering Documents to an XDS Document Repository
Querying and Retrieving a Document from another Affinity Domain (XCA)
Generating a C-CDA Document from an HL7 Message
Generating a C-CDA Document by Querying an Internal Database
Receiving a C-CDA Document and Converting it to an Internal Format
Using Cross-Enterprise User Assertion (XUA)
Internet User Authorization (IUA) Support
Cross-Community Access for Imaging (XCA-I)
Registry Settings for IHE Communication
Using the IHE Test Utility
Auditing

Data Transformations in InterSystems Healthcare Products
Enhanced Debugging of Healthcare Business Hosts

Connecting Systems

About...
Supported Formats
Supported Protocols
Email Adapters

Using the Email Inbound Adapter
Using the Email Outbound Adapter
Reference for Settings

File Adapters

Using the File Inbound Adapter
Using the File Outbound Adapter
Using the File Passthrough Service and Operation Classes
Reference for Settings

FTP Adapters

Using the FTP Inbound Adapter
Using the FTP Outbound Adapter
Reference for Settings

HTTP Adapters

About the HTTP Adapters
Using the HTTP Inbound Adapter
Using the HTTP Outbound Adapter
Reference for Settings

Java Messaging Service (JMS)

JMS Overview
Configuring and Using JMS Business Services and Operations
Creating Custom JMS Services and Operations Using the Adapter

IBM WebSphere MQ Adapters

About the IBM WebSphere MQ Adapters
Using the IBM WebSphere MQ Inbound Adapter
Using the IBM WebSphere MQ Outbound Adapter
Troubleshooting
Reference for Settings

MQTT Adapters

Introduction to Message Queuing Telemetry Transport (MQTT)
Using the MQTT Adapters
Configuring and Using the MQTT Passthrough Business Service and Operation
Reference for Settings

REST Services and Adapters

Overview of Using REST in Productions
Creating REST Services in Productions
Creating REST Operations in Productions

SOAP Services and Web Clients

About SOAP and Web Services
Creating a Web Service in a Production
Creating a Web Client in a Production
Configuring a Production for SOAP Services
Using the SOAP Inbound Adapter
Older Web Service Variation
Reference for Settings

SAP Java Connector

Overview
Setup Tasks
Using the SAP Java Connector

SQL Adapters

About the SQL Adapters
Using the SQL Inbound Adapter
Using the SQL Outbound Adapter
Creating Adapter Methods for SQL
Using Result Sets
Using Snapshots

TCP Adapters

Using the Inbound TCP Adapters
Using the Outbound TCP Adapters
Special Topics
Reference for Settings

Managed File Transfer

First Look
MFT Services

Introduction
Prerequisites and Configuration
Enabling a Production to Use MFT Services
Using the MFT API for InterSystems IRIS

Using the NHS Interoperability Toolkit

Overview
Setting Up the ITK Switchboard
Using the ITK Adapter Kit

Routing ASTM, DICOM, EDIFACT, HL7, X12, and XML Documents

About...
Using Virtual Documents in Productions

Virtual Documents
Schema Definitions
Virtual Property Paths
Using Virtual Documents in a Production
Defining Search Tables
Controlling Message Validation
Creating Custom Schema Categories
Portal Tools
Syntax Guide for Virtual Property Paths
Common Settings

ASTM

Introduction
Available Tools
Configuring the Production
Additional Steps
Reference for Settings

DICOM

Introduction
Creating DICOM Associations
Tasks for DICOM Productions
Sample DICOM Modality Worklist Production
Sample DICOM Routing to Storage Production
Sample DICOM File Storage Production
Sample DICOM Router Productions
DICOM Transfer Syntax
DICOM Glossary of Terms

EDIFACT

Introduction
Available Tools
Configuring the Production
Additional Steps
Reference for Settings

HL7 Version 2

Introduction
HL7 Schemas and Available Tools
Configuring the Production
Defining Routing Rule Sets for HL7
Defining DTL Data Transformations for HL7
Defining HL7 Search Tables
Important HL7 Scenarios
Reference

X12

Introduction
X12 Schemas and Available Tools
Configuring the Production
Creating an X12 Data Transformation
Handling X12 Interchanges
Reference for Settings

XML

Introduction
Available Tools
Configuration Steps
Overview of Property Paths in XML Virtual Documents
Specifying Schema-dependent Paths for XML Virtual Documents
Specifying DOM-style Paths for XML Virtual Documents
Defining Data Transformations for XML Virtual Documents
Defining Rule Sets for XML Virtual Documents
Defining Search Tables for XML Virtual Documents
XML-Enabled Objects Compared to XML Virtual Documents
Reference for Settings

Developing Business Rules

About Business Rules
Introduction to the Rule Editor
Creating and Editing Rule Sets
Debugging Routing Rules
Utility Functions for Use in Productions

Analytics and Data Science

About...
Business Intelligence

About...
InterSystems IRIS Adaptive Analytics
BI Introduction

Introduction to Business Intelligence
Introduction to the Business Intelligence User Interfaces
Introduction to the Other Business Intelligence Tools
Business Intelligence Glossary

BI Modeling

Introduction
Basic Concepts
Summary of Model Options
Principles and Recommendations
Defining Models for InterSystems Business Intelligence
Compiling and Building Cubes
Defining Dimensions, Hierarchies, and Levels
Details of Defining Levels
Defining Properties
Defining Measures
Defining Listings
Defining Listing Fields
Defining Calculated Members
Defining a Named Set
Defining Subject Areas
Defining Listing Groups
Reference Information for Cube Classes
Reference Information for Subject Area Classes
Details for the Fact and Dimension Tables

BI Advanced Modeling

Defining Computed Dimensions
Defining Shared Dimensions and Compound Cubes
Defining Cube-Cube Relationships
Using Text Analytics in Cubes
Defining Term Lists
Defining Worksheets
Defining Quality Measures
Defining Basic KPIs
Defining KPIs with Filters and Listings
Defining Advanced KPIs
Defining Plug-ins
Using Cube Inheritance
Defining Intermediate Expressions
Other Options
Reference Information for KPI and Plug-in Classes
Generating Secondary Cubes for Use with Text Analytics

Using Dashboards and the User Portal

Introduction to the User Portal
Using the Portal Features
Orientation to Dashboards
Using Dashboards
Using the Pivot Analysis Window

BI Dashboards

Introduction to Dashboards
Creating and Modifying Dashboards
Specifying Common Widget Options
Adding Pivot Table Widgets
Adding Chart Widgets
Customizing the Appearance of a Chart Widget
Adding Meter Widgets
Adding Scorecard Widgets
Adding Other Widgets
Defining and Using Themes
Adding Widget Controls

Implementing InterSystems IRIS Business Intelligence

Overview
Performing the Initial Setup
Configuring Settings
Defining Data Connectors
Performance Tips
Defining Custom Actions
Accessing Dashboards from Your Application
Keeping the Cubes Current
Executing Business Intelligence Queries Programmatically
Performing Localization
Packaging Business Intelligence Elements into Classes
Creating Portlets for Use in Dashboards
Other Development Work
Setting Up Security
Using Cube Versions
How the Analytics Engine Works
Using the MDX Performance Utility
Diagnostics for InterSystems Business Intelligence
Other Export/Import Options
Business Intelligence and Disaster Recovery

BI Analyzer

Introduction to the Analyzer
Creating Pivot Tables
Filtering Pivot Tables
Defining Calculated Elements
Defining and Using Pivot Variables
Customizing Pivot Tables
Working with Pivot Tables
Performing Ad Hoc Analysis
Configuring InterSystems IRIS for PDF Output

Using MDX

Background
Introduction to MDX Queries
Working with Levels
Working with Dimensions and Hierarchies
Working with Sets
Tuples and Cubes
Filtering a Query
Adding Summaries
Creating Calculated Measures and Members

MDX Reference

Basic Rules
Expression Types
MDX Statements and Clauses
MDX Functions
Intrinsic Properties
NOW Member for Time Levels
Quick Function Reference

Power BI
BI Clients

Introduction
DeepSee.js
Business Intelligence REST API

BI Tutorial

Getting Started
Introduction to Cube Elements
Creating a Cube
Expanding the Cube Definition
Creating Subject Areas
Creating and Packaging Pivot Tables and Dashboards

Apache Spark

About...
Using the InterSystems Spark Connector

Document Overview
Introduction
Spark Connector Data Source Options
Using Spark Connector Extension Methods
Spark Connector Best Practices
Spark Connector Internals
Spark Connector Quick Reference

Machine Learning

About...
Using IntegratedML

Introduction to ML
IntegratedML Basics
Providers
ML Configurations
Model Maintenance
About AutoML
SQL Commands
SQL Functions

Text Analytics (Natural Language Processing)

About...
Text Analytics with InterSystems Products
Using NLP

Conceptual Overview
NLP Implementation
Domain Architect
REST Interface
Alternatives for Creating an NLP Environment
Loading Text Data Programmatically
Performance Considerations when Loading Texts
NLP Queries
Semantic Attributes
Stemming
Skiplists
Filtering Sources
Text Categorization
Dominance and Proximity
Custom Metrics
Smart Matching: Creating a Dictionary
Smart Matching: Using a Dictionary
User Interfaces
IRIS Natural Language Processing (NLP) Tools
iKnow Web Services
KPIs and Dashboards
Customizing NLP
Language Identification
Domain Parameters

SQL Search

About...
First Look
Using SQL Text Search

InterSystems SQL Search Tool
SQL Search REST Interface

Unstructured Information Management Architecture

About...
InterSystems IRIS and UIMA
Using UIMA

Overview

Predictive Modeling Markup Language
InterSystems Reports

Introduction
InterSystems Reports Designer
InterSystems Reports Server with InterSystems IRIS

Class Reference

Using Python Gateway Connections

Updating Python Gateway Code

Feedback

View this item as PDF Download all PDFs

Privacy & Terms Guarantee Section 508

Cookies Settings Cookie List

Content date/time: 2021-09-21 06:00:02

DocReleaseID: IRISforHealth2021.1