Tirando Código

[SharePoint 2010] - Resolver usuarios y grupos a partir de su Login Name o Email - SPUtility.ResolvePrincipal

2011-12-12T17:47:00.000-08:00

Cuantas veces no hemos requerido buscar a un usuario a partir de su Email o de su LoginName, para obtener uno de estos datos, por ejemplo para enviarle un correo o asignarle una tarea dentro de un flujo de trabajo.

En el pasado utilizábamos el método GetLoginNameFromEmail de la clase SPUtility si conocíamos el email y necesitábamos el Login Name del usuario, sin embargo en la versión 2010 de la API de SharePoint este método ha sido marcado como obsoleto, lo que significa que si lo usamos producirá una alerta la cual nos recomienda, en su lugar, el uso del método ResolvePrincipal.

La ventaja de utilizar ResolvePrincipal es, en primera, que obtenemos de regreso un objeto del tipo SPPrincipalInfo el cual tiene varias propiedades útiles para trabajar con usuarios y grupos. Segunda, que como parámetro para realizar la búsqueda recibe el Display Name, Login Name o Email (solo uno de ellos), es decir que si conocemos cualquiera de estos tres valores de un usuario o grupo es posible resolverlo. Otro aspecto importante es que la búsqueda que realiza no está restringida a un sitio de SharePoint en particular.

A continuación un par de ejemplos de cómo utilizar este método para resolver usuarios.

SPWeb web = SPContext.Current.Site.RootWeb; //or SPControl.GetContextWeb(Context) or workflowProperties.Site.RootWeb, etc

//obtener el usuario a partir del display name
SPPrincipalInfo info = SPUtility.ResolvePrincipal(web, "Homero J. Simpson", SPPrincipalType.User, SPPrincipalSource.MembershipProvider | SPPrincipalSource.Windows, null, false);

//obtener el usuario a partir del Email
info = SPUtility.ResolvePrincipal(web, "hsimpson@sp2010.com", SPPrincipalType.All, SPPrincipalSource.All, web.AllUsers, true);

Por último, aunque no menos importante, mencionar que este método no esta disponible en soluciones SandBox.

Happy Coding!

QI for IEnumVARIANT failed on the unmanaged server

2011-11-21T18:35:00.000-08:00

Bueno, por si alguna vez les ha ocurrido este error al tratar de ingresar a la página de administración del servicio de búsqueda.

Inclusive al intentar recuperar algún valor mediante PowerShell este mismo error aparece, una posible solución que a mí me funciono fue reiniciar el IIS utilizando el siguiente comando

iisreset /noforce

Esto en cada uno de los servidores de crawling

Happy Configuring!

Crear custom workflow tasks forms [No Infopath]

2011-11-21T17:23:00.000-08:00

Como recordaran en el post anterior, mostré un ejemplo de cómo crear columnas de sitio y content types programáticamente, en este post voy a dar un ejemplo de cómo crear un formulario personalizado para el tipo de contenido que creamos en ese ejemplo anterior.

Es común que creemos tipos de contenido personalizados (custom content types) para asociarlos a la lista de tareas de workflows (Workflow Tasks), esto con el fin de poder recolectar más información del usuario cuando se le asigna una tarea dentro de un flujo de trabajo, y también es muy común que necesitemos personalizar el formulario de captura que el usuario utiliza para ingresar esa información adicional que necesitamos recolectar dentro del flujo de trabajo. Por lo anterior y utilizando el tipo de contenido que creamos en el post anterior, y que de manera premeditada hice que heredara del tipo de contenido WorkflowTask (recuerdan?).

También es importante mencionar que el custom approval workflow task form que crearemos será utilizando un formulario ASP.NET, creo que la mayoría sabe que no simpatizo mucho con InfoPath, además que ejemplos de esos hay bastantes en la red.

El escenario de ejemplo es el siguiente, cree una lista llamada “Solicitud Vacaciones”, en la que los usuarios podrán capturar las peticiones para tomar días de vacaciones, una vez que registren sus solicitud se enviará un correo de aviso al usuario responsable y se le asignará una tarea para que apruebe o rechace dicha solicitud, en caso de aprobación o rechazo se le notificará al usuario solicitante.

Como primer paso, creamos un flujo de trabajo sencillo, en este caso construiré un flujo de aprobación de solicitud de vacaciones, como se aprecia en la siguiente imagen:

No voy a explicar el cómo construir el flujo de trabajo, dado que la finalidad de este post no es mostrar cómo hacer un flujo de trabajo, adicional a que hay muchos ejemplos en la red. Sin embargo voy a compartir el código por si a alguien le interesa ver cómo fue construido el Workflow.

Como se aprecia en la siguiente imagen, se agregó una actividad de tipo CreateTaskWithContentType la cual recibe el Id del Content Type a partir del cual se creara la tarea que será asignada al usuario responsable de autorizar la solicitud de vacaciones.

Como se aprecia en la imagen, el ID del tipo de contenido se asocia a una propiedad declarada en código, la que manipularemos para buscar y asignar el ID de tipo de contenido correcto cuando el Workflow se inicialice, en el evento WorkflowActivated.

private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
 WorkflowContext.Initialize(workflowProperties);
 workflowID = workflowProperties.WorkflowId;

 //si el tipo de contenido no ha sido asociado a la lista de tareas
 try
 {
  if (workflowProperties.TaskList.ContentTypes[contentTypeName] == null)
  {
   SPContentType ctype = WorkflowContext.Web.AvailableContentTypes[contentTypeName];
   if (ctype != null)
   {
    workflowProperties.TaskList.ContentTypes.Add(ctype);
    workflowProperties.TaskList.Update();
   }
  }

  SPContentType customContentType = WorkflowContext.Web.AvailableContentTypes[contentTypeName];
  this.CustomContentTypeId = customContentType.Id.ToString();

 }
 catch (Exception ex)
 {
  //registramos la excepcion
 }
}

Estableciendo el formulario de edición al tipo de Contenido

Regresando a la definición del tipo de contenido que creamos en el post anterior, que cómo podrán recordar fue provisionado programáticamente. El siguiente paso es establecer por lo menos el formulario de edición del tipo de contenido, es decir, el formulario que el usuario visualizará cuando vaya a aprobar o rechazar la tarea asignada. Para que el Content Type sepa que formulario debe invocar, utilizaremos la propiedad EditFormUrl la que estableceremos con el valor del formulario ASP.NET que vamos a crear en el siguiente paso.

Noten la línea 131:

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Security;

namespace WF1.Features.Feature1
{
    /// 
    /// This class handles events raised during feature activation, deactivation, installation, uninstallation, and upgrade.
    /// 
    /// 
    /// The GUID attached to this class may be used during packaging and should not be modified.
    /// 

