Migrera prenumerationer till en ny handelsupplevelse med hjälp av batchmigreringsverktyget (BAM)

Du kan effektivt migrera ett stort antal prenumerationer till den nya handelsupplevelsen (NCE) med hjälp av batchmigreringsverktyget (BAM).

(Du kan också migrera batchar med prenumerationer med hjälp av migrerings-API:et från .NET SDK version 3.0.1).

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

BAM-verktyget:

• Stöder högkvalitativa, repeterbara, anpassningsbara batchmigreringar.
• Använder Excel för att hantera migreringsredigeringar
• Kräver ingen kod
• Kan laddas ned med hjälp av exempelkoden på GitHub.

Funktioner för batchmigreringsverktyg

Med bam-verktyget kan du:

• Hämta en lista över alla kunder för en klientorganisation.

• Hämta äldre kundprenumerationer i en .csv fil.

• Förbered exporteras .csv fil för migrering och redigera prenumerationer (till exempel ändringar i antal platser, terminer och faktureringscykler) under migreringen.

• Ladda upp en uppdaterad prenumeration .csv fil till verktyget, varefter verktyget kör migreringsbegäranden.

• Granska statusen för migreringsbegäranden.

• Ladda ned alla NCE-prenumerationer för alla kunder i indatafilen.

Förutsättningar

.NET 6.0 SDK krävs för att använda BAM-verktyget.

SDK och exempelkod

Mer information och resurser om SDK-versioner och exempelappkod som du kan använda för att komma åt BAM-verktyget:

• Ladda ned SDK-versioner
• Få åtkomst till exempelkod från GitHub

Använda BAM-verktyget

Kommentar

Detaljerade instruktioner finns i Steg för steg-flödet för migrering av en batch.

Använd följande steg för att läsa in arbetsflödesalternativen för batchmigrering:

• Kör BAM-verktyget och ange ncebulkmigration [app-ID] {UPN ID] i kommandotolken.

I det här steget kan partnern:

• Exportera en lista över kunder.
• Exportera äldre prenumerationer med migreringsberättigande.
• Ladda upp prenumerationer som ska migreras.
• Exportera migreringsstatusen för batchar som redan har laddats upp för migrering.
• Exportera en lista över nya prenumerationer för handel.

Kontoautentisering

BAM-verktyget är inte konfigurerat för appar med flera klientorganisationer. När du slutför autentiseringen använder du AppID för en app med konfiguration av en enda klientorganisation.

Microsoft utvärderar alternativ för att aktivera batchmigrering för program med flera klienter.

Exportera en lista över kunder

Använd följande steg för att exportera en lista över kunder:

• Kör BAM-verktyget och ange kommando 1.

Den exporterade listan över kunder sparas i utdatafilen för BAM-verktygets mappar.

Visa exporterade kunder i filen customers.csv.

För varje kund under ett partnerklient-ID kan du visa:

• Kundens klientorganisation-ID
• Kunddomän
• Kundens företagsnamn

Få åtkomst till prenumerationer för utvalda kunder

Du kan ta bort rader med kunder från den nedladdade customers.csv fil vars prenumerationer du inte vill exportera i nästa filnedladdning. De kunder som finns kvar i filen verifieras för migreringsberättigande under nästa steg i BAM-verktygets arbetsflöde.

• Spara den uppdaterade customers.csv filen i indatamappen så att du kan köra nästa steg för att ta emot prenumerationer för de angivna kunderna.
  • Indatamappen har två kapslade mappar, migreringar och prenumerationer.
  • Placera inte customers.csv i de kapslade mapparna. Behåll den i indatamappen.

Använd följande steg för att exportera prenumerationer med migreringsberättigande:

• Kör BAM-verktyget och ange kommando 2.

  Verktyget körs och anger att prenumerationer verifieras för berättigande. När exporten är klar är listan över prenumerationer för de angivna kunderna tillgänglig i utdatamappen som subscriptions.csv, som innehåller en lista över alla äldre prenumerationer (både aktiva och pausade) för de kunder som tidigare angetts.

