Tirando Código

Entrevista CompartiMOSS

2013-12-11T13:51:00.000-08:00

CompartiMOSS es una revista digital especializada en temas de SharePoint y algunas tecnologías relacionadas a esta plataforma de colaboración. En la más reciente edición de la revista del mes de Diciembre se publicó una entrevista que me hicieron en días pasados.

Les recomiendo ampliamente lean los artículos de esta revista, y claro también lean la entrevista que me hicieron.

Link al número 18 de la revista

Entrevista a Gerardo Reyes por Fabian Imaz

Happy Coding!

ID4037: The key needed to verify the signature could not be resolved from the following security key identifier

2013-10-31T20:22:00.000-07:00

Hace unos días estaba revisando un portal de SharePoint 2013 que había sido configurado para permitir la autentificación mediante Windows Live ID, la autentificación había sido configurada utilizando las siguientes guías:

Configure claims-based authentication using Windows Live ID (SharePoint Server 2010)
Visual guide to Windows Live ID authentication with SharePoint 2010 - part 1

Aunque las guías mencionadas son para SharePoint 2010 funcionan para SharePoint 2013 también, tan es así que el portal estuvo funcionando adecuadamente durante la etapa de desarrollo del proyecto (algunas semanas) sin embargo de un día para otro dejo de funcionar la autentificación mediante Windows Live ID y en su lugar el portal mostraba el siguiente error cuando un usuario intentaba autentificarse mediante este método.

El mensaje:

ID4037: The key needed to verify the signature could not be resolved from the following security key identifier.

Después de revisar un rato los logs de SharePoint que se generaban al presentarse el error no encontré mayor información acerca del error por lo que decidí revisar los datos de configuración del proveedor de autentificación, sin embargo todo parecía estar correctamente configurado. Por último recordé que al ser esta una instalación de “Staging” los certificados que se utilizan para la configuración son temporales por lo que procedí a revisar la vigencia de los certificados y efectivamente estaban vencidos.

Una vez descubierta la causa del error es hora de buscar la solución, la cual describo a continuación:

1.- Remover los certificados expirados. Para esto pueden utilizar la consola MMC.exe importando el addin de Certificados, identificar los certificados que ya expiraron y eliminarlos, los certificados deben encontrarse en los siguientes almacenes: Trusted Root Certification Authority, Trusted People y SharePoint.

2.- Una vez que los certificados han sido removidos se debe descargar de nuevo el certificado para posteriormente instalarse en los mismos almacenes. El certificado debe descargarse de la url https://nexus.passport-int.com/federationmetadata2/2007-06/federationmetadata.xml, se debe copiar y pegar en un archivo de texto lo que se encuentra del nodo X509Certificate, se guarda el archivo con extensión .cer.

3.- Una vez que se cuenta con el certificado actualizado se debe instalar en los mismos almacenes de los que se eliminó: Trusted Root Certification Authority, Trusted People y SharePoint.

4.- Por ultimo ejecutamos este pequeño script de PowerShell para actualizar solo el certificado del Trusted Identity Token Issuer

$certfile="C:\temp\LiveID-INT.cer" #path en donde se encuentra el nuevo certificado descargado desde https://nexus.passport-int.com/federationmetadata2/2007-06/federationmetadata.xml
$tokenIssuer=Get-SPTrustedIdentityTokenIssuer -Identity "LiveID INT" #Nombre con el que se registro el Trusted Identity Token Issuer
Set-SPTrustedIdentityTokenIssuer -Identity $tokenIssuer -ImportTrustCertificate $certfile

Despues de realizar estos sencillos pasos el sitio vuelve a funcionar y ya permite la autentificación mediante Windows Live ID

Happy Configuring!

Error configurando SQL Server Reporting Services 2012 en SharePoint 2010

2013-08-08T18:32:00.000-07:00

Hola amigos, el día de hoy con un escenario que encontré hace unos días que intentaba configurar SSRS 2012 en SharePoint 2010.

El escenario es el siguiente: tenía una granja pequeña de SharePoint 2010 SP 2 con dos servidores y un servidor de base de datos con SQL Server 2012 SP 1.

Como parte de los requerimientos era necesario habilitar el servicio de Reporting Services en SharePoint 2010, por lo que procedí a descargar el Add-in de Reporting Services para SharePoint:

Microsoft® SQL Server® 2012 SP1 Reporting Services Add-in for Microsoft® SharePoint®

Sin embargo después de instalar el Add-in en los servidores de SharePoint y seguir el procedimiento standard de instalación de Microsoft, que consiste en la ejecución de los comandos de PowerShell:

Install-SPRSService
Install-SPRSServiceProxy
get-spserviceinstance -all |where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance

Y posteriormente la creación del service application de Reporting Services en el sitio central de administración, noto que no me es posible crearlo, al revisar los servicios iniciados en el servidor me doy cuenta que el servicio SQL Server Reporting Services Service tuvo un error al iniciarse. Como buen consultor intento iniciarlo una vez más (porque todos pensamos que los problemas se resuelven haciendo las mismas cosas muchas veces?) y veo el siguiente error en pantalla:

Pero como siempre, este tipo de mensajes no son de mucha ayuda por lo que revise el visor de eventos de Windows para ver si existe alguna información extra que me ayude a corregir el error, pero solo encuentro el mismo mensaje:

Installation Error: Could not find SOFTWARE\Microsoft\Microsoft SQL Server\110 registry key Error with installing SQL Server Reporting Service Application

Después de un rato de investigación y de no encontrar nada, vuelvo a leer y revisar los procedimientos de instalación (oficiales y no oficiales) y me doy cuenta que algunos blogs hacen referencia a este Add-in, sin embargo otros hacen referencia, implícitamente, al uso de la media de SQL Server 2012, es decir del archivo ISO con que se instaló SQL Server 2012 y lo utilizan para instalar el Add-in de SSRS en los servidores de SharePoint.

Dado que en este punto no sabía que otra cosa intentar más que utilizar los bits de SQL Server 2012 SP 1 para configurar Reporting Services procedo a desinstalar el Add-in:

Y posteriormente utilizando los bits de SQL Server 2012 SP 1 con que se instaló el servidor de base de datos, ejecuto el instalador en los servidores de SharePoint 2013 y selecciono solo los componentes necesarios de Reporting Services.

Acto seguido vuelvo a ejecutar los comandos de PowerShell y reviso si el servicio fue iniciado adecuadamente, y efectivamente todo funciona como debería.

Ya solo por curiosidad reviso la versión del Add-in instalado y note que si es diferente a la versión que había estado instalando previamente:

Espero que este post les sirva y ahorre tiempo en el futuro.

Happy configuring!

SharePoint 2010 Service Pack 2

2013-07-23T20:06:00.000-07:00

El dia de hoy se han hecho públicos los bits del service pack 2 de SharePoint 2010, por lo que a continuación les comparto un enlace de donde pueden descargarlos:

SharePoint Foundation 2010 SP2
SharePoint Server 2010 SP2

En este link pueden encontrar el listado de cambios que se incluyen en el service pack 2

Por su puesto tambien estan disponibles los service pack 2 para los respectivos language packs

Service Pack 2 for Microsoft SharePoint Foundation 2010 Language Pack
Service Pack 2 for Microsoft 2010 Server Language Pack

No olviden primero instalar y probar estos nuevos bits en ambientes de desarrollo y/o pre producción.

Happy updating!

Error <nativehr>0x80070003</nativehr><nativestack></nativestack> al restaurar una colección de sitios

2013-07-10T20:56:00.000-07:00

Hace algunos días intentando restaurar una colección de sitios desde un respaldo generado en otra granja, me encontré con el siguiente error:

<nativehr>0x80070003</nativehr><nativestack></nativestack> At line:1 char:1 + Restore-SPSite http://webapplication:12345/sites/sitecollection_name -Pat ... + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~ + CategoryInfo : InvalidData: (Microsoft.Share...dletRestoreSite: SPCmdletRestoreSite) [Restore-SPSite], DirectoryNotFoundException + FullyQualifiedErrorId : Microsoft.SharePoint.PowerShell.SPCmdletRestoreSite
La instrucción de PowerShell que estaba utilizando era algo como lo siguiente

Restore-SPSite -Identity http://server_name/sites/sitecollection -Path c:\temp\site_name.bak

Buscando un poco en la web se encuentran algunas referencias de dos posibles razones y formas de corregir este error:

1.- Managed Path incorrecto. Esto en caso de que el managed path "sites" no estuviera registrado como un path valido en el web application, la solución evidentemente es agregarlo. No era mi caso

2.- Permisos. Ejecutar el comando de Restore-SPSite con un usuario sin permisos; la solución obviamente es ejecutar el comando con un usuario administrador de la granja de SharePoint. Desafortunadamente tampoco era mi caso.

La forma en que yo pude realizar satisfactoriamente la restauración de la colección de sitios en la granja de destino fue a partir de un backup realizado desde la base de datos de contenido, a continuación enumero los pasos a seguir para realizar este workaround.

1.- Identificar la base de datos de contenido que contiene la coleccion de sitios que deseamos restaurar en la granja destino.
2.- Realizar un full backup de esta base de datos mediante SQL Server Management Studio (o mediante t-sql).
3.- Mover el respaldo realizado a una ubicacion que pueda ser accedida desde la base de datos de la granja destino.
4.- Restaurar la base de datos de contenido en una nueva base de datos dentro de la instanacia de SQL Server de la granja de SharePoint destino.
5.- Montar la base de datos con el siguiente comando de PowerShell:

Mount-SPContentDatabase "Nombre_de_la_base_de_datos_de_contenido_restaurada"  -WebApplication http://webapplication_destino

Por ultimo es importante recordar que una base de datos de contenido puede contener mas un site collection por lo que si este es su caso, desafortunadamente tendrán que borrar manualmente las colecciones de sitios que no utilicen.

Referencias:
Restore-SPSite
Mount-SPContentDatabase

Happy Coding!

SkyDrive Pro app para Windows 8 e iOS

2013-06-28T20:41:00.000-07:00

Tal como lo dice el titulo de este post, el día de ayer Microsoft libero la app de SkyDrive Pro para Windows 8 y para iOS, las cuales pueden ser descargadas desde sus respectivos stores.

Desafortunadamente estas apps solo funcionan para suscriptores de Office 365 que utilizan SharePoint Online (SPO), pero esperemos que en un futuro cercano Microsoft agregue soporte para deployments on-premises

Happy testing!

Listar folders utilizando la API REST de SharePoint Online

2013-06-22T21:10:00.000-07:00

En ocasiones es necesario navegar programáticamente a través de la estructura de carpetas de una librería de documento o de una carpeta en específico, esta actividad es bastante sencilla realizándola mediante la API de servidor de SharePoint con la que hemos venido trabajando los últimos años.

Sin embargo a partir del nuevo paradigma de desarrollo de apps para SharePoint 2013, nos enfrentamos a nuevas formas de realizar los que antes ya hacíamos con API del servidor utilizando y nos lleva a utilizar métodos mucho más estándares y que son compatibles con el nuevo modelo de apps, me refiero a utilizar la API REST de SharePoint 2013.

En esta ocasión voy a ejemplificar como cumplir con la tarea de listar las carpetas de una librería de documentos mediante la api REST, lo primero que necesitamos en comenzar a construir la consulta REST a utilizar contra una librería de documentos, en principio la siguiente consulta nos mostraría la información de una librería de documentos:

https://myportal.sharepoint.com/_api/web/GetFolderByServerRelativeUrl('/Folders%20Library')

Donde “Folders Library” es el nombre de la librería de documentos de la cual quiero mostrar sus carpetas. Noten el uso del método GetFolderByServerRelativeUrl que se encuentra a nivel del “objeto” Web y el cual nos permite abrir un folder en particular, en este caso la librería de documentos en si misma.

Lo siguiente es utilizar la opción $expand para acceder a la “propiedad” Folders de la librería de documentos, algo como lo siguiente: https://myportal.sharepoint.com/_api/web/GetFolderByServerRelativeUrl('/Folders%20Library')?$expand=Folders

Por ultimo solo usamos la opción $select para seleccionar los campos que necesitamos, recuerden que siempre debemos limitar la cantidad de información que solicitamos al servidor, solo para fines de optimizar nuestro desarrollo, la url de consulta final:

https://myportal.sharepoint.com/_api/web/GetFolderByServerRelativeUrl('/Folders%20Library')?$select=Folders/name,Folders/ServerRelativeUrl,Folders/ItemCount&$expand=Folders

Una vez que tenemos lista la consulta solo agrego un código de ejemplo que pinta las carpetas que se encuentran dentro de la librería de documentos como un listado, Show me the money!

El script:

El resultado:

Happy Coding!

Recomendaciones para despliegue SharePoint 2013

2013-06-05T21:16:00.000-07:00

Recientemente me he embarcado en un proyecto que implica el despliegue de una granja de SharePoint 2013 con 16 servidores, si, como lo leyeron… 16 servidores!

Dado que el propósito de esta arquitectura será servir como un repositorio central de una gran cantidad de documentos, es decir Archiving, se ha diseñado una arquitectura que a grandes rasgos es integrada por los siguientes servidores:

3 servidores Web Front End

2 Servidores de Aplicación

11 Servidores dedicados para el servicio de búsqueda

Sin lugar a dudas más adelante estaré comentando como me ha ido con este despliegue de SharePoint, por el momento comparto algunos de los enlaces que a mí me han servido bastante para dimensionar y diseñar este monstruo de granja:

Software boundaries and limits forSharePoint 2013

Scaletest report for very large scale document repositories
Configuring SharePoint 2013 SearchTopology
Hardware and software requirementsfor SharePoint 2013

Install prerequisites for SharePoint2013 from a network share

Database types and descriptions(SharePoint 2013)

Configure SQL Server security forSharePoint 2013 environments

TCP/IP Ports of SharePoint 2013

Adicionalmente, y dado que es un proyecto que estamos realizando en conjunto con MCS (Microsoft Consulting Services) el equipo de soporte premier me ha recomendado instalar los siguientes fixes liberados hasta el momento, tómenlos en cuenta para sus implementaciones:

SharePoint Server 2013 update: March 12, 2013

SharePoint Server 2013cumulative update package (SharePoint server-package): April 26, 2013

Happy Configuring!

SharePoint 2013 - Recuperar imagenes de libreria de imagenes mediante REST

2013-05-29T22:17:00.000-07:00

En estos últimos días me he estado jugando un poco con la API REST para crear funcionalidad para SharePoint Online en donde, como todos ustedes ya saben, no se puede desplegar soluciones full trust.

La API REST de SharePoint es tan fácil de usar que combinándola con un poco de JavaScript y utilizando alguno de los frameworks más populares como jQuery, Knockout, JsRender, etc, etc, se pueden lograr cosas bastante funcionales y sobre todo muy visuales.

En esta ocasión voy a compartir un ejemplo de cómo recuperar las Urls de las imágenes que se encuentran en una librería de imágenes para mostrarlas en una WebPart.

