BAM(일괄 마이그레이션 도구)을 사용하여 구독을 새 상거래 환경으로 마이그레이션

아티클
10/23/2023

BAM(일괄 마이그레이션 도구)을 사용하여 많은 수의 구독을 새 NCE(상거래 환경)로 효율적으로 마이그레이션할 수 있습니다.

(.NET SDK 버전 3.0.1에서 마이그레이션 API를 사용하여 구독 일괄 처리를 마이그레이션할 수도 있습니다).

Important

2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. 유용한 정보가 포함된 추가 정보 파일과 함께 GitHub에서 SDK 릴리스를 다운로드할 수 있습니다.

파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

BAM 도구:

고품질의 반복 가능하고 사용자 지정 가능한 일괄 처리 마이그레이션을 지원합니다.
Excel을 사용하여 마이그레이션 편집 관리
코드가 필요 없음
GitHub의 샘플 코드를 사용하여 다운로드할 수 있습니다.

일괄 마이그레이션 도구 기능

BAM 도구를 사용하여 다음을 수행할 수 있습니다.

테넌트에 대한 모든 고객 목록을 검색합니다.
.csv 파일에서 고객 레거시 구독을 검색합니다.
마이그레이션을 위해 내보내는 .csv 파일을 준비하고 마이그레이션 중에 구독(예: 사용자 수, 용어 및 청구 주기 변경)을 편집합니다.
업데이트된 구독 .csv 파일을 도구에 업로드한 후 도구에서 마이그레이션 요청을 실행합니다.
마이그레이션 요청의 상태 검토합니다.
입력 파일의 모든 고객 목록에 대한 모든 NCE 구독을 다운로드합니다.

필수 조건

BAM 도구를 사용하려면 .NET 6.0 SDK가 필요합니다.

SDK 및 샘플 코드

SDK 릴리스와 관련된 세부 정보 및 리소스 및 BAM 도구에 액세스하는 데 사용할 수 있는 샘플 앱 코드는 다음과 같습니다.

BAM 도구 사용

참고 항목

자세한 지침은 일괄 처리 마이그레이션의 단계별 흐름을 참조하세요.

일괄 마이그레이션에 대한 워크플로 옵션을 로드하려면 다음 단계를 사용합니다.

BAM 도구를 실행하고 명령 프롬프트에서 ncebulkmigration [앱 ID] {UPN ID]를 입력합니다.

이 단계에서 수행할 수 있는 작업은 다음과 같습니다.

고객 목록을 내보냅니다.
마이그레이션 자격이 있는 레거시 구독을 내보냅니다.
마이그레이션할 구독을 업로드합니다.
마이그레이션을 위해 이미 업로드된 일괄 처리의 마이그레이션 상태 내보냅니다.
새 상거래 환경 구독 목록을 내보냅니다.

계정 인증

BAM 도구는 다중 테넌트 앱에 대해 구성되지 않습니다. 인증을 완료할 때 단일 테넌트 구성으로 앱의 AppID를 사용합니다.

Microsoft는 다중 테넌트 애플리케이션에 일괄 마이그레이션을 사용하도록 설정하는 옵션을 평가하고 있습니다.

고객 목록 내보내기

고객 목록을 내보내려면 다음 단계를 사용합니다.

BAM 도구를 실행하고 명령 1을 입력합니다.

내보낸 고객 목록은 BAM 도구 폴더의 출력 파일에 저장됩니다.

customers.csv 파일 에서 내보낸 고객을 봅니다.

파트너 테넌트 ID 아래의 각 고객에 대해 다음을 볼 수 있습니다.

고객 테넌트 ID
고객은 그렇게 합니다기본
고객 회사 이름

선택한 고객에 대한 액세스 구독

다음 파일 다운로드에서 내보내지 않으려는 구독을 다운로드한 customers.csv 파일에서 고객의 행을 제거할 수 있습니다. 파일에 다시 기본 고객은 BAM 도구의 작업 흐름에서 다음 단계에서 마이그레이션 자격에 대한 유효성을 검사합니다.

지정된 고객에 대한 구독을 받는 다음 단계를 실행할 수 있도록 업데이트된 customers.csv 파일을 입력 폴더에 저장합니다.
- 입력 폴더에는 마이그레이션 및 구독의 두 개의 중첩된 폴더가 있습니다.
- 중첩된 폴더에 customers.csv를 배치하지 마세요. 입력 폴더에 보관합니다.

마이그레이션 자격이 있는 구독을 내보내려면 다음 단계를 사용합니다.

BAM 도구를 실행하고 명령 2를 입력합니다.

도구가 실행되고 구독이 자격에 대한 유효성을 검사하고 있음을 나타냅니다. 내보내기가 완료되면 지정된 고객에 대한 구독 목록을 subscriptions.csv로 출력 폴더에서 사용할 수 있습니다. 이 목록은 이전에 지정한 고객에 대한 모든 레거시 구독(활성 및 일시 중단됨) 목록을 제공합니다.

각 구독에 대해 다음 필드를 볼 수 있습니다.