    [Guid("dd6b6ec4-3391-46de-a659-55244237f346")]
    public class Feature1EventReceiver : SPFeatureReceiver
    {
        public override void FeatureActivated(SPFeatureReceiverProperties properties)
        {
            try
            {
                SPWeb web = null;
                if (properties.Feature.Parent is SPSite)
                {
                    SPSite sites = (SPSite)properties.Feature.Parent;
                    web = sites.RootWeb;
                }
                else
                {
                    web = (SPWeb)properties.Feature.Parent;
                }
                if (web == null)
                    return;

                //Nombre del grupo de Content Types que crearemos
                string contentTypeGroupName = "Blog - Content Types";
                //Nombre del tipo de contenido que crearemos
                string contentTypeName = "Blog - Response Workflow Content Type";
                //Nombre del grupo de columnas de sitio que crearemos
                string columnGroupName = "Blog - Site Columns";
                //nombre de la columna de sitio que permitira al usuario seleccionar su respuesta (Approve | Reject)
                string choiceFieldName = "ChoiceWFResponse";
                //nombre de la columna de sitio que permitira al usuario capturar comentarios a cerca de su respuesta
                string commentsFieldName = "CommentsWFResponse";


                SPFieldMultiLineText approveRejectCommentsField = null;
                SPFieldChoice approveRejectChoiceField = null;

                /*Columna de sitio para seleccionar Aprobar o Rechazar*/
                //mucho ojo! Validamos si la columa de sitio ya existe
                if (!web.Fields.ContainsField(choiceFieldName))
                {
                    string approveReject = web.Fields.Add(choiceFieldName, SPFieldType.Choice, true);
                    approveRejectChoiceField = (SPFieldChoice)web.Fields.GetFieldByInternalName(approveReject);
                    approveRejectChoiceField.Group = columnGroupName;
                    approveRejectChoiceField.EditFormat = SPChoiceFormatType.RadioButtons;
                    approveRejectChoiceField.Choices.Add("Approve");
                    approveRejectChoiceField.Choices.Add("Reject");
                    approveRejectChoiceField.DefaultValue = "Approve";
                    approveRejectChoiceField.Update();
                }
                //Si ya existe, solo obtenemos una referencia a la columna
                else
                {
                    approveRejectChoiceField = web.Fields[choiceFieldName] as SPFieldChoice;
                }

                /*Columna de sitio para permitir al usuario ingresar un comentario*/
                if (!web.Fields.ContainsField(commentsFieldName))
                {
                    string comments = web.Fields.Add(commentsFieldName, SPFieldType.Note, true);
                    approveRejectCommentsField = (SPFieldMultiLineText)web.Fields.GetFieldByInternalName(comments);
                    approveRejectCommentsField.Group = columnGroupName;
                    approveRejectCommentsField.Update();
                }
                else
                {
                    approveRejectCommentsField = web.Fields[commentsFieldName] as SPFieldMultiLineText;
                }

                //
                //Ahora creamos el tipo de contenido
                //

                //heredamos del WorkflowTask Content Type
                SPContentType workflowTaskCType = web.AvailableContentTypes[SPBuiltInContentTypeId.WorkflowTask];
                SPContentType approvalRejectCType = null;
                bool isUpdating = false;

                //validamos si el tipo de contenido ya existe
                if (web.AvailableContentTypes[contentTypeName] == null)
                {
                    approvalRejectCType = new SPContentType(workflowTaskCType, web.ContentTypes, contentTypeName);
                    approvalRejectCType = web.ContentTypes.Add(approvalRejectCType);
                    approvalRejectCType.Group = contentTypeGroupName;
                }
                else
                {
                    approvalRejectCType = web.ContentTypes[contentTypeName];
                    isUpdating = true;
                }

                if (!isUpdating)
                {
                    //agregamo la columna de Seleccion
                    SPFieldLink approveRejectFieldRef = new SPFieldLink(approveRejectChoiceField);
                    approveRejectFieldRef.Required = true;
                    approveRejectFieldRef.DisplayName = "Approve or Reject the task";
                    approvalRejectCType.FieldLinks.Add(approveRejectFieldRef);

                    //agregamo la columna de Comentarios
                    SPFieldLink commentsFieldRef = new SPFieldLink(approveRejectCommentsField);
                    commentsFieldRef.DisplayName = "Comments";
                    approvalRejectCType.FieldLinks.Add(commentsFieldRef);
                }
                else
                {
                    //Actualizamos la columna de Seleccion
                    SPFieldLink approveRejectFieldRef = approvalRejectCType.FieldLinks[approveRejectChoiceField.Id];
                    approveRejectFieldRef.Required = true;
                    approveRejectFieldRef.DisplayName = "Approve or Reject the task";

                    //Actualizamos la columna de Comentarios
                    SPFieldLink commentsFieldRef = approvalRejectCType.FieldLinks[approveRejectCommentsField.Id];
                    commentsFieldRef.DisplayName = "Comments";
                }

                approvalRejectCType.EditFormUrl = "_layouts/WF1/CustomApprovalTask.aspx";

                //actualizamos el tipo de contenido
                approvalRejectCType.Update(true);
            }
            catch (Exception ex)
            {
                //log Exception
            }
        }

    }
}

Existen algunas otras propiedades con las cuales podemos indicar que formulario debe mostrarse dependiendo de la vista que sea solicitada, tales como: DisplayFormUrl, MobileDisplayFormUrl, etc, etc

Creación del formulario

El siguiente paso es la creación del formulario que será invocado cuando el usuario haga clic en editar tarea. Para esto agregamos un elemento Application Page y la nombramos como CustomApprovalTask.aspx, el cual usaremos para crear la forma de edición para el tipo de contenido.

A continuación el código del formulario, en realidad es bastante sencillo solo presenta un par de controles, una caja de texto para capturar los comentarios y un dropdownlist para elegir una opción (Aprobar, Rechazar).

using System;
using System.Collections;
using System.Web;
using System.Web.UI.WebControls;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Utilities;
using Microsoft.SharePoint.WebControls;
using Microsoft.SharePoint.Workflow;

namespace WF1.Layouts
{
    public partial class CustomApprovalTask : LayoutsPageBase
    {
        protected SPList targetTasksList;
        protected SPListItem targetTask;
        protected SPWorkflow workflowInstance;
        protected SPWorkflowModification workflowModification;

        string choiceFieldName = "ChoiceWFResponse";
        //nombre de la columna de sitio que permitira al usuario capturar comentarios a cerca de su respuesta
        string commentsFieldName = "CommentsWFResponse";


        protected override void OnLoad(EventArgs e)
        {
            base.OnLoad(e);
            /**/
            // Retrieve the current task list and task item
            targetTasksList = Web.Lists[new Guid(Request.Params["List"])];
            targetTask = targetTasksList.GetItemById(int.Parse(Request.Params["ID"]));

            //Obtiene el autorizador de la tarea
            string Aprobador = Convert.ToString(targetTask[SPBuiltInFieldId.AssignedTo]);
            int IdAporbador = Convert.ToInt32(Aprobador.Remove(Aprobador.IndexOf(';'), Convert.ToInt32(Aprobador.Length - Aprobador.IndexOf(";"))));

            if ((Web.CurrentUser.ID != IdAporbador) )
            {
                ClosePopup();
            }

            /**/
            if (!this.Page.IsPostBack)
            {
                // Populate fields on the form
                lblTitle.Text = targetTask["Title"] != null ? targetTask["Title"].ToString() : string.Empty;
                txtCommnents.Text = targetTask[commentsFieldName] != null ? targetTask[commentsFieldName].ToString() : string.Empty;

                ListItem selectedItem = ddlResponse.Items.FindByValue(targetTask[choiceFieldName].ToString());

                if (selectedItem != null)
                {
                    this.ddlResponse.ClearSelection();
                    selectedItem.Selected = true;
                }
            }

        }

        protected void UpdateTaskFromControls(SPListItem targetTask, System.Collections.Hashtable taskProperties)
        {
            // Update task item fields
            taskProperties[SPBuiltInFieldId.TaskStatus] = SPWorkflowStatus.Completed;
            taskProperties[commentsFieldName] = txtCommnents.Text;
            taskProperties[choiceFieldName] = ddlResponse.SelectedValue;
        }

        public void btnSaveTask_Click(object sender, EventArgs e)
        {
            try
            {
                Hashtable taskProperties = new Hashtable();
                UpdateTaskFromControls(targetTask, taskProperties);
                SPWorkflowTask.AlterTask(targetTask, taskProperties, false);

            }
            catch (Exception exception)
            {
                SPUtility.Redirect("Error.aspx", SPRedirectFlags.RelativeToLayoutsPage,
                HttpContext.Current,
                "ErrorText=" + SPHttpUtility.UrlKeyValueEncode(exception.Message));
            }
            ClosePopup();
        }

        public void Cancel_Click(object sender, EventArgs e)
        {
            ClosePopup();
        }

        protected void ClosePopup()
        {
            this.Response.Clear();
            this.Response.Write("Closing ...");
            this.Response.Flush();
            this.Response.End();
        }
    }
}

Pueden descargar el código de aquí

Happy Coding!

Creando Site Columns y Content Types programáticamente

2011-10-12T20:01:00.000-07:00

El día de hoy quiero compartir con ustedes un ejemplo de cómo crear columnas de sitio y tipos de contenido programáticamente. El objetivo final es crear un tipo de contenido que herede del tipo de contenido WorkflowTask (el que se utiliza para las tareas que se asignan en los flujos de trabajo), utilizando dos columnas de sitio, la primera será una columna que permitirá al usuario capturar su respuesta (Aprobar | Rechazar), la segunda permitirá capturar comentarios acerca de su respuesta.

Sin mucho preámbulo comencemos creando un proyecto en blanco con un elemento Feature con scope Site, al cual agregaremos un Event Receiver

Inmediatamente después comenzamos a tirar un poco de código en el método FeatureActivated para crear en primera instancia las dos columnas de sitio que utilizaremos:

SPWeb web = null;
if (properties.Feature.Parent is SPSite)
{
    SPSite sites = (SPSite)properties.Feature.Parent;
    web = sites.RootWeb;
}
else
{
    web = (SPWeb)properties.Feature.Parent;
}
if (web == null)
    return;
                
//Nombre del grupo de Content Types que crearemos
string contentTypeGroupName = "Blog - Content Types";
//Nombre del tipo de contenido que crearemos
string contentTypeName = "Blog - Response Workflow Content Type";
//Nombre del grupo de columnas de sitio que crearemos
string columnGroupName = "Blog - Site Columns";
//nombre de la columna de sitio que permitira al usuario seleccionar su respuesta (Approve | Reject)
string choiceFieldName = "ChoiceWFResponse";
//nombre de la columna de sitio que permitira al usuario capturar comentarios a cerca de su respuesta
string commentsFieldName = "CommentsWFResponse";


SPFieldMultiLineText approveRejectCommentsField = null;
SPFieldChoice approveRejectChoiceField = null;
                
/*Columna de sitio para seleccionar Aprobar o Rechazar*/
//mucho ojo! Validamos si la columa de sitio ya existe
if (!web.Fields.ContainsField(choiceFieldName))
{
    string approveReject = web.Fields.Add(choiceFieldName, SPFieldType.Choice, true);
    approveRejectChoiceField = (SPFieldChoice)web.Fields.GetFieldByInternalName(approveReject);
    approveRejectChoiceField.Group = columnGroupName;
    approveRejectChoiceField.EditFormat = SPChoiceFormatType.RadioButtons;
    approveRejectChoiceField.Choices.Add("Approve");
    approveRejectChoiceField.Choices.Add("Reject");
    approveRejectChoiceField.DefaultValue = "Approve";
    approveRejectChoiceField.Update();
}
//Si ya existe, solo obtenemos una referencia a la columna
else
{
    approveRejectChoiceField = web.Fields[choiceFieldName] as SPFieldChoice;
}

