Condividi tramite

Plugin del modello di processo Windows SharePoint Services

  • Articolo

Aggiornamento: novembre 2007

Il plug-in Windows SharePoint Services definisce il portale di progetto per il team sulla base di un modello di sito SharePoint. Il nome del plug-in è Microsoft.ProjectCreationWizard.Portal. Il file XML relativo a Windows SharePoint Services è denominato WssTasks.xml ed è posizionato nella cartella Windows SharePoint Services nella gerarchia delle cartelle del modello di processo. Se necessario, è possibile modificare il nome del file XML e della cartella.

Specificare una o più attività e le relative dipendenze nel file XML. È necessario specificare tre attività chiave: quale modello di sito utilizzare, quali librerie di documenti creare e quali cartelle e file copiare nelle librerie di documenti. Per un esempio di attività in cui viene specificato un portale di progetto semplice, vedere il file WssTasks.xml nel modello di processo MSF for Agile Software Development.

Nota:

Team Foundation Server non include un meccanismo per la distribuzione di plug-in, criteri o altre modifiche sul lato client. Se si desidera distribuire plug-in, criteri o altre modifiche a Team Explorer, è opportuno utilizzare il programma di distribuzione e installazione di cui si dispone.

Per ulteriori informazioni sui siti Windows SharePoint Services e l'amministrazione di Windows SharePoint Services, vedere Windows SharePoint Services Administrator's Guide (informazioni in lingua inglese).

Modello del sito

È necessario specificare il modello di sito su cui è basato il portale. Il modello di sito deve essere disponibile anche nel portale SharePoint in Team Foundation Server. I modelli di sito non sono inclusi nel modello di processo.

Specificare il modello di sito utilizzando l'elemento site.

<site template="" language=""/>

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento site.

Attribute

Descrizione

template

Specifica il modello da utilizzare. Il modello è una combinazione del nome del modello e dell'ID di configurazione derivanti dal file webtemp.xml sul server SharePoint.

language

Specifica un ID impostazioni locali che indica la versione della lingua del modello di sito da utilizzare. La versione relativa alla lingua inglese è la 1033.

Nell'esempio riportato di seguito viene mostrato come fare riferimento alla versione in lingua inglese del modello VSTS_MSFAgile.

  <task id="SharePointPortal"
        name="Create Sharepoint Portal"
        plugin="Microsoft.ProjectCreationWizard.Portal"
        completionMessage="Project site created.">
    <dependencies/>
    <taskXml>
      <Portal>
        <site template="VSTS_MSFAgile" language="1033"/> 
...
Nota:

Tutte le altre attività di Windows SharePoint Services dipendono da questa attività, in quanto il portale del progetto deve essere creato prima della creazione di altre librerie di documenti o della copia di file.

Creazione di modelli di sito personalizzati

È possibile creare modelli di sito SharePoint personalizzati da utilizzare con i modelli di processo. I modelli di sito SharePoint vengono creati utilizzando le funzionalità di amministrazione del sito SharePoint. Per ulteriori informazioni sulla creazione dei modelli di sito SharePoint, consultare la guida di Microsoft Windows SharePoint Services 2.0.

Una volta creato un modello di sito SharePoint personalizzato, aggiungerlo a tutti i Team Foundation Server in cui verrà impiegato. Salvare per prima cosa il modello di sito personalizzato in un file STP. Per ulteriori informazioni sul salvataggio dei modelli di sito, consultare la guida di Microsoft Windows SharePoint Services 2.0.

Per aggiungere modelli di sito personalizzati è possibile utilizzare il sito SharePoint o utilizzare il prompt dei comandi. Nella procedura riportata di seguito viene illustrato come aggiungere un modello di sito personalizzato a Team Foundation Server.

