FHIR Chat · hrex references not resolving · IG creation

Stream: IG creation

Topic: hrex references not resolving

Eric Haas (Oct 23 2020 at 18:43):

I am referencing the Da Vinci HRex IG and am getting link errors:

CapabilityStatement-data-consumer-server.html#/html/body/div/div/div/div/div/div/ol/li/a at Line 188, column 2220 error The link 'http://hl7.org/fhir/us/davinci-hrex/2020Sep/security.html' for "Security and Privacy" cannot be resolved

however when I put that link into browser window it resolves to the appropriate page.

Please advise...

Eric Haas (Oct 23 2020 at 18:46):

Ps:

source is here: https://github.com/HL7/davinci-ecdx/
guide is here: http://build.fhir.org/ig/HL7/davinci-ecdx/
qa is here: http://build.fhir.org/ig/HL7/davinci-ecdx/qa.html

Lynn Laakso (Oct 23 2020 at 18:49):

this is the link in 14.2.2.2? ​For security considerations specific to this guide refer to the Da Vinci HRex Implementation Guide section on Security and Privacy? that link resolves for me

Eric Haas (Oct 23 2020 at 18:56):

yes

Grahame Grieve (Oct 23 2020 at 19:47):

what is your declared dependency?

Eric Haas (Oct 23 2020 at 22:12):

this is a direct/absolute link since it resides in the narrative block.

<li>
For security considerations specific to this guide refer to the Da Vinci HRex Implementation Guide section on
 <a href=\"http://hl7.org/fhir/us/davinci-hrex/2020Sep/security.html\">Security and Privacy</a>
</li>

Eric Haas (Oct 23 2020 at 22:14):

do I need to url encode and escape the '-' ?

Grahame Grieve (Oct 24 2020 at 02:14):

don't think so but you still need to answer my question

Eric Haas (Oct 25 2020 at 03:26):

...
dependsOn:
-   id: uscore
    packageId: hl7.fhir.us.core
    uri: http://hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core
    version: 3.1.1
-   id: hrex
    packageId: hl7.fhir.us.davinci-hrex
    uri: http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide/hl7.fhir.us.davinci-hrex
    version: current
...

Grahame Grieve (Oct 25 2020 at 19:02):

well, if you depend on current, then you have to reference the ci-build

Eric Haas (Oct 26 2020 at 01:20):

ok

Eric Haas (Nov 03 2020 at 04:05):

For my capability statement narratives the links to the derived profiles are all wonky.

1. for Da Vinci Alerts IG : if you click on the IG link on this page: http://hl7.org/fhir/us/davinci-alerts/CapabilityStatement-notification-forwarder.html

image.png

Eric Haas (Nov 03 2020 at 04:06):

you get this ....

image.png

Eric Haas (Nov 03 2020 at 04:09):

note that this link is ... http://hl7.org/fhir/us/davinci-alerts/http%3A//hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core%7C3.1.1 in the published output

vs .

<ul>
<li>
<a href="http%3A//hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core%7C3.1.1">
http://hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core|3.1.1
</a>
</li>
</ul>

in the source file

Eric Haas (Nov 03 2020 at 04:10):

for some reason the absolute url is being overwritten by the davinci base url - http://hl7.org/fhir/us/davinci-alerts/

Eric Haas (Nov 03 2020 at 04:12):

also occurring here:

http://build.fhir.org/ig/HL7/davinci-ecdx/CapabilityStatement-data-consumer-client.html

image.png

Eric Haas (Nov 03 2020 at 04:15):

despite text file url...

<ul>
<li>
<a href=\"http%3A//hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core%7C3.1.1\">
http://hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core|3.1.1
</a>
</li>
</ul>
<ul>
<li><
a href=\"http%3A//hl7.org/fhir/us/davinci-hrex/2019Jun/ImplementationGuide-hl7.fhir.us.davinci-hrex%7C0.2.0\">
http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide-hl7.fhir.us.davinci-hrex|0.2.0
</a>
</li>
</ul>

the rendered link is: http://build.fhir.org/ig/HL7/davinci-ecdx/http%3A//hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core%7C3.1.1

