Información sobre aplicaciones en los informes de implementación

Actualización: noviembre 2007

En el informe de implementación XML, el elemento <Applications> contiene información sobre las aplicaciones que es necesario implementar en un sistema distribuido. Esta información se necesita con el fin de configurar dichas aplicaciones para la implementación. Este elemento puede contener información de las aplicaciones de ese sistema exclusivamente, o puede incluir información de otros sistemas de dicho sistema. También incluye información sobre las opciones de configuración, los recursos y los extremos de cada aplicación. Para obtener más información, vea Información general de las secciones clave de los informes de implementación.

Por ejemplo, si el informe de implementación generado corresponde a un sistema "predeterminado", este elemento contiene todas las aplicaciones de dicho sistema, pero no de otros sistemas. Sin embargo, el sistema predeterminado representa cómo están conectadas y configuradas dichas aplicaciones en el entorno de desarrollo, no en el entorno de implementación. Para obtener más información, vea Definiciones de implementación creadas desde diagramas de sistemas y de aplicaciones.

El elemento <Applications> contiene uno o varios elementos <Application> que identifican cada aplicación en el informe de implementación. Las secciones siguientes contienen más información sobre el elemento <Application>:

Application Information in the <Application> Element
Paths to Application Files
Configuration File Settings for Applications
IIS Metabase Settings for ASP.NET Applications
Information about Application Connections
Web Service and Web Content Absolute URIs

Información sobre las aplicaciones en el elemento <Application>

El ejemplo siguiente contiene un elemento <Application> correspondiente a una aplicación para Windows. El valor "Microsoft_WindowsApplication:WindowsApplication" del atributo "Extends" identifica la aplicación para Windows:

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="ed22d434-f40d-48b1-bbec-0b4e93ad2a9f">
   ...
</Application>

En este elemento puede encontrar la información siguiente:

Rutas de acceso a los archivos de la aplicación necesarios para la implementación.
Opciones de configuración que deben actualizarse en los archivos de configuración de aplicaciones.
Opciones de configuración de la metabase de Internet Information Services (IIS) requeridas por las aplicaciones ASP.NET para la implementación.
Información de conexión para las aplicaciones.
URI absolutos (ubicación de la implementación) para los extremos de proveedor de servicios Web y contenido Web.

El tipo de aplicación determina los tipos de archivos, las opciones de configuración y otra información incluida en el informe de implementación.

Rutas de acceso a los archivos de la aplicación

El informe de implementación incluye información sobre la ruta de acceso de los archivos necesarios para la implementación de las aplicaciones. Entre estos archivos se incluyen, por ejemplo, bibliotecas, ejecutables, archivos de contenido y archivos de configuración. Esta información es necesaria para localizar dichos archivos para la implementación. Sin embargo, se debe especificar una ubicación para copiar los archivos antes de generar el informe de implementación. Puede especificar dicha ubicación en la propiedad Destination Path del diagrama de implementación utilizado para generar el informe de implementación. También debe especificar si desea incluir los archivos de código fuente, de contenido y binarios mediante las propiedades correspondientes. Esto le permitirá incluir dichos archivos y recopilarlos desde la ubicación que especifique. Cuando se genera el informe de implementación, el proceso de generación crea los directorios de proyecto apropiados y copia en ellos los archivos. Para obtener más información, vea Cómo: Generar informes de implementación.

Nota:
Para cada definición de aplicación que admite la implementación en el diagrama de aplicaciones, sólo existe un proyecto en la solución para dicha definición. Sin embargo, la definición puede tener varios usos en el sistema que se está implementando. Por ejemplo, el sistema puede incluir varios usos con opciones de configuración de la seguridad diferentes y que se implementarán en servidores diferentes. El informe de implementación incluye estos usos múltiples. Sin embargo, el proceso de generación sólo crea un directorio de proyecto para todos los usos. Por lo tanto, el proceso de implementación debe crear y configurar cada uso valiéndose de la información del informe de implementación.

Para cada definición de aplicación que admite la implementación en el diagrama de aplicaciones, sólo existe un proyecto en la solución para dicha definición. Sin embargo, la definición puede tener varios usos en el sistema que se está implementando. Por ejemplo, el sistema puede incluir varios usos con opciones de configuración de la seguridad diferentes y que se implementarán en servidores diferentes. El informe de implementación incluye estos usos múltiples. Sin embargo, el proceso de generación sólo crea un directorio de proyecto para todos los usos. Por lo tanto, el proceso de implementación debe crear y configurar cada uso valiéndose de la información del informe de implementación.

