통합

Adobe Experience Manager - AEM (TMS)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

사용 가능:

  • 엔터프라이즈 플랜

라이선스에 관한 질문은 영업팀에 문의하십시오.

사용 가능:

  • Enterprise 요금제(레거시)

라이센스 질문은 영업팀에 문의하십시오.

지원되는 버전

Adobe Experience Manager용 Phrase 번역 플러그인은 Adobe Experience Manager와 동일한 제품 지원 기간을 따릅니다. 지원 기간에 대한 정보는 https://helpx.adobe.com/support/programs/eol-matrix.html을 참조하십시오.

Adobe Experience Manager 버전이 핵심 지원 종료에 도달하면 Phrase는 더 이상 해당 플러그인을 유지 관리하지 않습니다. 설치 프로그램은 계속 사용할 수 있지만 더 이상의 개선 사항이나 수정 사항은 구현되지 않습니다.

  • 플러그인 버전 2.x는 6.5를 지원합니다.

  • 플러그인 버전 3.x는 AEM as a Cloud Service를 지원합니다.

플러그인 릴리스 정보

Phrase 구성

인컨텍스트 미리보기 구성

인컨텍스트 미리보기 기능은 CAT 웹 편집기와 CAT 데스크톱 편집기 모두에서 원문 또는 번역문의 실시간 미리보기를 제공합니다.

표, 열, 다양한 그래픽, 서식 및 글꼴(사용자가 설치한 경우)이 지원됩니다. 이 기능은 번역 시 문맥을 제공하기 위한 것이며 원본이나 완성된 문서를 완벽하게 재현하지는 않으므로, 일부 시각적 차이가 발생할 수 있습니다. 또한 액세스 및 보안 설정에서 편집기에서 외부 콘텐츠 로드 허용 옵션을 활성화/비활성화하여 영향을 받을 수도 있습니다.

Phrase 요구 사항:

  • 온프레미스 설치에 액세스하려면 엔터프라이즈 방화벽을 통과하십시오.

  • 저작 환경에 인증하십시오.

온프레미스 설치를 위한 방화벽 구성:

  • 설치는 Phrase 서버 IP 주소에서 액세스할 수 있어야 합니다. 현재 목록은 Phrase 서버 IP 주소를 참조하십시오.

  • 도메인 이름은 외부에서 해석될 수 있어야 합니다.

참고

일부 HTML 태그는 위험을 초래할 수 있으므로 CAT 편집기는 미리보기를 표시할 때 이 HTML에서 해당 태그를 제거합니다. 이는 사용자의 데이터 개인정보보호 및 보안을 보장하기 위함입니다.

제거된 태그의 예로는 FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT 또는 background-image CSS 속성이 있습니다.

Phrase TMS 설정

필수 조건: 게시되지 않은 페이지를 보는 데 필요한 최소 권한을 가진 Adobe Experience Manager 사용자를 생성하십시오.

팁

