En algún momento me construí mi propia herramienta (usando Macros) para documentar código basado en este artículo que me fue súper útil: Handy .NET Macro.

Menos mal que que existen herramientas para asistirnos en la laboriosa tarea de escribir nuestros amados comentarios XML, sí esos que hay que comenzar con “/// “.

En mi afán de tener una herramienta que documente código ya escrito encontré GhostDoc, que me ha servidor para resolver todas las necesidades que tenía para documentar el código. Veamos algunas características.

GhostDoc

GhostDoc es un plug-in compatible tanto con las versiones de Visual Studio 2005  y superiores creado por Roland Weigelt, cuya utilidad es (Obligarnos a escribir comentarios), automatizar la escritura de comentarios XML, generando toda la estructura del comentario, lo único que tenemos que hacer es modificar el texto que necesitemos para que todo sea más entendible y legible entre todos los programadores que comparten un proyecto.  Gracias a este plug-in nos ahorramos de escribir una cantidad impresionantes de texto y podemos realizar los comentarios XML muy rápido.

¿Cómo Funciona?

Muy simple, imaginemos que tenemos unas reglas de negocio complejas y que para ello tenemos que implementar algunas clases (aquí un ejemplo simple) :

Teniendo el código así se ve todo complejo y por lo tanto casi imposible de usar si es que no se tiene la documentación de:

• ¿Para qué sirve la clase?

• ¿Para qué sirve cada método?

• ¿Que representa cada parámetro?

Para proceder con nuestra tarea de documentación asistida tenemos que realizar los siguientes pasos:

1. Descargar la versión que corresponda de GhostDoc de la siguiente dirección:Roland Weigelt’s  GhostDoc. Luego procedemos a instalarlo dejando los valores por defecto.

2. Al iniciar Visual Studio se nos pedirá que seleccionemos algunas opciones como combinación de teclas para acceso directo, donde también pueden dejar los valores por defecto, para verificar que esté instalado el plug-in, revisar en el menú principal la opción “Tools”, bajo la que ahora debería estar GhostDoc.

3. Ya tenemos todo listo así que nos queda comenzar a generar los comentarios XML, en primer lugar comentaremos la clase, para lo cual pulsamos clic derecho sobre el nombre de la clase y en el menú contextual seleccionamos: “Document this” (también podemos utilizar la combinación de teclas de acceso rápido, si es que dejaron los valores por defecto serán: Ctrl + Shift + D)

   

   Esto genera la estructura del comentario completa incluida las etiquetas de resumen, poniendo el cursor en posición para escribir la descripción de la clase.

4. A continuación solo nos queda escribir la descripción de la clase:

   

5. Ahora nos toca generar los comentarios XML para los métodos, el proceso es el mismo, pulsamos clic derecho sobre el nombre del método y del menú contextual seleccionamos: “Document this”, lo cual genera toda la estructura necesaria para la descripción del método los parámetros de entrada y la salida del método. Ahora solo nos queda escribir la descripción del método, los parámetros y el valor de salida, repetimos el procedimiento para todos los métodos.



6. Ahora ya tenemos nuestra clase completamente comentada, cabe aclarar que en este caso solo utilizamos comentarios para la clase y para métodos, pero también se pueden generar comentarios para otros miembros de clases como propiedades y eventos. GhostDoc también tiene numerosas opciones de configuración avanzadas, para las cuales tendrán que profundizar más en el estudio de esta herramienta.

¿Y para qué sirven esos comentarios XML?
Ahora ya tenemos nuestra clase completamente comentada, y ¿para qué nos sirve esto?, pues si pensamos en lo más inmediato, sirve para que las personas que revisen el código de esta clase puedan guiarse por estos comentarios y entender la funcionalidad de los miembros de la clase, esta no es su única utilidad, también sirve para que los usuarios de nuestra clase sepan cómo utilizar los miembros públicos de la clase, los comentarios XML que escribimos se presentarán como ayudas de IntelliSense al momento de escribir el código como se muestra en las siguiente imagen:

La utilidad de los comentarios XML no termina aquí, también pude servir para generar los archivos de ayuda a partir de estos comentarios XML (pero esto merece otro artículo).
Espero que esta excelente herramienta os motive a escribir más comentarios XML y os sea de utilidad.

Un Windows renovado y reinventado a partir de las robustas características de velocidad y seguridad de Windows 7. Una interfaz táctil completamente nueva. Un nuevo Windows para nuevos dispositivos.

Se puede descargar la versión preliminar desde aquí

Aquí unas capturas de pantalla para abrir el apetito…

La máquina virtual está tiene dos aplicaciones Web desarrolladas por Fabrikam Fiber – un proveedor de servicios de cable y telecomunicaciones. Ellos usan las herramientas de Visual Studio application lifecycle management para administrar su código fuente, ejecutar sus compilaciones, probar los sitios Web, así como planificar y hacer un seguimiento al proyecto.

La nueva herramienta Storyboarding de PowerPoint hará más fácil afinar los requerimientos y asegurarse que el equipo esté desarrollando el software correcto antes de escribir una línea de código.

El equipo de Fabrikam Fiber  usa Team Web Access portal  para ayudarles a colaborar de manera más efectiva como equipo.

El equipo de Fabrikam Fiber  mantiene una un registro común dentro de la Web para seguir el trabajo futuro y empezar a asignar esta labor a las iteraciones.

Los elementos del registro de pedidos se puede descomponer en iteraciones y se descompone, con un punto de vista sobre la capacidad de cada miembro del equipo de manera que se evita la sobrecarga en las personas más allá de lo que puede ofrecer con éxito.

El equipo de Fabrikam Fiber  usa la nueva “task board” en la Web para hacer un seguimiento del trabajo en todo el proyecto. Echa un vistazo a la "gestión de proyectos ágil …".

El explorador del Equipo ha sido totalmente re-diseñado .

También los desarrolladores con Eclipse tienen una actualización con mejoras en la apariencia.

Visual Studio 11 permitirá que herramientas de terceros tales como NUnit and xUnit, puedan hacer pruebas unitarias.

En el laboratorio de pruebas unitarias, también descubrirá la nueva y poderosa capacidad clonar código. Esto le permite encontrar bloques de código semánticamente similares, lo que podría abrir nuevas oportunidades de refactorización,o indicar bloques de código que necesitan una corrección común de errores.

Microsoft Test Manager 11 ofrece un apoyo aún mayor para las pruebas exploratorias.Esto le permite poner una marca de probador en adelante, encontrar errores, y  automáticamente capturar los diagnósticos.

Y ya que hay cambios en la Web El equipo de Fabrikam Fiber, puede recabar la opinión de las partes interesadas para asegurarse de que lo que se construyó cumple con las expectativas de los usuarios finales, los abogados de privacidad, el director general, o quien más tiene que ofrecer las pruebas de aceptación del software. La nueva retroalimentación de los clientes facilita este proceso mediante la captura de datos, mientras que un actor está evaluando el software. Estos datos – que puede incluir grabaciones de vídeo, texto y las anotaciones de audio y recortes de pantalla – todos pueden ser almacenados en Team Foundation Server para facilitar el acceso al equipo de desarrollo y la trazabilidad completa de los requisitos originales .

Por último, sabemos que la gestión de ciclo de vida de la aplicación no termina cuando se libera una versión . Visual Studio 11 amplía las capacidades de IntelliTrace que le permite capturar archivos ricos en contenido de las máquinas que se ejecutan en su entorno de producción con bajo impacto mediante comandos de PowerShell. Esto le da una amplia información, la depuración histórica queda a su alcance – lo que le permite ver exactamente qué errores se están produciendo en su entorno de producción.

¡A disfrutarlo!