Lo primero que debemos hacer y tal vez lo más “difícil” es construir la consulta ODATA que recupere los metadatos que necesitamos para obtener las urls de las imágenes.

En mi ejemplo la librería de imágenes se llama “Car Images” y se encuentra dentro de un subsitio WXYZ (el nombre de sus subsitio), por lo que la url podría quedar como la siguiente:

https://sitioprincipal/subsitio/_api/web/Lists/getbytitle('Car%20Images')/items?$Expand=File&$select=File/ServerRelativeUrl

La parte fundamental es la que esta marcada en negro, con esa consulta podemos recuperar las urls de las imágenes, sin embargo existe el inconveniente de que las urls que recuperamos pertenecen a las imágenes originales y que pueden ser muy grandes (como en mi caso) por lo que lo ideal es recuperar las imágenes pequeñas o thumbnails que se crean automáticamente cuando los archivos de imágenes se cargan en la biblioteca. Para lo anterior se debe modificar un poco la consulta para acceder a la carpeta “_t” que es en donde se encuentran esas imágenes miniatura, y quedaría de la siguiente manera:

https://sitioprincipal/subsitio/_api/web/GetFolderByServerRelativeUrl('Car%20Images/_t')?$Expand=Files&$select=Files/ServerRelativeUrl

Noten el uso de la función GetFolderByServerRelativeUrl para acceder a la carpeta “_t” y enumerar las imágenes miniatura. Una vez que ya tenemos la consulta lo siguiente es escribir un Html muy sencillo en el que se ejecute esta consulta y se pinten las imágenes en el HTML. Algo como lo siguiente podría funcionar:

Y si ponemos este Html dentro de un content editor...funciona!

Nótese que en este caso por simplicidad solo concateno texto para formar el HTML, algo que podría hacerse mucho mas elegante con Knockout por ejemplo, pero eso sera en un siguiente post.

Happy coding!

Webcast - Nuevo modelo de aplicaciones con Sharepoint 2013

2013-05-12T19:38:00.000-07:00

Hola amigos, quiero invitarlos al Webcast Nuevo modelo de aplicaciones con Sharepoint 2013, que estaré impartiendo como parte del ciclo de Webcast de Visual Studio 2012.

El Webcast se llevara a cabo el Lunes 27 de Mayo del 2013 a las 2:00 PM (GMT-06:00) hora de la ciudad de México.

Les comparto la URL para el registro:

Espero contar con su asistencia

Happy code!

SharePoint 2013 REST - Feed format not supported

2013-05-05T21:40:00.000-07:00

Si están comenzando a adentrarse en la creación de apps para SharePoint 2013, tal vez de las operaciones más básicas que están realizando es consumir la api REST de SharePoint, y dada la facilidad con que se puede hacer una consulta ODATA a través de la barra de navegación del explorador es muy probable que se enfrenten a la siguiente situación cuando crean una consulta:

Internet Explorer muestra el mensaje: Feed format not Supported.

Por suerte es bastante fácil solucionar esto, simplemente sigan los siguientes pasos:

En el menú Tools de Internet Explorer seleccionen la opción Internet Options

En la pestaña Content seleccionen la opción Feeds and Web Slices

Asegúrense que la opción Turn on feed Reading view no está seleccionada

Eso solucionara este pequeño inconveniente

Happy Coding!

Recomendaciones para iniciar a construir apps para SharePoint 2013

2013-05-01T19:42:00.000-07:00

Algo de lo cual me he dado cuenta últimamente es que desafortunadamente los desarrolladores de SharePoint que solo desarrollan para esta plataforma tienen nulos o vagos conocimientos de algunas otras tecnologías/plataformas/frameworks y es que haciendo una reflexión del día a día al que nos enfrentamos los desarrolladores SharePoint (me incluyo) lo común es crear elementos tales como:

Features
Event Receivers
Jobs
Web Services
WebParts
Workflows
Master Pages
Paginas (ASPX)
User Controls (ASCX)
Etc, etc

Además de lo acotado que es el ámbito técnico de los elementos de desarrollo de SharePoint, y por favor no me mal entiendan, la variedad de soluciones que se pueden construir con y sobre SharePoint es casi ilimitada sin embargo los elementos a utilizar tecnológicamente hablando son relativamente pocos (los listados arriba), lo que ocasiona que con el tiempo nos encasillemos en cosas como el desarrollo ASP.NET “tradicional”.

Dicho y aclarado lo anterior, no es de extrañarse la renuencia de los desarrolladores ahora que Microsoft quiere evangelizarlos para construir, diseñar y pensar en términos de apps en lugar de soluciones tradicionales (Farm Solutions) ya que las Apps implican muchos conceptos y tecnologías nuevos, y a veces hasta desconocidos, para este grupo de desarrolladores.

Es imprescindible que comencemos a aprender todos estos conceptos/frameworks/tecnologías ASAP si no queremos quedarnos fuera de la jugada y con el tiempo ir quedando relegados. Evidentemente no es posible aprender todo en una noche (o acaso les funciono cuando estudiaban la noche antes del examen? ) pero si es posible ir diseñando un track de auto capacitación que nos permita acercarnos a esta nueva apuesta de Microsoft.

A continuación les menciono y comparto un primer paquete de enlaces de los temas y herramientas con los que un “desarrollador SharePoint 2013” debería estar familiarizado, en posts subsecuentes iré agregando algunos otros enlaces recomendados junto con los ejemplos de desarrollos para SharePoint 2013, por el momento revisen lo siguiente:

Temas
ODATA
ASP.NET MVC 5
How to: Complete basic operations using SharePoint 2013 REST endpoints
Web API
Jquery

Herramientas
Fiddler
ODATA QueryBuilder
Internet Explorer Developer Tools
Chrome Developer Tools

Adicionalmente es muy recomendable que si tienen la oportunidad de adquirir una subscripcion al sitio de entrenamiento en linea de Pluralsight lo hagan sin dudarlo, tiene una amplia biblioteca de recursos tecnicos de muy buena calidad.

Por el momento pueden iniciar con estos temas, si consideran que hay alguna herramienta o tema fundamental para iniciar el desarrollo de Apps que no haya mencionado no duden en comentar!

Happy Coding!

Rich Text Field in SharePoint Document Library

2013-03-05T10:18:00.000-08:00

Se han visto en la necesidad de agregar una columna de texto enriquecido a una librería de documentos de SharePoint?

Si es así, se habrán dado cuenta que las librerías de documentos permiten crear un campo de texto multilinea pero no permite utilizar texto enriquecido.

De manera predeterminada las librerías de documentos de SharePoint no permiten utilizar el texto enriquecido en una columna. De hecho si miramos dentro de las propiedades del campo en la librería de documentos, utilizando PowerShell, veremos que en efecto los valores de los campos no son los adecuados para poder ingresar texto enriquecido en la columna recién creada.

Sin embargo siempre se puede utilizar un poco de scripting para "corregir" todo. A continuación el fragmento de PowerShell que modifica este comportamiento.

cls
$site= Get-SPSite -Identity http://sharepoint/sites/Test/
$web = $site.RootWeb

$lists= $web.Lists["Documents"]
$field=$lists.Fields["RichTextColumn1"]

$field.RichText=$True
$field.RichTextMode="FullHtml"
$field.UnlimitedLengthInDocumentLibrary=$True

$field.Update()

Adicionalmente deben tener cuidado con la propiedad UnlimitedLengthInDocumentLibrary, ya que podría causar problemas de performance si el usuario decide agregar mucho texto en esa columna o si esta columna será utilizada como metadato de alguno de los documentos de Office, ya que estos últimos tienen la restricción de solo soportar 255 caracteres como máximo.

