The jira specification file appears to be out of date with the versions, artifacts and pages currently defined in the IG. A proposed revised file to be reviewed and, if appropriate, submitted as a pull request against the XML folder in https://github.com/HL7/JIRA-Spec-Artifacts. To see the differences, perform a file compare on 'template/jira-current.xml' (a normalized view of what is in Github) and 'template/jira-new.xml' (reflects current IG content)
This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization|3.1.1'
Editor's Comment: 25. While technically correct, US Core has approved a 'patch' that indicates this cardinality relaxation is considered valid in 3.1.1 - https://jira.hl7.org/browse/FHIR-51489Show Reasoning
Organization.identifier:NPI
error
The max value of '*' on the path Organization.identifier:NPI does not comply with the value '1' from the claimed profile
Organization.identifier:CLIA
error
The max value of '*' on the path Organization.identifier:CLIA does not comply with the value '1' from the claimed profile
This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole|6.1.0'
Editor's Comment: 00.b The profile does enforce the same rules as 3.1.1. The invariant remains, it's just that the FHIRPath has been corrected. https://chat.fhir.org/#narrow/channel/179252-IG-creation/topic/Incorrect.20profile.20derivation.20error/with/570474355Show Reasoning
PractitionerRole
error
The constraint 'telecom or endpoint' is defined in the claimed profile, but missing
PractitionerRole
error
The constraint 'practitioner or organization or healthcareService or location' is defined in the claimed profile, but missing
This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole|3.1.1'
Editor's Comment: 00.b The profile does enforce the same rules as 3.1.1. The invariant remains, it's just that the FHIRPath has been corrected. https://chat.fhir.org/#narrow/channel/179252-IG-creation/topic/Incorrect.20profile.20derivation.20error/with/570474355Show Reasoning
PractitionerRole
error
The constraint 'telecom or endpoint' is defined in the claimed profile, but missing
PractitionerRole.code
warning
The valueSet http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1099.30|20240605 includes codes not allowed in the claimed profile which has value set http://hl7.org/fhir/us/core/ValueSet/us-core-provider-role|3.1.1 (codes: 310188001, 721937004, 229774002, 309394004, etc)
PractitionerRole.specialty
warning
The ValueSet 'http://hl7.org/fhir/us/core/ValueSet/us-core-provider-specialty|3.1.1' cannot be expanded so the claim cannot be checked: ValueSet 'http://hl7.org/fhir/us/core/ValueSet/us-core-provider-specialty|3.1.1' Filter by property 'abstract' and op 'EQUAL' is not supported yet (and Error from https://tx.fhir.org/r4: Error: The filter abstract = false was not understood)
00.a This will go away when the next tools IG release is published
ERROR: ImplementationGuide/hl7.fhir.us.davinci-hrex: ImplementationGuide.definition.extension[35].url: No definition could be found for URL value 'http://hl7.org/fhir/tools/StructureDefinition/expansion-parameters' (0 uses)
00.b The profile does enforce the same rules as 3.1.1. The invariant remains, it's just that the FHIRPath has been corrected. https://chat.fhir.org/#narrow/channel/179252-IG-creation/topic/Incorrect.20profile.20derivation.20error/with/570474355
ERROR: StructureDefinition/hrex-practitionerrole: StructureDefinition: This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole|3.1.1' (1 uses)
ERROR: StructureDefinition/hrex-practitionerrole: StructureDefinition: This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole|6.1.0' (1 uses)
01. Consider adding this in the future. To this point, we havn't said that HRex actually has use-cases - FHIR-48917
WARNING: DA VINCI: The second menu item under Background should have the label Use Cases. (1 uses)
02. Detailed changes weren't tracked until after 1.0.0 was released
WARNING: DA VINCI: The Change Log page (history.html) does not include an h3 section for the version 0.1.0 (1 uses)
WARNING: DA VINCI: The Change Log page (history.html) does not include an h3 section for the version 0.2.0 (1 uses)
WARNING: DA VINCI: The Change Log page (history.html) does not include any Jira tracker items links for the section with title STU 1.0.0 (1 uses)
03. **[Added second sentence to reason] Da Vinci doesn't have any conformance expectations itself - conformance expectations are determined by IGs that derive from HRex. Therefore, CapabilityStatements aren't appropriate
WARNING: DA VINCI: Da Vinci IGs SHOULD define CapabilityStatements. Without CapabilityStatements, there is no technical way to declare conformance to the IG. (1 uses)
04. HRex can't depend on itself
WARNING: DA VINCI: The Base Specs menu item must have a child called HRex 1.2.0. (1 uses)
WARNING: DA VINCI: The Conformance page (conformance.html) Must Support section needs to include a link to the HRex conformance.html#mustsupport section. (1 uses)
WARNING: DA VINCI: The Conformance page (conformance.html) needs to include a link to the HRex conformance.html page. (1 uses)
WARNING: DA VINCI: The Security page (security.html) must include a reference to the HRex security.html page (with a SHALL comply). (1 uses)
WARNING: DA VINCI: This IG does not depend on HRex. Either add a formal dependency or confirm that a textual dependency has been declared. (1 uses)
05. **[Clarified message] This isn't actually a resource in R4, so we point to the R5 version, which this check doesn't detect.
WARNING: DA VINCI: The How to Read page (fhir.html) needs to include a reference to the http://hl7.org/fhir/R4/subscriptiontopic.html because this IG uses the subscriptiontopic resource. (1 uses)
06. **[Clarified message] These uses of 'pattern' are inherited from US Core
INFORMATION: StructureDefinition/hrex-organization: StructureDefinition.snapshot.element[9].slicing.discriminator[0]: The discriminator type 'pattern' is deprecated in R5+. For future compatibility, you could consider using type=value with a pattern[x] instead (if this is not an inherited slicing) (1 uses)
INFORMATION: StructureDefinition/hrex-provenance: StructureDefinition.snapshot.element[22].slicing.discriminator[0]: The discriminator type 'pattern' is deprecated in R5+. For future compatibility, you could consider using type=value with a pattern[x] instead (if this is not an inherited slicing) (1 uses)
07. **[Clarified message] While deprecated in R5, this is undeprecated in R6
Reference to deprecated ValueSet http://hl7.org/fhir/5.0/ValueSet/jurisdiction|5.0.0 (11 uses)
08. **[Merged pinning suppressions together] These pinnings are correct
%to 20240605 from choices of 20190418 (us.nlm.vsac#0.11.0), 20240605 (us.nlm.vsac#0.19.0) (4 uses)
Pinned the version of http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066 to 20240606 from choices of 20190521 (us.nlm.vsac#0.11.0), 20240606 (us.nlm.vsac#0.19.0) (1 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (2 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-location to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (1 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (2 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (1 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (6 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (3 uses)
Pinned the version of http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson to 7.0.0 from choices of 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (1 uses)
Pinned the version of http://hl7.org/fhir/us/core/ValueSet/us-core-provenance-participant-type to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (1 uses)
Pinned the version of http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state to 7.0.0 from choices of 3.1.1 (hl7.fhir.us.core#3.1.1), 6.1.0 (hl7.fhir.us.core#6.1.0), 7.0.0 (hl7.fhir.us.core#7.0.0) (1 uses)
Pinned the version of http://terminology.hl7.org/ValueSet/v3-PurposeOfUse to 3.1.0 from choices of 2.0.0 (hl7.terminology.r4#5.0.0), 3.0.0 (hl7.terminology.r4#5.5.0), 3.1.0 (hl7.terminology.r4#7.0.1) (2 uses)
09. These are termerminology server and/or validator limitations
Source Code System http://snomed.info/sct is only supported on the terminology server, so the source codes are not validated for performance reasons (1 uses)
Target Code System http://snomed.info/sct is only supported on the terminology server, so the target codes are not validated for performance reasons (1 uses)
The concept map has too many codes to validate (662) (1 uses)
10. **[Clarified reason] This is a data type profile, and this IG defines no profiles that use it. It's created for downstream IGs. That makes it impossible to create an example that tests the profile. The definition is sufficiently simple that there's no possibility of errors in the construction.
WARNING: StructureDefinition.where(url = 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-reference-id'): The Implementation Guide contains no examples for this data type profile (1 uses)
11. **[Updated reason] The contents of this code system have been migrated to THO, however, as a minor unballoted release, this is not the correct time to transition to the THO codes.
INFORMATION: CodeSystem/hrex-temp: CodeSystem: Most code systems defined in HL7 IGs will need to move to THO later during the process. Consider giving this code system a THO URL now (See https://confluence.hl7.org/display/TSMG/Terminology+Play+Book, and/or talk to TSMG) (1 uses)
12. **[New] This code system is a 'code' binding in an IG-specific logical model, and as such, does not need to migrate to THO
INFORMATION: CodeSystem/hrex-endpoint-discovery: CodeSystem: Most code systems defined in HL7 IGs will need to move to THO later during the process. Consider giving this code system a THO URL now (See https://confluence.hl7.org/display/TSMG/Terminology+Play+Book, and/or talk to TSMG) (1 uses)
13. The patterns are only locking down the system, which is the discriminator for the slices, so this is fine.
INFORMATION: StructureDefinition/hrex-organization: StructureDefinition.snapshot.element[10].pattern.ofType(Identifier): The repeating element has a pattern. The pattern will apply to all the repeats (this has not been clear to all users) (1 uses)
INFORMATION: StructureDefinition/hrex-organization: StructureDefinition.snapshot.element[11].pattern.ofType(Identifier): The repeating element has a pattern. The pattern will apply to all the repeats (this has not been clear to all users) (1 uses)
INFORMATION: StructureDefinition/hrex-organization: StructureDefinition.snapshot.element[12].pattern.ofType(Identifier): The repeating element has a pattern. The pattern will apply to all the repeats (this has not been clear to all users) (1 uses)
14. These identifiers are 'extra' and aren't expected to match any slice
INFORMATION: Organization/full: Organization.identifier[0]: This element does not match any known slice defined in the profile http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-organization|1.2.0 (this may not be a problem, but you should check that it's not intended to match a slice) (1 uses)
INFORMATION: Organization/full: Organization.identifier[4]: This element does not match any known slice defined in the profile http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-organization|1.2.0 (this may not be a problem, but you should check that it's not intended to match a slice) (1 uses)
15. These additional coverage classes are not (currently) part of the profile and are not expected to match slices
INFORMATION: Parameters/member-match-in: Parameters.parameter[1].resource/*Coverage/9876B1*/.class[2]: This element does not match any known slice defined in the profile http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-coverage|1.2.0 (this may not be a problem, but you should check that it's not intended to match a slice) (1 uses)
INFORMATION: Parameters/member-match-in: Parameters.parameter[1].resource/*Coverage/9876B1*/.class[3]: This element does not match any known slice defined in the profile http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-coverage|1.2.0 (this may not be a problem, but you should check that it's not intended to match a slice) (1 uses)
16. These code systems should not be draft in THO. The terminology work group is trying to fix these
Reference to draft CodeSystem http://hl7.org/fhir/task-status|4.0.1 (12 uses)
17. Narrative doesn't make sense in resources passed to a real-time operation
WARNING: Parameters/member-match-in-provider: Parameters.parameter[0].resource/*Patient/1*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in-provider: Parameters.parameter[1].resource/*Coverage/9876B1*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in-provider: Parameters.parameter[2].resource/*Consent/null*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in: Parameters.parameter[0].resource/*Patient/1*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in: Parameters.parameter[1].resource/*Coverage/9876B1*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in: Parameters.parameter[2].resource/*Coverage/AA87654*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
WARNING: Parameters/member-match-in: Parameters.parameter[3].resource/*Consent/null*/: Constraint failed: dom-6: 'A resource should have narrative for robust management (text.`div`.exists())' (defined in http://hl7.org/fhir/StructureDefinition/DomainResource) (Best Practice Recommendation) (1 uses)
18. These are tested by the parameters input examples
INFORMATION: StructureDefinition.where(url = 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-consent'): The Implementation Guide contains no explicitly linked examples for this profile (1 uses)
INFORMATION: StructureDefinition.where(url = 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-patient-demographics'): The Implementation Guide contains no explicitly linked examples for this profile (1 uses)
19. **[Updated approval] HRex needs a patient with no identifier - US Realm approved: https://jira.hl7.org/browse/FHIR-46468
WARNING: StructureDefinition.where(url = 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-patient-demographics').baseDefinition: US FHIR Usage rules require that all profiles on Patient derive from the core US profile. See https://confluence.hl7.org/display/CGP/US+Core+Variance+Request+Process (1 uses)
20. **[Updated approval] HRex needs Coverage pointing to a patient with no identifier - US Realm approved: https://jira.hl7.org/browse/FHIR-46468
WARNING: StructureDefinition.where(url = 'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-coverage').baseDefinition: US FHIR Usage rules require that all profiles on Coverage derive from the core US profile. See https://confluence.hl7.org/display/CGP/US+Core+Variance+Request+Process (1 uses)
21. The IG description is talking about the potential for certain resources to be deprecated in the future. The IG itself is definitely not deprecated
INFORMATION: ImplementationGuide/hl7.fhir.us.davinci-hrex: ImplementationGuide: Resource is not deprecated, but the description mentions deprecated - check whether it should be deprecated (1 uses)
22. This link exists, but because we're inheriting this fragment from a shared template, the link looks different and the template doesn't recognize it
The link 'http://hl7.org/fhir/us/davinci-hrex/davinci-guiding-principles.html' for "guiding principles" cannot be resolved (1 uses)
23. The version used is based on regulation
The ImplementationGuide uses package hl7.fhir.us.core#7.0.0 released on 2024-05-08, but the most recent appropriate version is 8.0.1. This reference is getting old and the more recent version should be considered (1 uses)
24. This references is inherited from the FHIR core spec, which used it before the extension was deprecated
INFORMATION: StructureDefinition/hrex-consent: StructureDefinition.snapshot.element[4].binding.extension[0]: The extension http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet|5.2.0 is deprecated (1 uses)
25. While technically correct, US Core has approved a 'patch' that indicates this cardinality relaxation is considered valid in 3.1.1 - https://jira.hl7.org/browse/FHIR-51489
ERROR: StructureDefinition/hrex-organization: StructureDefinition: This profile does not comply with claimed profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization|3.1.1' (1 uses)
26. This conformance pattern of MS on identifier as a whole but not on all slices is inherited from US Core.
WARNING: StructureDefinition/hrex-organization: StructureDefinition.snapshot: The slice 'CLIA' on path 'Organization.identifier' is not marked as 'must-support' which is not consistent with the element that defines the slicing, where 'must-support' is true (1 uses)
WARNING: StructureDefinition/hrex-organization: StructureDefinition.snapshot: The slice 'NAIC' on path 'Organization.identifier' is not marked as 'must-support' which is not consistent with the element that defines the slicing, where 'must-support' is true (1 uses)
27. These multiple relationships are intensional and reflect the real relationship between the codes
WARNING: ConceptMap/CareTeamMember-NUCCFunction: ConceptMap.group[0].element[146].target[0]: A narrower relationship has already been defined from the code 224534008 to the code 176B00000X, but this defines a new relationship narrower (1 uses)
WARNING: ConceptMap/CareTeamMember-NUCCFunction: ConceptMap.group[0].element[638].target[0]: A wider relationship has already been defined from the code 79898004 to the code 176B00000X, but this defines a new relationship wider (1 uses)
28. **[Clarified reason] This change is intentional and reflects the new recommended codes for this element which have changed since R4 was published.
The Coding provided (http://ihe.net/fhir/ihe.formatcode.fhir/CodeSystem/formatcode#urn:ihe:pcc:apr:handp:2008) was not found in the value set 'DocumentReference Format Code Set' (http://hl7.org/fhir/ValueSet/formatcodes|4.0.1), and a code is recommended to come from this value set. (error message = The provided code 'http://ihe.net/fhir/ihe.formatcode.fhir/CodeSystem/formatcode#urn:ihe:pcc:apr:handp:2008' was not found in the value set 'http://hl7.org/fhir/ValueSet/formatcodes|4.0.1') (2 uses)
29. These uses of conformance verbs aren't actually conformance statements and thus aren't appropriate to be marked as conformance statements
INFORMATION: en/conformance.html: The html source contains the word 'MAY' but it is not in a text phrase marked as a conformance clause: 'Da Vinci IGs, including this one, make use of conformance language such as SHALL, SHOULD and MAY to describe the behavior of systems. The meaning of these words shall be interpreted as per the FHIR core spec.' (1 uses)
INFORMATION: en/conformance.html: The html source contains the word 'SHALL' but it is not in a text phrase marked as a conformance clause: 'Da Vinci IGs, including this one, make use of conformance language such as SHALL, SHOULD and MAY to describe the behavior of systems. The meaning of these words shall be interpreted as per the FHIR core spec.' (1 uses)
INFORMATION: en/conformance.html: The html source contains the word 'SHOULD' but it is not in a text phrase marked as a conformance clause: 'Da Vinci IGs, including this one, make use of conformance language such as SHALL, SHOULD and MAY to describe the behavior of systems. The meaning of these words shall be interpreted as per the FHIR core spec.' (1 uses)
30. We have links to the R5 definitions. These resources did not exist in R4.
WARNING: DA VINCI: The How to Read page (fhir.html) needs to include a reference to the http://hl7.org/fhir/R4/actordefinition.html because this IG uses the actordefinition resource. (1 uses)
WARNING: DA VINCI: The How to Read page (fhir.html) needs to include a reference to the http://hl7.org/fhir/R4/requirements.html because this IG uses the requirements resource. (0 uses)
31. **[New] No new trackers are associated with this release
WARNING: DA VINCI: The Change Log page (history.html) does not include any Jira tracker items links for the section with title STU 1.2.0 (1 uses)
hl7.fhir.us.davinci-hrex
hl7.fhir.r4.examples
