Visual Studio Team System : MOSS 2007

[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

[VSTS 2010] Instalación del Team Foundation Server 2010

Francisco X. Fagas — Mon, 31 Aug 2009 22:46:00 GMT

Nota: El procedimiento de instalación se realizó con el Beta 1 de TFS 2010.

Tal como había ofrecido en Junio en el post de instalación de Visual Studio 2010 y que por razones de tiempo y trabajo me he alejado un poco de mi blog, pero bueno todo ha sido superado exitosamente y me tienen nuevamente escribiendo. Para las personas que vienen utilizando versiones anteriores del Team Foundation Server 2005/2008 la instalación del Team Foundation Server 2010 será un alivio, el proceso de configuración de los diferentes productos es mucho mas transparente, y que puede considerarse como una de las nuevas características del TFS 2010, así como la capacidad de poder definir varios team projects collections, los mismos que puede contener varios team projects, tal como manejamos los sitios en SharePoint, esto facilita las tareas administrativas.

La instalación que hice fue en un ambiente virtualizado con un controlador de dominio en Windows Server 2003, y en otro servidor con Windows Server 2008, SQL Server 2008 y Microsoft Office SharePoint Server 2007.

Previo a la instalación se debe levantar el servicio de IIS, instalar SQL Server 2008 y MOSS 2007.

Instalación del TFS

Primero debemos ejecutar el instalador del Team Foundation Server 2010, aceptar los términos de licencia.

Seleccionar los componentes que se van a instalar, en este caso seleccionamos todos los componentes:

Al finalizar la instalación habilite la casilla de verificación para ejecutar la herramienta de configuración del TFS.

Instalación de las extensiones de SharePoint

Configuración del Team Foundation Server

De la ventana de configuración seleccionamos configuración personalizada.

Iniciamos el asistente

Ventana de bienvenida del asistente de configuración personalizada

Base de Datos de Configuración

Ingresamos el nombre del servidor de base de datos y su instancia.

Capa de Aplicación

Configuramos la cuenta de servicio, y el sitio web, puerto y directorio virtual para los servicios del TFS

Configuración de Repoting

Habilitamos la casilla de verificación para configurar reporting services para utilizar TFS

Ingresamos el nombre del servidor de reporting services y selecciona las urls del report server y report manager.

Ingresa el nombre del servidor que contiene el Analysis Services para el cubo del TFS

Ingresa la cuenta que utilizará el RS para la generación de los reportes del TFS.

Habilite configurar sharepoint en este momento.

Configuramos la url donde se ubicaran los team sites y de la herramienta central de administración

Creamos un team project collection por defecto

Vista de resumen de la configuración ingresada en los pasos anteriores

Inicio del proceso de configuración

Finalización del proceso de configuración

Habilitar el servicio de Single Sign On (SSO)

Nota: El servicio de SSO lo debemos configurar para los reportes de Excel Services y la correcta visualización del dashboard.

En SQL Server creamos un login para la cuenta de servicio de SSO.

Le asignamos los respectivos permisos

Desde el administrador de servicios del Server manager configuramos el servicio de Microsoft Single Sign-On

Una vez configurada la cuenta de inicio del servicio, lo iniciamos

Abrimos la herramienta central de administración del MOSS 2007.

Verificamos que la cuenta de servicio del SSO este dentro del grupo de administradores de la granja del MOSS 2007 (Para ingresar a la siguiente ventana desde las acciones del sitio debe seleccionar personas y grupos)

Regresamos a la pestaña de operaciones y seleccionamos “Administración de las configuraciones de SSO” de la sección de configuración de seguridad, luego en la siguiente ventana seleccionamos administrar configuraciones del servidor.

Configuramos la cuenta de servicio y el grupo de los usuarios de sso (Nota: la cuenta de inicio de servicio de SSO debe pertenecer a este grupo.)

Luego respaldamos el encryption key desde la opción de administración de clave de encriptación

Luego creamos una nueva definición haciendo clic sobre “Manage settings for enterprise application definitions”.

Para finalizar la configuración del SSO debemos ir al proveedor de servicios compartidos al que pertenece la aplicación web que contendrá los team sites y debemos agregar dicha url dentro de los sitios de confianza de excel services. Descargar documento de referencia.

Prueba de creación de un Team Project

Nos conectamos desde un equipo cliente con VS 2010 y creamos un Team project (similar a lo realizado en versiones anteriores) y abrimos el team site:

Nota: El Team Foundation Web Access está integrado al team site mediante web parts de sharepoint.

[MOSS 2007 - SSRS2008] Componentes de integración de SQL Server Reporting Services no aparece en la Administración de Aplicaciones de la Herramienta Central de Administración de SharePoint 2007

Francisco X. Fagas — Mon, 31 Aug 2009 03:50:27 GMT

En esta última semana me volví a encontrar con el mismo problema de integración entre MOSS 2007 y SSRS 2008, la solución que publiqué hace algún tiempo atrás, también aplica para esta versión de SSRS 2008.

La solución está en el siguiente link: http://msmvps.com/blogs/ffagas/archive/2008/08/11/moss-2007-ssrs2005-componentes-de-integraci-243-n-de-sql-server-reporting-services-no-aparece-en-la-administraci-243-n-de-aplicaciones-de-la-herramienta-central-de-administraci-243-n-de-sharepoint-2007.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í.

[MOSS 2007 - SSRS2005] Componentes de integración de SQL Server Reporting Services no aparece en la Administración de Aplicaciones de la Herramienta Central de Administración de SharePoint 2007

Francisco X. Fagas — Mon, 11 Aug 2008 22:50:00 GMT

Respaldando unos documentos de implementaciones de SharePoint 2007 que he realizado con algunos clientes me encontré con un problema que tuvimos por diciembre del año pasado mientras implementábamos una solución de intranet cuyos reportes de Reporting Services debían estar en una librería de reportes de MOSS 2007, en la actualidad no he tenido que volver a implementar una solución de este tipo pero en aquel tiempo me encontré con el problema de que pese de haber instalado correctamente el SP2 de SQL Server 2005, configurado Reporting Services 2005 de manera correcta para la integración con MOSS 2007 e instalado el RSIntegration Add-In sin ningún error, cuando íbamos a la Herramienta Central de Administración de SharePoint 2007 en la sección de Administración de Aplicaciones no aparecían los en laces para continuar la configuración de Reporting Services, si usted tiene el mismo problema siga los siguientes pasos para instalar correctamente y poder utilizar esta característica:

Instale el SP 2 de SQL Server 2005
Configure SSRS 2005 en modo integración con MOSS 2007
Al momento de instalar el RSIntegration Add-In primero abra una ventana del command prompt de Windows y ubíquese en la carpeta donde se encuentra el instalador a continuación ejecute el siguiente comando (el nombre de mi instalador corresponde al instalador para servidores de 64 bits ya que el servidor de producción era un Blade con procesador AMD de 64 bits):

SharePointRS_x64ESN.msi SKIPCA=1 (A continuación de clic Next)

Luego desde el explorador de Windows ubique la siguiente ruta \Documents and Settings\<su nombre>\LOCALS~1\Temp
Regrese al command prompt y digite CD \Documents and Settings\<Intranetadmin>\LOCALS~1\Temp
Una vez ubicado en la ruta mencionada anteriormente en el command prompt digite:

rsCustomAction.exe /i

De esta forma tenemos los componentes de Reporting Services instalados en el Servidor de MOSS 2007.

[VS2008 -WWF- MOSS 2007] ¿Cómo crear actividades personalizadas?

Francisco X. Fagas — Thu, 07 Aug 2008 21:25:00 GMT

Introducción

En este artículo aprenderá cómo crear una actividad personalizada utilizando Visual Studio 2008, esta actividad contendrá los pasos básicos necesarios para asignar una tarea en MOSS 2007 a un usuario, la misma que esperará a que este la complete, en una segunda publicación aprenderá cómo utilizar ésta actividad personalizada en un flujo de trabajo para MOSS 2007.

Para poder utilizar esta actividad en un flujo para MOSS 2007 deberá ser firmada con un strong name (La clave para quienes descarguen el codigo de ejemplo es Password1) y publicada en el GAC del servidor de MOSS 2007.

Descargar código Fuente.

Software Requerido

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

Desarrollo

Empiece abriendo Visual Studio 2008 y cree un nuevo proyecto.

Los flujos de trabajo para MOSS 2007 son flujos de Windows WorkFlow Foundation, por lo tanto de la lista de Project types seleccione Workflow, y luego seleccione la plantilla Workflow Activity Library, en el nombre del proyecto ingrese BasicTaskActivity.

Una vez creado el proyecto deberá firmar el assembly con un strong name, para lo cual haga clic derecho sobre el proyecto y seleccione propiedades, en la ventana de propiedades diríjase al tab signing.

Active la casilla Sign Assembly y seleccione new para crear un nuevo archivo de clave, deberá ingresar un nombre y una clave antes de dar clic en OK.

Una vez creado cierre la ventana de propiedades. Para poder utilizar las actividades para MOSS 2007 deberá agregar la referencia de los siguientes assemblies:

Identity	Description
Microsoft.Sharepoint	Windows® SharePoint® Services
Microsoft.SharePoint.WorkflowActions	Windows® SharePoint® Services Workflow Actions

Utilice el nombre que aparece en description (ver tabla anterior) para agregar las referencias.

Luego proceda a renombrar la actividad llamándola WssTaskActivity.cs

Vaya al código de la actividad personalizada y dentro de la clase agregue la siguiente definición de variables, las cuales servirán como parámetros de entrada cuando agregue la actividad a un flujo de aprobación de MOSS 2007.

#region Public Parameters

public Guid idCampoEstado;

public string strAsignadoA;

public string strTitulo;

public string strDescripcion;

public DateTime dtDuración;

public bool bEnviarNotificación;

#endregion

En el toolbox de VS 2008 existen las actividades necesarias para gestionar tareas de MOSS 2007, así como para enviar email, registrar mensajes en el historial del flujo de trabajo, etc.

Luego deberá agregar las siguientes actividades con sus respectivas propiedades en el área de diseño de la actividad que estamos creando.

Paso	Grupo	Actividad
Ver Paso A	SharePoint Workflow	CreateTask
Ver Paso B	Windows Workflow v3.0	While
Ver Paso C	SharePoint Workflow	OnTaskChanged
Ver Paso D	SharePoint Workflow	CompleteTask

Paso A

Configure las siguientes propiedades de la actividad CreateTask:

(Name): Ingrese Crear Tarea

CorrelationToken: Ingrese TaskToken

OwnerActivityName: Seleccione WssTaskActivity

Invoked: Ingrese CrearTarea_MethodInvoking y presione enter. El código del método será el siguiente:

private void CrearTarea_MethodInvoking(object sender, EventArgs e)

{

taskId = Guid.NewGuid();

CrearTarea_TaskProperties1.AssignedTo = this.strAsignadoA;

CrearTarea_TaskProperties1.Title = this.strTitulo;

CrearTarea_TaskProperties1.Description = this.strDescripcion;

CrearTarea_TaskProperties1.DueDate = this.dtDuración;

CrearTarea_TaskProperties1.SendEmailNotification = this.bEnviarNotificación;

}

TaskId:

Para configurar esta propiedad deberá ir al código de la actividad y declarar una variable pública llamada taskId.

public Guid taskId;

Luego regrese a la vista de diseño y en la propiedad TaskId de clic sobre el botón '…' y seleccione la variable que acaba de definir.

TaskProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

Paso B

(Name): Ingrese mientrasTareaNoCompletada

Condition: Seleccione Code Condition. Luego expanda la propiedad e ingrese el siguiente nombre para el método: CodeConditionMethod.

Una vez en el código agregue otro campo público:

public bool taskCompleted = false;

El método deberá quedar de la siguiente forma:

private void CodeConditionMethod(object sender, ConditionalEventArgs e)

{

e.Result = !taskCompleted;

}

Paso C

(Name): Ingrese CambiaTarea

CorrelationToken: Seleccione TaskToken

Invoked: Ingrese cambiaTarea_Invoked y presione enter. El código del método será el siguiente:

private void cambiaTarea_Invoked(object sender, ExternalDataEventArgs e)

{

string estado=cambiaTarea_AfterProperties1.ExtendedProperties[this.idCampoEstado].ToString();

if (estado != null)

{

if (estado.Equals("Completed"))

this.tareaCompletada = true;

}

AfterProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

BeforeProperties: De clic en el botón '…', luego en el tab Bind to a new member seleccione Create Field.

TaskId: De clic en el botón '…', y seleccione la propiedad TaskId de la actividad Crear Tarea.

Paso D

(Name): Ingrese TareaCompletada

CorrelationToken: Seleccione TaskToken

TaskId: De clic en el botón '…', y seleccione la propiedad TaskId de la actividad Crear Tarea.

Finalmente, compile el proyecto y registre la librería en el GAC y a partir de este momento podrá utilizar esta actividad personalizada en los flujos para MOSS 2007 que desarrolle con Visual Studio 2008.

[VSTS Team Architect Rosario April CTP] Cómo elaborar el diagrama de secuencia del inicializador de un WorkfFlow para SharePoint 2007

Francisco X. Fagas — Wed, 06 Aug 2008 14:33:00 GMT

En estos días me encuentro probando la aplicabilidad de los nuevos diagramas del Visual Studio "Rosario" Team Architect, y luego de algunas pruebas quise elaborar el diagrama de secuencia de la inicialización de los componentes para un flujo de trabajo que desarrollé para MOSS 2007, para esto realicé los siguientes pasos:

Importe la solución completa a mi máquina virtual de Rosario (April CTP) y lo abrí en VS "Rosario".
En el proyecto IG.DocumentMangement.WorkFlows (Este es el proyecto que contiene los flujos de trabajo), agregué un nuevo diagrama de secuencia de la siguiente forma:
1. Clic derecho sobre el proyecto, luego seleccionan Add -> New Item
2. Luego seleccionan la categoría general y en templates seleccionan sequence diagram, le asignan un nombre al diagrama y dan clic en Add.
3. Luego abren el Architecture Explorer (View -> Architecture Explorer)
4. En el Architecture Explorer van navegando desde la solución seleccionando Contains para que en la siguiente lista se muestre el contenido del componente(Solución - Proyecto - Clase - Miembros de clase) que seleccionaron en la lista anterior.
5. Una vez que han seleccionado el proyecto continúan seleccionando la clase, nuevamente contains para que puedan ver los métodos, seleccionamos el método InitializeComponent.
6. Finalmente seleccionan Insert Into Active Diagram y automáticamente VS generará la secuencia que sigue el método para construir los componentes que forman parte de su flujo de trabajo para MOSS 2007 :D. (Tip: dandole clic derecho sobre el área de trabajo del diseñador puede seleccionar la opción para exportar el diagrama como imagen, la cual estoy pegando a continuación).

[C# - VS 2008] Cómo crear atributos personalizados para Enumerados

Francisco X. Fagas — Tue, 05 Aug 2008 13:03:00 GMT

Los enumerados son listas constantes agrupables que por defecto empiezan en 0 y que una utilidad es que facilitan a nivel de desarrollo evitar que se pasen valores fuera de rango a objetos, o dato basura, evitar escribir código de validación del parámetro que estamos recibiendo, para encontrar más información básica sobre enumerados aquí, pero cuando trabajamos con enumerados puede darse el caso de que necesitemos extraer su valor equivalente en string y no entero, por ejemplo que para si queremos representar en nuestro sistema un objeto WorkFlowType cuyo valor lo debe extraer de MOSS 2007 en español, pues para este caso como entrada y salida de nuestro sistema necesitamos que el enumerado represente a un string, pues para este caso podemos utilizar un atributo personalizable (ValorString) para poder representar el enumerado de la siguiente manera:

[Serializable]

public enum WorkFlowType

{

[ValorString("Ninguno")]

Empty,

[ValorString("En Serie")]

Serial,

[ValorString("En Paralelo")]

Parallel

};

Para que este código funcione y el compilador no les retorne un error lo que se debe hacer es escribir una clase que represente a un atributo, para esto la clase debe:

Heredar de la clase Attribute del espacio de nombres System.
Debe contener un campo de tipo string, el constructor debe recibir un string para inicializar el campo, y una propiedad de sólo lectura que retorne el valor que contiene el campo.

La clase completa es:

[Serializable]

public class AtributoValorString : System.Attribute

{

#region Fields

private string _valor;

#endregion

#region Constructor

public AtributoValorString(string parametro)

{

_valor = parametro;

}

#endregion

#region Properties

public string ValorString

{

get { return _valor; }

}

#endregion

}

Para finalizar debemos crear un nuevo método extendido (Extension Method – Nueva característica de lenguaje C# en VS 2008), no olviden agregar el namespace reflection:

using System.Reflection;

[Serializable]

public static class Utilitarios

{

public static string ObtenerValorString(this Enum value)

{

// Obtiene el tipo

Type type = value.GetType();

// Obtiene el fieldinfo para este tipo

FieldInfo fieldInfo = type.GetField(value.ToString());

// Obtiene el atributo ValorString

AtributoValorString [] attribs = fieldInfo.GetCustomAttributes(

typeof(AtributoValorString), false) as AtributoValorString[];

// Retorna el primer elemento.

return attribs.Length > 0 ? attribs[0].StringValue : null;

}

Cuando utilicemos el enumerado ahora veremos que podemos utilizar el método extendido que acabamos de crear:

WorkFlowType.Serial.ObtenerValorString()

[MOSS 2007 - VS 2008] Tip Workflows para MOSS 2007 con VS 2008

Francisco X. Fagas — Tue, 05 Aug 2008 11:37:00 GMT

Me he tenido que alejar un poco de mi blog debido a un proyecto en el que estado trabajando un Framework de Gestión Documental ISO para MOSS 2007 el cual ya lo pasé a producción y ahora tendré un poco más de tiempo hasta que me asignen a otro proyecto ;-), aunque ya llevo 1 año desarrollando aplicaciones para MOSS 2007 este proyecto en particular fue un reto debido a que ciertos requerimientos requerían implementar código complejo, por ejemplo el Framework es totalmente parametrizable ya que el sistema es capaz de soportar cualquier documento ya sea para ISO 9001, 14000, 22000 e incluso documentos no controlados (denominación para documentos que no forman parte del ningún sistema de gestión documental pero que se debe llevar un historial y debe estar habilitado para ejecutar acciones ISO), pero bueno cuando llegó el momento de la implementación del flujo de trabajo ningún flujo de MOSS 2007 ni con SharePoint Designer 2007 se podía implementar , se implementó un flujo utilizando la plantilla Sequential WorkFlow for SharePoint 2007 utilizando Visual Srudio 2008, ah y lo más importante es que la administración del ciclo de vida de desarrollo de este sistema se realizó con VISUAL STUDIO TEAM SYSTEM 2008 ;-), algunas consideraciones importantes que se debieron enfrentar en la implementación fueron:

El flujo en base a propiedades el documento debía ejecutar un flujo en serie o en paralelo.
Si los emisores eran los mismos que los aprobadores se debía aprobar automáticamente.
Los emisores, aprobadores y distribución del documento no eran usuarios de MOSS eran grupos de AD que reflejaban un rol, por ejemplo: el emisor podría ser: Asistente de RRHH, quien aprobaba era el Gerente de RRHH y un segundo aprobador Administrador de Documentación, y por último la distribución dependiendo de un campo del documento podría tomar de un campo llamado distribución del documento o leer los usuarios que tenían permisos sobre la carpeta que contenía el documento, de igual forma eran grupos del directorio activo.
Al final del flujo debía enviar notificación con el resultado de la aprobación a todos los involucrados: emisores, aprobadores y distribución.
La aprobación en serie era una aprobación en serie a nivel de grupos y en paralelo a nivel de usuarios, es decir, pensemos en un documento cuyos aprobadores son: GrupoA; Grupo B, al inicia el flujo en serie empezaría por el grupo a, y debería crear tareas de aprobación en paralelo para todos los usuarios que pertenecen al Grupo A, una vez que algún miembro de dicho grupo apruebe el flujo debería continuar al siguiente Grupo de aprobadores y hacer lo mismo que hizo para el Grupo anterior. Recordemos que los grupos son del AD.
La aprobación en paralelo consistía en ejecutar una aprobación en paralelo a nivel de usuarios, pero recordemos que los aprobadores son grupos de AD, por lo que el flujo debería crear tareas en paralelo los usuarios miembros de ambos grupos al mismo tiempo.

¿Interesantes requerimientos no?, pues a continuación algunos tips para trabajar con flujos de trabajo:

Las actividades básicas de aprobación de documentos se implementó en un proyecto de Activity Library de Windows WorkFlow Foundation. Recuerden en strong name para este tipo de proyectos ya que lo deben registrar en el GAC del servidor.
El proceso de aprobación como tal no estaba en el sequential workflow estaba en una librería del Framework el cual al invocar al constructor construía los objetos necesarios que se encontraban en la capa de entidades, objetos como por ejemplo: Grupo, Usuario, Documento.
Recuerden que cuando trabajen con workflows los objetos que declaren como globales ya sea para actividades personalizadas o para el propio flujo deben ser serializables, incluidos objetos de lógica del proceso. Esto no se encuentra documentado y pese a que las entidades eran serializables los objetos de proceso no lo eran esto ocasionó que el flujo no espere acción de los usuarios sobre las tareas debido a que los objetos de la capa de proceso no lo eran.
Para resolver el manejo de grupos, se utilizó utilitarios de la capa Core para conectarse al AD pasarle el grupo y que nos retorne sus miembros (usuarios que es con lo que trabaja MOSS 2007) con sus propiedades.
Para implementar tareas en paralelo utilicen el replicator configurado para que se ejecute en paralelo.
Para implementar tareas en serie pueden utilizar un replicator configurado en serie, o pueden utilizar una actividad while.

Espero que estos tips les sean de utilidad si algún momento deben implementar alguno de estos requerimientos.