Migración de suscripciones a una nueva experiencia comercial mediante la herramienta de migración por lotes (BAM)

Artículo
10/23/2023

Puede migrar eficazmente un gran número de suscripciones a la nueva experiencia comercial (NCE) mediante la herramienta de migración por lotes (BAM).

(También puede migrar lotes de suscripciones mediante la API de migración desde la versión 3.0.1 del SDK de .NET).

Importante

A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

Se recomienda a los partners seguir usando las API REST del Centro de partners.

La herramienta BAM:

Admite migraciones por lotes personalizables, repetibles y de alta calidad.
Usa Excel para administrar las modificaciones de migración
No requiere código
Se puede descargar mediante el código de ejemplo en GitHub.

Funcionalidades de la herramienta de migración por lotes

Con la herramienta BAM, puede hacer lo siguiente:

Recupere una lista de todos los clientes de un inquilino.
Recupere las suscripciones heredadas del cliente en un archivo .csv.
Prepare el archivo .csv exportado para la migración y edite suscripciones (como cambios en el número de puestos, el período y el ciclo de facturación) durante la migración.
Cargue un archivo .csv de suscripción actualizado en la herramienta, después del cual la herramienta ejecuta las solicitudes de migración.
Revisar el estado de las solicitudes de migración.
Descargue todas las suscripciones de NCE para toda la lista de clientes en el archivo de entrada.

Requisitos previos

Es necesario el SDK para .NET 6.0 para usar la herramienta BAM.

SDK y código de ejemplo

Para más información y recursos relacionados con las versiones del SDK y el código de aplicación de ejemplo que puede usar para acceder a la herramienta BAM:

Uso de la herramienta BAM

Nota:

Para obtener instrucciones detalladas, consulte Flujo paso a paso de la migración de un lote.

Para cargar las opciones de flujo de trabajo para la migración por lotes, siga estos pasos:

Ejecute la herramienta BAM y, en el símbolo del sistema, escriba ncebulkmigration [app ID] {UPN ID].

Entre las acciones que puede realizar en esta fase se encuentran las siguientes:

Exporte una lista de clientes.
Exporte suscripciones heredadas con elegibilidad de migración.
Cargar las suscripciones que se van a migrar.
Exportar el estado de migración de los lotes que ya se han cargado para la migración.
Exporte una lista de nuevas suscripciones de experiencia comercial.

Autenticación de cuenta

La herramienta BAM no está configurada para aplicaciones multiinquilino. Al completar la autenticación, use el AppID de una aplicación con configuración de inquilino único.

Microsoft está evaluando las opciones para habilitar la migración por lotes para aplicaciones multiinquilino.

Exportación de una lista de clientes

Para exportar una lista de clientes, siga estos pasos:

Ejecute la herramienta BAM y escriba el comando 1.

La lista exportada de clientes se guarda en el archivo de salida de las carpetas de la herramienta BAM.

Consulte los clientes exportados en el archivo customers.csv.

Para cada cliente en un identificador de inquilino de asociado, puede ver:

Id. de inquilino de cliente
Dominio del cliente
Nombre de la empresa del cliente

Acceso a las suscripciones de clientes seleccionados

Puede quitar filas de clientes del archivo customers.csv descargado cuyas suscripciones no desea exportar en la siguiente descarga de archivos. Los clientes que permanecen en el archivo se validan para la elegibilidad de la migración durante el siguiente paso en el flujo de trabajo de la herramienta BAM.

Guarde el archivo customers.csv actualizado en la carpeta de entrada para poder ejecutar el paso siguiente de recibir suscripciones para los clientes especificados.
- La carpeta input tiene dos carpetas anidadas, migrations y subscriptions.
- No coloque customers.csv en las carpetas anidadas. Manténgalo en la carpeta de entrada .

Para exportar suscripciones con elegibilidad para la migración, siga estos pasos:

Ejecute la herramienta BAM y escriba el comando 2.

La herramienta se ejecuta e indica que las suscripciones se están validando para la idoneidad. Una vez completada la exportación, la lista de suscripciones para los clientes especificados está disponible en la carpeta de salida como subscriptions.csv, que proporciona una lista de todas las suscripciones heredadas (activas y suspendidas) para los clientes especificados anteriormente.

Se pueden ver los campos siguientes para cada suscripción:

Identificador del inquilino del partner
PartnerID de revendedor indirecto
Nombre del cliente
Identificador de inquilino de cliente
Identificador de la suscripción heredada
Nombre de la suscripción heredada
Nombre de producto heredado
Fecha de expiración
Migración elegible (True o False)
Plazo actual
Plan de facturación actual
Número actual de puestos
Iniciar nuevo plazo (después de la migración en NCE)
Plazo (después de la migración en NCE)
Plan de facturación (después de la migración en NCE)
Número de puestos (después de la migración en NCE)
Complemento (True o False)
Suscripción base (si es un complemento)
Motivo de la no elegibilidad de la migración (si la suscripción no es elegible para la migración)

Determinar qué suscripciones se van a migrar y cómo

Con los campos anteriores, puede filtrar la lista exportada de suscripciones para determinar qué suscripciones desea migrar a NCE en un lote. Por ejemplo, puede filtrar para migrar un lote de suscripciones de un tipo de producto determinado o un lote de suscripciones en un revendedor indirecto determinado.

Después de filtrar y seleccionar suscripciones, elimine las suscripciones que no estén seleccionadas para el lote del archivo .csv. Si lo hace, se evitan migraciones no deseadas.

Se recomienda exportar no más de 200 suscripciones por lote. (Consulte Migre más de 200 suscripciones más adelante en este artículo si necesita migrar más).

El siguiente paso consiste en especificar cómo se van a migrar las suscripciones (por ejemplo, tal cual están o con los atributos iniciar nuevo plazo, frecuencia de facturación, duración del plazo o número de puestos actualizados).

Puede sobrescribir los siguientes campos en las filas de las suscripciones que desea migrar:

Iniciar nuevo plazo
Término
Plan de facturación
Número de puestos

Los campos anteriores representan las instrucciones o atributos que cumplirá la suscripción de NCE después de la migración. Los valores predeterminados de estos campos son los valores de las suscripciones heredadas que se van a migrar. Si no se realizan cambios en un campo, la suscripción de NCE correspondiente tiene el mismo valor que la suscripción heredada desde la que migró. Por ejemplo, si una suscripción heredada que se va a migrar tiene un número de puestos actual de dos y no se realizan cambios en el campo Recuento de puestos, la suscripción de NCE tendrá un recuento de puestos de dos después de la migración.

Para iniciar una suscripción con un nuevo término en NCE, use el paso siguiente:

Cambie la marca Iniciar nuevo término de FALSE a TRUE.

No cambie los valores fuera de las columnas siguientes:
- Iniciar nuevo plazo
- Término
- Plan de facturación
- Número de puestos

Carga de un lote para la migración

Después de especificar cómo se va a migrar un lote (es decir, después de filtrar las suscripciones para la migración y de haber actualizado los valores NCE, si lo desea), guarde el archivo subscriptions.csv actualizado en la carpeta subscriptions que está anidada en la carpeta de entrada. Cada archivo guardado en la carpeta subscriptions representa un lote que se va a migrar.

Después de procesar un archivo de la carpeta subscriptions para la migración, la herramienta BAM mueve ese archivo a la carpeta anidada processed, lo que indica que se han ejecutado solicitudes de migración para ese lote. No es necesario mover manualmente los archivos a la carpeta processed. La herramienta BAM no lee los archivos de la carpeta processed para ejecutar la migración porque ya se han procesado.

Para cargar migraciones, use el paso siguiente:

En el símbolo del sistema, ejecute la herramienta BAM y seleccione la opción 3, cargue migraciones, después de lo cual:
- La herramienta BAM lee los archivos por lotes de la carpeta suscripciones y ejecuta solicitudes de migración.
- La ventana de consola indica que se están procesando las solicitudes de migración.
  
  Se exporta un archivo para cada lote que contiene los identificadores de migración y está disponible en la carpeta migrations que está anidada en la carpeta de salida .
  - Los archivos exportados se etiquetan como [IdentificadorDeLote].csv.
  - El archivo [IdentificadorDeLote].csv tiene los mismos campos que el archivo subscriptions.csv de entrada, pero con dos columnas más para el identificador de lote y el identificador de migración.
  - El identificador de lote es el mismo para todas las suscripciones del archivo, lo que indica que estas suscripciones pertenecen al mismo lote o conjunto de solicitudes de migración que se procesaron conjuntamente.
  - El identificador de Lote también se refleja en el nombre del archivo .csv: [batchID].csv.

