[Beta]{class="badge informative"}

UI에서 SAP Commerce 소스 연결 만들기

NOTE
SAP Commerce 원본이 Beta 버전입니다. 베타 레이블 소스를 사용하는 방법에 대한 자세한 내용은 소스 개요를 참조하십시오.

다음 자습서에서는 Adobe Experience Platform 사용자 인터페이스를 사용하여 SAP 구독 청구 연락처 및 고객 데이터를 가져오기 위해 SAP Commerce 소스 연결을 만드는 단계를 안내합니다.

시작하기 getting-started

이 자습서에서는 다음 Experience Platform 구성 요소를 이해하고 있어야 합니다.

이미 유효한 SAP Commerce 계정이 있는 경우 이 문서의 나머지 부분을 건너뛰고 데이터 흐름 구성에 대한 자습서로 진행할 수 있습니다.

필요한 자격 증명 수집 gather-credentials

SAP Commerce을(를) Experience Platform에 연결하려면 다음 연결 속성에 대한 값을 제공해야 합니다.

자격 증명
설명
클라이언트 ID
서비스 키의 clientId 값입니다.
클라이언트 암호
서비스 키의 clientSecret 값입니다.
토큰 엔드포인트
서비스 키의 url 값은 https://subscriptionbilling.authentication.eu10.hana.ondemand.com과(와) 비슷합니다.
지역
데이터 센터 위치. 영역이 url에 있으며 eu10 또는 us10과(와) 유사한 값을 갖습니다. 예를 들어 url이(가) https://eu10.revenue.cloud.sap/api이면 eu10이(가) 필요합니다.

자세한 내용은 SAP Commerce 설명서를 참조하세요.

플랫폼 스키마 만들기 create-platform-schema

SAP Commerce 소스 연결을 만들기 전에 먼저 소스에 사용할 Experience Platform 스키마를 만들어야 합니다. 스키마를 만드는 방법에 대한 포괄적인 단계를 보려면 플랫폼 스키마 만들기에 대한 자습서를 참조하십시오.

다음 섹션을 확장하여 예제 스키마를 봅니다.

스키마 보기 예
code language-none
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}

SAP Commerce 계정 연결 connect-account

Platform UI의 왼쪽 탐색 막대에서 소스 ​를 선택하여 소스 작업 영역에 액세스합니다. 카탈로그 화면에 계정을 만들 수 있는 다양한 소스가 표시됩니다.

화면 왼쪽에 있는 카탈로그에서 적절한 카테고리를 선택할 수 있습니다. 또는 검색 옵션을 사용하여 작업할 특정 소스를 찾을 수 있습니다.

eCommerce 범주에서 SAP Commerce ​을 선택한 다음 데이터 추가 ​를 선택합니다.

SAP Commerce 카드가 있는 카탈로그용 플랫폼 UI 스크린샷

SAP Commerce 계정 연결 페이지가 나타납니다. 이 페이지에서 새 자격 증명 또는 기존 자격 증명을 사용할 수 있습니다.

기존 계정 existing-account

기존 계정을 사용하려면 새 데이터 흐름을 만들 SAP Commerce 계정을 선택한 다음 다음 ​을 선택하여 계속합니다.

SAP Commerce 계정을 기존 계정과 연결하는 플랫폼 UI 스크린샷

새 계정 new-account

새 계정을 만드는 경우 새 계정 ​을(를) 선택한 다음 이름, 설명(선택 사항) 및 자격 증명을 제공합니다. 완료되면 소스에 연결 ​을 선택한 다음 새 연결을 설정할 수 있는 시간을 허용하세요.

SAP Commerce 계정을 새 계정과 연결하는 플랫폼 UI 스크린샷

데이터 선택 select-data

마지막으로 플랫폼으로 수집할 객체 유형을 선택해야 합니다.

오브젝트 유형
설명
Customers
구독이 있는 엔티티입니다.
Contacts
고객에 대한 연락처 세부 정보.
고객

고객 데이터를 수집하려면 개체 유형으로 고객 ​을 선택한 후 다음 ​을 선택하십시오.

