Abonnementen migreren naar nieuwe commerce-ervaring met behulp van het hulpprogramma voor batchmigratie (BAM)

Artikel
03/08/2023

U kunt efficiënt grote aantallen abonnementen migreren naar de nieuwe commerce-ervaring (NCE) met behulp van het hulpprogramma voor batchmigratie (BAM).

(U kunt ook batches met abonnementen migreren met behulp van de migratie-API van .NET SDK versie 3.0.1).

Belangrijk

Vanaf juni 2023 is de nieuwste .NET SDK-release 3.4.0 van partnercentrum nu gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van het Partnercentrum te blijven gebruiken.

Het BAM-hulpprogramma:

Ondersteunt hoogwaardige, herhaalbare, aanpasbare batchmigraties.
Maakt gebruik van Excel om migratiebewerkingen te beheren
Vereist geen code
Kan worden gedownload met behulp van de voorbeeldcode op GitHub.

Mogelijkheden van het hulpprogramma Batch-migratie

Met behulp van het BAM-hulpprogramma kunt u het volgende doen:

Een lijst met alle klanten voor een tenant ophalen.
Verouderde abonnementen van klanten ophalen in een .csv-bestand.
Bereid het geëxporteerde .csv-bestand voor op migratie en bewerk abonnementen (zoals wijzigingen in aantal plaatsen, termijn en factureringscyclus) tijdens de migratie.
Upload een bijgewerkt abonnement .csv bestand naar het hulpprogramma, waarna het hulpprogramma de migratieaanvragen uitvoert.
Controleer de status van migratieaanvragen.
Download alle NCE-abonnementen voor alle klanten in het invoerbestand.

Vereisten

De .NET 6.0 SDK is vereist voor het gebruik van het BAM-hulpprogramma.

SDK en voorbeeldcode

Voor details en resources met betrekking tot SDK-releases en voorbeeld-app-code die u kunt gebruiken om toegang te krijgen tot het BAM-hulpprogramma:

Het HULPPROGRAMMA BAM gebruiken

Notitie

Zie Stapsgewijze stroom van het migreren van een batch voor gedetailleerde instructies.

Voer de volgende stappen uit om de werkstroomopties voor batchmigratie te laden:

Voer het hulpprogramma BAM uit en voer bij de opdrachtprompt ncebulkmigration [app-id] {UPN-id] in.

Enkele van de acties die u in deze fase kunt uitvoeren, zijn:

Een lijst met klanten exporteren.
Verouderde abonnementen exporteren met geschiktheid voor migratie.
Upload abonnementen die moeten worden gemigreerd.
Exporteer de migratiestatus van batches die al zijn geüpload voor migratie.
Exporteer een lijst met nieuwe commerce-ervaringsabonnementen.

Accountverificatie

Het BAM-hulpprogramma is niet geconfigureerd voor multitenant-apps. Gebruik bij het voltooien van de verificatie de AppID van een app met configuratie met één tenant.

Microsoft evalueert opties voor het inschakelen van de batchmigratie voor multitenant-toepassingen.

Een lijst met klanten exporteren

Voer de volgende stappen uit om een lijst met klanten te exporteren:

Voer het hulpprogramma BAM uit en voer opdracht 1 in.

De geëxporteerde lijst met klanten wordt opgeslagen in het uitvoerbestand van de mappen van het BAM-hulpprogramma.

Geëxporteerde klanten weergeven in het bestand customers.csv.

Voor elke klant onder een partnertenant-id kunt u het volgende bekijken:

Tenant-id van de klant
Klantdomein
Bedrijfsnaam van klant

Toegang tot abonnementen voor bepaalde klanten

U kunt rijen met klanten verwijderen uit het gedownloade customers.csv-bestand waarvan u de abonnementen niet wilt exporteren in het volgende bestand. De klanten die in het bestand blijven, worden tijdens de volgende stap in de werkstroom van het BAM-hulpprogramma gevalideerd of ze in aanmerking komen voor migratie.

Sla het bijgewerkte customers.csv-bestand op in de invoermap , zodat u de volgende stap voor het ontvangen van abonnementen voor de opgegeven klanten kunt uitvoeren.
- De invoermap bevat twee geneste mappen, migraties en abonnementen.
- Plaats customers.csv niet in de geneste mappen. Bewaar deze in de invoermap .

Voer de volgende stappen uit om abonnementen te exporteren die in aanmerking komen voor migratie:

Voer het hulpprogramma BAM uit en voer opdracht 2 in.

Het hulpprogramma wordt uitgevoerd en geeft aan dat abonnementen worden gevalideerd om in aanmerking te komen. Nadat het exporteren is voltooid, is de lijst met abonnementen voor de opgegeven klanten beschikbaar in de uitvoermap als subscriptions.csv. Deze bevat een lijst met alle verouderde abonnementen (zowel actief als onderbroken) voor de eerder opgegeven klanten.

De volgende velden kunnen worden weergegeven voor elk abonnement:

Tenant-id van partner
PartnerID van indirecte reseller
Naam van klant
Tenant-id van de klant
Verouderde abonnements-id
Naam van verouderd abonnement
Verouderde productnaam
Verloopdatum
Migratie die in aanmerking komt (waar of onwaar)
Huidige term
Huidig factureringsplan
Aantal huidige zetels
Nieuwe term starten (na migratie in NCE)
Term (na migratie in NCE)
Factureringsplan (na migratie in NCE)
Aantal plaatsen (na migratie in NCE)
Toevoegen aan (Waar of Onwaar)
Basisabonnement (indien een invoegtoepassing)
Reden van niet-in aanmerking komende migratie (als het abonnement niet in aanmerking komt voor migratie)

Bepalen welke abonnementen worden gemigreerd en hoe

Met behulp van de voorgaande velden kunt u de geëxporteerde lijst met abonnementen filteren om te bepalen welke abonnementen u in een batch naar NCE wilt migreren. U kunt bijvoorbeeld filteren om een batch abonnementen van een bepaald producttype of een batch abonnementen onder een bepaalde indirecte reseller te migreren.

Nadat u abonnementen hebt gefilterd en geselecteerd, verwijdert u alle abonnementen die niet zijn geselecteerd voor de batch uit het .csv-bestand. Hiermee voorkomt u onbedoelde migraties.

U wordt aangeraden niet meer dan 200 abonnementen per batch te exporteren. (Zie Meer dan 200 abonnementen migreren verderop in dit artikel als u meer wilt migreren.)

De volgende stap is het opgeven hoe abonnementen moeten worden gemigreerd (bijvoorbeeld like-to-like of met bijgewerkte kenmerken voor nieuwe startperiode, factureringsfrequentie, duur of aantal plaatsen ).

U kunt de volgende velden in rijen overschrijven voor abonnementen die u wilt migreren:

Nieuwe term starten
Termijn
Factureringsplan
Aantal plaatsen

De voorgaande velden vertegenwoordigen de instructies of kenmerken die het NCE-abonnement na de migratie zal naleven. De standaardwaarden voor deze velden zijn de waarden van de verouderde abonnementen die worden gemigreerd. Als er geen wijzigingen worden aangebracht in een veld, heeft het bijbehorende NCE-abonnement dezelfde waarde als het verouderde abonnement waaruit het is gemigreerd. Als een verouderd abonnement dat wordt gemigreerd bijvoorbeeld het huidige aantal zetels van twee heeft en er geen wijzigingen worden aangebracht in het veld Aantal zitplaatsen , heeft het NCE-abonnement een aantal zetels van twee na de migratie.

Gebruik de volgende stap om een abonnement te starten met een nieuwe term in NCE:

Wijzig de vlag Nieuwe term starten van FALSE in TRUE.

Wijzig geen waarden buiten de volgende kolommen:
- Nieuwe term starten
- Termijn
- Factureringsplan
- Aantal zetels

Een batch uploaden voor migratie

Nadat u hebt opgegeven hoe een batch moet worden gemigreerd (dat wil gezegd, nadat u abonnementen voor migratie hebt gefilterd en indien gewenst de NCE-waarden hebt bijgewerkt), slaat u het bijgewerkte subscriptions.csv-bestand op in de map abonnementen die is genest in de invoermap . Elk bestand dat is opgeslagen in de map abonnementen vertegenwoordigt een batch die moet worden gemigreerd.

Nadat een bestand uit de map abonnementen is verwerkt voor migratie, verplaatst het BAM-hulpprogramma dat bestand naar de geneste verwerkte map, waarmee wordt aangegeven dat migratieaanvragen voor die batch zijn uitgevoerd. U hoeft bestanden niet handmatig te verplaatsen naar de verwerkte map. Bestanden in de verwerkte map worden niet gelezen door het BAM-hulpprogramma om de migratie uit te voeren, omdat ze al zijn verwerkt.

Gebruik de volgende stap om migraties te uploaden:

Voer bij de opdrachtprompt het BAM-hulpprogramma uit en selecteer optie 3, migraties uploaden, waarna:
- Het BAM-hulpprogramma leest batchbestanden uit de map abonnementen en voert migratieaanvragen uit.
- Het consolevenster geeft aan dat migratieaanvragen worden verwerkt.
  
  Een bestand voor elke batch met de migratie-id's wordt geëxporteerd en is beschikbaar in de migratiemap die is genest in de uitvoermap .
  - Geëxporteerde bestanden hebben het label [batchID].csv.
  - [batchID].csv heeft dezelfde velden als de invoer subscriptions.csv bestand, maar met nog twee kolommen: Batch-id en Migratie-id.
  - Batch-id is hetzelfde voor elk abonnement in het bestand, wat aangeeft dat deze abonnementen deel uitmaken van dezelfde batch of set migratieaanvragen die samen zijn verwerkt.
  - De batch-id wordt ook weergegeven in de naam van het .csv-bestand: [batchID].csv.

Migratiestatus controleren

