Eseguire la migrazione delle sottoscrizioni alla nuova esperienza commerciale usando lo strumento di migrazione batch (BAM)

Articolo
07/03/2024

È possibile eseguire in modo efficiente la migrazione di un numero elevato di sottoscrizioni nella nuova esperienza commerciale (NCE) usando lo strumento di migrazione batch (BAM).

È anche possibile eseguire la migrazione di batch di sottoscrizioni usando l'API di migrazione da .NET SDK versione 3.0.1.

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner.

Lo strumento BAM:

Supporta migrazioni batch di alta qualità, ripetibili e personalizzabili.
Usa Excel per gestire le modifiche alla migrazione
Non richiede codice
Può essere scaricato usando il codice di esempio in GitHub.

Funzionalità dello strumento di migrazione batch

Usando lo strumento BAM, è possibile:

Recuperare un elenco di tutti i clienti per un tenant.
Recuperare le sottoscrizioni legacy dei clienti in un file di .csv.
Preparare .csv file esportato per la migrazione e modificare le sottoscrizioni (ad esempio modifiche al numero di postazioni, al termine e al ciclo di fatturazione) durante la migrazione.
Caricare un file di sottoscrizione aggiornato .csv nello strumento, dopo il quale lo strumento esegue le richieste di migrazione.
Esaminare lo stato delle richieste di migrazione.
Scaricare tutte le sottoscrizioni NCE per tutti gli elenchi di clienti nel file di input.

Prerequisiti

.NET 6.0 SDK è necessario per usare lo strumento BAM.

SDK e codice di esempio

Per informazioni dettagliate e risorse relative alle versioni dell'SDK e al codice dell'app di esempio che è possibile usare per accedere allo strumento BAM:

Usare lo strumento BAM

Nota

Per istruzioni dettagliate, vedere Flusso dettagliato della migrazione di un batch.

Per caricare le opzioni del flusso di lavoro per la migrazione batch, seguire questa procedura:

Eseguire lo strumento BAM e al prompt dei comandi immettere ncebulkmigration [ID app] {UPN ID].

Tra le azioni che è possibile eseguire in questa fase sono:

Esportare un elenco di clienti.
Esportare sottoscrizioni legacy con idoneità alla migrazione.
Caricare le sottoscrizioni di cui eseguire la migrazione.
Esportare lo stato della migrazione dei batch che sono già stati caricati per la migrazione.
Esportare un elenco di nuove sottoscrizioni dell'esperienza commerciale.

Autenticazione dell'account

Lo strumento BAM non è configurato per le app multi-tenant. Al termine dell'autenticazione, usare l'ID app di un'app con la configurazione a tenant singolo.

Microsoft sta valutando le opzioni per abilitare la migrazione batch per le applicazioni multi-tenant.

Esportare un elenco di clienti

Per esportare un elenco di clienti, seguire questa procedura:

Eseguire lo strumento BAM e immettere il comando 1.

L'elenco esportato dei clienti viene salvato nel file di output delle cartelle dello strumento BAM.

Visualizzare i clienti esportati nel file customers.csv.

Per ogni cliente con un ID tenant partner, è possibile visualizzare:

ID tenant cliente
Dominio del cliente
Nome società cliente

Accedere alle sottoscrizioni per i clienti selezionati

È possibile rimuovere righe di clienti dal file customers.csv scaricato le cui sottoscrizioni non si desidera esportare nel download del file successivo. I clienti che rimangono nel file vengono convalidati per l'idoneità alla migrazione durante il passaggio successivo del flusso di lavoro dello strumento BAM.

Salvare il file di customers.csv aggiornato nella cartella di input in modo da poter eseguire il passaggio successivo di ricezione delle sottoscrizioni per i clienti specificati.
- La cartella di input include due cartelle annidate, migrazioni e sottoscrizioni.
- Non posizionare customers.csv nelle cartelle nidificate. Conservarlo nella cartella di input .

Per esportare sottoscrizioni con idoneità alla migrazione, seguire questa procedura:

Eseguire lo strumento BAM e immettere il comando 2.

Lo strumento viene eseguito e indica che le sottoscrizioni vengono convalidate per l'idoneità. Al termine dell'esportazione, l'elenco delle sottoscrizioni per i clienti specificati è disponibile nella cartella di output come subscriptions.csv, che fornisce un elenco di tutte le sottoscrizioni legacy (attive e sospese) per i clienti specificati in precedenza.

Per ogni sottoscrizione è possibile visualizzare i campi seguenti:

Partner tenant ID
PartnerID rivenditore indiretto
Nome cliente
ID tenant del cliente
ID sottoscrizione legacy
Nome sottoscrizione legacy
Nome prodotto legacy
Data di scadenza
Migrazione idonea (True o False)
Termine corrente
Piano di fatturazione corrente
Conteggio dei posti corrente
Avvia nuovo termine (dopo la migrazione in NCE)
Termine (post-migrazione in NCE)
Piano di fatturazione (post-migrazione in NCE)
Seat Count (post-migrazione in NCE)
Aggiungi su (True o False)
Sottoscrizione di base (se un componente aggiuntivo)
Motivo dell'impossibilità della migrazione (se la sottoscrizione non è idonea per la migrazione)

Determinare le sottoscrizioni di cui verrà eseguita la migrazione e come eseguire la migrazione

Usando i campi precedenti, è possibile filtrare l'elenco esportato di sottoscrizioni per determinare quali sottoscrizioni eseguire la migrazione a NCE in un batch. Ad esempio, è possibile filtrare per eseguire la migrazione di un batch di sottoscrizioni di un determinato tipo di prodotto o di un batch di sottoscrizioni in un particolare rivenditore indiretto.

Dopo aver filtrato e selezionato le sottoscrizioni, eliminare tutte le sottoscrizioni non selezionate per il batch dal file .csv. In questo modo si evitano migrazioni impreviste.