Per aggiungere un modello di sito personalizzato a Team Foundation Server

  1. Aprire una finestra del prompt dei comandi in Team Foundation Server.

  2. Passare alla directory \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin nel prompt dei comandi.

  3. Per aggiungere il modello di sito personalizzato a Team Foundation Server, digitare il comando

    stsadm -o addtemplate -filename <custom site template filename>.stp -title <site template title>

  4. Digitare iisreset e premere INVIO. Per rendere disponibile il modello di sito personalizzato è necessario riavviare IIS.

Una volta caricati in Team Foundation Server, i modelli di sito personalizzati possono essere utilizzati dai modelli di processo per creare progetti Team. Nella procedura riportata di seguito viene descritto come modificare il file XML del modello di processo per utilizzare un modello di sito personalizzato.

Per aggiungere un modello di sito personalizzato a un modello di processo

  1. Aprire una finestra del prompt dei comandi in Team Foundation Server.

  2. Passare alla directory \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin nel prompt dei comandi.

  3. Digitare stsadm -o enumtemplates e premere INVIO. Vengono elencati i modelli di sito disponibili. Queste informazioni sono necessarie per costruire il file XML del modello di processo corretto.

    Ad esempio, se si aggiunge un modello di sito denominato ExCustom, si otterrà il seguente output.

    ExCustom - Language: 1033 - Site Template: _GLOBAL_#1 - Template Id: 1

    Nota:

    L'ID modello (Template Id) può differire in base al numero dei modelli di sito presenti sul server.

  4. In Visual Studio, scegliere Impostazioni di Team Foundation Server dal menu Team, quindi scegliere Gestione modelli di processo.

  5. Scaricare il modello di processo da modificare utilizzando Gestione modelli di processo.

    Per ulteriori informazioni sul download dei modelli di processo, vedere Procedura: scaricare un modello di processo.

  6. Modificare il file WSSTasks.xml nel modello di processo.

    Individuare l'elemento site e modificare l'attributo del modello per fare in modo che corrisponda al nome del modello del sito recuperato nel passaggio 3. Nel file XML riportato di seguito è mostrato un esempio di elemento site per il modello di esempio ExCustom.

    <site template="_GLOBAL_#1" language="1033"/>

  7. Caricare il modello di processo aggiornato.

    Per ulteriori informazioni sul caricamento dei modelli di processo, vedere Procedura: caricare un modello di processo.

    Nota:

    I modelli di processo aggiornati non devono contenere file EXE in alcuna cartella; in caso contrario, la creazione del progetto non riuscirà, anche se il modello di processo aggiornato viene caricato correttamente.

A questo punto, è possibile utilizzare la Creazione guidata nuovo progetto team per creare nuovi progetti Team dal modello di processo personalizzato. Il modello di sito personalizzato verrà utilizzato dai nuovi progetti Team per il portale del progetto.

Librerie di documenti

Una volta creato il portale del progetto, è possibile specificare la creazione di librerie di documenti aggiuntive. Utilizzare l'elemento documentLibrary per specificare una libreria di documenti.

<documentLibraries>
   <documentLibrary name="" description=""/>
</documentLibraries>
Nota:

Nel modello di processo non è possibile attivare o disattivare il controllo delle versioni per una libreria di documenti. Il controllo delle versioni può essere attivato o disattivato mediante il modello di sito Windows SharePoint Services o dopo la creazione del progetto.

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento documentLibrary.

Attribute

Descrizione

name

Specifica il nome della libreria di documenti visualizzata nel portale del progetto.

description

Fornisce una descrizione della libreria di documenti visualizzata nel portale del progetto.

Nell'esempio riportato di seguito viene illustrato come creare una libreria di documenti denominata Development che il team di sviluppo può utilizzare per la memorizzazione dei documenti.

<documentLibraries>
   <documentLibrary name="Development" 
      description=" Documents for the development team "/>
</documentLibraries>

Cartelle e file

Una volta creato il portale del progetto, è possibile specificare la creazione di cartelle aggiuntive. È anche possibile specificare la copia di file, ad esempio i file di modello.

Utilizzare l'elemento folder per creare una nuova cartella.

<folders>
   <folder documentLibrary="" name=""/>
</folders>

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento folder.

