440 likes | 635 Vues
Project 2003 Sviluppare Soluzioni EPM con Project Server (1/4). Massimiliano Bosco – Aliware – Torino – info@aliware.it. Finalità della sessione. Programmazione in Project 2003 Project Server 2003 Project Data Service (PDS) Integrazione applicazioni e connettori
E N D
Project 2003 SviluppareSoluzioniEPM conProject Server(1/4) Massimiliano Bosco – Aliware – Torino – info@aliware.it
Finalità della sessione • Programmazione in Project 2003 • Project Server 2003 • Project Data Service (PDS) • Integrazione applicazioni e connettori • Esempi sui meccanismi di scambio dati con SAP, Siebel, applicativi gestionali custom di terze parti, etc. • Analisi dati della raccolta di progetti (portfolio) • Ottimizzazione del processo di sviluppo con le nuove tecnologie (Web Service, XML, Visual Studio .NET)
Destinatari • Programmatori Office con esigenze di • condivisione dei dati di progetto in team • implementazione e/o migrazione a soluzioni client-server ed EPM • integrazione e sincronizzazione dati tra applicazioni eterogenee • Programmatori “classici” (VB, VBA, .NET) che sviluppano in client-server e devono integrare le loro applicazioni in Office
Prerequisiti • Conoscenze di base della piattaforma Microsoft Project 2002 professional e server • Conoscenza di base dei linguaggi di programmazione MS Visual Basic e Visual Basic .NET • Concetti di base in ambito database e SQL • Risulteranno utili l’esperienza nello sviluppo di applicazioni Web (ASP o ASP.NET) e la conoscenza di BizTalk server
Agenda • Parte 1: programmazione in ambito EPM • Alcune richieste tipiche • Soluzioni stand-alone, client-server, EPM • Architettura di Project Server 2003 • Project Data Service (PDS) • Esempio 1.1: utilizzo del PDS • Parte 2: architetture di connessione • Schema generale di un connettore • Esempio 2.1: importare le risorse con file XML • Parte 3: uso dei cubi OLAP e loro estensioni • Acquisizione dati da Sharepoint • Esempio 3.1: gestione rischi e problemi • Parte 4: estendere il PDS con codice gestito (.NET) • Schema generale di un’estensione PDS • Esempio 4.1: estensione PDS in C#
Strumenti • MS Project SDK 2003 go.microsoft.com/fwlink/?linkid=21722
Strumenti lato client • VBA: macro recorder, IDE (automazione task, add-in, integrazione con altre applicazioni Office, etc.) • Project Guide: guide e wizard personalizzabili dal programmatore con XML content definition, link a pagine HTML, script • OLE DB provider: accesso ai dati del progetto sul client o in project server • COM Add Ins: funzionalità aggiuntive e personalizzate richiamabili da menu (impl. VB o .NET)
Strumenti lato server • Project Data Service (PDS): API basata su XML per l’accesso a progetti, risorse, custom field,… • Servizio Enterprise Data Maintenance (EDM): sincronizzazione dati del PDS tramite messaggi SOAP/XML o file drop • Object Link Provider (OLP): interfaccia per collegare i dati di progetto e la gestione documentale (normalmente WSS) a cui ci si deve attenere nell’integrazione con gestori di terze parti per documenti, attività, eventi, etc. • Project Server Web Parts e URL options: personalizzazione delle pagine di PWA (nascondendo con le options o modificando le sezioni con le Web parts)
Alcune richieste tipiche • Sincronizzare elenchi di risorse • HR, Active Directory, fogli elettronici, DB, XML, etc. • Sincronizzare attività • Gestionali, ERP, schedulatori, etc. • Personalizzare report • Applicativi stand-alone, pagine ASP o ASP.NET • Esportazione dei dati • Testo, fogli elettronici, DB, XML • Business intelligence • Estensioni cubi OLAP per gestione rischi, problemi, calcolo valore della produzione, etc.
Risposte Microsoft Project Professional 2003 Microsoft Project Web Access Microsoft Office Outlook 2003 Microsoft Office Web Controls 2003 Line of Business Applications Client Tier • Microsoft Office Project Server 2003 • Project Data Services (PDS) • Windows Sharepoint Services • Session Manager • View Publishing • Exchange Server Microsoft Windows Server 2003 Family Windows 2000 Server Family Web Front End Services E-Mail Microsoft SQL Server 2000 Project Server Tables Project Web Tables SQL 2000 Analysis Services Database Tier
“Thin” Client XML Web service Client logic Business logic Data storage “Fat” Client 1-Tier (monolithic) 2-Tier 3-Tier N-Tier Internet Possibili architetture
Requisiti SW • Sistema operativo e server Web: • Windows Server 2003 (IIS 6.0) o Windows 2000 Server (IIS 5.0) • Windows SharePoint Services (WSS): • Project Server 2003 funziona solo con WSS – (non con SharePoint Team Services) • WSS richiedeWindows Server 2003 • In caso di aggiornamento occorre migrare da STS a WSS • Database: • SQL Server 2000 SP3 o MSDE 2000 SP3 • SQL Server 2000 Analysis Services se occorre • DTC (partizionando il DB SQL) • Visual Studio .NET, opp. SOAP Toolkit 2.0 o superiore • .NET Enterprise Servers (p. es. BizTalk) se occorre
Architettura SQL Server 2000 Internet Information Services WSS Database Windows Sharepoint Services Internet Explorer Project Web Access View Tables Project Server 2003 Core Oulook 2003 PWA Tables Session Management Service Project Data Tables View Processing Service Project Professional Scheduled Process Service SQL Analysis Server OLAP Cubes Client Application Database
Requisiti SWScelta del DB • SQL Server 2000 • Obbligatorio in ambienti di produzione • Consente prestazioni e scalabilità ottimali • Fornisce gli “Analysis Services” per generare report avanzati e cubi OLAP • MSDE • Non fornito con l’installazione • Non prevede la connessione agli “Analysis Services” e quindi non è possibile generare cubi e/o report avanzati • Ha delle limitazioni sul numero di batch T-SQL concorrenti e quindi in definitiva sul numero di utenti contemporanei
Project Data Service (PDS) • PDS è l’API di Project Server • Supporto per i metodi delle versioni precedenti • Due ruoli: • Servizio middle tier • ProjectsStatus: elenco progetti e informazioni base • ResourcesStatus: elenco risorse e stato • Security gatekeeping • ProjectsAccess: accesso al progetto e check out • ResourcesAccess: accesso a risorse e check out
XML, XSD, HTTP, SMTP • Implementati con standard Internet aperti SOAP • I consumatori spediscono e ricevono messaggi XML Web Services Description Language • Sono definiti in termini di formati e ordine di precedenza dei messaggi Discovery Document • W3C prevede che il sito offra un documento che descrive i servizi attivi UDDI • W3C ha standardizzato un insieme di criteri per pubblicazione e ricerca PDS e i Web Services • Componenti accessibili per mezzo di Internet anziché DCOM
Uso di PDS • Preliminarmente: • Scaricare la guida PDS Reference da MSDN • Installare Visual Studio .NET(oppure il SOAP Toolkit 3.0) • Da programma: • Effettuare il logon a PDS con UserID e password • Ottenere il security cookie • Preparare la richiesta XML • Inviare il flusso XML unito al security cookie • Ricevere la risposta XML
Uso di PDS • Preliminarmente: • Scaricare la guida PDS Reference da MSDN (link da SDK o download.microsoft.com) • Installare Visual Studio .NET (oppure il SOAP Toolkit 3.0) • Da programma: • Effettuare il logon a PDS con UserID e password • Ottenere il security cookie • Preparare la richiesta XML • Inviare il flusso XML unito al security cookie • Ricevere la risposta XML
Uso di PDS (2) • Demo: • Esempio di accesso in VB 6 con SOAP Toolkit 3.0 • Esempio di accesso in C# da Visual Studio .NET
Background su PDS • Introdotto per la prima volta in Project 2002 • Usato da vari tipi di client per l’accesso ai dati della raccolta di progetti • Project professional • Project Web Access • Applicativi sviluppati da solution provider • Accede alle tabelle e alle viste del DB di project server con funzione di gateway
Background su PDS • Garantisce la consistenza dei dati nel DB • Gestisce una connessione al DB in nome e per conto del client • Autentica il client e accede ai dati rilevanti del progetto • Fornisce metodi per l’accesso diretto alle viste del DB • Usato nella personalizzazione dei report • Non è permesso l’accesso diretto alle tabelle per assicurare che l’utente veda i soli dati per cui dispone dei privilegi d’accesso
Accesso diretto (2) • Il client effettua il logon a Project Server • Se ok richiede a PDS i dati della connessione con GetLoginInformation • Se ok effettua una connessione diretta al database e richiede il relativo SPID • Al PDS richiede l’accesso al progetto o alla risorsa con ProjectAccess o ResourceAccess rispettivamente • Effettua le query sul DB richiamando direttamente le viste • Al PDS comunica la fine dell’operazione per mantenere la sicurezza dei dati con ProjectAccessCompleted o ResourceAccessCompleted • Quindi chiude la connessione
Accesso diretto (3) • GetLoginInformation • Avviene inviando la seguente richiesta SOAP <Request> <GetLoginInformation/> </Request>
Accesso diretto (4) • La risposta in XML è la seguente: <Reply> <HRESULT>0</HRESULT> <STATUS>0</STATUS> <UserName>Administrator</UserName> <GetLoginInformation> <DBType>0</DBType> <DVR>{SQL Server}</DVR> <DB>ProjectServer</DB> <SVR>MYPROJECTS</SVR> <ResGlobalID>1</ResGlobalID> <ResGlobalName>resglobal</ResGlobalName> <UserName>MSProjectUser</UserName> <Password>password</Password> </GetLoginInformation> </Reply>
Accesso diretto (5) • Con la GetLoginInformation otteniamo i dati per una connessione ADO • E’ di vitale importanza considerare da subito gli aspetti di sicurezza • UserID e password per l’accesso al DB viaggiano in chiaro • La connessione deve essere protetta con SSL se la rete non è fidata (es. Internet)
Accesso diretto (6) • Una volta aperta la connessione ADO occorre recuperare con una query T-SQL lo SPID da ripresentare al PDS per le richieste successive • La query è banale: SELECT @@SPID • Project Server utilizza lo SPID per tracciare gli accessi in lettura e in lettura/scrittura ai progetti e alle risorse globali (tabelle MSP_PROJ_SECURITY e MSP_RES_SECURITY)
Accesso diretto (7) • L’utente che vuole accedere ai dati del progetto per creare un report deve prima richiamare ProjectsAccess specificando l’ID del progetto (ottenuto p.es. da ProjectsStatus), lo SPID e il relativo timestamp. • Nella tabella MSP_PROJ_SECURITY appare una riga come la seguente: PROJ_ID SEC_SPID SEC_SPIDDATESTAMP SEC_READCOUNT SEC_WRITECOUNT ------- -------- ----------------------- ------------- -------------- 1 51 2001-10-17 10:55:00.000 1 0
Accesso diretto (8) • La chiamata in XML è la seguente: <Request> <ProjectsAccess> <Mode>0</Mode> <SPID>58</SPID> <SPIDTimestamp>20011017105500</SPIDTimestamp> <Project> <ProjectID>3</ProjectID> </Project> </ProjectsAccess> </Request>
Accesso diretto (9) • Nella risposta XML otteniamo la lista dei progetti e delle eventuali risorse globali: <Reply> <HRESULT>0</HRESULT> <STATUS>0</STATUS> <UserName>Administrator</UserName> <ProjectsAccess> <Mode>0</Mode> <ResGlobalID>1</ResGlobalID> <ResGlobalName>resglobal</ResGlobalName> <Project> <ProjectID></ProjectID> <ProjectName> </ProjectName> <ProjectType></ProjectType> <ReplyStatus></ReplyStatus> </Project> </ProjectsAccess> </Reply>
Accesso diretto (10) • La sicurezza e l’integrità dei dati sono assicurate dalle regole seguenti: • L’account utente specificato nella stringa ADO deve avere i permessi di accesso alle viste di SQL server • L’account MSProjectUser creato in fase di installazione dispone dei privilegi necessari in quanto appartiene al ruolo MSProjectRole ma non ha accesso diretto alle tabelle • Eventuali deroghe devono seguire le linee guida contenute nel file PJDB.HTM contenuto nella directory di installazione di Project Server • Non è garantita la compatibilità dei client che accedono alle tabelle con versioni future di PDS
Accesso diretto (11) • Esempio di vista SQL per sola lettura: CREATE VIEW dbo.MSP_TASKS_PROJ_READVIEW AS SELECT * FROM MSP_TASKS WHERE PROJ_ID IN (SELECT PROJ_ID FROM MSP_PROJ_SECURITY WHERE @@SPID = SEC_SPID AND SEC_READCOUNT > 0) WITH CHECK OPTION
Accesso diretto (12) • Esempio di vista SQL per accesso read/write alle risorse enterprise globali (tipo 3) CREATE VIEW dbo.MSP_TASKS_RES_READVIEW AS SELECT * FROM MSP_TASKS WHERE PROJ_ID IN (SELECT PROJ_ID FROM MSP_PROJECTS WHERE PROJ_TYPE = 3) WITH CHECK OPTION
Accesso diretto (13) • Esempio di uso delle viste per estrarre un elenco delle risorse impegnate in un progetto e delle relative attività: select p.TASK_ID 'Task Number', p.TASK_NAME 'Task Name', CONVERT(VARCHAR(4), p.TASK_DUR_VAR/(60*60)) + 'd' 'Duration', r.RES_NAME 'Resource Name' from MSP_TASKS_PROJ_READVIEW p inner join MSP_ASSIGNMENTS_PROJ_READVIEW a on (p.TASK_UID = a.TASK_UID) inner join MSP_RESOURCES_PROJ_READVIEW r on (a.RES_UID = r.RES_UID) order by TASK_OUTLINE_NUM
Accesso diretto (14) • Esempio di output della query precedente: Task Number Task Name Duration Resource Name ----------- ------------- -------- ------------- 1 Write outline 1d Writer 2 Write draft 2d Writer 3 Create art 1d Artist
Accesso diretto (15) • Al termine delle operazioni occorre richiedere a PDS la rimozione dei record nelle tabelle MSP_PROJ_SECURITY e MSP_RES_SECURITY <Request> <ProjectsAccessCompleted> <Mode>0</Mode> <SPID>58</SPID> <Project> <ProjectID>3</ProjectID> </Project> </ProjectsAccessCompleted> </Request>
Accesso a Project Server Dim sURL As String sURL = "http://myserver/projectserver/LgnIntAu.asp" Dim oXMLDocument As DOMDocument30 Set oXMLDocument = New DOMDocument30 oXMLDocument.Load sURL 'Wait for the XML Document to load from Microsoft ‘Project Server Const cTimeout As Long = 45 Dim startTime As Long, elapsed As Long startTime = Timer Do While oXMLDocument.readyState < 4 DoEvents elapsed = Timer - startTime If elapsed > cTimeout Then GoTo errTimeout Loop
Accesso a Project Server (2) Dim sCookie As String Dim oNode As IXMLDOMNode If oXMLDocument.parseError.errorCode = 0 Then If Not oXMLDocument Is Nothing Then Set oNode = XMLDocument.selectSingleNode("Reply/Cookie") If Not oNode Is Nothing Then sCookie = oNode.Text End If End If Else sCookie = "" End If
Accesso a Project Server (3) errTimeout: MsgBox prompt:="Login Timeout Occurred." & vbCrLf & "Elapsed time = " _ & elapsed & " seconds" & vbCrLf & "xmlDocument.ReadyState = " & _ oXMLDocument.readyState, Title:="Login Timeout" MsgBox prompt:=oXMLDocument.xml
Struttura delle chiamate a PDS <Request> <MethodName> <Parameter1>value</Parameter1> <Parameter2>value</Parameter2> ... <ParameterN>value</ParameterN> </MethodName> </Request>
Trattamento dei dati XML • Per isolare il singolo dato occorre accedere al nodo corrispondente del documento XML col metodo selectSingleNode del parser • Per inviare la richiesta a PDS si può utilizzare il metodo SOAPXmlRequest
Riferimenti • download.microsoft.com • MS Project Server 2003 Software Development Kit (SDK) • MS Project 2003 Resource Kit • Office developer center: articoli, SDK, esempi, codice http://msdn.microsoft.com/office/understanding/project/ • Getting started: developing with Project 2003 http://msdn.microsoft.com/office/understanding/project/techarticles/default.aspx?pull=/library/en-us/odc_pj2003_ta/html/odc_pjgetstarted.asp/
Articoli KB • Q307033 HOW TO: use an XML Web Service by using ASP.NET from an Office VBA Macro in Word or Excel • Q301273 HOW TO: Write a Simple Web Service by Using Visual Basic .NET • Q308359 HOW TO: Write a Simple Web Service by Using Visual C# .NET • Q892964 How to troubleshoot common errors that occur when you use the PDSTest tool or the PDSTest.NET tool to test the Project Server 2003 Project Data Service • KB811318 PRB: "Access Denied" Error Message When You Call a Web Service While Anonymous Authentication Is Turned Off