バッチ移行ツール (BAM) を使用してサブスクリプションを新しいコマース エクスペリエンスに移行する

適切な役割: 管理エージェント ・ 販売エージェント

バッチ移行ツール (BAM) を使用して、多数のサブスクリプションを新しいコマース エクスペリエンス (NCE) に効率的に移行できます。

( .NET SDK バージョン 3.0.1 の移行 API を使用して、サブスクリプションのバッチを移行することもできます)。

BAM ツール:

• 高品質で反復可能でカスタマイズ可能なバッチ移行をサポートします。
• Excel を使用して移行の編集を管理する
• コードは必要ありません
• GitHub のサンプル コードを使用してダウンロードできます。

Batch 移行ツールの機能

BAM ツールを使用すると、次のことができます。

• テナントのすべての顧客の一覧を取得します。

• .csv ファイルで顧客のレガシ サブスクリプションを取得します。

• 移行のためにエクスポート.csvファイルを準備し、移行中にサブスクリプション (シート数、期間、支払いサイクルの変更など) を編集します。

• 更新されたサブスクリプション .csv ファイルをツールにアップロードし、その後、ツールが移行要求を実行します。

• 移行要求の状態を確認する。

• 入力ファイル内のすべての顧客リストのすべての NCE サブスクリプションをダウンロードします。

前提条件

BAM ツールを使用するには、.NET 6.0 SDK が必要です。

SDK とサンプル コード

SDK リリースに関する詳細とリソース、および BAM ツールへのアクセスに使用できるサンプル アプリ コードについては、次のようにします。

• SDK のバージョンをダウンロードする
• GitHub からサンプル コードにアクセスする

BAM ツールを使用する

バッチ移行のワークフロー オプションを読み込むには、次の手順を使用します。

• BAM ツールを実行し、コマンド プロンプトで「ncebulkmigration [app ID] {UPN ID]」と入力します。

この段階では、パートナーは次のことができます。

• 顧客の一覧をエクスポートします。
• 移行の資格を持つレガシ サブスクリプションをエクスポートします。
• 移行するサブスクリプションをアップロードする。
• 移行用に既にアップロードされているバッチの移行状態をエクスポートします。
• 新しいコマース エクスペリエンス サブスクリプションの一覧をエクスポートします。

アカウント認証

BAM ツールはマルチテナント アプリ用に構成されていません。 認証を完了する場合は、シングル テナント構成のアプリの AppID を使用します。

Microsoft では、マルチテナント アプリケーションのバッチ移行を有効にするためのオプションを評価しています。

顧客の一覧をエクスポートする

顧客の一覧をエクスポートするには、次の手順を使用します。

• BAM ツールを実行し、コマンド 1 を入力します。

エクスポートされた顧客の一覧は、BAM ツールのフォルダーの出力ファイルに保存されます。

エクスポートされた顧客をファイル customers.csv で確認できます。

パートナー テナント ID の下の顧客ごとに、次の情報を表示できます。

• 顧客テナント ID
• 顧客ドメイン
• 顧客の会社名

一部の顧客のサブスクリプションにアクセスする

ダウンロードしたcustomers.csvファイルから、次のファイルダウンロードでエクスポートしないサブスクリプションを持つ顧客の行を削除できます。 ファイルに残っているお客様は、BAM ツールのワークフローの次の手順で移行の資格が検証されます。

• 指定した顧客のサブスクリプションを受け取る次の手順を実行できるように、更新 されたcustomers.csv ファイル を入力 フォルダーに保存します。
  • input フォルダーには、migrations と subscriptions という入れ子になった 2 つのフォルダーがあります。
  • 入れ子になったフォルダーにcustomers.csvを配置しないでください。 入力フォルダーに保存します。

移行の資格を持つサブスクリプションをエクスポートするには、次の手順に従います。

• BAM ツールを実行し、コマンド 2 と入力します。

  ツールが実行され、サブスクリプションが適格性の検証中であることを示します。 エクスポートが完了すると、指定した顧客のサブスクリプションの一覧が出力フォルダーにsubscriptions.csvとして表示されます。このフォルダーには、以前に指定した顧客のすべてのレガシ サブスクリプション (アクティブと中断の両方) の一覧が表示されます。

