Il primo passo per poter far funzionare il meccanismo è la definizione di una Secure Store Target Application, ovvero di un elemento che memorizza le credenziali di accesso al sistema esterno, al quale Sharepoint farà riferimento per evitare che vengano chieste all’utente che in quel momento visualizza i dati. E’ tuttavia possibile evitare questo passo, se si desidera che per l’accesso al database esterno vengano utilizzate le credenziali dell’utente connesso anzichè credenziali comuni.
La Secure Store Target Application si crea dalla Central Administration. Navigando nella sezione Application Management, e cliccando su Manage Service Applications sotto a Service Applications. Apparirà una schermata con la lista delle service applications, clicchiamo su Secure Store Service. A questo punto clicchiamo su Generate New Key nel ribbon, si apre una finestra che chiede di impostare una pass phrase, servirà per poter modificare la target application, va quindi appuntata da qualche parte (ma questo appunto è superfluo, no?).

A questo punto si può creare una nuova target application e compilare tutti i campi necessari, come da figura sotto. Come email mettiamo quella di un amministratore di sistema, mentre come Target Application Type in genere si mette Group, perchè in questo modo è possibile associare la target application a un gruppo di utenti.

Nel passaggio successivo è possibile quali campi associare alla target application, in genere sono sufficienti username e password: saranno poi valorizzati con le credenziali che dovranno impersonificare l’utente che si collega al database.

Ora bisogna specificare per quali utenti sarà disponibile questa target application, e quali sono gli utenti amministratori.

Ora che la target application è creata, non resta che settare le credenziali che utilizzerà per gli accessi al database esterno. Selezioniamo la target application dalla lista e premiamo il tasto set credential nel ribbon.

Si aprirà una finestra dove inserire username e password, questo utente deve ovviamente avere accesso ai dati sul database esterno al quale vorremo collegare le liste di Sharepoint.

Ora l’attività si sposta su Sharepoint Designer 2010, per impostare i contenuti esterni e creare le liste che puntano ad essi. La prima cosa da fare è definire un External Content Type: ovvero un contenuto esterno dal quale attingere. Dopo aver aperto un sito, bisogna andare sul menù External Content Type e tramite il comando ribbon crearne uno nuovo.

Diamo un nome al contenuto esterno e clicchiamo sul link per impostare la connessione verso il sistema esterno.

Ora bisogna cliccare sul tasto Add Connection per aggiungere una connessione.

Apparirà una serie di schermate dove compilare i dati per l’accesso al database esterno.

Selezionare come opzione di connessione Connect with Impersonated Custom Identity e mettere il nome della secure store application definita prima sulla Central Administration.

Premendo OK il sistema chiederà le credenziali, inserire quelle dell’utente definito come amministratore della secure store application ai passi precedenti. Una volta validata la connessione, nell’Operation Designer apparirà tra le connessioni disponibili anche quella appena impostata: si espande l’albero per trovare la tabella o la vista contenente i dati che dovranno popolare la lista esterna di Sharepoint.

Una volta individuata, cliccando col tasto destro sulla tabella o sulla lista, è possibile generare le operazioni che servono (lettura, modifica, cancellazione, ecc..). E’ possibile crearle tutte assieme, cliccando su Create All Operation. Nelle finestre successive dovremo dare un nome alle operazioni, si potranno settare filtri e sarà necessario marcare almeno un campo come identifier (ID di lista).

I filtri sono necessari per limitare il numero di record restituiti: di default è 2000 e a volte questo valore potrebbe non essere sufficiente, causando errore nella visualizzazione della lista tramite il browser sul sito Sharepoint.

Per l’operazione Read List, conviene settare qualche campo per la visualizzazione nel picker, altrimenti di default saranno visualizzati tutti e lato utente questa cosa risulta scomoda.

andando su List and Libraries, nei ribbon appare il comando Elenco Esterno.

Per chi volesse approfondire:

http://blog.concurrency.com/sharepoint/accessing-external-data-using-business-connectivity-services-in-sharepoint-2010/

Riporto qualce appunto per installare senza problemi la piattaforma Apache+MySQL+php, così da avere in locale un server dove testare e sviluppare le proprie applicazioni (come wordpress o joomla).

Installazione Apache Server 2.2.6

Installare Apache è stato piuttosto semplice. Ecco i passi da seguire:

