ARF Form Base Authentication and WSS Publishing

Indagando nel codice di ARF ho scoperto un paio di funzionalità nascoste e non documentate, che ho intenzione di esplorare meglio con degli articoli mirati e nella mia guida. Per il momento mi limito a riportare quanto scoperto e le prime impressioni. Le due due funzionalità in questione sono ARF-FormsAuth e ARF-WSSPublishing. Entrambe sono due feature non attive dopo l'installazione della soluzione ARF, ma che devono essere attivate dall'utente, la prima è addirittura HIDDEN. ARF-FormsAuth è un tentativo di creare un sistema di autenticazione di base basato su form, integrato in SharePoint. Si basa su due liste custom FormsMemberList e FormsRoleConfig e su due provider personalizzati da configurare a mano nel web.config della web application: MembershipProvider e RoleProvider.

Nella wsp che si scarica dal sito ufficiale di ARF c'è un probolema con la feature ARF-FormsAuth, mancano le due cartelle contenenti gli schema delle liste custom. Siccome esiste una seconda feature che installa un'istanxa di queste liste e che non funziona se la prima feature non è attivata in modo corretto è necessario correggere l'errore di installazione. Per fare ciò è necessario rinominare la wsp di ARF in un file .cab, estrarre il contenuto e copiare le cartelle FormsMemberList e FormsRoleConfig contenute nella cartella della feature ARF-FormsAuth nella rispettiva cartella che si trova in 12\TEMPLATE\FEATURES. Fatto ciò è necessario riattivare la feature con stsadm -o activatefeature (usare l'opzione -force) e infine lanciare un IISRESET. Dopo questi passaggi sarà possibile attivare anche la feature ARF-FormsAuthLists.

La seconda feature, attivabile a livello di sito (SPWeb), dovrebbe consentire di creare delle pagine custom in WSS a partire dal template di pagina Basic.aspx, che al suo interno usa un campo (field) RichTextField, compreso nella soluzione ARF. Il condizionale è d'obbligo perchè non sono ancora riuscito a far funzionare la caratteristica. Di certo devo segnalare un errore: nella pagina Basic.aspx si fa riferimento alla master page /_catalogs/masterpage/spworks.master di cui non vi è traccia nella soluzione; pertanto la pagina risulta inutilizzabile. Per risolvere il problema consiglio di modificare la pagina utilizzando una più standard ~masterurl/default.master o ~masterurl/custom.master master page.

L'impressione al momento è che queste funzionalità siano solo una bozza e non effettivamente funzionanti, ma vi saprò dire una volta che le avrò provato davvero.

Come sempre rinnovo l'invito a collaborare con me se avete già avuto modo di fare esperianza con qualcuna delle funzionalità di ARF, in modo da avere una più ricca collezione di esperienze e di impressioni.

ARF e WCF

In un recente progetto che ho realizzato in WSS con l'ausilio di ARF, un mio collega ha dovuto integrare delle chiamate a servizi WCF, nella fattispecie per recuperare un profilo utente da un applicativo propietario.

Durante il test è incappato in questo errore:

ARF: System.ApplicationException: This operation returned because the timeout period expired. (Exception from HRESULT: 0x800705B4)

at System.Threading.ReaderWriterLock.AcquireWriterLockInternal(Int32 millisecondsTimeout)

at ARF.Web.Utility.SPFileWatcher.Timer_Elapsed(Object sender, ElapsedEventArgs e)

Dopo averci speso una giornata, seguendo alcune mie considerazioni, Alberto ha scoperto che la connessione WCF va chiusa esplicitamente altrimenti va in conflitto con la cache di ARF (ARFCache.cs). Frugando nel codice di ARF si è anche accorto che la cache, utilizzata per cachare i template xslt, ha un timeout impostato a 30 secondi, di default.

Accessibilità con SharePoint 2007

Avendo dovuto affrontare il discorso di sito accessibile, per un recente progetto, da realizzarsi con MOSS 2007, ho fatto un po’ di ricerche in giro per vedere come affrontare il progetto. Su CODEPLEX ho trovato alcuni interessanti progetti, uno tra tutti GSPTV, che mettevano a disposizioni soluzioni interessanti per rendere accessibili: webpart zone, menu di navigazione, box di ricerca, content query web part etc. In più ho trovato molto interessante il progetto ARF, anch’esso mette a disposizione sia controlli che adapter per sistemare alcune magagne di SharePoint. A dirla tutto, come consiglio, non ho usato un unico progetto, ma una selezione di componenti di uno e dell’altro. Di ARF in particolare ho trovato molto interessanti il ARF:Menu e ARF:SiteMap. Una delle caratteristiche principali di ARF (Alternative Render Framework) è di utilizzare il linguaggio XML per descrivere gli oggetti di MOSS e una serie di fogli di stile XSL per renderizzare il codice HTML. In questo modo il controllo in mano allo sviluppatore è completo.

Riferimenti

GSPTV
ARF

Alternative Rendering Framework (ARF)

Già in precedenza ho accennato al framework ARF, in quanto mi è venuto comodo per rendere accessibili alcuni componenti del WCM di MOSS. In questo periodo ho ripreso in mano il framework, anche perchè ci sono state della aggiunte, e vorrei provare a spiegarne l'utilizzo. Il problema è che il framework è poco documentato e non sempre intuitivo; volevo quindi lanciare una proposta, ovvero chiunque ha usato il framework o ha materiale in merito mi può contattare o postare un commento per aiutarmi a scrive una serie di articoli in italiano che descrivano al meglio alcuni aspetti di questo strumento.

A breve ho intenzione di parlarvi dei controlli SiteQuery e ListQuery di ARF che ho usato con WSS e che mimano un pochino la funzionalità delle Content by Query Web Part, XML e XSL compresi.

Rinnovo l'invito a farsi avanti a tutti coloro che avessero informazioni su ARF.

Intanto vi segnalo un embrione di sito documentativo sull'argomento: http://arf.thekid.me/Pages/default.aspx

ARF Guide (1)

Come accennato in precedenza comincio a parlarvi dei risultati delle mie prove con ARF e di quanto reperito in rete, soprattutto dall'autore, in merito a ARF (Alternative Rendering Framework). Ogni commento e ulteriori informazioni sono più che gradite.

ARFConsole
Mostra una console di editing (stile Publishing Site). Ci sono due Control Template per la console; uno per i Publishing Site e uno per i Team Site (WSS e MOSS):

• ArfConsole.ascx


• ArfWssConsole.ascx

I due controlli sono diversi, ArfConsole corrisponde a quanto mostrato nella figura sottostante, mentre ArfWssConsole mostra il Welcome Message e il pulsante Site Action. A dire il vero quest'ultimo controllo non lo trovo utilissimo, comunque può essere uno spunto per una personalizzazione.

Proprietà pubbliche

IsFloating

Booleano per indicare se la console è bloccata o flottante

Esempio
Inserire nella propria pagina/layout di pagina la dichiarazione del control template da usare e il controllo console;

<@ Register TagPrefix="ARFConsole" TagName="Console" src="~/_controltemplates/ARF/ARFConsole.ascx" %>

<ARFConsole:Console runat="server" IsFloating="True">

Guida ad ARF in italiano

Ho finalmente rilasciato la prima release della guida su ARF, per ora solo in italiano. La guida non è ancora completa, perchè il lavoro di indagine e lungo e tedioso, anche perchè il prodotto non è molto documentato e quel poco di documentazione è frammentario e non esaustivo.

Spero che vi sia utile e aspetto commenti e suggerimenti.

Italian ARF Guide

Guida ad ARF - in arrivo una nuova versione

State collegati, tra poco rilascerò un nuova versione della guida in italiano su ARF; ricca di contenuti, dalle feature nascoste all'intragrazione con Silverlight, qusta nuova versione si merita un salto di numerazione. Sarà targata 0.9, ben tre salti di versione. Spero di riuscirla a pubblicare in concomitanza con l'evento SharePoint Future che si terrà martedì 27 a Milano, in cui ci verranno preentate in anteprima le nuove caratteristiche di SharePoint 2010.

ARF Guide 0.9 è online

Ho appena rilasciato la nuova versione della guida in italiano sul fremawork ARF.
Potete scaricarla da Codeplex.

Rilasciata nuova versione della guida su ARF

Ho rilasciato su Codeplex una nuova versione della guida di ARF. Ancora più dettagliata, ho approfondito il controllo Menu, mostrando il suo utilizzo in un caso reale. Da non perdere la presentazione dei template XSLT utilizzati per generare i menu di navigazione, nei quali sfrutto la catteristica del controllo di iniettare parametri all'interno degli stili XSLT.

Dai diamanti non nasce niente dal letame nascono i fior...

Se son rose fioriranno. In effetti non tutto è perduto, ho ancora l'occasione di lavorare con SharePoint, per il momento con una vecchia versione (WSS 2.0), ma è sempre esperienza. Il morale è alto e forse presto vi sottoporrò qualche nuovo risultate delle mie sperimentazioni.

Dimenticavo, devo ancora finire la guida di ARF!

A presto.

SharePoint Future

Quest'oggi ho partecipato alla SharePoint Future, overview di SharePoint 2010, organizzata da Green Team e Pialorsi Sistemi. Come sempre la ormai rodata squadra di trainer ci ha bombardato letteralmente di informazioni; ed erano solo una minima parte. Dal mio punto di vista, più orientato al site building, mi ha fatto piacere sapere che SP 2010 sarà XHTML strict compatibile, anche se mi ha lasciato un po' di sasso il fatto che non supporterà più IE 6 (forse la conferma che le nuove tecnologie Microsoft sono più rispettose degli standard). Le master page nuove sono "prive di tabelle" o per lo meno a tendere lo saranno e tutti i controlli sono stati riscritti per generare del buon HTML semantico. No vedo l'ora di provarlo!

Ultima considerazione, probabilmente con la nuova versione di SharePoint ARF andrà in pensione...

SharePoint 2007 & XHTML

Per esperienza personale, oltre al fatto che è anche dichiarato da Microsoft, SharePoint 2007 non è in grado OOTB di generare codice XHTML valido, indipendentemente dal DOCTYPE utilizzato. Fortunatamente qualche espediante per raggiungere un buon grado di aderenza allo standard XHTML c'è.

Parlo principalmente della carateristica di publish del MOSS, di cui ho più esperienza. I problemi derivano per esempio dal rendering dei campi RitchImage, che aggiungono attributi deprecati e scrivono il tag in maiuscolo. Per risolvere questo problema si può ricorrere agli adapter. Molti progetti presenti in Codeplex inerenti all'accessibilità fanno ricorso a questo espediante; consiglio:

• Get SharePoint to Validate
• [unofficial] Accessibility Kit for SharePoint (uAKS)
• BKS (Barrierefrei-Kit for SharePoint)
• ARF

Tutti progetti che affrantano il problema della resa del codice conforme allo standard XHTML; dal mio punto di vista non esiste il progetto risolutore, un mix delle soluzioni è l'approccio migliore.

Un altro consiglio per generare del buon codice è di usare il più possibile le Content by Query WebPart, che generano il codice html tramite XSLT. Questo permette al programmatore di maggior controllo sul codice generato. L'unica accrotezza da tenere presente è che gli XSLT usati dalla CQWP generano HTML pertanto il consiglio è di modificarli per fargli generare in output del codice XML. Per avere un controllo maggiore, tramite browser, delle CQWP, ho usato una WebPart che le estende e che espone anche quelle proprietà che altrimenti sarebbero visibili solo esportando la webpart stessa; la webpart è la Extented CQWP di Waldek Mastykarz (Paging Content Query Web Part).

Best Master Page

Facendo mente locale all'esperienza passata e ad alcuni studi recenti, con relativa sperimentazione, sono giunto alla seguente conclusione: se dovessi riscrivere una custoim master page userei solo codice html e placeholder. Detta così non c'è nulla di inaspettato, ma spiegando quanto ho in mente forse qualche perplessità potrebbe nascere. Vi invito quindi fin da subito a commentare quanto andrò a dire, concedendomi l'attenuante di una temporanea insanità mentale e del fatto che non propongo ciò come LA SOLUZIONE, ma semplicemente come uun'idea che mi è venuta in mente, o perlomeno una presa di coscienza.

L'invenzione dell'acqua calda consiste in questo: invece di mettere i controlli direttamente nella master page, soprattutto quelli custom (si pensi per esempio al rendering accessibile dei menu tramite l'utilizzo delle componenti di ARF, che ho menzionato in post precedenti), andrei a posizionarli in control template personalizzazati, posizionati in pagina tramite feature, utilizzando appunto i delegate control. Un vantaggio che mi viene in mente, e qui potrebbero scatenarsi i detrattori, è la possibilità di scrivere del codice runat server all'interno dei controlli ascx, cosa che nelle master page non è possibile fare; questo mi permetterebbe volendo (anche se non è il sistema più elegante dal punto di vista dei puristi dello sviluppo) di non generare codice compilato in DLL. Ovvero ad eventuali modifiche non dovrei ricompilare il codice per riportarlo o nella bin della web application oppure in GAC.

A questo punto sono pronto alla pubblica lapidazione. Ben venga se ne esce qualcosa di costruttivo che ci consenta di scrivere delle buone master page, facilmete manutenibili.

Aggiungo qualche link di approfondimento:
User Control in Master Page (Page Footer)
Sovrascrivere i DelegateControl