Instalar un ASP.NET Starter Kit, paso a paso
Se lo debo a un amigo, y en general que sea para la comunidad. Por cierto, no voy a comentar sobre la estructura del Starter Kit a usar, sólo lo haré funcionar :)
- Buscar el starter kit que deseemos evaluar: http://www.asp.net/community/projects/. Voy a escoger un Starter Kit que aún no haya probado. Escogí: My Web Pages Starter Kit.
- Extraemos los archivos al directorio sobre el cuál vamos a trabajar, y en mi caso, renombro la carpeta, C:\Webs\WebPagesSK.
- Iniciamos Visual Studio o Visual Web Developer Express (descarga Gratuita). Nos vamos al menú File->Open->Web Site, y apuntamos a la carpeta donde esta el starter kit:
- Nota, si lo están abriendo con Visual Studio 2008 les preguntará si desean cambiar la versión del .Net Framework, sobre la cual se va trabajar, yo le voy a dar que si. Que por cierto, no me dejo hacer la actualización ya al extraer el Starter Kit estaba en modo sólo lectura. Si abren con Visual Studio 2005 o Visual Web Developer 2005, no preguntara nada:
- Haciendo sólo eso, ya podemos echarle un ojo a todos los archivos (como lo hicieron, que usaron) del Starter Kit,
ye... ta en C#:
- Hagamos view in browser a la página default.aspx, crucemos los dedos y a ver si funciona :D:
- No puede ser, funciono. Me malogro el plan. Revisando el web.config, entenderemos por que funciona. Esta basado en providers de archivos xml, por eso no tenemos ningún problema :(.
- Pero no se ve nada más que el default.aspx, y el login. Iniciamos sesión con admin;admin, (casi un estándar en los Starter Kits), y podremos configurar el sitio.
- Cambiamos el Look & Feel, agregamos navegación, secciones, cambiamos el tema (hay varios para escoger):
- Subimos algunas imágenes, y o sorpresa, podemos cambiar la vista a Silverlight, o dejarla en html:
Como dicen en la página de descarga, este esta basado en archivos (recién leo eso, mejor, por que de repente ni lo revisaba :D), y no en base de datos. Pero no por eso, se puede decir que no merece la pena revisarlo, cada Starter Kit tiene algo de bueno del cual podemos aprender.
Vamos hacer el intento de nuevo, para que no funcione un Starter Kit, y no quedar mal a la audiencia:
- Ahora vamos a descargar Personal Web Starter Kit.
- Al descargar vamos encontrar este archivo,
alguna vez lo trataba como archivo zip y no pude instalarlo, sólo hacemos doble clic para su instalación:
- E instala plantillas para C# y para VB:
- Ahora abro Visual Web Developer Express 2008 (descarga Gratuita), y tengo una nueva plantilla para mis sitios web, escoge una ruta deseada, escogemos nuestro lenguaje favorito,
escojan C#, y aceptamos:
- Nuevamente nos preguntará si deseamos actualizar la versión del .Net Framework sobre la cual vamos a trabajar. Lo que hace diferente un Web Site con ASP.NET 2.0 y Web Site con ASP.NET 3.5 no debería llamarse ASP.NET 3.5 por cierto, es el web config. Cuando instalamos el Starter Kit, lo instalo con el web.config al estilo ASP.NET 2.0, y es por eso que ahora nos lanza la pregunta, le decimos que si:
- Hacemos view in browser al default.aspx, y ahora si obtenemos lo que buscaba, manos a la obra :D:
- En algunos casos haciendo el View in Browser puede funcionar. Lo que pasa es la mayoría de los Starter Kit (sobre todo los que son instalables), trabajan con SQLExpress en modo attachfile. Si vamos a la carpeta App_Data dentro del sitio Web podemos ver el archivo Persona.mdf, para el modo attachfile de SQLExpress, pero por suerte también tiene los querys para crear la base datos:
- Abrimos los archivos que contienen los querys, con SQL Server Managment Studio, si no tienen una versión de SQL, pueden descargar de manera gratuita SQLExpress, y no se olviden de descargar Management Studio Express. El query que debemos ejecutar es personal-add.sql, como pueden apreciar este query no hace la creación de la base de datos, así que la podemos hacer por query, o con el asistente, llamamos a la base de datos: Personal.
- Si volvemos a ejecutar vamos a ver que tenemos el mismo problema. Revisemos el web.config. Como podrán apreciar hay una cadena de conexión por defecto, esta funcionaría siempre y cuando estemos usando SQLExpress, y además si no hubiésemos cambiado el nombre de la instancia en una instalación avanzada de SQL Express:
- Pero maquillando la cadena de conexión, recuerden que hay varios modos de poner la cadena de conexión, para nuestro escenario tendríamos algo así:
- Ahora ejecuto nuevamente mi página, y voy a obtener este otro error: "Could not find stored procedure 'dbo.aspnet_CheckSchemaVersion'":
- Lo que pasa es, y pasa lo mismo en la mayoría de Starter Kits, que este sitio soporta algunos de los servicios del Page Framework de ASP.NET, como el servicio de Membership y Roles, y aunque estos no están declarados en el web.config, se están haciendo un merge con el archivo machine.config, ubicado en la carpeta "C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG", y si revisan el contenido de este archivo se percatarán que este tiene un valor por defecto para la cadena de conexión LocalSqlServer, y también tiene un provider por defecto para el servicio de Membership y Roles, que usan la cadena de conexión LocalSqlServer. Si ustedes se fijan en la figura del paso 10, removemos la cadena LocalSqlServer, para agregarla nuevamente y así reemplazar a la que existe en el machine.config, pero noten que no es necesario hacer ninguna declaración en el web.config, para usar el servicio Membership, y esto debido a que eso ya esta configurando en el machine.config para trabajar con LocalSqlServer, sólo basta con reemplazar esa cadena de conexión y listo. Tendríamos que declarar el elemento membership en nuestro web.config, si queremos cambiar algún valor por defecto.
- Ahora tenemos que agregar el esquema, que no va hacer otra cosa que agregar tablas y SPs, necesario para que trabaje algunos de los servicios de APS.NET como Membership, Roles, entro otros. Nos vamos a la carpeta C:\Windows\Microsoft.NET\Framework\v2.0.50727, y ejecutamos el archivo aspnet_regsql.exe, que es sencillísimo de usar, este programita es que el agregará las tablas y SPs a nuestra base de datos:
- Ejecutamos nuevamente la página aspx, y ya tenemos la web funcionando (h):
Y eso, la instalación de los otros Starter Kits, es algo parecido. Ahora ya tienen muchos EJEMPLOS WEB para revisar y aprender :).
Saludos,
Post cruzado