Visual Studio Team System : WSS 3.0

[Screencasts] Microsoft Office SharePoint Server 2007

Francisco X. Fagas — Tue, 01 Sep 2009 05:13:09 GMT

En el mes de Junio hice algunos screencasts sobre SharePoint 2007, este es uno de los productos muy utilizados por el Team Foundation Server razón por la cual conocer el potencial de esta herramienta es muy importante para el crecimiento y creación de nuevas características para nuestro equipo de trabajo del TFS.

http://blogs.technet.com/ccaitpro/archive/2009/06/10/snackti-de-colaboraci-n-cero-papel-con-sharepoint.aspx

http://blogs.technet.com/ccaitpro/archive/2009/06/10/snackti-de-colaboraci-n-direccionamiento-de-contenido-utilizando-audiciones.aspx

http://blogs.technet.com/ccaitpro/archive/2009/06/10/snackti-de-colaboraci-n-colaboraci-n-a-nivel-documental-dentro-de-un-sitio-sharepoint.aspx

http://blogs.technet.com/ccaitpro/archive/2009/06/10/snackti-de-colaboraci-n-flujos-de-trabajo-para-agilizar-procesos.aspx

[Cómo hacer] MsiInstallProduct return code: 1603 - Restauración de sitios de Team Foundation Server 2008

Francisco X. Fagas — Mon, 31 Aug 2009 02:44:00 GMT

Descripción del problema

Cuando se trabaja con Team Fundation Server 2008 se pueden distribuir los diferentes productos y componentes que forman parte de la solución en diferentes servidores. Algunas ocasiones los sitios para los team projects que se encuentran en el Team Foundation Server 2008 pueden estar en un servidor de MOSS 2007. Debido a una actualización y desconocimiento del administrador de dicho servidor, en el servidor de MOSS 2007 se pueden eliminar todos los sitios del TFS 2008 y puede que estos no se encuentren respaldados, adicionalmente puede darse el caso que la actualización sea hacia un servidor de 64 bits, a partir de ese momento cuando quieran subir una nueva guía de proceso, crear un Team Project o agregar documentos les presentará un error.

Nota: Se considera para este escenario que se mantiene el nombre del servidor de SharePoint y se crea una aplicación web en el mismo puerto previo a la acción de eliminación.

Solución al problema

El procedimiento normal sería volver a instalar las extensiones del TFS para SharePoint pero debido a que ahora el servidor es de 64 bits es necesario primero descargue desde el sitio de descarga las extensiones de TFS para Sharepoint de 64 bits (WssExt64Bit.msi), de lo contrario al momento de instalar las extensiones que viene en el instalador de TFS 2008 por defecto le presentará el siguiente mensaje de error:

Y en el log del instalador les retornará el siguiente error:

[08/31/09,10:59:49] Setup.exe: AddGlobalCustomProperty
[08/31/09,10:59:49] Microsoft Visual Studio 2008 Team Foundation Server SharePoint Extensions - ENU: ***ERRORLOG EVENT*** : ERROR:SharePoint must be installed to install this product.
[08/31/09,10:59:49] Setup.exe: AddGlobalCustomProperty
[08/31/09,10:59:50] Microsoft Visual Studio 2008 Team Foundation Server SharePoint Extensions - ENU: ***ERRORLOG EVENT*** : ACTION FAILURE:Action ended 10:59:49: CA_LaunchCondition_STSADM_Present. Return value 3.See MSI log for details.
[08/31/09,10:59:50] Setup.exe: AddGlobalCustomProperty
[08/31/09,10:59:50] Microsoft Visual Studio 2008 Team Foundation Server SharePoint Extensions - ENU: ***ERRORLOG EVENT*** : ACTION FAILURE:Action ended 10:59:50: INSTALL. Return value 3.See MSI log for details.
[08/31/09,10:59:50] Microsoft Visual Studio 2008 Team Foundation Server SharePoint Extensions - ENU: CRootComponent::Install(): Finished MSI Installation
[08/31/09,10:59:50] Microsoft Visual Studio 2008 Team Foundation Server SharePoint Extensions - ENU: MsiInstallProduct return code: 1603.

Nota: el link hace referencia al release de octubre de 2008, procure que sea el último release.