1. Scaricare l’installer (MSI) per Windows dal sito di Apache HTTP Server
2. Disattivare il controllo UAC: Su Vista: start -> pannello di controllo -> Account Utente e protezione per la famiglia -> Account Utente -> Attiva o disattiva controllo account utente [tra parentesi questa cosa vi libererà delle fastidiosissime finestrelle "consenti" che appaiono dopo ogni clic]Su Windows 7:  start -> pannello di controllo -> Account Utente -> Account Utente -> Modifica le impostazioni di controllo dell’account utente -> Impostare su Nessuna Notifica
3. Lanciare l’installer appena scaricato e seguire le istruzioni, come Network Domain e Server Name possiamo mettere “localhost” (se l’installazione avviene in locale) e come porta scegliere 80.
4. Ora è possibile configurare Apache Server, aprendo il file “C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf” con un editor di testo.La cosa principale da fare è indicare la cartella dove vengono salvate le nostre pagine web per poi renderle accessibili via browser grazie al server. La cartella di default è /htdocs/, si trova all’interno di quella dove abbiamo installato Apache.Se vogliamo cambiarla è sufficiente trovare il paramentro “DocumentRoot” e modificarlo come segue:#
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "C:/www"

   C:/www/ in questo caso è la cartella dove andremo a posizionarele pagine web e tutti i file annessi.

5. Lo stesso percorso va riportato sotto, in questo modo:#
# This should be changed to whatever you set DocumentRoot to.
#
<Directory "C:/www">
6. Salvare e riavviare il server.
7. Se dovessero presentari problemi in fase di avvio del server, per prima cosa controllare l’application log di windows; se dovessero mancare delle dll può tornare utile questa pagina: http://windows.php.net/download/
   Un’altra operazione da fare è settare anche questi due ulteriori parametri sul file di configurazione come da testo sotto:
   # ServerName gives the name and port that the server uses to identify itself.
# This can often be determined automatically, but we recommend you specify
# it explicitly to prevent problems during startup.
#
# If your host doesn't have a registered DNS name, enter its IP address here.
#
ServerName localhost:80
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
#
# Change this to Listen on specific IP addresses as shown below to
# prevent Apache from glomming onto all bound IP addresses.
#
Listen 127.0.0.1:80

Il problema all’avvio dell’icona Apache Monitor nella systray con Windows Vista – risoluzione

Una volta installato il server è sufficiente digitare l’indirizzo “http://localhost/” nella barra degli indirizzi del browser per capire se tutto funziona. Su Windows XP però eravamo abituati all’iconcina con la piuma dalla quale era possibile avviare o stoppare il server apache.

Con Vista questa icona non c’è più, inoltre un fastidioso problema all’avvio ci accoglie perchè Apache Monitor non riesce a caricarsi correttamente. Per risolvere l’inconveniente basta andare nella cartella di installazione di Apache Server, entrare nella cartella /bin/ e cliccare col tasto destro sul file ApacheMonitor.exe, da qui clic su Proprietà. In alto selezionare la tab “Compatibilità” e spuntare l’opzione “Esegui il programma in modalità compatibile per Windows XP (Service Pack 2)”. Vedi figure sottostanti.

Installazione MySQL 5.0

MySQL è un server per database relazionali open source, ormai affermato e robusto, soprattutto in ambito web. Per l’installazione è necessario:

1. Scaricare dal sito ufficiale l’installer per windows.
2. Lanciare l’installer e seguire le istruzioni a video, scegliendo l’installazione Typical.
3. Alla fine dell’installazione scegliere di configurare il server.
4. Scegliamo l’opzione “Detailed Configuration“



5. Impostare la tipologia come “Developer Machine” (il server sarà infatti utilizzato principalmente per i nostri test in locale)



6. Al passaggio successivo selezionare “Multifunctional Database“



7. Lasciare invariato al punto successivo e proseguire, a meno che non si voglia specificare una directory particolare per InnoDB
8. Come numero approssimativo di connessioni al server possiamo specificare 20. Più che sufficienti se lo utilizziamo come server di test.



9. Al passaggio successivo selezionare entrambe le opzioni, è poi possibile specificare la porta di connessione al database: generalmente la 3306



10. Come impostazioni dei caratteri scegliere “Best support for Multilingualism“



11. Se vogliamo cheMySQL si avvii in automatico all’accensione di windows selezionare “Install as Windows Service” e “Launch the MySQL server automatically“.