Happy Scripting!

Exámenes liberados para SharePoint 2013

2013-02-05T09:16:00.000-08:00

Tal vez aún no se hayan dado cuenta, pero un par de exámenes de SharePoint 2013 ya fueron liberados desde el 1 de Febrero. Los exámenes liberados son:

Estos exámenes forman parte del path de certificación para MCSM de SharePoint

Adicionalmente, se enviaron los resultados para los que presentaron alguno de estos exámenes el pasado noviembre de 2012, cuando todavía se encontraban en fase beta. Yo presenté y pasé el examen Core Solutions of Microsoft SharePoint Server 2013, además de poder contribuir a generar feedback a Microsoft para ese examen.

Desafortunadamente los exámenes del path de certificación de desarrollo aún no han sido liberados

Pues a preparar los exámenes!!!

Pruebas unitarias con SharePoint Emulator Package

2013-01-18T15:59:00.000-08:00

No sé si ustedes hayan notado el mes pasado (con todas las fiestas que había) que el equipo de Visual Studio anuncio el paquete de SharePoint Emulators de Visual Studio 2012 para SharePoint 2010.

De entrada este paquete solo aplica para SharePoint 2010 y utilizándolo en Visual Studio 2012. Es comprensible que este paquete solo aplique para SharePoint 2010, dado el poco tiempo que lleva SharePoint 2013 liberado, además de que la finalidad del emulador es poder probar código de servidor, mismo que Microsoft desalienta escribir para SharePoint 2013.

Este paquete se puede instalar a través de NuGet. Solo tienen que buscarlo y aparece dentro de los resultados.

En el pasado había sido bastante difícil aislar los componentes SharePoint de una solución para realizar pruebas unitarias, debido a que estos componentes dependen enormemente de SharePoint, es decir, para poder realizar la ejecución de pruebas de esos componentes era necesario tener instalado SharePoint.

SharePoint Emulators Package nos permite crear pruebas unitarias y ejecutarlas sin tener instalado un ambiente de SharePoint, este paquete se basa en el concepto de Shims de Microsoft Fakes para crear un contexto (un conjunto de Shims) en memoria de los objetos más comunes dentro de la API de SharePoint. Con lo que, para crear una prueba unitaria que utiliza objetos de la API de SharePoint lo único que debe hacer es encerrar el código que estamos probando dentro de un SharePoint Emulator Scope.

[TestMethod]
public void CreateList()
{
	using (SharePointEmulationScope scope = new SharePointEmulationScope(Microsoft.QualityTools.Testing.Emulators.EmulationMode.Enabled))
	{
		using (SPSite site = new SPSite("http://UrldePrueba/"))
		{
			using (SPWeb web = site.OpenWeb())
			{
				Assert.IsNotNull(web);

				//Definiendo la lista
				Guid listId = site.RootWeb.Lists.Add(listName, listName, SPListTemplateType.GenericList);
				SPList list = site.RootWeb.Lists[listId];
				Assert.IsNotNull(list);
				Assert.AreEqual(list.Title, listName, "Bad list name!");

				//agregando los campos a la lista
				list.Fields.Add("Code", SPFieldType.Number, true);
				list.Fields.Add("Name", SPFieldType.Text, true);
				list.Fields.Add("Description", SPFieldType.Text, true);

				//agregando dos nuevos elemento a la lista
				SPListItem item1 = list.Items.Add();
				item1["Code"] = 1;
				item1["Name"] = "West";
				item1["Description"] = "West Region";
				item1.Update();

				SPListItem item2 = list.Items.Add();
				item2["Code"] = 1;
				item2["Name"] = "East";
				item2["Description"] = "East Region";
				item2.Update();

				Assert.AreEqual(list.ItemCount, 2, "Bad number of items");
			}
		}
	}
}

Como mencionaba antes, este paquete solo contiene los Shims para los objetos de uso más común dentro de la API de SharePoint, por lo que habrá casos es los que al hacer uso de ciertos métodos o propiedades, que devuelven un tipo de objeto que no tiene su correspondiente Shim dentro del emulador, obtendremos excepciones de tipo NotSupportedException, como por ejemplo al intentar utilizar el método GetItems de un objeto SPList, que devuelve un objeto de tipo SPListItemCollection.

El siguiente código muestra el método que se está probando, en la línea 17 está la llamada al método GetItems que lanzará la excepción.

public string GetNameByCode(string listName, SPWeb web, int code)
{
	SPList list = web.Lists[listName];

	var listQuery = new SPQuery
	{
		Query = String.Format(
			"" +
			"" +
			"" +
			"{0}" +
			"" +
			"", code)
	};

	string name = string.Empty;
	foreach (SPListItem item in list.GetItems(listQuery))
	{
		name = item["Name"].ToString();
	}

	return name;
}

Lo genial de esto, es que es posible inyectar Shims al Emulador para los tipos no soportados, como por ejemplo para SPListItemCollection, de la forma tradicional, es decir usando Shims, como se aprecia de las líneas 41 a la 50

[TestMethod]
public void SearchItemById()
{
	int searchById = 2;

	using (SharePointEmulationScope scope = new SharePointEmulationScope(Microsoft.QualityTools.Testing.Emulators.EmulationMode.Enabled))
	{
		using (SPSite site = new SPSite("http://UrldePrueba/"))
		{
			using (SPWeb web = site.OpenWeb())
			{
				Assert.IsNotNull(web);

				//Definiendo la lista
				Guid listId = site.RootWeb.Lists.Add(listName, listName, SPListTemplateType.GenericList);
				SPList list = site.RootWeb.Lists[listId];
				Assert.IsNotNull(list);
				Assert.AreEqual(list.Title, listName, "Bad list name!");

				//agregando los campos a la lista
				list.Fields.Add("Code", SPFieldType.Number, true);
				list.Fields.Add("Name", SPFieldType.Text, true);
				list.Fields.Add("Description", SPFieldType.Text, true);

				//agregando dos nuevos elemento a la lista
				SPListItem item1 = list.Items.Add();
				item1["Code"] = 1;
				item1["Name"] = "West";
				item1["Description"] = "West Region";
				item1.Update();

				SPListItem item2 = list.Items.Add();
				item2["Code"] = 2;
				item2["Name"] = "East";
				item2["Description"] = "East Region";
				item2.Update();

				Assert.AreEqual(list.ItemCount, 2, "Bad number of items");

				//Agregamos el Shimp para el objeto SPListItemCollection
				if (scope.EmulationMode == EmulationMode.Enabled)
				{
					var fakeList = new ShimSPList(list);
					fakeList.GetItemsSPQuery = (query) =>
					{
						var shim = new ShimSPListItemCollection();
						shim.Bind(new[] { list.Items[0], list.Items[1] });
						return shim.Instance;
					};
				}

				RegionGateway gateway = new RegionGateway();

				//Ahora al realizar la llamada al metodo GetNameByCode, no se lanzara la excepcion
				string result = gateway.GetNameByCode(listName, site.RootWeb, searchById);
				Assert.AreNotEqual(string.Empty, result, true, "Search Failed!");


				Region searchItem = gateway.GetRegionById(listName, web, 1);
				Assert.IsNotNull(searchItem);
				Assert.AreEqual("West", searchItem.Name, true);
			}
		}
	}
}

Sin duda alguna un importante paquete que debiéramos usar desde ya para las pruebas unitarias de nuestro código. Ahora lo importante sería preguntar para cuando este paquete estará disponible para SharePoint 2013.

