Il prerequisito di base è che la function abbia alcune proprietà basilari: “Modulo accessibile in remoto”, vedi figura dalla transazione SE37.

Per pubblicarla come servizio web, basta andare da menu, sempre nella SE37: Utilities -> Altre Utilities -> Generare servizio web -> Dal function module (vedi figura)

Bisognerà poi seguire il wizard come da figure sotto, dando un nome al web service.

Per pubblicare senza richiesta di autenticazione, selezionare come da figura sottostante:

Scegliere il pacchetto e la richiesta di trasporto.

Cliccare su “completare”, si aprirà la maschera di creazione del servizio e resterà solamente da attivare il servizio (con l’icona di attivazione).

Ora bisognerà terminare il lavoro dalla transazione SOAMANAGER (introdotta con l’ECC 6).
Si aprirà una finestra del browser, da qui bisogna andare su “Web service configuration”

Da qui è possibile ricercare il web service appena creato, selezionarlo, premere “apply selection” e andare sulla tab “configuration”

Qui bisogna creare un nuovo servizio.

Bisogna inserire un nome per il servizio e per il binding, poi premere “Apply Settings”

Sotto si aprire una maschera con le impostazioni del servizio, bisognerà configurarle. Se ad esempio si vuole impostare un utenza fissa, in modo tale che le applicazioni esterne chiamino il servizio senza autenticarsi ogni volta, si può configurare come in figura sotto. Alla fine premere “Save”.

A questo punto è tutto pronto.

Bisognerà premere su “Open WSDL document for selected binding or service” per ottenere l’url della definizione del web service, da utilizzare ad esempio su SOAP UI per poter consumare il web service e testarlo.

E se un giorno volessimo ripubblicare il servizio dopo aver cambiato la function?

Magari viene aggiunto un parametro di input/output, il web service non recepirà queste modifiche finchè non lo torniamo a pubblicare. Per fare ciò, da SAP, dobbiamo accedere alla transazione SE80. Selezionare il pacchetto in cui è stata salvata la function e poi selezionare il proprio servizio web sotto “Enterprise Service -> Service Provider”. Andare in modifica e da menù come da immagine sottostante.

Salvare e attivare.

Ora il web service avrà ereditato le modifiche.

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/

Ecco allora un po’ di documentazione per chi volesse cimentarsi in queste affascinanti integrazioni. Io ci sono in mezzo, attualmente non ho La Soluzione, ma una vaga idea me la sono fatta. Credo che l’integrazione perfetta, quella dove l’utente non percepisce differenze, sia difficile ma realizzabile. Già il semplice fatto che entrambi i sistemi supportano il Single Sign On e pescano le credenziali di accesso dall’active directory migliora sensibilmente l’esperienza di navigazione. Non credo però sia un bene, lato amministratore, costruire un forte accoppiamento. Si tratta comunque di sistemi in evoluzione (stiamo parlando di portali e non di software gestionali), ritengo quindi più conveniente mantenere una certa separazione, evitando di caricare viste di Sharepoint su SAP Portal o viceversa pescare dati da SAP per pubblicarli in sharepoint.

SAP è il mondo della documentazione definitiva, dei dati da archivio; sharepoint è il mondo della documentazione viva, delle discussioni, della community.
Qualcuno ci ha lavorato? Qualcuno l’ha vissuta diversamente?

Come promesso, ecco un buon elenco di materiale dal quale partire:

• Interoperability between SAP NetWeaver Portal and Microsoft SharePoint Technologies
  http://download.microsoft.com/download/b/c/1/bc1939d9-638f-4053-b602-4258f18bb683/CB_045_Interoperability%20between%20SAP%20NetWeaver%20Portal%20and%20Microsoft%20SharePoint%20Server%202007.pdf
• Interoperability between SAP NetWeaver Portal and Microsoft SharePoint Portal Server
  https://www.sdn.sap.com/irj/sdn/dotnet?rid=/webcontent/uuid/f735eb47-0a01-0010-6286-fd089bc952e3
• Integration of SAP Business Server Pages (SAP BSP) in Share Point 2007
  http://download.microsoft.com/download/4/3/d/43de0f43-df6a-4cf2-8c91-2c9001df5945/cb_027_integration_of_sap_bsp_into_sharepoint_server_2007.pdf
• Integrating Microsoft® Office SharePoint® Server 2007 and SAP
  http://download.microsoft.com/download/9/9/5/99583191-9cd2-4701-9ef1-47715b73cffe/CB_028_Integrating_Microsoft_Office_SharePoint_Server_and_SAP.pdf
• Consuming SAP Enterprise Services in a Microsoft Office InfoPath Form
  https://www.sdn.sap.com/irj/scn/go/portal/prtroot/docs/library/uuid/e0421f9a-4c9e-2910-1085-a45f8e813324
• Interoperability between Microsoft Office SharePoint Server and SAP Enterprise Portal [il caso Siemens]
  http://www.sharepointusergroup.at/info/Dokumente/Sharepoint_and_SAP_Real_World_final.pdf