This wiki has undergone a migration to Confluence found Here
Difference between revisions of "Implementation Packages"
Jump to navigation
Jump to search
Astechishin (talk | contribs) |
Rene spronk (talk | contribs) |
||
| (9 intermediate revisions by the same user not shown) | |||
| Line 10: | Line 10: | ||
Rationale: | Rationale: | ||
| − | *Newbie implementers need a ‘starter kit’ – not just the standard itself. It lowers the hurdle towards implementation, which is one of the | + | *Newbie implementers need a ‘starter kit’ – not just the standard itself. It lowers the hurdle towards implementation, which is one of the strategic initiatives. |
*Education for v2 needs an ‘implementation package’ were all the specs and tooling for v2 are in. | *Education for v2 needs an ‘implementation package’ were all the specs and tooling for v2 are in. | ||
| Line 18: | Line 18: | ||
#Definition of the contents of the Implementation Package for HL7 version 2 | #Definition of the contents of the Implementation Package for HL7 version 2 | ||
#Definition of the contents of the Implementation Package for CDA | #Definition of the contents of the Implementation Package for CDA | ||
| + | |||
| + | |||
| + | ===Functional Requirements of an Implementation Package=== | ||
| + | From a functional perspective, irrespective of the standard for which an implementation package is defined, an ''implementation package'' should contain (by inclusion, or by reference): | ||
| + | *Specification: | ||
| + | **A human readable version of the standard, preferrably in an easily accessible and hyperlinked format. | ||
| + | **software processable expressions of the standard | ||
| + | **#Structure definitions in some parsable (platform independent) language (richer than schema), e.g. to serve as the basis for code generation. | ||
| + | **#Object models, e.g. to be tied to parsers and serialisers; object models represent an additional set of decisions beyond the structured definitions. | ||
| + | **Multiple instance examples for all of the core structures as defined in the standard. | ||
| + | *Tools: | ||
| + | **Programming APIs which ease the software implementation process of the standard. | ||
| + | ***Parsers, serialisers, validators (java, C#, some win32 language, javascript) | ||
| + | **Testing and simulation tools which ease the software development and testing process related to the standard. | ||
| + | *Other | ||
| + | **Whitepapers or other documentation of implementation best practices of the standard. | ||
| + | **Examples of (software processable) conformance profiles | ||
| + | **Examples of (human readable) implementation guides | ||
===HL7 version 2 Implementation Package=== | ===HL7 version 2 Implementation Package=== | ||
| + | *HL7v2 spec (in HTML) format, | ||
| + | *set of v2 example instances | ||
| + | *the HAPI/nHAPI toolkits, | ||
| + | *Message Workbench (MWB), | ||
| + | **examples of message profiles | ||
| + | *other relevant (open source) toolkits | ||
| + | **v2 client and/or server simulators ? | ||
| + | *the v2 XML schema, | ||
| + | *the v2 database (with definition of message structures) | ||
| + | *examples of HL7 v2 implementation guides (for human readers) | ||
===CDA Implementation Package=== | ===CDA Implementation Package=== | ||
| + | |||
| + | ==Status== | ||
| + | *2017-04 - CTO suggests to approach ArB to see if current specification is complete. Suggests to approach O&O (as caretaker for HL7 v2 product management group) for discussion about v2 content. Ultimately needs to go to TSC. | ||
Latest revision as of 13:12, 19 April 2017
This page is related to the AID/EST/Education/Publishing project of the same name.
Contents
Project Scope
To define the contents of 'Implementation Packages' for each of the product lines that consist of:
- HL7 standard publications,
- software processable expressions thereof that can be used for Education and source code generation, as well as
- other related implementation tools and toolkits. The package could be made available as a ZIP, or simply be a list of URLs on a webpage, the exact deliverable is to be determined.
Original PSS: File:HL7 AID-Implementation Packages-v0.2.docx
Rationale:
- Newbie implementers need a ‘starter kit’ – not just the standard itself. It lowers the hurdle towards implementation, which is one of the strategic initiatives.
- Education for v2 needs an ‘implementation package’ were all the specs and tooling for v2 are in.
Effectively FHIR is an ‘implementation package’. As an example, the HL7v2 Implementation Package could consist of the HL7v2 spec (in HTML) format, v2 examples, the HAPI/nHAPI toolkits, other relevant (open source) toolkits, the v2 XML schema, the v2 database (with definition of message structures).
Specific goals for this project:
- Definition of the contents of the Implementation Package for HL7 version 2
- Definition of the contents of the Implementation Package for CDA
Functional Requirements of an Implementation Package
From a functional perspective, irrespective of the standard for which an implementation package is defined, an implementation package should contain (by inclusion, or by reference):
- Specification:
- A human readable version of the standard, preferrably in an easily accessible and hyperlinked format.
- software processable expressions of the standard
- Structure definitions in some parsable (platform independent) language (richer than schema), e.g. to serve as the basis for code generation.
- Object models, e.g. to be tied to parsers and serialisers; object models represent an additional set of decisions beyond the structured definitions.
- Multiple instance examples for all of the core structures as defined in the standard.
- Tools:
- Programming APIs which ease the software implementation process of the standard.
- Parsers, serialisers, validators (java, C#, some win32 language, javascript)
- Testing and simulation tools which ease the software development and testing process related to the standard.
- Programming APIs which ease the software implementation process of the standard.
- Other
- Whitepapers or other documentation of implementation best practices of the standard.
- Examples of (software processable) conformance profiles
- Examples of (human readable) implementation guides
HL7 version 2 Implementation Package
- HL7v2 spec (in HTML) format,
- set of v2 example instances
- the HAPI/nHAPI toolkits,
- Message Workbench (MWB),
- examples of message profiles
- other relevant (open source) toolkits
- v2 client and/or server simulators ?
- the v2 XML schema,
- the v2 database (with definition of message structures)
- examples of HL7 v2 implementation guides (for human readers)
CDA Implementation Package
Status
- 2017-04 - CTO suggests to approach ArB to see if current specification is complete. Suggests to approach O&O (as caretaker for HL7 v2 product management group) for discussion about v2 content. Ultimately needs to go to TSC.