Por último les comparto el proyecto de Visual Studio para que vean el código y puedan analizarlo mejor.

Referencias

Happy Code!

JqGrid y la API REST de SharePoint 2013

2013-01-09T21:25:00.000-08:00

El motivo de este post es mostrar un ejemplo de como combinar el uso del jqGrid obteniendo datos de una lista de SharePoint a través de la API REST.

Antes que nada, supongo que muchos de ustedes conocen el jqGrid, si no es así, se están perdiendo de un plugin de jquery bastante interesante, muy fácil de usar y con bastantes características como:

Formatear celdas
Reordenar columnas
Menús contextuales para filas
Barras de menús personalizadas
Carga de datos desde diferentes fuentes como XML, JSON, etc
Multiseleccion
Resizing
Edición en línea
Agrupación
Búsqueda
Paginación
Y un largo etcétera.

Lo anterior combinado con la practicidad de la nueva API REST de SharePoint 2013 permite a los desarrolladores crear aplicaciones realmente sorprendentes.

Escenario:
Tengo un sitio de SharePoint con una lista llamada Sales con las columnas y datos que se aprecian en la imagen

Requerimiento:
Es necesario mostrar en una pagina, una vista de la lista utilizando alguna de las características arriba mencionadas, como ordenación, menús contextuales, multiseleccion, etc.

Solución:
Como siempre y para cualquier problema, no hay una solución única, pero yo me inclinaría por usar jqGrid, porque la solución es muy sencilla, fácil de codificar y ni siquiera requiere crear un wsp o una App (cosa que hare en otro post) que se instale y despliegue en la granja.

Solo hare uso de la webpart Script Editor para agregar un poco de HTML y JavaScript a una pagina cualquiera de SharePoint.

A continuación el código completo utilizado:

La explicación:
Primero agregamos algunas referencias a los archivos js y css, tanto del grid como de jquery

Luego agregamos el código para configurar el jqGrid, es decir las columnas, el ordenamiento, etc, etc. y el código para realizar la llamada REST y manejar la respuesta para hacer el Binding de datos JSON con el grid

$(onPageLoad);

//funcion que se ejecuta en el evento onLoad de la pagina
function onPageLoad()
{
 //adjuntamos a el evento onclick del boton 'getSales' la funcion getSales()
 $("#getSales").click(getSales);
   $(document).ready(function () {
   //configuramos el jqGrid
    $("#SalesTable").jqGrid({
    datatype: 'local',
    autowidth: true,
    height: 230,
    colNames: ['ID', 'Order Date', 'Region', 'Representative', 'Item', 'Units', 'Unit Cost', 'Total'],
    colModel: [
     { name: 'ID', index:'ID', width: 80 , sorttype:"int"},
     { name: 'Title', width: 80 , sorttype:"date"},
     { name: 'Region', width: 80 },
     { name: 'Rep', width: 80 },
     { name: 'Item', width: 80 },
     { name: 'Units', width: 80 },
     { name: 'Unit_x0020_Cost', width: 80 },
     { name: 'Total', width: 80 , sorttype:"float"},
    ],
    caption: 'Sales via OData'
  });
   });
}

//funcion que se ejecuta cuando hacemos click en el boton 'Obtener Ventas'
function getSales(){
 //Url REST de la consulta que estamos haciendo, recuperamos los elementos de la lista 'Sales'
 var requestUri = "http://sp2013app/_api/web/lists/getByTitle('Sales')/items/";
 //Se establece el header ACCEPT de manera adecuada
 var requestHeaders={
      "ACCEPT":"application/json;odata=verbose",
 }
 //se realiza la llamada ajax mediante jquery
 $.ajax({
 url: requestUri,    //Url de la consulta a realizar
 type:"GET",      //tipo de la llamada
 contentType:"application/json", //el tipo de contenido que esperamos recuperar, JSON
 headers: requestHeaders,  //headers correctos
 error:onError,      //en caso de error se ejecuta la funcion onError()
 success: onGetSalesSuccess  //en caso de exito, se ejecuta la funcion onGetSalesSuccess()
 }); 
}

//funcion que se ejecuta en caso de que la llamada REST sea exitosa
function onGetSalesSuccess(data){
 if(!data)return;
  //por cada uno de los resultados obtenidos se agrega una fila al jqGrid
  $.each(data.d.results,function(index, value){
   $("#SalesTable").jqGrid('addRowData', value.ID, value);
  });
 $("#SalesTable").jqGrid('SalesTable','#pager2',{edit:false,add:false,del:false});
}

function onError(xhr, status){
 alert(xhr.response.message);
}

Y por ultimo tenemos el código HTML que sirve como contenedor del grid, me refiero al input, la tabla y el div. Solo basta descomentar el código HTML al ser usado

El resultado:

Happy Coding!

HTML Field Security en SharePoint 2013

2013-01-04T12:41:00.000-08:00

Una de las nuevas características en el área de Web Content Management en SharePoint 2013 es que ahora existe una opción llamada HTML Security Settings que se encuentra en la sección de configuración de administradores de la colección de sitios, por lo que evidentemente se debe contar con este rol para utilizarla.

En SharePoint 2013 los creadores de contenido de un sitio puede agregar iframes en cualquier página, ya sea utilizando la opción Embed Code del menú Insert del Ribbon, o utilizando la nueva webpart Script Editor.

Hasta aquí ninguna novedad, en el pasado también se podían agregar iframes a una página de SharePoint, obviamente no utilizando las opciones arriba descritas ya que estas son nuevas en SharePoint 2013, pero si se podía hacer. Lo que la opción HTML Security viene a cubrir era la necesidad de los administradores de SharePoint (esos tipos a los que cualquier toque de creatividad les molesta) de poder restringir los dominios a los cuales se puede agregar o referenciar dentro de un iframe en un sitio de SharePoint.

Este setting permite habilitar a los usuarios con rol de "Contributors" el poder agregar iframes a partir de un listado de dominios permitidos, poder referenciar cualquier dominio o no poder insertar iframes con contenido externo a SharePoint en absoluto. La opción por default es permitir a los contribuidores agregar iframes con un listado de sitios también predefinido, como se aprecia en la imagen.

Para este ejemplo voy a agregar un iframe a una página de SharePoint referenciando uno de mis sitios favoritos, Channel 9. Aunque como se puede apreciar en la imagen, obtendré un mensaje indicándome que no cuento con los permisos suficientes para agregar el iframe.

Lo que se debe hacer es ir a apartado de configuración de HTML Security Settings y agregar el dominio channel9.msdn.com (para este ejemplo), y acto seguido intentar de nuevo agregar el iframe.

Y con esto podemos ya agregar satisfactoriamente una referencia a contenido externo, de manera un poco más ordenada.

Un último comentario es que este setting solo aplica/restringe a los usuarios con el rol de "Contributors", es decir que si eres el dueño del sitio o un site collection administrator, ni te preocupes por este tipo de limitantes que solo aplican a los simples mortales. Lo que debería preocuparte es revisar tu modelo de gobernabilidad en SharePoint.

Happy Configuring!

The HTTP header ACCEPT is missing or its value is invalid making rest call using JavaScript

2012-12-14T00:09:00.000-08:00

Es bastante común que al intentar hacer una llamada utilizando la API REST para SharePoint 2013 utilizando JavaScript, como la siguiente:

function onGetCustomers(){
 var requestUri = _spPageContextInfo.webAbsoluteUrl + "/_api/web/lists/getByTitle('Clientes')/items/?$select=Title,Nombre,Apellidos";
 
 //$.getjson() falla
 jqCall = $.getJSON(requestUri,null, onGetCustomersSuccess);
 jqCall.error(onError);
}