/*Columna de sitio para permitir al usuario ingresar un comentario*/
if (!web.Fields.ContainsField(commentsFieldName))
{
    string comments = web.Fields.Add(commentsFieldName, SPFieldType.Note, true);
    approveRejectCommentsField = (SPFieldMultiLineText)web.Fields.GetFieldByInternalName(comments);
    approveRejectCommentsField.Group = columnGroupName;
    approveRejectCommentsField.Update();
}
else
{
    approveRejectCommentsField = web.Fields[commentsFieldName] as SPFieldMultiLineText;
}

Una vez que las hemos creado, procedemos a crear el tipo de contenido utilizando las columnas de sitio.

//
//Ahora creamos el tipo de contenido
//

//heredamos del WorkflowTask Content Type
SPContentType workflowTaskCType = web.AvailableContentTypes[SPBuiltInContentTypeId.WorkflowTask];
SPContentType approvalRejectCType = null;
bool isUpdating = false;

//validamos si el tipo de contenido ya existe
if (web.AvailableContentTypes[contentTypeName] == null)
{
    approvalRejectCType = new SPContentType(workflowTaskCType, web.ContentTypes, contentTypeName);
    approvalRejectCType = web.ContentTypes.Add(approvalRejectCType);
    approvalRejectCType.Group = contentTypeGroupName;
}
else
{
    approvalRejectCType = web.ContentTypes[contentTypeName];
    isUpdating = true;
}

if (!isUpdating)
{
    //agregamo la columna de Seleccion
    SPFieldLink approveRejectFieldRef = new SPFieldLink(approveRejectChoiceField);
    approveRejectFieldRef.Required = true;
    approveRejectFieldRef.DisplayName = "Approve or Reject the task";
    approvalRejectCType.FieldLinks.Add(approveRejectFieldRef);

    //agregamo la columna de Comentarios
    SPFieldLink commentsFieldRef = new SPFieldLink(approveRejectCommentsField);
    commentsFieldRef.DisplayName = "Comments";
    approvalRejectCType.FieldLinks.Add(commentsFieldRef);
}
else
{
    //Actualizamos la columna de Seleccion
    SPFieldLink approveRejectFieldRef = approvalRejectCType.FieldLinks[approveRejectChoiceField.Id];
    approveRejectFieldRef.Required = true;
    approveRejectFieldRef.DisplayName = "Approve or Reject the task";

    //Actualizamos la columna de Comentarios
    SPFieldLink commentsFieldRef = approvalRejectCType.FieldLinks[approveRejectCommentsField.Id];
    commentsFieldRef.DisplayName = "Comments";
}

//actualizamos el tipo de contenido
approvalRejectCType.Update(true);

Hacemos Deploy de nuestro proyecto y validamos que se hayan creado las columnas de sitio y el tipo de contenido

Listo!

Pueden descargar el código de aquí

Happy Coding!

Reemplazando el diagrama de Workflow en SharePoint 2010 usando un Delegate Control

2011-09-20T21:02:00.000-07:00

Como sabemos, los controles delegados (Delegate Controls) son básicamente contenedores que encapsulan contenido y que SharePoint permite substituir este contenido con contenido personalizado diferente a la implementación predeterminada. Una de sus funciones primordiales es proveer de una manera fácil de hacer Branding de los sitios SharePoint. SharePoint define varios controles delegados dentro de la master page v4.

En este post, les propongo usar esta característica para sustituir (y mejorar) la manera predeterminada en que se muestran los diagramas de los flujos de trabajo en la página de detalle del flujo de trabajo en SharePoint 2010.

Y poder adicionarle un poco de vida!

Primero se debe crear un proyecto nuevo y vacío (obviamente de SharePoint 2010)

Agregamos un usercontrol, en el cual vamos a escribir el código aspx que sustituirá al diagrama de flujo. De hecho este user control tendra el mismo contenido que el WorkflowStatus.ascx, y solo agregaremos una referencia a un archivo js que será el encargado de manipular el diagrama de Visio utilizando la API de Visio Services.

Agregamos una nueva Feature con Scope Site a la solución, la cual se encargará de desplegar el elemento que crearemos en el siguiente paso

La magia viene aquí; agregamos un nuevo elemento a la solución de tipo Empty Element y agregamos la siguiente definición:

El valor del atributo Id y el atributo Sequence son importantes ya que el Id debe coincidir con la definición del control que queremos reemplazar, y el valor de la propiedad Sequence debe ser menor a la especificada en la definición original del control para que tenga precedencia sobre este. A continuación como fue definido originalmente el control en la feature VisioWebAccess

Si quieren saber como poder agregar este tipo de mejoras a los diagramas de Visio, pueden checar dos de mis anteriores posts:

Visio Services API

Agregando controles Silverlight a un diagrama de Visio Services

Anticipando algunas de sus posibles preguntas:

Porque utilizar un delegate control solo para adicionar la referencia a un archivo js?

Se podría haber agregado la referencia a este archivo .js desde la Master Page, incluso se puede sustituir el archivo workflowstatus.js que es el que se encarga de manera predeterminada del dibujado de todos los diagramas de Visio para los flujos de trabajo, sin embargo esto es muy invasivo ya que sería un cambio global y de la manera que este post propone el cambio sería a nivel de Sitio, es decir, lo menos invasivo posible.

Happy Coding!

Descargar los prerequisitos de SharePoint 2010 offline

2011-09-06T21:13:00.000-07:00

Como muchos de ustedes saben, el nuevo instalador de SharePoint 2010 nos permite instalar los prerequisitos que nos hagan falta antes de comenzar con el proceso de instalación, lo que es bastante cómodo si recordamos la forma manual que se utilizaba para instalar SharePoint 2007.

Sin embargo hay algunos escenarios ~~en el mundo real~~ en los cuales no podemos utilizar esta ventajosa herramienta, específicamente me refiero al siguiente escenario:

Estamos haciendo un despliegue de una granja SharePoint en un ambiente (Desarrollo, QA, Producción, DRP, etc.) en el cual no tenemos acceso a internet y aunque hemos suplicado por él, el equipo de Seguridad no lo permitiría jamás.

Luego entonces lo que necesitamos hacer es descargar en una máquina en la cual si tengamos acceso a internet, todos los componentes de prerequisitos para SharePoint 2010 y posteriormente copiar esos archivos a cada uno de los servidores en los que haremos el despliegue de la granja.

ü SQL Server 2008 Native Client (sqlncli.msi)

ü Microsoft Chart Controls for the Microsoft .NET Framework 3.5 (MSChart.exe)

ü Microsoft .NET Framework version 3.5 SP1 (dotnetfx35.exe)

ü Windows PowerShell 2.0 (Windows6.0-KB968930-x64.msu)

ü KB976394 (Windows6.0-KB976394-x64.msu)

ü KB976492 (Windows6.1-KB976462-v2-x64.msu)

ü Windows Identity Foundation (WIF) for Windows Server 2008 R2 (Windows6.1-KB974405-x64.msu)

ü Microsoft Sync Framework Runtime (Synchronization-v2.0-x64-ENU.msi)

ü Microsoft Filter Pack 2.0 (FilterPack64bit.exe)

ü Microsoft SQL Server 2008 Analysis Services ADOMD.NET (SQLSERVER2008_ASADOMD10.msi)

ü SQL Server 2008 R2 November CTP Reporting Services Add-in (rsSharePoint.msi)

ü Microsoft Server Speech Platform (SpeechPlatformRuntime.msi)

ü Speech recognition language for English (MSSpeech_SR_en-US_TELE.msi)

Listado de requisitos de software para SharePoint 2010

http://technet.microsoft.com/en-us/library/cc262485.aspx#section4

No obstante, esta solución es demasiado manual y nos consume demasiado tiempo, (el Facebook no se actualiza solo, o si?)

Por lo que les recomiendo utilicen mejor, el script “Download-All_SP2010_PreReqs.ps1” que forma parte de la utilería AutoSPInstaller, la cual podemos descargar de Codeplex, y que nos permite hacer esa descarga de manera automática hacia una carpeta para posteriormente copiarlos hacia los servidores que no tienen acceso a internet.

Al ejecutarlo nos pedirá la ruta en la cual se descargaran todos los componentes, la indicamos y hacemos click en OK

El script comienza a trabajar

Y ya solo nos resta esperar a que se terminen de descargar todos los componentes, los cuales quedarán en la carpeta "PrerequisiteInstallerFiles".

Espero que este tip les sirva.

Happy Configuring

MOSS MA not found

2011-08-14T20:11:00.000-07:00

Aprovecho este espacio para dejar constancia de otro de los posibles inconvenientes a los que nos enfrentamos al tratar de desplegar el servicio de profile (UPS – User Profile Service) de manera completa en SharePoint 2010.