Följande fält kan visas för varje prenumeration:

• Partnerklientorganisations-ID

• vIndirect Reseller PartnerID*

• Kundnamn

• Kundens klientorganisations-ID

• Äldre prenumerations-ID

• Äldre prenumerationsnamn

• Äldre produktnamn

• Utgångsdatum

• Migreringsberättigande (sant eller falskt)

• Aktuell term

• Aktuell faktureringsplan

• antal urrent-platser

• Starta ny term (efter migrering i NCE)

• Term (efter migrering i NCE)

• Faktureringsplan (efter migrering i NCE)

• Antal platser (efter migrering i NCE)

• Lägg till på (sant eller falskt)

• Basprenumeration (om ett tillägg)

• Orsak till migreringsfel (om prenumerationen inte är berättigad till migrering)

Fastställa vilka prenumerationer som ska migreras

Med hjälp av föregående fält kan du filtrera den exporterade listan med prenumerationer för att avgöra vilka prenumerationer du vill migrera till NCE i en batch. Du kan till exempel filtrera migreringsbatch baserat på produkttyp eller till en viss indirekt återförsäljare.

Partner kan ta bort prenumerationer från den .csv batch som de inte vill migrera.

Vi rekommenderar att du exporterar högst 200 prenumerationer per batch. (Se Migrera fler än 200 prenumerationer senare i den här artikeln om du behöver migrera fler.)

Nästa steg är att ange hur prenumerationer migreras. Partner bestämmer vilka egenskaper som ska tillämpas på migreringen.

Du kan skriva över följande fält i rader för prenumerationer som du vill migrera:

• Starta ny term

• Term

• Faktureringsplan

• Antal platser

Föregående fält representerar de instruktioner eller attribut som NCE-prenumerationen följer efter migreringen. Standardvärdena för dessa fält är värdena för de äldre prenumerationer som migreras. Om inga ändringar görs i ett fält har motsvarande NCE-prenumeration samma värde som den äldre prenumeration som den migrerade från. Om en äldre prenumeration som migreras till exempel har ett aktuellt antal platser på två och inga ändringar görs i fältet Antal platser, har NCE-prenumerationen ett antal platser på två efter migreringen.

Om du vill starta en prenumeration med en ny term i NCE använder du följande steg:

• Ändra flaggan Starta ny term från FALSE till TRUE.

  Ändra inte värden utanför följande kolumner:

  • Starta ny term
  • Term
  • Faktureringsplan
  • Antal sittplatser

Ladda upp en batch för migrering

Spara den uppdaterade subscriptions.csv filen i den prenumerationsmapp som är kapslad i indatamappen. Varje fil som sparats i prenumerationsmappen representerar en batch som ska migreras.

När en fil från prenumerationsmappen har bearbetats och körts för migrering flyttar BAM-verktyget filen till den kapslade bearbetade mappen. Du behöver inte flytta filer till den bearbetade mappen manuellt. BAM-verktyget kategoriserar filer i den bearbetade mappen eftersom de redan har bearbetats.

Om du vill ladda upp migreringar använder du följande steg:

• Kör BAM-verktyget i kommandotolken och välj alternativ 3, ladda upp migreringar, varefter:

  • BAM-verktyget läser batchfiler från prenumerationsmappen och kör migreringsbegäranden.

  • Konsolfönstret anger att migreringsbegäranden bearbetas.

    En fil för varje batch som innehåller migrerings-ID:t exporteras och är tillgänglig i mappen migreringar som är kapslad i utdatamappen.

    • Exporterade filer är märkta [batchID].csv.
    • [batchID].csv har samma fält som indatafilen subscriptions.csv , men med ytterligare två kolumner: Batch-ID och migrerings-ID.
    • Batch-ID är detsamma för varje prenumeration i filen, vilket anger att dessa prenumerationer tillhör samma batch eller uppsättning migreringsbegäranden som bearbetades tillsammans.
    • Batch-ID:t återspeglas också i namnet på .csv-filen: [batchID].csv.

