1. 1 ISO 21090 Data Types Adoption - The Plan and the Tools Architecture/VCDE Joint Face-to-Face June 3, 2010 St. Louis, Missouri Sichen Liu CBIIT Core Infrastructure Engineering

2. Agenda Background Guidelines Overview of the NCI CBIIT Localization of the ISO 21090 Data Types Infrastructure Tools Support 2

3. Background The ISO 21090 data type standard is based on the considerable effort over an extended period of time by a group of international healthcare informatics experts from the US, Canada, Australia, and Europe representing ISO, CEN, and HL7. As a critical step in defining, designing, developing, and deploying software components that enable computable semantic interoperability across multiple technology platforms, the Enterprise Conformance and Compliance Framework (ECCF) that has been adopted by NCI CBIIT requires that each attribute of a static information model should be bound to a robust data type specification that fully and unambiguously expresses the semantics of the attribute. NCI CBIIT has identified the ISO 21090 standard to meet this need

4. Guidelines Use of ISO 21090 data types is required for NCI CBIIT-funded projects. Every project will be required to utilize the NCI CBIIT “localization” of the data type, as defined in the ISO 21090 PIM (Platform Independent Model). Any NCI CBIIT-funded project wishing an exception will be required to receive a waiver from the architecture governance team A list of approved ISO 21090 data type localizations will be maintained by NCI CBIIT and implementation package. Approved localizations exist for nearly half of the data types in the standard. A list of existing localizations can be found at https://wiki.nci.nih.gov/display/ISO21090/CBIIT+Localizations https://wiki.nci.nih.gov/display/ISO21090/CBIIT+Localizations An overall project manager (called as “ISO Project Manager”) will maintain the content and be primary point of contact for project teams

5. Guidelines (cont.) NCI CBIIT has chosen to develop new localizations through “pilot projects.” A pilot project will provide the definition for the new data type along with the required documentation. When a project which identifies a need for an ISO 21090 data type that does not yet have a NCI CBIIT localization, that team will identify this need to the ISO Project Manager, who will propose a pilot project to the architecture governance team, which will identify a pilot project. (The pilot project may be the project which identified the need.) Projects considering using data types that are not in the “approved” list are required to contact ISO Project Manager to determine if there is an existing “pilot” effort. The project team is expected to coordinate with any existing pilot effort to ensure that both projects will be able to leverage the data type definitions resulting from the pilot project activity

6. Guidelines (cont.) If a project cannot use the existing implementation of “approved” data types, the project team will be required to coordinate with the ISO Project Manager and provide reasons, including specific enhancements needed before using the data types and a timeline for conforming to the standard. The waiver will be reviewed by the architecture governance team.

7. NCI CBIIT Localization of the ISO 21090 Data Types 7 Specialized/constrained version of the ISO 21090 Data Types Standard Relationship to the ISO Standard This version refers to ISO 21090 (2007-09-24) When a new version is available, conformance to the new version may be needed Conformance and Compliance - Indirect Mappings between internal data types and the Standard Inward mapping, outward mapping, no mapping XML representation Detailed Information - The ISO 21090 PIM https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/documents/PIM_21090.doc

8. NCI CBIIT Localization of the ISO 21090 Data Types (cont.) 8 Localized Classes

9. NCI CBIIT Localization of the ISO 21090 Data Types (cont.) 9 Data Types in the localization https://wiki.nci.nih.gov/display/ISO21090/CBIIT+Localizations

10. NCI CBIIT Localization of the ISO 21090 Data Types (cont.) 10 Syntax, and the inward and outward mappings for each data type Basic Data Types – ANY, BL Text And Binary Data Types – ED, ST, SC Coded Data types (Terminology) – CD Identification and Location Data Types – II, TEL Name and Address Data Types – AD, EN Quantity Data Types – QTY, PQ, TS, REAL Collections Of Data Types – COLL, DSET Continuous Set Data Types – QSET, IVL Unmapped Data types

11. Infrastructure Tools Support - Need for ISO 21090 Enabled Tooling It is needed for the infrastructure tools to support the NCI CBIIT localization of ISO 21090 data types. Current infrastructure tools use primitive data types (string, integer, double etc) to create the services. It is necessary to enhance the existing tools (caCORE SDK, caAdapter, Introduce) to support the ISO 21090 data types in addition to the other primitive data types that were already supported 11

12. Infrastructure Tools Support - Goals Overarching Goal Provide tooling support for automated creation and deployment of services using ISO 21090 data types compliant with SAIF and ECCF to ease adoption of ISO 21090 data types Short Term Goal Provide support for NCI localizations of ISO 21090 data types in caCOE SDK, caAdapter, and Introduce for service creation and deployment on the caGrid Infrastructure

