AEM Guides의 캐싱으로 인해 DXML 사후 처리에서 Assets을 건너뛰었습니다
AEM Guides의 DXML 후처리는 제목, 문서 상태 및 연결 참조와 같은 에셋 메타데이터가 사용자 인터페이스에서 올바르게 동기화 및 렌더링되도록 하는 데 중요한 역할을 합니다. 이렇게 하면 작성된 콘텐츠 내에서 정확한 표시와 안정적인 탐색이 가능합니다. 메타데이터 누락, 끊어진 항목 링크 또는 불완전한 출력 사전 설정과 같은 AEM Guides의 에셋이 올바르게 처리되지 않는 경우 문제가 DXML 포스트 프로세서에 있는 캐시된 경로에서 비롯될 수 있습니다. 이 문서에서는 저장소에서 무시된 경로를 식별하고 제거하여 적절한 에셋 처리 및 메타데이터 동기화를 복원하는 방법에 대해 설명합니다.
설명 description
환경
- 제품: Adobe Experience Manager(AEM) Managed Services
- 버전: AEM 6.5, 안내서 4.0+
문제/증상
- DITA 파일의 제목 필드는 업데이트를 유지하지 않고 새로 고친 후 이전 상태로 되돌아갑니다.
- 문서 상태 필드가 속성 콘솔에 없지만 파일 속성 패널에 표시됩니다.
- 파일은 안내서에 필요한 Topic 형식 대신 File 형식으로 표시됩니다.
- 지도에 추가된 주제는 파란색이 아니라 끊겼거나 사용할 수 없는 링크를 나타내는 빨간색으로 표시됩니다.
- 자산이 CRX/DE의
/var/dxml/postprocess/ignoredPaths노드 아래에 나열된 경로에 있는 경우 새로 만든 맵에 대한 출력 사전 설정이 누락될 수 있습니다. 이러한 경로는 DXML 사후 처리에서 제외된 것으로 처리되며 이 문제는 해당 노드에 정의된 모든 위치에서 발생할 수 있습니다. - 파일 속성에 있는 Used In 및 발신 링크 참조가 올바르게 업데이트되지 않습니다.
해결 방법 resolution
이 문제의 근본 원인은 캐시된 자산 경로로 인해 사후 처리 워크플로우가 특정 경로를 무시하기 때문입니다. AEM Guides은 관리자가 사후 처리에서 제외할 폴더를 지정할 수 있도록 하는 OSGi 구성을 제공합니다. AEM Guides 설명서의 폴더에 대한 사후 처리 사용 안 함을 참조하십시오. 이 구성 외에도 저장소에는 건너뛸 경로의 캐시 역할을 하는 노드가 /var/dxml/postprocess/ignoredPaths에 있습니다. 에셋이 이러한 경로 중 하나에 있으면 DXML 후 처리 중에 무시됩니다. 이렇게 하면 다음과 같은 INFO 수준 로그 메시지가 표시될 수 있습니다.
캐시 구성으로 인해 [사후 처리] 경로가 무시됨[ 사후 처리] 페이로드: /content/dam/< path-to-asset>에 대한 사후 처리 건너뛰기
해결 단계
-
영향을 받는 경로가 CRX/DE의
/var/dxml/postprocess/ignoredPaths아래에 나열되어 있는지 확인하십시오. 이 노드로 이동하여 무시된 경로에 해당하는 속성을 확인합니다. 단계는 AEM as a Cloud Service 사용 안내서의 CRXDE Lite 시작하기를 참조하십시오. -
ignoredPaths노드에서 불필요한 항목을 제거합니다. 기본값인/content/dam/projects/translation_output만 유지합니다. 단계는 AEM 6.5 사용 안내서의 cURL을 사용하여 속성 및 노드를 삭제하는 방법을 참조하세요. 값이 비어 있는 속성을 노드에POST하면 AEM에서 해당 속성을 삭제합니다. 주어진 노드에서 속성을 제거하려면 다음 형식을 사용합니다.code language-none curl -u 'userId:password' \ -F "propertyName=" \ http://localhost:4502/path/to/nodepropertyName은(는) 제거할 속성의 이름으로 바꿔야 합니다.path/to/node은(는) 속성이 있는 저장소 경로여야 합니다. 등호(=) 뒤에 값을 비워 두면 AEM에서 지정된 속성을 삭제하도록 알려줍니다.참고: 노드에서 제거할 각 속성에 대해 명령을 반복해야 합니다.
-
영향을 받는 경로와 관련된 다른 모든 항목을 삭제합니다. 또는 영향을 받는 에셋이 무시되는 경로만 삭제합니다. 단계는 AEM 6.5 사용 안내서의 Sling 콘텐츠를 참조하십시오.
-
영향을 받는 경로의 모든 에셋에서 DAM 에셋 업데이트 워크플로 를 다시 실행합니다. 이렇게 하면 메타데이터 생성과 적절한 에셋 처리가 보장됩니다. 단계는 AEM Assets 자습서에서 DAM 자산 업데이트 워크플로우 실행을 참조하십시오.
-
유효성 검사:
-
업데이트 후에도 제목은 유지됩니다.
-
문서 상태 필드가 인터페이스에 올바르게 나타납니다.
-
파일 아이콘은 주제(으)로 표시됩니다.
-
지도에 주제를 추가하면 주제가 파란색으로 표시됩니다.
-
모든 출력 사전 설정은 새 맵에 사용할 수 있습니다.
-
참조(Used In, 발신 링크)가 정확하게 업데이트됩니다.
AEM Guides 설명서의 AEM Guides의 보고서를 참조하여 자산 및 맵에서 컨텐츠 상태, 참조 및 출력 관련 속성을 확인하는 유효성 검사 목록을 개발할 수 있습니다.
-
무시된 경로를 지우고 자산 워크플로우를 다시 실행하면 이전에 누락된 자산 및 메타데이터가 다시 나타나고 AEM Guides에 올바르게 표시됩니다. 제목, 문서 상태, 링크 및 출력 사전 설정이 예상대로 업데이트되어 처리가 정상적으로 재개되었는지 확인합니다.