Kontrollera migreringsstatus

Om en migrering lyckas är dess migreringsstatus Slutförd.

Om en migrering misslyckas är dess migreringsstatus Misslyckad och du kan visa orsaken till felet.

Ett migrerings-ID är unikt för varje prenumeration som migreras, så du kan använda migrerings-ID för att spåra migreringsstatus.

Ett NCE-prenumerations-ID fylls också i vid lyckad migrering.

Om du vill hämta en uppdaterad statusfil för en batch använder du följande steg:

• Kopiera eller spara den exporterade [batchID].csv filen från mappen output/migrations till mappen input/migrations .

  På så sätt kan verktyget läsa vilken batchstatus som begärs och förbereda rapporter för export.

Statusfiler uppdateras inte automatiskt. För att hämta uppdaterade statusar måste en ny begäran göras varje gång.

Använd följande steg för att hämta uppdaterade migreringsstatusar:

• Kör BAM-verktyget och ange kommando 4.

  BAM-verktyget körs och anger att det söker efter migreringsstatus och exporterar status till mappen migrationstatus . Namnen på de exporterade migreringsstatusfilerna representerar batch-ID för prenumerationer som finns i .csv-filerna.

[ batchID].csv fil som exporteras till mappen migrationstatus innehåller uppdaterade statusar för bearbetade migreringsbegäranden. Om mer än en batch representeras i filen använder du kolumnen Batch-ID för att filtrera för att få åtkomst till status för begäranden i en viss batch.

Exportera en lista över prenumerationer på nya köpupplevelser

Om du vill exportera NCE-prenumerationer använder du följande steg:

• Kör BAM-verktyget och ange kommando 5.

  Den exporterade listan sparas i utdatamappen. Det här steget krävs inte för migrering, men du kan använda det för att organisera NCE-prenumerationer för olika kunder.

Migrera fler än 200 prenumerationer

Om du vill migrera fler än 200 prenumerationer (vilket är den maximala rekommenderade batchstorleken) kan du ladda upp flera batchar till BAM-verktyget. Du kan ordna mappar efter olika fält för att minska storleken på de filer som du vill ladda upp som ska migreras:

• Indirekt återförsäljare
• Produktnamn
• Prenumerationsnamn
• Andra kriterier

Batch-filer som överskrider den maximala rekommenderade storleken på 200 prenumerationer kan delas upp i separata .csv filer.

Ladda upp flera filer

Du kan ladda upp flera filer till BAM-verktyget samtidigt. Verktyget läser migreringsbegäranden en batchfil i taget tills den har slutfört bearbetningen av alla filer i indatakatalogen.

BAM-verktyget läser batchar en i taget och anropar API:et Skapa migrering för varje prenumeration individuellt.

Du behöver inte vänta tills en batchfil har körts klart för att lägga till fler batchfiler i indatakatalogen.

Hastighetsbegränsningar och begränsning

Om du vill köra kommando 2 (hämta prenumerationer för kunder och validera dessa prenumerationer för migrering) anropar BAM-verktyget API:et Validate Migration (Validera migrering ). Hastighetsgränsen för API:et Verifiera migrering är 450 anrop per partner + kundkombination på fem minuter. Med den här hastighetsgränsen och den aktuella svarstiden för API:et Verifiera migrering kommer de flesta partner inte att uppleva begränsningar när du kör BAM-verktyget. Partner kan höja samtidighetsgränserna för att säkerställa att begränsningen inte sker.

Men om ett problem uppstår kan du hålla reda på vilka kundprenumerationer som inte hämtades och verifierades. En separat .csv med titeln failedCustomers.csv visas i verktygets utdatamapp om kundens prenumerationer inte kan hämtas eller om det finns andra valideringsproblem. Du kan försöka hämta och verifiera prenumerationer för dessa kunder igen.

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). Mer information finns i Ny handelsupplevelse för licensbaserade tjänster.

• Detaljerade instruktioner om hur du använder BAM-verktyget finns i Steg för steg-flödet för migrering av en batch.