En cada aplicación para Windows, ASP.NET u Office del informe de implementación, el elemento <Application> contiene un elemento <Resource> denominado "Directory". Este elemento "Directory" contiene elementos <Resource> que incluyen información sobre los directorios existentes en la ubicación de resultados y los archivos copiados en dichos directorios. Para obtener más información, vea Ubicación y estructura de directorios de los archivos de resultados de la implementación.

Cada elemento <Resource> del elemento "Directory" hace referencia a un archivo o un directorio situado en la ruta de acceso del sistema de archivos, en la ubicación de resultados. Los elementos <Resource> que hacen referencia a un directorio pueden contener otros elementos <Resource> con referencias a subdirectorios. Sin embargo, todos los elementos <Resource> que hacen referencia a archivos se encuentran en el nivel de hoja.

Nota:
Este grupo de elementos <Resource> tiene la misma jerarquía que la estructura del proyecto en la solución. Sin embargo, los elementos <Resource> que representen directorios en el mismo nivel pueden aparecer en un orden diferente al de sus carpetas en la solución o en el disco. Además, el cambio de los nombres de los proyectos en una solución no implica el cambio de los nombres de las carpetas en el disco. No obstante, se utiliza el nombre de la carpeta del proyecto en el disco, y no el nombre del proyecto en la solución, para crear el directorio del proyecto en la ubicación de resultados. Por lo tanto, el nombre del directorio del proyecto en la ubicación de resultados puede no ser el mismo que el nombre del proyecto en la solución.

Este grupo de elementos <Resource> tiene la misma jerarquía que la estructura del proyecto en la solución. Sin embargo, los elementos <Resource> que representen directorios en el mismo nivel pueden aparecer en un orden diferente al de sus carpetas en la solución o en el disco. Además, el cambio de los nombres de los proyectos en una solución no implica el cambio de los nombres de las carpetas en el disco. No obstante, se utiliza el nombre de la carpeta del proyecto en el disco, y no el nombre del proyecto en la solución, para crear el directorio del proyecto en la ubicación de resultados. Por lo tanto, el nombre del directorio del proyecto en la ubicación de resultados puede no ser el mismo que el nombre del proyecto en la solución.

Además, cada elemento <Resource> que representa un directorio o un archivo contiene un elemento <Setting> denominado "Path". Este elemento "Path" contiene tres elementos <Facet>: "Assigned," "Parent" y "Current".

En la tabla siguiente se ofrece información sobre estos elementos.

Elemento <Facet>	Descripción
"Assigned"	Contiene la ruta de acceso de la ubicación de resultados especificada por la propiedad Destination Path en el informe de implementación. No obstante, solamente el elemento "Path" del elemento "Directory" contiene este valor.
"Parent"	Contiene la ruta de acceso desde el directorio del proyecto al directorio primario de un subdirectorio o de un archivo. No obstante, sólo el elemento "Path" de ese subdirectorio o archivo contiene este valor. Nota: Si el proyecto tiene un directorio primario, el elemento "Parent" del elemento "Path" en el elemento "Directory" no incluye la ruta de acceso a dicho directorio primario.
"Current"	Contiene la ruta de acceso desde el directorio del proyecto a un subdirectorio o un archivo. El elemento "Path" del directorio del proyecto, un subdirectorio o un archivo contiene este valor.

Por lo tanto, puede recuperar la ruta de acceso completa a un subdirectorio o un archivo si combina el elemento "Assigned" de "Path" en el elemento "Directory" con el elemento "Current" de un subdirectorio o un archivo.

Nota:
Puede que sea necesario agregar una barra diagonal inversa (\) en el lugar apropiado para crear una ruta de acceso válida.

Para obtener más información, vea Cómo: Buscar rutas de acceso a los archivos de resultados de implementación en los informes de implementación y Ubicación y estructura de directorios de los archivos de resultados de la implementación.

Opciones del archivo de configuración para las aplicaciones