Nos encontremos con un error como este:

25d
{"error":{"code":"-1, Microsoft.SharePoint.Client.ClientServiceException","message":{"lang":"en-US","value":"The HTTP header ACCEPT is missing or its value is invalid."},"innererror":{"message":"The HTTP header ACCEPT is missing or its value is invalid.","type":"Microsoft.SharePoint.Client.ClientServiceException","stacktrace":" at Microsoft.SharePoint.Client.Rest.RestRequestProcessor.Process()\r\n at Microsoft.SharePoint.Client.Rest.RestRequestProcessor.ProcessRequest()\r\n at Microsoft.SharePoint.Client.Rest.RestService.ProcessQuery(Stream inputStream, IList`1 pendingDisposableContainer)"}}}
0

Y esto se debe sencillamente a que si inspeccionamos a detalle los headers enviados en la petición encontraremos que hace falta algo adicional:

Headers enviados como parte del request:

Al hacer este tipo de llamadas debemos indicar, junto con el header Accept=application/json, el header: odata=verbose, es decir quedaría de esta forma: Accept=application/json; odata=verbose. Esto debido a que por el momento solo se soporta el formato verbose de JSON, el formato "light" no es soportado.

Luego entonces cambiamos la llamada para incluir este header, por el siguiente código:

function onGetCustomers(){
 var requestUri = _spPageContextInfo.webAbsoluteUrl + "/_api/web/lists/getByTitle('Clientes')/items/?$select=Title,Nombre,Apellidos";

 var requestHeaders={
 "ACCEPT":"application/json;odata=verbose",
 }

 $.ajax({
 url: requestUri,
 type:"GET",
 contentType:"application/json",
 headers: requestHeaders,
 success:onGetCustomersSuccess,
 error:onError
 });
}

Después de realizar esto, la respuesta sera satisfactoria

Algunas referencias:
Important developer changes from Office and SharePoint 2013 Preview to Office and SharePoint 2013
OData Verbose JSON Format

Happy Coding!

Add Sign In as Different User in SharePoint 2013 with custom action

2012-12-08T02:23:00.000-08:00

Si ya han estado utilizando SharePoint 2013, por lo menos en ambientes de pruebas, se habrán dado cuenta que en el menú de acciones personales la opción "Sign as Different User" simplemente ya no esta, todos pensábamos que era solo una omisión de la versión beta, pero ahora que se han liberado la versión definitiva, vemos con asombro que sigue sin aparecer.

Nick Grattan muestra en su ejemplo de como agregar esta opcion al menu, sin embargo es necesario mencionar que no es una buena practica (sin tomar en cuenta que no es soportada por Microsoft) modificar los archivos que están en el folder 15, ademas de que en un ambiente multiservidor se deberían modificar al menos todos los WFE's.

Una mejor solución, desde mi particular punto de vista, es crear un custom action que agregue la opción al menú mediante una feature que se despliegue en la granja de SharePoint.

Nuestro Objetivo

Para lo cual, crearemos una solución en blanco de SharePoint 2013, agregando un elemento de tipo "Empty Element"

Y agregamos el siguiente código al archivo Elements.xml que se ha creado

Luego cambiamos el scope de la feature que se creo al agregar el archivo Elements, el scope que debemos establecer es WebApplication para que podamos aprovechar ese elemento en toda la aplicación web

Por último hacemos el deploy de nuestro custom action y ya podremos ver el nuevo elemento del menú que nos permite firmarnos con diferentes usuarios

Para concluir les comparto el código.

Happy Coding

Webcast - CSOM y la API REST para SharePoint 2013

2012-12-07T21:35:00.003-08:00

Como parte de la continuación del exitoso maratón de SharePoint que se llevo a cabo el día 29 de Noviembre y que desafortunadamente tuvo que suspenderse por motivos técnicos.

Quiero invitarlos al webcast que estaré impartiendo el día martes 11 de Diciembre de este 2012.
El horario es 02:00 – 03:00 (GMT +1), es decir (7:00 pm a 8:00 pm hora del centro de México UTC-6:00)

Ademas comparto la lista completa de webcast que se estaran impartiendo.

Espero me puedan acompañar

Entrar al evento

Happy Coding!

SharePoint Conference 2012

2012-11-30T00:05:00.000-08:00

Pues bien, ha sido un evento fabuloso, bastante bien organizado.

La calidad de profesionales que tuve oportunidad de conocer y las opiniones que compartimos fueron realmente valiosas

Las vegas es una ciudad asombrosa con muchos lugares a donde ir, aunque muy cara. De noche siempre hay algo que hacer

Sin duda un evento que quedara para la historia

Algunas fotos.

SharePoint 2010 - New instances of this workflow template are currently disallowed

2012-11-04T21:12:00.001-08:00

¿Les ha pasado que alguna vez quieren iniciar una instancia de un flujo de trabajo y aparece este mensaje de error?

Bueno púes a mí me había pasado muchas veces, solo que nunca al utilizar código para iniciar automáticamente un flujo de trabajo, es decir, siempre que había obtenido este mensaje de error había sido utilizando la interfaz de usuario, para lo cual existen muchas referencias en la red para solucionarlo.

SharePoint 2007 - New instances of this workflow template are currently disallowed
Error: New instances of this workflow template are currently disallowed.

¿Pero y cómo podemos resolverlo cuando hablamos de código?

Al igual que cuando lidiamos con este error al intentar inicializar in flujo de trabajo utilizando la interfaz de usuario, este error se debe a que existe más de una versión del mismo flujo relacionada con la lista o cualquier otro elemento al que se pueda asociar un workflow como librerías de documentos, sitios, etc., en mi caso específico con un tipo de contenido.

Para ejemplificar este escenario, muestro a continuación mi código de powershell que tenía este error, y el cual simplemente intentaba iniciar programáticamente todas las instancias de una lista de SharePoint con el estatus de “Cancelled”:

cls
#Add-PSSnapin microsoft.sharepoint.powershell
$siteUrl="http://sp2010/mysite"
$site = Get-SPSite -Identity $siteUrl

foreach($web in $site.AllWebs)
{
    $list=$web.Lists["List"]
    $manager=$site.WorkFlowManager
   
    foreach($ct in $list.ContentTypes)
    {
        if($ct.Name -eq "MyContentType")
        {
            $swapWorkflowAssociation = $Ct.WorkflowAssociations[0]
        }
    }
    
    #Si la referencia al objeto WorkflowAssociation es null, no intentamos iniciar el WF
    if($swapWorkflowAssociation -eq $null) { continue } 
   
    foreach($listItem in $list.Items)
    {
        foreach($workflowInstance in $listItem.Workflows)
        {
        
            if($workflowInstance.InternalState -eq [Microsoft.SharePoint.Workflow.SPWorkflowState]::Cancelled)
            {
               $data=$workflowAssociation.AssociationData
               try
               {
                    $result = $manager.StartWorkflow($listItem, $workflowAssociation, $data, $True)
               }
               catch
               {
                    #Write-Host $_.Exception.ToString()
               }
               
               $cadena =   "Se inicia el WF|" + $web.Url + "|" + $listItem.ID.ToString() + "|" + $listItem.Title + "|" + $workflowInstance.InternalState
               
               Write-Host $cadena 
            }  
        }
    } 
}