파트너 테넌트 ID
간접 재판매인 PartnerID
고객 이름
고객 테넌트 ID
레거시 구독 ID
레거시 구독 이름
레거시 제품 이름
만료 날짜
마이그레이션 적격(True 또는 False)
현재 용어
현재 청구 계획
현재 좌석 수
새 용어 시작(NCE에서 마이그레이션 후)
용어(NCE에서 마이그레이션 후)
청구 계획(NCE에서 마이그레이션 후)
좌석 수(NCE에서 마이그레이션 후)
추가 기능(True 또는 False)
기본 구독(추가 기능인 경우)
마이그레이션 부적격성 이유(구독이 마이그레이션에 적합하지 않은 경우)

마이그레이션할 구독 및 방법 결정

이전 필드를 사용하여 내보낸 구독 목록을 필터링하여 일괄적으로 NCE로 마이그레이션할 구독을 결정할 수 있습니다. 예를 들어 특정 제품 유형의 구독 일괄 처리 또는 특정 간접 재판매인의 구독 일괄 처리를 마이그레이션하도록 필터링할 수 있습니다.

구독을 필터링하고 선택한 후에는 .csv 파일에서 일괄 처리에 대해 선택되지 않은 구독을 삭제합니다. 이렇게 하면 의도하지 않은 마이그레이션이 방지됩니다.

일괄 처리당 200개 이하의 구독을 내보내는 것이 좋습니다. (참조) 더 많은 구독을 마이그레이션해야 하는 경우 이 문서의 뒷부분에 있는 200개 이상의 구독을 마이그레이션합니다.)

다음 단계는 구독을 마이그레이션하는 방법을 지정하는 것입니다(예: 유사 항목 또는 업데이트된 시작 새 용어, 청구 빈도, 기간 또는 사용자 수 특성 포함).

마이그레이션하려는 구독의 행에서 다음 필드를 덮어쓸 수 있습니다.

새 용어 시작
기간
청구 계획
좌석 수

이전 필드는 NCE 구독이 마이그레이션 후 준수할 지침 또는 특성을 나타냅니다. 이러한 필드의 기본값은 마이그레이션 중인 레거시 구독의 값입니다. 필드를 변경하지 않으면 해당 NCE 구독의 값은 마이그레이션된 레거시 구독과 동일합니다. 예를 들어 마이그레이션 중인 레거시 구독의 현재 좌석 수가 2개이고 사용자 수 필드가 변경되지 않은 경우 마이그레이션 후 NCE 구독의 사용자 수는 2입니다.

NCE에서 새 용어로 구독을 시작하려면 다음 단계를 사용합니다.

새 용어 시작 플래그를 FALSE에서 TRUE로 변경합니다.

다음 열 외부에서 값을 변경하지 마세요.
- 새 용어 시작
- 기간
- 청구 계획
- 좌석 수

마이그레이션을 위한 일괄 처리 업로드

일괄 처리 마이그레이션 방법을 지정한 후(즉, 마이그레이션에 대한 구독을 필터링하고 원하는 경우 NCE 값을 업데이트한 후) 업데이트된 subscriptions.csv 파일을 입력 폴더에 중첩된 구독 폴더에 저장합니다. 구독 폴더에 저장된 각 파일은 마이그레이션할 일괄 처리를 나타냅니다.

마이그레이션을 위해 구독 폴더의 파일이 처리된 후 BAM 도구는 해당 파일을 중첩된 처리된 폴더로 이동하여 해당 일괄 처리에 대한 마이그레이션 요청이 실행되었음을 나타냅니다. 수동으로 파일을 처리된 폴더로 이동할 필요가 없습니다. 처리된 폴더의 파일은 이미 처리되었으므로 BAM 도구에서 마이그레이션을 실행하기 위해 읽지 않습니다.

마이그레이션을 업로드하려면 다음 단계를 사용합니다.

명령 프롬프트에서 BAM 도구를 실행하고 옵션 3을 선택하고 마이그레이션을 업로드한 후 다음을 수행합니다.
- BAM 도구는 구독 폴더에서 일괄 처리 파일을 읽고 마이그레이션 요청을 실행합니다.
- 콘솔 창은 마이그레이션 요청이 처리되고 있음을 나타냅니다.
  
  마이그레이션 ID를 포함하는 각 일괄 처리에 대한 파일이 내보내지고 출력 폴더에 중첩된 마이그레이션 폴더에서 사용할 수 있습니다.
  - 내보낸 파일의 레이블은 [batchID].csv입니다.
  - [batchID].csv에는 입력 subscriptions.csv 파일과 동일한 필드가 있지만 Batch ID 및 마이그레이션 ID라는 두 개의 열이 더 있습니다.
  - 일괄 처리 ID 는 파일의 모든 구독에 대해 동일하며, 이는 이러한 구독이 함께 처리된 동일한 일괄 처리 또는 마이그레이션 요청 집합에 속함을 나타냅니다.
  - Batch ID는 .csv 파일의 이름인 [batchID].csv에도 반영됩니다.

마이그레이션 상태 확인

마이그레이션에 성공하면 마이그레이션 상태 완료됩니다.