Comprobar el estado de la migración

Si una migración se realiza correctamente, su estado de migración es Completado.

Si una migración no se realiza correctamente, su estado de migración es Error y puede ver el motivo del error.

Un identificador de migración es único para cada suscripción que se migra, por lo que puede usar el identificador de migración para realizar un seguimiento del estado de la migración.

También se rellena el identificador de suscripción de NCE después de una migración correcta.

Para recuperar un archivo de estado actualizado para un lote, use el paso siguiente:

Copie o guarde el archivo [batchID].csv exportado (que se exporta a la carpeta de migraciones anidada en la salida) a la carpeta de migraciones (que está anidada en la carpeta de entrada).

Al hacerlo, se permite a la herramienta leer el estado de los lotes que se han solicitado y preparar los informes para exportarlos.

Los archivos de estado no se actualizan automáticamente. Para recuperar los estados actualizados, se debe realizar una nueva solicitud cada vez.

Para recuperar los estados de migración actualizados, use el paso siguiente:

Ejecute la herramienta BAM y escriba el comando 4.

La herramienta BAM se ejecuta e indica que busca el estado de migración y que se ha exportado un archivo a la carpeta migrationstatus . Los nombres de los archivos de estado de migración exportados representan el identificador de lote de las suscripciones contenidas en los archivos CSV.

El archivo [IdentificadorDeLote].csv exportado a la carpeta migrationstatus proporciona los estados actualizados de las solicitudes de migración que se han procesado. Si se representa más de un lote en el archivo, use la columna del identificador de lote para filtrar y acceder a los estados de las solicitudes de un lote determinado.

Exportación de una lista de nuevas suscripciones de experiencia comercial

Para exportar suscripciones de NCE, use el paso siguiente:

Ejecute la herramienta BAM y escriba el comando 5.

La lista exportada se guarda en la carpeta output. Este paso no es necesario para la migración, pero puede usarlo para organizar suscripciones de NCE de distintos clientes.

Migración de más de 200 suscripciones

Si desea migrar más de 200 suscripciones (que es el tamaño máximo de lote recomendado), puede cargar varios lotes en la herramienta BAM. Puede organizar carpetas por varios campos para reducir el tamaño de los archivos que desea cargar para migrar. Por ejemplo, puede organizar las suscripciones que se van a migrar mediante:

Revendedor indirecto
Nombre de producto
Nombre de suscripción
Otros criterios

Si un archivo por lotes que ha organizado supera el tamaño máximo recomendado de 200 suscripciones, puede separar uno .csv en varios copiando de forma eficaz sobre suscripciones a nuevos archivos para mantener el máximo de 200 suscripciones máximo de cada lote. Por ejemplo, si desea migrar 425 suscripciones, puede dividirlas en tres archivos independientes (dos archivos que contienen 200 suscripciones y otro que tenga 25).

Carga de varios archivos

Puede cargar varios archivos en la herramienta BAM a la vez. La herramienta lee las solicitudes de migración de un archivo por lotes a la vez y comienza automáticamente a leer en otros archivos por lotes guardados en el directorio de entrada (si se han agregado varios lotes).

La herramienta BAM lee lotes uno a uno y llama a create migration API en cada suscripción individualmente.

No es necesario esperar a que un archivo por lotes termine de ejecutarse para agregar más archivos por lotes al directorio de entrada.

Limitación de velocidad

Para ejecutar el comando 2 (recuperar las suscripciones de los clientes y validar esas suscripciones para su migración), la herramienta BAM llama a la API Validar migración. El límite de velocidad de la API Validar migración es de 450 llamadas por cada combinación de partner y cliente en cinco minutos. Con este límite de velocidad y la latencia actual de la API Validar migración, no se prevé que vaya a experimentar una limitación al ejecutar la herramienta BAM. Además, la herramienta tiene límites de simultaneidad para asegurarse de que no se produzca la limitación.

Sin embargo, si se produce un problema, puede realizar un seguimiento de las suscripciones de los clientes que no se han extraído y validado. Si no se pueden extraer las suscripciones de un cliente o si hay problemas al validar suscripciones, aparece un archivo .csv independiente titulado failedCustomers.csv en la carpeta de salida de la herramienta. Puede volver a intentar extraer y validar suscripciones para esos clientes de nuevo.