Como comente antes, en la línea marcada obtenía este mensaje de error. El error estaba en que debido al proceso de ~~prueba y error~~ desarrollo iterativo, el tipo de contenido tenía más de una versión del flujo de trabajo asociado, por lo que al intentar recuperar una referencia al objeto WorkflowAssociation, no se recuperaba precisamente la más “reciente” o actual. El truco está en que las versiones viejas del flujo de trabajo, además de ser establecidas con el atributo “No New Instances”, siempre son renombradas de la forma: “NombreDeMiWorkflow (fecha)”, excepto para la Asociación más reciente (la correcta).

Por lo que, para evitar este error, se debe validar que la propiedad Name del objeto WorkflowAssociation, sea exactamente como la establecimos en un principio, sin fechas (o algún otro texto adicional).

$swapWorkflowAssociation = $Ct.WorkflowAssociations[0]

Para concluir, el código corregido

cls
Start-SPAssignment –Global
#Add-PSSnapin microsoft.sharepoint.powershell
$siteUrl="http://sp2010/mysite"

$site = Get-SPSite -Identity $siteUrl

foreach($web in $site.AllWebs)
{
    $list=$web.Lists["List"]
    $manager=$site.WorkFlowManager
   
    foreach($ct in $list.ContentTypes)
    {
        if($ct.Name -eq "MyContentType")
        {
            foreach($swapWorkflowAssociation in $Ct.WorkflowAssociations)
            {
                if($swapWorkflowAssociation.Name -eq "MyWorkflowName") 
                {
                    $workflowAssociation = $swapWorkflowAssociation
                }
                
            }
        }
    }
   
   #Si la referencia al objeto WorkflowAssociation es null, no intentamos iniciar el WF
   if($swapWorkflowAssociation -eq $null) { continue } 
   
    foreach($listItem in $list.Items)
    {
        foreach($workflowInstance in $listItem.Workflows)
        {
        
            if($workflowInstance.InternalState -eq [Microsoft.SharePoint.Workflow.SPWorkflowState]::Cancelled)
            {
               $data=$workflowAssociation.AssociationData
               try
               {
                    $result = $manager.StartWorkflow($listItem, $workflowAssociation, $data, $True)
               }
               catch
               {
                    #Write-Host $_.Exception.ToString()
               }
               
               $cadena =   "Se inicia el WF|" + $web.Url + "|" + $listItem.ID.ToString() + "|" + $listItem.Title + "|" + $workflowInstance.InternalState
               
               Write-Host $cadena 
            }  
        }
    } 
}

Happy Coding!

Extraer archivos WSP instalados en una granja SharePoint

2012-10-12T18:11:00.000-07:00

Hace unos días mientras me encontraba en medio de una migracion de SharePoint 2007 a SharePoint 2010, me vi en la necesidad de descargar un par de soluciones personalizadas (archivos WSP) de la granja de SharePoint 2007 ya que no había código fuente de esas soluciones y se tenían que hacer ajustes para que funcionaran de manera adecuada.

Después de buscar un par de minutos me encontré con esta utilidad que pueden descargar desde MSDN, me refiero al SharePoint Farm Solution Extractor, funciona bastante bien y es muy fácil de usar.

