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

AEM Site generation is failing after upgrading to Guides 4.3.1

  • December 13, 2023
  • 2 replies
  • 1012 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

pradyumanaggarwalAdobe EmployeeAccepted solution
Adobe Employee
January 3, 2024

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

DivrajSingh
Adobe Employee
Adobe 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.