Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se describe cómo usar la consola de administración de BizTalk Server o la línea de comandos importar una aplicación de BizTalk en un grupo de BizTalk. La importación de una aplicación de BizTalk registra los artefactos en la base de datos de administración de BizTalk y escribe los datos de los artefactos en las bases de datos de BizTalk adecuadas. Para obtener más información, consulte What Happens When Artifacts Are Imported(Qué sucede cuando se importan artefactos). La importación de una aplicación no instala la aplicación. Debe instalar una aplicación que incluya artefactos basados en archivos para poder ejecutarse.
Cuando usa la consola de administración de BizTalk Server para importar una aplicación, la ubicación desde la que inicia el Asistente para importar MSI determina si puede o no crear una nueva aplicación mientras importa los elementos. Si inicia el asistente haciendo clic con el botón derecho en el grupo de BizTalk, debe proporcionar un nombre de aplicación. Si una aplicación existente en el grupo de BizTalk tiene el nombre que especifique, los artefactos del archivo se importan en esta aplicación; De lo contrario, se crea una nueva aplicación que tiene el nombre especificado y los artefactos se importan en ella. Si inicia el asistente haciendo clic con el botón derecho en una aplicación, no puede especificar un nombre de aplicación y los artefactos se importan en la aplicación actual.
Cuando se usa la herramienta de línea de comandos BTSTask para importar un archivo .msi, proporcionar un nombre de aplicación es opcional. Si no proporciona un nombre, sus artefactos se importan en la aplicación predeterminada.
Después de importar los artefactos, puede verlos en la carpeta adecuada en la carpeta de la aplicación en la consola de administración de BizTalk Server. También puede ver una lista de artefactos en la aplicación mediante BTSTask, como se describe en ListApp Command.
Prerrequisitos
Para importar una aplicación de BizTalk, debe iniciar sesión con una cuenta que sea miembro del grupo Administradores de BizTalk Server. Para instalar una aplicación de BizTalk, también debe tener permisos de escritura en el sistema de archivos local. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.
Consideraciones para importar aplicaciones
Al importar una aplicación, se pueden aplicar las siguientes consideraciones:
Importar aplicaciones de versiones anteriores de BizTalk Server. Si va a importar aplicaciones desde BizTalk Server 2006 R2 o BizTalk Server 2009, y las aplicaciones contienen datos de entidad EDI/AS2, la importación de la aplicación podría producir un error porque el modelo de administración de socios comerciales ha cambiado considerablemente en BizTalk Server. En su lugar, debe usar la Herramienta de Migración de Entidades para migrar los datos de la entidad de versiones anteriores de BizTalk Server. Para obtener más información sobre la herramienta, consulte Utilidades de Migración EDI.
Los enlaces existentes siempre se sobrescriben mediante enlaces importados. Al importar un archivo .msi que contiene enlaces en una aplicación existente, los enlaces existentes se sobrescriben mediante enlaces importados que tienen el mismo nombre. Este es el caso incluso cuando no ha seleccionado la opción para sobrescribir artefactos existentes al importar el archivo .msi. Si no desea que los enlaces de la aplicación que exporte sobrescriban los enlaces de una aplicación en la que va a importar el archivo de .msi, no debe seleccionar el archivo de enlace como un recurso para exportar durante la operación de exportación. Para obtener más información, vea Cómo exportar una aplicación de BizTalk.
A medida que se aplican enlaces durante el proceso de importación, los enlaces que ya se han aplicado se sobrescriben mediante nuevos enlaces que tienen el mismo nombre. En otras palabras, la última asignación de un nombre determinado que se va a aplicar entra en vigor. Al importar una aplicación, los enlaces se aplican en el orden siguiente:
Enlaces de aplicación generados por BizTalk Server que no se agregaron explícitamente a la aplicación a través de un archivo de enlace, pero que el usuario seleccionó explícitamente para exportarlo al archivo .msi de la aplicación.
Los archivos vinculantes que se han agregado de manera explícita y que no tienen un entorno de implementación de destino especificado. Las vinculaciones de este conjunto se aplican en ningún orden específico.
Enlaces que se han agregado explícitamente y que tienen un entorno de implementación de destino asociado que coincide con el entorno de implementación seleccionado para la importación de la aplicación. Las vinculaciones de este conjunto se aplican en ningún orden específico.
El host debe existir en el grupo. Un host correspondiente al host especificado en los enlaces de aplicación contenidos en el archivo .msi ya debe existir en el grupo de BizTalk o se producirá un error en la operación de importación. Además, el nivel de confianza del host debe coincidir.
Es posible que tenga que agregar una referencia a otra aplicación. Si la aplicación que va a importar depende de un artefacto de otra aplicación, debe agregar una referencia a esta aplicación. La aplicación y el artefacto necesario ya deben existir en el grupo. El Asistente para importación proporciona esta opción. Sin embargo, si usa el comando ImportApp de BTSTask, debe agregar la referencia a la aplicación después de la importación, como se describe en Cómo agregar una referencia a otra aplicación. Para obtener información general, consulte Dependencias e implementación de aplicaciones. El Asistente para importación compara las referencias con las aplicaciones existentes en el grupo y le ofrece la opción de agregar una nueva referencia o cambiar una referencia existente. Debe realizar el paso adicional para comprobar que la aplicación a la que se hace referencia contiene el artefacto necesario.
Si una operación de importación agota el tiempo de espera, divida la aplicación en archivos .msi adicionales. Una operación de importación agotará el tiempo de espera si supera los 3600 segundos de duración. Si está intentando importar un archivo .msi y la operación agota el tiempo de espera, debe dividir el contenido de la aplicación en más de un archivo .msi mediante la reexportación de la aplicación y la selección de un subconjunto de artefactos que se van a exportar. Para obtener más información, vea Cómo exportar una aplicación de BizTalk.
Importante
Por motivos de seguridad, durante la exportación de aplicaciones, las contraseñas se quitan de los enlaces de aplicación. Sin embargo, no se quitan de los archivos vinculantes que se agregaron a la aplicación. Después de importar la aplicación, deberá volver a configurar las contraseñas para que funcione la aplicación. Para ello, edite el archivo de enlace o use la consola de administración. Para obtener más información sobre cómo editar un archivo de enlace, consulte Personalización de archivos de enlace. Para obtener más información sobre cómo configurar la seguridad de los adaptadores, consulte Uso de adaptadores.
Nota:
Si se produce un error en una importación, BizTalk Server revierte todas las operaciones de importación, excepto las acciones realizadas por scripts personalizados.
Nota:
Si crea un filtro para un puerto de envío en una aplicación que usa un esquema de propiedades en otra aplicación y, a continuación, importa la primera aplicación en un nuevo grupo de BizTalk, no recibirá una advertencia de que falta el esquema y el filtrado no funcionará cuando se instale e inicie la aplicación. Puede corregir el problema importando la aplicación que contiene el esquema antes de instalar la aplicación que no contiene el esquema.
Importación de una aplicación de BizTalk mediante la administración de BizTalk Server
Haga clic en Inicio, todos los programas, Microsoft BizTalk Server 20xx y, a continuación, haga clic en Administración de BizTalk Server.
En el árbol de consola, expanda Administración de BizTalk Server, expanda el grupo de BizTalk y haga una de las siguientes acciones:
Para importar la aplicación y los artefactos contenidos en el archivo .msi en el grupo de BizTalk, haga clic con el botón derecho en Aplicaciones, seleccione Importary, a continuación, haga clic en Archivo MSI.
Para importar los artefactos incluidos en el archivo .msi en una aplicación existente, expanda Aplicaciones, haga clic con el botón derecho en la aplicación, seleccione Importar y, a continuación, haga clic en Archivo MSI.
En la página Bienvenido al Asistente para importar MSI, en el archivo MSI que se va a importar, escriba la ruta del archivo .msi y, a continuación, haga clic en Siguiente. Si es necesario, puede buscar el archivo .msi haciendo clic en el botón ... .
En la página Configuración de la aplicación, en la lista desplegable Nombre de la aplicación, seleccione el nombre de la aplicación, si está disponible. La lista está disponible si va a importar la aplicación en el grupo de BizTalk.
Nota:
La lista incluye los nombres de todas las aplicaciones actualmente en el grupo de BizTalk, así como la aplicación desde la que se exportó el archivo .msi. Si selecciona el nombre de la última aplicación y la aplicación aún no existe en este grupo de BizTalk, el Asistente para importación crea una nueva aplicación. Si selecciona una aplicación que ya existe en el grupo, el Asistente para importación importa los artefactos desde el archivo .msi a la aplicación existente.
En Aplicaciones disponibles para agregar referencias a, seleccione las aplicaciones a las que se van a agregar referencias, si las hay y, a continuación, haga clic en Siguiente.
Si va a importar el archivo .msi en una aplicación existente y desea sobrescribir artefactos en la aplicación existente, seleccione Sobrescribir recursos.
Nota:
Si no selecciona esta opción y el archivo .msi contiene un artefacto que ya existe en la aplicación, se producirá un error en la operación de importación y se revertirá. Determinados tipos de artefactos de una aplicación o grupo de BizTalk deben ser únicos. Si va a agregar un artefacto que ya existe en el grupo de BizTalk, pero no en la aplicación actual, se producirá un error en la operación de importación, aunque especifique la opción de sobrescritura. Para obtener más información sobre qué artefactos deben ser únicos y de qué maneras deben ser únicos, vea Artefactos que deben ser únicos en una aplicación o grupo.
En la página Configuración del entorno de destino de la aplicación, en la lista desplegable Entorno de ensayo de destino, seleccione el entorno de destino de esta aplicación y haga clic en Siguiente. Esta lista contiene todos los entornos especificados para los archivos de enlace que se han agregado a esta aplicación. Seleccione <Predeterminado> si desea aplicar todos los enlaces de la aplicación, excepto los que tienen un entorno de destino especificado. Si el archivo .msi no contiene un archivo de vinculación que desea aplicar explícitamente, puede dejar <Predeterminado> seleccionado.
Nota:
Al agregar un archivo de enlace a una aplicación, especifique el entorno de destino para los enlaces. Para obtener la información general, consulte Vinculación de archivos y despliegue de aplicaciones. Para obtener instrucciones sobre cómo agregar archivos de enlace, consulte Cómo agregar un archivo de enlace a una aplicación.
En la página Importar resumen, confirme que la información de resumen es correcta y, a continuación, haga clic en Importar.
En la página Importación exitosa, si desea instalar la aplicación en el equipo local, seleccione la casilla Ejecutar el Asistente para la instalación de aplicaciones para instalar la aplicación en el equipo local.
Nota:
A menos que necesite ejecutar la aplicación tal como está configurada actualmente en el equipo local, no es necesario instalarla. Sin embargo, si la aplicación incluye artefactos basados en archivos, debe instalar la aplicación en todos los equipos que lo ejecutarán antes de que pueda empezar a funcionar, ya que la importación de la aplicación solo la agrega a la base de datos de administración de BizTalk.
Haga clic en Finalizar
Nota:
Si se produce un error en la instalación, por ejemplo, porque no tiene permisos de escritura en el sistema de archivos local, la instalación se revierte, pero no la operación de importación.
Importación de una aplicación de BizTalk mediante la línea de comandos
Abra un símbolo del sistema como se indica a continuación: haga clic en Inicio, haga clic en Ejecutar, escriba
cmdy, a continuación, haga clic en Aceptar.Escriba el siguiente comando, sustituyendo los valores adecuados, como se describe en la tabla siguiente:
BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]
Ejemplo:
BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite
Parámetro Importancia /Paquete Ruta de acceso completa del archivo .msi. Si la ruta de acceso incluye espacios, debe incluirla entre comillas ("). /Medio ambiente Entorno de implementación de destino del archivo de enlace que se va a aplicar, como Test. Este es el valor que se especificó para el entorno de implementación de destino cuando se agregó el archivo de enlace a la aplicación. /ApplicationName Nombre de la aplicación de BizTalk a la que se importan los artefactos del archivo .msi. Si no se especifica, se usa el nombre de la aplicación que se especificó al exportar el archivo .msi. Si la aplicación especificada no existe, se creará. Los nombres de aplicación que incluyen espacios deben incluirse entre comillas dobles ("). /Sobrescribir Opción para sobrescribir artefactos en la aplicación con artefactos en el archivo .msi que tienen el mismo identificador único local (LUID). Si no se especifica esta opción y hay uno o varios artefactos en la aplicación que tienen el mismo LUID que los artefactos del archivo .msi, se produce un error en la importación. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp. /Servidor Nombre de la instancia de SQL Server que hospeda la base de datos de administración de BizTalk, en el formulario NombreDeServidor\NombreDeInstancia,Puerto.
El nombre de instancia solo es necesario cuando el nombre de instancia es diferente del nombre del servidor. El puerto solo es necesario cuando SQL Server usa un número de puerto distinto del predeterminado (1433).
Ejemplos:
Server=MyServer
Servidor=MyServer\MySQLServer,1533
Si no se proporciona, se usa el nombre de la instancia de SQL Server que se ejecuta en el equipo local./Base de datos Nombre de la base de datos de administración de BizTalk. Si no se especifica, se usa la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.
Véase también
Importación de aplicaciones, vinculaciones y directivas de BizTalk
Comando ImportApp