En el momento de manejar AddIn’s para extender la funcionalidad de Visual Studio .Net 2005 en los proyectos de BizTalk Server 2006 se debe conocer como acceder a cada una de las propiedades de configuración del proyecto.

Ya que el modelo de objetos de un proyecto de BTS 2006 no esta documentado, a continuación se muestra la forma en la cual se pueden acceder a las propiedades del proyecto.

Propiedades de Configuracion

Para acceder a las propiedades de configuración del proyecto es necesario obtener las propiedades del ítem ConfigProperties de la configuración activa. A continuación se da un ejemplo de código.

Property configProperties = project.ConfigurationManager.ActiveConfiguration.Properties.Item("ConfigProperties");
IDictionary dicConfigProps = configProperties.Value as IDictionary;
string outputPath = dicConfigProps[DictionaryTags.OutputPath].ToString();

En este ejemplo de código, la variable project es de tipo EnvDTE.Project y representa el proyecto de BizTalk Server 2006. Luego, se obtiene el diccionario de propiedades y se acceden por medio de la enumeración DictionaryTags cada una de las propiedades.

En el anterior ejemplo se accedió la propiedad OuputPath que contiene la ruta de despliegue del ensamblado del proyecto. A continuación se lista las propiedades que pueden ser accedidas en este diccionario.

Configuration Properties Enumeracion
Seccion: Build
Restart Host Instances: especifica si se reinicializan las instancias de Host en BizTalk Server en la maquina. DictionaryTags.RestartHostInstances
Register: especifica si se registra el assembly en el GAC DictionaryTags.Register
Redeploy: especifica si se elimina la configuración actual y se vuelve a crear cada ves que se despliega el assembly de BizTalk DictionaryTags.Redeploy
Application Name: especifica la aplicación de BizTalk Server donde será desplegado el assembly. DictionaryTags.ApplicationName
Configuration Database: base de datos de configuración de BizTalk DictionaryTags.ConfigurationDatabase
Server: servidor de la base de datos de configuración de BizTalk DictionaryTags.Server
Seccion: Deployment
Bpel Compliance: especifica si la salida es acorde a BPEL DictionaryTags.BpelCompliance
Generate Debugging Information: especifica si se generan los símbolos de debug DictionaryTags.GenerateDebuggingInformation
Embed Tracking Information: especifica si se adiciona información de tracking en el assembly DictionaryTags.EmbedTrackingInformation
Treat Warnings As Errors: especifica si se detectan las alertas como errores en compilación DictionaryTags.TreatWarningsAsErrors
Warning Level: especifica el nivel de error DictionaryTags.WarningLevel
Output Path: especifica el directorio de salida donde se generaran los assemblies DictionaryTags.OutputPath

Propiedades Comunes

Para acceder a las propiedades de configuración del proyecto es necesario obtener las propiedades del ítem CommonProperties del proyecto. A continuación se da un ejemplo de código.

Property commmonProperties = project.Properties.Item("CommonProperties");
IDictionary dicCommonProps = commmonProperties.Value as IDictionary;
string projKeyFileName = dicCommonProps[DictionaryTags.AssemblyKeyFile].ToString();

En el anterior ejemplo se accedió la propiedad AssemblyKeyFile que contiene la ruta del archivo que contiene el Strong Name para firmar el assembly. A continuación se lista las propiedades que pueden ser accedidas en este diccionario.

Common Properties Enumeracion
Seccion: Assembly
Assembly Key Name: indica el nombre de la llave. DictionaryTags.AssemblyKeyName
Assembly Key File: especifica la ruta del archivo que contiene el SN. DictionaryTags.AssemblyKeyFile
Assembly Delay Sign: especifica si se espera para firmar el assembly. DictionaryTags.AssemblyDelaySign
Assembly Title: titulo del assembly. DictionaryTags.AssemblyTitle
Assembly Description: descripción del assembly. DictionaryTags.AssemblyDescription
Assembly Default Alias: alias que será usado por los assemblies que lo relacionen. DictionaryTags.AssemblyDefaultAlias
Assembly Configuration: especifica el tipo de desarrollo sobre el assembly. DictionaryTags.AssemblyConfiguration
Assembly Trademark: marca de la compañía. DictionaryTags.AssemblyTrademark
Assembly Product: información del producto. DictionaryTags.AssemblyProduct
Assembly Informational Version: versión adicional no usada por el framework. DictionaryTags.AssemblyInformationalVersion
Assembly File Version: versión del archivo. DictionaryTags.AssemblyFileVersion
Assembly Copyright: derechos sobre el contenido del assembly. DictionaryTags.AssemblyCopyright
Assembly Company: compañía que desarrolla el assembly. DictionaryTags.AssemblyCompany
Assembly Version: versión del assembly. DictionaryTags.AssemblyVersion
Assembly Culture: cultura del assembly. DictionaryTags.AssemblyCulture
Seccion: References Path
References Path: lista de directorios de referencia. DictionaryTags.ReferencesPath
Seccion: General
Project Folder: la ruta completa del directorio del proyecto. DictionaryTags.ProjectFolder
Project File: nombre del archive que contiene la configuración del proyecto. DictionaryTags.ProjectFile
Default Namespace: especifica el namespace por defecto de los nuevos elementos creados. DictionaryTags.DefaultNamespace
Assembly Name: el nombre del assembly de salida. DictionaryTags.AssemblyName

Clase DictionaryTags

La clase de enumeración DictionaryTags utilizada para acceder a cada propiedad del diccionario se encuentra en el assembly Microsoft.BizTalk.Studio.Extensibility.dll y es representada así:

public enum DictionaryTags
{
OutputPath,
WarningLevel,
TreatWarningsAsErrors,
EmbedTrackingInformation,
GenerateDebuggingInformation,
BpelCompliance,
Server,
ConfigurationDatabase,
ApplicationName,
Redeploy,
Register,
RestartHostInstances,
AssemblyName,
DefaultNamespace,
ProjectFile,
ProjectFolder,
ReferencesPath,
AssemblyCulture,
AssemblyVersion,
AssemblyCompany,
AssemblyCopyright,
AssemblyFileVersion,
AssemblyInformationalVersion,
AssemblyProduct,
AssemblyTrademark,
AssemblyConfiguration,
AssemblyDefaultAlias,
AssemblyDescription,
AssemblyTitle,
AssemblyDelaySign,
AssemblyKeyFile,
AssemblyKeyName,
None
}

Autor: Carlos Medina

Este mensaje se proporciona "como está" sin garantías de ninguna clase, y no otorga ningún derecho.