Paolo Pialorsi

Microsoft SharePoint Conference 2008: 2 e 3 ottobre 2008 a Milano!

paolo — Tue, 01 Jul 2008 23:00:08 GMT

Con grande piacere posso annunciare, insieme all'amico Igor, che da qualche giorno è online il sito dedicato alla prossima edizione di Microsoft SharePoint Conference 2008, la conferenza italiana dedicata a Microsoft Office SharePoint Server 2007 e alle tecnologie collegate. Dopo il successo dello scorso anno, questa volta l'organizzazione è il frutto di una partnership diretta con Microsoft Italia che da sponsor, quale era lo scorso anno, con nostra grande soddisfazione diventa quest'anno co-organizzatore.

Sul sito dell'evento si possono trovare agenda, descrizione sessioni e contenuti, biografie degli speaker e istruzioni per l'iscrizione.

L’evento si terrà il 2 e 3 ottobre 2008 a Milano (a breve maggiori dettagli sulla location) e vedrà riuniti in due giorni una dozzina tra i massimi esperti nazionali ed internazionali di Microsoft Office SharePoint Server 2007 e delle tecnologie collegate, per erogare 30 sessioni tecniche per IT Pro, Site Builders e sviluppatori. Obiettivo dell’evento è condividere esperienze reali e riunire la comunità di persone che ad oggi lavorano con SharePoint.

L’evento prevede un "super early bird" che permette un’iscrizione a tariffa agevolata (480€+IVA anziché 600€+IVA). Il "super early bird" scadrà il 20 luglio 2008!

Per chi ha partecipato all'edizione dello scorso anno e per chi scopre per la prima volta questo evento, l'invito è di visitare il sito dell’evento per consultarne i contenuti ed iscriversi al più presto!

SharePoint Workflow: due articoli utili

paolo — Fri, 13 Jun 2008 10:24:15 GMT

Per chi vuole "avviarsi" allo sviluppo di Workflow per SharePoint, segnalo due articoli utili scritti da David Man e pubblicati su MSDN:

http://msdn.microsoft.com/en-us/library/cc546557.aspx
http://msdn.microsoft.com/en-us/library/cc546558.aspx

VSeWSS v1.2: prime prove

paolo — Fri, 06 Jun 2008 18:07:17 GMT

Ieri sera ho fatto qualche prova con VSeWSS v. 1.2. Ecco qualche feedback:

Non è in grado di migrare i progetti fatti con VSeWSS 1.1 su VS2005 (e questo non è bello!). Ho provato a migrare diversi progetti, ma il tipo di progetto tra VS2005 e VS2008 è apparentemente diverso, quindi la conversione non va a buon fine. Se qualcuno ha trovato il modo di scavalcare il problema ... sotto ci sono i commenti :-).
L'editor grafico di solution non è affatto male, è comodo anche se potrebbe essere più "ricco" perché alla fine occorre comunque andare di XML a manina nei file di Feature.XML. Resta comunque comodo il fatto che si possono creare dei package di deployment con al loro interno diverse feature.
I template di progetto e di elemento sono integrati con la generazione automatica della solution, per cui diventa molto semplice creare progetti di estensione "articolati" fatti di N WebPart, CustomField, ContentTyp, List Template, ecc.
Il solution generator, a partire da siti/liste esistenti, ha apparentemente gli stessi problemi di stabilità e affidabilità della versione precendente. Esiste però in due versioni: una per VS2005 e una VS2008.

In conclusione strumenti come STSDev restano ancora molto interessanti, ma queste estensioni a VS2008 sono decisamente comode. Speriamo che la futura versione 1.3 (o come si chiamerà) sia in grado di migrare i dati e che non ci costringa a spostare a mano di nuovo i file di progetto da VS2005 a VS2008.

VSeWSS v1.2: eccolo!

paolo — Thu, 05 Jun 2008 17:14:22 GMT

Come annunciato ieri, eccolo!

Programming LINQ a TechEd e ... "The pen is on the table" :-)

paolo — Thu, 05 Jun 2008 16:50:07 GMT

Come già segnalato da Marco, l'altro giorno siamo stati intervistati da Ken Rosen a proposito del nostro nuovo libro su LINQ.

Se volete sentire un bresciano e un torinese che parlano in inglese ... fate un giro sulla home page di TechEd Online (per qualche ora saremo lì, poi ci sposteremo sul link interno - high res e low res).

Parallel Extensions for .NET: June 2008 CTP

paolo — Wed, 04 Jun 2008 19:54:16 GMT

