Abonnementen migreren naar een nieuwe commerce-ervaring in batches met behulp van het BAM-hulpprogramma

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties bevatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle Cloud Solution Provider (CSP's). Zie Nieuwe commerce-ervaring voor services op basis van licenties voor meer informatie.

Notitie

Het hulpprogramma voor batchmigratie (BAM) dat in dit artikel wordt beschreven, kan worden gedownload via de voorbeeld-app-code van de Maart SDK-release. Het hulpprogramma is opgenomen via een nupkg-bestand om onafhankelijk van de partnercentrumportal te downloaden en uit te voeren.

Als reactie op feedback van partners kunt u nu abonnementen in batches migreren met behulp van een hulpprogramma voor console-app, het hulpprogramma voor batchmigratie (BAM). Met behulp van het BAM-hulpprogramma kunt u efficiënt migreren naar en overstappen op de nieuwe commerce-ervaring (NCE). U kunt het BAM-hulpprogramma downloaden via de voorbeeldcode van maart 2022 SDK.

SDK-releasegegevens

Ga naar de volgende bronnen voor meer informatie en informatie over SDK-releases en de voorbeeld-app-code waaruit het BAM-hulpprogramma kan worden gedownload:

Inleiding tot hulpprogramma's

Om u te helpen grote hoeveelheden abonnementen efficiënt te migreren naar NCE, het BAM-hulpprogramma:

  • Is een eenvoudig hulpprogramma dat ondersteuning biedt voor hoogwaardige, herhaalbare, aanpasbare batchmigraties.

  • Heeft een gestroomlijnde, open source, .NET SDK-voorbeeld-app-ervaring.

  • Gebruikt Excel om migratiebewerkingen te beheren.

  • Hiervoor is geen code vereist.

Ervaringsoverzicht

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

  • Verouderde abonnementen van klanten ophalen in een CSV-bestand.

  • Bereid het geëxporteerde CSV-bestand voor op migratie en bewerk abonnementen tijdens de migratie.

  • Upload een bijgewerkt CSV-abonnementsbestand in het hulpprogramma, waarna het hulpprogramma de migratieaanvragen uitvoert.

  • Controleer de status van migratieaanvragen.

Softwarevereisten

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

Installatie- en accountverificatie

Het BAM-hulpprogramma installeren en verifiëren:

  1. Ga bij de opdrachtprompt naar de map waar u het installatiebestand van het BAM-hulpprogramma hebt opgeslagen.
  2. Voer de installatieopdracht installncebulkmigrationtool.cmd in.
  3. Controleer of de versie 0.5.0 is.
  4. Voer ncebulkmigration [app ID] {UPN ID] in met de referenties van uw Partnercentrum-account om het gebruik van het BAM-hulpprogramma te verifiëren.

Nadat u het BAM-hulpprogramma op uw systeem hebt geïnstalleerd, is het klaar om te worden gebruikt. Wijzigingen in het configuratiebestand appsettings.json zijn niet vereist.

De .NET-console-app laden

Als u de werkstroomopties voor batchmigratie wilt laden, voert u bij de opdrachtprompt ncebulkmigration [app-id] {UPN-id] in

Vanuit deze fase in de toepassingsstroom kunt u het volgende doen:

  • Klanten exporteren.
  • Abonnementen exporteren met geschiktheid voor migratie.
  • Upload abonnementen die moeten worden gemigreerd.
  • Exporteer de migratiestatus van batches die al zijn geüpload voor migratie.

Filteren op klant

Als u een lijst met klanten wilt exporteren, voert u de 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 tenant-id van een partner kunt u de tenant-id van de klant, het klantdomein en de bedrijfsnaam van de klant bekijken.

Toegang tot abonnementen voor bepaalde klanten

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

Sla het bijgewerkte customers.csv-bestand op in de invoermap , zodat u de volgende stap van het ontvangen van abonnementen voor de opgegeven klanten kunt uitvoeren.

De invoermap heeft twee geneste mappen, migraties en abonnementen. Plaats customers.csv niet in de geneste mappen; bewaar deze in de invoermap .

Als u abonnementen wilt exporteren met geschiktheid voor migratie, voert u het BAM-hulpprogramma uit en voert u opdracht 2 in. Het hulpprogramma geeft aan dat abonnementen worden gevalideerd om in aanmerking te komen. Nadat de export is voltooid, is de lijst met abonnementen voor de opgegeven klanten beschikbaar in de uitvoermap als subscriptions.csv.

subscriptions.csv bevat een lijst met alle oudere abonnementen (zowel actief als onderbroken) voor de eerder opgegeven klanten.

De volgende velden kunnen voor elk abonnement worden weergegeven:

  • Partnertenant-id

  • MPN-id van indirecte reseller

  • Naam van klant

  • Tenant-id van de klant

  • Verouderde abonnements-id

  • Naam van verouderd abonnement

  • Verouderde productnaam

  • Verloopdatum

  • Migratie in aanmerking komend (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 (waar of onwaar)

  • Basisabonnement (als een invoegtoepassing)

  • Reden voor 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 wilt migreren naar NCE in een batch. U kunt bijvoorbeeld filteren op het migreren van abonnementen van een specifiek producttype of abonnementen onder een bepaalde indirecte reseller in een batch.

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

We raden maximaal 100 abonnementen per batch aan.

De volgende stap is om op te geven hoe abonnementen moeten worden gemigreerd (bijvoorbeeld like-to-like, of met bijgewerkte nieuwe term, factureringsfrequentie, duur ofaantal plaatsen ).

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

  • Nieuwe term starten

  • Termijn

  • Factureringsplan

  • Aantal zitplaatsen

De voorgaande velden vertegenwoordigen de instructies of kenmerken die het NCE-abonnement na de migratie volgt. 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 een Huidig Seat-aantal van twee heeft en er geen wijzigingen worden aangebracht in het veld Seat Count , heeft het NCE-abonnement een aantal van twee plaatsen na de migratie.

Als u een abonnement wilt starten met een nieuwe term in NCE, wijzigt u de vlag Nieuwe term starten van FALSE in TRUE. Wijzig geen waarden buiten de kolommen Nieuwe termijn, Term, Factureringsplan en Aantal plaatsen .

Een batch verzenden voor migratie

Nadat u hebt opgegeven hoe een batch moet worden gemigreerd (dat wil gezegd hebben nadat u abonnementen voor migratie hebt gefilterd en NCE-waarden hebt bijgewerkt, slaat u desgewenst 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 naar de verwerkte map te verplaatsen. Bestanden in de verwerkte map worden niet gelezen door het BAM-hulpprogramma om migratie uit te voeren omdat ze al zijn verwerkt.

Voer vervolgens bij de opdrachtprompt het BAM-hulpprogramma uit en selecteer optie 3, migraties uploaden. Met het BAM-hulpprogramma worden batchbestanden uit de map abonnementen gelezen en migratieaanvragen uitgevoerd. In het consolevenster wordt aangegeven dat de migratieaanvragen worden verwerkt. Een bestand voor elke batch met de migratie-id's wordt geëxporteerd en is beschikbaar in de map migraties die is genest in de uitvoermap .

Geëxporteerde bestanden worden gelabeld [batchID].csv. [batchID].csv heeft dezelfde velden als het invoerbestand subscriptions.csv , maar met twee kolommen: Batch-id en migratie-id. Batch-id is hetzelfde voor elk abonnement in het bestand, waarmee wordt aangegeven 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 de 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.

Er wordt ook een NCE-abonnements-id ingevuld bij een geslaagde migratie.

Als u een vernieuwd statusbestand voor een batch wilt ophalen, kopieert of slaat u het geëxporteerde [batchID].csv-bestand (dat wordt geëxporteerd naar de migratiemap die is genest in uitvoer) naar de migratiemap (die is genest in de invoermap ). Hierdoor kan het hulpprogramma lezen welke batchstatus is aangevraagd en rapporten voorbereiden om te exporteren.

Statusbestanden worden niet automatisch bijgewerkt. Als u bijgewerkte statussen wilt ophalen, moet elke keer een nieuwe aanvraag worden ingediend. Als u bijgewerkte migratiestatussen wilt ophalen, voert u het BAM-hulpprogramma uit en voert u opdracht 4 in. Het BAM-hulpprogramma geeft aan dat de migratiestatus wordt opgezoekt 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 geëxporteerd naar de map migrationstatus biedt bijgewerkte statussen voor migratieaanvragen die zijn verwerkt. Als meer dan één batch wordt weergegeven in het bestand, gebruikt u de kolom Batch-id om te filteren op toegang tot de statussen van aanvragen in een bepaalde batch.

Een lijst met nieuwe commerce-ervaringsabonnementen exporteren

Als u NCE-abonnementen wilt exporteren, voert u 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.

Frequentielimieten en bandbreedtebeperking

Als u opdracht 2 wilt uitvoeren (abonnementen voor klanten ophalen en deze abonnementen voor migratie valideren), roept het BAM-hulpprogramma de Migratie-API valideren aan. De frequentielimiet van de Migratie-API valideren is in vijf minuten 450 aanroepen per partner en klantcombinatie. Met deze frequentielimiet en de huidige latentie van de Migratie-API valideren , verwachten we niet dat u beperkingen ondervindt wanneer u het BAM-hulpprogramma uitvoert. Het hulpprogramma heeft ook gelijktijdigheidslimieten om ervoor te zorgen dat beperking niet plaatsvindt.

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 afzonderlijk CSV-bestand met de titel failedCustomers.csv weergegeven in de uitvoermap van het hulpprogramma. U kunt opnieuw abonnementen voor deze klanten ophalen/valideren.