AEM Site generation is failing after upgrading to Guides 4.3.1

[Beaula123]

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.

[pradyumanaggarwal · Accepted solution]

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

[DivrajSingh]

@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.