Compartir a través de

Instalar y configurar herramientas de desarrollo

Este artículo describe cómo instalar y configurar los requisitos de herramientas financieras y operativas de Visual Studio en su entorno de desarrollo local. Las instrucciones de cada sección deben seguirse en el orden presentado en este artículo.

Importante

Puede obtener más información viendo la presentación y las demostraciones de la serie Dynamics 365 FastTrack Tech Talk

Experiencia de desarrollo unificada para finanzas y operaciones | Charla técnica Dynamics 365 FastTrack

Requisitos previos

  • Como requisito previo, necesita acceso a un entorno sandbox aprovisionado y centrado en el desarrollador.
  • A la cuenta de usuario que utilizará para el desarrollo en el entorno sandbox se le debe asignar el rol Sistema Administrador.
  • La máquina de desarrollo debe tener al menos 16 GB de espacio libre en la unidad del sistema local para descargar la extensión y los metadatos.
  • La máquina de desarrollo que ejecuta Microsoft Windows 10 u 11 deben tener Visual Studio 2022 instalado con al menos la carga de trabajo de desarrollo de escritorio .NET, el SDK de modelado y algunos componentes más.
  • Este SDK y otros componentes se pueden seleccionar e instalar desde el panel de componentes individuales en el instalador de Visual Studio. Consulte los componentes de Visual Studio necesarios.
  • Microsoft SQL Server Express LocalDB se instala de forma predeterminada con Visual Studio 2022, y debería validar que puede conectarse al mismo con autenticación de Windows.

Instalar la extensión de Power Platform para Visual Studio

Siga las instrucciones de este artículo para instalar la extensión desde el mercado: Qué es Power Platform Tools para Visual Studio. No es necesario instalar el generador de perfiles del complemento como se indica en ese artículo.

Conectarse a su entorno en línea

Después de instalar la extensión Power Platform Tools para Visual Studio, siga estas instrucciones para conectar Visual Studio a su entorno unificado centrado en desarrolladores.

  1. Inicie Visual Studio si aún no se está ejecutando.

  2. En el menú Herramientas, seleccione Conectarse a Dataverse o Descargar activos de Dynamics 365 FinOps.

    • Conectar Dataverse solo descarga activos si no se descargaron antes.
    • Descargar Dynamics 365 Los activos de FinOps siempre se descargan.

  3. Seleccione las opciones que desee en el cuadro de diálogo y seleccione Iniciar sesión.

    Si necesita utilizar otra cuenta o un entorno en línea diferente, no elija utilizar el usuario que inició sesión. Introduzca las credenciales de su cuenta de usuario de desarrollador con acceso al entorno en línea.

  4. Seleccione una solución disponible en el cuadro de diálogo y luego elija Listo.

  5. Busque el entorno de espacio aislado creado para el desarrollo en línea en la lista de entornos de Dataverse y conéctese al mismo.

    Nota

    Si solo tiene un entorno de desarrollo en línea, es posible que el cuadro de diálogo de la lista de organizaciones no se muestre, ya que se conectaría automáticamente al entorno. Menú para conectarse al entorno unificado desde Visual Studio

    Cuadro de diálogo de inicio de sesión al conectarse a un entorno unificado desde Visual Studio con Mostrar avanzado seleccionado.

    Si su cuenta requiere autenticación de varios factores, desmarque todas las casillas de verificación en la pantalla de inicio de sesión.

    Si inicia sesión en un entorno de desarrollo en línea en un inquilino diferente al suyo, donde su nombre principal de usuario (UPN) se agrega como invitado, actualice Visual Studio>Herramientas>Opciones>Power Platform Tools y seleccione Omitir detección al conectarse a Dataverse y desmarque todas las casillas en el panel de inicio de sesión. Se le pedirá que proporcione la URI de Dataverse.

    Visual Studio> Tools> Opciones> Power Platform Tools para omitir detección

    Cuadro de diálogo de inicio de sesión al conectarse al entorno unificado desde Visual Studio

    Diálogo para obtener la URI de Dataverse para el entorno de desarrollo unificado.

Descargue e instale la extensión y los metadatos de finanzas y operaciones

Después de instalar la extensión de Power Platform Tools y conectarse al entorno de desarrollador unificado, se le presentará un cuadro de diálogo para descargar la extensión y los metadatos de Visual Studio de finanzas y operaciones.

Diálogo de descarga de extensiones y metadatos.

Importante

Puede configurar los ajustes utilizando la configuración de Visual Studio Herramientas>Opciones>Power Platform Tools.

La opción Configuración automática para Dynamics 365... está habilitada de forma predeterminada. Esto garantiza que no tendrá que extraer manualmente los metadatos del sistema ni crear la configuración de metadatos. La herramienta hará esto por usted. Investigue el panel de salida de Visual Studio para ver si el usuario necesita realizar alguna acción.

Considere seleccionar la opción No mostrar el Explorador de Power Platform... para acelerar la conexión a su entorno y Descargar registros... para obtener registros de implementación y operaciones de DBSync.

Considere deseleccionar la opción Configuración automática para Dynamics 365 si usa un entorno unificado para descargar solo los recursos y realizar la configuración manualmente.

Necesita al menos 16 GB de espacio libre en la unidad del sistema local para descargar la extensión y los metadatos.

Elija Aceptar en el cuadro de diálogo para iniciar la descarga. Visual Studio lo mantiene actualizado sobre el progreso en el panel de salida de Visual Studio.

Extraer metadatos del sistema

Nota

Esto no es necesario cuando la configuración automática está habilitada

Los recursos descargados se pueden encontrar en la siguiente ubicación:
C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>