Al finalizar la instalación de las extensiones del TFS para SharePoint vuelva a ingresar los valores anteriores en la configuración de las extensiones de SharePoint indicando las siguientes urls: sitios de TFS http://servidorsharepoint:puerto/sites, servidor de reportes: http://servidorreportes/reports y report server: http://servidorreportes/reportserver.

A partir de esta configuración ya podrá volver a utilizar el Team Foundation Server con normalidad.

Para los Team Projects existentes una solución sería crear los sitios desde la administración central de SharePoint (Nota: Por razones de seguridad he borrado direcciones de servidor).

a. Desde la herramienta central de administración de MOSS 2007 seleccionar la aplicación web que contendrá los sitios de los proyectos.

b. Una vez seleccionada la aplicación se debe seleccionar crear colección de sitios

c. En la pantalla de creación de sitios escribir el mismo nombre del team project en los campos: title y url, en la sección de la plantilla seleccionar la plantilla de su guía de proceso y en el administrador ingresar tfssetup, dar clic en aceptar.

[VS2008 – WWF – MOSS 2007] ¿Cómo crear tareas paralelas en MOSS 2007 desde Visual Studio 2008 ?

Francisco X. Fagas — Mon, 16 Mar 2009 16:44:29 GMT

Introducción

En un artículo anterior publiqué cómo crear una tarea en MOSS 2007, en este artículo aprenderá cómo crear tareas paralelas en MOSS 2007 utilizando Visual Studio 2008 Team Developer, Visual Studio 2008 nos permite crear de manera sencilla (al estilo Microsoft) flujos de trabajo para SharePoint, para esto disponemos de plantillas de proyecto al momento de empezar con la creación del mismo, en Microsoft Office SharePoint 2007 (MOSS 2007) podemos crear tareas en serie o en paralelo, las mismas que para crearlas las podemos hacer utilizando diferentes herramientas disponibles en el toolbox de Visual Studio 2008, en esta ocasión utilizaremos el replicator para la creación de las actividades en paralelo.

Les recomiendo leer el artículo anteriormente mencionado y descargar su código ya que reutilizaremos el ejemplo anterior para la creación de las tareas. El código fuente del presente artículo lo pueden descargar de aquí:

Descargar código Fuente.

Software Requerido

Windows Server 2003 o superior
Microsoft Office SharePoint 2007 (instalación stand alone)
Visual Studio 2008 Team Developer

Desarrollo

Empiece abriendo Visual Studio 2008 y agregando un nuevo proyecto a la solución anterior.

De la lista de Tipos de Proyectos seleccione Workflow y luego de la lista de plantillas SharePoint 2007 Sequential Workflow, le asigna un nombre a su proyecto y de clic en Ok.

Visual Studio 2008 iniciará un asistente, el cual en esta primera ventana deberá asignarle el nombre de su flujo de trabajo que desea que aparezca en SharePoint, e ingresar la url del sitio sobre el cual va a publicar el flujo de trabajo, Visual Studio 2008 en plataformas de 32 bits le permite publicar y hacer debug de sus flujos de trabajo para MOSS 2007, para lo cual utilizará la url proporcionada en este paso.

Si usted desea puede marcar para que automáticamente se asocie el flujo de trabajo que va a desarrollar con una librería en particular, caso contrario lo puede realizar manualmente utilizando comandos. Para la asociación automática debemos tener claro que significa cada elemento listado en este paso del asistente. El flujo de trabajo se debe asociar a una lista, esta lista será quien inicie el flujo de trabajo bajo ciertas condiciones, la lista de historial me permitirá almacenar toda la información relacionada al flujo de trabajo, por ejemplo: cuando inicio el flujo, cierta actividad, cuanto terminó, quién la terminó, etc., por último tenemos que seleccionar la lista de tareas, en esta lista el flujo de trabajo creará las tareas que nosotros le indiquemos. Antes de continuar y una vez entendido lo anterior pensemos en el siguiente escenario: Tenemos una librería de documentos que cada vez que se modifique un documento este deba ser aprobado por la persona X, persona Y o persona Z (esto implica que cualquiera de dichos usuarios puede aprobar el documento, es decir, estamos hablando de un flujo de aprobación en paralelo), para que dichos usuarios se enteren de que deben aprobar el documento debemos crear tareas y asignárselas para esto utilizaremos la lista de tareas.