12. Indicare la password per l’utente amministratore (root) ed eventualmente creare un utente anonimo (anche se sarebbe meglio evitare, è poco sicuro)



13. Per l’amministrazione del Database installare MySQL Workbench. Si tratta di utili strumenti per la gestione “visiva” del server, degli utenti, dei permessi e dei database. Comprende inoltre il Query Browser per lanciare le query SQL.

Installazione php 5 sul server Apache

Con l’installazione di php e delle estensioni per la connessione al database avremo completato l’opera. In questo caso è meglio eseguire una installazione manuale. Come riportato nella Guida php su Windows di HTML.it:

Questa installazione, consigliata dal manuale ufficiale Php, ha il vantaggio di non richiedere lo spostamento di file nelle directory di sistema (Windows, System32 e altre): infatti modificando la sola variabile di sistema PATH e mantenenedo i file in c:\php, tutto rimane più ordinato e l’aggiornamento diventa molto più semplice.

Ecco i passi da seguire:

1. Scaricare il pacchetto zip dal sito ufficiale
2. Estrarre i files nella cartella C:/php/ (il nome breve è più comodo)
3. Aprire Pannello di Controllo -> Sistema e Sicurezza (Sistema e Manutenzione su Vista) -> Sistema. Nella barra di sinistra cliccare su “Proprietà di Sistema avanzate” (Vista) o su “Impostazioni avanzate di sistema” (Windows 7), poi sul tasto “Variabili d’ambiente..“.Dalla tendina sotto (variabili di sistema) selezionare “Path” e cliccare su “Modifica”. In fondo al testo già presente aggiungere la stringa “;C:\php” (con il punto e virgola, senza gli apici).

   In questo modo abbiamo indicato al sistema dove si trova l’interprete php.

4. Riavviare windows
5. Ora è necessario integrare l’interprete php nel server Apache. Per farlo bisogna aprire il file di configurazione di Apache: “C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf”C’è una lunga lista di “LoadModule” (molti di questi sono commentati) alla fine della quale bisogna aggiungere queste righe:# Start Php integrationLoadModule php5_module "C:/php/php5apache2_2.dll"

   AddType application/x-httpd-php .php

   PhpIniDir "C:/php"

   # End Php integration

6. Infine modifichiamo il parametro DirectoryIndex come segue:#
# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
<IfModule dir_module>
DirectoryIndex index.html index.php
</IfModule>

7. Ora andiamo nella directory di php e rinominiamo il file “php.ini-development” in “php.ini“.Si tratta del file di configurazione dell’interprete php. Apriamolo con un editor di testo.
8. Cambiamo il parametro “extension_dir” come segue:; Directory in which the loadable extensions (modules) reside. extension_dir = "C:/php/ext"
9. Settare il parametro “display_errors” su On per poter vedere gli errori generati dagli script che svilupperemo
10. Infine decommentare (togliendo il punto e virgola davanti) il parametro “session.save_path” e moficarlo come segue:session.save_path = "C:/php/sessionfiles"


    sessionfiles è una cartella da creare, dove verranno salvati i file relativi alle sessioni di php.

11. Ora dovremo attivare i connettori php-MySQL (maggiori info nella pagina dei download dal sito ufficiale di MySQL). Si tratta di file dll che permettono la connessione da parte di php al database: mysqli e mysql
12. Assicurarsi che siano presenti i file php_mysql.dll e php_mysqli.dll nella cartella /ext/ di php (dove ci sono le estensioni)
13. Ora nel file php.ini aperto in precedenza decommentare (togliendo il ; ad inizio riga) le estensioni di mysql come segue:extension=php_mysql.dll
extension=php_mysqli.dll

14. Altra estensione utile è quella per la gestione delle immagini, che conviene decommentare:extension=php_gd2.dll
15. A questo punto salvare tutto, riavviare il server Apache e tutto dovrebbe funzionare.

Per essere sicuri possiamo creare un file “index.php” con all’interno il semplice codice

<?php phpinfo() ; ?>


Aprire il browser e digitare l’indirizzo: “http://localhost/index.php” Se tutto è stato eseguito correttamente dovremmo vedere una pagina che riporta diverse informazioni sulla versione di php installata.

Si noti che questo semplice test non ci dà informazioni sulla corretta installazione delle estensioni per la connessione al database, che dovremo testare in un secondo momento, magari provando l’installazione in locale di un cms come wordpress.