SELECT ROUTINE_NAME FROM INFORMATION_SCHEMA.ROUTINES
   WHERE ROUTINE_TYPE = 'PROCEDURE'
   ORDER BY ROUTINE_NAME 

Que os sea útil

El lugar donde ahora se encuentra la carpeta del Menú para todos los usuarios está en C:\ProgramData\Microsoft\Windows\Start Menu (Típicamente C: o la unidad donde esté instalado el sistema operativo). Aquí se pueden crear todos los accesos directos que se necesiten y estarán habilitados para todos los usuarios. Se puede ir directamente a esta carpeta, pero está oculta por defecto, así que sería necesario seleccionar la opción “Mostrar archivos, carpetas y unidades ocultos” de “Opciones de Carpeta y búsqueda” del menú organizar en el explorador de Windows.

Si se trata de acceder directamente a la carpeta “C:\Users\All Users\Start Menu”, se mostrará un mensaje de acceso denegado, porque a pesar del nombre, no es el lugar que se debería usar de todas formas. Para eso se usa la carpeta C:\ProgramData\Microsoft\Windows\Start Menu.

SELECT * FROM INFORMATION_SCHEMA.TABLES
WHERE table_type='BASE TABLE'
ORDER BY table_name

Que os sea útil

Básicamente se trata de hacer una consulta de la tabla “sysindexes”, pero al tener muchos campos y algunos datos directamente ilegibles construimos una consulta haciendo las conversiones de datos solo de los campos que nos interesan, así como también los filtros respectivos para que no se incluya información que no sean propiedades de una tabla. Finalmente a esta consulta le podemos dar un formato numérico más legible y ordenarlo por el campo que nos sea de interés. En el siguiente ejemplo está ordenado descendentemente por número de registros que contiene la tabla.

SELECT
    X.[name],
    REPLACE(CONVERT(varchar, CONVERT(money, X.[rows]), 1), '.00', '')
        AS [rows],
    REPLACE(CONVERT(varchar, CONVERT(money, X.[reserved]), 1), '.00', '')
        AS [reserved],
    REPLACE(CONVERT(varchar, CONVERT(money, X.[data]), 1), '.00', '')
        AS [data],
    REPLACE(CONVERT(varchar, CONVERT(money, X.[index_size]), 1), '.00', '')
        AS [index_size],
    REPLACE(CONVERT(varchar, CONVERT(money, X.[unused]), 1), '.00', '')
        AS [unused]
FROM
(SELECT
    CAST(object_name(id) AS varchar(50))
        AS [name],
    SUM(CASE WHEN indid < 2 THEN CONVERT(bigint, [rows]) END)
        AS [rows],
    SUM(CONVERT(bigint, reserved)) * 8
        AS reserved,
    SUM(CONVERT(bigint, dpages)) * 8
        AS data,
    SUM(CONVERT(bigint, used) - CONVERT(bigint, dpages)) * 8
        AS index_size,
    SUM(CONVERT(bigint, reserved) - CONVERT(bigint, used)) * 8
        AS unused
    FROM sysindexes WITH (NOLOCK)
    WHERE sysindexes.indid IN (0, 1, 255)
        AND sysindexes.id > 100
        AND object_name(sysindexes.id) <> 'dtproperties'
    GROUP BY sysindexes.id WITH ROLLUP
) AS X
WHERE X.[name] is not null
ORDER BY X.[rows] DESC

Espero que os sea de utilidad.

Para crear un programa que lea y escriba ficheros INI desde .NET necesitamos dos métodos definidos en el Kernel32: WritePrivateProfileString  para escribir y GetPrivateProfileString para leer:

[DllImport("kernel32.dll")]
private static extern long WritePrivateProfileString(
   string section,
   string key,
   string val,
   string filePath);

[DllImport("kernel32.dll")]
private static extern int GetPrivateProfileString(
   string section,
   string key,
   string def,
   StringBuilder retVal,
   int size,
   string filePath);

