통합

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라는 새 사용자를 생성하고 해당 사용자를 Authors 그룹에 추가하십시오.

  1. 설정 Setup_gear.png 페이지에서 Integrations 섹션으로 스크롤하십시오.

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

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

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

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

  4. 유형을 Adobe Experience Manager Live Preview(으)로 변경하고 커넥터 이름을 입력하십시오.

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

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

    도메인 이름은 외부에서 확인할 수 있어야 합니다(인트라넷 도메인 아님).

  6. 사용자 이름과 비밀번호를 입력하십시오.

    싱글 사인온(SSO) 및 2단계 인증(2FA)은 지원되지 않습니다. Drupal 계정에 SSO 또는 2FA가 적용된 경우, 둘 다 적용되지 않는 전용 서비스 계정을 사용하십시오.

  7. 페이지 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: (''))의 링크가 다시 작성됩니다.

  8. 저장을 클릭합니다.

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

커넥터 삭제

커넥터를 삭제하려면:

  1. Integrations 페이지에서 삭제할 커넥터를 선택하십시오.

  2. Delete을 클릭하십시오.

    Delete connector 창이 열립니다.

  3. "delete"를 입력하고 Delete을 클릭하십시오.

    커넥터가 삭제되고 커넥터 목록이 표시됩니다.

참고

프로젝트의 휴지통에 있는 작업을 포함하여 불완전한 작업에 여전히 연결된 커넥터는 삭제할 수 없습니다. 이러한 커넥터를 삭제하려고 하면 "커넥터 삭제 실패" 오류가 반환됩니다.

해결 방법: 커넥터와 연결된 프로젝트를 열고 남아 있는 작업을 완료하거나 삭제하십시오. Settings/Recycle bin으로 이동하여 비우면 커넥터에 여전히 연결된 작업이 제거됩니다. 커넥터 삭제를 다시 시도하십시오.

참고

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

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

번역 워크플로 구성

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

  • Access and Security에서 Allow loading of external content in Phrase CAT editor 옵션을 활성화하십시오.

레거시 버전을 사용하는 경우 service 및 submitter portal을 만들고 유효성을 검사해야 합니다. 구성을 확인하려면 다음 단계를 따르십시오.

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

  2. Export를 Job 타일 메뉴에서 선택합니다.

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

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

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

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

AEM 구성

플러그인 설치

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

온프레미스 AEM

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

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

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

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

  4. 패키지 업로드를 선택하고 설치 파일을 업로드합니다.

  5. 강제 업로드를 체크하고 제출합니다.

AEM as a Cloud Service

플러그인이 이미 설치되어 있으면 4단계로 이동하십시오.

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

    repositories {
    
      리포지토리
        <id>project.local</id>
        <name>project</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. 도구에서 클라우드 서비스로 이동하여 Translation Cloud Services를 클릭하십시오.

  2. 특히 번역을 위해 새 구성을 만드십시오.

    • Translate Component Strings 및 Translate Tags가 선택 해제되어 있는지 확인하십시오.

    • Translate page assets를 Do not translate로 설정하십시오.

    • Assets 탭에서 Translation Workflow를 Do not translate로 설정하십시오.

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

사이트에 번역 통합을 적용하십시오.

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

번역 통합을 적용하려면:

  • 고급 탭에서 새로 만든 구성을 클라우드 구성으로 선택하십시오.

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

번역할 콘텐츠를 제출하십시오.

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

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

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

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

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

  4. 다국어 번역 프로젝트 만들기를 선택하십시오.

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

  5. 프로젝트 제목을 입력하고 만들기를 클릭하십시오.

  6. 프로젝트 섹션에서 프로젝트로 이동하여 여십시오.

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

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

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

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

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

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

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

    팁

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

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

    프로젝트 세부 정보 페이지를 새로 고치면 강제로 가져오기가 수행됩니다.

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

  10. 거부된 경우, 작업의 첫 번째 워크플로 단계는 이메일 발송됨으로 설정되고, 나머지 워크플로 단계는 신규으로 설정됩니다.

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

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

기타

사용자 지정 언어 매핑

온프레미스 AEM

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

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

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

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

  3. 새 노드를 만듭니다.

  4. Name으로 Adobe Experience Manager 언어 코드(예: 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 속성으로 저장됩니다.

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

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로 설정하며, 이는 재인덱싱이 오류 없이 완료되었음을 확인하는 것이므로 추가 조치가 필요하지 않습니다.

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

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.