Anche su Windows Vista e Windows 7 gira, buon lavoro. :)

In questo piccolo tutorial vengono realizzate cinque semplici pagine:

1. registrazione.html
2. registra.jsp
3. login.html
4. login.jsp
5. logout.jsp

Tutte le operazioni di inserimento e le interrogazioni al database vengono effettuate dal bean UtentiBean.java. Potete scaricare il file con gli esempi direttamente qui.

La prima operazione da fare è il caricamento dei files nella cartella webapps di Tomcat. Per funzionare correttamente il nome della cartella che contiene tutti i files deve essere “diplod”, se vuoi cambiare il nome alla tua cartella ricordati di farlo anche nelle pagine jsp che si connettono al database, ovvero “registra.jsp” e “login.jsp”. Puoi cambiare nome pure al database, purchè lo modifichi anche nella stringa che si connette ad esso. Queste semplici pagine sono state testate su Tomcat versione 5.5, per funzionare sulla versione 4 bisogna cambiare la stringa di collegamento al database e impostare i permessi di accesso ad esso dal pannello di controllo di windows (strumenti di amministrazione, origine dati ODBC). In amministrazione dati scegliere “Database di Microsoft Access” e cliccare su Aggiungi.

Selezionare “Driver do Microsoft Access (*.mdb)”

Selezionare il database nella sua posizione e assegnarli un nome univoco, che sarà poi quello utilizzato nella stringa di collegamento.

Vediamo ora nel dettaglio il contenuto delle pagine:

La pagina “registrazione.html” contiene un semplice form di inserimento dati, per il quale evito di riportare il codice.

La pagina “registra.jsp” contiene invece il codice per processare i parametri ricevuti e invocare il metodo di salvataggio del bean. Se infatti l’utente ha inviato i dati, questi vengono salvati in stringhe e successivamente impostati sul bean tramite i metodi setNomeVar(). Successivamente viene invocato il metodo salvaUtente(), che restituisce valore vero nel caso l’inserimento dei dati sul database vada a buon fine.

NB: in grassetto è evidenziata la stringa di connessione al database, se non avete modificato i nomi della cartella e del database e state utilizzando Tomcat 5.5 si può lasciare invariata, altrimenti va modificata opportunamente con il giusto percorso. Se invece state utilizzando Tomcat 4 va sostituito tutto il blocco di bean.setDbUrl(…..); con questo blocco: bean.setDbUrl(“jdbc:odbc:nomeDelTuoDatabase”); dove al posto di nomeDelTuoDatabase bisogna riportare il nome univoco dato al database dal pannello di controllo di windows.

Questo il codice della pagina:
<%@page language="java"%>
<jsp:useBean id="bean" scope="page"
class="beans.UtentiBean"/>
<% if (request.getParameter("invio")!=null) {
bean.setDbUrl("jdbc:odbc:Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:/Programmi/Apache Software Foundation/Tomcat 5.5/webapps/diplod/diplod.mdb");
bean.connect();
String nome = request.getParameter("nome");
String cognome = request.getParameter("cognome");
String username = request.getParameter("username");
String password = request.getParameter("password");
String email = request.getParameter("email");
String hobby = request.getParameter("hobby");
bean.setNome(nome);
bean.setCognome(cognome);
bean.setUsername(username);
bean.setPassword(password);
bean.setEmail(email);
bean.setHobby(hobby);
} %>
<% //salvataggio utente
boolean salvataggio = false;
salvataggio = bean.salvaUtente();
if (salvataggio==true) { %>
<h1>Conferma registrazione</h1>
<p>La tua registrazione è avvenuta correttamente.</p>
<p>Questi sono i tuoi dati: <br/>
Il tuo nome:<%=bean.getNome()%><br/>
Il tuo cognome:<%=bean.getCognome()%><br/>
La tua email:<%=bean.getEmail()%><br/>
Il tuo username:<%=bean.getUsername()%><br/>
La tua password:<%=bean.getPassword()%><br/>
Il tuo hobby:<%=bean.getHobby()%><br/>
</p>
<% } else { %>
<h1>Errore!</h1>
<p>La tua registrazioneb non è avvenuta correttamente.</p>
<p>Forse hai scelto un nome utente già presente o non hai compilato correttamente alcuni campi! Torna a <a
xhref="registrazione.html" mce_href="registrazione.html" >registrazione</a>.</p>
Motivo dell'errore: <br/>
<%=bean.getMsgErrore()%>
<% }
bean.disconnect(); %>