Attribute

Descrizione

documentLibrary

Identifica la libreria di documenti in cui creare la cartella.

name

Specifica il nome della cartella.

Nell'esempio riportato di seguito viene illustrato come creare una cartella denominata Trip Reports nella libreria di documenti Development, nella quale gli sviluppatori possono memorizzare resoconti di conferenze o visite ai clienti.

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

Nelle librerie di documenti e nelle cartelle è anche necessario copiare i file. I file di origine sono posizionati nella cartella Windows SharePoint Services. Nel portale del progetto è necessario specificare una destinazione.

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento file.

Attribute

Descrizione

source

Percorso relativo della copia locale del file. In genere, il percorso di origine inizia con Windows SharePoint Services.

documentLibrary

Nome della libreria di documenti in cui verrà copiato il file.

target

Percorso relativo della destinazione nel portale del progetto in cui verrà copiato il file.

queryId

Specifica il nome di una query elemento di lavoro associata al file. Quando il file viene aperto per la prima volta, al suo interno vengono inseriti i risultati dell'esecuzione della query. Questo attributo è facoltativo e la query specificata deve essere presente nel file workitems.xml.

Nota:

queryId si applica solo ai file XLS e MPP.

Nell'esempio riportato di seguito viene illustrato come copiare un file di modello denominato Project Checklist nella cartella Project Management. In questo esempio viene anche specificato che, quando il file viene aperto per la prima volta, devono esservi inseriti i risultati della query elemento di lavoro Project Checklist.

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>
Nota:

All'interno del modello di sito è possibile includere cartelle e file, che non è necessario elencare nel file XML.
Nota:

Se si specificano file EXE e il sito Windows SharePoint non supporta i file EXE, non sarà possibile creare un progetto team utilizzando il modello di processo.

Prestazioni del modello di processo

I file specificati in wsstasks.xml vengono inclusi nel modello di processo quando questo viene caricato. Le dimensioni del modello di processo influiscono sul tempo necessario per la creazione di un nuovo progetto team. Dimensioni maggiori del modello di processo comportano tempi più lunghi per la creazione dei nuovi progetti Team. Si consiglia di adottare strategie alternative per fornire i file quando le prestazioni del modello di processo si riducono.

Utilizzo del modello di sito

Nel modello di sito Windows SharePoint è possibile includere file. Questa operazione consente di spostare i file dal modello di processo nel modello di sito e migliorare quindi le prestazioni durante la creazione di nuovi progetti Team.

Tuttavia, la creazione di elenchi di file in wsstasks.xml presenta un vantaggio: i file di Microsoft Project e di Microsoft Excel possono essere associati a una query utilizzando l'attributo queryid descritto in precedenza. Questa prerogativa semplifica il lavoro dei membri del team quando essi aprono i file, in quanto saranno già connessi al Team Foundation Server e alla query appropriati.

Utilizzo di un sito Web alternativo

Se si dispone di un insieme di file di grandi dimensioni condiviso tra più progetti Team, è possibile utilizzare un sito Web alternativo per inserire i file e creare collegamenti ai file dal portale del progetto o dalle pagine Web. Questa strategia aumenta anche le prestazioni della creazione dei progetti Team, in quanto non è necessario copiare i file nel portale del progetto.

Linee guida per il processo

I file delle linee guida per il processo sono installate dal plug-in Windows SharePoint Services. Tutti i file delle linee guida per il processo sono posizionati nella cartella Windows SharePoint Services\Process Guidance ed è necessario specificare un elemento file per ciascun file per garantirne la copia nel portale del progetto. Per ulteriori informazioni sulla personalizzazione delle linee guida per il processo, vedere MSF for Agile Software Development e MSF for CMMI Process Improvement (informazioni in lingua inglese) e MSF for CMMI Process Improvement (informazioni in lingua inglese).

Vedere anche

Attività

Procedura: verificare le modifiche di Windows SharePoint Services

Procedura: scaricare un modello di processo

Procedura: caricare un modello di processo