Als een migratie is geslaagd, is de migratiestatus voltooid.

Als een migratie mislukt, is de migratiestatus mislukt en kunt u de reden voor de fout bekijken.

Een migratie-id is uniek voor elk abonnement dat wordt gemigreerd, zodat u migratie-id kunt gebruiken om de migratiestatus bij te houden.

Bij een geslaagde migratie wordt ook een NCE-abonnements-id ingevuld.

Voer de volgende stap uit om een vernieuwd statusbestand voor een batch op te halen:

Kopieer of sla het geëxporteerde bestand [batchID].csv (dat wordt geëxporteerd naar de migratiemap die in uitvoer is genest) op in de map migrations (die is genest in de invoermap ).

Als u dit doet, kan het hulpprogramma lezen welke batches zijn aangevraagd en rapporten voorbereiden om te exporteren.

Statusbestanden worden niet automatisch bijgewerkt. Als u bijgewerkte statussen wilt ophalen, moet er elke keer een nieuwe aanvraag worden gedaan.

Gebruik de volgende stap om bijgewerkte migratiestatussen op te halen:

Voer het BAM-hulpprogramma uit en voer opdracht 4 in.

Het BAM-hulpprogramma wordt uitgevoerd en geeft aan dat het de migratiestatus opzoekt en dat een bestand is geëxporteerd naar de map migrationstatus . De namen van de geëxporteerde migratiestatusbestanden vertegenwoordigen de batch-id van abonnementen in de CSV's.

Het bestand [batchID].csv dat naar de map migrationstatus is geëxporteerd, bevat bijgewerkte statussen voor migratieaanvragen die zijn verwerkt. Als meer dan één batch in het bestand wordt weergegeven, gebruikt u de kolom Batch-id om te filteren op toegang tot de statussen van aanvragen in een bepaalde batch.

Een lijst met nieuwe commerceervaringsabonnementen exporteren

Gebruik de volgende stap om NCE-abonnementen te exporteren:

Voer het BAM-hulpprogramma uit en voer opdracht 5 in.

De geëxporteerde lijst wordt opgeslagen in de uitvoermap . Deze stap is niet vereist voor migratie, maar u kunt deze gebruiken om NCE-abonnementen voor verschillende klanten te organiseren.

Meer dan 200 abonnementen migreren

Als u meer dan 200 abonnementen wilt migreren (wat de maximale aanbevolen batchgrootte is), kunt u meerdere batches uploaden naar het BAM-hulpprogramma. U kunt mappen ordenen op verschillende velden om de grootte te verkleinen van de bestanden die u wilt uploaden om te worden gemigreerd. U kunt bijvoorbeeld abonnementen organiseren die moeten worden gemigreerd door:

Indirecte reseller
Productnaam
Abonnementsnaam
Andere criteria

Als een batchbestand dat u hebt georganiseerd de maximale aanbevolen grootte van 200 abonnementen overschrijdt, kunt u één .csv in meerdere delen door effectief abonnementen naar nieuwe bestanden te kopiëren om het maximum van 200 abonnementen van elke batch te behouden. Als u bijvoorbeeld 425 abonnementen wilt migreren, kunt u deze splitsen in drie afzonderlijke bestanden (twee bestanden met 200 abonnementen en één met 25).

Meerdere bestanden uploaden

U kunt meerdere bestanden tegelijk uploaden naar het BAM-hulpprogramma. Het hulpprogramma leest migratieaanvragen met één batchbestand tegelijk en begint automatisch met het lezen van andere batchbestanden die zijn opgeslagen in de invoermap (als er meerdere batches zijn toegevoegd).

Het BAM-hulpprogramma leest batches één voor één en roept de Migratie-API maken voor elk abonnement afzonderlijk aan.

U hoeft niet te wachten totdat één batchbestand is uitgevoerd om meer batchbestanden toe te voegen aan de invoermap.

Frequentielimieten en beperking

Als u opdracht 2 wilt uitvoeren (abonnementen voor klanten ophalen en deze abonnementen valideren voor migratie), roept het BAM-hulpprogramma de MIGRATIE-API valideren aan. De frequentielimiet van de Validate Migration-API is 450 aanroepen per combinatie van partner en klant in vijf minuten. Met deze frequentielimiet en de huidige latentie van de Validatiemigratie-API verwachten we niet dat u te maken krijgt met beperking wanneer u het BAM-hulpprogramma uitvoert. Het hulpprogramma heeft ook gelijktijdigheidslimieten om ervoor te zorgen dat er geen beperking optreedt.

Als er echter een probleem optreedt, kunt u bijhouden welke abonnementen van klanten niet zijn opgehaald en gevalideerd. Als de abonnementen van een klant niet kunnen worden opgehaald of als er problemen zijn tijdens het valideren van abonnementen, wordt er een afzonderlijke .csv met de titel failedCustomers.csv weergegeven in de uitvoermap van het hulpprogramma. U kunt opnieuw proberen abonnementen voor deze klanten op te halen en te valideren.