Migrieren von Abonnements zu neuer Commerce-Erfahrung mithilfe des Batchmigrationstools (BAM)

Artikel
07/02/2024

Mit dem Batchmigrationstool (BAM) können Sie eine große Anzahl von Abonnements effizient in die neue Commerce-Erfahrung (NCE) migrieren.

(Sie können auch Batches von Abonnements mithilfe der Migrations-API von .NET SDK Version 3.0.1 migrieren.

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

Das BAM-Tool:

Unterstützt hochwertige, wiederholbare, anpassbare Batchmigrationen.
Verwendet Excel zum Verwalten von Migrationsbearbeitungen
Erfordert keinen Code
Kann mit dem Beispielcode auf GitHub heruntergeladen werden.

Funktionen des Batchmigrationstools

Mithilfe des BAM-Tools können Sie Folgendes ausführen:

Dient zum Abrufen einer Liste aller Kunden für einen Mandanten.
Abrufen von älteren Kundenabonnements in einer .csv Datei.
Bereiten Sie .csv Datei für die Migration vor, und bearbeiten Sie Abonnements (z. B. Änderungen an der Anzahl von Arbeitsplätzen, Laufzeiten und Abrechnungszeitraum) während der Migration.
Laden Sie ein aktualisiertes Abonnement .csv Datei in das Tool hoch, nach dem das Tool die Migrationsanforderungen ausführt.
Überprüfen Sie den Status von Migrationsanforderungen.
Laden Sie alle NCE-Abonnements für alle Kundenlisten in der Eingabedatei herunter.

Voraussetzungen

Das .NET 6.0 SDK ist erforderlich, um das BAM-Tool zu verwenden.

SDK- und Beispielcode

Ausführliche Informationen und Ressourcen zu SDK-Versionen sowie Beispiel-App-Code, den Sie für den Zugriff auf das BAM-Tool verwenden können:

Verwenden des BAM-Tools

Hinweis

Ausführliche Anweisungen finden Sie unter Schritt-für-Schritt-Fluss der Migration eines Batches.

Führen Sie die folgenden Schritte aus, um die Workflowoptionen für die Batchmigration zu laden:

Führen Sie das BAM-Tool aus, und geben Sie an der Eingabeaufforderung ncebulkmigration [App-ID] {UPN-ID] ein.

Zu den Aktionen, die Sie in dieser Phase ausführen können, gehören:

Exportieren sie eine Liste von Kunden.
Exportieren Von Legacyabonnements mit Migrationsberechtigung.
Hochladen Abonnements, die migriert werden sollen.
Exportieren Sie den Migrationsstatus von Batches, die bereits für die Migration hochgeladen wurden.
Exportieren sie eine Liste der neuen Abonnements für die Commerce-Erfahrung.

Kontoauthentifizierung

Das BAM-Tool ist nicht für Mehrinstanzen-Apps konfiguriert. Verwenden Sie beim Abschließen der Authentifizierung die App-ID einer App mit einer Konfiguration mit einem einzelnen Mandanten.

Microsoft prüft Optionen zum Aktivieren der Batchmigration für mehrinstanzenfähige Anwendungen.

Exportieren einer Kundenliste

Führen Sie die folgenden Schritte aus, um eine Liste von Kunden zu exportieren:

Führen Sie das BAM-Tool aus, und geben Sie Befehl 1 ein.

Die exportierte Liste der Kunden wird in der Ausgabedatei der Ordner des BAM-Tools gespeichert.

Zeigen Sie exportierte Kunden in der Datei customers.csvan.

Für jeden Kunden unter einer Partnermandanten-ID können Sie Folgendes anzeigen:

Mandanten-ID des Kunden
Kundendomäne
Customer company name (Firmenname des Kunden)

Zugreifen auf Abonnements für ausgewählte Kunden

Sie können Zeilen von Kunden aus der heruntergeladenen customers.csv Datei entfernen, deren Abonnements Sie nicht im nächsten Dateidownload exportieren möchten. Die Kunden, die in der Datei verbleiben, werden während des nächsten Schritts im Arbeitsablauf des BAM-Tools für die Migrationsberechtigung überprüft.

Speichern Sie die aktualisierte customers.csv Datei im Eingabeordner , damit Sie den nächsten Schritt des Empfangens von Abonnements für die angegebenen Kunden ausführen können.
- Der Eingabeordner verfügt über zwei geschachtelte Ordner, Migrationen und Abonnements.
- Platzieren Sie customers.csv nicht in den geschachtelten Ordnern. Behalten Sie sie im Eingabeordner bei.

Führen Sie die folgenden Schritte aus, um Abonnements mit Migrationsberechtigung zu exportieren:

Führen Sie das BAM-Tool aus, und geben Sie Befehl 2 ein.

Das Tool wird ausgeführt und gibt an, dass Abonnements für die Berechtigung überprüft werden. Nach Abschluss des Exports ist die Liste der Abonnements für die angegebenen Kunden im Ausgabeordner als subscriptions.csv verfügbar, die eine Liste aller Legacyabonnements (sowohl aktiv als auch ausgesetzt) für die zuvor angegebenen Kunden bereitstellt.

Die folgenden Felder können für jedes Abonnement angezeigt werden:

Partnermandanten-ID
Indirekter Reseller PartnerID
Kundenname
Mandanten-ID des Kunden
Legacy-Abonnement-ID
Legacy-Abonnement-Name
Legacyproduktname
Ablaufdatum
Migrationsberechtigt (True oder False)
Aktueller Ausdruck
Aktueller Abrechnungsplan
Aktuelle Lizenzanzahl
Neuen Ausdruck starten (nach der Migration in NCE)
Ausdruck (Nach der Migration in NCE)
Abrechnungsplan (Nach der Migration in NCE)
Lizenzanzahl (Nach der Migration in NCE)
Add-On (True oder False)
Basisabonnement (wenn ein Add-On)
Migrationsanfälligkeitsgrund (wenn das Abonnement nicht für die Migration berechtigt ist)

Bestimmen, welche Abonnements migriert werden und wie

Mithilfe der vorherigen Felder können Sie die exportierte Liste der Abonnements filtern, um zu bestimmen, welche Abonnements Sie in einem Batch zu NCE migrieren möchten. Sie können z. B. filtern, um eine Reihe von Abonnements eines bestimmten Produkttyps oder eine Reihe von Abonnements unter einem bestimmten indirekten Wiederverkäufer zu migrieren.

Nachdem Sie Abonnements gefiltert und ausgewählt haben, löschen Sie alle Abonnements, die für den Batch nicht ausgewählt sind, aus der .csv Datei. Dies verhindert unbeabsichtigte Migrationen.

Es wird empfohlen, nicht mehr als 200 Abonnements pro Batch zu exportieren. (Siehe Migrieren Sie mehr als 200 Abonnements später in diesem Artikel, wenn Sie mehr migrieren müssen.)

Der nächste Schritt besteht darin, anzugeben, wie Abonnements migriert werden sollen (z. B. liken oder mit aktualisierter Startzeit, Abrechnungshäufigkeit, Laufzeitdauer oder Lizenzanzahlsattributen).

Sie können die folgenden Felder in Zeilen für Abonnements überschreiben, die Sie migrieren möchten:

Neuen Ausdruck starten
Begriff
Abrechnungsplan
Lizenzanzahl

Die vorherigen Felder stellen die Anweisungen oder Attribute dar, die das NCE-Abonnement nach der Migration einhalten wird. Die Standardwerte für diese Felder sind die Werte der migrierten Legacyabonnements. Wenn keine Änderungen an einem Feld vorgenommen werden, hat das entsprechende NCE-Abonnement denselben Wert wie das Legacyabonnement, aus dem sie migriert wurde. Wenn z. B. ein älteres Abonnement über eine aktuelle Anzahl von zwei Lizenzen verfügt und keine Änderungen am Feld "Seat Count " vorgenommen werden, verfügt das NCE-Abonnement nach der Migration über eine Anzahl von zwei Arbeitsplätzen.

Um ein Abonnement mit einer neuen Laufzeit in NCE zu starten, führen Sie den folgenden Schritt aus:

Ändern Sie das Flag " Neuer Ausdruck starten" von FALSE in "WAHR".

Ändern Sie werte nicht außerhalb der folgenden Spalten:
- Neuen Ausdruck starten
- Begriff
- Abrechnungsplan
- Lizenzanzahl

Hochladen eines Batches für die Migration

Nachdem Sie angegeben haben, wie ein Batch migriert werden soll (d. h., nachdem Sie Abonnements für die Migration gefiltert und NCE-Werte aktualisiert haben, falls gewünscht), speichern Sie die aktualisierte subscriptions.csv Datei im Ordner "Abonnements ", der im Eingabeordner geschachtelt ist. Jede Datei, die im Ordner "Abonnements" gespeichert ist, stellt einen Batch dar, der migriert werden soll.

Nachdem eine Datei aus dem Ordner "Abonnements" für die Migration verarbeitet wurde, verschiebt das BAM-Tool diese Datei in den geschachtelten verarbeiteten Ordner, der angibt, dass Migrationsanforderungen für diesen Batch ausgeführt wurden. Sie müssen Dateien nicht manuell in den verarbeiteten Ordner verschieben. Dateien im verarbeiteten Ordner werden nicht vom BAM-Tool gelesen, um die Migration auszuführen, da sie bereits verarbeitet wurden.

Verwenden Sie den folgenden Schritt, um Migrationen hochzuladen:

Führen Sie an der Eingabeaufforderung das BAM-Tool aus, und wählen Sie Option 3 aus, laden Sie Migrationen hoch, danach:
- Das BAM-Tool liest Batchdateien aus dem Ordner "Abonnements " und führt Migrationsanforderungen aus.
- Das Konsolenfenster gibt an, dass Migrationsanforderungen verarbeitet werden.
  
  Eine Datei für jeden Batch, der die Migrations-IDs enthält, wird exportiert und ist im Migrationsordner verfügbar, der im Ausgabeordner geschachtelt ist.
  - Exportierte Dateien werden [batchID].csv bezeichnet.
  - [batchID].csv hat dieselben Felder wie die Eingabedateisubscriptions.csv Datei, aber mit zwei weiteren Spalten: Batch-ID und Migrations-ID.
  - Batch-ID ist für jedes Abonnement in der Datei identisch, das angibt, dass diese Abonnements zu demselben Batch oder einer Gruppe von Migrationsanforderungen gehören, die zusammen verarbeitet wurden.
  - Die Batch-ID wird auch im Namen der .csv Datei angezeigt: [batchID].csv.

Überprüfen des Migrationsstatus

Wenn eine Migration erfolgreich ist, ist der Migrationsstatus abgeschlossen.

Wenn eine Migration nicht erfolgreich ist, ist der Migrationsstatus fehlgeschlagen, und Sie können den Grund für den Fehler anzeigen.

Eine Migrations-ID ist für jedes migrierte Abonnement eindeutig, sodass Sie die Migrations-ID verwenden können, um den Migrationsstatus zu verfolgen.

Eine NCE-Abonnement-ID wird auch nach erfolgreicher Migration aufgefüllt.

Verwenden Sie den folgenden Schritt, um eine aktualisierte Statusdatei für einen Batch abzurufen:

Kopieren oder speichern Sie die exportierte [batchID].csv Datei (die in den Migrationsordner exportiert wird, der in der Ausgabe geschachtelt ist) in den Migrationsordner (der im Eingabeordner geschachtelt ist).

Dadurch kann das Tool lesen, welche Batchesstatus angefordert wurde, und berichte zum Exportieren vorbereiten.

Statusdateien werden nicht automatisch aktualisiert. Um aktualisierte Status abzurufen, muss jedes Mal eine neue Anforderung vorgenommen werden.

Verwenden Sie den folgenden Schritt, um aktualisierte Migrationsstatus abzurufen:

Führen Sie das BAM-Tool aus, und geben Sie Befehl 4 ein.

Das BAM-Tool wird ausgeführt und gibt an, dass der Migrationsstatus nachschlagen und eine Datei in den Migrationsstatusordner exportiert wurde. Die Namen der exportierten Migrationsstatusdateien stellen die Batch-ID von Abonnements dar, die in den CSVs enthalten sind.

Die [batchID].csv Datei, die in den Migrationsstatusordner exportiert wurde, stellt aktualisierte Status für Migrationsanforderungen bereit, die verarbeitet wurden. Wenn mehrere Batche in der Datei dargestellt werden, verwenden Sie die Spalte "Batch-ID", um auf Status von Anforderungen in einem bestimmten Batch zuzugreifen.

Exportieren einer Liste neuer Abonnements für die Commerce-Erfahrung

Verwenden Sie den folgenden Schritt, um NCE-Abonnements zu exportieren:

Führen Sie das BAM-Tool aus, und geben Sie Befehl 5 ein.

Die exportierte Liste wird im Ausgabeordner gespeichert. Dieser Schritt ist nicht für die Migration erforderlich, aber Sie können es verwenden, um NCE-Abonnements für verschiedene Kunden zu organisieren.

Migrieren von mehr als 200 Abonnements

Wenn Sie mehr als 200 Abonnements migrieren möchten (dies ist die maximale empfohlene Batchgröße), können Sie mehrere Batches in das BAM-Tool hochladen. Sie können Ordner nach verschiedenen Feldern organisieren, um die Größe der Dateien zu verringern, die Sie hochladen möchten, um migriert zu werden. Sie können z. B. Abonnements organisieren, die migriert werden sollen, indem Sie:

Indirekter Wiederverkäufer
Produktname
Abonnementname
Andere Kriterien

Wenn eine von Ihnen organisierte Batchdatei die maximale empfohlene Größe von 200 Abonnements überschreitet, können Sie eine .csv in mehrere trennen, indem Sie abonnements effektiv in neue Dateien kopieren, um die maximale Größe von 200 Abonnements für jeden Batch beizubehalten. Wenn Sie beispielsweise 425 Abonnements migrieren möchten, können Sie sie in drei separate Dateien aufteilen (zwei Dateien, die 200 Abonnements enthalten und eine andere mit 25).

Hochladen mehrerer Dateien

Sie können mehrere Dateien gleichzeitig in das BAM-Tool hochladen. Das Tool liest Migrationsanforderungen jeweils eine Batchdatei und beginnt automatisch mit dem Lesen in anderen Batchdateien, die im Eingabeverzeichnis gespeichert sind (wenn mehrere Batches hinzugefügt wurden).

Das BAM-Tool liest Batches einzeln und ruft die Create Migration API für jedes Abonnement einzeln auf.

Sie müssen nicht warten, bis die Ausführung einer Batchdatei abgeschlossen ist, um dem Eingabeverzeichnis weitere Batchdateien hinzuzufügen.

Ratenbegrenzung und -drosselung

Zum Ausführen von Befehl 2 (Abrufen von Abonnements für Kunden und Validieren dieser Abonnements für die Migration) ruft das BAM-Tool die Überprüfungsmigrations-API auf. Die Rategrenze der Überprüfungsmigrations-API beträgt 450 Aufrufe pro Partner + Kundenkombination in fünf Minuten. Mit diesem Ratelimit und der aktuellen Latenz der Überprüfungsmigrations-API erwarten wir nicht, dass Beim Ausführen des BAM-Tools eine Einschränkung auftritt. Außerdem verfügt das Tool über Parallelitätsbeschränkungen, um sicherzustellen, dass die Drosselung nicht auftritt.

Wenn jedoch ein Problem auftritt, können Sie nachverfolgen, welche Abonnements des Kunden nicht abgerufen und überprüft wurden. Wenn die Abonnements eines Kunden nicht abgerufen werden können oder beim Überprüfen von Abonnements Probleme auftreten, wird im Ausgabeordner des Tools eine separate .csv mit dem Titel failedCustomers.csv angezeigt. Sie können erneut versuchen, Abonnements für diese Kunden abzurufen und zu validieren.