Een psychologische kijk op arbeidsrelaties Aukje Nauta

1. ECCF Training Computationally Independent Model (CIM) ECCF Training Working Group March 2011

2. Translation the specification formerly known as "Computationally Independent Model" (CIM) "Conceptual Perspective" = To maintain consistency between this training material and its source documentation and other references, the original term "CIM" will be used in this module to refer to what is know known as the "CP"

3. Outline • Introduction • Review of ECCF • What is a CIM? • Viewpoints for a CIM • Development of a CIM • CIM Template and Example • Review and Relationship to PIM • References

4. ECCF • ECCF combines: • The Model-Driven Architecture (MDA) layered approach to software design • Viewpoints defined by the Reference Model for Open Distributed Processing (RM-ODP)

5. What is a CIM? Computationally Independent Model (CIM) The most abstract MDA layer (conceptual) CIM specification Detailed analysis document that specifies a given business capability Documents both "what" and "why" Contains: Service capabilities Traceability to requirements Service information model Service behavioral semantics Structured to address each of the RM-ODP viewpoints Enterprise Information Computational/Behavioral Engineering/Implementation 5

6. RM-ODP Viewpoints for the CIM • Enterprise Viewpoint • Scope and vision • Business objectives and policies • Use cases and storyboards • Core functional and non-functional requirements • Service capabilities

7. RM-ODP Viewpoints for the CIM Information Viewpoint Information model describing the entities used by the service Constrained domain analysis model (DAM) Includes classes, attributes, datatypes, and value sets Dynamic schema (state diagrams for entities) 7

8. RM-ODP Viewpoints for the CIM Computational/Behavioral Viewpoint Service capabilities and constraints Including roles and functional profiles (aggregate service capabilities) Interactions with and dependencies on other services Describes the role of a system in overall business interactions Activity, sequence, or state diagrams 8

9. RM-ODP Viewpoints for the CIM Engineering/Implementation Viewpoint Populated as needed Functions required to support the computational components Software platforms and environments Deployment/architecture requirements and constraints 9

10. CIM Development • Based on artifacts developed during the requirements analysis phase • Examples include (but are not limited to): • Vision/Scope Document • Business Case Document • Use Case Model • Analysis Model • Design Model • Information Model • Architectural Diagrams/Document/Models • User Interface Model • Conformance Statements • Standards Documents • Glossaries

11. CIM Development CIM development is iterative Artifacts are refined during development Top-down (business model) or bottom-up (implementations) NCI CBIIT created a template for CIM specifications Contains all required/optional components Viewpoints are built-in 11

12. Outline Introduction CIM Template and Example In-class exercises Review and Relationship to PIM References 12

13. NCI CBIIT CIM Template Table of Contents • Overview and business case • Business storyboards • Detailed functional model • Profiles • System implementation details • Conformance and compliance • Appendix A: Relevant standards • Appendix B: References • Appendix C: Glossary • Appendix D: Cross reference tables • Contains all required/optional components • Viewpoints are built-in • http://tinyurl.com/NESdocs

14. CIM Specification Training • Walk through the CBIIT CIM template • Discuss contents, purpose, intent of each section • http://tinyurl.com/NESdocs • "CIM Service Specification Template" • Study an example • Molecular Annotation (MA) CIM • http://tinyurl.com/CIMfiles • CIMSS_Molecular_Annotation_Service.doc • Hands-on exercises • Subject Registration (SR) CIM • http://tinyurl.com/CIMfiles • Questions: CIM_Subject_Registration_Service_021811_4training.doc • Answers: CIM_Subject_Registration_Service_021811.doc

15. 1. Overview and Business Case • Service description and purpose • Description of the service • Business purpose of the specification • Description of the functional capabilities in business terms • Potential value to stakeholders and consumers • Scope • Overall potential scope of the service • Including specific exclusions • Assumptions • Related to scope