phrase-preview라는 새 사용자를 생성하고 해당 사용자를 작성자 그룹에 추가하십시오.

  1. 설정 Setup_gear.png 페이지에서 아래로 스크롤하여 통합 섹션을 찾으십시오.

  2. 커넥터을 클릭합니다.

    커넥터 페이지가 열립니다.

  3. 새 커넥터를 클릭하십시오.

    커넥터 생성 페이지가 열립니다.

  4. 유형을 Adobe Experience Manager 실시간 미리보기(으)로 변경하고 커넥터 이름을 입력하십시오.

  5. 선택적으로 보안 연결 강제 적용을 활성화하십시오.

  6. 호스트를 입력하십시오.

    Adobe Experience Manager 설치의 호스트 주소를 사용하십시오(예: https://aem-author.example.org/ 또는 https://author-X-Y.adobeaemcloud.com/).

    도메인 이름은 외부에서 해석될 수 있어야 합니다(인트라넷 도메인이 아닙니다).

  7. 실시간 미리보기 사용자 이름 및 실시간 미리보기 비밀번호를 입력하십시오.

  8. 페이지 HTML에 포함된 링크를 수정하려면 URL 재작성 규칙을 정규식으로 제공하십시오.

    예:

    https://example.org/en-us/images/sample.jpg에서 전체 로캘 코드를 언어 코드로만 바꾸려면 /([a-z]{2})-[a-z]{2}/를 찾아 /$1/(으)로 바꾸십시오.

    <img src="" data-lazy-src="", <link href="", <script src="", <iframe src="" 태그의 링크와 CSS 스타일 및 참조된 CSS 파일(url: (''))의 링크가 다시 작성됩니다.

  9. 저장을 클릭합니다.

    커넥터는 커넥터 페이지의 목록에 추가됩니다.

참고

일부 HTML 태그는 위험을 초래할 수 있으므로 CAT 편집기는 미리보기를 표시할 때 이 HTML에서 해당 태그를 제거합니다. 이는 사용자의 데이터 개인정보 보호 및 보안을 보장하기 위함입니다.

제거된 태그의 예로는 FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT 또는 background-image CSS 속성이 있습니다.

번역 워크플로 구성

Adobe Experience Manager 작업 처리를 구성하려면 필요에 맞게 구성된 프로젝트 템플릿을 만듭니다.

  • 액세스 및 보안에서 Phrase CAT 편집기에서 외부 콘텐츠 로드 허용 옵션을 활성화합니다.

레거시 버전을 사용하는 경우 서비스와 제출자 포털을 만들고 유효성을 검사해야 합니다. 구성을 확인하려면 다음 단계를 따르십시오.

  1. 완료되지 않은 번역 프로젝트를 엽니다.

  2. 내보내기를 작업 타일 메뉴에서 선택합니다.

  3. 다운로드한 zip 파일 내에서 원본 텍스트가 포함된 .XML 파일을 찾습니다.

  4. Phrase에서 통합에 사용되는 제출자 포털로 이동하여 나열된 URL을 엽니다.

  5. SP 양식을 작성하고 .XML 파일을 업로드한 다음 이메일을 확인하고 제출합니다.

  6. 구성된 대로 프로젝트 템플릿에서 새 프로젝트가 생성되었는지 확인합니다.

AEM 구성

플러그인 설치

Phrase의 Phrase 에코시스템 페이지에서 다운로드 버튼을 사용하여 최신 플러그인 패키지를 다운로드합니다. 이 플러그인은 구매한 조직에서만 사용할 수 있습니다.

온프레미스 AEM

  1. 6.2 또는 6.3에서 6.4 이상으로 마이그레이션하는 경우, 클래식 UI 관리 도구 (/miscadmin#/etc/cloudservices/memsource-translation)에서 모든 레거시 클라우드 서비스 구성을 제거하십시오.

    모든 구성이 레거시 클라우드 서비스 > AEM용 Memsource 번역 플러그인에서 사라집니다.

  2. 도구, 배포에서 패키지로 이동합니다.

  3. 해당되는 경우, 이전 버전의 플러그인을 제거하십시오.

  4. 패키지 업로드를 선택하고 설치 파일을 업로드하십시오.

  5. 강제 업로드를 확인하고 제출하십시오.

클라우드 서비스로서의 AEM

플러그인이 이미 설치되어 있다면 4단계로 건너뛰십시오.

  1. AEM 클라우드 서비스 프로젝트 루트 pom.xml에 로컬 파일 시스템 기반 메이븐 저장소를 추가하십시오:

    repositories {
    
      리포지토리
        <id>project.local</id>
        <name>프로젝트</name>
        <url>file:${maven.multiModuleProjectDirectory}/repository</url>
      리포지토리
    
    repositories {
  2. all/pom.xml에 플러그인 의존성을 추가하십시오:

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>X.X.X</version>
      <type>zip</type>
    </dependency>
  3. all/pom.xml -> filevault-package-maven-plugin 구성에 임베디드 블록을 추가하십시오:

    plugin
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      구성
      <group>my_packages</group>
      <embeddeds>
       <embedded>
         <groupId>com.memsource</groupId>
         <artifactId>aem-memsource-plugin.all</artifactId>
         <type>zip</type>
         <target>/apps/aem-memsource-plugin-packages/application/install</target>
       </embedded>
    
  4. 로컬 메이븐 저장소에 플러그인을 추가합니다. AEM 클라우드 서비스 프로젝트 루트에서 다음 명령을 실행하여 {memsource.plugin.path} 자리 표시자를 플러그인 경로(예: /tmp/aem-memsource-plugin.all-3.0.1.zip)로 바꿉니다:

    mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={memsource.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip
    
  5. all/pom.xml에서 올바른 플러그인 버전(예: 3.0.1)을 설정하십시오:

    <dependency>
      <groupId>com.memsource</groupId>
      <artifactId>aem-memsource-plugin.all</artifactId>
      <version>3.0.1</version>
      <type>zip</type>
    </dependency>
    

플러그인 구성

두 가지 구성이 필요합니다:

  • TMS 연결 방법을 지정하여 번역 서비스 공급자로 추가함으로써 시스템에 Phrase가 존재함을 알립니다.

  • 번역 통합 구성을 설정하여 Adobe Experience Manager에 Phrase를 언제 어떻게 사용할지 알립니다.

    예:

    중요도가 높은 콘텐츠에는 Phrase를 사용하고, 커뮤니티 콘텐츠에는 기계 번역 공급업체를 사용하십시오.

Phrase를 번역 서비스 공급자로 추가

다음 단계를 따르십시오:

  1. 도구, 일반에서 구성 브라우저로 이동합니다.

  2. 각 Phrase 서비스에 대한 구성 컨테이너를 만듭니다(예: 사람 번역을 위한 구성 하나와 기계 번역 전용을 위한 별도의 구성 하나).

  3. 클라우드 서비스에서 번역 클라우드 서비스로 이동합니다.

  4. conf 디렉토리를 확장하십시오.

  5. 새 구성을 만들고 다음 정보를 입력하십시오:

    • 호스트 이름: 기본 URL은 https://cloud.memsource.com/web/이지만, 귀하 또는 LSP가 사용자 지정 URL을 사용하는 경우 다를 수 있습니다.

    • 사용자 이름 및 비밀번호 (사용자 권한에서 전역 서버 설정 수정 옵션이 활성화된 PM 역할이어야 함).

    연결을 클릭하십시오.

  6. 다른 옵션을 선택하고 구성을 닫으십시오.

    • 모든 번역 작업을 단일 Phrase 프로젝트로 그룹화 

      하나의 AEM 프로젝트 내의 모든 번역 작업은 하나의 Phrase 프로젝트 내에서도 생성됩니다.

      중요 사항

      이 옵션은 Phrase 프로젝트 템플릿 설정에서 사전 번역 완료 시 작업 완료로 설정 및 모든 작업 완료 시 프로젝트 완료로 설정이 동시에 활성화된 경우 올바르게 작동하지 않습니다.

    • AEM으로 가져온 후 Phrase 작업 상태를 전달됨으로 설정 

    • 분석 생성 

      활성화된 경우, 번역 작업이 전송되면 파일이 가져와질 때 분석이 자동으로 생성됩니다. 분석은 프로젝트 템플릿 설정과 관계없이 항상 언어별로 생성됩니다. 

    • 견적 생성 

      분석 자동 생성이 활성화된 경우, 이러한 분석을 기반으로 견적을 생성할 수 있습니다.

이전 버전을 사용하는 경우 서비스 및 제출자 포털 정보도 필요합니다.

번역 통합 설정

AEM용 Phrase 번역 플러그인을 사용할 때, 번역 작업의 모든 파일이 번역을 위해 제출되고 Phrase에서 반환됩니다. 프로젝트 번역 통합 구성을 사용하여 번역할 수 없는 자산이나 참조 자료가 프로젝트에 포함되지 않도록 하십시오.

  1. 도구에서 클라우드 서비스로 이동한 다음 번역 클라우드 서비스를 클릭하십시오.

  2. 번역을 위한 새 구성을 만듭니다.

    참고

    conf 아래에 구성을 만듭니다. /libs 아래의 항목은 읽기 전용 Adobe 기본값입니다.

    • Translate Component Strings 및 Translate Tags가 선택 해제되어 있는지 확인합니다.

    • Translate page assets를 Do not translate로 설정합니다.

    • Assets 탭에서 Translation Workflow를 Do not translate로 설정합니다.

  3. 프로젝트에 여전히 번역할 수 없는 자산이나 참조 자료가 포함되어 있는 경우 Phrase에서 직접 표시하고 삭제하십시오.

사이트에 번역 통합 적용

사이트 분류의 다른 부분으로 기본 Phrase 번역 공급자를 구성합니다. 사이트의 루트 노드에서 공급자를 구성합니다. 모든 하위 페이지가 설정을 상속합니다. 다른 공급자 구성을 사용해야 하는 노드에서 설정을 재정의합니다(예: 전체 사이트는 사람 번역을 사용하지만 커뮤니티 섹션은 기계 번역을 사용하는 경우).

번역 통합을 적용하려면:

  • Advanced 탭에서 새로 만든 구성을 클라우드 구성으로 선택합니다.

이 페이지에서 콘텐츠를 추가할 때 번역 가능한 콘텐츠만 추가됩니다. References Panel에서 프로젝트를 생성하면 루트 페이지와 연결된 클라우드 구성을 사용하도록 자동으로 설정됩니다.

번역을 위해 콘텐츠 제출

번역을 위해 콘텐츠(사이트, 에셋)를 제출하려면 Adobe Experience Manager에서 번역 프로젝트를 만듭니다. 프로젝트 섹션에서 수동으로 프로젝트를 만들거나 내장된 워크플로를 사용하여 노력을 최소화할 수 있습니다.

내장된 워크플로를 통해 제출할 프로젝트를 준비하려면 다음 단계를 따르십시오:

  1. 사이트 보기에서 페이지로 이동하여 선택한 다음 참조 패널을 엽니다.

  2. 언어 사본을 클릭하고 레일 하단의 생성 및 번역 섹션을 확장하십시오.

  3. 대상 언어를 선택하고 선택적으로 모든 하위 페이지 선택의 선택을 취소하십시오.

  4. 다국어 번역 프로젝트 생성을 선택하십시오.

    대상 언어가 여러 개인 경우 각 언어에 대해 별도의 프로젝트가 생성됩니다.

  5. 프로젝트 제목을 입력하고 생성을 클릭하십시오.

  6. 프로젝트 섹션에서 프로젝트로 이동하여 엽니다.

  7. 첫 번째 타일의 줄임표를 클릭하여 고급 프로젝트 설정을 엽니다.

    올바르게 구성된 경우 위 단계에서 생성된 구성이 참조됩니다.

  8. 작업을 제출하려면 작업 타일 메뉴에서 시작을 선택하십시오.

    몇 분 내에 새 프로젝트가 생성됩니다.

    • 가져오기 시 프로젝트 템플릿에서 공급자가 할당되고 AEM 작업 항목 상태가 번역을 위해 커밋됨(으)로 설정됩니다.

    • 공급자가 작업을 수락하면 AEM 작업 항목 상태가 번역 진행 중(으)로 변경됩니다.

    • 작업이 삭제되거나 취소되면 AEM 작업 항목 상태가 취소됨(으)로 변경됩니다.

    팁

    Adobe Experience Manager는 번역 플랫폼 구성에서 구성된 일정에 따라 웹 콘솔을 통해 액세스하여 작업 상태 업데이트를 폴링합니다.

    스케줄러 Cron 속성을 자주 실행하도록 설정하면(예: 0 0/5 * * * ? *) 5분마다 번역 작업 상태가 새로 고쳐집니다.

    프로젝트 세부 정보 페이지를 새로 고침하면 pull 작업이 강제로 실행됩니다.

  9. Phrase에서 프로젝트 작업을 번역하고 상태를 Completed로 설정하십시오. 완료되면 작업이 AEM으로 다시 가져와집니다.

  10. 거부된 경우 작업의 첫 번째 워크플로 단계는 Emailed로 설정되고, 나머지 워크플로 단계는 New로 설정됩니다.

  11. AEM 작업 항목이 수락되면 플러그인 설정에 구성된 대로 작업 상태가 Delivered로 업데이트됩니다.

참조 패널을 사용하여 번역 프로젝트를 생성하는 방법에 대한 자세한 내용은 Adobe 문서를 참조하십시오.

기타

사용자 지정 언어 매핑

온프레미스 AEM

Adobe Experience Manager 언어를 Phrase의 다른 언어(예: zh를 zh_tw로)로 매핑하려면 다음 단계를 따르십시오.

매핑은 소스 언어와 타겟 언어 모두에 적용됩니다.

  1. CRXDE(/crx/de/index.jsp)를 엽니다.

  2. /apps/memsource-connector/language-mapping/ 폴더로 이동합니다.

  3. 새 노드를 생성합니다.

  4. Adobe Experience Manager 언어 코드를 Name(으)로 사용하고(예: zh), Type: nt:unstructured을(를) 유지합니다.

  5. 속성 추가:

    • Name: memsourceLanguage

    • 유형 문자열

    • Value: 언어 코드(예: zh_tw)

  6. Save All을 클릭합니다.

매핑되지 않은 언어 코드는 그대로 전송됩니다.

AEM as a Cloud Service

AEM Cloud Services에서 언어 매핑을 추가하려면 다음 단계를 따르십시오:

  1. /conf/aem-memsource-plugin/language-mapping/ 폴더에 .content.xml 파일을 생성합니다.

  2. 생성된 파일을 열고 다음 내용을 복사합니다:

    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
        jcr:primaryType="sling:Folder"/>
  3. /conf/aem-memsource-plugin/language-mapping/zh-cn 폴더에 .content.xml 파일을 생성합니다.

  4. 생성된 파일을 열고 다음 내용을 복사합니다:

    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0"
              jcr:primaryType="nt:unstructured"
              memsourceLanguage="zh_cn">
    </jcr:root>
  5. 이전 단계에서 만든 경로를 ui.content/src/main/content/META-INF/vault/filter.xml에 있는 filter.xml 파일에 추가합니다:

    <?xml version="1.0" encoding="UTF-8"?>
    <workspaceFilter version="1.0">
    
        <filter root="/conf/aem-memsource-plugin" mode="update"/>
        <filter root="/conf/aem-memsource-plugin/language-mapping" mode="update"/>
    </workspaceFilter>

프로젝트 ID

번역 작업이 제출되면 프로젝트 ID와 UID가 /content/projects/project-name/jcr:content/dashboard/gadgets/translationjob에 PROPERTY_MEMSOURCE_PROJECT_ID와 PROPERTY_MEMSOURCE_PROJECT_UID 속성으로 저장됩니다.

이 ID들을 AEM 환경에서 표시하거나, API에서 플러그인 기능을 확장하는 데 사용하십시오.

AEM 문제 해결

문제

원인

솔루션

Cloud Manager가 /content/projects 아래의 translationObjectID에 대한 쿼리에 대해 "Query Without Index" 경고를 보고합니다.

Phrase AEM 커넥터는 런타임에 할당된 translationObjectID을(를) 통해 번역 작업 노드를 찾습니다. 이 식별자는 기존 리포지토리 속성으로 존재하지 않으므로 AEM as a Cloud Service는 이를 미리 인덱싱할 수 없으며, 대신 전체 탐색을 수행하게 되어 Cloud Manager에 의해 경고로 표시됩니다.

oak:QueryIndexDefinition 유형의 사용자 지정 Oak/Lucene 인덱스 정의를 /content/projects로 범위 지정하여 추가하고, translationObjectID에 대한 속성 인덱스를 생성하십시오. 런타임에 인덱스 정의를 만드는 대신 코드 파이프라인을 통해 배포하고, 프로덕션 환경에 배포하기 전에 비프로덕션 환경에서 유효성을 검사하십시오. 인덱스를 AEM 인스턴스의 프로젝트 폴더 구조로 범위 지정하고, 가능한 경우 /content/projects 전체를 인덱싱하는 대신 특정 프로젝트 폴더로 좁히십시오. 인덱스 범위가 너무 넓으면 성능에 영향을 줄 수 있습니다. 배포 후 AEM은 재인덱싱이 완료되면 인덱스 정의의 reindex 속성을 false로 설정하며, 이는 재인덱싱이 오류 없이 완료되어 추가 작업이 필요 없음을 나타냅니다.

Maven 빌드가 “Package of type ‘APPLICATION’ is not supposed to contain any sub packages” 또는 “Package of type ‘APPLICATION’ is not supposed to contain OSGi bundles or configurations”와 같은 filevault-package-maven-plugin 유효성 검사 오류로 인해 실패합니다.

플러그인 버전 3.1.18.6 이하에서는 OSGi 번들과 구성 파일이 애플리케이션 유형 패키지 내에 패키징되어 있으며, 이는 AEM as a Cloud Service 유효성 검사에서 거부됩니다.

플러그인 버전 3.1.18.7 이상으로 업데이트하십시오. 임시 방편으로 추가된 경우 Maven 구성에서 skipSubPackageValidation을 제거하십시오.

Translation Cloud Services의 /libs 아래 목록에서 Phrase가 누락되었습니다.

/libs 아래의 항목은 읽기 전용 Adobe 기본값입니다. 플러그인은 해당 구성을 /conf, /apps/aem-memsource-plugin 및 /var/memsource-tms 아래에 저장합니다.

conf 아래에 번역 통합 구성을 생성하십시오. 서버 연결은 /conf/global/settings/cloudconfigs/translation/memsource-translation에 별도로 저장됩니다.

도움이 되었습니까?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.