팁
Phrase Strings의 Contentful 통합에 대한 자세한 내용은 Contentful (Strings)를 참조하십시오.
Contentful은 콘텐츠를 생성하고 관리하여 모든 플랫폼이나 기기에 배포할 수 있는 헤드리스 콘텐츠 관리 인프라를 제공합니다. Phrase는 다음과 같은 두 가지 방법으로 Contentful과 통합됩니다:
-
전용 Contentful 커넥터를 통한 방법(2.0, 엔트리 수준, 필드 수준)
Contentful 2.0 커넥터는 현재 미국 데이터 센터를 통한 인증만 지원합니다.
-
맞춤형 경험을 위한 Contentful 마켓플레이스 플러그인을 통한 방법
참고
이 커넥터는 JSON 객체의 번역을 지원하지 않습니다.
지원되는 현지화 방법
Contentful은 여러 현지화 방법을 지원합니다. 자세한 설명은 Contentful 문서를 참조하십시오.
Contentful 2.0 커넥터는 필드 수준 현지화를 지원하는 현재 권장되는 통합 방식입니다. 또한 다음 기능을 제공합니다:
-
다수의 공백
-
환경 별칭
-
미리보기 URL 설정
-
참조 가져오기
-
태그 기반 콘텐츠 필터링
-
라이브 미리보기 구성
엔트리 수준 현지화(레거시)
Contentful (엔트리 수준) 커넥터를 사용하십시오.
엔트리 수준 커넥터는 현지화된 참조 필드가 있는 콘텐츠 유형에서만 작동합니다(예: 현지화가 활성화된 Localized라는 참조 필드).
필드 수준 현지화(레거시)
Contentful (필드 수준) 커넥터를 사용하십시오.
필드 수준 커넥터는 현지화가 활성화된 번역 가능 필드(예: 텍스트 또는 서식 있는 텍스트 필드)가 있는 콘텐츠 유형에서만 작동하며, 선택적으로 미디어 자산도 지원합니다. 참조된 항목과 해당 항목의 번역 가능한 필드(참조 필드가 현지화된 경우)를 가져옵니다.
중요 사항
레거시 커넥터는 2026년 11월 30일에 지원 중단됩니다. 이러한 커넥터의 새 인스턴스는 2026년 8월 17일까지 생성할 수 있습니다. 지원 중단 날짜 이전에 새 커넥터로 마이그레이션하십시오.
전체 마이그레이션 가이드는 레거시 커넥터 지원 중단을 참조하십시오.
커넥터 여러 사용 사례가 있습니다.
-
프로젝트 관리자는 온라인 리포지토리에서 프로젝트에 직접 파일을 추가할 수 있습니다. 콘텐츠는 항목 ID로 검색할 수 있습니다.
-
제출자가 온라인 리포지토리에서 직접 요청에 파일을 추가할 수 있도록 제출자 포털을 설정하십시오. 콘텐츠는 항목 ID로 검색할 수 있습니다.
-
모니터링되는 문서 또는 폴더의 콘텐츠 크기에 변경 사항이 감지되면 자동 프로젝트 생성(APC)을 사용하여 새 프로젝트가 자동으로 생성되도록 하십시오.
애플리케이션의 사용 사례:
-
콘텐츠 편집자는 Contentful 내에서 직접 현지화를 위해 항목을 제출할 수 있습니다. 이를 통해 콘텐츠 편집자나 관리자는 현지화 흐름을 완전히 제어하고 항목을 볼 때 즉시 상태 업데이트를 받을 수 있습니다.
항목이 완료되면:
-
현지화할 대상 언어를 선택하십시오.
-
선택한 언어에 대해 해당 항목만 Phrase TMS에 제출하거나 필드 선택 탭을 사용하여 필드를 선택하십시오.
-
필드를 선택하지 않으면 현지화 가능한 모든 필드가 번역을 위해 제출됩니다.
-
현지화할 수 없는 필드를 선택하더라도 해당 필드는 번역을 위해 제출되지 않습니다. 현지화 가능한 필드만 제출됩니다.
-
일부 현지화 가능한 필드만 선택된 경우 해당 필드만 번역을 위해 제출됩니다.
-
-
APC 설정에 따라 제출된 콘텐츠에서 작업이 자동으로 생성됩니다. APC 실행 중에는 제출됨 상태의 항목만 작업 생성을 위해 선택됩니다.
-
제출된 항목에서 작업이 생성되면 상태가 진행 중으로 변경됩니다. 번역이 Contentful로 다시 푸시되면 상태가 완료됨으로 변경됩니다.
-
이전에 번역된 항목은 원문이 변경된 후 다시 제출할 수 있습니다.
-
-
콘텐츠 편집자는 Phrase TMS 홈 화면을 사용하여 다음을 수행할 수 있습니다:
-
항목을 일괄 제출하십시오.
-
일괄 제출 시 개별 대상 언어를 지정하십시오.
-
활성 번역 작업에 대한 개요를 확인하십시오.
-
Contentful 설정
Phrase TMS 애플리케이션으로 작업할 때:
-
마켓플레이스에서 Phrase TMS 애플리케이션을 다운로드하십시오.
-
현재 활성 공간에 애플리케이션을 설치하고 애플리케이션 설치가 필요한 콘텐츠 모델을 선택하십시오.
-
Phrase TMS 내에서 커넥터를 생성할 때 획득한 Phrase TMS 인증 토큰을 입력하십시오.
-
설치를 클릭하십시오.
선택 사항 - Launch App(Contentful에서 지원 중단)
Contentful의 Launch App을 통해 워크플로 지원을 사용하는 경우 다음 단계를 따르십시오:
-
하나 이상의 공간에 Contentful의 Launch 애플리케이션을 설치하십시오.
참고
공간당 하나의 워크플로우만 생성할 수 있습니다. 하나의 Contentful 공간 내에서 콘텐츠 유형에 대해 서로 다른 접근 방식이 필요한 경우, 전담 고객 성공 관리자에게 문의하십시오.
-
필요한 현지화 워크플로우를 설정하십시오.
-
설명된 워크플로우를 따르는 콘텐츠 유형을 선택하십시오.
커넥터에서 워크플로우가 설정된 경우, 모니터링되는 아티클이나 콘텐츠 유형에 대해 워크플로우 단계의 변경 사항이 감지되면 자동 프로젝트 생성(APC) 기능이 자동으로 새 프로젝트를 생성합니다.
제출된 작업은 취소할 수 있으며, 변경 사항을 적용한 후 콘텐츠를 다시 제출할 수 있습니다. 이러한 작업은 Phrase에 그대로 남아 있으므로 프로젝트 관리자가 삭제해야 합니다.
참고
Contentful Launch 앱은 2.0 커넥터에서 지원되지 않습니다.
-
설정
페이지에서 섹션으로 스크롤하십시오.
-
커넥터을 클릭합니다.
페이지가 열립니다.
-
새 커넥터를 클릭하십시오.
페이지가 열립니다.
-
유형을 Contentful 2.0(으)로 변경하십시오.
-
커넥터 이름을 입력하십시오.
-
Contentful 2.0에 연결을 클릭하십시오.
Contentful 로그인 창이 열립니다.
-
로그인 정보를 입력하고 로그인을 클릭하십시오(또는 다른 로그인 방법을 사용하십시오). 로그인 창이 닫히고 이 표시됩니다.
-
앱과 함께 커넥터를 사용하는 경우 선택적으로 Phrase Contentful 앱 확인란을 선택하십시오.
-
토큰 생성을 클릭하십시오.
창이 열립니다.
-
토큰 생성을 클릭하십시오.
토큰이 생성됩니다. 생성된 토큰을 클립보드나 텍스트 파일에 복사하십시오. 창을 닫으면 토큰이 다시 표시되지 않으므로 닫기 전에 토큰을 복사했는지 확인하십시오. 이 토큰은 에서 앱에 연결할 때 사용됩니다.
-
창을 닫으면 이 표시됩니다.
-
-
Contentful 태그를 사용하여 번역 가능한 콘텐츠를 식별하는 경우, 태그 ID를 입력하고 Enter 키를 누르십시오.
ID가 표시되며 추가로 더 입력할 수 있습니다. 태그를 사용하여 커넥터에 표시되는 Contentful의 콘텐츠 범위를 제한할 수 있습니다.
-
필요한 경우 을 선택하십시오.
-
필요한 경우 (중첩된 콘텐츠)을 선택하십시오.
이 표시됩니다. 시스템이 콘텐츠 간 관계를 탐색하는 방식을 더 세밀하게 제어하려면 원하는 필터를 적용하십시오.
-
가져오기 중 Phrase가 참조된 항목을 따라 탐색하는 범위를 제한합니다.
기본값은 10,000입니다. 필요한 경우 다른 값을 선택하거나 사용자 지정 정수 값을 지정하십시오.
-
콘텐츠 유형이 지정된 목록과 일치하는 항목에서 중지할지 아니면 계속 따라갈지 선택하십시오.
-
상위 콘텐츠 유형이 지정된 목록과 일치하는 항목을 제외합니다.
-
지정된 콘텐츠 태그를 포함하는 항목에서 중지할지 또는 해당 항목을 따라갈지 선택하십시오.
-
지정된 필드 ID에 의해 참조되는 항목에서 중지할지 또는 해당 항목을 따라갈지 선택하십시오.
-
-
필요한 경우 을 선택하십시오.
필드가 표시됩니다. 분류 설정을 활성화하려면 값을 입력하십시오.
-
선택하면 커넥터가 Contentful에서 분류를 가져와 .XLIFF 파일에 포함합니다. CAT 에디터의 창에는 각 세그먼트의 Contentful 분류 값이 나열됩니다. 분류 값은 번역 가능한 콘텐츠가 아닙니다. 이 값들은 단독으로 또는 항목과 함께 독립형 작업으로 나열, 가져오기 또는 내보내기할 수 없습니다.
-
분류 메타데이터를 사용할 수 없거나 커넥터에 해당 메타데이터가 구성되지 않은 경우 창은 표시되지 않습니다.
-
프로젝트에 기능/화면 컨텍스트가 필요하지 않은 경우, .XLIFF 내보내기 시 성능을 최적화하기 위해 분류를 비활성화 상태로 두는 것이 좋습니다.
-
-
필요한 경우 를 선택하십시오.
별칭은 모든 APC 모니터링과 작업 재가져오기 및 내보내기에 사용됩니다. 나중에 별칭 대상이 변경되면 APC는 새 대상의 콘텐츠를 모니터링하며 작업은 새 별칭 대상에서 다시 가져오거나 새 별칭 대상으로 내보내집니다.
별칭 따르기는 APC 모니터링, 작업 재가져오기 및 작업 내보내기에 적용됩니다. 또한 별칭 URL에서 Phrase Contentful 앱을 통해 제출된 항목에도 적용됩니다. 앱은 제출 시 별칭을 기록하므로, 별칭 대상이 변경된 후에도 커넥터가 이러한 항목을 찾을 수 있습니다. 별칭이 이전 환경을 가리키고 있을 때 제출된 항목은 커넥터에 계속 표시됩니다. 각 항목은 여전히 제출된 환경으로 내보내지고 해당 환경에서 다시 가져와집니다.
별칭을 따르는 커넥터는 별칭 URL 대신 실제 환경 URL에서 제출된 항목을 찾지 못합니다. 또한 별칭 지원이 추가되기 전에 앱을 통해 제출된 항목은 찾지 못합니다. Contentful에서 별칭 URL을 통해 이러한 항목을 다시 제출하십시오.
-
(기본값 및 권장 사항)
APC 및 생성된 작업은 작업/APC 생성 시점에 별칭이 가리키던 환경에 연결됩니다. APC는 해당 환경과 콘텐츠만 모니터링하며, 작업은 해당 환경으로 내보내지고 다시 가져옵니다.
-
APC 및 생성된 작업은 별칭 자체에 연결됩니다. APC는 해당 별칭과 콘텐츠만 모니터링하며, 작업은 해당 별칭으로 내보내지고 다시 가져옵니다.
별칭 대상이 변경되면 APC는 새 별칭 대상(환경)을 모니터링하며, 작업은 이제 해당 대상으로 내보내지고 다시 가져옵니다.
Phrase Contentful 앱을 통해 제출된 항목의 경우, 작업은 항목이 제출된 환경으로 내보내지고 다시 가져옵니다.
사용자 지정 Contentful 역할은 별칭 자체가 아닌 별칭이 가리키는 특정 기본 환경에 대한 직접적인 액세스 권한이 필요하며, 그렇지 않으면 Phrase TMS 앱 대시보드가 로드되지 않습니다. Contentful의 에서 해당 역할의 섹션에 이 액세스 권한을 추가하십시오. 나중에 별칭이 다른 환경으로 다시 지정되면 새 환경에 대한 액세스 권한도 추가하십시오.
-
-
필요한 경우 을 제공하십시오.
이는 Contentful에서 렌더링된 콘텐츠로 연결되는 URL 템플릿입니다. 다음 자리 표시자가 지원됩니다:
-
{env_id}: Environment ID -
{entry.id}: Entry ID -
{space_id}: 공백 ID
URL 템플릿은 다음과 같을 수 있습니다.
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
참고
URL은 Contentful 콘텐츠를 렌더링하는 배포된 애플리케이션으로 연결되어야 합니다. 라이브 미리보기를 사용하려면 URL 템플릿의
contentfulapp.tld를 애플리케이션의 실제 도메인으로 바꾸십시오.콘텐츠 미리보기 설정에 대한 자세한 내용은 Contentful 설명서를 참조하십시오.
로캘은 자리 표시자로 지원되지 않습니다. URL에서 로캘을 사용하려면 고정 값을 지정하고 여러 커넥터 인스턴스를 만드십시오.
-
-
필요한 경우 를 사용하여 특정 필드를 Phrase로 가져오지 않도록 하십시오. 가져오기에서 생략해야 할 ContentID를 제공하십시오.
-
에 필요한 와 을 입력하십시오.
미리보기 API를 사용하려면 Contentful 공간의 API 설정에서 구성해야 하는 이라는 Contentful 액세스 토큰이 필요합니다.
Contentful 2.0 통합은 콘텐츠 가져오기 및 변경 사항 모니터링(APC)을 위해 이 API를 사용합니다.
-
Contentful에서 모니터링/가져올 각 공간과 환경을 선택하십시오.
-
설정 및 액세스는 Contentful 자체 내에서 관리됩니다.
-
-
저장을 클릭합니다.
커넥터는 페이지의 목록에 추가됩니다.
참고
Contentful은 어떤 로캘이 변경되었는지 보고하지 않으므로 APC 모니터링은 실행될 때마다 추적된 항목과 해당 참조의 전체 콘텐츠를 다시 확인합니다. 참조된 항목은 일괄 처리가 아닌 개별적으로 가져오므로 참조된 항목이 많은 공간에서는 한 번의 실행으로 Contentful 미리보기 API 및 콘텐츠 API에 대한 많은 수의 요청이 생성될 수 있습니다. 이 때문에 원문이 변경되지 않았더라도 번역된 콘텐츠를 받은 후 항목을 다시 가져올 수 있습니다. 대용량 공간에서는 이로 인해 APC 실행 속도가 느려지고 Contentful API 사용량이 크게 증가할 수 있습니다.
이를 줄이려면:
-
항목 작업이 완료되면 번역 태그를 제거하고 재번역이 필요한 경우에만 다시 추가하십시오.
-
번역이 필요한 항목만 포함하도록 설정의 범위를 좁히십시오.
-
Phrase Contentful 앱을 사용하십시오. 이 앱은 앱을 통해 제출된 항목만 모니터링합니다.
이전에 번역된 항목은 원문이 변경된 후 다시 제출할 수 있습니다. Phrase Contentful 앱을 사용할 때는 수동으로 다시 제출해야 합니다. APC가 항목을 감지하고 기존 작업의 소스를 업데이트하려면 편집자가 Contentful에서 항목을 열고 Phrase 앱 사이드바에서 Start over를 클릭하거나 앱 대시보드에서 일괄 재제출 기능을 사용해야 합니다. 이는 APC가 수동 재제출 없이 소스 변경 사항을 자동으로 감지하는 파일 또는 폴더 모니터링 커넥터와 다릅니다.
Contentful 2.0 커넥터는 개별 사용자가 아닌 조직에 속합니다. 커넥터가 사용하는 Contentful OAuth 토큰은 이를 승인한 사용자와 연결되어 있습니다.
커넥터를 다른 Contentful 사용자와 연결하려면 기존 OAuth 토큰을 제거하여 다른 사용자가 커넥터를 다시 승인할 수 있도록 해야 합니다:
-
토큰을 생성한 Contentful 계정을 사용하여 관련 공간의 API 토큰 페이지(https://app.contentful.com/spaces/{space_id}/api/cma_tokens)를 엽니다.
-
"Memsource Connector"라는 이름의 토큰을 삭제합니다. 이름이 같은 토큰이 여러 개인 경우, 삭제하기 전에 영향을 받는 커넥터에서 어떤 토큰이 사용되는지 확인하십시오.
-
토큰이 삭제되면 새 사용자가 Phrase TMS의 커넥터 설정에서 커넥터를 다시 승인할 때까지 커넥터가 비활성화됩니다.
원래 사용자의 Contentful 액세스 권한이 제거되기 전에 이 단계를 완료하십시오. 그렇지 않으면 토큰이 더 이상 표시되지 않을 수 있습니다.
중요 사항
사용자 지정 도메인(예: mydomain.phrase.jp)에서 액세스하는 경우, 시크릿 브라우저 창을 열고 cloud.memsource.com 또는 us.cloud.memsource.com을 통해 로그인하여 커넥터를 생성하거나 저장하는 데 필요한 인증을 완료하십시오. 저장 후에는 사용자 지정 도메인을 통해 커넥터에 액세스할 수 있습니다.
-
설정
페이지에서 아래로 스크롤하여 섹션으로 이동하십시오.
-
커넥터을 클릭합니다.
페이지가 열립니다.
-
새 커넥터를 클릭하십시오.
페이지가 열립니다.
-
유형을 Contentful (항목 수준) 또는 Contentful (필드 수준) 중 하나로 변경하고 커넥터 이름을 입력합니다.
-
앱과 함께 커넥터를 사용하는 경우 선택적으로 Phrase Contentful 앱 확인란을 선택하십시오.
-
Contentful 앱 토큰
Phrase TMS Contentful 애플리케이션에 입력할 앱 토큰을 생성합니다. 토큰을 생성하고 Contentful 앱에 복사한 후 커넥터를 저장합니다.
참고
저장 후에는 Contentful 내에서 토큰을 변경할 수 없습니다. 업데이트하려면 Phrase TMS의 커넥터 구성에서 토큰을 폐기하고 새 토큰을 생성하십시오.
-
-
언어 비종속 설정을 구성합니다.
-
소스 언어
Contentful 기본 언어를 덮어쓸 소스 언어를 선택합니다. 그러면 커넥터가 커넥터 구성에 설정된 언어로 된 콘텐츠를 가져옵니다.
예:
참고
애플리케이션 사용 시에는 적용되지 않습니다.
-
-
항목 가져오기 모드를 통해 중첩된 콘텐츠를 처리하는 방법을 선택합니다. 콘텐츠는 참조 필드를 사용하여 다른 콘텐츠를 참조할 수 있으므로 엔티티 계층 구조를 생성할 수 있습니다.
-
Contentful (항목 수준)
항목 수준 커넥터는 중첩된 콘텐츠의 전체 계층 구조를 자동으로 탐색합니다.
-
Contentful (필드 수준)
필드 수준 커넥터가 중첩된 콘텐츠를 가져오는 방법을 선택하십시오.
-
-
저장소에서 추가할 때 명시적으로 선택된 콘텐츠가 가져와집니다.
-
APC에 의해 감지된 변경 사항이 번역을 위해 가져와집니다.
-
-
참조된 항목 가져오기
-
커넥터는 중첩된 콘텐츠의 전체 계층 구조를 탐색하고 번역 가능한 모든 필드를 번역을 위해 가져옵니다.
-
-
-
-
번역 가능한 필드 생략에 쉼표로 구분된 목록을 만들어 가 선택된 필드를 Phrase TMS로 가져올 때 제외하십시오. 다음 구조를 사용하십시오:
contentTypeID:fieldID.-
나열된 필드를 비워 두려면 생략된 필드 비워 두기를 선택하십시오. 이 설정은 나열된 항목에 모두 적용됩니다.
-
나열된 필드에 소스 값을 포함하려면 소스를 타겟으로 복사를 선택하십시오. 이 설정은 나열된 항목에 모두 적용됩니다.
-
-
소스 언어의 특정 필드에 데이터가 없는 경우 을 선택하십시오.
필요한 경우 드롭다운 목록에서 를 선택하십시오. 이 언어 로캘은 데이터가 누락된 경우에 사용됩니다.
참고
Contentful 대체 언어와 이 설정 사이에는 아무런 관계가 없습니다.
-
필요한 경우 (BETA)을 제공하십시오.
이는 Contentful에서 렌더링된 콘텐츠로 연결되는 URL 템플릿입니다. 다음 자리 표시자가 지원됩니다:
-
{env_id}: Environment ID -
{entry.sys.id}: Entry ID -
{space_id}: 공백 ID
URL 템플릿은 다음과 같을 수 있습니다.
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
참고
URL은 Contentful 콘텐츠를 렌더링하는 배포된 애플리케이션으로 연결되어야 합니다. 실시간 미리보기를 사용하려면 URL 템플릿의
contentfulapp.tld를 애플리케이션의 실제 도메인으로 바꾸십시오.콘텐츠 미리보기 설정에 대한 자세한 내용은 Contentful 설명서를 참조하십시오.
로캘은 자리 표시자로 지원되지 않습니다. URL에서 로캘을 사용하려면 고정 값을 지정하고 여러 커넥터 인스턴스를 만드십시오.
-
-
기술 지원 팀에서 디버그 정보 로깅을 요청하는 경우 을 선택하십시오.
-
Contentful에 연결을 클릭하십시오.
연결에 성공하면 커넥터 설정에 체크 표시가 나타납니다. 그렇지 않으면 빨간색 느낌표가 나타납니다. 자세한 내용을 보려면 아이콘 위로 고정하세요.
-
Contentful (항목 수준)에만 해당:
소스 언어를 설정하십시오.
참고
이 언어는 Contentful의 로캘 설정에 구성된 Contentful 공간의 기본 로캘과 일치해야 합니다.
-
저장을 클릭합니다.
커넥터는 페이지의 목록에 추가됩니다.
-
선택적으로 커넥터를 편집하여 를 선택하십시오.
-
:
커넥터가 선택된 단계(예: 번역)에서 문서를 모니터링합니다. 작성자는 번역 준비가 되면 이 라벨을 문서에 적용할 수 있습니다.
Contentful에서 가져올 때:
-
소스 아티클이 다운로드되면 커넥터가 워크플로 단계를 선택한 단계(예: 번역 진행 중)로 변경합니다.
Contentful로 내보낼 때:
-
번역이 내보내지면 커넥터는 원본 아티클의 워크플로 단계를 선택한 단계(예: 번역 완료)로 설정합니다.
참고
Contentful은 2023년 6월 1일부터 워크플로 지원을 중단했습니다. 계속 사용하는 것은 지원되지 않습니다.
-