CPQ 필드, 시스템 필드 및 파트너 필드

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

    • 에CPQ 있는 CPQ세 가지 유형의 필드에 대해 알아봅니다. 각 유형이 구성에서 데이터를 저장, 검색 및 표시하는 방법과 원활한 데이터 통합을 위해 Salesforce 및 파트너 시스템과 상호작용하는 방법을 이해합니다.

    환경에는 필드, 시스템 필드 및 파트너 필드의 세 CPQ 가지 범주의 필드 CPQ 가 있습니다.

    CPQ 필드

    CPQ 필드는 환경에 따라 사용자 지정된 사용자 정의 필드입니다.CPQ 해당 유형은 번호, 텍스트, 선택 목록, 세트 또는 제품 선택기일 수 있습니다. 사용자가 CPQ에서 필드를 만들 때 필드 정의에 기본값을 수동으로 할당하거나 결정 작업을 통해 값을 설정할 수 있습니다.

    다음 예는 사용자가 구성/재구성 시 보강에서 필드를 CPQ 설정하는 방법을 보여줍니다.

    cfgRequest.testField.set("value", "Hello World");

    필드에 CPQ 대한 자세한 설명은 다음 문서를 참조하십시오 필드 구성.

    주:
    시작점 CPQ으로 Salesforce를 사용하지 않는 조직에서는 API 호출에서 모든 필드를 초기화해야 합니다.

    시스템 필드

    시스템 필드

    시스템 필드가 미리 정의되어 있습니다. 시스템 필드는 SFDC 제품 캐시(또는 현재 날짜 및 시간)를 활용하여 값을 생성하므로 기본값을 할당할 수 없습니다.

    다음 예는 사용자가 구성/재구성 시 보강에서 시스템 필드를 호출하는 방법을 보여줍니다.

    let pC = {"input2":cfgRequest.sys.productCode.value};

    시스템 필드는 모든 레이아웃에 직접 추가할 수 있습니다. 미리 정의된 데이터가 포함되어 있는지 여부에 관계없이 표시하는 데 문제가 없습니다.

    레이아웃 편집기에서 다음을 수행합니다.

    레이아웃 편집기

    구성기 UI에서 다음을 수행합니다.

    레이아웃 편집기 화면

    이 예에서는 SFDC에 측정 단위가 정의되어 있지 않기 때문에 비어 있습니다.

    이러한 각 시스템 필드를 해당 SFDC 객체에 매핑하는 방법은 다음과 같습니다. 필드 API 이름은 괄호 안에 있습니다.

    • sys.productUOM > 제품: 수량 측정 단위(QuantityUnitOfMeasure)
    • sys.productName > 제품: 제품 이름(이름)
    • sys.productFamily > 제품: 제품군(제품군)
    • sys.productDescription > 제품: 제품 설명(설명)
    • sys.productCode > 제품: 제품 코드(ProductCode)
    • sys.enableValidation: 값은 기본적으로 예로 설정됩니다.
    • sys.currentDate: 단순 시간 API 호출, UTC 날짜 반환
    • sys.actionContext > 견적 라인: 작업 컨텍스트(LGK ActionContext c)
    • sys.productPrice > 가격 장부 항목: 목록 가격(UnitPrice)
    • sys.productId: 값은 관리자 설정에 따라 다릅니다.

      sys.productId는 환경 설정에 CPQ 정의된 대로 변경됩니다. 예를 들어 제품 ID 필드가 제품 코드로 설정된 경우 결과 데이터는 제품 코드가 되어 sys.productCode 필드와 동일합니다.

    제품 코드

    제품 ID 필드가 파트너 ID로 대신 설정된 경우 SFDC 필드에서 데이터를 끌어옵니다. 제품 2 ID(필드 API 이름으로의 ID):

    시스템 필드 화면

    파트너 필드

    파트너 필드

    파트너 필드는 POST 호출을 사용하여 API를 통해 구성을 초기화하는 필드입니다. 파트너 필드는 파트너의 데이터 세트를 활용하여 필드 값을 생성합니다.

    이러한 각 파트너 필드를 해당 SFDC 객체에 매핑하는 방법은 다음과 같습니다. 필드 API 이름은 괄호 안에 있습니다.

    • 견적 > 기록 ID(ID) partner.quote.id
    • partner.quote.lineId 견적 라인 > 기록 ID(ID)
    • partner.quote.pricebookId 견적 > Pricebook ID(SBQQPricebookIdc)
    • partner.quote.currencyIsoCode 견적 > CurrencyIsoCode

      partner.quote.currencyIsoCode는 Salesforce 조직에서 복수 통화를 활성화하지 않은 경우 기본값은 USD입니다. 복수 통화를 사용하려면 이 Salesforce 문서의 단계를 따르십시오 . 복수 통화 활성화.

    이러한 필드를 사용할 때 제품이 처음 구성될 때 일부 데이터에 값(null)이 없을 수 있다는 점에 유의해야 합니다. 초기화 오류가 없는지 확인하려면 파트너 필드를 활용하는 규칙이나 스크립트에 null 검사를 포함합니다.

    이러한 필드는 시스템 필드처럼 레이아웃에 직접 추가할 수 없습니다. 대신 필드를 사용하여 CPQ 초기화 보강을 통해 파트너 필드의 데이터를 채울 수 있습니다.

    다음 초기화 보강 예시는 파트너 필드의 값을 구성기에 채웁니다.

    let quoteId = cfgRequest.partner.quote.id.value;
let lineID = cfgRequest.partner.quote.lineId.value;
let currencyISO = cfgRequest.partner.quote.currencyIsoCode.value;
let priceBookID = cfgRequest.partner.quote.pricebookId.value;

if (quoteId != null) {
	cfgRequest.quoteIDTest.set("value", quoteId);
}
if (lineID != null) {
	cfgRequest.lineIDTest.set("value", lineID);
}
if (currencyISO != null) {
	cfgRequest.currencyISOCodeTest.set("value", currencyISO);
}
if (priceBookID != null) {
	cfgRequest.pricebookIDTest.set("value", priceBookID);
}
return cfgRequest;

    초기 구성:

    초기 구성 화면.

    재구성:

    파트너 필드

    이제 라인 ID가 채워집니다.

    파트너 및 시스템 필드를 사용하는 방법은 사용자에게 달려 있습니다. 일부 조직에서는 구성기의 최종 사용자에게 이 정보를 표시하는 것이 유용하다고 생각하는 반면, 다른 조직에서는 규칙의 백그라운드에서 이 정보를 사용하여 가격 조건을 구동합니다.