Payload 콘텐츠 아티팩트

공급자 시스템에 다시 저장할 때 필요한 구조를 유지하면서, 선택한 Payload 콘텐츠 관리 시스템 필드와 지원되는 Lexical 텍스트를 번역합니다.

Payload 페이지는 사람이 읽는 콘텐츠뿐 아니라 식별자, 관계, 업로드 항목, 편집기 구조로 이루어져 있습니다. 통합 기능은 먼저 현지화 대상 필드를 선택해 번역할 아티팩트를 구성합니다. 그런 다음 payload 핸들러가 아티팩트 안에서 지원되는 일반 값과 Lexical 텍스트를 번역합니다.

Payload 통합을 사용해 콘텐츠를 선택하고 다시 저장하세요. 필터링하지 않은 콘텐츠 관리 시스템 레코드를 직접 제출하면 공급자의 필드 선택 과정을 건너뛰므로, 애초에 번역 대상이 아닌 데이터까지 포함될 수 있습니다.

선택한 필드와 서식 있는 텍스트 #

선택한 필드로 구성한 아티팩트에는 제목과 Lexical 트리가 포함될 수 있습니다:

json
{
  "title": "Delivery options",
  "body": {
    "root": {
      "type": "root",
      "children": [
        {
          "type": "paragraph",
          "children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
        }
      ]
    }
  }
}

제목과 지원되는 텍스트 콘텐츠는 번역 대상입니다. Lexical 노드 유형, 서식 데이터, 지원되는 인라인 구조는 재구성의 기준이 됩니다. 링크 대상, 업로드 항목, 관계, 구조를 정의하는 블록 필드는 문자열을 포함한다고 해서 번역할 본문이 되는 것은 아닙니다. 다만 지원되는 블록 필드 안에서 선택한 현지화 대상 텍스트는 공급자 측 필터링을 거친 뒤에도 번역할 수 있습니다.

Lexical 내에서 지원되는 텍스트 구간은 서식과 인라인 구조를 유지합니다. 사용자 지정 노드는 지원되는 표현 방식에 맞는지 확인해야 합니다. Lexical 지원이 모든 편집기의 문서 트리를 지원한다는 뜻은 아닙니다.

원본과 대상의 대응 관계 #

원본과 대상의 필드 경로는 서로 대응하는 값을 식별합니다. 이전 원본 없이 기존 대상만 제공되면, 핸들러는 현재 대응하는 대상 값을 그대로 사용하고 빈 부분을 번역합니다. 기록상 첫 동기화라는 이유만으로 현지화된 기존 필드를 모두 덮어쓰지는 않습니다.

이전 원본이 있으면 변경된 원본 단위와 누락된 대상 값을 처리해야 합니다. 기존 콘텐츠 관리 시스템 문서는 일부만 번역되어 있을 수 있으므로, 문서가 있다는 것만으로 번역이 완료되었다고 볼 수는 없습니다. 재구성은 선택한 원본 아티팩트에서 시작해 지원되는 번역 값이나 유지된 값을 삽입하는 방식으로 진행됩니다. 원본 바이트를 보존하는 대신 JSON으로 직렬화합니다.

편집 후에는 서식 있는 텍스트의 대응 관계를 확인해야 합니다. 일부 단어가 그대로여도 단락 구조나 사용자 지정 노드가 바뀌면 대응 관계에 영향을 줄 수 있습니다. 아티팩트가 유효한지만 확인하지 말고, 최종 콘텐츠 관리 시스템 필드와 화면에 표시되는 콘텐츠도 확인하세요.

필드 선택부터 다시 저장하기까지 연결하기 #

Payload 통합은 스키마 선택, 로캘 읽기, 연결 설정, 다시 저장하기 기능을 제공합니다. Payload 콘텐츠 관리 시스템 패키지 문서는 플러그인이 내보내는 항목을 설명합니다. 선택한 필드가 올바른 문서와 로캘에 반영되도록 아티팩트 핸들러 전후에 이러한 공급자 측 처리 단계를 유지하세요.

다시 저장한 후에는 현지화된 콘텐츠 관리 시스템 문서를 열어 일반 필드와 서식 있는 텍스트를 모두 살펴보세요. 링크를 열어 보고, 삽입된 관계를 확인하고, 대상에 반영된 필드 범위를 원본에서 선택한 범위와 비교하세요. 아티팩트 재구성은 공급자 시스템에 대한 쓰기 권한을 부여하지 않으며, 콘텐츠를 게시할 준비가 되었는지도 판단하지 않습니다.