El error: “MOSS MA not found”, algo más que confuso y hasta cierto punto gracioso, obviamente no la primera vez que te enfrentas a él.

Cuando aparece: Cuando se está creando o editando la conexión hacia el AD (Directorio Activo), después de hacer click en OK.

Resolución: Si alguno de los servicios de Forefront están detenidos, entonces primero debes asegurarte que se inicien, yo personalmente recomiendo que no traten de iniciar los servicios manualmente, sino desde el Sitio Central de Administración de SharePoint. Si los servicios de Forefront están ya iniciados, pues…. entonces reinícienlos :), esto debería permitirles editar o crear su conexión sin que se vuelva a presentar el error.

Unable to connect to the Synchronization Service

2011-08-08T21:16:00.000-07:00

Si ustedes como yo, son uno más de los desafortunados a los que les ha tocado pagar todos los pecados de sus vidas anteriores, con el servicio de User Profile Synchronization que esta a nuestra disposición en SharePoint 2010. Tal vez ya se hayan encontrado con varios de esos "comunes", y hasta cierto punto aceptados, errores de configuración.

El día de hoy quiero dejar precedente de uno de los últimos con los que he tenido que lidiar. El mensaje de error es el mismo que intitula este post y se presenta al intentar abrir la herramienta que acompaña al servicio de sincronización, me refiero al FIM Client (Forefront Identity Manager), el cual se encuentra usualmente en la siguiente ruta:

%programfiles%\Microsoft Office Server\14.0\Synchronization Service\UIShell\miisclient.exe

Y el cual nos ayuda a rastrear que hace ~~y la mayoria del tiempo los errores que se presentan~~ en este servicio.

Unable to connect to the Synchronization Service

Como siempre, mi primera recomendación es que respiren profundo.

Como en pocas ocasiones, el mensaje de error que se muestra es perfectamente claro y muy conciso.

Revisen si el servicio esta ejecutándose en el servidor desde el cual están intentando acceder al FIM Client, si el servicio no esta iniciado, es imposible abrir el FIM Client.
Revisen si el usuario con el que se está ejecutando este utilería pertenece al grupo de FIMSyncAdmins, el cual se crea cuando se provisiona el servicio de sincronización y al cual, en teoría, el usuario con el cual se ejecuta el servicio es agregado automáticamente.

Si estas dos sugerencias ya las han revisado y asegurado que se cumplen, es posible que estén en el mismo escenario que el mío, y es que, acabando recién de provisionar el servicio de sincronización UPS (User Profile Synchronization), cuando me disponía a utilizar el FIM client, para mi sorpresa apareció este error .

La raíz y solución del contratiempo: como bien mencioné, al provisionar el servicio, este asigna los permisos y roles necesarios a la cuenta de servicio, entre ellos, se asigna al grupo FIMSyncAdmins. Solo que para que estos permisos sean efectivos es necesario efectuar un logoff y posteriormente un logon. Eso es todo!

Happy configuring!

Fast Search Center Template is Missing in SharePoint 2010

2011-07-28T21:20:00.000-07:00

Les ha ocurrido que ya después de haber pasado penurias en desplegar Fast Search Server 2010 for SharePoint (FS4SP), configurar los services search applications (SSA) necesarios, y habilitar su comunicación por medio de la importación/exportación de certificados para que SharePoint se comunique con FS4SP… que después de todo este trabajo, vayan ~~ilusos~~ confiados a su Sitio Web a crear un nuevo sitio que utilice el template de Fast Search Center para proveer a los usuarios de la capacidad de búsquedas empresariales y que al intentar seleccionar este template del apartado de Search, este template no aparezca!?

Evidentemente, lo primero que se nos cruza por la mente es validar que las dos características a nivel de sitecollection requeridas estén activadas…. Y si, si están activadas

Ok, después de esta sucia broma del destino, lo que necesitamos hacer para que este template aparezca como opción al momento de crear un nuevo sitio es activar la característica de SearchExtensions, la cual es de tipo hidden y que pueden activar utilizando el pequeño scritp de powershell que a continuación muestro:

Enable-SPFeature –Id SearchExtensions –url http://sp2010/

[Tip] Agregar automáticamente los cmdlets de SharePoint a PowerShell ISE

2011-06-08T15:20:00.000-07:00

Si a ustedes como a mi, les gusta usar Windows PowerShell ISE a la hora de escribir scripts PowerShell, principalmente, aunque no únicamente, para SharePoint Server 2010, les mostraré un tip para evitar el uso del comando Add-PSSnapin para registrar los cmdlets de SharePoint cada vez que abrimos esta aplicación.

Antes que nada, si ustedes aún no usan Windows PowerShell ISE, lo recomiendo ampliamente por sus características de Debugging, si aún no lo usan porque no lo tienen activado, recuerden que Windows PowerShell ISE es instalado en Windows 2008/R2 por default, solo que no es activado, y esto se logra mediante la activación de la característica “Windows PowerShell Integrated Scripting Environment (ISE)”.

Una vez que ya lo han activado e iniciado, se darán cuenta que si intentan usar algún cmdlet de SharePoint, este no funciona y es porque no ha sido registrado el paquete de cmdlets de SharePoint, para esto usamos el cmdlet Add-PSSnapin Microsoft.SharePoint.PowerShell, ahora bien, volviendo a la intención original de este post, que es evitar escribir este comando cada vez que abrimos el Windows PowerShell ISE, podemos editar ó crear (en caso de no existir) una archivo de perfil de usuario, con el fin de que cada vez que abramos esta aplicación, este archivo de perfil de usuario se encargue de cargar todos los paquetes de cmdlets que hayamos indicado.

Existen cuatro diferentes ámbitos de perfiles en los cuales se puede crear este archivo, para mayor información revisen este link de technet, yo personalmente recomiendo que usen el que aplica a todos los usuarios y todos los shells, con esto se evitaran repetir esta acción entre diferentes usuarios y diferentes consolas de Shell, este archivo lo pueden referenciar a través de $profile.AllUsersAllHosts. A continuación los pasos que pueden usar para crear este archivo y agregar los paquetes de cmdlets que deben cargarse cada que se lanza la aplicación, en este ejemplo solo agrego el de SharePoint 2010.

Primero se debe abrir el archivo de perfil (profile.ps1) si existe de lo contrario crearlo, para esto se puede abrir directamente desde el file system o mediante un comando de PowerShell como se observa a continuación:

if (!(test-path $profile.AllUsersAllHosts))
{
    new-item -type file -path $profile.AllUsersAllHosts-force
}

Una vez que el archivo está abierto solo se debe agregar el siguiente código:

#se edita el archivo de perfil
psEdit $profile.AllUsersAllHosts
If ((Get-PSSnapIn -Name Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue) -eq $null )
{ 
    Add-PSSnapIn -Name Microsoft.SharePoint.PowerShell 
    #agregue aqui sus modulos favoritos!
}

Después guardar el archivo y listo, la siguiente vez que se lance la aplicación automáticamente se cargarán los módulos indicados.

Happy Coding!

[Tip] Convertir un Diagrama de Visio a un archivo .xap de Silverlight

2011-05-30T11:58:00.000-07:00

Algunos lectores del blog me han comentado que aunque les parecen muy atractivos los resultados que se pueden obtener al personalizar un diagrama utilizando JavaScript, también me comentan que les parece muy complicado estar "buscando" objetos en el DOM, una vez que el diagrama ha sido dibujado.

Me explico, una vez que el diagrama ha sido rendereado, es entonces cuando podemos comenzar a interactuar con él, en términos de manipular los objetos (Silverlight principalmente), para esta manipulación casi siempre necesitamos saber el ID del control, para posteriormente modificar alguna de sus propiedades, inclusive para removerlo del diagrama. Importante es mencionar que estos ID's se autogeneran cuando el diagrama es transformado a .xap, por lo que no tenemos certeza de cuál es el nombre una vez generado.

Es entonces este proceso de "búsqueda" de ID's de los controles a modificar el que se vuelve un poco tedioso, luego entonces, el motivo de este post es mostrarles un ~~workaround~~ proceso alternativo con el que podemos tener acceso al archivo .XAP de un diagrama de Visio, lo cual nos permitirá ver la jerarquía de controles, sus respectivos ID's e inclusive los datos que son enviados al cliente (de esto hablaremos en un post siguiente).

Y lo único que tenemos que hacer es guardar el diagrama como página web y una vez que concluya el asistente, abrir la carpeta de archivos que genera y examinar los archivos .xaml que se encuentran dentro, puede haber tantos archivos .xaml como paginas tenga el diagrama, en mi ejemplo el diagrama contiene tres paginas.

Happy Coding!

Reseña Cuarto Simposio Latinoamericano de SharePoint 2011

2011-05-26T05:37:00.000-07:00

Como muchos de ustedes saben, tuve el privilegio de ser invitado a participar como expositor con una charla en el pasado Cuarto Simposio Latinoamericano de SharePoint 2011, que se llevo acabo el 29 de Abril pasado en las instalaciones de Microsoft México. En aquella ocasión, mi participación fue acerca de Visio Services en SharePoint 2010.