Le Parallel Extensions per .NET sono sicuramente uno degli argomenti più caldi del periodo. Se ne è parlato anche durante la Keynote di TechEd (l'ultima di Bill Gates come employee di Microsoft). Contestualmente alle sessione sull'argomento tenute a TechEd ecco una nuova CTP disponibile.

Come abbiamo (io e Marco) già detto in diverse occasioni LINQ non è solo LINQ to SQL e non è solo un ORM ... le prospettive che si prefigurano con strumenti come Parallel Extensions e PLINQ ne sono la dimostrazione chiara e tangibile.

Visual Studio 2008 Extensions for Windows SharePoint Services

paolo — Wed, 04 Jun 2008 17:55:27 GMT

Come già segnalato da Marco, in questi giorni siamo ad Orlando per seguire TechEd e soprattutto :-) per promuovere il nostro nuovo libro su LINQ.

Oggi ho assistito ad una sessione in cui è stato annunciato il rilascio a giugno 2008 (cioè in questi giorni) delle estensioni per Visual Studio 2008 per WSS3. Era ora! Tutti le aspettavamo da tempo. A cosa servono?

Queste estensioni, insieme a quanto già offerto nativamente da VS2008, offrono:

Project Templates

Team Site Definition
List Definition
Empty
Blank Site Definition
Web Part

Workflow Templates

SharePoint 2007 Sequential Workflow
SharePoint 2007 State Machine Workflow

Item Templates

List Definition
Content Type
Field Control
Web Part
Module
Template
Event Receiver
List Instance
List Definition from Content Type

Custom Viewers

WSP Viewer

Con funzionalità di build & deploy

Quali sono i limiti di questo insieme di estensioni?

