Preparar el desarrollo de Dynamics 365 Finance and Operations requiere coordinar el equipo local, las herramientas de Visual Studio y el ambiente cloud. d365bap.tools puede complementar este trabajo con PowerShell, siempre que sus comandos se evalúen junto con la documentación oficial y los permisos del ambiente.
Qué aporta d365bap.tools
Es un módulo comunitario del proyecto d365collaborative para tareas de administración de D365FO y Dataverse. Su repositorio recomienda PowerShell 7, advierte que no todos los comandos funcionan en Windows PowerShell 5.1 y proporciona ayuda por función. Se distribuye bajo licencia MIT. No es una herramienta oficial de Microsoft ni reemplaza los requisitos de la plataforma.
Separar ambiente y estación de trabajo
La experiencia unificada permite desarrollar código y mantener metadata en el equipo local, mientras la ejecución ocurre en un servicio cloud. Por tanto, instalar un módulo PowerShell no equivale a dejar preparado todo el entorno ni garantiza que un sandbox tenga habilitadas las herramientas de desarrollo.
El tutorial oficial de desarrollo, despliegue y depuración X++ explica esta separación y permite validar el recorrido completo.
Preparar las herramientas oficiales
La guía de Microsoft para instalar y configurar las herramientas debe aplicarse según la versión del ambiente. Su secuencia comprende instalar los componentes de Visual Studio, incorporar Power Platform Tools, conectar al entorno Dataverse y descargar la extensión de Finance and Operations y el metadata.
La configuración automática puede extraer el metadata y preparar su configuración. Revise la ventana Output para identificar acciones pendientes. Si se realiza la configuración manual, deben definirse las rutas de metadata propio y de referencia, así como la base de referencias cruzadas. Microsoft permite varias configuraciones, con una activa a la vez.
Instalar y explorar el módulo
El siguiente bloque instala el módulo para el usuario actual, lo importa y muestra su versión y ayuda. No crea ambientes ni ejecuta despliegues. La instalación sí modifica el equipo y puede solicitar confirmación del repositorio y sus dependencias.
Install-Module -Name d365bap.tools -Scope CurrentUser
Import-Module d365bap.tools
Get-Module d365bap.tools | Select-Object Name, Version
Get-Command -Module d365bap.tools
Get-Help Get-BapEnvironment -Full
Get-Help Get-BapEnvironment -ExamplesAntes de estandarizar esta instalación, seleccione y pruebe una versión concreta. Registre también las dependencias para que otro desarrollador pueda reproducir el resultado. Repositorio, instalación y ejemplos del módulo.
Autenticación y destino explícito
El proyecto utiliza autenticación de Azure para obtener tokens OAuth. Su README documenta el inicio de sesión con usuario o principal de servicio. Para una primera prueba interactiva, reemplace el marcador por el identificador de su tenant:
Login-AzAccount -TenantId "<GUID-TENANT>"Autenticarse no concede permisos adicionales. Consulte la ayuda de la versión instalada antes de ejecutar una función sobre un ambiente. No presuponga que todas las operaciones aceptan las mismas identidades o requieren los mismos roles.
Validación propuesta antes de usarlo en un proyecto
- Confirmar el tenant, el ambiente habilitado para desarrollo y la identidad utilizada.
- Registrar versiones de plataforma, Visual Studio, extensiones y módulo PowerShell.
- Comprobar que Application Explorer muestra el metadata esperado y que la configuración activa corresponde al destino.
- Crear una prueba X++ pequeña siguiendo el tutorial oficial, compilarla y desplegarla en el ambiente de desarrollo.
- Validar ejecución y depuración, conservando los logs de compilación y despliegue.
- Repetir el procedimiento con un segundo equipo para detectar pasos manuales no documentados.
Estos son criterios de aceptación propuestos; no representan pruebas ejecutadas como parte de este artículo. Un procedimiento reproducible debe dejar evidencia tanto de los éxitos como de los fallos y sus condiciones.
Seguridad, licencias y mantenimiento
Evite secretos en scripts y repositorios, limite el acceso a logs y utilice datos sintéticos cuando sea posible. La licencia del módulo no sustituye los derechos de uso de Dynamics 365, Visual Studio ni los requisitos de capacidad del ambiente. Tampoco debe interpretarse como una garantía de soporte de Microsoft para el código comunitario.
Antes de incorporar funciones de aprovisionamiento, copia o despliegue, revise su implementación, parámetros y efectos en la versión seleccionada. No ejecute cambios administrativos solamente porque una conexión de lectura haya funcionado.
Referencia de origen y alcance de esta revisión
El tema parte del artículo Setting Up D365FO Dev Environment con d365bap.tools, de Mehrdad Ghazvinizadeh. Su contenido completo y fecha no pudieron verificarse durante esta revisión. Esta entrada desarrolla una guía independiente con el repositorio y Microsoft Learn; no reproduce ni valida íntegramente el procedimiento de LinkedIn.
Recomendación: probar el módulo como complemento de la preparación oficial y documentar una versión reproducible. La automatización completa del entorno queda pendiente de verificar los comandos específicos y superar la prueba de compilación, despliegue y depuración.