Ademas también encontré en este foro de Microsoft, que otra forma practica de hacerlo es utilizando PowerShell, sin embargo para mi no era muy practico ya que el servidor no tenia instalado PowerShell :(

[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint")
$farm = [Microsoft.SharePoint.Administration.SPFarm]::Local
$farm.Solutions | % { 
  $filename = ($pwd.ToString() + "\" + $_.SolutionFile.Name); 
  write-host ("Saving" + $filename); 
  $_.SolutionFile.SaveAs($filename) 
}

Por ultimo, también les comparto un ejemplo de como guardar todos los archivos WSP's de una granja SharePoint 2010 en un directorio que indiquen utilizando PowerShell

cls
#path en donde se guardaran los archivos WSP's, este path debe existir antes de ejecutar el script
$path="c:\wsps\"
$farm = Get-SPFarm
foreach($item in $farm.Solutions)
{
 $file = $item.SolutionFile
 Write-Host "Guardando el archivo" $file.Name
 $file.SaveAs($path+$file.Name)
}

Happy Coding!

SharePoint 2013 - SQL Server instance does not have the required "max degree of parallelism"

2012-09-06T19:00:00.001-07:00

No sé ustedes pero yo personalmente aún ahora, probando el preview de SharePoint 2013, cruzo los dedos cada vez que el wizard de configuración se encuentra en el paso "Creating the configuration database…"

Precisamente el error del que hablaremos el día de hoy, ocurre al momento de estar creando la base de datos de configuración de nuestra flamante granja de SharePoint 2013:

Failed to create the configuration database.

This SQL Server instance does not have the required "max degree of parallelism" setting of 1. Database provisioning operations will continue to fail if "max degree of parallelism" is not set 1 or the current account does not have permissions to change the setting. See documentation for details on manually changing the setting.

Lo único rescatable de este escenario de error es que si te llega a ocurrir, es porque casi seguramente estas usando la filosofía de mínimos privilegios o least-privileges, es decir la cuenta con la que estas instalando SharePoint 2013 solo tiene los roles dbcreator y securityadmin de base de datos, lo cual es muy bueno pero insuficiente para modificar el setting “max degree of parallelism” por el cual ocurre el error. De hecho si lees bien el mensaje de error, si la cuenta que será usada como Farm Administrator tuviera permisos de modificar el setting, lo hubiera hecho.

Ahora bien, después de la sección de reflexiones, como se resuelve este inconveniente?

Primero le llamas al amigo DBA, o consigues una cuenta administradora de la base de datos. Para modificar el “max degree of parallelism” puedes ocupar cualquiera de las siguientes dos opciones:

Utilizando la UI
1. Abrir Microsoft SQL Server Management Studio
2. Conectarse a la instancia en la que se intenta crear la granja de SharePoint, con la cuenta administradora
3. Hacer click en Properties sobre el nombre de la instancia, aparecerá un cuadro de dialogo
4. Modificar a 1 el valor del elemento Max Degree of Parallelism

Utilizando el stored procedure sp_configure
Ejecuta las siguientes instrucciones en una ventana de query

sp_configure 'show advanced options', 1; 
GO
RECONFIGURE WITH OVERRIDE; 
GO
sp_configure 'max degree of parallelism', 1; 
GO
RECONFIGURE WITH OVERRIDE; 
GO

Después de ejecutar cualquiera de estas dos soluciones no olvides borrar la base de datos SharePoint_Config, que se creó en el intento fallido de creación de la granja. Por último vuelve a ejecutar el wizard para la configuración de la granja de SharePoint 2013

Y bueno, mientras ven como avanza el wizard, no estaría demás que leyeran las siguientes referencias:

Install and Configure SharePoint 2013 preview
Deployment guide for Microsoft SharePoint 2013 preview
General guidelines to use to configure the MAXDOP option
The ins and outs of MAXDOP

Happy Configuring!

Creando custom workflow activities para SharePoint 2010

2012-08-12T20:43:00.000-07:00

Una de las mejores prácticas a la hora de crear flujos de trabajo (no solo para SharePoint) es encapsular funcionalidad común o reutilizable en actividades personalizadas, esto nos permitirá hacer flujos de trabajo mucho más mantenibles, disminuyendo así la cantidad de código que escribimos dentro del “code behind”, y es que al menos en mi muy humilde opinión, el código que escribimos debería ser mínimo y para casos muy específicos.

Además de todas las ventajas que implica el uso de actividades personalizadas, es bastante sencillo crearlas, a continuación explicaré el paso a paso de cómo crear una actividad que nos permita la creación de sub-sitios.

Pensemos en el siguiente escenario: El administrador de un sitio recibe muchas peticiones para generar sub sitios dentro del sitio que él administra, esta aburrido de hacer está tarea tan repetitiva, él lo que desea es salir temprano de la oficina y darle duro al ~~PS3~~ Xbox 360, por lo que se le ocurre automatizar el proceso de solicitud de creación de sitios mediante una lista en la cual los solicitantes puedan ingresar la información fundamental para la creación del sitio y una justificación de porque lo necesitan, de esta manera el administrador solo recibe un mail de que tiene una tarea pendiente, entra a revisar la tarea y la aprueba (si es el caso) y automágicamente el sitio se provisiona, cool no!?. Pues entonces comencemos a darle forma a los sueños de este administrador ficticio.

Primero creamos una solución de tipo de Sequential Workflow que nos servirá para probar la actividad personalizada que crearemos, después creamos un proyecto de tipo Workflow Activity Library que será en donde crearemos las actividades de workflow personalizadas.

Acto seguido agregamos una clase con el nombre que tendrá la actividad personalizada, en este caso CreateNewSubSite, y heredamos de la clase base Activity.

Creamos las propiedades que tendrán la información necesaria para crear el sub sitio: SiteName, SiteUrl, SiteLCID, TemplateName, SiteDescription, UseUniquePermissions y una propiedad para almacenar el contexto de ejecución del workflow. Lo primero que debemos notar es que las propiedades que creamos son dependency properties (propiedades de dependencia), esto para permitir a cualquiera que use nuestra actividad poder enlazar (Binding) estas propiedades para que en tiempo de ejecución los valores se calculen. Si aún no sabes que es o para que se utilizan las property dependencies, lee esto.

public static readonly DependencyProperty SiteNameProperty = DependencyProperty.Register("SiteName", typeof(string), typeof(CreateNewSubSite));
public static readonly DependencyProperty SiteUrlProperty = DependencyProperty.Register("SiteUrl", typeof(string), typeof(CreateNewSubSite));
public static readonly DependencyProperty SiteLCIDProperty = DependencyProperty.Register("SiteLCID", typeof(uint), typeof(CreateNewSubSite), new PropertyMetadata((uint)1033));
public static readonly DependencyProperty TemplateNameProperty = DependencyProperty.Register("TemplateName", typeof(string), typeof(CreateNewSubSite), new PropertyMetadata("STS#1"));
public static readonly DependencyProperty SiteDescriptionProperty = DependencyProperty.Register("SiteDescription", typeof(string), typeof(CreateNewSubSite));
public static readonly DependencyProperty UseUniquePermissionsProperty = DependencyProperty.Register("UseUniquePermissions", typeof(bool), typeof(CreateNewSubSite));

public static DependencyProperty __ContextProperty = System.Workflow.ComponentModel.DependencyProperty.Register("__Context", typeof(Microsoft.SharePoint.WorkflowActions.WorkflowContext), typeof(CreateNewSubSite));

[Description("The name of the new subsite")]
public string SiteName
{
 get { return (string)GetValue(SiteNameProperty); }
 set { SetValue(SiteNameProperty, value); }
}

[Description("Relative Url of the new subsite. You should consider that any space will be codified, for example MySite=MySite, Financial Area=Financial%20Area")]
public string SiteUrl
{
 get { return (string)GetValue(SiteUrlProperty); }
 set { SetValue(SiteUrlProperty, value); }
}

[Description("Specify the LCID of the language that will be used to create the subsite. Example: English=1033, Spanish=3082. For more reference you can see http://technet.microsoft.com/en-us/library/ff463597.aspx")]
public uint SiteLCID
{
 get { return (uint)GetValue(SiteLCIDProperty); }
 set { SetValue(SiteLCIDProperty, value); }
}

[Description("Specify the template name that will be used to create the subsite. Example: GLOBAL#0 = Global template, STS#0 = Team Site, STS#1 = Blank Site.")]
public string TemplateName
{
 get { return (string)GetValue(TemplateNameProperty); }
 set { SetValue(TemplateNameProperty, value); }
}

[Description("Specify the description of the new subsite")]
public string SiteDescription
{
 get { return (string)GetValue(SiteDescriptionProperty); }
 set { SetValue(SiteDescriptionProperty, value); }
}

[Description("Specify if the site will have unique permissions")]
public bool UseUniquePermissions
{
 get { return (bool)GetValue(UseUniquePermissionsProperty); }
 set { SetValue(UseUniquePermissionsProperty, value); }
}

public WorkflowContext __Context
{
 get { return (WorkflowContext)GetValue(__ContextProperty); }
 set { SetValue(__ContextProperty, value); }
}

La parte medular para la creación de nuestra actividad personalizada es sobreescribir el método Execute, el cual contiene el código principal a ejecutar por la actividad personalizada. En este ejemplo tomamos los valores de las propiedades para crear el sub sitio, no sin antes ejecutar algunas validaciones.

protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)
{
 SPSecurity.RunWithElevatedPrivileges(() =>
  {
   using (SPSite site= new SPSite (__Context.Site.ID))
   {
    using (SPWeb web = site.AllWebs[__Context.Web.ID])
    {
     //before to add the new subsite, we need to validate some settings, remember! never trust in another dev
     //first at all, validate the LCID
     SPLanguage language = SPRegionalSettings.GlobalInstalledLanguages.Cast().FirstOrDefault(x => x.LCID == SiteLCID);
     if (language == null)
     {
      throw new ArgumentException(string.Format("The value '{0}' for SiteLCID is not supported, are you sure corresponding language pack is already installed?", this.SiteLCID));
     }
     
     //then validate the name of site template
     SPWebTemplate webTemplate = site.GetWebTemplates(this.SiteLCID).Cast().FirstOrDefault(x => x.Name == this.TemplateName);
     if (webTemplate == null)
     {
      throw new ArgumentException(string.Format("The specified TemplateName='{0}' is not supported for specified language='{1}'", this.TemplateName, language.DisplayName));
     }

     //then validate the SiteUrl is unique
     if (web.Webs.Names.Contains(SiteUrl))
     {
      throw new ArgumentException("The SiteUrl is not unique, there is another subsite with the same SiteUrl");
     }

     web.Webs.Add(SiteUrl, SiteName, SiteDescription, SiteLCID, webTemplate, UseUniquePermissions, false);
    }
   }
  }
 );

 return ActivityExecutionStatus.Closed;
}

Así de simple ya tenemos una actividad personalizada lista para ser utilizada. Para este ejemplo agregamos el proyecto del workflow (WorkfllowDemo) y el proyecto de las actividades personalizadas (CustomActivities) en la misma solución, por lo que al compilar la solución automáticamente la actividad que creamos aparece en el toolbox.

Aunque también se puede solo agregar la referencia a la dll que contiene las actividades utilizando la ventana de diálogos para agregar elementos al Toolbox, para poder utilizar las actividades sin necesidad del código fuente.

El paso siguiente es arrastrar la actividad CreateNewSubSite al diseñador de workflows y configurar sus propiedades con la información para crear el subsitio.

Como se aprecia en la imagen anterior, agregamos solo una actividad más para escribir en la lista de Workflow History que el sitio fue creado correctamente. Ahora hablemos un poco a cerca de la lista que utilizaremos para las solicitudes de nuevos sitios, la cual solo contiene dos columnas: SiteName y SiteUrl. Es a esta lista a la cual asociaremos el flujo de trabajo.

Configuramos el flujo para que se ejecute al crear un nuevo elemento en la lista y podremos ver como se crea el sitio automáticamente, además del mensaje en el historial del flujo de trabajo

Les comparto el código y si tienen algún comentario o pregunta no duden en hacerla

Happy coding!