Non supporta i 64bit sulle macchine di sviluppo (quindi se usate le VM come me non avrete problemi, se usate il PC "ufficiale" e l'avete installato a 64bit ... vi toccherà rivedere i vostri progetti). Non supporta la compilazione da riga di comando e il remote deployment, cioè non potete automatizzare il deploy su server diversi da quello di sviluppo, sul quale state lavorando (di nuovo, va bene su PC DEV dedicati o su VM dedicate). Non ha designer WYSIWYG degli oggetti che si creano (e questo non è un limite :-) ...).

Qui trovate maggiori dettagli sulla versione 1.1 ad oggi disponibile solo per VS2005. Qui invece potete fare il download, della versione per VS2005.

Infine qui potete trovare informazioni sulla documentazione del prodotto.

Un nuovo LINQ Query Provider: LINQ4SP

paolo — Sun, 18 May 2008 07:46:43 GMT

Ho appena visto l'annuncio di un nuovo LINQ query provider per creare/modificare/cancellare e interrogare contenuti di liste di SharePoint . Sembra un'implementazione molto interessante, almeno in base ai video dimostrativi pubblicati (qui e qui) per ora. Da quando ho iniziato ad occuparmi di LINQ (ormai 3 anni fa) ho sempre pensato che SharePoint sarebbe stato un valido candidato per l'implementazione di un LINQ query provider personalizzato.

.NET 3.5 e Visual Studio 2008 SP1 - Beta

paolo — Tue, 13 May 2008 22:17:21 GMT

Ecco la prima Beta del SP1 di .NET 3.5 e Visual Studio 2008. Tra le novità più interessanti, oltre ai soliti bug fix tipici dei Service Pack, la diffusione di una nuova release di ADO.NET Entity Framework e ADO.NET Data Services e tutta una serie di migliorie a WCF, compreso un hosting wizard che dovrebbe aiutare nella creazione di WCF Service Host.

SharePoint Object Model

paolo — Sun, 11 May 2008 22:04:57 GMT

In questo post riporto "as is" l'articolo che ho pubblicato su Visual Basic Journal di alcuni mesi fa, a proposito della programmazione di SharePoint tramite il suo Object Model.

_____

Microsoft Office SharePoint Server 2007 (MOSS2007) è un framework applicativo principalmente pensato per la realizzazione di soluzioni web di collaborazione, gestione documentale e publishing. Come probabilmente saprete esiste una versione gratuita di SharePoint, chiamata Windows SharePoint Services 3.0 (WSS3), che sta alla base anche di MOSS2007, che semplicemente lo estende in termini di funzionalità e servizi accessori. Ad esempio MOSS2007, nelle sue varie versioni e licenze, offre un motore di ricerca evoluto e di livello enterprise, fornisce un motore di Single Sign On, consente il collegamento a sistemi e software gestionali esterni tramite il Business Data Catalog, consente di gestire integrazioni con Microsoft Office Form Server e Microsoft Office Excel Services, ecc.

Tutti questi servizi e funzionalità sono utilizzabili “out of the box” e gestibili con strumenti già pronti per l’uso, come Microsoft Office SharePoint Designer 2007 e Microsoft Office 2007 in generale.

Sviluppare soluzioni SharePoint

Molto spesso però non è sufficiente appoggiarsi a questi strumenti e occorre sviluppare delle personalizzazioni, per integrare le proprie soluzioni con il motore di WSS3/MOSS2007.

Di seguito sono elencati alcuni dei più comuni ambiti di personalizzazione e sviluppo di soluzioni SharePoint:

WebPart: controlli web pensati per arricchire la classica interfaccia utente di SharePoint, definibili e configurabili anche dall’utente finale, che si integrano con l’interfaccia web di SharePoint. Richiamano in tutto e per tutto il concetto di WebPart di ASP.NET 2.0, in quanto ne rappresentano un’estensione.
EventHandler: sono classi che intercettano azioni eseguite dagli utenti (inserimento di un file, cancellazione di un item da una lista, ecc.) e consentono di svolgere azioni correttive, se invocati pre-evento, o consequenziali, se invocati post-evento.
List template: descrivono modelli di liste di documenti o elementi (contatti, appuntamenti, task, ecc.) utilizzabili per creare N diverse istanze delle stesse, tutte con la stessa struttura e comportamento, in base a quanto definito nel modello.
Site template: spesso si realizzano soluzioni basate su N siti web tutti con lo stesso modello grafico e la stessa struttura di contenuti (liste, cartelle documenti, ecc.). Si pensi alla gestione dei clienti e alla realizzazione di un mini-portale web, per ciascun cliente o area commerciale, con le cartelle per le fatture attive, passive, gli indirizzi, gli appuntamenti, ecc. Creare un site template corrisponde a formalizzare uno schema dei contenuti, delle personalizzazioni e del layout grafico di base, da applicare poi a tutte le singole istanze di sito web, costruite secondo quel modello.
Workflow: sono processi di business realizzati con Windows Workflow Foundation e che possono arricchire di funzionalità e comportamenti le liste di file e contenuti o i modelli di documento. Ad esempio è possibile associare un workflow di approvazione ad ogni documento di tipo “offerta”, oppure collegare un workflow a qualsiasi documento inserito in una specifica cartella, oppure ancora definire un flusso da eseguire ogni volta che viene inserito un appuntamento in un’agenda on-line.

Vi sono molti altri ambiti in cui può essere necessario sviluppare porzioni di codice per SharePoint, ma quelli appena visti sono sicuramente tra i più diffusi. Ciò che conta maggiormente però è il fatto che qualunque tipo di soluzione si vada ad implementare, uno degli strumenti principali da utilizzare è l’Object Model di SharePoint.

SharePoint Object Model

Dal momento che SharePoint persiste sia la propria configurazione che la configurazione e i contenuti dei suoi siti su dei database applicativi, basati su Microsoft SQL Server, è necessario appoggiarsi ad un modello ad oggetti per poter operare in modo sicuro e corretto.

Lo SharePoint Object Model è un framework di classi, realizzato con .NET Framework e parzialmente offuscato, che consente di lavorare e interagire con tutti gli strumenti e gli oggetti definiti all’interno di una server farm SharePoint.

È una libreria di classi che è disponibile su qualsiasi server sul quale siano configurati i moduli di SharePoint. Non è pensato per essere referenziato ed utilizzato da applicazioni o servizi che girano su server diversi da quelli preposti ad ospitare SharePoint. Esistono infatti dei web service, pubblicati da SharePoint, pensati per tutte quelle situazioni in cui sia necessario utilizzare i server MOSS2007/WSS3 da server o applicazioni remote.

Esistono poco più di una ventina di namespace .NET che raggruppano diverse migliaia di classi. Il namespace radice si chiama Microsoft.SharePoint e contiene numerosi altri namespace, alcuni dei più importanti sono:

Microsoft.SharePoint.Administration: contiene le classi per l’amministrazione e la gestione della topologia di soluzioni SharePoint.
Microsoft.SharePoint.WebControls: racchiude i controlli e le classi per la realizzazione di WebPart e WebControl.
Microsoft.SharePoint.Workflow: rappresenta il namespace preposto a definire le classi relative all’integrazione tra SharePoint e Windows Workflow Foundation.
Microsoft.SharePoint.Portal.Search: contiene le classi relative al motore di ricerca, presente solo in MOSS2007 e non in WSS3.
Microsoft.SharePoint.Portal.WebControls: controlli web specifici di MOSS2007.
Microsoft.SharePoint.Portal.SingleSignOn: le classi che afferiscono al motore di Single Sign On di MOSS2007.

La topologia di una soluzione SharePoint prevede la definizione di una SharePoint Server Farm, rappresentata da oggetti di tipo SPFarm. Una SPFarm consente di gestire la configurazione della farm, importare/esportare utenti definiti nella farm stessa e svolgere operazioni di backup e restore dei servizi configurati. Di seguito un esempio di codice per accedere ad una SPFarm, in base alla stringa di connessione del suo database di configurazione:

SPFarm farm = SPFarm.Open("server=localhost;database=SharePoint_Config;integrated security=SSPI;");
Console.WriteLine("The current SPFarm version is: {0}", farm.BuildVersion);
Console.WriteLine("The SPFarm name is: {0}", farm.DisplayName);

Una SPFarm è costituita da una o più Web Application, che in SharePoint Object Model si chiamano SPWebApplication. Queste ultime corrispondo ai siti IIS configurati sui server web di pubblicazione. Da una SPWebApplication si gestiscono le configurazioni della singola applicazione. Ad esempio di seguito si utilizza un oggetto SPWebApplication per configurare l’accesso anonimo all’applicazione:

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri(http://moss2007dev:9501/));
webApplication.IisSettings[SPUrlZone.Default].AllowAnonymous = true;
webApplication.Update();

Come si vede già da questo primo esempio, le modifiche agli oggetti devono sempre essere confermate invocando l’apposito metodo Update(). Infatti mentre si lavora con gli oggetti si modifica solo una copia in memoria di quello che deve poi essere persistito nel database di configurazione o applicativo, a seconda dei casi.

All’interno di ciascuna Web Application trovano posto le Site Collection, oggetti di tipo SPSite, che non sono altro che insiemi di Siti Web, corrispondenti ad oggetti di tipo SPWeb. Gli SPSite raggruppano diversi SPWeb, consentendo di condividere il database di contenuti, gli utenti e i gruppi SharePoint, oltre ad alcune impostazioni generali.

Ecco un esempio di codice che scorre tutti gli SPSite configurati su una SPWebApplication, per andare poi a mostrare le singole istanze di SPWeb in essi cotenute.

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri("http://moss2007dev:9501/"));

Console.WriteLine("\nHere are the Sites in the SPWebApplication:");
foreach (SPSite site in webApplication.Sites)
{
Console.WriteLine("\tPortal Name: {0}\n\tURL: {1}",
site.PortalName, site.Url);
Console.WriteLine("\n\tHere are the Webs in the SPSite:");
foreach (SPWeb web in site.AllWebs)
{
Console.WriteLine("\tTitle: {0}\n\tURL: {1}\n\tTemplate: {2}",
web.Title, web.Url, web.WebTemplate);
}
}

Il codice di esempio appena visto è definito all’interno di un’applicazione esterna, in questo caso specifico si tratta di un’applicazione Console, che interagisce con SharePoint. Molto spesso però il codice che scriviamo gira all’interno di pagine ASP.NET o WebPart, che in realtà sono ospitate all’interno di istanze di SPWeb. Per questo motivo gli oggetti SPWeb e SPSite possono essere costruiti anche sfruttando direttamente il contesto ASP.NET delle richieste che si stanno evadendo, per ricavare automaticamente il contesto SharePoint.

SPSite site = SPControl.GetContextSite(Context);
SPWeb web = SPControl.GetContextWeb(Context);

L’esempio appena riportato descrive come accedere al SPSite e/o SPWeb corrente da una Web Part configurata in MOSS2007/WSS3. L’oggetto SPControl utilizzato, si trova nel namespace Microsoft.SharePoint.WebControls, proprio ad indicare che è di uso ricorrente da parte dei Web Control ASP.NET creati per girare in SharePoint.

Lavorare con le liste

A prescindere dal fatto che si lavori con applicazioni esterne (servizi del sistema operativo, moduli batch da Console, programmi Windows Forms, ecc.) referenziando gli SPSite e SPWeb tramite la loro URI, oppure con pagine ASP.NET e WebPart, utilizzando il contesto ASP.NET, tipicamente questi oggetti sono utilizzati non tanto o non solo per variare la configurazione dell’ambiente, ma soprattutto per accedere in lettura e scrittura ai contenuti del portale.

Attraverso un’istanza di SPWeb si può avere accesso, da codice, alle liste di contenuti e documenti presenti all’interno di un portale SharePoint, sia esso MOSS2007 o WSS3. Infatti ogni SPWeb espone la proprietà Lists, di tipo SPListCollection, tramite la quale si possono scorrere e ricercare le singole liste di contenuti. Pensiamo allora ad un classico portale SharePoint di collaborazione (detto “Team Site”), dove sia presente una lista di “Contacts”. Il seguente codice mostra come ottenere e sfogliare l’elenco dei singoli contatti in essa contenuti:

SPWeb web = SPControl.GetContextWeb(Context);
SPList listContacts = web.Lists["Contacts"];
foreach (SPListItem contact in listContacts.Items)
{
Respone.Write(String.Format("Last Name: {0} - EMail: {1}",
contact["Title"], contact["Email"]));
}

Come si vede dall’esempio appena riportato, ogni item di una lista SharePoint è descritto da un oggetto di tipo SPListItem, il quale espone un dictionary di proprietà che corrispondono ai campi informativi dell’elemento. Si noti che le chiavi utilizzate per accedere i singoli campi non corrispondo necessariamente ai nomi dei campi stessi (“Last Name” diventa “Title”). Inoltre ogni campo di un SPListItem ha un nome pubblico e descrittivo, chiamato Title, e un nome interno, chiamato InternalName. Nel nostro esempio il campo con Title “Last Name” ha un InternalName pari a “Title”. La ricerca dei campi su un SPListItem avviene sulla base dell’InternalName, che è case sensitivi. Per avere un elenco preciso dei nomi dei campi disponibili per gli SPListItem di un’istanza di SPList possiamo utilizzare la proprietà Fields dell’oggetto che descrive la lista.

SPWeb web = SPControl.GetContextWeb(Context);
SPList listContacts = web.Lists["Contacts"];
SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
foreach (SPField field in listContacts.Fields)
{
Respone.Write(String.Format("Title: {0} - Internal Name: {1} - Type: {2}",
field.Title, field.InternalName, field.TypeAsString));
}

In alternativa possiamo utilizzare la proprietà SchemaXml che caratterizza ogni istanza di SPList, per avere la sua struttura in un solo passaggio, in formato XML.

Un’operazione ricorrente, oltre allo sfogliare una lista, è creare nuovi elementi al suo interno ovvero creare liste ex-novo. Di seguito è riportato un esempio di codice che aggiunge un contatto alla lista appena sfogliata:

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPList listContacts = web.Lists["Contacts"];
SPListItem newContact = listContacts.Items.Add();
newContact["Title"] = "Pialorsi";
newContact["First Name"] = "Paolo";
newContact["Email"] = "paolo@devleap.it";

newContact.Update();

In questo caso l’accesso all’istanza di SPWeb avviene tramite il metodo OpenWeb() dell’oggetto SPSite. Di fatto questo metodo, se invocato nel suo overload senza parametri, restituisce l’istanza di SPWeb corrispondente al sito web radice della Site Collection corrente. Sottolineo il fatto che l’elemento deve prima di tutto essere aggiunto alla lista, tramite il metodo Add() della collezione di Items, quindi solo dopo aver valorizzato i suoi campi può essere salvato, chiamandone il metodo Update(), già visto in precedenza.

Nel prossimo estratto di codice invece si crea, completamente da zero, una lista di clienti, con titoli “Clienti”, in un portale di collaborazione SharePoint:

SPWeb web = SPControl.GetContextWeb(Context);
Guid newListId = web.Lists.Add("Clienti", "Lista Clienti", SPListTemplateType.Contacts);
Response.Write(String.Format("List {0} created.", web.Lists[newListId].Title));

La lista viene aggiunta, come accadeva per gli SPListItem, alla collezione delle Lists del SPWeb. Il risultato del metodo di Add(...) è il GUID che identifica univocamente in SharePoint la lista appena creata. Come si vede il tipo di lista è ottenuto tramite una enumerazione di tipologie predefinite (SPListTemplateType). In realtà è anche possibile utilizzare template di liste personalizzati, per creare da codice N istanze di liste secondo modelli proprietari. Non soffermiamoci oltre su aspetti di dettaglio in un articolo introduttivo come questo.

Gestire file e documenti

Uno degli aspetti più interessanti e rivoluzionari di SharePoint è il fatto che è possibile utilizzare portali e soluzioni SharePoint come valide alternative a sistemi di file sharing tradizionali. Le soluzioni di archiviazione documentale basate su WSS3/MOSS2007 sono gestibili non solo attraverso l’interfaccia utente di SharePoint, Microsoft Office e Windows Explorer, ma anche attraverso l’Object Model. Ogni lista di documenti, dal punto di vista di SharePoint, è innanzitutto una SPList, specializzata nel tipo SPDocumentLibrary. In pratica ogni SPDocumentLibrary non è altro che una classe, derivata da SPList, che specializza alcuni dei suoi comportamenti e funzionalità. Mentre gli elementi di una SPList tradizionale sono oggetti di tipo SPListItem, i documenti all’interno di una SPDocumentLibrary sono oggetti di tipo SPFile. A ciascun SPFile corrisponde però anche un SPListItem che rappresenta il contenitore di meta-informazioni legate al singolo file (autore, data di upload, versione, ecc. e campi personalizzati).

Di seguito è riportato un esempio di codice per leggere i file presenti in una document library:

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;
Console.WriteLine("\n\tHere are the Files in the SPDocumentLibrary:");
foreach (SPFile file in doclib.RootFolder.Files)
{
Console.WriteLine("\tTitle: {0}\n\tUrl: {1}\n\tAuthor: {2}",
file.Title, file.Url, file.Author.Name);
}

Qualora si voglia estrarre da SharePoint il contenuto binario di un file, è possibile accedervi tramite un oggetto di tipo System.IO.Stream, nel modo seguente:

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();

SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;

SPFile fileInstance = doclib.RootFolder.Files["Notes.txt"];

Stream fileStream = fileInstance.OpenBinaryStream();

using (StreamReader sr = new StreamReader(fileStream))

{

String data = sr.ReadToEnd();

Console.WriteLine(data);

}

Anche il salvataggio di un file in una cartella documenti è un’operazione abbastanza banale:

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;
String fileContentAsText = "Sample document content!";
Byte[] fileContent = Encoding.Unicode.GetBytes(fileContentAsText);
SPFile fileUploaded = doclib.RootFolder.Files.Add("sample.txt", fileContent);
fileUploaded.Item["Title"] = "Sample Document";
fileUploaded.Item.Update();
fileUploaded.Update();

Come si vede possiamo scrivere il contenuto del file sotto forma di array di Byte, oppure anche come Stream sfruttando un overload differente del metodo Add(...) della lista di Files corrente. Ogni SPFile prevede poi una proprietà di nome Item che corrisponde al SPListItem sottostante. Ogni lista di documenti infatti è prima di tutto una lista di SPListItem, che hanno però una serie di caratteristiche in più finalizzate a descrivere il file rappresentato. Nuovamente si sottolinea l’importanza dell’invocazione del metodo Update() sul SPFile e sul SPListItem sottostante.

Un’altra attività abbastanza semplice e ricorrente è il check-in/check-out dei documenti da modello ad oggetti. SharePoint consente infatti di gestire politiche di accesso concorrente ai documenti, sfruttando regole di check-out esclusivo dei file e di check-in al termine delle attività di modifica. Ecco un esempio di codice in grado di prendere un documento, farne il check-out e successivamente il check-in, il tutto da Object Model.

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;
String fileContentAsText = "Sample document content!";
Byte[] fileContent = Encoding.Unicode.GetBytes(fileContentAsText);
SPFile fileUploaded = doclib.RootFolder.Files.Add("sample.txt", fileContent);
fileUploaded.Item["Title"] = "Sample Document";
fileUploaded.Item.Update();
fileUploaded.Update();
fileUploaded.CheckOut();
Stream fileStream = fileUploaded.OpenBinaryStream();
using (StreamReader sr = new StreamReader(fileStream))
{
String data = sr.ReadToEnd();
data = data.ToUpper();
fileUploaded.SaveBinary(Encoding.Unicode.GetBytes(data));
}
fileUploaded.Update();
fileUploaded.CheckIn("Upper case done.");

I metodi più importanti di questo esempio sono CheckOut() e CheckIn(...), dove il nome indica già in modo inequivocabile lo scopo di ciascuno dei due. Volendo è anche possibile annullare un’operazione di check-out, invocando il metodo di UndoCheckOut().

Conclusioni

In questo articolo abbiamo “assaggiato” alcune delle potenzialità del modello ad oggetti di SharePoint. È importante ricordare che lo SharePoint Object Model è fruibile da qualsiasi postazione abbia SharePoint installato. Inoltre è fondamentale sottolineare che il codice che usa l’Object Model dall’interno di Web Part o controlli ASP.NET, deve essere autorizzato a farlo, tramite apposite configurazioni di Code Access Security (CAS), altrimenti il codice non sarà autorizzato a girare e non produrrà alcun effetto, anzi in alcune circostanze determinerà errori.

In articoli futuri approfondiremo alcuni di questi e altri temi relativi allo sviluppo per SharePoint, come per esempio la creazione di EventHandler e di Workflow personalizzati, l’utilizzo dei Web Service di SharePoint, per la gestione dei contenuti da remoto, e la configurazione della Code Access Security.

Riferimenti

[1] http://msdn.microsoft.com/sharepoint/
[2] http://msdn2.microsoft.com/en-us/library/bb530302.aspx
[3] http://msdn2.microsoft.com/en-us/library/bb530301.aspx
[4] http://msdn2.microsoft.com/en-us/library/bb153523.aspx

WCF Web Centric e Microsoft Search Server Express => 1 + 1 = 1000! :-)

paolo — Fri, 25 Apr 2008 13:52:34 GMT

Il nuovo Microsoft Search Server Express, di recente annunciato e rilasciato da Microsoft offre tra le sue funzionalità a mio modo di vedere più interessanti il "Federated Search" che consente di rivolgere le ricerche anche ad altri server (MSSX e non), sfruttando un paradigma basato su "connettori" che tra gli altri possono anche nativamente essere risultati in formato RSS 2.0/Atom 1.0, a fronte di richieste HTTP GET (REST), così come previsto dalla specifica OpenSearch.

Bene! Non vi viene in mente nulla?! :-)

Pensiamo a WCF Web Centric, che consente di esporre servizi WCF interrogabili via HTTP GET (in ottica REST) ottenendo risultati in formato POX (Plain Old XML) che possono anche essere Syndication (RSS 2.0 o Atom 1.0). Ebbene ecco che prende forma la possibilità di avere servizi di ricerca implementati con WCF (solo con .NET 3.5) federabili e richiamabili da MSSX 2008. Pensate ad un software gestionale che si rende ricercabile dalla Search Center di SharePoint ... senza nemmeno avere bisogno di BDC.

Non male! :-)

PS: A DevCon avremo una sessione dedicata a WCF Web Centric ... per chi volesse approfondire la cosa ci vediamo là.

WCF: Impostazioni predefinite, limiti configurati/configurabili, parametri che influenzano la scalabilità

paolo — Sun, 23 Mar 2008 17:54:30 GMT

Segnalo che ho appena pubblicato sul mio blog in inglese un post relativo a quanto in oggetto. Spero risulti utile.

STSDev Tool 1.2

paolo — Sun, 23 Mar 2008 14:47:03 GMT

Qualche giorno fa è stato aggiornato STSDev, come segnalato da David Mann. Si tratta di un tool molto utile per chi come me sviluppa personalizzazioni per SharePoint. In particolare è interessante la possibilità, di recente aggiunta, di generare modelli di activity e condition per SharePoint Designer. Qui il download. Da non sottovalutare il fatto che supporti anche Visual Studio 2008, dove ad oggi le Extension for WSS sono ancora assenti.

Libri che consiglio a proposito di SharePoint (per DEV)

paolo — Fri, 14 Mar 2008 14:44:35 GMT

Stimolato dalla richiesta di un amico, ecco la mia lista personale di libri che consiglio di leggere per diventare programmatori SharePoint:

Professional SharePoint 2007 Development - Wrox
http://www.wrox.com/WileyCDA/WroxTitle/productCd-0470117567.html

Developer's Guide to the Windows SharePoint Services v3 Platform - Charles River Media
by Todd C. Bleeker
http://www.charlesriver.com/Books/BookDetail.aspx?productID=149744

Inside Microsoft Windows SharePoint Services 3.0 - Microsoft Press
by T. Pattison, D. Larson
http://www.microsoft.com/mspress/books/9692.aspx

Inside Microsoft Office SharePoint Server 2007 - Microsoft Press
by P. Tisseghem
http://www.microsoft.com/mspress/books/10472.aspx

Inside the Index and Search Engines: Microsoft® Office SharePoint® Server 2007 - Microsoft Press
by P. Tisseghem, L. Fastrup (Questo libro deve ancora uscire, ma gli autori e l'argomento lo rendono irrinunciabile!)
http://www.microsoft.com/MSPress/books/12195.aspx

Credo che sia importante leggerli nell'ordine che ho indicato, anche se i primi due testi sono parzialmente in sovrapposizione. Dovendo scegliere tra i due iniziali prenderei il libro di Todd C. Bleeker.

OBA Composition Reference Toolkit

paolo — Thu, 06 Mar 2008 19:14:23 GMT

Oggi ho seguito una sessione in cui è stato presentato il nuovo OBA Composition Reference Toolkit.

Si tratta di un progetto che potrebbe avere del potenziale, soprattutto considerando che:

consente ai non tecnici di definire soluzioni OBA da un designer (realizzato in WPF) e farne poi il provisioning automatizzato
è un prodotto estendibile da noi programmatori che possiamo/potremo creare componenti custom utilizzabili nel designer
prevede un'infrastruttura di sicurezza per gestire chi può fare cose nella definizione delle soluzioni OBA
la prossima refresh di aprile 2008 sarà fornita con "shared source" su CodePlex
ha già una serie di componenti per collegarsi a BDC via SOAP e per "pluggare" componenti di estensione realizzati con VSTO

Sicuramente da tenere d'occhio ...

Paolo Pialorsi

Microsoft SharePoint Conference 2008: 2 e 3 ottobre 2008 a Milano!

SharePoint Workflow: due articoli utili

VSeWSS v1.2: prime prove

VSeWSS v1.2: eccolo!

Programming LINQ a TechEd e ... "The pen is on the table" :-)