Dejo el link de la reseña oficial del evento, desde el sitio de la comunidad SharePoint de México.
También una reseña ~~apócrifa~~ realizada por mi buen amigo Haaron Gonzalez

La presentación la pueden descargar de aquí

Solo queda volver a agradecer a Luis Du Solier por la invitación y confianza.

Agregando controles Silverlight a un diagrama de Visio Services

2011-05-22T20:13:00.000-07:00

Hasta el momento he omitido intencionalmente el mencionar uno de los hechos mas relevantes, y que tiene que ver con la forma en que el diagrama es dibujado (rendereado) en el navegador.

Existen dos únicas formas en las que el diagrama de Visio puede ser dibujado en el navegador, en formato Raster ó usando Silverlight!!!.

Así es, una de las tecnologías favoritas de este humilde desarrollador, vuelve a hacerse presente en un escenario en el que la interacción del usuario con el navegador es parte fundamental de la experiencia final de uso. Ahora bien, habrá quienes en este punto aún no tengan claro el porqué de mi exaltación por el uso de Silverlight para renderear el diagrama de Visio, es decir, si, todos ya sabíamos que Silverlight es usando ampliamente en varios aspectos de SharePoint 2010 porque esto brinda, sin lugar a dudas, una experiencia de usuario mejorada. Pero… volviendo a Visio Services… y qué más da que se use Silverlight para dibujar el diagrama en el navegador?

Pues el hecho relevante es, como todos sabemos, que Silverlight expone una API en JavaScript para la manipulación y creación de objetos desde el lado del cliente (JavaScript), puede sonar redundante puesto que Silverlight de por sí se ejecuta del lado del cliente (navegador). Ahora sí, las piezas comienzan a encajar en este rompecabezas.

La razón de este post es demostrar cómo podemos, mediante el uso de la API de Silverlight en JavaScript, agregar objetos al diagrama, una vez que ha sido dibujado en el navegador. Este es el punto medular, ya que con un poco de imaginación y algunas líneas de código (en su mayoría JavaScript) podemos crear diagramas muy atractivos al usuario final.

Dado que ha sido demasiado preámbulo, nada mejor que algunas líneas de código que ejemplifiquen mucho mejor de que estamos hablando.

Agregando objetos Silverlight(xaml) al diagrama

Tomando como base el diagrama del post anterior, vamos a modificar un poco el código que utilizamos para contar los shapes que existen dentro del diagrama para agregar los objetos Silverlight.

Sys.Application.add_load(onApplicationLoad)

//declaramos algunas variables globales que ocuparemos
var vwaControl;
var vwaPage;
var vwaShapes;
var vwaShapeCount;


function onApplicationLoad() {
    //obtenemos la instancia de la Visio Web Access Web Part
    getVwaControl();

    //Nos subscribimos a dos de los eventos que son expuesto por la API
    if (vwaControl != null) {
        vwaControl.addHandler("diagramcomplete", onDiagramComplete);
        vwaControl.addHandler("shapeselectionchanged", onShapeSelectionChanged);           
    }
    else {
        alert("Error connecting to Visio Web Part.  Please contact the site administrator.");
    }
}