with an inserted based of http://build.fhir.org/ig/HL7/davinci-ecdx/

(BTW the address is: https://www.hl7.org/fhir/us/core/ImplementationGuide-hl7.fhir.us.core.html)

same for the hrex link.

But for HRex the url downloaded from the package: http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide/hl7.fhir.us.davinci-hrex does not resolve either.

Eric Haas (Nov 03 2020 at 05:28):

I figured out the reason for this....There is no way to resolve the IG to an html page with our templates, since the pages are nulled out in the config file so nothing in the output. (This is inconsistent with the package file contents btw) I would like to have a landing page for the IG resource so the reader can click on the link and discover the IG. I'll make a PR to the templates

Eric Haas (Nov 05 2020 at 02:17):

currently the CDEX ig has this error
URL value 'http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide-hl7.fhir.us.davinci-hrex|0.2.0' does not resolve

The question is what should it resolve to... The package points to a nonexistent page since the templates don't generate a landing page for Implementation Guides:

from the package.other.spec_interals

  "paths": {
    "http://hl7.org/fhir/us/davinci-cdex/ImplementationGuide/hl7.fhir.us.davinci-cdex|0.2.0": "0.2.0/ImplementationGuide-hl7.fhir.us.davinci-cdex.html",
    "http://hl7.org/fhir/us/davinci-cdex/ImplementationGuide/hl7.fhir.us.davinci-cdex": "ImplementationGuide-hl7.fhir.us.davinci-cdex.html,
...

Eric Haas (Nov 05 2020 at 02:20):

I see 2 Options for where this url should point...

1. The home page of the guide
2. An IG resource page in the IG ( I added this to the config in a local template and then did not really think is was that useful so I chose to show the home page in the narrative instead of the urls (which would leads to even more errors )

Eric Haas (Nov 24 2020 at 21:49):

revisiting this?

currently the CDEX ig has this error
URL value 'http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide-hl7.fhir.us.davinci-hrex|0.2.0' does not resolve

The question is what should it resolve to...

The HREX implementation guide's id in the repro is 'davinci-hrex'
the package list says:

"http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide/hl7.fhir.us.davinci-hrex|0.2.0": "0.2.0/ImplementationGuide-hl7.fhir.us.davinci-hrex.html",

and why is nobody else having this issue?

Lloyd McKenzie (Nov 24 2020 at 23:35):

http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide-hl7.fhir.us.davinci-hrex is not the URL of the IG. It's http://hl7.org/fhir/us/davinci-hrex/ImplementationGuide/davinci-hrex

Eric Haas (Nov 25 2020 at 02:24):

why does the package say differently and what is the convention ?

Lloyd McKenzie (Nov 25 2020 at 23:31):

I don't know why the package says differently. @Grahame Grieve ?

Lloyd McKenzie (Nov 25 2020 at 23:32):

(Note that you'd need "ImplementationGuide/" rather than "ImplementationGuide-" regardless

Eric Haas (Nov 26 2020 at 15:13):

Ok thanks for seeing the dash

Grahame Grieve (Nov 26 2020 at 19:50):

I don't know why the package says differently. What is the guide we are talking about?

Eric Haas (Nov 28 2020 at 03:21):

DaVinci HRex

Eric Haas (Nov 28 2020 at 03:22):

http://hl7.org/fhir/us/davinci-hrex/

Eric Haas (Nov 28 2020 at 03:24):

What is the ig resource naming convention. I’m using the package dot notation that I see in the packages. Lloyd just used davinci-blah

Lloyd McKenzie (Nov 28 2020 at 03:36):

The publisher used to yell when you didn't have an id that followed the package dot notation but doesn't anymore. Because it didn't yell at me, I didn't change it because I think the package dot notation makes for weird ids - and is also rather redundant when you stick it on the end of the canonical URL.

Eric Haas (Nov 28 2020 at 16:03):

Well I don’t care what it is but I think we should have a convention. I am always having to hunt down the URL’s and being able to reliable guess what they are would be nice

Last updated: Apr 12 2022 at 19:14 UTC