La pagina login.html è un’altra semplice pagina statica che contiene il form per il login.

La pagina login.jsp gestisce il primo login e la sessione dell’utente. A differenza della pagina jsp per la registrazione, lo scope del bean è infatti settato a “session”, ovvero i dati relativi all’utente vengono tenuti in memoria dal server per tutta la durata del collegamento, fino al logout. Anche in questo caso è necessario tenere presente degli accorgimenti sulla stringa di connessione al database illustrati precedentemente.

Come si vede dal codice, la pagina imposta i dati dati solo se sono stati effettivamente inviati dal form, per poi invocare il metodo loginUtente() del bean. Questo metodo, nel caso l’utente sia presente nel database, imposta a true una variabile booleana. Il suo valore viene recuperato poi dalla jsp tramite il metodo getAuth(), per controllare se l’utente ha effettuato positivamente il login. Questo metodo potrebbe essere invocato da tutte le pagine sicure del nostro sito, quelle alle quali si può accedere solo dopo il login.

Se il login non è andato a buon fine, al posto del menù di navigazione viene restituito un messaggio di cortesia all’utente.

Ecco il codice della pagina:

<%@page language="java"%>
<jsp:useBean id="bean" scope="session"
class="beans.UtentiBean"/>
<%
//se l'utente ha compilato il form per il login
if (request.getParameter("invio")!=null) {
bean.setDbUrl("jdbc:odbc:Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:/Programmi/Apache Software Foundation/Tomcat
5.5/webapps/diplod/diplod.mdb");
bean.connect();
String username = request.getParameter("username");
String password = request.getParameter("password");
bean.setUsername(username);
bean.setPassword(password);
bean.loginUtente();
}
//controllo l'esito del login
if (bean.getAuth()) { %>
<h1>Benvenuto nel sito <%=bean.getNome()%> <%=bean.getCognome()%></h1>
<p>Questo è il menù di navigazione.</p>
<ul>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 1</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 2</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 3</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 4</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 5</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 6</a></li>
</ul>
<a xhref="logout.jsp" mce_href="logout.jsp" >Logout</a>
<% } else { %>
<h1>Errore!</h1>
<p>Nome utente o password non corretti.</p>
<p>se ancora non sei registrato vai a <a xhref="registrazione.html" mce_href="registrazione.html" >registrazione</a> altrimenti <a xhref="login.html" mce_href="login.html" >ritenta il login</a>.</p>
Motivo dell'errore: <br/>
<%=bean.getMsgErrore()%>
<% }
bean.disconnect(); %>

La pagina logout.jsp non fa altro che invocare il metodo logout() del bean. Tale metodo torna a settare a false la variabile auth, in questo modo l’accesso alle pagine protette non sarà più possibile.

Per il codice del bean, si faccia riferimento direttamente al file UtentiBean.java, il codice è commentato per una più facile comprensione. La composizione delle stringhe per le query sql, così come la gestione delle statement sono volutamente semplificate per risultare di più facile comprensione, ma probabilmente non sono il modo migliore per interrogare un database ed eseguire operazioni sql.

Giusto a titolo informativo, si riporta un metodo più professionale per interrogare un database (in questo caso MySql).

PreparedStatement stmt = null;
ResultSet rs = null;
Connection cn=null;
try{
Class.forName("com.mysql.jdbc.Driver");
cn = DriverManager.getConnection("jdbc:mysql://localhost/database?user=XXXX&password=XXXXX");
String sql="SELECT * FROM tabella WHERE user=? AND password=?";
stmt = cn.prepareStatement(sql);
stmt.setString(1,user);
stmt.setString(2,password);
rs = stmt.executeQuery();
if (rs.next()) { ..........

Spero che questo piccolo tutorial possa essere utile. Quando ho iniziato a studiare la tecnologia server-side di java ero un po’ spaesato, e nonostante diverse ricerche tra forum e manuali non sono mai riuscito a trovare una semplice guida per la gestione degli utenti con un database access. Certo non è il miglior database da utilizzare se vogliamo creare un sito web, ma cambiando solo pochissime righe di codice si può utilizzare questa applicazione ugualmente con MySQL.

Se avete suggerimenti, se trovate qualcosa di incorretto, lasciate un commento a questo post.