FHIR Chat · build fails moving from template 0.0.5 to current · IG creation

Stream: IG creation

Topic: build fails moving from template 0.0.5 to current

Giorgio Cangioli (Mar 11 2020 at 10:49):

I tried to update the template reference from 0.0.5 to current
But if I do so the build fails with this error

Unrecognized realm in id: hl7.fhir.it.sandbox
Fatal Error! Processing terminated by xsl:message at line 34 in onGenerate.genProperties.xslt

Suggestions to fix it ?

Grahame Grieve (Mar 11 2020 at 11:40):

@Lloyd McKenzie

Jose Costa Teixeira (Mar 11 2020 at 11:40):

National IG templates should use the base template, not the HL7 FHIR template - which uses HL7 template

Grahame Grieve (Mar 11 2020 at 11:41):

it's the "it" that Lloyd's template doesn't like

Jose Costa Teixeira (Mar 11 2020 at 11:42):

yep, that xslt says

    <xsl:if test="not($realm='us' or $realm='uv')">
      <xsl:message terminate="yes">
        <xsl:value-of select="concat('Unrecognized realm in id: ', $id)"/>
      </xsl:message>
    </xsl:if>

Jose Costa Teixeira (Mar 11 2020 at 11:43):

in BE we're not using the HL7 template, but the base template - which I think is as discussed previously. Does this still apply? If so, the base template does not have that xslt

Giorgio Cangioli (Mar 11 2020 at 11:44):

I believe that it would be good if affiliates IGs will have the same look and feel of the HL7 FHIR ones..
..just changing the HL7 logo with the HL7 affiliate one..

Giorgio Cangioli (Mar 11 2020 at 11:44):

..but this should be an affiliate decision...

Jose Costa Teixeira (Mar 11 2020 at 11:46):

We _could_ have a "affiliate template"

Jose Costa Teixeira (Mar 11 2020 at 11:48):

that way, affiliates can inherit a common set of rules and look and feel, and they can just change the logo even without making their own template if they want

Jose Costa Teixeira (Mar 11 2020 at 11:54):

so instead of this (just showing a few templates I'm aware of)
image.png

Jose Costa Teixeira (Mar 11 2020 at 11:57):

we could have this
image.png

Jose Costa Teixeira (Mar 11 2020 at 11:57):

this would allow some consistency across affiliates if needed,
and especially, avoiding the one work that all affilaites have to do: removing the fantastic purple

Giorgio Cangioli (Mar 11 2020 at 13:01):

Yes it can be a solution or we could just allow the affiliates to specialize the HL7 FHIR template ..
.. sincerely I don't see why a separate affiliate IG template is needed : is this actually a necessary effort ?

Jose Costa Teixeira (Mar 11 2020 at 13:14):

If affiliates can build on the FHIR IG template, not really. But then we're enforcing the HL7 rules onto affiliates, which i don't know if it makes sense

Jose Costa Teixeira (Mar 11 2020 at 13:18):

Giorgio Cangioli said:

Yes it can be a solution or we could just allow the affiliates to specialize the HL7 FHIR template ..

btw, which one do you mean? HL7 template or FHIR template? :)

Lloyd McKenzie (Mar 11 2020 at 14:33):

The HL7 template is intended to only be a base for content produced by HL7. Jose is correct that others should be using the 'base' template. The base template is what drives most of the look & feel. The HL7 template adds on the HL7 logo, the copyright, and some new stuff that ties into HL7's Jira - none of which should be used by affiliates. (For the logo, you should be using your affiliate logo, not the HL7 International logo, and for the rest, you should be using your own copyright.)

Giorgio Cangioli (Mar 11 2020 at 14:54):

Lloyd McKenzie said:

The HL7 template is intended to only be a base for content produced by HL7.

HL7 Affiliates are an integral part of HL7 ;-)

Jose Costa Teixeira (Mar 11 2020 at 15:11):

I think Lloyd means content produced and managed by HL7 International.

Lloyd McKenzie (Mar 11 2020 at 15:23):

y

Lloyd McKenzie (Mar 11 2020 at 15:27):

If there were elements of the template that made sense to share between HL7 international and affiliates, then we could certainly insert a different layer. It may be that the name of the template isn't as clear as it should be. I could rename it to hl7intl.base.template, but that's going to impact a whole lot of IGs, so I'd prefer to avoid that if I can.

Lloyd McKenzie (Mar 11 2020 at 15:29):

I will update the description of the template to make clear that the scope is HL7 International

Jose Costa Teixeira (Mar 11 2020 at 16:40):

What would be the common things to an IG template for affiliates?
I'm thinking

• remove the awesome purple?
• Easy to change the logo without having to further customize template

Jose Costa Teixeira (Mar 11 2020 at 16:41):

• I guess the scripts would be the same as base.
• header and footer need to change - which may mean they need to change the template anyway...?

Lloyd McKenzie (Mar 11 2020 at 18:19):

The awesome purple is there specifically to encourage people to change it :)
There is no logo to change - so that there's no risk someone won't bother to change it. Instead, you need to add your own.
Header and footer shouldn't need to change, but may want to add to footer to indicate copyright, link to change management process, etc.

Lloyd McKenzie (Mar 11 2020 at 18:19):

Essentially an affiliate should do most of the same things that the HL7 template does (with the exception of the new Jira stuff)

Last updated: Apr 12 2022 at 19:14 UTC