16. Overview and Business CaseExample: MA Service • Service description and purpose …Annotations providing detailed information on the molecular origin, biological process, and genetic alterations of associated experiment data can provide important insight on experimental outcomes. The Molecular Annotation Service provides a standardized set of interfaces for querying molecular (e.g. genomic, pathway) annotations. The purpose of this service is to provide a set of capabilities for retrieving molecular annotations… There are a variety of molecular annotations… The development of a common, reusable set of interfaces provided by this service will facilitate standardization, integration, and interoperability between various systems that provide and consume of molecular annotations. This service specification provides a key infrastructure component for NCI to support molecular annotations originating from other systems. This service serves as a main platform for integrating molecular annotations among all heterogeneous systems/components independent of platform within the integrative cancer research domain.

17. Overview and Business CaseExample: MA Service • In Scope • Molecular annotations, including lexical search • Functional associations, cellular locations, biological processes, genetic variations, diseases, and agents associated with a gene • Physical location of a gene • Homologous genes • Genomic annotations by microarray reporter • Out of Scope • Other types of annotations, including those for miRNAs, proteins, pathways, and other associations • Assumptions • Annotations will be retrieved using standard identifiers • No security constraints

18. 2. Business Storyboards • Define a set of business scenarios in which the service will be used • Should be sufficient but not exhaustive • Provide an overview of the business scenario • Provide a list of actors • People (roles) • System

19. Business StoryboardsExample: MA Service • Overview …The storyboards provided here cover two individuals looking for annotations for their specific data, as well as two external systems which would like to fully integrate with a molecular annotation service. • Actors

20. Business StoryboardsExample: MA Service • MA-SB1 – Researcher Initiated Molecular Annotations

21. 3. Detailed Functional Model • Structure of the Service • List of capabilities • Detail of the Capabilities • Description • Pre- and Post-Conditions • Security • Inputs and Outputs • Exception Conditions • Aspects Left for Technical Bindings

22. Detailed Functional ModelExample: MA Service [M] = Mandatory, [O] = Optional

23. Exercise • Refer to the Subject Registration CIM • http://tinyurl.com/CIMfiles • CIM_Subject_Registration_Service_021811_4training.doc • Review background information • Note: Focus on the yellow-highlighted sections • Section 1: Overview and business cases • Section 2: Business storyboards • Section 3.1: List of capabilities

24. Exercise • Fill in the blanks for the following capabilities • Initiate Subject Registration (page 22) • Enroll Subject (page 25) • Take Subject Off Study (page 28) • Query Subject Registration (page 31) • Discuss as a group • http://tinyurl.com/CIMfiles • Answers: CIM_Subject_Registration_Service_021811.doc

25. 4. Profiles • Functional Profiles • Groupings of similar or related capabilities • Defined from the perspective of the consumer of the operations • Semantic Profiles • Constrained information models • Derived from standard models (e.g., HL7 RIM, BRIDG) • Define objects that are used by the service capabilities • Conformance Profiles • Combinations of functional and semantic profiles • 1 or more functional profiles + exactly 1 semantic profile • Defines a set of coherent capabilities against which conformance can be claimed

26. Functional ProfilesExample: MA Service • Groupings of similar or related capabilities

27. Semantic ProfilesExample: MA Service Sequence Annotation Location Sequence Constrained from LS DAM 1.1 Gene Organism BRIDG::Drug SNP Gene ID • Constrained information models • Objects that are used by the service capabilities • "The MA service binds to and complies with the semantics of the LSDAM v1.1 information model."

28. Conformance ProfilesExample: MA Service • Combinations of functional and semantic profiles • 1 or more functional profiles + exactly 1 semantic profile

29. Exercise • Refer to the Subject Registration CIM • http://tinyurl.com/CIMfiles • CIM_Subject_Registration_Service_021811_4training.doc • Review background information • Section 4.1: Functional profiles • Section 4.2: Semantic profiles • Complete Section 4.3 (conformance profiles) • The first one is done for you • Discuss as a group