마이그레이션에 실패한 경우 마이그레이션 상태 실패하고 실패 이유를 확인할 수 있습니다.

마이그레이션 ID는 마이그레이션되는 각 구독에 고유하므로 마이그레이션 ID를 사용하여 마이그레이션 상태 추적할 수 있습니다.

마이그레이션에 성공하면 NCE 구독 ID 도 채워집니다.

일괄 처리에 대해 새로 고친 상태 파일을 검색하려면 다음 단계를 사용합니다.

내보낸 [batchID].csv 파일(출력에 중첩된 마이그레이션 폴더로 내보내기)을 마이그레이션 폴더(입력 폴더에 중첩됨)에 복사하거나 저장합니다.

이렇게 하면 도구에서 요청된 일괄 처리의 상태 읽고 내보낼 보고서를 준비할 수 있습니다.

상태 파일은 자동으로 업데이트되지 않습니다. 업데이트된 상태 검색하려면 매번 새 요청을 수행해야 합니다.

업데이트된 마이그레이션 상태 검색하려면 다음 단계를 사용합니다.

BAM 도구를 실행하고 명령 4를 입력합니다.

BAM 도구가 실행되고 마이그레이션 상태 조회 중이며 파일이 마이그레이션상태 폴더로 내보내졌는지를 나타냅니다. 내보낸 마이그레이션 상태 파일의 이름은 CSV에 포함된 구독의 일괄 처리 ID를 나타냅니다.

마이그레이션으로 내보낸 [batchID].csv 파일상태 폴더는 처리된 마이그레이션 요청에 대해 업데이트된 상태 제공합니다. 파일에 둘 이상의 일괄 처리가 표시되는 경우 Batch ID 열을 사용하여 필터링하여 특정 일괄 처리의 요청 상태 액세스합니다.

새 상거래 환경 구독 목록 내보내기

NCE 구독을 내보내려면 다음 단계를 사용합니다.

BAM 도구를 실행하고 명령 5를 입력합니다.

내보낸 목록은 출력 폴더에 저장됩니다. 이 단계는 마이그레이션에 필요하지 않지만 이를 사용하여 다른 고객에 대한 NCE 구독을 구성할 수 있습니다.

200개 이상의 구독 마이그레이션

최대 권장 일괄 처리 크기인 200개 이상의 구독을 마이그레이션하려는 경우 BAM 도구에 여러 일괄 처리를 업로드할 수 있습니다. 다양한 필드별로 폴더를 구성하여 마이그레이션할 업로드할 파일의 크기를 줄일 수 있습니다. 예를 들어 다음을 통해 마이그레이션할 구독을 구성할 수 있습니다.

간접 재판매인
제품 이름
구독 이름
기타 조건

구성한 일괄 처리 파일이 최대 권장 크기인 200개 구독을 초과하는 경우 구독을 새 파일에 효과적으로 복사하여 하나의 .csv를 여러 개의 구독으로 구분하여 각 일괄 처리의 최대 구독 200개를 기본 수 있습니다. 예를 들어 425개의 구독을 마이그레이션하려는 경우 세 개의 개별 파일(200개의 구독을 포함하는 두 개의 파일과 25개가 있는 다른 파일)로 분할할 수 있습니다.

여러 파일 업로드

BAM 도구에 여러 파일을 한 번에 업로드할 수 있습니다. 이 도구는 마이그레이션에서 한 번에 하나의 일괄 처리 파일을 요청하고 입력 디렉터리에 저장된 다른 일괄 처리 파일에서 자동으로 읽기 시작합니다(여러 일괄 처리가 추가된 경우).

BAM 도구는 일괄 처리를 하나씩 읽고 각 구독에서 마이그레이션 만들기 API를 개별적으로 호출합니다.

입력 디렉터리에 일괄 처리 파일을 더 추가하기 위해 하나의 일괄 처리 파일이 실행을 완료할 때까지 기다릴 필요가 없습니다.

속도 제한 및 제한

BAM 도구는 명령 2(고객에 대한 구독 검색 및 마이그레이션에 대한 구독 유효성 검사)를 실행하기 위해 마이그레이션 유효성 검사 API를 호출합니다. 마이그레이션 유효성 검사 API의 속도 제한은 파트너당 450개 호출 + 고객 조합(5분)입니다. 이 속도 제한 및 마이그레이션 유효성 검사 API의 현재 대기 시간으로 BAM 도구를 실행할 때 제한이 발생할 것으로 예상하지 않습니다. 또한 도구에는 제한이 발생하지 않도록 하는 동시성 제한이 있습니다.

그러나 문제가 발생하는 경우 어떤 고객의 구독이 끌어오고 유효성을 검사하지 않았는지 추적할 수 있습니다. 고객의 구독을 끌어올 수 없거나 구독의 유효성을 검사하는 동안 문제가 있는 경우 도구의 출력 폴더에 failedCustomers.csv라는 별도의 .csv가 나타납니다. 해당 고객에 대한 구독을 다시 끌어와 유효성 검사를 다시 시도할 수 있습니다.