En este paso final del asistente debemos seleccionar cuando queremos que el flujo de trabajo se inicie, basándonos en el ejemplo anterior debería seleccionar cuando el elemento cambie, pero en este caso yo quiero iniciar el flujo manualmente, razón por la cual selecciono sólo la primera acción.

Una vez terminado el asistente se abrirá el diseñador del flujo, recuerden que para la creación de una tarea utilizaremos el ejemplo publicado en el artículo anterior, por lo cual debemos a este proyecto agregar la referencia al mismo.

En la ventana de referencias seleccione de proyectos BasicTaskActivity.

En ese momento en el toolbox veremos el componente WssTaskActivity, pero antes de agregarlo debemos insertar en el flujo de trabajo el componente que realizará la creación de las tareas en paralelo, para lo cual seleccionen el componente replicator y llévenlo hacia el área de trabajo, luego seleccionen WssTaskActivity e insértenlo dentro del replicator.

La siguiente es la vista del flujo de trabajo con el replicator insertado. Le damos doble clic sobre el componente onWorkflowActivated1, para proceder a inicializar variables.

Una vez realizado lo anterior, vamos al código del flujo de trabajo y defina las siguientes variables públicas:

//Contendrá la lista de aprobadores.
public IList approversList;
//Bandera que se utilizará para determinar si la tarea actual
//fue completada o no, por defecto es falso.
public bool isActualTaskCompleted = false;

En este ejemplo quemaremos en el código la lista de aprobadores, pero debemos tener en cuenta que los aprobadores los podemos obtener de cualquier objeto.

private void onWorkflowActivated1_Invoked(object sender, ExternalDataEventArgs e)
{
   approversList = new ArrayList();
   approversList.Add("igec\\ffagas");
   approversList.Add("igec\\user1a");
   approversList.Add("igec\\user2a");
}

Una vez inicializada la lista de aprobadores regresamos a la vista de diseño del flujo de trabajo y procedemos a configurar las propiedades del replicator, lo primero que debemos hacer es vincular la variable approversList con la propiedad InitialChildData, el replicator utilizará esta lista para la creación de las actividades, veamos al replicator como un foreach, lo que implica que no debemos programar el avance al siguiente elemento de la lista, el replicator permite dos tipos de iteraciones en serie o en paralelo, por defecto está en serie, procedamos a cambiarlo a paralelo.

Luego, procedemos a programar los siguientes métodos del replicator, para lo cual en la lista de propiedades ingrese el nombre del método y enter, automáticamente el VS abrirá la vista de código del flujo:

private void ParallelChildInitialized(object sender, ReplicatorChildEventArgs e)
{
  /* Debemos hacer un cast de la actividad que está actualmente instanciada
     con la actividad que creamos en el proyecto anterior, para 
     poder tener acceso 
     a las propiedades públicas de la misma. Estas propiedades 
     nos permitirán asignar a un usuario,
     la descripción, título, ID (es un GUID), y el campo de estado de la tarea.
  */
  //Recuerde que los usuarios a los que se va a asignar la tarea se encuentran en la lista,
  //entonces debe hacer referencia al dato actualmente instanciado y asignarselo al campo público de la actividad.
  (e.Activity as BasicTaskActivity.WssTaskActivity).strAsignadoA = e.InstanceData.ToString();
  (e.Activity as BasicTaskActivity.WssTaskActivity).strDescripcion = "Demo Tarea Paralelas";
  (e.Activity as BasicTaskActivity.WssTaskActivity).strTitulo = "Demo Tarea Paralela";
  (e.Activity as BasicTaskActivity.WssTaskActivity).taskId = Guid.NewGuid();
  // Para obtener información de una columna de sharepoint la debemos instanciar por su GUID, 
para lo cual utilizaremos las propiedades del flujo,
  // instanciamos la lista de tareas, luego sus campos y le pasamos como 
parametro el nombre que se muestra en sharepoint
  // en este caso me interesa conocer la información del campo estado, y obtengo su ID (GUID) 
que utilizará el WssTaskActivity para obtener la información
  // del estado actual de la tarea 
  (e.Activity as BasicTaskActivity.WssTaskActivity).idCampoEstado = 
workflowProperties.TaskList.Fields["Estado"].Id;
}

 private void ParallelChildCompleted(object sender, ReplicatorChildEventArgs e)
        {
// Validamos cada vez que se complete una actividad hija del 
replicator el estado actual de la tarea
// si la tarea fue completada, cambiamos el estado de la 
variable isActualTaskCompleted a True.
            if ((e.Activity as BasicTaskActivity.WssTaskActivity).esTareaCompletada)
            {
                this.isActualTaskCompleted = true;
            }
        }