Debe actualizar el archivo de configuración (Web.config en las aplicaciones ASP.NET o App.config en las aplicaciones para Windows o de Office) para cada uso de una aplicación en el sistema con las opciones de configuración de la implementación correctas. Inicialmente, las opciones del archivo de configuración representan la configuración de la aplicación en el entorno de desarrollo, no en el entorno de implementación. No obstante, puede recuperar del informe de implementación las opciones del archivo de configuración necesarias para la implementación.

El elemento <Application> de una aplicación contiene un elemento <Resource> denominado "Directory". Para obtener más información, vea Paths to Application Files. Dicho elemento "Directory" contiene otro elemento <Resource> denominado "Configuration". Este elemento "Configuration" contiene elementos <Setting> y <Resource> que identifican las opciones del archivo de configuración necesarias para la implementación. Para obtener más información, vea Cómo: Buscar las opciones del archivo de configuración de la aplicación en los informes de implementación.

Nota:
Las opciones del archivo de configuración en el informe de implementación deben tener los mismos nombres que sus homólogas en el archivo de configuración. No obstante, los nombres de recurso debajo de los cuales aparecen las opciones de configuración en el informe de implementación pueden diferir de las secciones correspondientes en el archivo de configuración. Para obtener más información, vea Secciones del archivo de configuración de los informes de implementación.

Las opciones del archivo de configuración en el informe de implementación deben tener los mismos nombres que sus homólogas en el archivo de configuración. No obstante, los nombres de recurso debajo de los cuales aparecen las opciones de configuración en el informe de implementación pueden diferir de las secciones correspondientes en el archivo de configuración. Para obtener más información, vea Secciones del archivo de configuración de los informes de implementación.

Opciones de configuración de la metabase de IIS para las aplicaciones ASP.NET

El elemento <Application> de una aplicación ASP.NET contiene un elemento <Resource> denominado "WebApplication". Este elemento "WebApplication" contiene elementos <Setting> que describen las opciones de configuración de la metabase de IIS necesarias para la implementación. No obstante, algunos nombres, valores o tipos de las opciones de configuración difieren de sus homólogos en IIS y requieren una conversión antes de configurarlos en el servidor de destino. Para obtener más información, vea los temas siguientes:

Información sobre las conexiones de aplicaciones

El elemento <Application> contiene un elemento <Endpoint> para cada extremo de una aplicación. Un elemento <Endpoint> contiene un elemento <Setting> denominado "ConnectedToEndpoints" cuando un extremo se conecta con otro. Puede usar el elemento "ConnectedToEndpoints" para identificar todos los extremos conectados con dicho extremo. El elemento "ConnectedToEndpoints" contiene un Identificador único global (GUID) que coincide con el atributo "InstanceId" del extremo conectado. Otros elementos <Setting> del elemento <Endpoint> contienen información de las opciones de configuración del extremo.

Sugerencia:
Para ver estas opciones de configuración, seleccione el extremo en el diagrama de aplicaciones o en el diagrama del sistema (a partir del cual se creó el diagrama de implementación). A continuación, en el Editor de restricciones y configuración, vea el nodo Configuración del extremo de aplicación. Para obtener más información, vea Editor de restricciones y configuración.

El ejemplo siguiente contiene un elemento "ConnectedToEndpoints" para un extremo de consumidor de servicios Web en una aplicación para Windows. Este elemento contiene un GUID que identifica el extremo de proveedor de servicios Web conectado en una aplicación Web ASP.NET. A su vez, el elemento <Endpoint> de dicho extremo de proveedor de servicios Web tiene un elemento "ConnectedToEndpoints" que contiene el valor del GUID para el extremo de consumidor de servicios Web conectado:

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="6b36995a-a6cf-47d6-9dcb-679d07db23ef">
   <Endpoint Name="MyWebServiceConsumer" Definition="MyWinAppDefinition:MyWinAppDefinition.WebServiceConsumer1" Extends="Microsoft_Web:WebServiceClient" InstanceId="a18fb424-c1a4-49e3-b4af-e6d7e2e9d063"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>9c4e0dc0-a29d-4bb7-8061-a9d3e2075581</Value></Setting>
      ...
   </Endpoint>
...
</Application>
<Application Name="MyWebApp1" Definition="MyWebApp1:MyWebApp1" Extends="Microsoft_WebApplication:WebApplication" InstanceId="1a912802-d7f3-4b53-89a5-b8bc7f378411">
   ...
   <Endpoint Name="WebService1" Definition="MyWebApp1:MyWebApp1.WebService1" Extends="Microsoft_Web:WebService" InstanceId="9c4e0dc0-a29d-4bb7-8061-a9d3e2075581"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>a18fb424-c1a4-49e3-b4af-e6d7e2e9d063</Value></Setting>
      ...
   ...
   </Endpoint>