Parallel Extensions for .NET: June 2008 CTP

Visual Studio 2008 Extensions for Windows SharePoint Services

Un nuovo LINQ Query Provider: LINQ4SP

.NET 3.5 e Visual Studio 2008 SP1 - Beta

SharePoint Object Model

Sviluppare soluzioni SharePoint

SharePoint Object Model

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri(http://moss2007dev:9501/));
webApplication.IisSettings[SPUrlZone.Default].AllowAnonymous = true;
webApplication.Update();

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri("http://moss2007dev:9501/"));

SPSite site = SPControl.GetContextSite(Context);
SPWeb web = SPControl.GetContextWeb(Context);

Lavorare con le liste

SPWeb web = SPControl.GetContextWeb(Context);
SPList listContacts = web.Lists["Contacts"];
foreach (SPListItem contact in listContacts.Items)
{
Respone.Write(String.Format("Last Name: {0} - EMail: {1}",
contact["Title"], contact["Email"]));
}

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPList listContacts = web.Lists["Contacts"];
SPListItem newContact = listContacts.Items.Add();
newContact["Title"] = "Pialorsi";
newContact["First Name"] = "Paolo";
newContact["Email"] = "paolo@devleap.it";

newContact.Update();

SPWeb web = SPControl.GetContextWeb(Context);
Guid newListId = web.Lists.Add("Clienti", "Lista Clienti", SPListTemplateType.Contacts);
Response.Write(String.Format("List {0} created.", web.Lists[newListId].Title));