function onDiagramComplete() {
 vwaPage = vwaControl.getActivePage();
    //obtenemos la pagina activa con el metodo getActivePage()
    vwaPage.setZoom(80);
 
 //buscamos el contenedor del diagrama, casi siempre un objeto

En realidad el código es muy simple, sin mebargo es importante hacer mención aparte de la función que se encarga de crear los controles Silverlight a partir del código XAML, la función createFromXaml, acto seguido solo basta agregarlos al contenedor del diagrama (un objeto Canvas).

Es importante tambien mencionar que no todos los controles Silverlight se pueden crear a partir de esta API (aunque si se pueden manipular, si ya existen). Aquí puedes checar que objetos se pueden crear y cuales no, a través de la API de Silverlight en JavaScript.

Por último algunas referencias y el código js

JavaScript API for Silverlight
Objetos Silverlight expuesto por la API en JavaScript
Visio Services API
Función createFromXaml

Happy Coding!

Visio Services API

2011-05-13T14:59:00.000-07:00

Ok, antes de comenzar a hablar acerca de la API (Application Programming Interface) expuesta para Visio Services, es importante mencionar que no es estrictamente necesario desarrollar utilizando esta API, existen muchas formas de lograr diagramas ricos visualmente (con sus restricciones) sin necesidad de desarrollo alguno.

Sin embargo, si requerimos de más ~~poooder~~ flexibilidad en la creación de diagramas con una mejor experiencia de usuario, la API de Visio Services es la ~~única~~ mejor opción. De ahí que para esta serie de posts, me haya inclinado más por el uso, explicación y demostración del uso de esta API.

¿Qué es la API de Visio Services?

De manera resumida, la API de Visio Services es un conjunto de clases (solo cuatro), que nos permiten accesar, manipular e inclusive crear objetos dentro de un diagrama que ha sido rendereado utilizando el service application de Visio Graphics Service, a través de la Visio Web Access Web Part.

Punto modular de este tema es el hecho de que la API es expuesta en JavaScript, es decir que, para hacer uso de la misma es necesario escribir código JavaScript. Una de las preguntas más frecuentes es:

¿Por qué en JavaScript?

JavaScript fue elegido porque es el mínimo común denominador para todos los navegadores, si, incluyendo Internet Explorer. La versión soportada de JavaScript es la 1.3.

Desde el punto de vista de un desarrollador, creo que, fue una buena elección ya que JavaScript es ampliamente usado y aceptado además de que actualmente existen varios frameworks (como jquery) los cuales hacen que las tareas, que en el pasado eran verdaderos retos, ahora las puedes realizar con una sola línea de código (llamando a alguna función de jquery).

Ahora describiremos brevemente las clases que conforman esta API.

Vwa.VwaControl

Representa una instancia de la Visio Web Access Webpart, lo que significa que podemos acceder a la alguna de las propiedades de esta webpart desde el lado del cliente. Además provee métodos de mucha utilidad como addHandler, removeHandler y clearHandlers para interactuar con distintos eventos que esta clase expone, algunos de los más interesantes son:

diagramcomplete. Este evento es lanzado cuando el diagrama termina de cargarse
shapeselectionchanged. Se lanza cuando se selecciona un objeto del diagrama

Vwa.Page

Representa la página del diagrama que actualmente se está visualizando, como sabemos, un diagrama de Visio puede tener una o más páginas, luego entonces este objeto representa la página que se está desplegando en el momento. La forma más fácil de obtener una referencia a una instancia de este objeto es a través del método getActivePage() de la clase Vwa.VwaControl. Inclusive es posible establecer la página activa mediante el método setActivePage()

Vwa.ShapeCollection

Representa una colección de formas (shapes) que se encuentran en la página actualmente activa. Es posible obtener la colección entera de shapes que se encuentran en una página a través del método getShapes() de la clase Vwa.Page

Vwa.Shape

Y por último esta clase representa un shape (forma) que se encuentra dentro de la página activa.

Ahora bien, es tiempo de tirar un poco de código para ejemplificar el uso básico de esta API.

Antes que nada, es necesario publicar un diagrama de Visio web (.vwd), aquí un video bastante claro de cómo hacerlo. Acto seguido en una webpart page, agregamos la Visio Web Access webpart en la que estableceremos la url del diagrama que publicamos en el paso anterior.

Ahora agregamos una webpart de editor de Contenido la que nos servirá para agregar código JavaScript, evidentemente en lugar de agregar el código JavaScript directamente en esta web part, podríamos referenciar solamente un archivo de .js que se encuentre previamente provisionado en nuestro sitio.

Una vez que hemos hecho lo anterior, ya podemos escribir propiamente nuestros primeros pininos utilizando la API de Visio Services, entonces editamos la webpart de editor de contenido y agregamos el código JavaScript siguiente:

Explicando el código anterior:

Lo primero que podemos observar es la inclusión de esta referencia a otro archivo .js que sirve como “Helper” principalmente para obtener la referencia a la instancia de la webpart de Visio Web Access. Notese que para poder crear la instancia de Vwa.VwaControl, en necesario proporcionar el id de la webpart de Visio, para fines de hacer este proceso un poco más “dinamico”, el helper busca todos los elementos div que tengan la clase VisioWebAccess, esta es la manera más eficiente de buscar en el DOM el id de la webpart de Visio. Evidentemente no funciona si existe más de una Visio Web Access Web Part en la página.

/*!
* Visio Web Access JavaScript Library v1.0.1
*
* Copyright 2010, Microsoft
*/

//----------------------------------------------------------
// gets the first instance of the VisioWebAccess web part on this page.
// 
// if you have more than one VWA web part on the page this
// function will return the first one that is found
//----------------------------------------------------------
function getVwaControl() {
    var webPartID = null;

    try {
        webPartID = findVwaControlId();

        if (webPartID == null) {
            throw new Error("VisioWebAccess class not found.  Please contact the site administrator.");
        }

        // get the web part ID that we found on the page
        vwaControl = new Vwa.VwaControl(webPartID);
    }
    catch (ex) {
        alert(ex);
    }
}

//----------------------------------------------------------
// find the ID of the VisioWebAccess web part on this page.
// 
// if you have more than one VWA web part on the page this
// function will return the first one that is found
//----------------------------------------------------------
function findVwaControlId() {
    var retVal = null;

    var divCollection = document.getElementsByTagName("div");

    for (var i = 0; i < divCollection.length; i++) {
        if (divCollection[i].getAttribute("class") == "VisioWebAccess") {
            // the actual id of the VWA web part is two levels higher than this class node
            retVal = divCollection[i].parentNode.parentNode.getAttribute('id');
            break;
        }
    }

    return retVal;
}

//recupera el objeto silverlight en donde se esta pintando el diagrama
function findVwaRenderingObject() {
    var retVal = null;
    var objectCollection = document.getElementsByTagName("object");
    for (var i = 0; i < objectCollection.length; i++) {
        if (objectCollection[i].getAttribute("id").toString().indexOf("VisioWebAccess") != -1
  || objectCollection[i].getAttribute("id").toString().indexOf("silverlight") != -1
  )
        {
            retVal = objectCollection[i].getAttribute('id');
            break;
        }
    }
    return retVal;
}

function findVwaRenderingScript() {
    var retVal = null;
    var objectCollection = document.getElementsByTagName("script");
    alert(objectCollection.length);
    for (var i = 0; i < objectCollection.length; i++) {
        if (objectCollection[i].getAttribute("type") == "text/xaml") {
            retVal = objectCollection[i];
        }
    }
    return retVal;
}

La siguiente instrucción que agregamos es para adjuntar un manejador de eventos al evento load de ASP.NET AJAX.

Sys.Application.add_load(onApplicationLoad);

Acto seguido, escribimos el manejador de eventos que referenciamos en el punto anterior.

function onApplicationLoad() {
    //obtenemos la instancia de la Visio Web Access Web Part
    getVwaControl();

    //Nos subscribimos a dos de los eventos que son expuestos por la API
    if (vwaControl != null) {
        vwaControl.addHandler("diagramcomplete", onDiagramComplete);
        vwaControl.addHandler("shapeselectionchanged", onShapeSelectionChanged);           
    }
    else {
        alert("Error connecting to Visio Web Part.  Please contact the site administrator.");
    }
}

En el fragmento de código anterior, primero hacemos una llamada a la función getVwaControl(), que se encuentra en la librería Helper, y que se encarga de inicializar la variable vwaControl a través de lo que ya describimos anteriormente, después de que se inicializo esta variable satisfactoriamente, utilizamos la función addHandler de este objeto para suscribirnos a dos de los varios eventos que expone: diagramcomplete y shapeselectionchanged.

Lo siguiente es agregar los manejadores de los eventos a los cuales nos subscribimos (diagramcomplete y shapeselectionchanged).

function onDiagramComplete() {
    //obtenemos la pagina activa con el metodo getActivePage()
    vwaPage = vwaControl.getActivePage();
 //obtenemos la coleccion de formas con el metodo getShapes()
    vwaShapes = vwaPage.getShapes();
    vwaShapeCount = vwaShapes.getCount();
 alert("El diagrama contiene " + vwaShapeCount + " shapes");
    vwaPage.setZoom(50);
}

function onShapeSelectionChanged(source, args){
 alert(args);
 alert(source);
}

En primer lugar, dentro de la función onDiagramComplete, obtenemos la referencia a la página activa del diagrama, recordemos que un diagrama de Visio puede tener más de una página pero solo una activa, mediante la función getActivePage() de la clase Vwa.Page. Inmediatamente después obtenemos toda la colección de shapes (instancia de la clase Vwa.ShapeCollection), para después solo obtener el número de elementos de esta colección y mostrarlo en un alert. Por ultimo vemos que se llama a la función setZoom() de la clase Vwa.Page para establecer el valor del zoom del diagrama.

Espero que esta explicación sirva como primer acercamiento al uso de esta interesante API, y sobre todo, sirva como fundamento de los siguientes posts de esta serie. Si tienen alguna duda o comentario no duden en hacermela saber.

Ya por último dejo algunas referencias para que puedan adentrarse más en el uso de esta API

The Visio Services JavaScript Mashup API
Roadmap: Publish Visio drawings to a SharePoint site
Evento load de ASP.NET AJAX

Happy Coding!

SharePoint 2010 FBA Pack

2011-05-13T09:49:00.000-07:00

Seguramente ustedes recordaran el proyecto CKS (Community Kit for SharePoint), dentro del cual se encontraban varias herramientas como el Forms Based Authentication Solution con el cual podíamos habilitar, de manera muy sencilla, varias web parts que nos permitían administrar e interactuar con el sistema de FBA configurado en nuestro sitio SharePoint 2007.

Pues con la buena noticia de que por lo menos este componente ha logrado tener continuidad para la versión de SharePoint 2010 y está disponible para su libre descarga en el sitio de CodePlex del proyecto. Algunas de los elementos que podemos encontrar en este pack son:

1. Membership Request Web Part
2. Change Password Web Part
3. Password Recovery Web Part
4. Change Password Page
5. User Management
6. Role Management
7. Membership Review
8. FBA Pack Configuration

Adicionalmente, aunque no menos importante, remarcar el hecho de que también podemos obtener el código fuente de esta solución para agregar alguna característica extra, o modificar el comportamiento de alguna existente. Además los invito a que compartan sus aportaciones a este y tantos otros proyectos que se encuentran en CodePlex

Happy Coding!

Iniciando con Visio Services

2011-05-09T11:53:00.000-07:00

Después de un largo periodo en el que no me había podido hacer el tiempo necesario para escribir, hoy quiero abrir una serie de posts que se relacionan con el uso de uno de los Service Application que se encuentran listos para configurar y usarse en SharePoint Server 2010.

Visio Graphics Services

Visio Graphics Services es un Service Application que se encuentra dentro de SharePoint Server 2010 y que básicamente permite a los usuarios compartir y visualizar diagramas de Visio rendereados en el browser, a través de la webpart de Visio Web Access. Los diagramas que se pueden visualizar a través de esta webpart tienen la extension .vwd (Visio Web Diagram).

Beneficios principales

Algunas de las grandes ventajas de compartir un diagrama de Visio web (.vdw) haciendo uso de este Service Application, es que al ser rendereado (dibujado) en el navegador, los usuarios finales no requieren del cliente de Visio (inclusive sin el visor de Visio) instalado en sus equipos. Evidentemente el responsable de publicar los diagramas de Visio, si deberá contar con Microsoft Visio Professional 2010 ó Microsoft Visio Premium 2010. La funcionalidad que la Visio Web Access WebPart brinda para interactuar con los diagramas es la elemental: exploración y navegación básica, zoom, etc. Aunque esta funcionalidad es solo la más elemental, es aquí en donde la creatividad de los desarrolladores entra en juego para brindar a los usuarios finales una experiencia de uso mucho más rica.

Otro de los beneficios más importantes es la capacidad de “refrescado” de las conexiones a fuentes de datos que el diagrama contenga, esto es, si el diagrama contiene conexiones a fuentes de datos externas como Excel, listas de SharePoint, SQL Server, etc, Visio Services permite que estas conexiones sean respetadas y por ende actualizadas cada que el diagrama sea visualizado por los usuarios. Esta es una gran característica, ya que permite tener diagramas que muestran información casi en tiempo real.

Algunas de las fuentes de datos soportadas por Visio Services son:

SQL Server 7.0, 2000, 2005 (32b y 64b), 2008 (32b y 64b), 2008 R2 (32b y 64b)
Archivos de Excel publicados en Excel Services
Listas de SharePoint Server
OLE DB u ODBC
Custom Data Providers

Configuración de Visio Service Application

La configuración de este service application es realmente muy sencilla, para lo cual prefiero dejar la referencia oficial de TechNet. Para la mayoría de los escenarios esta referencia debiera ser más que suficiente, en posts futuros estaré tocando escenarios no tan comunes.

Referencias:
Visio Services Overview (SharePoint Server 2010)
Introducing Visio Services
Visio Services
Configure Visio Graphics Service Global Settings (SharePoint Server 2010)

Happy Coding!

El Día del Flujo de Trabajo de SharePoint 2010 para Desarrolladores

2010-12-06T21:03:00.000-08:00

Solo para invitarlos cordialmente a la serie de webcast sobre flujos de trabajo en SharePoint 2010 que se estará llevando acabo el día 15 de Diciembre del presente año, en donde estaré participando con una charla acerca del uso de Visio Services para el desarrollo de workflows.

Sin duda es una muy buena oportunidad para conocer todo lo referente a los flujos de trabajo en SP 2010, lo que siempre quisiste preguntar pero no habías podido. Esta por demás decir que los expositores son el Jet Set del Desarrollo en SharePoint (~~excepto yo, que solo estoy de colado~~)

El miércoles 15 de diciembre del presente año varios MVPs estaran celebrando el día del flujo de trabajo SharePoint 2010 para desarrolladores en donde presentaran los conceptos mas relevantes a relacionados con el desarrollo de flujos de trabajo con Microsoft SharePoint Server 2010 mediante presentaciones abiertas en línea de forma continua durante el transcurso del día.

	Conociendo los Flujos de Trabajo Pre Construidos en SharePoint 2010 En esta sesión conoceremos la propuesta de flujos de trabajo que SharePoint 2010 pone en la mesa y las características de cada uno de los flujos de trabajo pre construidos en el producto. Cuando y donde genera valor utilizarlo para automatizar algún proceso u operación empresarial y mejor aún cómo es posible extenderlos para personalizar algún proceso. 15 de Diciembre 2010 a las 10:00 AM Tiempo de México https://www.livemeeting.com/cc/mvp/join?id=wfday1&role=attend
	Construyendo Flujos de Trabajo en SharePoint 2010 utilizando SharePoint Designer 2010 En esta sesión veremos el soporte que SharePoint Designer 2010 tiene para la creación y manipulación de flujos de trabajo para SharePoint. Conozca el nuevo diseñador de flujos de trabajo, las actividades y condiciones disponibles en esta versión y como programar tus propias condiciones y acciones para SharePoint Designer 2010. 15 de Diciembre 2010 a las 11:30 AM Tiempo de México https://www.livemeeting.com/cc/mvp/join?id=wfday&role=attend
	Construyendo Flujos de Trabajo en SharePoint 2010 utilizando Visio Services En esta sesión veremos el valor que Visio Services aporta al mundo de los flujos de trabajo. Al fin contamos con una alternativa mucho más rica para poder mostrar de forma gráfica el estado de los flujos en ejecución y brindar opciones al usuario para consultar información contextual de una instancia en ejecución del flujo de trabajo. 15 de Diciembre 2010 a las 3:00 PM Tiempo de México https://www.livemeeting.com/cc/mvp/join?id=wfday3&role=attend
	Construyendo Flujos de Trabajo en SharePoint 2010 utilizando Visual Studio 2010 Esta es una sesión para desarrolladores .NET que construyen flujos de trabajo para SharePoint 2007 y buscan conocer cómo construir flujos de trabajo en SharePoint 2010. Exploraremos las nuevas características relacionadas con flujos dentro de SharePoint 2010 y el soporte simplificado Visual Studio 2010 aporta para facilitar su construcción y despliegue. 15 de Diciembre 2010 a las 4:30 PM Tiempo de México https://www.livemeeting.com/cc/mvp/join?id=wfday4&role=attend

Puedes seguir la cuenta del evento aqui:

Happy Coding!

Host-named SiteCollections

2010-11-22T21:40:00.000-08:00

En esta ocasión quiero hablar un poco acerca de los Host-Named SiteCollections (ó host-headers sitecollections). Que son, para que se utilizan, cuando no usarlos y como crearlos.

¿Que son los Host-Named SiteCollections?

Es la capacidad que brinda la infraestructura de SharePoint para crear SiteCollections, con lo que los amigos norteamericanos gustan nombrar como “vanity urls”. Es decir la capacidad de crear SiteCollections con un host-header personalizado e independiente de la url de la aplicación web, por ejemplo, consideremos las siguientes urls de sitecollections.

http://sales.contoso.com/
http://team.development.com/
http://research/

Si intentáramos utilizar el método de Path-based SiteCollection para formar estas urls, no nos quedaría más remedio que crear cada uno de estos sitecollection en una web application diferente para permitir que cada sitecollection tenga la url que se requiere.

¿Qué problema resuelven los Host-Named SiteCollections?

Gracias a esta característica podemos crear sitecollections con las urls que antes vimos, y todas vivir en una misma web application, sin necesidad de crear una web application independiente solo para resolver el tema de la url.

¿Para qué se utilizan los Host-Named SiteCollections?

Como comentamos antes, el uso principal es proveer la habilidad de nombrar sitecollections con una url que no tiene que ver en nada con la url de la web application en la cual vive.

Tiene un uso muy extendido en el área de hosting empresarial, o sea las empresas que se dedican a proveer hospedaje de sitios SharePoint, y es que, por medio de esta característica pueden construir una solución altamente escalable, ya que basta con crear una sitecollection con una url específica y asignar esa url a una entrada particular en sus DNS’s.

Otro uso es claramente, cuando una organización quiere dar identidad propia a cada una de sus áreas y/o suborganizaciones, y esto lo refleja en cada uno de los sitios de las mismas, que no solo tienen un aspecto visual distinto sino también una url única y acorde a sus funciones.

¿Cómo crear Host-Named SiteCollections?

Al igual que en la versión anterior, solo se pueden crear host-named sitecollections a través scripting, para generar los sitecollections antes mencionados podemos usar el siguiente script de ejemplo.

$web=Get-SPWebApplication http://sp2010:5300/

New-SPSite "http://sales.contoso.com" -OwnerAlias "moss\administrator" -HostHeaderWebApplication $web -Template "STS#0"

New-SPSite "http://team.development.com" -OwnerAlias "moss\administrator" -HostHeaderWebApplication $web -Template "STS#0"

New-SPSite "http://research" -OwnerAlias "moss\administrator" -HostHeaderWebApplication $web -Template "STS#0"

Ventajas y Desventajas

Como un buen amigo dice, todo siempre es un trade-off, y este tema no sería la excepción. Algunas de las desventajas de usar esta características versus usar el tradicional path-based sitecollections son:

Desventajas

No soportan AAM (Alternate Access mappings)
Se consideran siempre en la zona Default, por lo que no pueden responder a dos o más urls diferentes.

Ventajas:

Alta escabilidad en soluciones de hosting
Url personalizadas

Mención especial merece el hecho de que, por residir varios sitecollections en una misma web application, se comparte el web.config, esto es una ventaja o desventaja según se quiera o no compartir/aislar funcionalidad entre los sitecollections

Por último quisiera mencionar una utilería creada por Sharad Kumar, para agregar a la interfaz del sitio central de administración una opción para crear estos host-named sitecollections de manera visual

Recursos Adicionales:

Plan for host-named site collections (SharePoint Server 2010)

SharePoint 2010 – Central Admin tooling to create host header site collections

Configuración SharePoint 2010 - User Profile Application Service Error

2010-11-21T10:19:00.000-08:00

Uno de los tantos errores que podemos obtener al intentar configurar el nuevo servicio de aplicación para perfiles de usuario(User Profile Application Service), al querer acceder a la página de administración de este servicio nos aparece este mensaje:

Y al revisar los logs de SharePoint encontramos una entrada como la siguiente:

UserProfileServiceUserStatisticsWebPart:LoadControl failed, Exception: System.IO.FileLoadException: The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040) at Microsoft.Office.Server.UserProfiles.UserProfileConfigManager.InitializeIlmClient(String ILMMachineName, Int32 FIMWebClientTimeOut)
at Microsoft.Office.Server.UserProfiles.UserProfileConfigManager..ctor(UserProfileApplicationProxy userProfileApplicationProxy, Guid partitionID)
at Microsoft.SharePoint.Portal.WebControls.UserProfileServiceStatisticsWebPartBase.LoadControl(Object sender, EventArgs e)