Se descargan los siguientes archivos:

  • DYNAMICSXREFDB.bak es una copia de seguridad de la base de datos de referencia cruzada.
  • Microsoft.Dynamics.FinOps.ToolsVS2022.vsix Es la extensión de Finanzas y Operaciones.
  • PackagesLocalDirectory.zip son los metadatos del sistema.
  • TraceParser.msi Obtenga más información sobre Trace Parser.

Desbloquee cualquiera de los tres archivos que necesitan desbloquearse.

Desbloquear archivos de activos descargados

Desempaquete el archivo PackagesLocalDirectory.zip como PackagesLocalDirectory. Recomendamos utilizar la utilidad 7zip para acelerar la extracción.

Instalar la extensión de finanzas y operaciones

Nota

Esto solo es necesario cuando el panel de salida de Visual Studio lo indica.

Usando el Explorador de archivos de Windows, desde la carpeta C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>, abra el archivo Microsoft.Dynamics.FinOps.ToolsVS2022.vsix para instalar la extensión.

En el primer inicio de Visual Studio después de actualizar/instalar la extensión Microsoft.Dynamics.FinOps.ToolsVS2022 VS, se le solicitarán permisos elevados para que la extensión registre URLProtocoloHandler, configure objetivos de compilación y extraiga archivos del compilador, etc.

Configurar la extensión de finanzas y operaciones

Nota

Esto no es necesario cuando la configuración automática está habilitada. Si no ve la opción Configurar metadatos, abra Extensiones>Dynamics 365>Registro de información y vuelva a intentarlo.

Para configurar la extensión, siga estas instrucciones.

  1. Inicie Visual Studio y luego seleccione Continuar sin código en el cuadro de diálogo.

  2. Navegue a Extensiones>Dynamics 365>Configurar metadatos por primera vez.

    Configurar el menú de metadatos

  3. En el formulario de configuración, seleccione Nuevo y luego cree una nueva configuración. Consulte las descripciones de los campos proporcionadas en la tabla Descripciones de campos del formulario de configuración que sigue a este procedimiento.

    Cuadro de diálogo Configurar metadatos

  4. Seleccione Guardar.

  5. De manera similar, puede editar una configuración. Un campo común para actualizar es la carpeta de sus propios metadatos personalizados.

  6. Es posible que también desee mover su base de datos de referencia cruzada desde la base de datos local de SQL Server a SQL Server y actualizar la configuración

  7. Puede eliminar configuraciones obsoletas.

  8. Tenga en cuenta que solo una configuración puede estar actual o activa en un momento dado.

Descripciones de los campos del formulario de configuración

Campo de formulario Description
Name Nombre de la configuración que está creando ahora.
Description Descripción de la configuración que está creando ahora.
Servidor de base de datos de referencia cruzada Establezca en (localdb)\. si está usando LocalDB o localhost si está usando Microsoft SQL Server.
Nombre de base de datos de referencia cruzada El nombre de la base de datos de referencia cruzada. La extensión Visual Studio crea una si no existe.
Versión de la aplicación desde la que se restaurará la base de datos de referencia cruzada Seleccione esto. Se completa a partir de los recursos descargados cuando se conectó al entorno de desarrollador unificado.
Carpeta para sus propios metadatos personalizados Carpeta donde están (o estarán) sus propios módulos X++.
Carpetas para metadatos de referencia Debe contener al menos la ruta donde extrajo la carpeta PackagesLocalDirectory mencionada en Extraer metadatos del sistema. También donde agregaría carpetas que contienen otros módulos de referencia; por ejemplo, los recibidos de ISV.

Resolución de problemas de configuración

Si el botón Guardar aún aparece atenuado después de completar todos los campos, verá mensajes de error con un borde rojo en la información sobre herramientas de los campos con valores no válidos.

Configurar la validación de metadatos

Asegúrese de haber introducido los valores correctos para los campos con errores. Por ejemplo, use (localdb)\. si está usando LocalDB. Además, si está utilizando LocalDB, es posible que primero deba configurarlo y probarlo. Considere emitir el siguiente comando desde un símbolo del sistema:

sqllocaldb create MSSQLLocalDB -s.

Más información: SQL Server Express LocalDB.

Nota

Si la base de datos de referencia cruzada aún no existe, la herramienta restaurará la base de datos desde la copia de seguridad descargada en C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>. Verá notificaciones en el panel Salida de Visual Studio. Si necesita restaurarlo nuevamente usted mismo, puede hacerlo después de descargarlo con la configuración automática desactivada. Para obtener instrucciones sobre cómo restaurar una base de datos, consulte Restaurar a SQL Server.

Completar la configuración

Una vez creada la configuración tras una nueva instalación de la extensión, es posible que reciba un mensaje de elevación como administrador para registrar el manejador de protocolos y extraer los archivos del compilador. Continúe y acepte estas indicaciones.

Una vez que se complete la configuración, navegue hasta Ver>Explorador de aplicaciones . Debería ver la ventana Explorador de aplicaciones abierta. Quizás tenga que reiniciar Visual Studio primero.

Explorador de la aplicación

Puede crear varias configuraciones, pero debe seleccionar una para que esté actualizada. La configuración elegida tiene efecto en nuevas instancias de Visual Studio.

Resumen

Enhorabuena. Ahora está listo para crear, implementar, depurar y probar sus módulos X++ trabajando con el entorno de desarrollo en línea Power Platform. Explore las posibilidades con el poder de las finanzas y las operaciones integradas con Power Platform.

Pasos siguientes

Comience a escribir código, implementarlo y depurarlo.

Escribir, implementar y depurar código X++

Consulte también

Experiencia de desarrollador unificada para aplicaciones de finanzas y operaciones

  • Last updated on