고객 옵션이 선택된 구성을 보여주는 SAP Commerce용 플랫폼 UI 스크린샷

연락처

연락처 데이터를 수집하려면 연락처 ​를 개체 유형으로 선택한 다음 다음 ​을 선택합니다.

연락처 옵션이 선택된 구성을 보여주는 SAP Commerce용 플랫폼 UI 스크린샷

다음 단계 next-steps

이 자습서에 따라 SAP Commerce 계정에 대한 연결을 설정했습니다. 이제 다음 자습서를 계속 진행하고 데이터를 플랫폼으로 가져오도록 데이터 흐름을 구성할 수 있습니다.

추가 리소스 additional-resources

아래 섹션에서는 SAP Commerce 소스를 사용할 때 참조할 수 있는 추가 리소스를 제공합니다.

매핑 mapping

Platform은 선택한 대상 스키마 또는 데이터 세트를 기반으로 자동 매핑된 필드에 대한 지능형 권장 사항을 제공합니다. 사용 사례에 맞게 매핑 규칙을 수동으로 조정할 수 있습니다. 필요에 따라 필드를 직접 매핑하도록 선택하거나 데이터 준비 함수를 사용하여 소스 데이터를 변환하여 계산된 값 또는 계산된 값을 파생할 수 있습니다. 매퍼 인터페이스 및 계산된 필드 사용에 대한 포괄적인 단계는 데이터 준비 UI 안내서를 참조하십시오.

데이터 흐름에 대한 매핑 구성은 스키마 및 수집하도록 선택한 개체 유형에 따라 다릅니다.

고객

고객 데이터의 경우 SAP Commerce은(는) SAP Business Partners API의 고객고객 연락처 관계 끝점을 사용하여 데이터를 검색합니다

다음은 고객 데이터에 대한 SAP Commerce 데이터 흐름에 대한 매핑 구성의 예입니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2
대상 필드 설명
customerNumber 고객 번호.
corporateInfo 고객 번호.
customerType 고객 유형.
createdAt 고객을 만든 시기를 나타내는 타임스탬프입니다.
changedAt 고객이 마지막으로 업데이트된 시기를 나타내는 타임스탬프입니다.
markets[*].country 고객은 어레이 개체로 검색됩니다.
addresses[*].email 고객의 여러 주소와 연결된 이메일이며 배열 개체로 검색됩니다.
addresses[*].city 고객의 여러 주소와 연결된 도시가 배열 개체로 검색됩니다.
addresses[*].addressUUID 고객의 여러 주소와 연결된 ID로, 배열 개체로 검색됩니다.
externalObjectReferences[*].externalSystemId 배열 개체로 검색된 추가 데이터입니다.
externalObjectReferences[*].externalId 배열 개체로 검색된 추가 데이터입니다.
customReferences[*].id 배열 개체로 검색된 추가 데이터입니다.
customReferences[*].typeCode 배열 개체로 검색된 추가 데이터입니다.

원본 워크플로의 매핑 단계입니다.

연락처

연락처 데이터의 경우 SAP Commerce은(는) SAP Business Partners API의 연락처 끝점을 사용하여 데이터를 검색합니다.

다음은 연락처 데이터에 대한 SAP Commerce 데이터 흐름에 대한 매핑 구성의 예입니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
대상 필드 설명
contactNumber 연락처 전화번호.
createdAt 연락처가 만들어진 시기를 나타내는 타임스탬프입니다.
changedAt 연락처가 마지막으로 업데이트된 시기를 나타내는 타임스탬프입니다.
personalInfo.lastName 연락처의 성입니다.
personalInfo.firstName 연락처의 이름.
externalObjectReferences[*].externalSystemId 배열 개체로 검색된 추가 데이터입니다.
externalObjectReferences[*].externalId 배열 개체로 검색된 추가 데이터입니다.
externalObjectReferences[*].externalIdTypeCode 배열 개체로 검색된 추가 데이터입니다.

원본 워크플로의 매핑 단계입니다.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089