Y es que he de admitir que si bien es cierto que este servicio sufrió grandes modificaciones y adiciones de nuevas características para la versión 2010, también es cierto que se volvió más difícil de configurar, administrar, y diagnosticar al momento de implementarlo. Y no difícil por la cantidad de pasos o procedimientos que se tienen que ejecutar, sino por la cantidad de errores con que nos podemos encontrar al intentar hacerlo trabajar.

Sin embargo este error, en especial, es muy conocido y fácil de solucionar. El escenario en el que se presenta muy usualmente es el siguiente.

Escenario
El servicio User Profile Application Service y el Sitio Central de Administración han sido provisionados en el mismo servidor.

Solución
Ejecute un IISRESET después de iniciar el servicio, eso es todo!.

Desarrollo SharePoint 2010 - The Web application at [Url] could not be found

2010-11-15T13:35:00.000-08:00

El siguiente es un error que aparece con mucha frecuencia cuando comenzamos a desarrollar para SharePoint 2010, por lo menos esa es mi impresión en los equipos de desarrollo en que he participado.

The Web application at [Url] could not be found. Verify that you have typed the URL correctly. If the URL should be serving existing content, the system administrator may need to add a new request URL mapping to the intended application.

La excepción se presenta cuando accedemos programáticamente a un sitio SharePoint ("http://sp2010"), obviamente después de habernos asegurado que la url esta correcta.

Y es que sí creamos algún proyecto desde las plantillas de proyecto que vienen por default en Visual Studio 2010 especiales para desarrollo SharePoint, como lo son "Visual Web Part", "List Definition", "Sequential Workflow", etc. no obtendremos este error.

Sin embargo si creamos, por ejemplo, una aplicación de consola ó Windows Forms y después de agregar las referencias necesarias para trabajar con la API de SharePoint, muy probablemente nos aparecerá este error. Y esto es debido a que este tipo de aplicaciones al crearse especifican el valor de configuración de Platform target a x86, lo que indica que nuestra aplicación intentara ejecutarse como un proceso de 32 bits.

Para solucionar ó prevenir este comportamiento solo se debe establecer este valor de configuración a x64 ó Any CPU(si estamos desarrollando en un ambiente x64) y nuestro código funcionará correctamente.