30. 5. System Implementation Details • Runtime interaction details • Define complex sets of interactions or dependencies • Illustrate business scenarios that use multiple operations of the service in specific sequences • May use UML activity or sequence diagrams • Implementation/deployment considerations • May include dependencies on existing infrastructure

31. System Implementation DetailsExample: MA Service • No runtime interactions • Implementation considerations • The specification does not specify the behavior of the objects • e.g., lazy loading, eager loading • Deployment considerations • The MA service could be deployed on the same system as the caBIO database, which may be used by the MA service

32. 6. Conformance and Compliance • Testable, verifiable statements • Made in the context of a single RM-ODP viewpoint • May have hierarchical relationships within a given viewpoint • At the CIM level, statements may refer to compliance of artifacts at the PIM and PSM levels • Examples of conformance statements • http://tinyurl.com/NESdocs

33. Conformance and ComplianceExample: MA Service

34. 7-10. Appendices A-D • Appendix A: Relevant Standards • List of potentially relevant standards • Relationship to the specification • Implications of deployment in environments that use alternative standards • Appendix B: References • Appendix C: Glossary • Appendix D: Cross Reference Tables • List of storyboards • Mapping of capabilities to storyboards • Operations used by actors

35. 7-10. Appendices A-DExample: MA Service • Appendix A: Relevant Standards • LS DAM • BRIDG • LS BAM • HUGO gene nomenclature • Appendix B: References • MA service scope and description document • Appendix C: Glossary • Domain-specific (rather than enterprise-wide) terms • Appendix D: Cross Reference Tables • List of storyboards • Mapping of capabilities to storyboards • Operations used by actors

36. NCI CBIIT CIM Template Table of Contents Overview and business case Business storyboards Detailed functional model Profiles System implementation details Conformance and compliance Appendix A: Relevant standards Appendix B: References Appendix C: Glossary Appendix D: Cross reference tables • Contains all required/optional components • Viewpoints are built-in • http://tinyurl.com/NESdocs 36

37. Outline Introduction CIM Template and Example Review and Relationship to PIM References 37

38. Review of the CIM Computationally Independent Model (CIM) The most abstract MDA layer (conceptual) CIM specification Detailed analysis document that specifies a given business capability Documents both "what" and "why" Contains: Service capabilities Traceability to requirements Service information model Service behavioral semantics Structured to address each of the RM-ODP viewpoints Enterprise Information Computational/Behavioral Engineering/Implementation 38

39. Enterprise Viewpoint Scope and vision Business objectives and policies Use cases and storyboards Core functional and non-functional requirements Service capabilities Information Viewpoint Information model describing the entities used by the service Constrained domain analysis model (DAM) Includes classes, attributes, datatypes, and value sets Dynamic schema (state diagrams for entities) RM-ODP Viewpoints for the CIM • Computational/Behavioral Viewpoint • Service capabilities and constraints • Including roles and functional profiles (aggregate service capabilities) • Interactions with and dependencies on other services • Describes the role of a system in overall business interactions • Activity, sequence, or state diagrams • Engineering/Implementation Viewpoint • Populated as needed • Functions required to support the computational components • Software platforms and environments • Deployment/architecture requirements and constraints 39

40. NCI CBIIT CIM Template Table of Contents Overview and business case Business storyboards Detailed functional model Profiles System implementation details Conformance and compliance Appendix A: Relevant standards Appendix B: References Appendix C: Glossary Appendix D: Cross reference tables • Contains all required/optional components • Viewpoints are built-in • http://tinyurl.com/NESdocs 40

41. Outline Introduction CIM Template and Example Review and Relationship to PIM References 41

42. References • NCI SAIF IG • NCI CBIIT CIM Template • NCI CBIIT SAIF Best Practices, Policies, and Patterns • Molecular Annotation CIM Specification • Subject Registration CIM Specification