サブスクリプションごとに次のフィールドを確認できます。

• パートナー テナント ID

• vIndirect Reseller PartnerID*

• 顧客名

• 顧客テナント ID

• レガシ サブスクリプション ID

• 従来のサブスクリプション名

• 従来の製品名

• 有効期限

• 移行対象 (True または False)

• 現在の用語

• 現在の課金プラン

• 現在のシート数

• 新しい期間の開始 (NCE での移行後)

• 用語 (NCE での移行後)

• 課金プラン (NCE での移行後)

• シート数 (NCE での移行後)

• アドオン (True または False)

• ベース サブスクリプション (アドオンの場合)

• 移行の不適格性の理由 (サブスクリプションが移行の対象ではない場合)

移行するサブスクリプションを決定する

上記のフィールドを使用すると、エクスポートしたサブスクリプションの一覧をフィルター処理して、バッチで NCE に移行するサブスクリプションを決定できます。 たとえば、製品の種類や特定の間接リセラーに基づいて移行バッチをフィルター処理できます。

パートナーは、移行したくない .csv バッチからサブスクリプションを削除できます。

バッチあたり 200 個以下のサブスクリプションをエクスポートすることをお勧めします。 (「 さらに移行する必要がある場合は 、この記事の後半で 200 を超えるサブスクリプションを移行します)。

次の手順では、サブスクリプションの移行方法を指定します。 パートナーは、移行に適用するプロパティを決定します。

移行するサブスクリプションの行の次のフィールドを上書きできます。

• Start New Term (新しい期間の開始)

• 用語

• Billing Plan (課金プラン)

• シート数

上記のフィールドは、NCE サブスクリプションが移行後に準拠する手順または属性を表します。 これらのフィールドの既定値は、移行するレガシ サブスクリプションの値です。 フィールドに変更を加えなければ、対応する NCE サブスクリプションの値は、移行元のレガシ サブスクリプションと同じになります。 たとえば、移行中のレガシ サブスクリプションの現在のシート数が 2 で、[Seat Count]\(シート数\) フィールドに変更が加えされていない場合、NCE サブスクリプションのシート数は移行後に 2 になります。

NCE で新しい用語でサブスクリプションを開始するには、次の手順に従います。

• [Start New Term]\(新しい用語の開始\) フラグを FALSE から TRUE に変更します。

  次の列の外部で値を変更しないでください。

  • Start New Term (新しい期間の開始)
  • 用語
  • Billing Plan (課金プラン)
  • Seat Count (シート数)

移行用のバッチをアップロードする

更新されたsubscriptions.csv ファイルを、入力フォルダーに入れ子になったサブスクリプション フォルダーに保存します。 subscriptions フォルダーに保存された各ファイルが、1 つの移行バッチを表します。

サブスクリプション フォルダーのファイルが処理され、移行のために実行されると、BAM ツールはそのファイルを入れ子になった処理されたフォルダーに移動します。 processed フォルダーにファイルを手動で移動する必要はありません。 BAM ツールは、既に処理されているため、 処理された フォルダー内のファイルを無視します。

移行をアップロードするには、次の手順に従います。

• コマンド プロンプトで BAM ツールを実行し、オプション 3 を選択して移行をアップロードします。その後、次の手順を実行します。

  • BAM ツールは、サブスクリプション フォルダーからバッチ ファイルを読み取り、移行要求を実行します。

  • コンソール ウィンドウは、移行要求が処理されていることを示します。

    移行 ID を含む各バッチのファイルがエクスポートされ、出力フォルダーに 入れ子になった移行 フォルダーで 使用 できます。

    • エクスポートされたファイルには [バッチ ID].csv というラベルが付けられます。
    • [バッチ ID].csv には入力 subscriptions.csv ファイルと同じフィールドがありますが、その他に Batch ID (バッチ ID) と Migration ID (移行 ID) という 2 つの列があります。
    • Batch ID (バッチ ID) は、ファイル内のすべてのサブスクリプションで同じです。これは、これらのサブスクリプションが、一緒に処理された同じバッチまたは移行要求のセットに属していることを示します。
    • バッチ ID は、.csv ファイルの名前 [batchID].csvにも反映されます。

