Cómo implementar un ensamblado de BizTalk desde Visual Studio

  • Artículo

En este tema se proporcionan instrucciones sobre cómo usar Visual Studio Explorador de soluciones o el símbolo del sistema de Visual Studio para implementar los ensamblados de BizTalk desde Visual Studio en una aplicación de BizTalk. Aunque se pueda implementar un solo ensamblado desde el nivel de proyecto (haciendo clic con el botón secundario en el proyecto y haciendo clic en Implementar) o implementar todos los ensamblados en la solución al mismo tiempo desde el nivel de solución (haciendo clic con el botón secundario en la solución y haciendo clic en Implementar), recomendamos encarecidamente que se implementen todos al mismo tiempo desde el nivel de solución.

En versiones anteriores de BizTalk Server, si se querían implementar varios ensamblados en una solución y alguno de ellos tenía una dependencia en cualquiera de los demás ensamblados, había que implementar individualmente los ensamblados en orden inverso a sus dependencias. Por ejemplo, si Ensamblado1 tenía una dependencia en Ensamblado2, había que implementar primero el Ensamblado 2 y, a continuación, el Ensamblado1.

Esto sigue siendo así al implementar ensamblados desde el nivel de proyecto. Sin embargo, con BizTalk Server, al implementar ensamblados desde el nivel de solución en lugar del nivel de proyecto, BizTalk Server se encarga automáticamente de todos los pasos de implementación, incluida la implementación de ensamblados en el orden correcto. Por lo tanto, para simplificar la implementación, cuando otro ensamblado tenga una dependencia en el ensamblado que se esté implementando, se deberán implementar los ensamblados en el nivel de solución.

Al seleccionar la opción para implementar un proyecto o una solución desde Visual Studio, el ensamblado o ensamblados se crean e implementan automáticamente en la aplicación de BizTalk especificada en el grupo local de BizTalk. Si la aplicación aún no existe en el grupo, la implementación también crea la aplicación. Los ensamblados y los artefactos que contienen se registran y sus datos se guardan en la base de datos de administración (de configuración) de BizTalk correspondiente al grupo de BizTalk. Además, si se especifica esta opción en las propiedades de implementación del proyecto, los ensamblados se agregan a la caché de ensamblados global (GAC).

Un "artefacto" es cualquier elemento de una aplicación de BizTalk, incluidos los recursos con los que se trabaja en Visual Studio, como ensamblados y orquestaciones, así como otros elementos que se crean o se agregan posteriormente después de implementar la aplicación, como puertos de envío y recepción, certificados y secuencias de comandos. Una vez implementado el ensamblado, se pueden ver y administrar sus artefactos en el nodo Aplicaciones de la consola de administración de BizTalk Server. Cada aplicación se almacena en su propia carpeta, con subcarpetas que muestran los artefactos de la aplicación. Para obtener más información, consulte Uso de la consola de administración de BizTalk Server. Para obtener más información sobre cómo crear y administrar aplicaciones, vea Implementar y administrar aplicaciones de BizTalk.

Antes de implementar un ensamblado, hay que llevar a cabo los pasos siguientes:

Importante

No se deben realizar las tareas que se describen en este tema en un equipo de producción. Durante el proceso de desarrollo, el programador suele volver a implementar ensamblados desde Visual Studio. Para que esto último sea posible, Visual Studio debe anular la implementación, separar, detener y dar de baja artefactos que existan en la misma aplicación o en aplicaciones distintas. Aunque esto resulta necesario y apropiado en un entorno de desarrollo, puede producir consecuencias inesperadas no deseadas en un entorno de producción. Además, para evitar la posibilidad de que alguien intente implementar un ensamblado desde Visual Studio en un equipo de producción, se recomienda que no instale Visual Studio en un equipo de producción.

Nota

 La directiva de seguridad en tiempo de ejecución de .NET Framework impide de forma predeterminada la implementación de ensamblados desde un recurso compartido de red. Si intenta implementar un ensamblado desde un recurso compartido de red y tiene dificultades, consulte el administrador de seguridad de .NET Framework o consulte "Administración de directivas de seguridad" en la colección combinada de Visual Studio.

Requisitos previos

Para realizar los procedimientos descritos en este tema, deberá iniciar sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Si, en Propiedades de implementación , ha habilitado la opción de instalar un ensamblado en la caché global de ensamblados (GAC), también necesita permisos de lectura y escritura en la GAC. La cuenta de administradores del equipo local cuenta con este permiso. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.

Para implementar un ensamblado o ensamblados de BizTalk

Mediante el Explorador de soluciones de Visual Studio

  • En Visual Studio Explorador de soluciones, haga clic con el botón derecho en un proyecto o solución de BizTalk y, a continuación, haga clic en Implementar.

    El ensamblado del proyecto o los ensamblados de la solución se implementan en la aplicación de BizTalk especificada. El estado del proceso de generación e implementación se muestra en la esquina inferior izquierda de la página.

Mediante el símbolo del sistema de Visual Studio

  1. Inicie el símbolo del sistema de Visual Studio.

  2. Escriba el siguiente comando, sustituyendo los valores según corresponda, como se describe en la tabla que se presenta a continuación:

    devenv /deploySolnConfigNameSolutionName [/projectProjName] [/projectconfigProjConfigName]

    Ejemplo:

    devenv /deploy Release "C:\Documents and Settings\someuser\My Documents\Visual Studio\Projects\MySolution\MySolution.sln" /project "MyBizTalkApp\MyBizTalkApp.csproj" projectconfig Release

    Parámetro Value
    /Implementar Implementa una solución después de una compilación o recompilación.
    SolnConfigName Nombre de la configuración de la solución que se utilizará para generar la solución nombrada en NombreSolución.
    SolutionName Ruta completa y nombre del archivo de solución.
    /projectProjName Ruta y nombre del archivo del proyecto dentro de la solución. Puede especificar una ruta relativa desde la carpeta NombreSolución al archivo del proyecto, el nombre para mostrar del proyecto o la ruta completa y el nombre del archivo del proyecto.
    /projectconfigProjConfigName Nombre de la configuración de generación de un proyecto que se va a utilizar al generar el proyecto.

    Es posible que la primera vez que implemente un ensamblado que contenga una orquestación reciba un mensaje de advertencia que le indique que el archivo de enlace no contiene la orquestación. Ello se debe a que las orquestaciones no se enlazan automáticamente al host en el momento de la implementación. Deberá realizar este paso manualmente.

Consulte también

Implementación de ensamblados de BizTalk en una aplicación de BizTalk desde Visual Studio