276 hl7 2024 jan enhance explanation of soa aspects of the sdcsdpi sp…

…ecification (#356) * Updated description of SOA applied to MDI ChangeLog entry for #276 References added to Bibliography section TF-1B Updated content added to 1:10.4.1.1 SOA & SOMDS Architecture Alignment * Updated description of SOA applied to MDI ChangeLog entry for #276 References added to Bibliography section TF-1B Updated content added to 1:10.4.1.1 SOA & SOMDS Architecture Alignment * Corrected CHANGELOG conflict (by rebasing onto master) * Updated description of SOA applied to MDI ChangeLog entry for #276 References added to Bibliography section TF-1B Updated content added to 1:10.4.1.1 SOA & SOMDS Architecture Alignment * Corrected CHANGELOG conflict (by rebasing onto master) --------- Co-authored-by: Todd "AFC!" Cooper <[email protected]>
IHE · Dec 13, 2024 · 9e4509b · 9e4509b
1 parent 18c5ef7
commit 9e4509b
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 1 deletion.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -23,6 +23,8 @@ Each section shall contain a list of action items of the following format: `<bri
 - Bibliography note added indicating the rationale for the subcategories ([#266](https://github.com/IHE/DEV.SDPi/issues/266))
 - SDPi Use Case Approach explanatory text added to start of supplement ([#263](https://github.com/IHE/DEV.SDPi/issues/263))
 
+- Enhanced explanation of SOA aspects of the SDC/SDPi specification (HL7 Ballot) ([#276](https://github.com/IHE/DEV.SDPi/issues/276))
+
 ### Editorial Fixes
 - Added deprecation notice for three requirements due to expected impact of BICEPS standard corrigendum ([#334](https://github.com/IHE/DEV.SDPi/issues/334))
 - Updated SDPi "Topic of Interest" issue management for clarity ([#274](https://github.com/IHE/DEV.SDPi/issues/274))

diff --git a/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc b/asciidoc/volume1/tf1-ch-10-sdpi-p.adoc
@@ -797,7 +797,12 @@ This generalized model includes (3) system roles:
 * #same system can support both roles; all systems mush support participant#
 ////
 
-NOTE:  A detailed overview of <<acronym_soa>> concepts is beyond the scope of this specification.  See <<vol1_appendix_b_references>> for additional background materials.
+As SOA concepts and implementations have evolved, many different approaches have been defined, building upon some of the basic principles (as listed above) and adding detail appropriate for their specific application use.
+A detailed overview of <<acronym_soa>> concepts is beyond the scope of this specification; however, a number of foundational references related to how SOA has been leveraged for medical device interoperability have been provided in <<vol1_appendix_b_references>>, including:
+
+. <<ref_paper_connecting_clinical_it_to_soa_arch_of_medical_devices>>
+. <<ref_ornet_soa_for_safe_dynamic_medical_device_interoperability>>
+. <<ref_paper_design_pattern_for_soa_integration_of_medical_devices>>
 
 The <<acronym_sdc>> <<acronym_biceps>> standard, which SDPi-P profiles, consists of (3) core components, as illustrated in <<figure_sdc_biceps_components_model>>:
 

diff --git a/asciidoc/volume1/tf1-ch-b-ref-standards-conformance.adoc b/asciidoc/volume1/tf1-ch-b-ref-standards-conformance.adoc
@@ -147,8 +147,14 @@ metalanguage - Extended BNF, 15 December 1996, available at https://standards.is
 * [[[ref_omg_sysml_2_0_intro_graphical_model,OMG SysML ^&#174;^ Intro-Graphical Notation 2.0]]]  OMG Systems Modeling Language&#8482;  (SysML^&#174;^), Version 2.0, Introduction to the Graphical Model, Object Management Group (OMG) standard.  Available at https://github.com/Systems-Modeling/SysML-v2-Release/tree/master/doc[github.com/Systems-Modeling/SysML-v2-Release/doc/]
 
 * [[[ref_omg_sysml_2_0_spec,OMG SysML ^&#174;^ 2.0]]]  OMG Systems Modeling Language &#8482; (SysML^&#174;^), Version 2.0, Object Management Group (OMG) specification.  Available at https://github.com/Systems-Modeling/SysML-v2-Release/tree/master/doc[github.com/Systems-Modeling/SysML-v2-Release/doc/]
+
 * [[[ref_gender_harmony_project, HL7-GENDER]]] HL7 gender harmony project, available at https://confluence.hl7.org/display/VOC/The+Gender+Harmony+Project
 
+* [[[ref_paper_connecting_clinical_it_to_soa_arch_of_medical_devices, Connecting the clinical IT infrastructure to a service-oriented architecture of medical devices]]] Paper reviewing use of SOA architecture to integrate medical devices into clinical IT infrastructure, available at https://pubmed.ncbi.nlm.nih.gov/29272252/
+
+* [[[ref_ornet_soa_for_safe_dynamic_medical_device_interoperability, OR.NET: a service-oriented architecture for safe and dynamic medical device intoperability]]] Paper reviewing use of SOA architecture to enable an interoperable and safe ecosystem of medical devices, available at https://pubmed.ncbi.nlm.nih.gov/29346114/
+
+* [[[ref_paper_design_pattern_for_soa_integration_of_medical_devices,Standardized Device Services - A Design Pattern for Service Oriented Integration of Medical Devices]]]  C. Mauro, A. Sunyaev, J. M. Leimeister, and H. Krcmar, 2010 43rd Hawaii International Conference on System Sciences, Honolulu, HI, USA: IEEE, Jan. 2010, pp. 1–10. doi: 10.1109/HICSS.2010.347.
 
 [bibliography]
 ==== Presentations