부실 fmPostProcessedAt 속성으로 인한 DITA 맵 또는 주제 참조 나누기
Adobe Experience Manager as a Cloud Service(AEMaaCS) 또는 AEM 6.5에서 AEM Guides으로 작업하는 경우 DITA 맵 또는 주제 참조가 손상되어 출력 사전 설정이 UI에서 누락될 수 있습니다. 일반적으로 이 문제는 오래된 fmPostProcessedAt 속성으로 인해 자산이 동기화되지 않을 때(대개 수동 배포 또는 마이그레이션 후) 발생합니다. 이 문제를 해결하려면 DAM 자산 업데이트 워크플로우를 사용하여 영향을 받는 자산을 재처리합니다.
설명 description
환경
- 제품: Adobe Experience Manager(AEM) - 사이트
- 버전: AEM 6.5, AEM as a Cloud Service(AEMaaCS)
문제/증상
-
DITA Map 주제 참조는 저장소에 주제가 있더라도 배포 후 작성자 UI에서 손상되어(빨간색) 나타납니다.
-
확인되지 않았거나 손상된 주제 참조로 인해 PDF 또는 기타 출력 생성에 실패합니다.
-
새로 만든 출력 사전 설정은 페이지를 새로 고치거나 설명서를 생성한 후 AEM Guides UI에서 사라지지만 CRXDE에서 볼 수 있습니다.
-
/bin/guides/presets끝점이 영향을 받는 맵에 대해 500 서버 오류를 반환합니다. -
경고/오류 로그에는 다음과 같은 메시지가 포함됩니다.
- 참조 GUID-xxxx.ditamap에 대한 노드를 찾았지만 동기화되지 않아 null을 반환합니다
- com.adobe.fmdita.rest.presets.PresetsAPI 오류: {"errorCode":"DXML_MESSAGE_0004"}
- java.lang.NullPointerException…
-
수동 DITA Content Package 배포 또는 환경 간 마이그레이션으로 인해 DITA 에셋이 동기화되지 않습니다.
원인
이 문제는 DITA 에셋이 동기화되지 않을 때 발생합니다(일반적으로 jcr:created 및 fmPostProcessedAt 속성이 일치하지 않기 때문). 이렇게 불일치하면 안내서 UI 및 API에서 주제 참조 및 출력 사전 설정을 올바르게 확인할 수 없습니다.
이 동기화 중단 상태의 일반적인 원인은 다음과 같습니다.
- 후 처리를 트리거하지 않고 패키지 또는 파이프라인을 통해 DITA 콘텐츠 마이그레이션.
- AEM에서 DITA 에셋을 수동으로 가져오거나 편집합니다.
- 배포 후 자산 워크플로우 처리가 완료되지 않았거나 실패했습니다.
해결 방법 resolution
문제를 해결하려면 다음 단계를 수행합니다.
-
및 값이 일치하지 않는지 오류 로그를 확인하여
jcr:created동기화되지 않음fmPostProcessedAt으로 표시된 자산을 식별합니다. -
com.adobe.fmdita.postprocess.PostProcessJobInitiator값이 올바르게 업데이트되도록 하는 DXML 사후 프로세스 개시자(fmPostProcessedAt) 단계를 포함하는 AEM의 표준 DAM 자산 업데이트 워크플로우를 사용하여 영향을 받는 자산을 다시 처리합니다. -
필요한 경우 사용자 지정 워크플로를 만듭니다.
- DXML 사후 프로세스 개시자 단계만 포함하는 AEM의 새 워크플로우 모델을 구성합니다.
- 영향을 받는 맵 또는 항목에서 이 워크플로우를 실행하여 동기화 상태를 업데이트합니다.
-
끊어진 항목 참조가 확인되었고, 출력 생성이 성공적으로 완료되었으며, 사전 설정이 AEM Guides UI에 올바르게 표시되고,
/bin/guides/presets이(가) 예상한 결과를 반환하는지 확인하십시오.
관련 읽기
- AEM 사용 안내서에서 사용자 지정 DITA-OT 및 DITA 특수화 사용.
- AEM 사용 안내서의 DITA 콘텐츠 재사용 가능.