È consigliabile esportare non più di 200 sottoscrizioni per batch. (Vedere Eseguire la migrazione di più di 200 sottoscrizioni più avanti in questo articolo se è necessario eseguire la migrazione di più.

Il passaggio successivo consiste nel specificare il modo in cui eseguire la migrazione delle sottoscrizioni( ad esempio, simili a simili o con nuovi attributi di inizio nuovo termine, frequenza di fatturazione, durata del termine o numero di postazioni).

È possibile sovrascrivere i campi seguenti nelle righe per le sottoscrizioni di cui si vuole eseguire la migrazione:

Avvia nuovo termine
Termine
Piano di fatturazione
Conteggio postazioni

I campi precedenti rappresentano le istruzioni o gli attributi che la sottoscrizione NCE rispetterà dopo la migrazione. I valori predefiniti per questi campi sono i valori delle sottoscrizioni legacy di cui viene eseguita la migrazione. Se non vengono apportate modifiche a un campo, la sottoscrizione NCE corrispondente ha lo stesso valore della sottoscrizione legacy da cui è stata eseguita la migrazione. Ad esempio, se una sottoscrizione legacy di cui viene eseguita la migrazione ha un numero corrente di due postazioni e non vengono apportate modifiche al campo Seat Count , la sottoscrizione NCE avrà un numero di postazioni pari a due dopo la migrazione.

Per avviare una sottoscrizione con un nuovo termine in NCE, usare il passaggio seguente:

Modificare il flag Start New Term da FALSE a TRUE.

Non modificare i valori all'esterno delle colonne seguenti:
- Avvia nuovo termine
- Termine
- Piano di fatturazione
- Conteggio postazioni

Caricare un batch per la migrazione

Dopo aver specificato come eseguire la migrazione di un batch, ovvero dopo aver filtrato le sottoscrizioni per la migrazione e aver aggiornato i valori NCE, se necessario, salvare il file di subscriptions.csv aggiornato nella cartella delle sottoscrizioni annidata nella cartella di input. Ogni file salvato nella cartella sottoscrizioni rappresenta un batch di cui eseguire la migrazione.

Dopo l'elaborazione di un file dalla cartella delle sottoscrizioni per la migrazione, lo strumento BAM sposta il file nella cartella elaborata annidata, a indicare che sono state eseguite le richieste di migrazione per tale batch. Non è necessario spostare manualmente i file nella cartella elaborata . I file nella cartella elaborata non vengono letti dallo strumento BAM per eseguire la migrazione perché sono già stati elaborati.

Per caricare le migrazioni, usare il passaggio seguente:

Al prompt dei comandi eseguire lo strumento BAM e selezionare l'opzione 3, caricare le migrazioni, dopo di che:
- Lo strumento BAM legge i file batch dalla cartella delle sottoscrizioni ed esegue le richieste di migrazione.
- La finestra della console indica che le richieste di migrazione vengono elaborate.
  
  Un file per ogni batch contenente gli ID di migrazione viene esportato ed è disponibile nella cartella delle migrazioni annidata nella cartella di output .
  - I file esportati vengono etichettati [batchID].csv.
  - [batchID].csv ha gli stessi campi del file di input subscriptions.csv, ma con altre due colonne: ID batch e ID migrazione.
  - L'ID batch è lo stesso per ogni sottoscrizione nel file, a indicare che queste sottoscrizioni appartengono allo stesso batch o allo stesso set di richieste di migrazione elaborate insieme.
  - L'ID batch si riflette anche nel nome del file di .csv: [batchID].csv.

Verificare lo stato della migrazione

Se una migrazione ha esito positivo, lo stato della migrazione è Completato.

Se una migrazione non riesce, lo stato della migrazione è Non riuscito ed è possibile visualizzare il motivo dell'errore.

Un ID migrazione è univoco per ogni sottoscrizione di cui viene eseguita la migrazione, quindi è possibile usare l'ID migrazione per tenere traccia dello stato della migrazione.

Al termine della migrazione, viene popolato anche un ID sottoscrizione NCE.

Per recuperare un file di stato aggiornato per un batch, usare il passaggio seguente:

Copiare o salvare il file [batchID].csv esportato nella cartella migrations annidata nell'output, nella cartella delle migrazioni (annidata nella cartella di input).

In questo modo, lo strumento consente di leggere lo stato dei batch richiesti e di preparare i report per l'esportazione.

I file di stato non vengono aggiornati automaticamente. Per recuperare gli stati aggiornati, è necessario effettuare ogni volta una nuova richiesta.

Per recuperare gli stati di migrazione aggiornati, usare il passaggio seguente:

Eseguire lo strumento BAM e immettere il comando 4.

Lo strumento BAM viene eseguito e indica che sta cercando lo stato della migrazione e che un file è stato esportato nella cartella migrationstatus . I nomi dei file di stato della migrazione esportati rappresentano l'ID batch delle sottoscrizioni contenute nei volumi condivisi cluster.

Il file [batchID].csv esportato nella cartella migrationstatus fornisce gli stati aggiornati per le richieste di migrazione elaborate. Se nel file sono rappresentati più batch, usare la colonna ID batch per filtrare gli stati delle richieste in un determinato batch.

Esportare un elenco di nuove sottoscrizioni dell'esperienza commerciale

Per esportare le sottoscrizioni NCE, usare il passaggio seguente:

Eseguire lo strumento BAM e immettere il comando 5.

L'elenco esportato viene salvato nella cartella di output . Questo passaggio non è necessario per la migrazione, ma è possibile usarlo per organizzare le sottoscrizioni NCE per clienti diversi.

Eseguire la migrazione di più di 200 sottoscrizioni

Se si vuole eseguire la migrazione di più di 200 sottoscrizioni (ovvero le dimensioni massime consigliate per il batch), è possibile caricare più batch nello strumento BAM. È possibile organizzare le cartelle in base a vari campi per ridurre le dimensioni dei file di cui si vuole eseguire la migrazione. Ad esempio, è possibile organizzare le sottoscrizioni di cui eseguire la migrazione:

Rivenditore indiretto
Nome prodotto
Nome della sottoscrizione
Altri criteri

Se un file batch organizzato supera le dimensioni massime consigliate di 200 sottoscrizioni, è possibile separare un .csv in più copiando in modo efficace le sottoscrizioni in nuovi file per mantenere il massimo di 200 sottoscrizioni di ogni batch. Ad esempio, se si vuole eseguire la migrazione di 425 sottoscrizioni, è possibile suddividerle in tre file separati (due file che contengono 200 sottoscrizioni e un altro con 25).

Caricare più file

È possibile caricare più file nello strumento BAM contemporaneamente. Lo strumento legge le richieste di migrazione di un file batch alla volta e inizia automaticamente la lettura in altri file batch salvati nella directory di input (se sono stati aggiunti più batch).

Lo strumento BAM legge i batch uno per uno e chiama singolarmente l'API Crea migrazione in ogni sottoscrizione.

Non è necessario attendere il completamento dell'esecuzione di un file batch per aggiungere altri file batch alla directory di input.

Limiti di velocità e limitazione

Per eseguire il comando 2 (recupero delle sottoscrizioni per i clienti e convalida di tali sottoscrizioni per la migrazione), lo strumento BAM chiama l'API Convalida migrazione . Il limite di frequenza dell'API Convalida migrazione è di 450 chiamate per ogni partner e combinazione di clienti in cinque minuti. Con questo limite di velocità e la latenza corrente dell'API Convalida migrazione , non si prevede che si verifichino limitazioni quando si esegue lo strumento BAM. Inoltre, lo strumento presenta limiti di concorrenza per garantire che la limitazione non si verifichi.

Tuttavia, se si verifica un problema, è possibile tenere traccia delle sottoscrizioni del cliente non estratte e convalidate. Se non è possibile eseguire il pull delle sottoscrizioni di un cliente o se si verificano problemi durante la convalida delle sottoscrizioni, nella cartella di output dello strumento viene visualizzata una .csv separata intitolata failedCustomers.csv . È possibile riprovare a eseguire il pull e la convalida delle sottoscrizioni per tali clienti.