移行の状態を確認する

移行が成功した場合、移行の状態は [完了] になります。

移行が失敗した場合、移行の状態は Failed (失敗) になり、失敗の理由を確認できます。

Migration ID (移行 ID) は移行される各サブスクリプションに固有であるため、Migration ID (移行 ID) を使用して移行の状態を追跡できます。

移行が成功すると、NCE の Subscription ID (サブスクリプション ID) も設定されます。

バッチの更新された状態ファイルを取得するには、次の手順を使用します。

• エクスポートした [batchID].csvファイルを output/migrations フォルダーから input/migrations フォルダーにコピーまたは保存します。

  これにより、ツールは要求されたバッチの状態を読み取り、エクスポートするレポートを準備できます。

状態ファイルは、自動的には更新されません。 更新された状態を取得するには、毎回新しい要求を行う必要があります。

更新された移行状態を取得するには、次の手順に従います。

• BAM ツールを実行し、コマンド 4 を入力します。

  BAM ツールが実行され、移行の状態が参照され、状態が migrationstatus フォルダーにエクスポートされていることを示します。 エクスポートされた移行状態ファイルの名前は、.csv ファイルに含まれるサブスクリプションのバッチ ID を表します。

[batchID].csv migrationstatus フォルダーにエクスポートされたファイルは、処理された移行要求の更新された状態を提供します。 ファイルに複数のバッチが表示されている場合は、Batch ID (バッチ ID) 列を使用してフィルター処理し、特定のバッチ内の要求の状態にアクセスします。

新しいコマース エクスペリエンス サブスクリプションの一覧をエクスポートする

NCE サブスクリプションをエクスポートするには、次の手順に従います。

• BAM ツールを実行し、コマンド 5 を入力します。

  エクスポートされた一覧は output フォルダーに保存されます。 この手順は移行には必要ありませんが、これを使用してさまざまな顧客の NCE サブスクリプションを整理できます。

200 を超えるサブスクリプションを移行する

200 を超えるサブスクリプション (推奨される最大バッチ サイズ) を移行する場合は、BAM ツールに複数のバッチをアップロードできます。 さまざまなフィールドでフォルダーを整理して、移行するアップロードするファイルのサイズを小さくできます。

• 間接リセラー
• 製品名
• サブスクリプション名
• その他の条件

200 サブスクリプションの最大推奨サイズを超えるバッチ ファイルは、個別の.csv ファイルに分割できます。

複数のファイルをアップロードする

BAM ツールには、複数のファイルを一度にアップロードできます。 このツールは、入力ディレクトリ内のすべてのファイルの処理が完了するまで、一度に 1 つのバッチ ファイルを移行要求を読み取ります。

BAM ツールはバッチを 1 つずつ読み取り、各サブスクリプションで Create Migration API を個別に呼び出します。

入力ディレクトリにバッチ ファイルを追加するために、1 つのバッチ ファイルの実行が完了するまで待機する必要はありません。

レートの制限と調整

コマンド 2 を実行するには (顧客のサブスクリプションを取得し、移行のためにそれらのサブスクリプションを検証します)、BAM ツールは Validate Migration API を呼び出します。 Validate Migration API のレート制限は、パートナーと顧客の組み合わせごとに 5 分間で呼び出し 450 回となっています。 このレート制限とValidate Migration APIの現在の待機時間により、BAMツールを実行する際にほとんどのパートナーでスロットリングが発生しません。 パートナーは、スロットリングが発生しないようにコンカレンシー制限を更新できます。

ただし、問題が発生した場合は、どの顧客のサブスクリプションがプルおよび検証されなかったかを追跡できます。 顧客のサブスクリプションをプルできない場合、または他の検証の問題がある場合は、failedCustomers.csvというタイトルの別の.csvがツールの出力フォルダーに表示されます。 これらの顧客のサブスクリプションのプルと検証を再試行できます。

• BAM ツールの使用方法の詳細については、バッチの移行の詳細なフローを参照してください。