Gestire file e documenti

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();

SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;

SPFile fileInstance = doclib.RootFolder.Files["Notes.txt"];

Stream fileStream = fileInstance.OpenBinaryStream();

using (StreamReader sr = new StreamReader(fileStream))

{

String data = sr.ReadToEnd();

Console.WriteLine(data);

}

Conclusioni

Riferimenti

WCF Web Centric e Microsoft Search Server Express => 1 + 1 = 1000! :-)

WCF: Impostazioni predefinite, limiti configurati/configurabili, parametri che influenzano la scalabilità

STSDev Tool 1.2

Libri che consiglio a proposito di SharePoint (per DEV)

OBA Composition Reference Toolkit

Paolo Pialorsi

Microsoft SharePoint Conference 2008: 2 e 3 ottobre 2008 a Milano!

SharePoint Workflow: due articoli utili

VSeWSS v1.2: prime prove

VSeWSS v1.2: eccolo!

Programming LINQ a TechEd e ... "The pen is on the table" :-)

Parallel Extensions for .NET: June 2008 CTP

Visual Studio 2008 Extensions for Windows SharePoint Services

Un nuovo LINQ Query Provider: LINQ4SP

.NET 3.5 e Visual Studio 2008 SP1 - Beta

SharePoint Object Model

Sviluppare soluzioni SharePoint

SharePoint Object Model

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri(http://moss2007dev:9501/));webApplication.IisSettings[SPUrlZone.Default].AllowAnonymous = true;webApplication.Update();

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri("http://moss2007dev:9501/"));

SPSite site = SPControl.GetContextSite(Context); SPWeb web = SPControl.GetContextWeb(Context);

Lavorare con le liste

SPWeb web = SPControl.GetContextWeb(Context);SPList listContacts = web.Lists["Contacts"];foreach (SPListItem contact in listContacts.Items){ Respone.Write(String.Format("Last Name: {0} - EMail: {1}", contact["Title"], contact["Email"]));}

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();SPList listContacts = web.Lists["Contacts"];SPListItem newContact = listContacts.Items.Add();newContact["Title"] = "Pialorsi";newContact["First Name"] = "Paolo";newContact["Email"] = "paolo@devleap.it";

newContact.Update();

SPWeb web = SPControl.GetContextWeb(Context);Guid newListId = web.Lists.Add("Clienti", "Lista Clienti", SPListTemplateType.Contacts);Response.Write(String.Format("List {0} created.", web.Lists[newListId].Title));

Gestire file e documenti

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();

SPDocumentLibrary doclib = web.Lists["Shared Documents"] as SPDocumentLibrary;

SPFile fileInstance = doclib.RootFolder.Files["Notes.txt"];

Stream fileStream = fileInstance.OpenBinaryStream();

using (StreamReader sr = new StreamReader(fileStream))

{

String data = sr.ReadToEnd();

Console.WriteLine(data);

}

Conclusioni

Riferimenti

WCF Web Centric e Microsoft Search Server Express => 1 + 1 = 1000! :-)

WCF: Impostazioni predefinite, limiti configurati/configurabili, parametri che influenzano la scalabilità

STSDev Tool 1.2

Libri che consiglio a proposito di SharePoint (per DEV)

OBA Composition Reference Toolkit

SPWebApplication webApplication = SPWebApplication.Lookup(new Uri(http://moss2007dev:9501/));
webApplication.IisSettings[SPUrlZone.Default].AllowAnonymous = true;
webApplication.Update();

SPSite site = SPControl.GetContextSite(Context);
SPWeb web = SPControl.GetContextWeb(Context);

SPWeb web = SPControl.GetContextWeb(Context);
SPList listContacts = web.Lists["Contacts"];
foreach (SPListItem contact in listContacts.Items)
{
Respone.Write(String.Format("Last Name: {0} - EMail: {1}",
contact["Title"], contact["Email"]));
}

SPWeb web = new SPSite("http://moss2007dev/").OpenWeb();
SPList listContacts = web.Lists["Contacts"];
SPListItem newContact = listContacts.Items.Add();
newContact["Title"] = "Pialorsi";
newContact["First Name"] = "Paolo";
newContact["Email"] = "paolo@devleap.it";

SPWeb web = SPControl.GetContextWeb(Context);
Guid newListId = web.Lists.Add("Clienti", "Lista Clienti", SPListTemplateType.Contacts);
Response.Write(String.Format("List {0} created.", web.Lists[newListId].Title));