Expand my Community achievements bar.

SOLVED

AEM Site generation is failing after upgrading to Guides 4.3.1

Avatar

Level 4

Hi,

We recently upgraded our guides to 4.3.1. After upgrading we see the issue while generating the ditamaps with AEM site that, the generation is failing with below error.

 

Missing scope attribute in xref: https://rest.com/content/site/us/en/1-0.html in /content/dam/site/us/ja/dita/general/globalization/test/g11n-test-for-guides-4-3-1-with-connector/content/Documentation-resources.dita  PublishWorkflowStep.publishDITAMap(): java.lang.NullPointerException.

 

If the dita topic contains the xref without scope value its failing. Below is the example.

 <li><xref href="#">SE</xref>

Its working fine if we add the scope to the xref tag. 

 <li><xref href="#" scope="local">SE</xref>

Please suggest.

1 Accepted Solution

Avatar

Correct answer by
Employee

Yes, it is always suggested to put scope whenever using xref tag. Using scope "local" is absolutely fine. 

View solution in original post

2 Replies

Avatar

Correct answer by
Employee

Yes, it is always suggested to put scope whenever using xref tag. Using scope "local" is absolutely fine. 

Avatar

Employee

@Beaula123 : The attribute scope in xref element indicates the type of link it is. Read more about it: https://docs.oasis-open.org/dita/v1.2/os/spec/common/thescopeattribute.html

 

The behavior of publishing was updated in AEM Guides 4.3.1 - where processing of xrefs is pre-emptively checked to avoid unwanted results. The scenario you posted also falls under that check - so adding scope to the xref to such link is required.