AEM Site generation is failing after upgrading to Guides 4.3.1 | Community
Skip to main content
New Participant
December 13, 2023
Solved

AEM Site generation is failing after upgrading to Guides 4.3.1

  • December 13, 2023
  • 2 replies
  • 1011 views

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.

Best answer by pradyumanaggarwal

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

2 replies

DivrajSingh
Employee
April 25, 2024

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

pradyumanaggarwalAccepted solution
Employee
January 3, 2024

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