/*Este método corresponde a la condición del replicator, 
debe seleccionar en el tipo de condición (Until Condition)
código, y luego insertar el siguiente método, y le asignamos 
el valor de la variable this.isActualTaskCompleted, con esto
cuando un usuario complete la tarea el flujo terminará.
*/
private void ParallelTasksNotCompleteCondition(object sender, ConditionalEventArgs e)
        {
            e.Result = this.isActualTaskCompleted;
        }

Una vez realizado lo anterior, compilamos y ejecutamos el flujo de trabajo, esto le abrirá un navegador y deberá inicializar el flujo manualmente:

De la lista de flujos de trabajo seleccionamos el que acabamos de publicar y le aparecerá que la operación de inicialización está en proceso.

A continuación en el estado del flujo de trabajo veremos que se ha creado las tareas para los usuarios que configuramos en la lista

Seleccionamos cualquiera de ellas y editamos su estado

Seleccionamos completada. (Tenga en cuenta que si su sharepoint está en español deberá cambiar el código de la tarea personalizada), por lo siguiente:

private void cambiaTarea_Invoked(object sender, ExternalDataEventArgs e)
        {
            string estado = 
cambiaTarea_AfterProperties1.ExtendedProperties[idCampoEstado].ToString();
            if (estado != null)
            {
                if (estado.Equals("Completada"))
                    this.esTareaCompletada = true;
            }
        }

Luego de completar la tarea el flujo aparecerá con un estado ya no en curso sino en Finalizado.

[MOSS 2007 – VS Team Test] ¿Puedo Ejecutar Pruebas Web a Sitios de SharePoint Utilizando Team Test?

Francisco X. Fagas — Sun, 02 Nov 2008 05:25:45 GMT

Con Visual Studio Team Test podemos ejecutar pruebas como manuales, unitarias, web, carga, etc, en este artículo les hablaré de cómo ejecutar pruebas web sobre sitios implementados con Microsoft Office SharePoint Server 2007 (MOSS 2007), la prueba que realizaré es ingresar a un sitio básico, luego dirigirme al subsitio de documentos y abrir una librería documental, para lo cual debemos considerar que los usuarios que van a ingresar son usuarios de un directorio activo y que antes de ingresar al sitio deberán digitar sus credenciales, el sitio que vamos a probar se muestra a continuación:

Para ejecutar la prueba antes descrita vamos a empezar creando un nuevo proyecto de pruebas.

Una vez creado el proyecto de pruebas, agregaremos una nueva prueba de tipo web que llamaré MossTestNav1.

Al momento que creamos la prueba web Visual Studio abrirá un IE para grabar la secuencia de la prueba que deseamos ejecutar (El sitio solicitará el usuario y contraseña antes de abrir el sitio)

(Subsitio de Documentos)

(Librería Documental)

Al finalizar la secuencia para detener la grabación de la misma deben dar clic en Stop. Luego mandamos a ejecutar la prueba guardada con la herramienta y tendremos el siguiente resultado (Podemos observar que los 3 request retornan error y en la vista del navegador observamos el mensaje: Usted no está autorizado para ver esta página), este error se da porque no le estamos pasamos las credenciales del usuario con el que deseamos ejecutar la prueba.

Con Visual Studio 2008 Team Test podemos configurar data sources (orígenes de datos) para ejecutar nuestra pruebas, estos orígenes de datos para pruebas web pueden ser bases de datos, archivos csv y xml, para este caso crearé un archivo xml llamado usuarios y agregaré 4 usuarios con su respectiva contraseña:

Una vez creado el archivo xml retorno a Visual Studio y en la prueba web selecciono “Agregar Data Source” (En la imagen a continuación ver 1), luego en el asistente selecciono “XML file”.

