관리
    1. Phrase
    2. 글로벌
    3. 관리

    Phrase Strings 커넥터 (Job Sync)

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

    Phrase Strings 통합(Strings 인터페이스에서 Job Sync라고 함)은 Phrase TMS와 Phrase Strings를 연결합니다. 이 통합은 작업 수준 및 프로젝트 수준 동기화를 모두 지원합니다.

    필수 조건

    • TMS 및 Strings 애플리케이션 모두 액세스 필요

    • TMS 프로젝트에 사용된 언어 코드는 Strings 작업의 로캘 코드와 일치해야 합니다.

    • Strings 프로젝트의 기본 언어는 TMS 프로젝트에 정의된 소스 언어와 동일해야 합니다.

    중요 사항

    Figma 파일은 Strings에서 전체 라이브 파일로 표시될 수 있지만 TMS에서는 지원되지 않습니다. TMS CAT Editor는 특정 Figma 프레임의 번역된 콘텐츠만 SVG 형식으로 표시할 수 있습니다.

    Strings 키<1> 번역 상태는 지원되지 않습니다. TMS로 가져오기 전에 Strings에서 확인되지 않음으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings에서 확인됨으로 반환될 수 있습니다.

    다음의 경우 Strings 작업을 가져온 후 TMS에서 생성된 세그먼트의 수는 원래 키 수와 다를 수 있습니다.

    • 키는 Strings에서 제외됨으로 표시됩니다. 제외된 키를 가져올 수 없습니다.

    • TMS에서 작업을 생성할 때 XLIFF 2.0의 파일 가져오기 설정에서 세그먼트 XLIFF 옵션이 활성화되었습니다. 이러한 경우에는 Strings 키 수보다 세그먼트 수가 더 많을 수 있습니다.

    Strings 키는 HTML 개체를 포함할 수 있습니다. TMS에서 커넥터를 설정할 때 CDATA에 HTML 컨텐츠 포함 옵션을 활성화하여 TMS에서 해당 문자를 표시하는 대신 HTML 개체를 유지합니다.

    Strings 키의 소스 텍스트에 있는 선행 및 후행 공백은 TMS CAT Editor에 표시되지 않습니다. 이러한 공백은 스켈레톤에 보존되며 작업이 Strings로 다시 동기화될 때 소스 및 대상 모두에 다시 삽입됩니다. 이는 Strings에서 구성된 글자 수 제한 유효성 검사에 영향을 줄 수 있습니다. 번역 중에 TMS 편집자에서 공백 수가 반영되지 않기 때문입니다.

    커넥터 사용하여 여러 프로젝트와 파일을 APC 모니터링할 수 있습니다. 각 프로젝트 하나의 APC 내에서 개별 모니터링이 필요합니다.

    커넥터는 작업 로캘 주석을 사용하여 해당 Phrase TMS 프로젝트에 대한 메타데이터를 Strings 작업 및 작업 로캘에 첨부합니다. 작업 로캘 주석을 나열하기 위한 Phrase Strings API 엔드포인트가 이 메타데이터를 검색합니다. 작업 대상 로캘을 나열하기 위한 엔드포인트에도 include_annotations 매개변수가 true로 설정된 경우 이 메타데이터가 포함됩니다. 주석이 달린 작업에는 tms_project_id 및 tms_in_progress와 같은 필드가 포함되어 있어, 연결된 Phrase TMS 프로젝트에서 Strings 작업의 상태를 추적할 수 있습니다.

    ICU 메시지 및 CLDR 복수형

    번역을 위해 ICU 메시지나 복수 형태가 있는 Strings 작업을 TMS로 보낼 때 XLIFF 2.0 파일 가져오기 설정 또는 TMS 프로젝트 템플릿에서 ICU 메시지 구문 분석 옵션을 활성화합니다.

    사용 사례

    커넥터 여러 사용 사례가 있습니다.

    • TMS 프로젝트 관리자는 온라인 리포지토리 TMS 프로젝트에 직접 파일을 추가 수 있습니다.

    • 제출자가 Phrase TMS 제출자 포털을 통해 Phrase Strings에서 직접 요청에 파일을 추가할 수 있도록 설정합니다.

    • 모니터링되는 파일 또는 폴더에 대해 마지막으로 수정된 날짜에서 변경이 감지되면 TMS 자동 프로젝트 생성(APC)을 사용하여 새 프로젝트를 자동으로 생성하십시오.

      • 작업 수준 및 프로젝트 수준 동기화 모두에 대해 모니터링되는 프로젝트 경로를 작업 폴더(예: space/project/main/jobs)까지 모두 선택해야 합니다.

      • Job Sync의 경우, 다음 작업 업데이트로 APC 트리거됩니다:

        • 새로 추가된 키 또는 기존 키 변경

        • Strings 수정된 작업 만기일

        참고

        작업 다시 열리는 것은 APC 업데이트 간주되지 않습니다.

      • 프로젝트 수준 동기화의 경우, APC는 다음으로 트리거됩니다:

        • 새로 추가된 키

        • 기존 키에 대한 변경 사항

      • APC 설정 시 매번 새 프로젝트 생성을 선택하면 원격 온라인 리포지토리는 소스뿐만 아니라 대상 업데이트를 위해 모니터링될 수 있습니다.

        대상 업데이트를 모니터링하도록 선택할 경우 온라인 리포지토리 대상 복사본을 변경하면 Phrase TMS 번역 메모리 자동으로 업데이트.

      • 원격 개체에서 수행된 대상 업데이트가 TM에 자동 저장으로 선택된 경우, Strings 대상 언어의 주요 텍스트 변경 사항이 관련 APC 프로젝트에서 사용되는 TMS 번역 메모리에 자동으로 업데이트됩니다.

    • TMS 커넥터 API는 UI를 통해 수동으로 수행되는 단계를 자동화하는 데 사용할 수 있습니다. 웹 후크는 특정 이벤트(예: 작업 상태 변경)에 대해 제3자 시스템에 알림을 보낼 수 있습니다.

    Job Syncs 페이지

    Job Syncs 페이지는 Phrase Strings 커넥터를 사용하는 모든 Job Sync 설정(APC)에 대한 중앙 집중식 보기를 제공합니다. 여기에는 Strings에서 직접 생성된 동기화와 TMS에서 구성된 동기화가 관련 정보와 함께 포함됩니다.

    Job Syncs 페이지에서 Strings의 관리자 및 프로젝트 관리자 사용자는 새 Job Sync 구성, 기존 Job Sync 편집(활성/비활성 상태 포함) 또는 삭제를 수행할 수 있습니다.

    기존 Job Sync는 More More Menu 메뉴의 관련 옵션을 사용하여 편집하거나 삭제할 수 있습니다. 모든 변경 사항은 Strings와 TMS 간에 동기화됩니다. Job Sync를 삭제하면 TMS의 해당 APC가 제거됩니다.

    Job Syncs 페이지는 Integrations 및 Jobs 왼쪽 탐색 메뉴 모두에서 액세스할 수 있습니다.

    Strings에서 Job Sync 구성

    참고

    TMS에 필수 사용자 지정 필드가 정의된 경우, Strings에서 Job Sync를 설정하는 것은 지원되지 않습니다.

    Strings와 TMS 간의 새로운 Job Sync를 기본 설정으로 설정하려면 Strings UI에서 다음 단계를 따르십시오.

    1. 통합<1> 페이지에서 Job Sync<3> 통합 옆의 설정<2>을 선택하십시오.

      Job Sync<1> 페이지가 표시됩니다.

    2. + 새 Job Sync<1>를 클릭하십시오.

      새 Job Sync 생성<1> 창이 표시됩니다.

    3. 동기화 이름<1>을 입력하고 할당된 Strings 프로젝트<2> 드롭다운에서 TMS에 연결할 Strings 프로젝트를 선택하십시오.

      언어 조합이 동일한 프로젝트만 포함할 수 있습니다.

    4. 선택적으로 사용할 TMS 프로젝트 템플릿<1>을 선택하십시오. 선택한 TMS 프로젝트 템플릿은 할당된 Strings 프로젝트에 정의된 언어 세트와 일치해야 합니다.

      동기화된 작업은 선택한 템플릿에서 생성된 TMS 프로젝트에 추가됩니다.

      • 기본값을 선택하면 선택한 Strings 프로젝트를 기반으로 TMS 프로젝트 템플릿이 자동으로 생성됩니다.

    5. TMS에서 생성할 프로젝트 유형<1>을 선택하십시오.

      • 연속 프로젝트

        기본 옵션입니다.

      • 신규 프로젝트

        Strings 작업에서 변경 사항이 감지될 때마다 새로운 TMS 프로젝트가 생성됩니다.

    6. Strings로 내보내기 섹션에서 TMS의 번역이 Strings로 다시 내보내지는 방식을 제어하기 위한 Strings 내보내기 설정을 지정하십시오.

      • 기존 번역을 덮어쓰기

        Strings의 기존 대상 번역을 업데이트합니다.

      • 작업을 완료됨으로 표시

        Strings에서 작업을 자동으로 완료됨으로 표시합니다.

      • Strings에서 변경되지 않은 번역 확인

        확인되지 않음<1>으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings에서 자동으로 확인됨으로 표시됩니다.

    7. 필요한 경우 고급 옵션<1>을 클릭하여 추가 내보내기 옵션을 표시하십시오.

      • 로캘을 완료됨으로 표시

        번역이 다시 동기화되면 특정 로캘을 완료된 것으로 표시합니다.

      • 새 키 생성 및 기존 키 업데이트

        TMS의 새 키가 Strings에 생성되고 기존 키가 업데이트되도록 합니다.

      • 소스가 저장된 버전과 일치하는 경우에만 번역을 적용

        내보내기 이후 Strings에서 소스 텍스트가 변경된 경우 번역이 덮어쓰여지는 것을 방지합니다.

    8. 저장을 클릭합니다.

      새 Job Sync 설정이 비활성 상태로 TMS Job Syncs 목록에 추가됩니다. Active 열 아래의 토글을 사용하여 Job Sync를 활성화합니다.

    팁

    더 고급 설정을 하려면 Phrase TMS 설정을 사용하여 커넥터를 설정하십시오.

    Phrase TMS 설정

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

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

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

    3. New connector를 클릭합니다.

      Create connector 페이지가 열립니다.

    4. Type을 Phrase Strings로 변경하고 커넥터 이름을 입력합니다.

    5. Strings에서 얻은 계정 ID와 액세스 토큰을 입력합니다.

    6. 연결 테스트을 클릭합니다.

      • 성공하면 Test connection 버튼 옆에 작은 확인 표시가 나타납니다.

    7. TMS로 가져올 항목을 선택합니다.

      대상 문자열을 가져오지 않은 경우, XLIFF 2.0 파일의 파일 가져오기 설정에서 Segment XLIFF를 선택하면 XLIFF 2.0 파일을 추가로 세분화할 수 있습니다.

      • 필요에 따라 고급 가져오기 옵션을 활성화하거나 사용 안 함으로 설정합니다:

        • TMS 프로젝트의 소스 언어를 가져올 때 적용

          TMS 프로젝트의 소스 언어는 Strings 프로젝트의 기본 언어와 관계없이 적용됩니다.

        • 각 언어별로 TMS 작업을 생성하십시오

          이미 진행 중인 로캘에 대해 중복된 TMS 작업을 생성하지 않으려면 이 옵션을 활성화하십시오. 여러 언어가 포함된 작업에 대한 더 나은 제어 기능을 위해 권장됩니다.

        • HTML 컨텐츠를 CDATA로 감싸기

          • 이 옵션을 사용하면 HTML 개체가 Strings TMS 간에 전송하는 동안 CDATA에 포장되어 보존되도록 합니다.

          • 이 옵션을 사용하면 ICU 구문과 인라인 HTML 요소를 결합한 컨텐츠 가져오기 수 있습니다.

    8. 내보내기 모드를 선택.

      • 필요에 따라 다음 내보내기 옵션을 활성화하거나 사용 안 함으로 설정합니다:

        • 번역 덮어쓰기

          파일 콘텐츠로 기존 번역이 업데이트되지 않게 하려면 사용 안 함으로 설정하십시오.

        • 새 키 생성 또는 키 업데이트

          새 키 생성 및 기존 키 업데이트를 방지하려면 사용 안 함으로 설정하십시오.

        • 소스와 일치하는 경우에만 번역 적용

          최신 소스 콘텐츠와 일치하지 않는 번역은 동기화 중에 제외됩니다. 이는 소스 텍스트와 번역 간의 일관성을 유지하여 오래되었거나 잘못된 번역을 방지하는 데 도움이 됩니다.

        • 번역 내용이 변경되지 않은 경우에만 확인

          확인되지 않음<1>으로 표시된 키는 대상 번역이 변경되지 않은 경우 Strings에서 자동으로 확인됨으로 표시됩니다.

        • 언어를 완료됨으로 표시

          번역이 다시 동기화되면 특정 로캘을 완료된 것으로 표시합니다.

        • 작업을 완료됨으로 표시

          선택하면 마지막 로캘이 업로드된 경우에만 작업이 완료됨으로 표시됩니다.

    9. 지정된 경우 기본 폴더를 선택하십시오(저장 후에만 가능).

    10. 언어 매핑이 제시되어 필요한 경우 사용자 지정할 수 있습니다. 언어 매핑 변경 사항은 기존 작업에 영향을 미치지 않습니다.

      목록은 한 번에 5개의 프로젝트를 페이지로 나누어 표시하며 프로젝트는 알파벳순으로 정렬됩니다. 먼저 A-Z(대문자) 순으로 정렬된 다음 a-z(소문자) 순으로 정렬됩니다.

    11. 저장을 클릭합니다.

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

    통합 지원:

    Strings에서 프로젝트 참조를 위해 TMS로 전송됨:

    • 키 설명

      Strings에서 전송되고 TMS CAT 편집기의 컨텍스트 메모 창에 컨텍스트 메모로 표시됩니다.

    • 키 글자 최대 길이

      Strings에서 전송되고 TMS CAT 편집기의 컨텍스트 메모 창 내에 표시됩니다.

    APC를 통한 Strings에서 대상 업데이트 모니터링

    APC 통한 Strings 대상 업데이트를 모니터링하려면 다음 단계를 수행하십시오.

    1. APC를 설정할 때, 매번 새 프로젝트 생성을 선택합니다.

      이렇게 하면 Strings 수행된 대상 업데이트를 위한 온라인 리포지토리 모니터링을 할 수 있습니다.

    2. APC 설정의 자동화 섹션에서 선택한 원격 개체에서 수행된 대상 업데이트는 TM에 자동으로 저장됩니다.

    Strings 대상 언어 컨텐츠 변경하면 APC 모니터링이 트리거될 때 Phrase TMS 번역 메모리 자동으로 저장됩니다.

    Phrase TMS 편집자 대상 세그먼트를 수정하여 번역 메모리 업데이트를 덮어쓸 수 있습니다. Phrase TMS 작업 완료되면 이러한 업데이트는 Strings 다시 내보내집니다.

    APC를 사용한 키 삭제 동작

    Strings에서 키를 작업에 포함한 후 삭제해도 일회성 수동 가져오기를 통해 생성된 Phrase TMS 작업에는 영향을 주지 않습니다. 해당 작업은 수동으로 다시 가져오기 전까지 변경되지 않은 상태로 유지됩니다.

    APC 모니터링이 활성 상태이면 Phrase는 각 폴링 또는 웹 후크 트리거에서 콘텐츠 해시를 비교하고 키 삭제를 포함한 모든 변경 사항을 재동기화를 트리거하는 업데이트로 처리합니다.

    • 연속 프로젝트로<1> 모드에서는 재동기화를 통해 기존 Phrase TMS 프로젝트 또는 작업을 Strings의 현재 콘텐츠와 일치하도록 업데이트하므로 삭제된 키의 콘텐츠가 해당 작업에서 제거됩니다.

    • 매번 새 프로젝트 생성<1> 모드에서는 재동기화를 통해 삭제 후 콘텐츠를 반영하는 새 Phrase TMS 작업 버전이 생성되며, 이전에 생성된 작업 버전은 변경되지 않습니다.

    작업 동기화 문제 해결

    아래 표는 사용자가 Strings 통합 사용할 때 발생할 수 있는 일반적인 문제를 요약합니다. 가능한 원인 및 해결 방법을 제공합니다.

    문제

    원인

    솔루션

    경고 메시지 관련 NMTOKEN TMS 작업

    키 이름에 원치 않는 글자가 포함되어 있습니다(예: 공백).

    사용자는 경고 메시지에도 불구하고 번역 컨텐츠 처리하고 Strings 다시 내보내기 수 있습니다.

    TMS 키가 비어 있습니다.

    작업에 소스 언어의 소스 텍스트가 없는 키가 포함되어 있습니다.

    중 하나:

    • 세그먼트 무시.

    • Strings 작업에서 키를 제거하고 온라인 리포지토리에서 소스를 다시 가져오십시오.

    APC는 프로젝트를 생성하거나 새 작업을 처리하지 않습니다.

    언어 코드 불일치

    Strings 언어 코드가 TMS 프로젝트 언어 코드와 일치 항목 확인하십시오.

    APC 연속 프로젝트로 설정되면 프로젝트 생성 후 프로젝트 템플릿 변경된 내용은 기존 프로젝트에 적용되지 않습니다. 따라서 연속 프로젝트에 변경 사항을 직접 수행해야 합니다.

    APC는 작업/로캘이 처리된 것으로 간주합니다.

    작업을 시작한 후에 프로젝트 템플릿/APC 설정이 수정된 경우, APC 기록에서 처리된 것으로 간주될 수 있습니다. 따라서 다음 이터레이션에 적합하려면 작업 업데이트 합니다.

    중 하나:

    • 작업 새 키 추가 작업 기존 키 업데이트.

    • Strings 작업 만기일 변경

    429 요청이 많음 오류(Strings API 제한)

    APC 개 수를 줄이고 모니터링 빈도를 낮추십시오.

    Strings 프로젝트의 기존 키가 TMS 작업에서 누락됨

    특정 키가 Strings 작업에 추가되지 않았습니다.

    Strings 작업에 키를 추가하고 TMS에서 온라인 리포지토리로부터 작업을 다시 가져오십시오.

    작업을 가져오거나 내보내려고 할 때 \"인증할 수 없음\" 오류가 나타납니다.

    "created by Phrase Strings" 커넥터의 액세스 토큰이 만료되었거나 취소되었습니다.

    TMS에서 새 Phrase Strings 커넥터를 생성하고 기존 APC를 새 커넥터에 다시 연결한 다음 모니터를 트리거하십시오.

    완료된 Phrase TMS 작업이 번역을 Phrase Strings로 다시 동기화하지 않습니다. Phrase TMS는 작업이 완료되었다고 보고하지만, Phrase Strings의 영향을 받는 로케일은 여전히 단어가 번역되지 않음으로 표시됩니다.

    완료된 작업의 번역이 영향을 받는 로케일에 대해 Phrase Strings로 올바르게 동기화되지 않았습니다.

    Strings에서 작업을 다시 열고 영향을 받는 로케일을 미완료로 표시하십시오. TMS에서 작업을 선택하고 Reimport from online repository를 클릭하십시오. TMS에서 영향을 받는 로케일의 내보내기를 다시 트리거하십시오.
    도움이 되었습니까?
    ★ ★ ★ ★ ★

    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.