...
</Application>

URI absolutos de servicios Web y contenido Web

Debe configurar los extremos de consumidor de cada aplicación que consuma un servicio o contenido Web con la ubicación de implementación de dicho servicio o contenido Web. El elemento <Application> de una aplicación ASP.NET que expone un servicio Web o un contenido Web contiene un elemento <Endpoint>. Dicho elemento <Endpoint> contiene un elemento "Uri" <Setting> que, a su vez, contiene tres elementos <Facet>: "Relative," "Base" y "Absolute".

La tabla siguiente contiene más información sobre estos elementos.

Elemento <Facet>	Descripción
"Relative"	Contiene la configuración de Service URL de un extremo de proveedor de servicios Web. Esta configuración puede contener una dirección URL de servicio Web relativa o absoluta. O bien Contiene la configuración de Relative Path de un extremo de proveedor de contenido Web. Esta configuración contiene una ruta de acceso relativa que hace referencia al contenido de una ubicación diferente del directorio raíz de la aplicación.
"Base"	Contiene la configuración de URL de un extremo de sitio Web. Este extremo de sitio Web está en el servidor Web de IIS que aloja el servicio o el contenido Web.
"Absolute"	Contiene el URI absoluto del extremo de proveedor de servicios Web o de contenido Web. Nota: Si la configuración de Service URL o Relative Path contiene una ruta de acceso o una dirección URL relativa, este elemento combina la configuración de URL y la de Service URL o Relative Path. No obstante, si la configuración de Service URL o Relative Path contiene una ruta de acceso o una dirección URL absoluta, este elemento contiene dicha ruta de acceso o dirección URL absoluta. Para obtener más información, vea Cómo: Buscar los identificadores URI absolutos de servicios Web y contenido Web en los informes de implementación.

"Relative"

Contiene la configuración de Service URL de un extremo de proveedor de servicios Web. Esta configuración puede contener una dirección URL de servicio Web relativa o absoluta.

O bien

Contiene la configuración de Relative Path de un extremo de proveedor de contenido Web. Esta configuración contiene una ruta de acceso relativa que hace referencia al contenido de una ubicación diferente del directorio raíz de la aplicación.

"Base"

Contiene la configuración de URL de un extremo de sitio Web. Este extremo de sitio Web está en el servidor Web de IIS que aloja el servicio o el contenido Web.

"Absolute"

Contiene el URI absoluto del extremo de proveedor de servicios Web o de contenido Web.

Nota:

Si la configuración de Service URL o Relative Path contiene una ruta de acceso o una dirección URL relativa, este elemento combina la configuración de URL y la de Service URL o Relative Path. No obstante, si la configuración de Service URL o Relative Path contiene una ruta de acceso o una dirección URL absoluta, este elemento contiene dicha ruta de acceso o dirección URL absoluta.

Para obtener más información, vea Cómo: Buscar los identificadores URI absolutos de servicios Web y contenido Web en los informes de implementación.

Sugerencia:
Para ver las opciones de configuración de un extremo de proveedor de servicios Web o de contenido Web, selecciónelo en el diagrama de aplicaciones y examine el nodo Configuración del extremo de aplicación en el Editor de restricciones y configuración. Para ver las opciones de configuración de un extremo de sitio Web, selecciónelo en el diagrama de centros de datos lógicos y examine el nodo Configuración de extremo del servidor lógico en el Editor de restricciones y configuración. Para obtener más información, vea Editor de restricciones y configuración.

Para ver las opciones de configuración de un extremo de proveedor de servicios Web o de contenido Web, selecciónelo en el diagrama de aplicaciones y examine el nodo Configuración del extremo de aplicación en el Editor de restricciones y configuración. Para ver las opciones de configuración de un extremo de sitio Web, selecciónelo en el diagrama de centros de datos lógicos y examine el nodo Configuración de extremo del servidor lógico en el Editor de restricciones y configuración. Para obtener más información, vea Editor de restricciones y configuración.

Vea también

Conceptos

Información general sobre la implementación con informes de implementación

Last updated on 2008-10-07