Vía GigaOM

En estos casos normalmente no basta con hacer un copia completa del disco duro sobre otro disco, formatear y listo; así sólo conseguiremos tener acceso desde la nueva máquina a los ficheros físicos del sistema anterior, pero no podremos realizar tareas de nivel superior, como copiar configuraciones, exportar o importar datos desde aplicaciones, etc. Y lo que es imposible, en muchos casos, es planificar este movimiento con tanta exactitud que no se quede ni un byte por detrás. Por suerte para este tipo de tareas podemos con cierta tranquilidad era virtualizar el sistema anterior. Esto nos permitiría acceder en vivo a la configuración anterior y traspasar archivos con la seguridad que se necesita.

Y aquí es donde ha entrado en juego Disk2Vhd, la magnífica herramienta de Sysinternals (recomendada por Microsoft), que es capaz de generar un disco duro virtual (archivo con extensión .vhd) a partir de un disco duro físico. Y lo mejor de todo, que puede hacerlo sobre el propio equipo que está generando el volcado, es decir, en caliente.

Para esto es necesario trabajar con Windows XP SP2, Windows Server 2003 SP1 o superiores, incluyendo sistemas x64, y suficiente espacio en un disco duro como para almacenar el archivo resultante del volcado (por ejemplo, en un disco duro externo).

La aplicación es muy sencilla de utilizar. Se descarga desde su sitio web y se ejecuta, no requiere instalación (también puedes descargar directamente desde aquí); tras ello, simplemente debemos elegir los discos a virtualizar, seleccionar una ubicación de salida para el archivo .vhd, esperar unas horas (dependiendo del tamaño) y ya lo tenemos. Normalmente bastará con virtualizar el disco de sistema.

• Primer consejo: Para que la conversión se realice más rápidamente, lo mejor es hacer que el .vhd a generar resida en un disco duro distinto del que estamos virtualizando, aunque se puede realizar sobre el mismo. Una vez con el archivo .vhd a buen recaudo, ya podemos formatear tranquilamente el disco del sistema, montar el nuevo sistema operativo y comenzar a instalar las aplicaciones que vayamos a necesitar.
  Para acceder al sistema anterior tal y como estaba antes de la masacre, basta con instalar Virtual PC, crear una máquina virtual, “engancharle” el disco .vhd que hemos generado, y arrancar normalmente, pero ojo:
• Segundo consejo: haz una copia de seguridad del archivo .vhd antes de realizar cambios sobre el disco duro virtual. Me he encontrado algunos callejones sin salida en los que me ha venido de perlas (p.e., petes del Virtual PC al instalar las Virtual Machine Additions que me dejaban la máquina virtual inutilizada).
  La primera vez que enciendes la máquina virtual se llevará un buen rato arrancando Windows; es lógico, pues todos los controladores que tiene instalados corresponden a la máquina física, y el nuevo entorno debe ser configurado, prácticamente igual que si hubiéramos instalado el disco duro físicamente en otro equipo y arrancáramos desde él. Cuando esta reconfiguración finaliza, podremos utilizar con normalidad la máquina virtual e ir pasando las configuraciones y archivos al nuevo sistema tranquilamente.
• Tercer consejo: revisa la configuración básica de tu máquina virtual para evitar conflictos y funcionamiento anómalo en algunas aplicaciones; nombre de máquina, dirección IP, variables de entorno del sistema operativo, etc. En mi caso, la variable TMP/TEMP apuntaba a una unidad inexistente en el entorno virtual, y provocó algún que otro problemilla.

Y por si lo que queremos acceder a los datos del equipo anterior en bruto, existe la posibilidad de montar un archivo .vhd como si fuera un disco duro más y acceder a su contenido directamente, por lo que podemos evitar la incomodidad de tener que arrancar Virtual PC para todo. Si usas Windows 7 (o 2008), esta capacidad viene “de serie”, sólo tienes que activarla desde el administrador de discos: