Blog de David Alonso. Microsoft SharePoint, Office 365, Azure y otras tecnologías Microsoft

Personalizar Formularios de SharePoint con PowerApps (I)

2020-04-16T09:08:00.001-07:00

¿Cómo personalizar Formularios de una lista de SharePoint con PowerApps?

¿Qué es PowerApps?

Power Apps es un nuevo servicio incluido dentro de Office 365 que permite que cualquier usuario con conocimientos de Office pueda crear aplicaciones de negocio sin conocimientos de programación.

El objetivo de las PowerApps es dotar de autonomía a los empleados de las empresas a la hora de crear aplicaciones de procesos de negocio. Éstas aplicaciones se pueden ejecutar tanto en el navegador como en dispositivos móviles.

Para más información sobre Power Apps hacer clic aquí.

¿Personalizar un formulario de lista de SharePoint?

Mediante PowerApps, se puede personalizar un formulario de una lista de SharePoint. Para ello vamos a ver un ejemplo.

Lo primero que se va a realizar es crear una lista llamada Clientes. Esta lista tendrá las siguientes columnas:

Nombre: Columna de tipo texto.
Dirección: Columna de varias líneas de texto.
Teléfono: Columna de tipo texto
CIF: Columna de tipo texto
Logo: Columna de tipo Imagen

A continuación, desde la lista hacer clic en PowerApps en el menú superior.

Y elegir la opción Personalizar formularios.

Se abre la aplicación PowerApps en el navegador.

¿Modificar el orden de los campos del formulario?

Para modificar el orden de los campos del formulario hay que seleccionar SharePointForm1 en la vista de árbol y a continuación hacer clic en Editar Campos en la parte de la derecha de la ventana. La siguiente captura muestra estos dos puntos.

Al hacer clic en Editar Campos, aparece el menú contextual de los Campos, desde donde se puede seleccionar uno a uno y subir y bajar el orden del campo. En el ejemplo, subiremos la Imagen del logo a la parte superior.

Además, se permite que en el formulario pueda verse la imagen y no el texto de la url seleccionando Tipo de control: Ver imagen.

Otra cosa que vamos a hacer en este mismo bloque de campos es eliminar los datos adjuntos. Al igual que se hace para subir y bajar un campo, tenemos la opción Quitar.

¿Guardar y ver el formulario?

Para guardar el formulario hay que hacer clic en la pestaña Archivo > Guardar.
Una vez guardado es necesario Publicar en SharePoint.

Entramos a la lista y creamos un elemento nuevo.

Podremos ver el formulario creado.

En próximos post veremos más opciones a realizar con los formularios y PowerApps.

Cómo firmar un PDF con iText Sharp

2020-03-08T04:18:00.000-07:00

Firmar un pdf en C# con iTextSharp

¿Qué es iText Sharp?

iText Sharp es una adaptación a código CV# de la biblioteca iText, que se trata de una biblioteca Open Source para crear y manipular archivos PDF, RTF, y HTML en Java.

¿Qué significa firmar un documento pdf?

Firmar electrónicamente un documento, significa asociar al documento una serie de datos cuyo objetivo es identificar al firmante de manera inequívoca.

Además, asegura la integridad del documento, es decir el documento que se ha firmado es exactamente el mismo que el original por lo que no ha sufrido ninguna modificación.

Para más información sobre la firma electrónica, puede acceder al portal de administración electrónica haciendo clic en el siguiente enlace.

Firmar documento pdf programáticamente con c#

A continuación adjunto el código fuente para firmar el documento pdf con C#. Lo primero que habría que hacer es añadir con Nugget la librería iText.


 public static void FirmaPDF(string unsignedDocument, string signedDocument,
                                        int x, int y, int width, int height,
                                        string certFileNamePath,
                                        int pageToSign , string password)
    {
      FileStream certificado = new FileStream(certFileNamePath, FileMode.Open);
      Org.BouncyCastle.Pkcs.Pkcs12Store store = new Org.BouncyCastle.Pkcs.Pkcs12Store(certi, ((String)password).ToCharArray());
      String alias = "";
      System.Collections.Generic.ICollection chain = new System.Collections.Generic.List();
      // searching for private key   
      foreach (string al in store.Aliases)
        if (store.IsKeyEntry(al) && store.GetKey(al).Key.IsPrivate)
        {
          alias = al;
          break;
        }
      Org.BouncyCastle.Pkcs.AsymmetricKeyEntry pk = store.GetKey(alias);
      foreach (Org.BouncyCastle.Pkcs.X509CertificateEntry c in store.GetCertificateChain(alias))
        chain.Add(c.Certificate);
      Org.BouncyCastle.Crypto.Parameters.RsaPrivateCrtKeyParameters parameters = pk.Key as Org.BouncyCastle.Crypto.Parameters.RsaPrivateCrtKeyParameters;
      iTextSharp.text.pdf.PdfReader reader = new iTextSharp.text.pdf.PdfReader(unsignedDocument);
      FileStream os = new FileStream(signedDocument, FileMode.Create);
      iTextSharp.text.pdf.PdfStamper stamper = iTextSharp.text.pdf.PdfStamper.CreateSignature(reader, os, '\0',null, true);      

      // Creating the appearance
      iTextSharp.text.pdf.PdfSignatureAppearance appearance = stamper.SignatureAppearance;
      iTextSharp.text.Font font = new iTextSharp.text.Font(iTextSharp.text.Font.FontFamily.TIMES_ROMAN, 8, iTextSharp.text.Font.ITALIC, iTextSharp.text.BaseColor.BLACK);
      appearance.Layer2Font = font;
      appearance.SignatureRenderingMode = iTextSharp.text.pdf.PdfSignatureAppearance.RenderingMode.DESCRIPTION;
      appearance.SetVisibleSignature(new iTextSharp.text.Rectangle(x, y, width, height), 1, "sig");
      appearance.Layer2Text = "Firmado digitalmente:" + DateTime.Now.ToString("dd/MM/yyyy HH:mm:ss");
      // Creating the signature
      iTextSharp.text.pdf.security.IExternalSignature pks = new iTextSharp.text.pdf.security.PrivateKeySignature(parameters, iTextSharp.text.pdf.security.DigestAlgorithms.SHA256);
      iTextSharp.text.pdf.security.MakeSignature.SignDetached(appearance, pks, chain, null, null, null, 0, iTextSharp.text.pdf.security.CryptoStandard.CMS);

      certificado.Close();     
    }

NOTAS:

En la siguiente función, además de firmar, se adjunta en una posición del documento (concretamente en la página que se envía como parámetro pageToSign) un cuadro con texto. El bloque que añade este texto es el comentado como "Creating the appearance". El cuadro de texto tendrá las posiciones, ancho y alto que recibe como parámetros de la función. También se podría añadir una imagen, o texto propio del certificado sin modificar la Layer.
Se utilizan dos rutas de fichero. Signeddocument será la ruta donde está el fichero a firmar y
Si se quiere permitir más de una firma en el documento, hay que fijarse en la siguiente línea:


iTextSharp.text.pdf.PdfStamper stamper = iTextSharp.text.pdf.PdfStamper.CreateSignature(reader, os, '\0',null, true);

En ella, el último parámetro a true permite adjuntar más de una firma en el documento. En caso contrario, cuando se añada una nueva firma, se invalidará la primera.

Habilitar Uso Compartido Externo en SharePoint Online Programáticamente

2020-03-03T08:42:00.003-08:00

Cómo habilitar Uso Compartido Externo en una colección de sitios de SharePoint Online

¿Que es el Uso Compartido?

SharePoint Online permite compartir el contenido de una colección de sitios con personas de fuera de la organización como pueden ser clientes o proveedores. Para habilitar el uso compartido de una colección de sitios, hay que hacer lo siguiente:

Desde la página de Sitios activos del panel de administración de SharePoint moderno, hacer clic en el sitio (colección de sitios) para el que se desea activar el uso compartido.
Seleccione el sitio.
Hacer clic en uso compartido en el menú superior.
A continuación aparecen las siguientes opciones:

Más información sobre el uso compartido aquí.

Habilitar uso compartido externo programáticamente

Las mismas opciones que hemos visto en el apartado anterior, pueden realizarse mediante código fuente C#. Por ejemplo, desde una Azure Function se podría modificar el uso compartido mediante código c#. Si no conocéis que es una Azure Function, dejo aquí un post de como crear una desde cero.

A continuación os dejo una función para modificar el uso compartido externo:

      
public static void ConfigureExternalSharing(string site, string userSp , string passwordUserSP)
        {            
                ClientContext ccTenant = new AuthenticationManager().GetSharePointOnlineAuthenticatedContextTenant("https://dalonsoblog.sharepoint.com/",userSP, ConvertStringToSecureString(passwordUserSP));
                var _tenantAdmin = new Tenant(ccTenant);
                SiteProperties _siteprops = _tenantAdmin.GetSitePropertiesByUrl(site, true);
                ccTenant.Load(_tenantAdmin);
                ccTenant.Load(_siteprops);
                ccTenant.ExecuteQuery();
                _siteprops.SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing;
                _siteprops.Update();
                ccTenant.ExecuteQuery();
                ccTenant.Dispose();           
        }

La línea importante es:

   _siteprops.SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing;

Donde ConvertStringToSecureString es una función que he implementado para convertir la password de un string a un SecureString.

   
private static SecureString ConvertStringToSecureString(string s)
        {
            var secure = new SecureString();
            for (int i = 0; i < s.Length; i++)
            {
                secure.AppendChar(s[i]);
            }
            return secure;
        }

Las opciones que se pueden indicar en la propiedad SharingCapability son:
https://docs.microsoft.com/en-us/previous-versions/office/sharepoint-csom/dn174825(v%3Doffice.15)

SharingCapabilities.Disabled
SharingCapabilities.ExternalUserSharingOnly
SharingCapabilities.ExternalUserAndGuestSharing SharingCapabilities.ExistingExternalUserSharingOnly

Crear un evento en el calendario con Graph desde un web part SPFX. MSGraphClient

2020-02-27T01:27:00.000-08:00

Crear un evento de calendario con MS Graph

Lo primero que vamos a hacer es crear el web part, para ello, como siempre:

Abre una ventana de comandos y sitúate en la carpeta donde quieras generar el web part.

Ejecuta yeoman para generar el web part de sharepoint

yo @microsoft/sharepoint

Continúa el asistente de SharePoint

What is your solution name?: EventosGraphSPFx
Which baseline packages do you want to target for your component(s)?: SharePoint Online only (latest)
Where do you want to place the files?: Use the current folder
Do you want to allow the tenant admin the choice of being able to deploy the solution to all sites immediately without running any feature deployment or adding apps in sites?: No
Will the components in the solution require permissions to access web APIs that are unique and not shared with other components in the tenant?: No
Which type of client-side component to create?: WebPart
What is your Web part name?: EventosGraphSPFx
What is your Web part description?: EventosGraphSPFx Descripción.
Which framework would you like to use?: React

Cuando se complete el asistente de creación del web part, vamos a instalar los siguientes modulos:

npm install @microsoft/microsoft-graph-types --save-dev

A continuación, empezamos a modificar el codigo Fuente. El primer paso es añadir las siguientes dependencias al fichero .ts que nos ha generado el web part:

import { MSGraphClient } from '@microsoft/sp-http';

import * as MicrosoftGraph from '@microsoft/microsoft-graph-types';

Hay que modificar la function render que nos ha dado por defecto, en su lugar la dejaremos así:

this.context.msGraphClientFactory.getClient()

.then((client: MSGraphClient): void => {

const element: React.ReactElement<IEventosGraphProps> = React.createElement(

EventosGraph,

{

graphClient: client

}

);

ReactDom.render(element, this.domElement);

});

Como se puede apreciar, le estamos pasando al componente de react una propiedad llamada graphClient, por lo tanto debemos incluirla en el interfaz de propiedades IEventosGraphProps

import { MSGraphClient } from '@microsoft/sp-http';

export interface IEventosGraphProps {

graphClient: MSGraphClient;

}

NOTA: para añadir un MSGraphClient hay que hacer un import:

import { MSGraphClient } from '@microsoft/sp-http';

A continuación pasamos a modificar el codigo del fichero .tsx correspondiente al componente react que se mostrará en el web part.

En este caso, lo que voy a hacer es simplemente incluir un botón que cuando haga clic, introduzca un evento en el calendario del usuario conectado. Evidentemente podríamos modificar el formulario para que el evento se genere en función de unas fechas seleccionadas.

La función render quedará entonces así:

public render(): React.ReactElement {

return (

); }

Como estoy incluyendo un botón de ui fabric, recordad que hay que añadir un import:

import { DefaultButton, PrimaryButton, Stack, IStackTokens } from 'office-ui-fabric-react';

Como vamos a utilizar MSGraphClient desde el fichero tsx, también tenemos que hacer un import a éste modulo:

import * as MicrosoftGraph from '@microsoft/microsoft-graph-types';

Por último, en el render puede verse que el clic del botón lanza una función llamada alertClicked. El código de esta función es el siguiente:

public _alertClicked(): void {

const event : MicrosoftGraph.Event = {

subject: "Evento desde SPFX creado",

body: {

content: "Hemos creado un evento desde un web part SPFX”

start: {

dateTime: "2019-11-15T12:00:00",

timeZone: "Romance Standard Time"

end: {

dateTime: "2019-11-15T14:00:00",

timeZone: "Romance Standard Time"

location:{

displayName:"Lugar preferido de David?"

attendees: [

{

emailAddress: {

address:"david@mysite.onmicrosoft.com",

name: "David Alonso"

type: "required"

}

]

};

this.props.graphClient

.api('https://graph.microsoft.com/v1.0/me/calendar/events')

.post(event, (err, res) = > {

alert(res);

})

}

NOTA: para poder utilizar en la función el this, hay que bindearla.

NOTA2. En el evento que creo estoy metiendo como asistentes a David Alonso. Puedes generar el evento sin asistentes.

Hasta aquí tenemos el codigo para poder generar un evento desde SPFX, pero lo importante ahora es que este componente spfx tenga permisos de Graph para insertar el evento. Para ello es necesario añadir en el fichero config\package-solution.json las siguientes líneas

"webApiPermissionRequests": [

{

"resource": "Microsoft Graph",

"scope": "Calendars.ReadWrite"

}

]

Quedando ese fichero de la siguiente forma:

{

"$schema": "https://developer.microsoft.com/json-schemas/spfx-build/package-solution.schema.json",

"solution": {

"name": "graphemail-client-side-solution",

"id": "7d871ed2-27a7-474c-b468-a838f043703c",

"version": "1.0.0.1",

"includeClientSideAssets": true,

"isDomainIsolated": false,

"webApiPermissionRequests": [

{

"resource": "Microsoft Graph",

"scope": "Calendars.ReadWrite"

}

]

"paths": {

"zippedPackage": "solution/graphemail.sppkg"

}

NOTA: Fijaros que le he subido un 1 a la versión ;)

A continuación procedemos a desplegar la solución ejecutando los siguientes comandos.

gulp bundle --ship

gulp package-solution --ship

Buscamos el archive de la solucion y lo desplegamos en el catálogo de aplicaciones de SharePoint.

Ahora solo nos queda aprobar los permisos solicitados. Para ello desde el panel de Administración de SharePoint, buscar Administración de Api

Debería de aparecer como pendiente los permisos seleccionados desde el SPFX. Tendremos que aprobarlos y con esto el web part está listo para probar en una página moderna de SharePoint Online.

En otro post mostraré como visualizar los eventos introducidos en un web part.

Actualizar elemento de una lista con PNP Powershell

2020-02-26T02:56:00.000-08:00

Actualizar elementos de una lista de SharePoint Online con Powershell

PNP Powershell

Pnp (Pattern & Practices) se trata una comunidad de desarrollo de SharePoint de código abierto coordinada por el equipo de ingeniería de SharePoint. Esta iniciativa contiene una biblioteca de comandos de PowerShell llamada PnP de PowerShell, que permite realizar acciones dentro de SharePoint.

Dejo aquí un enlace a los Cmdlets de PnP Powershell.

Comando para actualizar elemento de una lista

Mediante los comandos PNP Powershell, vamos a actualizar columnas de elementos de una lista.

El comando que vamos a utilizar es SetPnpListItem.

Set-PnPListItem -List -Identity [-ContentType ] [-Values ] [-SystemUpdate []] [-Web ] [-Connection ]

Donde es el nombre de la lista y es el id del elemento de la lista que se quiere actualizar.

Ejemplos

Veamos algunos ejemplos:

A continuación vamos a actualizar el elemento con ID 1 de la lista Documentos. Las columna que se van a actualizar es "Titulo" por el valor "Titulo actualizado"

Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"Titulo" = "Titulo actualizado"}

Se puede añadir más de una columna en el mismo comando. Por ejemplo, actualizar la columna Titulo como en el caso anterior y la columna Categoría. Lo que hay que hacer es separar con ; los valores.

Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"Titulo" = "Titulo actualizado"; "Categoria" = "Categoria actualizada"}

En estos ejemplos, se ha actualizado una columna de tipo texto. Una columna de tipo elección o multitexto sería igual, pero para una columna lookup habría que indicar el ID del elemento de la lista lookup a la que apunta.

Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"Lookup" = "1"}

Para una columna de tipo Si/No .

Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"ColumnaSiNo" = $false}

Por último, una columna de tipo Usuario o grupo permite indicar el id del usuario/grupo o el email. Además permite indicar mas de uno en caso de que la columna esté indicada como "permite mas de un usuario".

Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"Usuarios" = "david@dalonsoblog.onmicrosoft.com","21"}

Acordarse que para lanzar estos comandos es necesario conectarse al sitio, para ello ejecutar el comando

Connect-PnpOnline "https://dalonsoblog.sharepoint.com"

Como crear un command set SPFx con un panel react en una librería de documentos

2020-02-22T05:43:00.000-08:00

Como crear una extensión SPFX en SharePoint Online

¿Qué es una Extensión SPFX?

Una extensión de SharePoint, permite ampliar la funcionalidad propia de SharePoint Online en las páginas Modernas. Con las extensiones se permite crear:

Personalizadores de aplicaciones. Permite agregar scripts a la página, así como tener acceso a marcadores de posición de elementos HTML conocidos y ampliarlos con representaciones personalizadas.

Personalizadores de campo. Puede usarse para proporcionar vistas modificadas de los datos para los campos de una lista.

Conjuntos de comandos. Extiende las superficies de comando de SharePoint para agregar nuevas acciones y proporciona código del lado cliente que puede utilizar para implementar comportamientos.

Para ver más información sobre las extensiones SPFX haz clic aquí.

Tutorial para tu primera Extensión SPFX

A continuación vamos a mostrar los pasos para generar un command set en SharePoint con SPFx que al hacer clic, abra un panel react. En el ejemplo mostraremos dentro del panel algún metadato del documento.
Lo primero que hay que hacer es abrir la ventana de comandos cmd y crear el command set con el comand yeoman:

yo @microsoft/sharepoint

A continuación, hay que ir rellenando los pasos del asistente yeoman para la creación del command set:

Indicar un nombre para el command-extension y presionar Entrar.

Seleccionar Solo SharePoint Online (más reciente) y presione Entrar.

Elegir Usar la carpeta actual y presione Entrar. Es por ello por lo que en el primer paso se debería de crear una carpeta y situarse en ella antes de lanzar el asistente yeoman.

Seleccionar Y para permitir que la solución se implemente en todos los sitios inmediatamente. En este caso, el command set podrá ser visible en todos los sitios del tenant. Si se desea que el command set solo esté visible en los sitios que lo agreguemos bajo demanda, indicar N.

Seleccionar N en la pregunta si la solución contiene permisos exclusivos.

Seleccionar Extensión como tipo de componente del lado cliente que se va a crear.

Seleccionar ListView Command Set como tipo de extensión que se va a crear.

A continuación, comenzará el proceso de creación del command set. Este proceso tarda unos minutos, hay que tener paciencia.

Nuestro Command Set aparecerá en la barra de menú de la biblioteca de documentos cuando seleccionemos un documento y el objetivo es abrir un panel lateral con información del documento.
Lo primero que vamos a hacer es crear un componente react para mostrar el panel.
Dentro de la carpeta src\extensions\nombredelcmmandset, creamos otra carpeta llamada components, y dentro de ella creamos un nuevo archivo PanelDocumento.tsx. En ese fichero agregamos los siguientes componentes.

import * as React from 'react';

import { Label } from 'office-ui-fabric-react/lib/Label';

import { TextField, DefaultButton, PrimaryButton, DialogFooter, autobind, Panel, Spinner, SpinnerType,Dialog } from "office-ui-fabric-react";

import { getId } from 'office-ui-fabric-react/lib/Utilities';

import { MessageBar, MessageBarType } from 'office-ui-fabric-react/lib/MessageBar';

import { Promise } from 'es6-promise';

import { Checkbox } from 'office-ui-fabric-react/lib/Checkbox';

import { PageContext } from '@microsoft/sp-page-context';

import { ContextualMenu } from 'office-ui-fabric-react/lib/ContextualMenu';

import { hiddenContentStyle, mergeStyles } from 'office-ui-fabric-react/lib/Styling';

import { HttpClient, SPHttpClient, HttpClientConfiguration, HttpClientResponse, ODataVersion, IHttpClientConfiguration, IHttpClientOptions, ISPHttpClientOptions } from '@microsoft/sp-http';

const screenReaderOnly = mergeStyles(hiddenContentStyle);

En el mismo .tsx creamos el state del componente.

export interface IPanelState

{

saving: boolean;

delayResults?: boolean;

hideDialog: boolean;

sending: boolean

}

y sus propiedades, donde nos llegaran los datos del documento que vamos a mostrar en el panel.

export interface IPanelProps {

onClose: () => void;

isOpen: boolean;

currentTitle: string;

listId: string;

spPageContext : PageContext;

propHttpClient : HttpClient;

}

En el render, pintaremos un Panel y las Label necesarias para mostrar los datos así como un botón Cancelar para cerrar el Panel.

public render(): React.ReactElement<IContabilizarPanelProps> {

let { isOpen, currentTitle } = this.props;

return (

<div>

<Label><b>Nombre Documento:</b> {this.props.currentTitle}</Label>

<Label><b>ID Lista Firma:</b> {this.props. listId }</Label>

</DialogFooter>

</Panel>

</div>

);

}

Además, añadimos el método onCancel y otros métodos necesarios:

private _onCancel() {

this.props.onClose();

}

private _showDialog = (): void => {

this.setState({ hideDialog: false });

};

private _closeDialog = (): void => {

this.setState({ hideDialog: true });

};

Volvemos al commandset, para ello en la carpeta src\extensions\nombrecommandset, localizar el archivo CommandSet.tsEste archivo ejecuta la acción del clic del commandset y lo que queremos es que nos abra un Panel lateral con los datos del documento sobre el que hemos hecho clic.
Para ello, dentro de la clase que se define vamos a incluir un control HTMLdivElement:

private panelPlaceHolder: HTMLDivElement = null;

En la función onInit vamos a meter este div HTML dentro del body de la página. Se puede incluir esta línea justo debajo del Log.info que nos genera automáticamente la extensión quedando el onInit de la siguiente forma:

this @override

public onInit(): Promise<void> {

Log.info(LOG_SOURCE, 'Initialized SpoContabilizarCommandSet');

this.panelPlaceHolder = document.body.appendChild(document.createElement("div"));

return Promise.resolve();

}

Cuando se crea un commandSet, por defecto nos da 2 botones, pero aquí nos vamos a quedar con uno. Para ello en el método onExecute, dejamos solo el case ‘COMMAND_1’ y además, en elfichero CommandSet.manifest.json , dentro de “ítems”, dejamos solamente la definición del COMMAND_1 :

"items": {

"COMMAND_1": {

"title": { "default": "Command Prueba" },

"iconImageUrl": "",

"type": "command"

}

Se puede modificar el title que será el texto que muestre la acción del menú y el icono. Para subir un icono se puede o bien indicar la ruta de un icono que tengamos en el directorio de la extensión spfx, o indicar el icono en base64.
Volvemos al método onExecute del CommandSet. Vamos a obtener el valor id y el valor del nombre del documento seleccionado, y llamaremos a una función showPanel que será la que muestre el componente react del panel

@override

public onExecute(event: IListViewCommandSetExecuteEventParameters): void {

switch (event.itemId) {

case 'COMMAND_1':

let selectedItem = event.selectedRows[0];

const docUrl = selectedItem.getValueByName("FileRef");

const listItemId = selectedItem.getValueByName('ID') as number;

this._showPanel(listItemId, docUrl);

break;

default:

throw new Error('Unknown command');

}

La función showPanel y funciones auxiliares:

private _showPanel(itemId: number, currentTitle: string)

{

this._renderPanelComponent({

isOpen: true,

currentTitle,

itemId,

listId: this.context.pageContext.list.id.toString(),

onClose: this._dismissPanel

});

}

@autobind private _dismissPanel() {

this._renderPanelComponent({ isOpen: false });

}

private _renderPanelComponent(props: any) {

const element: React.ReactElement<IPanelProps> = React.createElement(

CustomPanel, assign({

onClose: null,

currentTitle: null,

itemId: null,

isOpen: false,

listId: null,

propHttpClient: this.context.httpClient,

spPageContext: this.context.pageContext

ReactDom.render(element, this.panelPlaceHolder);

}

Con este código, ya se dispone de un CommandSet con un panel.
Para probarlo, se puede indicar la url de una librería en el archivo serve.json en la propiedad "pageUrl"

"pageUrl": "https://myurl.sharepoint.com/sites/mySite/SitePages/myPage.aspx",

Se abrirá la biblioteca de documentos y cuando haces clic en el documento, se mostrará en la barra de herramientas una nueva opción con el commandset. Al hacer clic sobre esa opción se abrirá el panel.

En futuro post explicaré como desplegar un command set para varias colecciones de sitios.

Añadir un cuadro de texto TextField en un web part React con SharePoint Framework

2019-11-12T06:13:00.000-08:00

TextField en un web part de SharePoint Framework con React

SharePoint Framework

Vamos a generar un web part y utilizar un componente TextField de Office UI fabric. Con Office fabric UI puedes aplicar simples estilos CSS a los elementos de tus aplicaciones web y hacer que obtengan automáticamente el aspecto de las aplicaciones de Office. Es algo interesante cuando desarrollamos web parts en SharePoitn Online ya que conseguimos que estos web parts, sin necesidad de tener que jugar con hojas de estilo, tengan la misma apariencia que el resto de componentes de SharePoint que se visualizan en la página. Los estilos tienen en cuenta la tipografía, los colores, los iconos, las animaciones, la distribución de elementos e incluso la localización a varios idiomas. Otra ventaja es que estos estilos se adaptan sin problema a cualquier dispositivo: escritorio, móvil, tableta...

Office UI Fabric me ayudó mucho a dar el cambio de programar para SharePoint con SPFX después de varios años como programador backend en C# y con mi poca experiencia (y poco gusto) en maquetación, css.

Este post puede ser un primer ejemplo de cómo utilizar componentes UI Fabric dentro de un web part con react ya que será un ejemplo básico. En otros post directamente trato los componentes UI Fabric como algo normal y hablo de otras cosas más avanzadas.

Doy por creado el web part con yeoman con Framework React, por loq ue paso directamente al código fuente para añadir el componente UI Fabric.

Lo primero que tenemos que hacer es un import del módulo.

import { TextField } from "office-ui-fabric-react";

Los datos que se escriban en el textfield, los iremos guardando en el state de react, para ello tendremos que añadir un campo nuevo dentro del state.

En el render, vamos a pintar el TextField. Veremos que en el onChanged del TextField, iremos guardando los valores en el state. Para ello generamos una función handleInputChange

<TextField label="Text Field Name:" id="textFieldID" onChanged={(value) => this.handleInputChange(textFieldID, value)} required={true} />

Esa función realiza lo siguiente.

public handleInputChange(id, value) {

this.setState({

textFieldValue: value

});

}

De este modo el valor del textbox lo tendremos siempre en el state de react.

Error gulp bundle: ENOENT: no such file or directory, scandir '**/node_modules/node-sass/vendor

2019-11-08T05:31:00.000-08:00

Error en SharePoint Framework

El otro día, me he descargado del repositorio de la empresa un componente SPFX y tras unos cambios, he tratado de generar los bundles con el comando

gulp bundle --ship

Me dió el siguiente error:

ENOENT: no such file or directory, scandir '**/node_modules/node-sass/vendor

Buscando por internet, encontré una solución ejecutando el siguiente comando:

npm rebuild node-sass

Espero que os sirva de ayuda.

Como Crear una Función de Azure (I)

2019-08-12T04:25:00.003-07:00

Antes de comenzar, vamos a hacer una pequeña introducción a Funciones de Azure o Azure Functions.

Una Azure Function es una solución que nos proporciona Microsoft para ejecutar un trozo de código en la nube sin necesidad de disponer de un servidor o una infraestructura para alojar ese código. Además, permite desarrollar en varios lenguajes de programación no solamente en C# o código .NET de Microsoft.

Aquí algunas características de las funciones de Azure sacadas de la documentación de Microsoft:

Opción de lenguaje: escriba funciones usando el lenguaje C#, Java, Javascript, Python u otro de su elección. Consulte Lenguajes admitidos para ver la lista completa.
Modelo de precios de pago por uso : pague solo el tiempo que haya empleado ejecutando el código.

Esta es una gran ventaja a la hora de desarrollar una solución para sus clientes puesto que se paga por uso, es decir, el plan de consumo de Azure Functions se factura en función del consumo de recursos y las ejecuciones por segundo. Los precios del plan de consumo incluyen una concesión gratuita mensual de 1 millones de solicitudes de forma que es probable que disponga de Funciones de Azure que salgan prácticamente gratis.

Utilizar sus propias dependencias : Funciones de Azure admite NuGet y NPM, para que pueda usar sus bibliotecas. De esta forma, mediante una función de Azure podremos desarrollar un componente que se integre con cualquier entorno utilizando dlls que desarrollemos nosotros mismos.
Seguridad integrada : proteja las funciones desencadenadas por HTTP con los proveedores de OAuth como Azure Active Directory, Facebook, Google, Twitter y cuenta Microsoft.
Integración simplificada : fácil aprovechamiento de los servicios de Azure y ofertas de software como servicio (SaaS).
Desarrollo flexible: codifique las funciones directamente en el portal o configure la integración continua e implemente el código mediante GitHub, Azure DevOps Services y otras herramientas de desarrollo compatibles.
Código abierto : el tiempo de ejecución de Funciones de Azure es de código abierto y está disponible en GitHub.

A continuación, vamos a ver un ejemplo de como crear una Función de Azure desde el portal web. Para comenzar, entrar en la url https:\\ portal.azure.com con un administrador global de su subscripción de Azure.

Lo primero que hay que hacer es crear el Funcion App, que es un contenedor de aplicaciones donde se alojarán las funciones de Azure. En un Function App puede alojarse más de una función diferente y dispondrá de más de una

En el menú lateral izquierdo del portal de Azure, se ofrece un vínculo a App Services. Al hacer clic en este vínculo, se accede a una página de introducción donde se visualizan las aplicaciones de servicio (App services) existentes.

En la barra de herramientas superior se dispone de una acción (botón Agregar) que permite habilitar un nuevo formulario donde se indica el tipo de Web Apps que se desea crear. En este caso se selecciona el tipo FunctionApp.

Al presionar este tipo, se habilita un nuevo formulario de confirmación haciendo clic sobre el botón Crear.

A continuación, se habilita otro formulario donde se introducen los datos de la App service que se desea crear:

Nombre de aplicación: Se indica un nombre. Para este nombre se asignará una url nombre.azurewebsites.net por lo que deberá ser un nombre indicativo y que no se vaya a usar más.
Suscripción: se selecciona la suscripción de Azure disponible.
Grupo de recursos: se mantiene el check Crear nuevo con el nombre que ofrece por defecto. Para próximas aplicaciones de servicio (app services) que se creen, puede reutilizarse seleccionando Usar existente.
OS: Windows.
Plan de hospedaje: Plan de consumo.
Ubicación: Oeste de Europa.
Pila en tiempo de ejecución: .NET.
Storage: se mantiene el check Crear nuevo con el nombre que ofrece por defecto. Para próximas aplicaciones de servicio (app services) que se creen, puede reutilizarse seleccionando Usar existente.
Application Insights: se mantiene el nombre que ofrece por defecto.

Presionando sobre el botón Crear - ubicado en la parte inferior del formulario - se crea la aplicación de servicio (App service).

Ahora Crearemos una Función de Azure y le añadiremos algo de código. Lo primero que deberemos de saber es que hay diferentes tipos de funciones de Azure. Aquí hay una entrada donde se explican los diferentes tipos de funciones de Azure.

Crearemos una Función de tipo HTTP. Esta función se ejecutará cuando entre una petición HTTP. Puede ser útil para comunicar o integrar entornos y utilizarse como una API REST.
Para ello, dentro de la Function App, en RFunctions, hacer clic en el simbolo + para crear una nueva Función de Azure.

Seleccionar WebHook + API y hacer clic en Crear.

La función ya está creada, se puede previsualizar el código que ya se crea por defecto.

Se puede ejecutar la función de Azure desde el propio portal de Azure. En la función, hay un botón de Ejecutar.

Para ejecutar la función desde el navegador, se puede obtener su url y meterla en el navegador. Para ello, hay un link Obtener url, situado justo al lado del botón de Ejecutar.

En la parte inferior de la función de Azure, hay un apartado Registros o Logs donde se pueden ver todas las lineas de log que se han introducido en el código mediante la sentencia:

log.Info("Texto a introducir en el log");

o mensajes de error:

log.Error("Mensaje de error");

De esta forma se puede controlar los errores de la función de Azure mediante try/catch y mostrar en el log el error.

Según este ejemplo, podremos ejecutar código que se ejecutara mediante una llamada HTTP, de esta forma podremos por ejemplo introducir datos en una base de datos según los parámetros recibidos en la url u obtener un listado de elementos guardados en una base de datos o una lista.

En el siguiente post sobre Funciones de Azure, crearemos una en Visual Studio para poder utilizar dlls externas y hacer algo de código mas complejo que este ejemplo.

Como crear un Mock de un servicio web SOAP con SoapUI

2019-05-23T00:57:00.000-07:00

Antes de nada, es necesario explicar que es un Mock.

Un Mock no es mas que un objeto de prueba. Se utiliza par a simular el comportamiento de un objeto, un servicio , un método ...

En el caso que vamos a explicar, trataremos de generar un mock de un servicio SOAP con el objetivo de simular las respuestas que nos devuelven cada uno de sus métodos.

Esto puede usarse con varios fines, y me he encontrado en varias ocasiones con estos casos:

El primero de ellos es para devolver la respuesta que nosotros queramos. Es decir, estamos desarrollando un componente que llama a un servicio, y queremos testear el comportamiento de nuestro componente en función de las distintas posibilidades de respuesta del servicio.
Se dispone de un servicio web publicado, pero el entorno de desarrollo se encuentra en una máquina que no tiene acceso a dicho servicio. En ese caso haríamos un mock del mismo y podríamos trabajar desde la maquina de desarrollo con el mock.
El servicio nos lo publica un cliente, un proveedor o alguien y aún lo ha terminando, o nos ha publicado una versión directamente en un entorno productivo y las pruebas pueden ocasionar inconvenientes en el entorno. Para esto es mejor, una vez dispongamos del descriptor de fichero (WSDL) final, hacer un Mock y

Para cumplir este objetivo, vamos a utilizar la herramienta SOAP UI, que se trata de una herramienta para la realización de pruebas a aplicaciones con arquitectura orientada a servicios (SOA) y servicios REST.

Cómo obtenemos el WSDL.

Si el servicio está publicado, podremos poner en Soap UI directamete la url.

Abrimos un nuevo servicio SOAP desde la parte superior de SOAP UI

En la ventana que aparece , donde se indica el WSDL hay que indicar la url:

En el caso de que nos hayan enviado el fichero WSDL, deberiamos de abrirlo en el botón Examinar (Browse).

Hacer clic en OK y nos aparecerá el servicio en la parte de la izquierda de SOAPUI

Cómo generar el Mock

Si hacemos botón derecho sobre el servicio, tenemos la opción de Generar Mock del servicio (Generate Mock Service).

La pantalla a continuación nos permite seleccionar el puerto donde publicaremos localmente el mock, los métodos que queremos que estén disponibles en el mock, y el path.

También es necesario indicar un nombre.

Para publicar el mock, hacer clic en el botón Play.

El icono de las flechas, nos abre el descriptor de fichero WSDL publicado en localhost y podemos usar esa url para incorporar al endpoint del mock en nuestro desarrollo.

Habilitar log al provisionar sitio de SharePoint Online con PNP

2018-12-12T02:00:00.001-08:00

¿Qué es PNP?

Pnp (Pattern & Practices) se trata una comunidad de desarrollo de SharePoint de código abierto coordinada por el equipo de ingeniería de SharePoint. Esta iniciativa contiene una biblioteca de comandos de PowerShell llamada PnP de PowerShell, que permite realizar acciones dentro de SharePoint.

Cuando nos disponemos a provisionar un sitio de SharePoint Online con el comando powershell Apply-PnPProvisioningTemplate, en ocasiones se producen errores y no muestra ningún mensaje indicando de donde proviene el error.

Para facilitar un poco la tarea de encontrar el problema en el xml de la plantilla, se puede habilitar un log que se muestra al provisionar. Para ello, justo antes de ejecutar el comando Apply-PnPProvisioningTemplate, hay que ejecutar este otro:
Set-PnPTraceLog -On -Level Debug

De esta forma, cuando se ejecute el provisionamiento, se mostrará por pantalla un registro de lo que Office Dev PnP Powershell esta haciendo.

Ocultar el titulo de una Pagina en SharePoint Online

2017-12-21T06:36:00.003-08:00

Hola,

hace poco un cliente me ha pedido que le oculte el titulo del sitio, dentro de la home.

Para ello y sin modificar masterpage o layout, he añadido un Script Editor en cualquier zona de la página (web part de seuencia de comados), y he introducido el siguiente bloque de código:

Espero sirva de ayuda.

Un saludo

Algunas urls de SharePoint

2017-11-21T02:53:00.003-08:00

Hola,

a veces me es útil disponer de las url de algunas páginas de SharePoint, como por ejemplo la de cambio de masterpage, dado que ésta solo aparece cuando tienes activada la característica de publicación.

Os pongo algunas, acordaros que hay que poner despues del /_layouts/, /15/16 en funcion de la version de SharePoint (2013, 2016).

Página cambio de masterpage: /_layouts/15/ChangeSiteMasterPage.aspx
Página seleccion página de bienvenida: /_layouts/15/AreaWelcomePage.aspx
Biblioteca de de páginas maestas: /_catalogs/masterpage/Forms/AllItems.aspx
Contenido del sitio: /_layouts/15/viewlsts.aspx
Configuración del sitio: /_layouts/15/settings.aspx
Guardar sitio como plantilla: /_layouts/15/savetmpl.aspx
Pagina de mantenimiento de elementos web: Añadir al edit form ?Contents=1
Listas ocultas de información de usuario

_catalogs/users
_catalogs/users/simple.aspx

Perfil de usuario: /_layouts/15/userdisp.aspx?id={UserID}&Force=True
Contenido y estructura: /_layouts/15/sitemanager.aspx

Según necesite urls y vaya recopilando, las iré añadiendo en este post.

Un saludo

Usar Select2 para filtrar listas de SharePoi con API REST

2017-11-08T08:03:00.002-08:00

Hace poco me paso que tenia que mostrar un dropdown list con datos de una lista, que obtenia haciendo una llamada a la API REST de SharePoint.

Como sabeis, esa llamada por defecto me devuelve (creo que 100) items, pero añadiendole a la llamada un top=n me devolverá mas. No obstante, me va a devolver tantos elementos como el umbral de la lista tenga marcado.

Se nos ocurrio mejorar esto utilizando el componente select2 https://select2.org.

El objetivo es disponer de un dropdownlist, además de un cuadro de texto que va autocompletando con los datos de la lista.

De esta forma segun escribimos en el cuadro de texto, irá filtrando elementos de la lista y mostrandolos. Además permite hacer paginacion de la misma.

Empiezo con un ejemplo:

1. Lo primero que hay que hacer es añadir el scriopt select2 y su css a la página:

2 . A continuación, añadimos en la página un elemento de tipo select con un class específico.

<select class="sharepoint-select2"></select>
3. Despues usamos el siguiente trozo de código javascript:

$('.sharepoint-select2').select2({

width: '200px',

ajax: {

url: function (params, data) { return _spPageContextInfo.webAbsoluteUrl + "/_api/Web/Lists/GetByTitle('LISTNAME')/items?$top=30&$select=COLUMNS&$filter=startswith(COLUMNAME,'" + params.term + "')"; //fijarse que hago un top30 para tener bloques de 30 elementos

dataType: 'json',

data: function (params) {

var query = {

page: params.page || 1

}

return query;

processResults: function (data, params) {

params.page = params.page || 1;

//ESTA PARTE ES IMPORTANTE EN SELECT2 4.0

var select2Data = $.map(data.value, function (obj) {

obj.id = obj.COLUMNID;

obj.text = obj.COLUMNTEXT;

return obj;

});

return {

results: select2Data ,

pagination: {

more: true //paginará siempre

}

};

cache: true

placeholder: 'Selecciona un elemento ... ',

escapeMarkup: function (markup) { return markup; },

minimumInputLength: 1,

templateResult: formatData ,

templateSelection: formatDataSelection

});

}

donde las funciones formatData y formatDataSelection:

function formatData (data) {

//Aqui puede devolverse html para pintar un bloque con varios datos ,

// /imagenes etc..

return data.COLUMNTEXT;

}

function formatDataSelection (data) {

return data.COLUMNID;

}

4. Por ultimo, para páginar yo lo que hice fue manejar 2 variables (ultimo ID de elemento de lista y ultimo texto añadido)

var lastID = -1;

var lastTerm = "";

$('.js-data-example-ajax').select2({

Cuando se va a sacar la url, se comprueba primero si ha cambiado el cuadro de texto (es nueva busqueda) y en caso de que haya cambiado, reseteo el id a -1.

if(lastTerm != params.term)

thisID = -1;

Despues hago una query u otra dependiendo del id. Si es -1 la query anterior y sino lo que hago es ordenar por D, y devolver aquellos con ID > el idGuardado (lastID)

if(thisID == -1)

return LLAMADA ANTERIOR;

else

return _spPageContextInfo.webAbsoluteUrl + "/_api/Web/Lists/GetByTitle('LISTNAME')/items?$top=30&$select=COLUMNS&$filter=(startswith(COLUMNNAME,'" + params.term + "') and (ID gt "+lastID +"))";

Hay que fijarse que el filtro lo hago con un startswith, es decir, que empiecen por el texto que introduzco.

En rpocessResults, guardo el latID y el lastTerm:

processResults: function (data, params) {

params.page = params.page || 1;

if(data.value.length > 0)

{

thisID = data.value[data.value.length-1].ID;

lastTerm = params.term;

}

Lo unico raro, es que si continuas haciendo scroll, siempre te aparece el texto de Loading more results. Para quitarlo habria que controlar que no haya mas elementos.

Espero que os sea util.

Un saludo

Instalar una dll en la GAC sin Visual Studio

2017-05-22T07:00:00.000-07:00

Hola,

a contiuación paso un script powershell para ejecutar en un servidor que se desee meter una dll en la GAC sin le herramienta gacutil.

Es algo sencillo, lo paso por si a alguien le puede ser útil.

Se puede generar un script con las siguientes lineas:

Set-location "ruta de la dll"
[System.Reflection.Assembly]::Load("System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
$publish = New-Object System.EnterpriseServices.Internal.Publish
$publish.GacInstall("ruta de la dll\nuestradll.dll")
iisreset

Donde hay que indicar :

la ruta donde tenemos la dll que queremos instalar, por ejemplo, Set-location "c:\temp"
Tambien a la hora de instalarla GacInstall("c:\temp\nuestradll.dll")
Por ultimo el nombre de la dll $publish.GacInstall("ruta de la dll\nuestradll.dll")

Ejecutar el script y se instalará y actualizará en caso de ya estar instalada.

Un saludo

Obtener el wsp de una solucion implementada en SharePoint

2017-04-28T00:29:00.003-07:00

En ocasiones, es común tener que modificar un proyecto que lleva implementado en Producción bastante tiempo y que nadie conoce cuando fue la última implementación. Es probable además que las personas que hayan desarrollado esa solución, ya no estén en la compañía con lo que no puedan ayudarte.

Tanto a mi como a casi todo el mundo, nos da respeto realizar una implementacion en ese entorno, sin estar seguros de que sea la ultima version. Es por ello, que se recomienda hacer una copia del wsp que se encuentra implementado en SharePoint para que en caso de que nuestra implementación falle, volver a implementarlo.

Para obtener el último wsp implementado, bastará con ejecutar el siguiente comando powershell En la consola de PowerShell de SharePoint:

$farm = Get-SPFarm
$file = $farm.Solutions.Item("nombredelasolucion.wsp").SolutionFile
$file.SaveAs("c:\rutaaguardar\nombredelasolucion.wsp")

Espero que sea de utilidad.

Un saludo

Forzar ejecución de un TimerJob en un servidor en concreto

2017-04-27T00:05:00.003-07:00

Hola a todos,

recientemente me ha pasado que en un proyecto disponiamos de un cluster de varios servidores

2 servidores frontales
2 servidores de aplicación
2 servidores de indexación

Concretamente, los 2 servidores de aplicaciones, los teníamos para lanzar varios timerjobs, que sincronizaban los sistemas de nuestro cliente con su SharePoint por las noches.

Tras un tiempo en ejecución, nos dimos cuenta que los TimerJobs, dejaban tostado el servicio timer de una de las maquinas, por lo que decidimos forzar unos Jobs a un servidor de aplicacion y otros a otra.

Para ello, el TimerJob tiene que tener el siguiente constuctor:

public NombreTimerJob(string jobName, string jobDescription, SPWebApplication webApplication, SPServer server): base(jobName, webApplication, server, SPJobLockType.Job)
{
}

En la activación de la Feature, creamos el timerJob y le indicamos el server:

public override void FeatureActivated(SPFeatureReceiverProperties properties)
{
SPServerCollection servers = SPFarm.Local.Servers;
NombreTimerJob timer = new NombreTimerJob ("nombre del timer", JobDescription, webApplication, servers["servidor2"]);

De esta forma, nos aseguramos que ese TimerJob se está ejecutando en el servidor 2.

Delegados y Eventos en C#

2016-09-29T00:19:00.001-07:00

Hace poco un compañero de trabajo me preguntaba que era un Delegado en .NET.

Le remití a la referencia de la msdn: https://msdn.microsoft.com/es-es/library/17sde2xt(v=vs.80).aspx , pero al poco me dijo que estaba igual que si no hubiera leido nada, incluso yo le di la razón. Decidí explicarselo con un ejemplo.

Segun la msdn, un delegado equivale a un puntero a una funcion con seguridad o a una devolucion de una llamada. Resumiendo. Un delegado no es mas que un apuntador a un método de una clase.

Con un ejemplo sacado de: https://msdn.microsoft.com/en-us/library/system.delegate(v=vs.110).aspx,

using System;
public class SamplesDelegate  {

   // Declares a delegate for a method that takes in an int and returns a String.
   public delegate String myMethodDelegate( int myInt );

   // Defines some methods to which the delegate can point.
   public class mySampleClass  {

      // Defines an instance method.
      public String myStringMethod ( int myInt )  {
         if ( myInt > 0 )
            return( "positive" );
         if ( myInt < 0 )
            return( "negative" );
         return ( "zero" );
      }

      // Defines a static method.
      public static String mySignMethod ( int myInt )  {
         if ( myInt > 0 )
            return( "+" );
         if ( myInt < 0 )
            return( "-" );
         return ( "" );
      }
   }

   public static void Main()  {

      // Creates one delegate for each method. For the instance method, an
      // instance (mySC) must be supplied. For the static method, use the
      // class name.
      mySampleClass mySC = new mySampleClass();
      myMethodDelegate myD1 = new myMethodDelegate( mySC.myStringMethod );
      myMethodDelegate myD2 = new myMethodDelegate( mySampleClass.mySignMethod );

      // Invokes the delegates.
      Console.WriteLine( "{0} is {1}; use the sign \"{2}\".", 5, myD1( 5 ), myD2( 5 ) );
      Console.WriteLine( "{0} is {1}; use the sign \"{2}\".", -3, myD1( -3 ), myD2( -3 ) );
      Console.WriteLine( "{0} is {1}; use the sign \"{2}\".", 0, myD1( 0 ), myD2( 0 ) );
   }

}

En el ejemplo se declara el delegado amyMethodDelegate y se peude ver que la clase mySampleClass tiene dos metedos que coinciden con el prototipo del delegado.

A continuación en el main se crea un delegado para cada uno de los metodos, pasandole como parametro el nombre del metodo en concreto.

Esto quiere decir que myD1 sera un delegado al metodo myStringMethod y myD2 al metodo mySampleClass

Mas información: https://msdn.microsoft.com/es-es/library/ms173172.aspx

SharePoint 2010: Cambiar autenticacion en modo clasico a basada en notificaciones

2013-04-14T01:05:00.000-07:00

Hola a todos,

Voy a explicar como cambiar la autenticacion de una aplicación web en modo clasico, a basada en notificaciones para configurar FBA.

Para ello hay que abrir la ventana de consola de PowerShell y ejecutar lo siguiente:

Add-PSSnapin Microsoft.SharePoint.PowerShell

A continuación ejecutamos este otro script:

$WebAppName = "http://"
$wa = get-SPWebApplication $WebAppName
$wa.UseClaimsAuthentication = $true
$wa.Update()

Poniendo el nombre de nuestra aplicacion web.
Con esto tendremos configurado la autenticacion basada en notificaciones.

Fuente: http://technet.microsoft.com/en-us/library/gg251985.aspx

Problemas con el Designer. ¡¡Me borra los formularios!!

2013-03-20T02:06:00.001-07:00

Hola,

voy a comentar algo curioso que me ha pasado estos días y me ha vuelto loco.

Resulta que tenía que realizar numerosos formularios para inserción de datos en diferentes listas. Además de esto, lo que hacían los formularios era llevar por defecto en funcion de un parámetro de QueryString, relacionaban una lista con otra (algo interesante a aportar en el próximo post).

¿Cual era mi problema?

Para realizar los formularios, como muchos eran similares pero modificaba algun componente o algun campo, me dedique a copiar y pegar el bloque donde muestran los campos del formulario.
Al terminar de crearlos todos e ir uno a uno probando, me daba cuenta que el SharePoint Designer me los borraba.
Tras un gran rato de investigacion y desesperacion encontre lo siguiente.
Cuando creas un formulario en SharePoint dDesigner, éste te asigna un webpartid al bloque (webpart) que muestra los campos, cómo yo estaba copiando y pegando en varios formularios, estaba poniendo el mismo webpartid y era algo que SharePoint no aceptaba como correcto :( .

La solución paso por borrar todos los parametros _webpartid y que SharePoint Designer los generase automáticamente.

Mostrar lista de SharePoint en un GridView (I). Campo de texto con formato enriquecido

2013-03-19T09:01:00.002-07:00

Hola, primero voy a explicar como mostrar una lista de SharePoint en un GridView.

Para ello, basta con obtener el listado de items de la lista.

SPList list = web.Lists["Nombre de la lista"];
SPListItemCollection collection = lista.Items;
Grid.DataSource = collection.GetDataTable();

En la lista, disponemos de un campo de texto de varias línea con formato.
Al mostrar los elementos de la lista, esa columna nos la pinta con html.

¿Como puedo mostrar unicamente el texto?

Para mostrar unicamente el texto se utilizara la siguiente funcion:SPHttpUtility.ConvertSimpleHtmlToText
Ejemplo:
Mostramos una label en la columna, suponiendo que es la segunda columna la que muestra el texto con formato(por ello accederemos a la Celda[1])

Label l = new Label();
l.Text = SPHttpUtility.ConvertSimpleHtmlToText(e.Row.Cells[1].Text, e.Row.Cells[1].Text.Length);
//se inserta la label en la columna e.Row.Cells[1].Controls.Add(l);

Redireccionar desde NewForm al EditForm del mismo elemento

2012-10-04T03:17:00.001-07:00

En el caso de plantearse la necesidad de redireccion hacia el dispform/editform de un elemento justo despues de su inclusion, ésta puede realizarse desde el evento ItemAdding tal y como se muestra en el codigo que introduzco a continuacion.

 private HttpContext _currentContext = null;

        public EventReceiver1()
            : base()
        {
            if (null != HttpContext.Current)
            {
                _currentContext = HttpContext.Current;
            }
        }

        /// <summary>
        /// Se va a agregar un elemento
        /// </summary>
        public override void ItemAdding(SPItemEventProperties properties)
        {
            base.ItemAdding(properties);
            try
            {

                // Obtenemos la lista
                SPSite siteColl = new SPSite(properties.SiteId);
                SPWeb site = siteColl.OpenWeb(properties.RelativeWebUrl);
                SPList list = site.Lists[properties.ListId];

                // Se clona el item ya que al hacer adding lo perderiamos
                EventFiringEnabled = false;
                SPListItem itemToAdd = list.Items.Add();

                // Todos los campos
                itemToAdd["Title"] = properties.AfterProperties["Title"];
                itemToAdd["test"] = properties.AfterProperties["test"];

                // Actualizamos el item
                itemToAdd.Update();
                site.Update();

                // Se obtiene el ID del elemento para la vinculacion
                string IDcampo = itemToAdd.ID.ToString();
                EventFiringEnabled = true;

                // Limpieza
                site.Dispose();
                siteColl.Dispose();

                // Redirect
                SPUtility.Redirect("/Lists/test/EditForm.aspx?ID=" + IDcampo, SPRedirectFlags.Default, _currentContext);
            }
            catch (Exception ex)
            {
                properties.Status = SPEventReceiverStatus.CancelNoError;
                properties.ErrorMessage = "ERROR " + ex.ToString();
                properties.Cancel = true;
            }
        }

Primero, se realiza la creacion del contexto para posteriormente, clonar el elemento e incluirlo en la lista con los valores del elemtneo original. Esto es debido a que la redireccion bloquea la inserccion del elemento actual en la lista.

Malas prácticas para dar permisos a una columna de una lista a un grupo de usuarios

2012-10-03T01:16:00.000-07:00

Estos días nos hemos encontrado con un problema para un proyecto. Resulta que tenemos una lista de datos de usuarios (lista personalizada de SharePoint) que los usuarios e un portal han de rellenar. Cuando rellenan esta lista, los miembros de la empresa (usuarios internos), han de rellenar mas datos que el usuario. Esos datos son sensibles a ver por el usuario, es decir "privados" para los usuarios Internos.

Nos encontramos con el primer problema. Hay que darle permisos a unas columnas de una lista a un numero de usuarios.

Voy a enumerar un numero de soluciones que hemos ido afrontando y que no nos han resultado de ayuda.

1. Crear dos formularios diferentes para cada tipo de usuario. Con el designer, podemos crear 2 formularios NewForm.aspx, 2 EditForm y 2 DispForm, de manera que cuando entre un usuario acceda a unos o a otros. (No voy a explicar como hacer para que unos entren en un formulario y otros en otro, pero habria que utilizar audiencias o modificar el comportamiento del link "Agregar nuevo elemento", boton de editar, etc, con el designer).
Problema: Un formulario(para usuarios finales) era el NewForm, el otro (administrdores o usuarios internos) NewFormAdm.aspx. Si yo accedo como usuario final al NewForm.aspx y modifico la url NewFormAdm.aspx ME SALE ESE FORMULARIO.

2. Desarrollar un custom control, que muestre un TextBox, combobox, dropdownlist, en funcion de un grupo de usuarios. Interesante y FUNCIONA
Problema: El dato no aparece en los formularios, pero si en las vistas de las listas.

3. Utilizar ECMA Script para capar permisos: En otra ocasion mostraré como hacer esto, pero basicamente era ocultar por javascript en funcion de un grupo de usuarios.
Problema: Si deshabilito javascript APARECEN LOS DATOS.

4. Continuamos con el 3, hacemos que si esta deshabilitado javascript, ocultamos la pagina. (luego pongo un post de esto).
Problema: si ponemos un display:none si esta jvascript deshabilitado, APARECE EN EL CODIGO FUENTE, un usuario con conocimientos utilizaria un navegador o herramientas como firebug, para facilmente mostrar los datos. Esto se debe a que el servidor no es el que comprueba si el navegador(cliente) tiene habilitado javascript, con lo cual los datos son enviados desde el servidor al cliente, y es este ultimo el que lo oculta. Deberiamos de NO ENVIAR los datos desde el servidor.

5. Continuamos el 4. Si comprobamos al hacer login si tiene javascript o no, para avisarle y que el servidor no envie datos.
Problema: ¿y si el usuario entra con javascript habilitado, y lo deshabilita despues? Volvemos al caso 4.

6. Creamos con designer unas paginas aspx en la libreria de Paginas e introducimos los formularios de nuevo, edit y disp. Esas paginas tienen permisos
Problema:Seguimos sin capar la columna para las vistas. Si genero una vista con unos campos que el user no puede ver, igual lo consigue con conocimientos de SharePoint, por mucho que pongamos filtros en paginas.

SOLUCION: Como este problema se nos da en muchas listas, no nos quedo otra que realizar siempre 2 listas, una para el usuario final, y otra solamente con permisos a los usuarios internos (lista y lista extendida). La pagina que muestre los datos del usuario y edit, mostrará una pestaña "Datos extendidos" que será añadir los campos del otro elemento.

Cualquier otra solucion sera bien recibira ;)

Un saludo.

Al seleccionar un campo de un combo Custom Control, me muestra los errores de validacion de otras columnas del formulario

2012-10-01T23:30:00.000-07:00

Para situarnos, me he descargado un Custom Control de Codeplex:

http://cascadefilterlookup.codeplex.com/

Este Custom Control, permite generar campos en el formulario de la lista de tipo lookup:

buscando listas de cualquier sitio (saltandose la restriccion de listas de un solo sitio)
Realizando un filtro caml para filtrar los resutlados que se muestran.
Permitiendo realizar combos en cascada. Para ello:

Se introduce el nombre del primer combo (Padre) y le introducimos si este va tener un padre (no) y un hijo(poner el nombre que posteriormente le daremos al hijo. Para el jio ponemos el nombre del padre y el que hemos puesto anteriormente para el hijo.
En ambos hay que seleccionar El campo Value, el campo que muestra el combo, y el campo que relaciona uno con otros.

Para que se relacionen, ambos combos tienen que alimentarse de una lista, pero el segundo (el hijo) tiene que tener ademas un campo de tipo lookup normal (busqueda) asociado con el padre. Este será el campo que filtre. Acordarse despues que el campo que hay que seleccionar en el padre para filtrar es el mismo que se muestre en la columna lookup de la lista de hijos.

Ahora llegamos al problema para el cual he escrito el post. Con este campo, cada vez que selecciono un valor en los combos para que alimente los combos hijo, me muestra los errores de validacion de cualquier otro campo del formulario que no sean los combos.

Para solucionar esto:

Busque en el codigo el DropDownList que pinta el combo. Se llama (CascadingDropDownList)
y modifico donde aparece this.CascadingDropDownList.CausesValidation = true; por this.CascadingDropDownList.CausesValidation = false;

Si miramos la especificacion de CausesValidation en msdn : http://msdn.microsoft.com/es-es/library/system.web.ui.webcontrols.listcontrol.causesvalidation.aspx nos dice lo siguiente:
Obtiene o establece un valor que indica si se realiza la validación cuando se hace clic en un control derivado de la clase ListControl. Es decir, si es true, validará los campos de la pagina.

Con esto estaria solucionado.

Un saludo

Cambiar el texto "Agregar Nuevo elemento" en una lista de SharePoint y la url del NewForm

2012-10-01T08:25:00.002-07:00

Hola a todos, en el siguiente post voy a explicar un metodo sencillo que he empleado para modificar el texto de Agregar Nuevo elemento de una lista.

Antes de empezar voy a explicar como llegue a esa necesidad. En un proyecto que estabamos realizando, utilizamos listas para crear soliciutudes de alta en los diferentes sistemas de la organizacion. La ventaja de las listas de SharePoint en estos casos, es que solamente con crearlas y añadirle las columnas correspondientes, disponemos del formulario de "Alta".

El problema que teníamos es que el usuario final carece de conocimientos de informatica y de tecnología web, con lo que el proyecto final debía de ser suficientemente usable y entendible. Debido a esto, una de las peticiones que se nos lanzaba en todo momento era modificar el titulo de "Agregar nuevo elemento" de las listas.

Primeramente, pense en la opcion de cambiarlo para todas. Debía; de ser un texto en un fichero de recursos, mmmm vamos a modificarlo Pero claro, lo que el cliente buscaba es modificarlo apra cada lista (si es una lista de solicitudes "Nueva Solicitud", si era una reserva "Nueva Reserva").

La opcion que opté es utilizar el SharePoint Designer y para ello:

1. Me conecto al sitio con el SharePoint Designer.

2. Entro en la librería de páginas: para ello hacer clie en "Todos los archivos" > "Paginas"

3. en el ribbon del designer , crear nueva ASPX

4. Darle un nombre a la página, y hacer clic en botón derecho sobre ella: Editar en modo avanzado

5. En vista codigo, situarse dentro del form1 y Añadir la lista para la que queremos cambiar el texto de nuevo elemento.

Insert> Data View (Insertar > Vista de datos) En ocasiones esa opcion está deshabilitada, probar a refrescar para pillar los cambios y debería habilitarse.

6. Una vez añadida la lista, lo primero hay que añadir la opcion de Agregar nuevo elemento, para ello hacer clic en la pestaña Diseño, y seleccionar en el menu Opciones , Summary Toolbar o (barra de herramientas reducida). Con esto aparecera la opcion de agregar nuevo elemento.

7. A continuacion hay que ver la lista en formato XSLT, para ello hacer clic en la pestaña Diseño, y seleccionar Customize XSLT View > Customize entire View (Personalizar XSLT).

8. Si seleccionamos la vista diseño, podemos situarnos encima de la opcion Agregar nuevo elemento, y con ella seleccionada, en la vista codigo, puede modificarse el Texto
Se puede modificar la linea --> <xsl:value-of select="$AddNewText" /> por el texto que se desea que aparezca, por ejemplo Nueva Solicitud

Asi mismo, se puede cambiar la url que aparece en el href y/o la url que abre el javascript en el onclick.

9. A continuación vamos a guardar el listado creado y modificado como web part, para ello en la pestaña Web Part, hacemos clic en Go To Site Gallery (Guardar En Galeria del sitio), para guardar este componente como un web part. Se abrirá una ventana para guardar y confiogurar por defecto las opciones del web part.

10. Para finalizar, si vamos a la web donde hemos creado este web part, Editamos la pagina y añadimos el web part creado (estara en la categoria Varios).

Espero que sea de ayuda..

Un saludo

Blog de David Alonso. Microsoft SharePoint, Office 365, Azure y otras tecnologías Microsoft

Personalizar Formularios de SharePoint con PowerApps (I)

¿Cómo personalizar Formularios de una lista de SharePoint con PowerApps?

¿Qué es PowerApps?

Power Apps es un nuevo servicio incluido dentro de Office 365 que permite que cualquier usuario con conocimientos de Office pueda crear aplicaciones de negocio sin conocimientos de programación.

El objetivo de las PowerApps es dotar de autonomía a los empleados de las empresas a la hora de crear aplicaciones de procesos de negocio. Éstas aplicaciones se pueden ejecutar tanto en el navegador como en dispositivos móviles.

Para más información sobre Power Apps hacer clic aquí.

¿Personalizar un formulario de lista de SharePoint?

¿Modificar el orden de los campos del formulario?

¿Guardar y ver el formulario?

Cómo firmar un PDF con iText Sharp

Firmar un pdf en C# con iTextSharp

¿Qué es iText Sharp?

iText Sharp es una adaptación a código CV# de la biblioteca iText, que se trata de una biblioteca Open Source para crear y manipular archivos PDF, RTF, y HTML en Java.

¿Qué significa firmar un documento pdf?

Firmar electrónicamente un documento, significa asociar al documento una serie de datos cuyo objetivo es identificar al firmante de manera inequívoca.

Además, asegura la integridad del documento, es decir el documento que se ha firmado es exactamente el mismo que el original por lo que no ha sufrido ninguna modificación.

Firmar documento pdf programáticamente con c#

A continuación adjunto el código fuente para firmar el documento pdf con C#. Lo primero que habría que hacer es añadir con Nugget la librería iText.

Habilitar Uso Compartido Externo en SharePoint Online Programáticamente

Cómo habilitar Uso Compartido Externo en una colección de sitios de SharePoint Online

¿Que es el Uso Compartido?

Habilitar uso compartido externo programáticamente

Las mismas opciones que hemos visto en el apartado anterior, pueden realizarse mediante código fuente C#. Por ejemplo, desde una Azure Function se podría modificar el uso compartido mediante código c#. Si no conocéis que es una Azure Function, dejo aquí un post de como crear una desde cero.

A continuación os dejo una función para modificar el uso compartido externo:

La línea importante es:

_siteprops.SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing;

Donde ConvertStringToSecureString es una función que he implementado para convertir la password de un string a un SecureString.

Crear un evento en el calendario con Graph desde un web part SPFX. MSGraphClient

Crear un evento de calendario con MS Graph

Actualizar elemento de una lista con PNP Powershell

Actualizar elementos de una lista de SharePoint Online con Powershell

PNP Powershell

Pnp (Pattern & Practices) se trata una comunidad de desarrollo de SharePoint de código abierto coordinada por el equipo de ingeniería de SharePoint. Esta iniciativa contiene una biblioteca de comandos de PowerShell llamada PnP de PowerShell, que permite realizar acciones dentro de SharePoint.

Comando para actualizar elemento de una lista

Mediante los comandos PNP Powershell, vamos a actualizar columnas de elementos de una lista. El comando que vamos a utilizar es SetPnpListItem.

Ejemplos

Como crear un command set SPFx con un panel react en una librería de documentos

Como crear una extensión SPFX en SharePoint Online

¿Qué es una Extensión SPFX?

Tutorial para tu primera Extensión SPFX

En el mismo .tsx creamos el state del componente.

y sus propiedades, donde nos llegaran los datos del documento que vamos a mostrar en el panel.

En el render, pintaremos un Panel y las Label necesarias para mostrar los datos así como un botón Cancelar para cerrar el Panel.

Además, añadimos el método onCancel y otros métodos necesarios:

En la función onInit vamos a meter este div HTML dentro del body de la página. Se puede incluir esta línea justo debajo del Log.info que nos genera automáticamente la extensión quedando el onInit de la siguiente forma:

Cuando se crea un commandSet, por defecto nos da 2 botones, pero aquí nos vamos a quedar con uno. Para ello en el método onExecute, dejamos solo el case ‘COMMAND_1’ y además, en elfichero CommandSet.manifest.json , dentro de “ítems”, dejamos solamente la definición del COMMAND_1 :

La función showPanel y funciones auxiliares:

Con este código, ya se dispone de un CommandSet con un panel.Para probarlo, se puede indicar la url de una librería en el archivo serve.json en la propiedad "pageUrl"

Se abrirá la biblioteca de documentos y cuando haces clic en el documento, se mostrará en la barra de herramientas una nueva opción con el commandset. Al hacer clic sobre esa opción se abrirá el panel.

En futuro post explicaré como desplegar un command set para varias colecciones de sitios.

Añadir un cuadro de texto TextField en un web part React con SharePoint Framework

TextField en un web part de SharePoint Framework con React

SharePoint Framework

Error gulp bundle: ENOENT: no such file or directory, scandir '**/node_modules/node-sass/vendor

Error en SharePoint Framework

ENOENT: no such file or directory, scandir '**/node_modules/node-sass/vendor

Como Crear una Función de Azure (I)

Como crear un Mock de un servicio web SOAP con SoapUI

Habilitar log al provisionar sitio de SharePoint Online con PNP

¿Qué es PNP?

Pnp (Pattern & Practices) se trata una comunidad de desarrollo de SharePoint de código abierto coordinada por el equipo de ingeniería de SharePoint. Esta iniciativa contiene una biblioteca de comandos de PowerShell llamada PnP de PowerShell, que permite realizar acciones dentro de SharePoint.

Cuando nos disponemos a provisionar un sitio de SharePoint Online con el comando powershell Apply-PnPProvisioningTemplate, en ocasiones se producen errores y no muestra ningún mensaje indicando de donde proviene el error.

Para facilitar un poco la tarea de encontrar el problema en el xml de la plantilla, se puede habilitar un log que se muestra al provisionar. Para ello, justo antes de ejecutar el comando Apply-PnPProvisioningTemplate, hay que ejecutar este otro: Set-PnPTraceLog -On -Level Debug

De esta forma, cuando se ejecute el provisionamiento, se mostrará por pantalla un registro de lo que Office Dev PnP Powershell esta haciendo.

Ocultar el titulo de una Pagina en SharePoint Online

Algunas urls de SharePoint

Usar Select2 para filtrar listas de SharePoi con API REST

Instalar una dll en la GAC sin Visual Studio

Obtener el wsp de una solucion implementada en SharePoint

Forzar ejecución de un TimerJob en un servidor en concreto

Delegados y Eventos en C#

SharePoint 2010: Cambiar autenticacion en modo clasico a basada en notificaciones

Problemas con el Designer. ¡¡Me borra los formularios!!

Mostrar lista de SharePoint en un GridView (I). Campo de texto con formato enriquecido

Redireccionar desde NewForm al EditForm del mismo elemento

Malas prácticas para dar permisos a una columna de una lista a un grupo de usuarios

Al seleccionar un campo de un combo Custom Control, me muestra los errores de validacion de otras columnas del formulario

Cambiar el texto "Agregar Nuevo elemento" en una lista de SharePoint y la url del NewForm

`_siteprops.SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing;`

Mediante los comandos PNP Powershell, vamos a actualizar columnas de elementos de una lista.

El comando que vamos a utilizar es SetPnpListItem.

Con este código, ya se dispone de un CommandSet con un panel.
Para probarlo, se puede indicar la url de una librería en el archivo serve.json en la propiedad "pageUrl"

Para facilitar un poco la tarea de encontrar el problema en el xml de la plantilla, se puede habilitar un log que se muestra al provisionar. Para ello, justo antes de ejecutar el comando Apply-PnPProvisioningTemplate, hay que ejecutar este otro:
Set-PnPTraceLog -On -Level Debug