Salesforce 트랜잭션 관리자 통합 패키지 확장 설치

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 12분
  • Salesforce에서 트랜잭션 관리자를 사용하려면 먼저 다음 단계에 따라 Salesforce 트랜잭션 관리자 통합 패키지 확장을 설치하고 구성해야 합니다.

    필수 구성요소

    이 가이드에서는 사용자 CPQ 환경이 Salesforce 조직과 통합되어 있고 트랜잭션 관리자가 활성화되어 있다고 가정합니다. Salesforce 조직에 패키지가 설치되어 있지 않으면 CPQ 관리 패키지 버전 2.7 이상을 설치합니다 CPQ . 지침은 Salesforce 조직에 연결된 환경에 대한 설치 및 설정 가이드 문서를 참조하십시오.

    주:
    CPQ 트랜잭션 관리자가 Salesforce CPQ에 대한 종속성이 없습니다. Salesforce CPQ와 관련된 단계 또는 참조는 무시할 수 있습니다.

    사용자 CPQ 환경에서 트랜잭션 관리자를 켜도록 요청하는 지원 티켓을 제출합니다.

    Transaction Manager 확장 정보 CPQ

    CPQ 트랜잭션 관리자 확장은 Salesforce 관리자가 Salesforce CPQ 환경과 트랜잭션 관리자 간의 통합을 용이하게 하기 위해 설치하는 구성요소 패키지입니다.

    최신 버전 및 설치를 위해 관리 패키지에 액세스하는 방법에 대한 자세한 내용은 ServiceNow 고객 지원에 문의하십시오.

    관리자는 관리자용, 모든 사용자 또는 특정 프로파일용으로 패키지를 설치할 수 있습니다. 이 패키지에는 개인에게 할당하거나 프로필에 복제할 수 있는 Transaction Manager에 대한 권한 집합이 포함되어 있습니다. 권한 세트를 보려면 설정에서 사용자로 이동한 다음 권한 세트에서 Logik.ai 모든 액세스 옵션을 확인합니다.

    패키지가 설치되면 Salesforce 설정의 설치된 패키지 섹션에서 패키지 버전을 볼 수 있습니다.

    Salesforce 설정 → 설치된 패키지

    Salesforce: 사용자 지정 주소 필드 사용

    Salesforce 환경에서는 사용자 지정 주소 필드가 활성화되어 있어야 합니다. 이 기능이 활성화되지 않은 경우 자세한 내용은 다음 문서를 참조하십시오. 사용자 지정 주소 필드 활성화

    Salesforce: 다음에 대한 보안 예외 허용 CPQ

    신뢰할 수 있는 URL을 추가합니다.

    1. Salesforce 설정 홈에서 다음으로 이동합니다. 설정 > 보안 > 신뢰할 수 있는 URL. 신뢰할 수 있는 새 URL을 생성합니다.
    2. API 이름을 입력합니다.
    3. 아래와 같이 환경의 URL을 CPQ 입력합니다.

      사용자 지정 주소 필드 활성화

    4. CSP 지침에서 최소한 frame-src(iframe 콘텐츠) 가 활성화되어 있는지 확인하고 저장을 클릭합니다.

      사용자 지정 주소 필드 활성화

    원격 사이트 설정을 구성합니다.

    1. Salesforce 설정 홈에서 다음으로 이동합니다. 설정 > 보안 > 원격 사이트 설정. 새 원격 사이트를 생성합니다.
    2. 이름을 제공합니다.
    3. 아래 이미지와 같이 환경의 CPQ URL을 입력하고 저장을 클릭합니다.

      원격 설정

    선택적으로 Cosmo Converse(현재 베타 버전)에 대한 마이크 액세스를 허용합니다. Cosmo Converse를 사용하면 사용자가 Transaction Manager와 음성을 통해 통신할 수 있습니다. 기본적으로 이 기능은 사용되지 않습니다. Cosmo Converse를 사용하려면 사용 사례를 설명하는 지원 티켓을 제출하십시오. Cosmo Converse를 준비하려면 마이크 액세스를 허용하도록 Salesforce 설정을 업데이트합니다.

    1. 설정 홈에서 다음으로 이동합니다. 설정 > 보안 > 세션 설정.
    2. Browser Feature Permissions(브라우저 기능 권한)에서 Include Permissions-Policy HTTP 헤더 확인란이 비활성화되어 있는지 확인합니다.
    3. 필요한 경우 저장을 클릭합니다.

    세션 설정

    CPQ: 런타임 클라이언트 토큰을 설정합니다.

    런타임 클라이언트 토큰을 CPQ 사용하면 Salesforce CPQ에서 로 통신할 때 쉽게 인증할 수 있습니다. 에서 런타임 클라이언트 토큰 CPQ을 생성하는 단계는 다음 문서를 참조하십시오 런타임 클라이언트 설정. 이 트랜잭션 관리자 사용 사례의 경우 트랜잭션에 대한 이 런타임 클라이언트의 권한을 활성화하고 해당 Salesforce 환경에서 인식할 수 있는 유효한 사용자 ID를 추가하십시오.

    Admin에서 CPQ 런타임 클라이언트 토큰은 해당 권한에 TRANSACTION을 포함하고 그 자체를 원본으로 포함하도록 업데이트되어야 합니다. (예를 들어 https://test-txn.test02.logik.io 에 대한 런타임 클라이언트 토큰의 원본은 https://test-txn.test02.logik.io 이어야 합니다.) 또한 런타임 클라이언트 토큰에 TRANSACTION이 포함되어 있으면 사용자가 포함되어야 합니다. 사용자에게 트랜잭션 생성 이벤트를 수행할 수 있는 권한이 있는지 확인합니다.

    런타임 클라이언트 편집

    런타임 클라이언트 토큰을 설정했으면 다음 절차에서 사용할 수 있도록 로컬 클립보드에 복사합니다.

    Salesforce에 CPQ 트랜잭션 런타임 토큰 설치

    1. Salesforce 앱 시작 관리자에서 Logik.io 관리자 사용자 지정 설정을 검색하여 엽니다.
    2. 런타임 클라이언트 토큰 필드 옆의 설정 버튼을 눌러 활성화합니다.
    3. CPQ 토큰을 편집 가능한 필드에 붙여넣고 저장을 클릭합니다.
    주:
    런타임 클라이언트 토큰은 저장된 후 관리자 사용자 지정 설정 페이지에 표시되지 않습니다.

    Salesforce: 트랜잭션 관리자를 열기로 기회 레이아웃 업데이트

    1. Salesforce에서 오른쪽 상단 모서리에 있는 기어 아이콘을 클릭합니다.
    2. 다음으로 이동 설정 > 객체 관리자 > 기회 > 페이지 레이아웃.
    3. 편집할 페이지 레이아웃을 선택합니다. (레이아웃이 여러 개인 경우 관련 기록 유형 또는 사용자 프로파일과 연결된 레이아웃을 선택합니다.)

      페이지 레이아웃 화면

    4. 관련 목록 섹션이 보일 때까지 레이아웃 편집기에서 아래로 스크롤합니다.

      페이지 레이아웃 화면

    5. 상단 팔레트의 사용 가능한 관련 목록에서 트랜잭션 객체를 관련 목록 섹션의 원하는 위치로 끌어옵니다.

      트랜잭션 화면

    6. 트랜잭션 객체의 렌치 아이콘을 클릭하여 관련 목록의 속성을 엽니다.

      관련 목록 속성

    7. 선택한 필드 섹션의 사용 가능한 필드 열에서 트랜잭션 편집 필드를 선택합니다. 추가를 클릭하여 선택한 필드 열로 이동합니다. 필요에 따라 필드를 재배열하고 확인 을 클릭하여 변경 내용을 저장합니다. 변경한 후 왼쪽 상단 모서리에 있는 저장을 클릭합니다.

      트랜잭션 화면

    8. 업데이트된 레이아웃을 테스트합니다.
      • 최종 사용자(Salesforce 구매측)로서 기회 기록으로 이동합니다.

      • 트랜잭션 관련 목록이 페이지에 나타나고 트랜잭션 편집 링크가 표시되고 작동하는지 확인합니다.

    문제 해결: 트랜잭션 버튼이 누락된 경우

    구매 측 기회 상세 페이지에서 거래 버튼이 누락된 경우 다음 단계를 따르십시오.

    1. 페이지의 오른쪽 상단 모서리에서 기어 아이콘을 클릭한 다음 페이지 편집을 클릭합니다. 기회 기록 페이지에 대한 Lightning 앱 작성기가 열립니다.

      페이지 편집 옵션

    2. 페이지의 관련 목록 구성요소를 선택합니다. 페이지 레이아웃 할당 섹션에서 현재 할당된 페이지 레이아웃의 이름을 찾습니다. (이미지에서 올바른 레이아웃은 "(미리 보기됨)"이라는 단어로 표시됩니다.)

      메뉴

    3. 미리 본 레이아웃을 클릭하고 "Salesforce: 트랜잭션 관리자를 열기 위해 기회 레이아웃 업데이트" 섹션(위)에서 4-7단계를 반복합니다. 그런 다음 구매 측에서 기회 기록으로 이동합니다. 관련 목록 섹션을 확인하여 트랜잭션 객체가 표시되는지 확인합니다. 화살표를 클릭하고 새 트랜잭션을 생성하여 트랜잭션 편집(EditLink__c) 필드를 사용할 수 있는지 확인합니다.

      문제 해결

      문제 해결

    Salesforce: 사용자 지정 필드 매핑 설정

    에서 새 CPQ 트랜잭션 기록이 시작 CPQ되면 Salesforce 트랜잭션 기록에서 필수 데이터를 전송하는 것이 도움이 될 수 있습니다. 이 섹션에서는 트랜잭션 생성 플로우 중에 Salesforce의 필드에서 의 필드 CPQ로 또는 그 반대의 필드로 정보를 복사("또는 "트윈")하는 필드 매핑을 설정합니다. 예를 들어, 관리자는 보유한 값을 LGK__OpportunityId__c 해당 CPQ 트랜잭션 필드에 txn.opportunity.id연결하는 것이 일반적입니다.

    1. Salesforce에서 설정으로 이동합니다.
    2. 빠른 찾기 창에서 사용자 지정 메타데이터 유형을 검색합니다.
    3. 검색 결과의 사용자 지정 코드에서 사용자 지정 메타데이터를 클릭합니다.

      홈페이지

    4. 기존 필드 매핑에 액세스하려면 사용자 지정 메타데이터 유형 목록에서 Logik.io 트랜잭션 필드 매핑 을 찾은 후 그 옆에 있는 기록 관리 링크를 클릭합니다.

      메타데이터 유형

    5. 새로 만들기를 클릭하고 필요한 상세 정보를 입력한 다음 저장을 클릭합니다.

      소스 필드:

      • 환경: 필드 값의 소스 선택:
        • Salesforce에서 시작된 필드에 대해 Salesforce 를 선택합니다.

        • 에서 시작된 CPQ필드에 대한 로직을 선택합니다.

      • 객체: 트랜잭션을 입력합니다.
      • 필드: 필드 이름을 지정합니다.
        • Salesforce 필드의 경우 __c 접미사(예: CustomField__c)를 포함합니다. 에서 정확한 필드 이름 검토 세일즈포스 > 설정 > 객체 관리자 > 트랜잭션 > 필드 그리고 관계.

          필드 관계

        • 필드의 경우 CPQtxn. 또는 txn.line과 같은 프리픽스를 포함하여 필드를 나타냅니다(예: txn. TotalAmount)를 사용합니다. 의 정확한 필드 변수 이름을 사용해야 합니다. 관리자 > 트랜잭션 > 관련된 필드.

          트랜잭션

      대상 필드:

      • 환경: 필드 값을 업데이트해야 하는 위치를 나타냅니다(Salesforce 또는 CPQ).
      • 필드: 동일한 형식으로 대상의 필드 이름을 입력합니다(예: __c 가 있는 Salesforce 필드 또는 CPQtxn. 프리픽스가 있는 필드).

        메타데이터 화면

    주:
    • 필드 매핑 기록은 참조로 포함됩니다. 이는 삭제할 수 없지만 소스 및 대상 상세 정보는 편집할 수 있습니다. 추가된 사용자 지정 필드 기록이 일치하는지 확인합니다.
    • 관리 패키지를 제거하는 경우 새 사용자 지정 필드에 대해 생성된 기록을 먼저 삭제해야 합니다.

    Salesforce: 거래 라인-영업 기회 라인 동기화 및 자산 플로우 활성화

    주:
    기본적으로 다음 플로우가 활성화됩니다.
    • Logik.ai 트랜잭션 복사
    • Logik.ai 트랜잭션 생성(기록 트리거)
    • Logik.ai 트랜잭션 생성(화면)
    1. Salesforce 설정 홈에서 "플로우"를 검색합니다. Click 프로세스 자동화 > 플로우.

    2. 다음을 검색합니다. 각각에 대해 3단계를 수행합니다.

      • Logik.io 기회 라인 동기화(업서트)
      • Logik.io 기회 라인 동기화(삭제)
      • Logik.io 기본 트랜잭션 변경
    3. 2단계에서 식별한 세 가지 플로우 각각에 대해 다음 옵션 중 하나를 활성화합니다.
      • 옵션 1: 드롭다운 메뉴 사용:
        • 플로우 이름 오른쪽의 화살표를 클릭합니다.

          상세 정보 목록

        • 상세 정보 및 버전 보기를 선택합니다.
        • 최신 버전의 플로우를 보려면 활성화를 클릭하십시오.

          플로우 버전

      • 옵션 2: 플로우 열기:
        • 플로우 이름을 클릭하여 플로우 작성기에서 엽니다.

          플로우 빌더

        • Flow Builder의 오른쪽 상단에 있는 활성화 를 클릭합니다.

          워크플로우

    모든 플로우가 활성 상태인지 확인합니다.

    주:
    기회 라인 동기화는 기본 트랜잭션 기회 필드에 할당된 트랜잭션에만 적용됩니다.

    최종 사용자 플로우: Salesforce에서 트랜잭션 시작 CPQ

    • Salesforce에서 트랜잭션 기록 만들기

      최종 사용자가 Salesforce에서 트랜잭션을 시작하는 CPQ 방법에는 여러 가지가 있습니다. 가장 일반적인 플로우는 기회 기록에서 시작됩니다.

      1. 기회 기록에서 트랜잭션 관련 목록의 화살표를 클릭한 다음 신규를 클릭합니다.

        영업 콘솔

      2. 기회 필드가 채워진 상태로 새 트랜잭션이 열립니다. 계정, 기본 연락처 및 선택적 필드를 입력합니다. 저장을 클릭합니다.

        새 거래

      3. 관리 패키지의 기록 트리거 플로우가 에서 새 트랜잭션을 생성합니다.CPQCPQ 트랜잭션 기록의 UUID가 Salesforce(LGK__TransactionUUID__c)에서 업데이트됩니다. 트랜잭션 ID가 즉시 표시되지 않으면 일반적으로 브라우저를 새로 고치면 예외가 수정됩니다.

        거래 상세 정보

        브라우저를 새로 고친 후에도 트랜잭션 ID 필드가 채워지지 않은 상태로 유지되면 아래 문제 해결 섹션을 참조하십시오.

    • 트랜잭션 편집

      Salesforce 트랜잭션(또는 트랜잭션 관련 목록)에서 트랜잭션 상세 페이지의 트랜잭션 편집 버튼 또는 트랜잭션 편집 필드를 통해 제공되는 링크를 사용하여 Transaction Manager를 시작할 수 있습니다. Salesforce 기록의 트랜잭션 ID 필드를 기반으로 트랜잭션이 CPQ 로드됩니다.

      트랜잭션 관리자가 iFrame에 로드되어 Salesforce의 현재 하위 탭을 대체합니다.

      주:
      Salesforce의 클래식 UI는 지원되지 않습니다.
    • 트랜잭션 복사

      사용자는 Salesforce 트랜잭션 기록에서 복제 버튼을 클릭하면 복사 이벤트를 호출 CPQ 하여 트랜잭션 관리자에서 트랜잭션 및 라인을 다시 만들 수 있습니다. 이 작업은 Salesforce의 헤더 기록에 있는 트랜잭션 ID를 기반으로 하며 트랜잭션 기록을 복제합니다.

      주:
      Salesforce에서 트랜잭션을 복제해도 연결된 라인 기록의 사본이 새 트랜잭션에 자동으로 작성되지는 않습니다. 라인을 새 트랜잭션에 복제하려면 트랜잭션 관리자에서 새(복제된) 트랜잭션 기록을 시작하고 Salesforce 동기화를 시작합니다.

    문제 해결: CPQ "ID가 'null'인 트랜잭션을 찾을 수 없습니다" 오류와 함께 시작할 수 없습니다.

    오류 메시지

    이 오류는 Salesforce의 API 호출을 통해 새 CPQ 트랜잭션 기록 생성이 시작되고 실패할 때 발생합니다. 이 실패는 일반적으로 다음 두 가지 이유 중 하나로 인해 발생합니다.

    • 트랜잭션 런타임 토큰이 잘못 설정되었거나 만료되었습니다. 위의 "CPQ: 런타임 클라이언트 토큰 설정" 섹션의 단계를 검토합니다.
    • Salesforce UI에서 트랜잭션 기록을 CPQ 생성하는 사용자에게 이를 수행할 수 있는 권한이 없습니다.

    권한 오류를 해결하려면 다음 단계를 수행합니다.

    1. 트랜잭션 관리에서 가상 사용자를 클릭합니다.
    2. 가상 사용자 목록에서 어떤 가상 사용자에게 DEFAULT로 레이블이 지정되었는지 확인합니다. 아래 스크린샷은 "영업 대리점"이 기본 가상 사용자임을 보여줍니다. 기본적으로 모든 새 사용자에게 이 가상 사용자가 할당됩니다.

      관련 목록 속성

    3. 각 가상 사용자 기록을 엽니다. 사용자 이름을 찾습니다. 디버깅 중인 사용자는 하나의 가상 사용자에서만 표시되어야 합니다. 적절한 가상 사용자를 찾으면 이 가상 사용자의 액세스를 관리하는 뷰를 기록해 둡니다. 이 예에서 사용자는 판매 대리점 가상 사용자에 나열된 사용자 이름 중 하나입니다. 이 가상 사용자의 액세스는 "판매" 뷰에서 관리됩니다.

      가상 사용자 화면

    4. 가상 사용자의 액세스를 관리하는 뷰를 엽니다. 이 예에서 뷰의 이름은 "sales"입니다. 보기를 열려면 트랜잭션 관리자 홈에서 CPQ 보기로 이동한 다음 관리 보기를 클릭하십시오.

      거래 상세 정보

    5. 세부 정보 보기 페이지에서 Access, Events, createTransaction을 차례로 검색합니다. 초기 단계에서는 트랜잭션 이벤트 생성(varname: createTransaction)을 활성으로 설정해야 합니다.

      판매 화면

    요약하자면, 지정된 사용자에 대해 관리자는 다음 테이블의 항목을 관리해야 합니다.

    문제 수정
    사용자 가상 사용자 할당

    트랜잭션 관리자에서 CPQ가상 사용자로 이동하여 가상 사용자 기록을 선택합니다.

    • 가상 사용자에 사용자를 추가하려면 + 사용자 연결을 클릭합니다.
    • 가상 사용자에서 사용자를 제거하려면 사용자 이름을 선택한 다음 선택한 항목 제거를 클릭합니다.
    가상 사용자 뷰 할당 트랜잭션 관리자에서 CPQ로 이동하여 뷰 기록을 선택한 다음 연결된 가상 사용자를 클릭합니다.
    뷰: 스테이지당 각 이벤트에 대한 액세스

    세분화된 액세스 관리(권장)를 수행하는 방법에 대한 자세한 내용은 의 이벤트 CSV 파일 섹션 트랜잭션 관리자: 뷰을 참조하십시오.

    보다 정확한 방법으로 액세스를 관리하려면 트랜잭션 관리자에서 CPQ 이벤트로 이동하여 트랜잭션 이벤트 생성 , 이벤트 액세스 편집을 차례로 클릭하고 이벤트 액세스를 활성으로 설정합니다. 기본적으로 이벤트는 모든 스테이지와 뷰에서 활성 상태입니다.