Por cierto, no se olviden de establecer el parámetro de configuración Target framework a: .Net Framework 3.5

Recursos adicionales:
Visual Studio .NET Platform Target Explained

Happy Coding!

SharePoint DisableLoopbackCheck security feature

2010-10-11T22:18:00.000-07:00

Hace unos días algunos desarrolladores me comentaban acerca de un "error" que ellos describían de la siguiente manera: "No podemos ver ninguna de los sitios SharePoint en el Servidor".

El problema

Cada vez que intentaban ver alguno de los sitios SharePoint, que se habían creado previamente, les pedía en repetidas ocasiones (las tres de rigor) su usuario y contraseña antes de mandar un error 401.1 Access Denied y una entrada en el EventViewer, todo esto solo cuando accedían a alguno de los sitios desde el servidor, desde cualquier cliente todo funcionaba correctamente.

Consideraciones a tomar

En primera instancia esto no es un gran problema porque ningún usuario usa alguno de los servidores de la granja de SharePoint para ver los sitios ahí hosteados. Pero y si es un servidor de pruebas? ó si ese servidor del que hablamos es nuestro entorno de desarrollo?. En estos casos es obligatorio que podamos acceder a los sitios sin que este comportamiento ocurra.

Un poco de historia

Este característica de seguridad fue introducida desde el Service Pack 1 de Windows Server 2003 y está presente hasta las versiones actuales de Windows Server 2008 R2. Básicamente lo que hace es bloquear el acceso a una web application usando el FQDN, si esto sucede la característica entra en acción y bloquea este acceso enviando un error 401.1, que por cierto no es muy adecuado.

¿Por qué se introdujo esta característica? Pues porque existían varios ataques que se basaban en reflección para engañar a IE y hacerle creer que se estaba trabajando de manera local y así burlar muchas restricciones de seguridad.

Algunos otros escenarios

Otros escenarios en los que esta característica de seguridad puede causar problemas, es en los servidores que además de tener el rol de WFE, también tienen el rol de Index. Esto porque básicamente el servidor Index intenta hacer un crawling (peticiones http) a sí mismo. Este comportamiento es fácilmente detectable porque los logs de crawling muestran cientos de errores del tipo 401.

Las soluciones

Pues muy fácil, seguimos las instrucciones del Microsoft's KB article 896861. Pero entonces para que todo este rollo que acaban de leer?

La solución dependerá en gran medida de lo que quieran hacer y el entorno en el que se encuentren. Como comentaba anteriormente, si se trata de un servidor de pruebas o de desarrollo, adelante!! Sigan el artículo y deshabiliten la característica LoopBackCheck.

Pero en un servidor productivo esto no es aceptable, ya que se constituye en un hueco de seguridad importante. Pero entonces, no es posible solucionar este problemilla en un servidor productivo? Por supuesto que sí!, sin embargo la solución no va por el camino de deshabilitar la característica LoopBackCheck, lo ideal es utilizar el Método dos descrito en el KB 896861, el cual indica la forma de agregar una entrada en el registro llamada BackConnectionHostNames, dentro de esta nueva entrada se agregarán host names que serán excluidos del funcionamiento de esta característica.

Algunas referencias adicionales

DisableLoopbackCheck? Lets do it the right way
Groundhog Day: Configuring Back Connection Host Names using Group Policy
Setting Back Connection Host Names for SharePoint 2007 Using STSADM
You receive error 401.1 when you browse a Web site that uses Integrated Authentication and is hosted on IIS 5.1 or a later version

The list cannot be displayed in Datasheet view with Office 2010

2010-08-05T13:35:00.000-07:00

Si aún están utilizando Office 2007, y están intentado ver la vista de hoja de datos (datasheet view) de una lista que se encuentre en un sitio de SharePoint 2007, este artículo puede resolver su problema.

Sin embargo, si ustedes como yo, están utilizando ya Office 2010 e intentan acceder a su vieja intranet corporativa(por poner un ejemplo), desplegada sobre SharePoint 2007, podrían obtener también este error.

La solución a este pequeño inconveniente es instalar el 2007 Office System Driver: Data Connectivity Components, tal como refiere el KB 2266203.

Y con este sencillo paso, ahora ya podrán abrir las listas de SharePoint 2007 en modo "datasheet view" aún cuando no tengan instalado Office 2007 y si el poderoso Office 2010.

[SharePoint Error] - An exception of type Microsoft.SharePoint.Upgrade.SPUpgradeException was thrown

2010-07-25T14:37:00.000-07:00

Una excepción muy rara y un poco fuera de lugar, dado que no estaba ejecutando algún proceso de migración, como se podría suponer por el nombre y descripción del error.

Failed to create the configuration database.
An exception of type Microsoft.SharePoint.Upgrade.SPUpgradeException was thrown. Additional exception information: One or more types failed to load. Please refer to the upgrade log for more details.
Microsoft.SharePoint.Upgrade.SPUpgradeException: One or more types failed to load. Please refer to the upgrade log for more details.
at Microsoft.SharePoint.Upgrade.SPDelegateManager.RegisterAssembly(Assembly asm, UInt32 nOrder)
at Microsoft.SharePoint.Upgrade.SPDelegateManager.get_InitialTypeDictionary()
at Microsoft.SharePoint.Upgrade.SPDelegateManager.GetDelegateTypes(Type tpObject)
at Microsoft.SharePoint.Upgrade.SPDelegateManager.GetDelegates(Object o)
at Microsoft.SharePoint.Upgrade.SPDelegateManager.GetUpgraders(Object o)
at Microsoft.SharePoint.Upgrade.SPManager.NeedsUpgradeFalse(Object o)
at Microsoft.SharePoint.Administration.SPPersistedUpgradableObject.set_NeedsUpgrade(Boolean value)
at Microsoft.SharePoint.Administration.SPPersistedObject.Update()
at Microsoft.SharePoint.Administration.SPFarm.Update()
at Microsoft.SharePoint.Administration.SPConfigurationDatabase.RegisterDefaultDatabaseServices(SqlConnectionStringBuilder connectionString)
at Microsoft.SharePoint.Administration.SPConfigurationDatabase.Provision(SqlConnectionStringBuilder connectionString)
at Microsoft.SharePoint.Administration.SPFarm.Create(SqlConnectionStringBuilder configurationDatabase, SqlConnectionStringBuilder administrationContentDatabase, IdentityType identityType, String farmUser, SecureString farmPassword)
at Microsoft.SharePoint.Administration.SPFarm.Create(SqlConnectionStringBuilder configurationDatabase, SqlConnectionStringBuilder administrationContentDatabase, String farmUser, SecureString farmPassword)
at Microsoft.SharePoint.PostSetupConfiguration.ConfigurationDatabaseTask.CreateOrConnectConfigDb()
at Microsoft.SharePoint.PostSetupConfiguration.ConfigurationDatabaseTask.Run()
at Microsoft.SharePoint.PostSetupConfiguration.TaskThread.ExecuteTask()

Por el contrario, estaba alegremente instalando MOSS 2007 SP2 en una máquina virtual.

Después de un rato de buscar en la red, solo se hace referencia en esta entrada de Microsoft Connect. Que menciona que si tienes instalado Office 2010 se puede presentar este problema, y en mi caso así fué. Una vez que desinstale Office 2010 y posteriormente procedí a reintentar la instalación de MOSS 2007, esta se ejecuto sin problemas.

Espero esta información les sea de utilidad.

Exámenes para SharePoint 2010 liberados!

2010-07-18T11:16:00.000-07:00

Si, los exámenes para SharePoint 2010 han sido liberados oficialmente el pasado 12 de julio, con el anuncio realizado en el blog Born to Learn.

The newest members of the SharePoint exam family are now available!

70-573 -- TS: Microsoft SharePoint 2010, Application Development

70-576 -- PRO: Designing and Developing Microsoft SharePoint 2010 Applications

70-667 -- TS: Microsoft SharePoint 2010, Configuring

70-668 -- PRO: SharePoint Server 2010, Administrator

The links will take you the official exam pages with audience profiles, skills measured, and other information to help you prepare.

Just getting started with SharePoint 2010? Find out more about upcoming training releases and other support from MS Learning here:

All four exams are available now in English at Prometric test centers worldwide. Localized versions (Japanese, German, French and Brazilian Portuguese) are in the works and will be ready in early August.

[Webcast] - Configurar Alternate Access Mappings en SharePoint 2010

2010-06-22T10:51:00.000-07:00

Tal y como dice el título de este post, aquí dejo un webcast en el que explico y muestro como configurar los AAM (Alternate Access Mappings) en SharePoint 2010.

Recuerden eston tres sencillos pasos:

Agregar la Url de acceso alternativo en alguna de las zonas de nuestra web application.
Agregar una entrada en su respectivo servidor de DNS, con el hostheader a utilizar.
Agregar un binding en el IIS utilizando el hostheader antes mencionado, aunque no lo menciono en el webcast, este paso se debe ejecutar en cada uno de los WFE's :(

Recursos adicionales:
Some AAM guidance from the front lines
Server Name Mapping and Alternate Access Mapping (AAM)