13. Infrastructure Tools Support - Iteration 1 Develop Object and Data Models with UML modeling tool (Enterprise Architect or ArgoUML) Use caAdapter MMS (Model Mapping Service) to easily map elements between Object and Data Models Use caCORE SDK to generate the Java code and RESTful APIs Use Introduce to create a caGrid Data Service and Analytical Service 13

14. Infrastructure Tools Support - Iteration 1: tools enhancements SDK Code Generation framework for UML Models based on the ISO 21090 data types SDK Java API to support the ISO 21090 data types SDK generated Middleware System for retrieving data based on ISO 21090 data types caAdapter Model Mapping Service for mapping ISO 21090 enabled object model to relational database caGrid/Introduce Toolkit caGrid Analytical Service and Data Service with ISO 21090 data types CQL query support for ISO 21090 data types

15. Infrastructure Tools Support - Iteration 1: current status Preliminary support for the NCI CBIIT’s localization of the ISO 21090 data types ISO 21090 enabled infrastructure tools includes caAdapter, caCORE SDK, and Introduce These tools will allow the developers to Generate Local and Remote Java API, RESTful XML service from a UML model with ISO 21090 data types using caCORE SDK Create caGrid Analytical service with ISO 21090 data types Create caGrid Data Service from caCORE SDK’s Java API with ISO 21090 data types using Introduce 15

16. Infrastructure Tools Support - Iteration 1: major features ISO 21090 Data Types Library Localized Java API implementation of selected data types from ISO 21090 data types standard Database Mapping framework for localized Java API using Hibernate XML Serialization framework for localized Java API using JAXB caAdapter Logical Model to Data Model mapping support for ISO 21090 data types caCORE SDK Code Generation framework for UML Models based on ISO 21090 data types UML Features Supported: Classes, Association, Generalization, Primitive data types, ISO 21090 data types Commonly used Model Mapping Features Commonly used mapping options

17. caCORE SDK (continued) caCORE SDK generated Middleware System for retrieving data based on ISO 21090 data types Local Java API Remote Java API RESTful XML API CSM and Grid Security caGrid/Introduce Analytical Service extension to enable easy usage of ISO 21090 data types CQL query support for ISO 21090 data types as supported by the SDK Introduce Data Service creation wizard for the new version of the SDK Infrastructure Tools Support - Iteration 1: major features (cont.)

18. Infrastructure Tools Support - Next Step Working with the community to identify additional requirements for tooling support Full support for the ISO 21090 data types standardized by NCI Support for multiple versions and multiple implementation of ISO 21090 in the infrastructure tools Integrated open source technology solution, and integration with the new semantic infrastructure (v2) to ensure metadata registration and retrieval for ISO 21090 data types Integration support for ISO 21090 data types enabled systems 18

19. Acknowledgements NCI-CBIIT/SAIC-F Management Sichen Liu Avinash Shanbhag Sreenath Nampally Project Management Satish Patel (Ekagra) John Eisenschmidt (Lantern Three) Ye Wu (SAIC) Elizabeth Prince (Sapient) Architecture Satish Patel (Ekagra) Ye Wu (SAIC) Scott Oster (OSU/Inventrio) Raghu Chintalapati (Ekagra) caCORE SDK Team Satish Patel (Ekagra) Vijay Parmar (Ekagra) Santhosh Garmilla (Ekagra) Dan Dumitru (Ekagra) Prasad Konka (SAIC) caAdapter Team Ye Wu (SAIC) Eugene Wang (SAIC) caGrid Team Scott Oster (OSU/Inventrio) Shannon Hastings (OSU/Inventrio) David Ervin (OSU) Justin Permar (OSU) Calixto Melean (OSU) QA Team Ye Wu (SAIC) Aynur Abdurazik (SAIC) Xiaoling Chen (SAIC) Documentation John Eisenschmidt (Lantern Three) Ann Wiley Bronwyn Gagne Carolyn Klinger Jill Hadfield 19

20. Resources The approved guidelines are at the eCAT wiki site https://wiki.nci.nih.gov/display/ISO21090/ISO+21090+Wiki+Home+Page The ISO 21090 standard can be found at https://wiki.nci.nih.gov/login.action?os_destination=%2Fdownload%2Fattach ments%2F25004394%2FPublished%2BISO%2Bstandard.pdf The ISO 21090 PIM can be found at https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/documents/PIM_21090.doc The ISO 21090 XSD (NCI CBIIT Localization) can be found at https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/code/extensions/src/main/xsd/I SO_datatypes_Narrative.xsd NCI CBIIT Localization Implementation - Java library https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/code/localization/ NCI CBIIT Localization Implementation - XML transformation framework https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/code/extensions NCI CBIIT Localization Implementation - database mapping framework https://ncisvn.nci.nih.gov/svn/ISO21090/trunk/code/hibernate

21. Questions 21