환경에서 환경으로 Blueprint 마이그레이션

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 일관된 구성 관리를 보장하기 위해 환경 간에 CPQ Blueprint를 마이그레이션합니다. 테스트된 구성을 개발에서 프로덕션으로 승격하려면 매트릭스 로더를 사용하여 Blueprint 패키지를 안전하게 익스포트, 업데이트 및 임포트합니다.

    시작하기 전에

    에 설명된 업그레이드 시기를 이해합니다CPQ.CPQ 업그레이드 일정 게시된 업그레이드 기간을 피하도록 마이그레이션 일정을 예약합니다. 이 주제와 관련하여 질문이 있는 경우 고객 성공 관리자에게 문의하십시오.

    이 작업에는 다음 용어가 사용됩니다.

    소스
    기능이 마이그레이션되는 환경입니다.
    대상
    기능이 마이그레이션되는 환경입니다.
    마이그레이션 패키지
    대상 환경으로 임포트할 원본 환경에서 익스포트한 파일입니다.

    이 작업은 마이그레이션이 한 번에 하나 이상의 Blueprint에서 수행되는 것으로 가정합니다.

    필요한 역할: (알 수 없음)

    프로시저

    1. 소스에서 Blueprint를 익스포트합니다.
      1. 소스 환경에서 이름 옆에 있는 확인란을 클릭하여 이동할 Blueprint를 선택합니다.블레프린트
      2. 익스포트를 클릭합니다.Blueprint 익스포트
        왼쪽 아래 모서리에 있는 종 모양 아이콘에서 알림을 확인합니다. 첫 번째 알림은 익스포트 프로세스가 시작되었음을 나타냅니다. 익스포트가 완료되면 Blueprint를 다운로드할 준비가 되었음을 나타내는 두 번째 알림이 나타납니다.
      3. Blueprint를 다운로드하려면 종 모양 아이콘 메뉴에서 다운로드 링크를 클릭합니다.Blueprint 다운로드
      4. Blueprint를 로컬 컴퓨터 또는 중앙 리포지토리(예: Git)에 저장합니다.
      5. 환경이 Salesforce와 통합되어 있고 Blueprint를 처음 마이그레이션하는 경우 필수 구성 요소를 확인하고 에서 1 Blueprint를 SFDC 통합 대상으로 마이그레이션단계를 수행합니다.
    2. 마이그레이션 패키지를 수정합니다.
      1. 1단계에서 다운로드한 Blueprint ZIP 파일의 압축을 풉니다.
        파일의 압축이 blueprint.yaml 파일로 풀립니다.

        blueprint.yaml 파일 선택

      2. 텍스트 편집기에서 blueprint.yaml 파일을 엽니다.

        이전 버전의 Blueprint가 있는 대상으로 Blueprint를 마이그레이션할 때는 파일 맨 아래에 다음 줄을 추가하는 것이 좋습니다.

        fullBlueprintMigration: true

        샘플 편집된 blueprint.yaml 파일:

        ---
blueprints:
- variableName: someBlueprint
  related Fields:
  - field1
  - field2
  - field3
  lastModifiedBy: dev5@dev.logik.io
  name: someBlueprintName
  description: BP description goes here
  relatedSets: null
  scripts: null
  layouts: null
  products: null
productPickers: /fields/productPickers.yaml
sets: null
fieldOptions: /fields/fieldOptions.csv
rules: /rules/rules.csv
fields: /fields/fields.csv
fullBlueprintMigration: true

        이 매개변수가 Blueprint 마이그레이션에 미치는 영향에 대한 설명은 다음 문서를 참조하십시오 fullBlueprintMigration 매개변수.

      3. 환경이 Salesforce와 통합되어 있고 Blueprint를 처음 마이그레이션하는 경우 다음에서 2 Blueprint를 SFDC 통합 대상으로 마이그레이션단계를 수행합니다.
      4. 편집 내용을 저장하고 blueprint.yaml 파일을 닫습니다.
    3. 마이그레이션 패키지의 모든 구성요소(blueprint.yaml, blueprints 폴더, fields 폴더, rules 폴더 및 마이그레이션 패키지에는 있을 수 있지만 상위 폴더는 아닌 기타 아티팩트 포함)를 새 ZIP 파일로 압축합니다.Blueprint 다운로드
      중요사항:
      압축할 때 상위 폴더 자체가 아닌 압축을 푼 Blueprint 익스포트의 내용만 선택해야 합니다. 상위 폴더를 선택하면 관리자에게 CPQ 업로드할 때 오류가 발생합니다.

      임포트 로그

    4. 마이그레이션하려는 Blueprint와 관련된 구성요소(예: Blueprint에서 사용하는 관리 테이블 및 외부 연결)를 프로덕션 테넌트로 마이그레이션합니다.
    5. Blueprint를 대상으로 임포트합니다.
      1. 대상 환경의 관리 영역에 로그인합니다.CPQ
      2. 매트릭스 로더를 엽니다.
      3. 편집된 마이그레이션 패키지 ZIP 파일을 매트릭스 로더 놓기 영역으로 끌어다 놓습니다.
      4. 다음을 클릭한 후 임포트를 클릭합니다.
      임포트 후 오류가 발생하면 화면의 지시에 따라 오류 로그를 검토합니다.
    6. 마이그레이션을 테스트합니다.
      1. 환경이 Salesforce와 통합되어 있고 Blueprint를 처음 마이그레이션하는 경우 에서 Blueprint를 SFDC 통합 대상으로 마이그레이션3단계와 4단계를 수행합니다.
      2. 대상 CPQ 환경의 최종 사용자 UI에서 마이그레이션된 Blueprint를 검토합니다.