A continuación selecciono el archivo anteriormente creado.

Seleccionamos la tabla que vamos a utilizar para esta prueba y cerramos el asistente con Finalizar.

Una vez configurado el data source debemos establecer las credenciales de la prueba, para esto junto a “Agregar Data Source” existe un botón “Set Credentials”, en el cuadro de dialogo seleccionamos los campos de la tabla del data source que corresponde al nombre de usuario y contraseña.

Una vez realizadas estas configuraciones volvamos a ejecutar la prueba web, ahora podremos observar que no recibimos error y en el tab “Web Browser” vemos que se ha iniciado sesión con el primer usuario que configuramos en el archivo usuarios.xml (Nota: el usuario intranetadmin constituye para el sitio el usuario cuenta del sistema).

En el caso anterior la prueba web se ejecutó una sola vez debido a que así estaba configurado, si queremos ejecutar la misma prueba web para varios usuarios y validar el nivel de permisos de los mismos y determinar que esta viendo cada usuario de la intranet, en la ventana de resultados de la prueba web den clic sobre “Edit run settings”, a continuación se les presentará el siguiente cuadro de dialogo dobre procedemos a cambiar el número de ejecuciones de “Fixed run count (1)” a “One run per data source row”

Para finalizar, ejecutamos nuevamente la prueba web y esta vez podemos observar que se ejecuta 4 veces (debido a que tenemos 4 entradas en el data source), comparemos el resultado de la ejecución anterior (ejecución con cuenta del sistema) con la ejecución actual, en la vista del web browser nos podemos dar cuenta que con el usuario que inició sesión en la segunda ejecución corresponde a la segunda entrada del data source (user1a) y debido a que este usuario solo tiene nivel de permisos de lector no aparece ningún link de acciones administrativas como “Acciones del sitio”.

(Resultado ejecución anterior de la prueba)

(Resultado ejecución actual de la prueba)

[MOSS 2007]¿ Puedo instalar WSS 3 o MOSS 2007 en Windows Server 2008 con SQL Server 2008?

Francisco X. Fagas — Tue, 02 Sep 2008 19:16:47 GMT

Hace unos días atrás durante una reunión con comunidades me hicieron esta pregunta, pues la respuesta es muy sencilla si y la forma de instalarlo es la misma como si fuera sobre un Windows Server 2003 con SQL Server 2005, pero debes tener en cuenta los siguientes tips:

En Windows Server 2008 debes agregar dos roles a tu servidor: Application Server y Web Server.
Debes instalar el .Net Framework 3.5 y el Sp1 (Requerido para instalar SQL Server 2008 - mas detalle puedes encontrarlo aquí), si vas a utilizar a RS integrado con MOSS 2007 les recomiendo que durante la instalación de SQL Server 2008 simplemente instalen pero no configuren el RS, luego lo configurarán manualmente en base a su arquitectura física de la implementación (Deben utilizar el SQL Server 2008 Reporting Services Add-in. Recuerden también este tip)
Debes instalar el WSS 3.0 o MOSS 2007 con SP1. Si tienen el instalador sin SP y el SP lo descargaron por separado, lo que deben hacer es copiar el instalador en el disco del servidor, así como el SP de WSS y MOSS, luego para cada instalador ejecuten lo siguiente:

%nombre_de_instalador_sp_WSS/MOSS.exe% /extract:C:\SP%WSS/MOSS%

*Lo que se encuentra entre %% es variable dependerá del nombre del instalador del SP y así mismo para el nombre de la carpeta donde van a extraer los archivos.

Finalmente copien el contenido extraido de cada SP de WSS y MOSS 2007 y peguenlo en la carpeta update del instalador de MOSS 2007.

[MOSS 2007 - VS2008] Mejores prácticas al momento de utilizar objetos de Windows SharePoint Services

Francisco X. Fagas — Tue, 12 Aug 2008 05:10:48 GMT

Tal como comenté en un post anterior respaldando mi información me encontré con este artículo que revisé antes de presentarme a dar mi examen de certificación de desarrollo de aplicaciones con MOSS 2007 por Junio del año pasado y que durante todo este tiempo me ha sido de mucha utilidad para escribir código de manera correcta y optimizado, el artículo lo pueden encontrar aquí.