Phrase Strings 통합(이 인터페이스에서는 라고 불립니다)은 Phrase TMS와 Phrase Strings를 연결합니다. 이 통합은 작업 수준 및 프로젝트 수준 동기화를 모두 지원합니다.
필수 조건
-
TMS 및 Strings 애플리케이션 모두에 대한 액세스 권한
-
TMS 프로젝트에 사용된 언어 코드는 Strings 작업의 로케일 코드와 일치해야 합니다.
-
Strings 프로젝트의 기본 언어는 TMS 프로젝트에 정의된 소스 언어와 동일해야 합니다.
중요 사항
Figma 파일은 Strings에서 전체 라이브 파일로 표시될 수 있지만 TMS에서는 지원되지 않습니다. TMS CAT 편집기는 특정 Figma 프레임의 번역된 컨텐츠만 SVG 형식으로 표시할 수 있습니다.
Strings 키 번역 상태는 지원되지 않습니다. TMS로 가져오기 전에 Strings에서 으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings로 으로 반환될 수 있습니다.
다음의 경우 Strings 작업을 가져온 후 TMS에서 생성된 세그먼트의 수는 원래 키 수와 다를 수 있습니다.
-
키는 Strings에서 제외됨으로 표시됩니다. 제외된 키를 가져올 수 없습니다.
-
TMS에서 작업을 생성할 때 XLIFF 2.0의 파일 가져오기 설정에서 세그먼트 XLIFF 옵션이 활성화되었습니다. 이러한 경우에는 Strings 키 수보다 세그먼트 수가 더 많을 수 있습니다.
Strings 키는 HTML 개체를 포함할 수 있습니다. TMS에서 커넥터를 설정할 때, 옵션을 활성화하여 HTML 엔티티가 해당 문자로 표시되지 않고 보존되도록 합니다.
Strings 키의 소스 텍스트에 있는 선행 및 후행 공백은 TMS CAT 편집기에 표시되지 않습니다. 이 공백은 스켈레톤에 보존되며 작업이 Strings로 다시 동기화될 때 소스와 타겟 모두에 다시 삽입됩니다. 공백 수가 번역 중 TMS 편집기에 반영되지 않으므로, 이는 Strings에 구성된 문자 제한 유효성 검사에 영향을 줄 수 있습니다.
커넥터 사용하여 여러 프로젝트와 파일을 APC 모니터링할 수 있습니다. 각 프로젝트 하나의 APC 내에서 개별 모니터링이 필요합니다.
APC가 작업 동기화 트리거를 처리할 때, Strings 로캘당 하나의 TMS 작업을 생성합니다. 이러한 작업의 가져오기 순서는 보장되지 않으며 APC 규칙에 할당된 프로젝트 템플릿을 통해 구성할 수 없습니다. 이 프로세스의 어떤 단계에서도 정렬 메커니즘이 적용되지 않습니다. 로캘 그룹별로 다른 처리를 적용하려면, 각각 다른 프로젝트 템플릿을 가리키는 별도의 APC 규칙을 구성하십시오.
커넥터는 작업 로캘 주석을 사용하여 해당 Phrase TMS 프로젝트에 대한 메타데이터를 Strings 작업 및 작업 로캘에 첨부합니다. 작업 로캘 주석을 나열하기 위한 Phrase Strings API 엔드포인트가 이 메타데이터를 검색합니다. 작업 타겟 로캘을 나열하기 위한 엔드포인트도 include_annotations 매개변수가 true로 설정된 경우 이 메타데이터를 포함합니다. 주석이 달린 작업에는 tms_project_id 및 tms_in_progress와 같은 필드가 포함되어 있어, 연결된 Phrase TMS 프로젝트에서 Strings 작업의 상태를 추적할 수 있습니다.
TMS는 프로젝트에서 동일한 로캘을 소스 언어와 타겟 언어로 동시에 사용하는 것을 지원하지 않습니다. 예를 들어, Strings 작업이 en-US를 소스 언어와 타겟 언어로 모두 사용하는 경우, en-US 타겟을 TMS로 가져올 수 없으며 전체 작업을 완료된 것으로 표시할 수 없습니다. TMS로 동기화될 작업을 Strings에서 생성할 때는 소스 로캘을 타겟 로캘로 선택하지 마십시오.
번역을 위해 ICU 메시지나 복수 형태가 있는 Strings 작업을 TMS로 보낼 때 XLIFF 2.0 파일 가져오기 설정 또는 TMS 프로젝트 템플릿에서 옵션을 활성화합니다.
커넥터 여러 사용 사례가 있습니다.
-
TMS 프로젝트 관리자는 온라인 리포지토리 TMS 프로젝트에 직접 파일을 추가 수 있습니다.
-
제출자가 Phrase TMS 제출자 포털을 통해 Phrase Strings에서 직접 요청에 파일을 추가할 수 있도록 설정합니다.
-
모니터링되는 파일 또는 폴더에 대해 마지막으로 수정된 날짜에서 변경이 감지되면 TMS 자동 프로젝트 생성(APC)을 사용하여 새 프로젝트를 자동으로 생성하십시오.
-
작업 수준 및 프로젝트 수준 동기화 모두에 대해, 모니터링되는 프로젝트 경로를 작업 폴더(예: space/project/main/jobs)까지 모두 선택해야 합니다.
-
작업 동기화의 경우, 다음 작업 업데이트로 APC가 트리거됩니다:
-
새로 추가된 키 또는 기존 키 변경
-
Strings 수정된 작업 만기일
참고
작업 다시 열리는 것은 APC 업데이트 간주되지 않습니다.
-
-
프로젝트 수준 동기화의 경우, APC는 다음으로 트리거됩니다:
-
새로 추가된 키
-
기존 키에 대한 변경 사항
-
-
APC 설정 시 을 선택하면 원격 온라인 리포지토리는 소스뿐만 아니라 대상 업데이트를 위해 모니터링될 수 있습니다.
대상 업데이트를 모니터링하도록 선택할 경우 온라인 리포지토리 대상 복사본을 변경하면 Phrase TMS 번역 메모리 자동으로 업데이트.
-
으로 선택된 경우, Strings 대상 언어의 주요 텍스트 변경 사항이 관련 APC 프로젝트에서 사용되는 TMS 번역 메모리에 자동으로 업데이트됩니다.
-
-
TMS 커넥터 API는 UI를 통해 수동으로 수행되는 단계를 자동화하는 데 사용할 수 있습니다. 웹 후크는 특정 이벤트(예: 작업 상태 변경)에 대해 제3자 시스템에 알림을 보낼 수 있습니다.
페이지는 Phrase Strings 커넥터를 사용하는 모든 작업 동기화 설정(APC)에 대한 중앙 집중식 보기를 제공합니다. 여기에는 Strings에서 직접 생성된 동기화와 TMS에서 구성된 동기화가 모두 관련 정보와 함께 포함됩니다.
페이지에서 Strings의 관리자 및 프로젝트 관리자 사용자는 를 통해 새 작업 동기화를 구성하거나, 기존 작업 동기화를 (활성/비활성 상태 포함) 편집 또는 삭제할 수 있습니다.
기존 작업 동기화는 메뉴의 관련 옵션을 사용하여 편집하거나 삭제할 수 있습니다. 모든 변경 사항은 Strings와 TMS 간에 동기화됩니다. 작업 동기화를 삭제하면 TMS의 해당 APC가 제거됩니다.
페이지는 및 왼쪽 탐색 메뉴 모두에서 액세스할 수 있습니다.
참고
TMS에 필수 custom fields가 정의되어 있는 경우, Strings에서 작업 동기화를 설정할 수 없습니다.
기본 구성으로 Strings와 TMS 간에 새 작업 동기화를 설정하려면 Strings UI에서 다음 단계를 따르십시오:
-
페이지에서 통합 옆의 Configure를 선택하십시오.
페이지가 표시됩니다.
-
+ New Job Sync를 클릭하십시오.
창이 표시됩니다.
-
을 입력하고 드롭다운에서 TMS에 연결할 Strings 프로젝트를 선택하십시오.
동일한 언어 조합을 가진 프로젝트만 포함할 수 있습니다.
-
선택적으로 사용할 을 선택하십시오. 선택한 TMS 프로젝트 템플릿은 할당된 Strings 프로젝트에 정의된 언어 세트와 일치해야 합니다.
동기화된 작업은 선택한 템플릿에서 생성된 TMS 프로젝트에 추가됩니다.
-
을 선택하면 선택한 Strings 프로젝트를 기반으로 TMS 프로젝트 템플릿이 자동으로 생성됩니다.
-
-
TMS에서 생성할 프로젝트 을 선택하십시오.
-
연속 프로젝트로
기본 옵션입니다.
-
Strings 작업에서 변경 사항이 감지될 때마다 새로운 TMS 프로젝트가 생성됩니다.
-
-
섹션에서 TMS의 번역이 Strings로 다시 내보내지는 방식을 제어하기 위한 Strings 내보내기 설정을 지정하십시오.
-
Strings의 기존 대상 번역을 업데이트합니다.
-
Strings에서 작업을 자동으로 완료됨으로 표시합니다.
-
미확인으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings에서 자동으로 확인됩니다.
-
-
필요한 경우 Advanced options을 클릭하여 추가 내보내기 옵션을 표시하십시오.
-
번역이 다시 동기화되면 특정 로캘을 완료됨으로 표시합니다.
-
TMS의 새 키가 Strings에 생성되고 기존 키가 업데이트되도록 합니다.
-
내보내기 이후 Strings에서 원문이 변경된 경우 번역이 덮어쓰여지는 것을 방지합니다.
-
-
저장을 클릭합니다.
새 작업 동기화 구성이 비활성 상태로 목록에 추가됩니다. 열 아래의 토글을 사용하여 작업 동기화를 사용하도록 설정하십시오.
팁
더 고급 구성을 위해 Phrase TMS 설정을 사용하여 커넥터를 설정하십시오.
사용자 지정 매핑을 사용하는 경우에는 변경이 필요할 때마다 해당 변경을 TMS의 커넥터에 적용해야 합니다.
Phrase TMS에서 Strings 커넥터를 생성한다고 해서 자동 작업 가져오기/내보내기를 위한 APC가 자동으로 생성되지는 않습니다. APC는 TMS에서 별도로 구성해야 합니다.
일부 조직은 조직의 Phrase 플랫폼 ID를 사용하여 자동으로 생성된 Phrase Strings 커넥터를 이미 보유하고 있습니다. 수동으로 생성하기 전에 페이지에서 커넥터 목록을 확인하십시오. 자동 생성된 커넥터는 수동으로 입력한 액세스 토큰이 아닌 로그인된 ID를 사용하여 서버 측에서 인증합니다.
커넥터는 생성 후 초기 동기화를 완료하는 동안 상태를 표시한 다음 으로 변경됩니다. 상태는 커넥터 구성이 변경되거나 커넥터 설정 페이지가 저장될 때마다, 의미 있는 변경 사항이 없더라도 트리거됩니다. 커넥터가 상태인 동안에는 Phrase TMS에서 작업 생성을 위한 소스로 사용할 수 없습니다. 해당 커넥터로 작업을 생성하기 전에 상태가 로 변경될 때까지 기다리십시오.
-
설정
페이지에서 섹션으로 스크롤하십시오.
-
커넥터을 클릭합니다.
페이지가 열립니다.
-
새 커넥터를 클릭하십시오.
페이지가 열립니다.
-
Type을 로 변경하고 커넥터 이름을 입력하십시오.
-
Strings에서 얻은 계정 ID와 access token을 입력하십시오.
-
연결 테스트을 클릭합니다.
-
성공하면 버튼 옆에 작은 확인 표시가 나타납니다.
-
-
TMS로 가져올 항목을 선택하십시오.
대상 키를 가져오지 않은 경우, XLIFF 2.0 파일의 에서 Segment XLIFF를 선택하면 XLIFF 2.0 파일을 추가로 세분화할 수 있습니다.
-
필요에 따라 고급 가져오기 옵션을 활성화하거나 비활성화하십시오:
-
TMS 프로젝트의 소스 언어는 Strings 프로젝트의 기본 언어와 관계없이 적용됩니다.
-
이미 진행 중인 로케일에 대해 중복된 TMS 작업이 생성되지 않도록 하려면 이 옵션을 활성화하십시오. 활성화되면, 이미 활성 TMS 작업에 포함된 키에 대한 변경 사항은 원래 작업이 완료될 때까지 다시 가져오지 않습니다. 여러 언어가 포함된 작업에 대한 더 나은 제어 기능을 위해 권장됩니다.
-
-
이 옵션을 사용하면 HTML 개체가 Strings TMS 간에 전송하는 동안 CDATA에 포장되어 보존되도록 합니다.
-
이 옵션을 사용하면 ICU 구문과 인라인 HTML 요소를 결합한 컨텐츠 가져오기 수 있습니다.
-
-
-
-
내보내기 모드를 선택.
-
필요에 따라 다음 내보내기 옵션을 활성화하거나 비활성화하십시오:
-
기존 번역이 파일 콘텐츠로 업데이트되지 않도록 하려면 비활성화하십시오.
-
새 키 생성 및 기존 키 업데이트를 방지하려면 비활성화하십시오.
-
최신 소스 콘텐츠와 일치하지 않는 번역은 동기화 시 제외됩니다. 이는 소스 텍스트와 번역의 일관성을 유지하여 오래되었거나 잘못된 번역을 방지하는 데 도움이 됩니다.
-
으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings에서 자동으로 확인됩니다. 활성화되면 TMS에서 반환된 모든 번역은 텍스트가 편집되었는지 또는 변경되지 않았는지에 관계없이 Strings에서 으로 표시됩니다. 작업이 열려 있는 동안 Strings에서 소스 텍스트가 변경된 키만 제외되며 상태로 유지됩니다.
-
번역이 다시 동기화되면 특정 로캘이 완료됨으로 표시됩니다.
-
선택하면 마지막 로캘이 업로드될 때에만 작업이 완료됨으로 표시됩니다.
-
-
-
지정된 경우 기본 폴더를 선택하십시오 (저장 후에만 가능합니다).
-
이 제시되어 필요한 경우 사용자 지정할 수 있습니다. 커넥터 구성에서 각 Strings 로캘이 단일 TMS 로캘에 대한 하나의 매핑 항목만 갖도록 하십시오. 언어 매핑 변경 사항은 기존 작업에 영향을 미치지 않습니다.
목록은 한 번에 5개의 프로젝트를 페이지로 나누어 표시하며, 프로젝트는 알파벳순으로 정렬됩니다. 먼저 A-Z(대문자)순, 그 다음 a-z(소문자)순으로 정렬됩니다.
-
저장을 클릭합니다.
커넥터는 페이지의 목록에 추가됩니다.
커넥터 삭제
커넥터를 삭제하려면:
참고
커넥터가 프로젝트의 미완료 작업에 여전히 연결되어 있는 경우(휴지통에 있는 작업 포함) 삭제할 수 없습니다. 이러한 커넥터를 삭제하려고 하면 "커넥터 삭제 실패" 오류가 반환됩니다.
해결 방법: 커넥터와 연결된 프로젝트를 열고 남은 작업을 완료하거나 삭제하십시오. 으로 이동하여 비우십시오. 그러면 커넥터에 여전히 연결된 작업이 제거됩니다. 커넥터 삭제를 다시 시도하십시오.
통합 지원:
Strings에서 프로젝트 참조를 위해 TMS로 전송됨:
-
키 설명
Strings에서 전송되고 TMS CAT 편집기의 컨텍스트 메모 창에 컨텍스트 메모로 표시됩니다.
-
키 글자 최대 길이
Strings에서 전송되고 TMS CAT 편집기의 컨텍스트 메모 창 내에 표시됩니다.
-
스크린샷
TMS CAT 편집기의 창에 Strings의 스크린샷을 표시하려면:
-
TMS 프로젝트 설정의 액세스 및 보안 섹션에서 옵션을 활성화하십시오.
-
창에서 형식을 선택하십시오.
-
-
지원되는 파일 형식의 사용자 지정 메타데이터:
-
.XLSX
-
.CSV
-
.XLIFF 2.0
-
APC 통한 Strings 대상 업데이트를 모니터링하려면 다음 단계를 수행하십시오.
-
APC를 설정할 때, 선택합니다.
이렇게 하면 Strings 수행된 대상 업데이트를 위한 온라인 리포지토리 모니터링을 할 수 있습니다.
-
APC 설정의 섹션에서 선택한 원격 개체에서 수행된
Strings 대상 언어 컨텐츠 변경하면 APC 모니터링이 트리거될 때 Phrase TMS 번역 메모리 자동으로 저장됩니다.
Phrase TMS 편집자 대상 세그먼트를 수정하여 번역 메모리 업데이트를 덮어쓸 수 있습니다. Phrase TMS 작업 완료되면 이러한 업데이트는 Strings 다시 내보내집니다.
APC를 사용한 키 삭제 동작
Strings의 키가 작업에 포함된 후 삭제되어도 일회성 수동 가져오기를 통해 생성된 Phrase TMS 작업에는 영향을 주지 않습니다. 해당 작업은 수동으로 다시 가져오기 전까지 변경되지 않습니다.
APC 모니터링이 활성화되면 Phrase는 각 폴링 또는 웹후크 트리거 시 콘텐츠 해시를 비교하고, 키 삭제를 포함한 모든 변경 사항을 재동기화를 트리거하는 업데이트로 처리합니다.
-
모드에서 재동기화는 기존 Phrase TMS 프로젝트나 작업을 현재 Strings의 콘텐츠와 일치하도록 업데이트하므로, 삭제된 키의 콘텐츠는 해당 작업에서 제거됩니다.
-
모드에서 재동기화는 삭제 후 콘텐츠를 반영하는 새 Phrase TMS 작업 버전을 생성하며, 이전에 생성된 작업 버전은 변경되지 않습니다.
아래 표는 사용자가 Strings 통합 사용할 때 발생할 수 있는 일반적인 문제를 요약합니다. 가능한 원인 및 해결 방법을 제공합니다.
|
문제 |
원인 |
솔루션 |
|---|---|---|
|
경고 메시지 관련 |
키 이름에 원치 않는 글자가 포함되어 있습니다(예: 공백). |
사용자는 경고 메시지에도 불구하고 번역 컨텐츠 처리하고 Strings 다시 내보내기 수 있습니다. |
|
TMS 키가 비어 있습니다. |
작업에 소스 언어의 소스 텍스트가 없는 키가 포함되어 있습니다. |
중 하나:
|
|
APC는 프로젝트를 생성하거나 새 작업을 처리하지 않습니다. |
언어 코드 불일치 |
Strings 언어 코드가 TMS 프로젝트 언어 코드와 일치 항목 확인하십시오. APC 연속 프로젝트로 설정되면 프로젝트 생성 후 프로젝트 템플릿 변경된 내용은 기존 프로젝트에 적용되지 않습니다. 따라서 연속 프로젝트에 변경 사항을 직접 수행해야 합니다. |
|
APC는 작업/로캘이 처리된 것으로 간주합니다. |
작업을 시작한 후에 프로젝트 템플릿/APC 설정이 수정된 경우, APC 기록에서 처리된 것으로 간주될 수 있습니다. 따라서 다음 이터레이션에 적합하려면 작업 업데이트 합니다. 중 하나:
|
|
|
|
APC 개 수를 줄이고 모니터링 빈도를 낮추십시오. |
|
|
Strings 프로젝트의 기존 키가 TMS 작업에서 누락됨 |
특정 키가 Strings 작업에 추가되지 않음 |
Strings 작업에 키를 추가하고 TMS에서 온라인 저장소로부터 작업을 다시 가져오십시오. |
|
작업을 가져오거나 내보내려고 할 때 \"인증할 수 없음\" 오류가 나타납니다. |
자동 생성된 \"Phrase Strings에서 생성됨\" 커넥터의 액세스 토큰이 만료되었거나 취소됨 |
TMS에서 새 Phrase Strings 커넥터를 생성하고 기존 APC를 새 커넥터에 다시 연결한 후 모니터를 트리거하십시오. |
|
Strings 작업이 완료된 것으로 표시되지 않음에도 불구하고 APC 또는 수동으로 가져오거나 다시 가져올 작업을 찾을 수 없습니다. |
작업이 이미 TMS 프로젝트로 가져와졌으나, 이후 완료되거나 삭제되지 않은 상태로 휴지통으로 이동되었습니다. 프로젝트가 기술적으로 여전히 진행 중이므로 작업이 다시 가져오기용으로 해제되지 않습니다. |
추가 문제 해결을 진행하기 전에 Strings의 로캘 옆에 있는 을 확인하여 해당 작업이 이미 TMS로 가져와졌는지 확인하십시오. 연결된 프로젝트가 휴지통에 있는 경우, 프로젝트를 복원하여 직접 작업을 계속하거나, 프로젝트가 필요하지 않은 경우 작업 및 프로젝트를 취소하거나, |
|
TMS 커넥터에 사용자 지정 로캘 매핑이 구성되어 있음에도 불구하고 " |
작업 동기화는 저장 시점에 Strings 프로젝트의 대상 로캘을 TMS에서 기본적으로 지원하는 로캘 목록과 직접 대조하여 유효성을 검사합니다. 이 유효성 검사는 사용자 지정 커넥터 로캘 매핑을 고려하지 않습니다. |
TMS에서 기본적으로 지원하지 않는 대상 로캘이 있는 Strings 프로젝트의 경우, Strings에서 사용하는 대신 TMS에서 직접 Strings 커넥터를 사용하고 사용자 지정 로캘 매핑을 구성하십시오. |
|
작업이 TMS에서 전달됨 상태로 표시됨에도 불구하고 번역이 Strings로 다시 내보내기 되지 않습니다. |
프로젝트 또는 템플릿에는 모든 작업이 전달된 후가 아니라 모든 작업이 사전 번역되면 프로젝트(및 해당 작업)를 완료됨/전달됨으로 표시하는 프로젝트 상태 자동화 설정이 있습니다. 이로 인해 내보내기 단계가 Strings로 실행되지 않은 상태에서 작업이 전달됨 상태로 강제 전환되므로 자동화 서비스가 내보내기를 예약하지 않고 번역이 Strings로 전송되지 않습니다. |
프로젝트 템플릿의 프로젝트 상태 자동화 설정에서, 프로젝트 상태를 설정할 때 을 선택하고, 대신 가 아닌 것으로 설정하십시오. 수동으로 생성된 작업의 경우, 수동 내보내기는 작업 상태를 자동으로 업데이트하지 않으므로 작업을 Strings로 수동 내보내기하고 작업 상태를 전달됨으로 수동 변경하십시오. 프로젝트의 모든 작업이 전달됨으로 설정되면 프로젝트는 자동으로 완료됨로 표시됩니다. |