Condividi tramite

Definire il plug-in del portale del progetto per un modello di processo

  • Articolo

Tramite il plug-in del portale è possibile definire le raccolte documenti, la struttura delle raccolte e i documenti iniziali di un portale del progetto team. È inoltre possibile includere le attività per la creazione di dashboard e rapporti di Excel progettati per l'utilizzo dei modelli di processo di Team Foundation Server (TFS).

Le attività specificate nel plug-in per Prodotti SharePoint vengono eseguite solo quando si crea un sito di SharePoint durante la creazione di un progetto team. Per ulteriori informazioni sui requisiti e sull'amministrazione del sito, vedere Requisiti di Prodotti SharePoint per Team Foundation Server.

Nome e percorso del plug-in del portale

Nella tabella seguente è incluso un riepilogo dei nomi del file del plug-in del portale, della cartella e del plug-in per i modelli di processo TFS.

Nome del file:

WssTasks.xml

Nome della cartella:

Windows SharePoint Services

Nome del plug-in:

Microsoft.ProjectCreationWizard.Portal

Nota

È possibile modificare i nomi del file XML e della cartella, ma non del plug-in.In TFS non è previsto un meccanismo per la distribuzione di plug-in, criteri o altre modifiche sul lato client.Se si desidera distribuire questo tipo di funzionalità, è necessario utilizzare il programma di distribuzione e installazione di cui si dispone.

Attività di creazione del portale e dipendenze

Nel file del plug-in del portale specificare una o più attività e le relative dipendenze. È necessario specificare le attività principali seguenti:

  • Creazione del sito tramite un modello di sito specificato

  • Creazione di raccolte documenti

  • Creazione di cartelle e caricamento di file nelle raccolte documenti

  • Attivazione di funzionalità del dashboard

Per un esempio di un'attività con cui si specifica un portale del progetto semplice, vedere il file WssTasks.xml in uno dei modelli di processo TFS. È possibile scaricare i modelli di processo più recenti da TFS.

Creare il sito e specificare il modello di sito

È necessario specificare un modello di sito su cui è basato il portale del progetto. 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 per l'elemento site.

Attributo

Descrizione

modello

Specifica il modello da utilizzare. È necessario specificare un modello definito nel server che ospita Prodotti SharePoint per i progetti team che verranno creati.

Per usare le funzionalità disponibili con la versione corrente dei modelli di processo per MSF, specificare la stringa seguente: Team Foundation Server Project Portal.

linguaggio

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

Nell'esempio seguente viene illustrato come fare riferimento alla versione inglese della versione corrente del modello di processo MSF Agile che supporta i dashboard.

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="Team Foundation Server Project Portal" language="1033" />  
       . . . 
        </Portal>

Nota

Tutte le altre attività definite nel plug-in del portale dipendono dall'attività di creazione del sito, in quanto è necessario creare il portale del progetto prima di poter creare raccolte documenti aggiuntive o copiare file.

Prestazioni del modello di processo

I file specificati in WssTasks.xml vengono inclusi come parte del 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.

Utilizzare il modello di sito

È possibile includere file come parte del modello di sito di SharePoint. 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 più vantaggioso elencare file in WssTasks.xml. È possibile associare file di Microsoft Project e di Microsoft Excel 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.

Utilizzare un sito Web alternativo

Se si dispone di una raccolta di file di grandi dimensioni condivisa 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. Per altre informazioni, vedere Configurare o aggiungere un portale progetto.

Creazione di raccolte documenti

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

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>

Nota

Nel modello di processo non è possibile abilitare o disabilitare il controllo delle versioni per una libreria di documenti.Il controllo delle versioni può essere abilitato o disabilitato 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.

Attributo

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.

isProcessGuidance

Specifica se la raccolta documenti viene utilizzata per supportare contenuto delle linee guida per il processo.

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="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

Creare la struttura di cartelle di una raccolta documenti

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.

Attributo

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>

Specificare i file da caricare nelle raccolte documenti

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.

Attributo

Descrizione

source

Percorso relativo della copia locale del file. In generale, il nome del percorso di origine inizia sempre con Windows SharePoint Services, che corrisponde al nome della cartella in cui è definito il plug-in del portale.

documentLibrary

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

destinazione

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 con estensione xls.

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 con estensione exe e il sito di SharePoint non supporta tali file, non sarà possibile creare un progetto team utilizzando il modello di processo.

File di supporto e contenuto delle linee guida per il processo

Per linee guida per il processo si intende il contenuto che documenta i processi che dovranno essere seguiti dai membri del team che si occupano di un progetto software. Gli elementi di lavoro, i rapporti e le query possono subire modifiche nel corso del ciclo di vita di un progetto team e possono essere differenti nei vari progetti team. Le linee guida per il processo forniscono informazioni dettagliate su un progetto team, ad esempio informazioni su come completare i campi degli elementi di lavoro, esempi di rapporti corretti e non corretti e descrizioni delle query. Le linee guida per il processo forniscono inoltre informazioni dettagliate sul processo da seguire in un progetto team, ad esempio i ruoli da assumere e le attività da completare.

Da MSDN Library è possibile accedere al contenuto delle linee guida per il processo per la maggior parte degli elementi definiti da ciascun modello di processo predefinito di TFS. È possibile esplorare il contenuto disponibile in MSDN da uno dei seguenti argomenti: Visual Studio Scrum 3.0, MSF for Agile 7.0 e MSF for CMMI 7.0.

Per supportare l'accesso alle linee guida per il processo dai form dell'elemento di lavoro in Team Explorer, viene caricato un set di file con estensione htm nella cartella Linee guida processo nella raccolta documenti di SharePoint. In questi file vengono specificati gli URL del contenuto MSDN visualizzato quando un membro del team fa clic sull'icona Aprire le linee guida per il processo relative all'elemento di lavoro delle linee guida per il processo in un form dell'elemento di lavoro. Questi file vengono caricati in base alle attività file definite nel plug-in del portale. Ad esempio, nel modello di processo Agile vengono definite le attività file seguenti:

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

È possibile personalizzare tali file perché puntino ad altre risorse per le linee guida per il processo. È inoltre possibile aggiungere file per supportare l'accesso ad altre linee guida per il processo create personalmente per il team. Per altre informazioni, vedere Configurare o aggiungere un portale progetto.

Attivazione di funzionalità del dashboard

I dashboard contengono i dati del progetto, supportano l'analisi e consentono ai team di eseguire rapidamente attività comuni. Nei dashboard vengono visualizzati diversi rapporti di Excel e Web part Team Web Access.

È necessario utilizzare l'elemento activateFeatures per provocare la creazione dei dashboard e dei rapporti di Excel. È necessario includere il codice seguente nel file del plug-in del portale, all'interno dell'elemento Portal, per attivare la creazione dei dashboard e dei rapporti di Excel per un progetto team.

Per attivare le funzionalità del dashboard progettate per l'utilizzo con il modello di processo per Visual Studio Scrum:

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

Per attivare le funzionalità del dashboard progettate per l'utilizzo con il modello di processo per MSF Agile Software Development:

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

Per attivare le funzionalità del dashboard progettate per l'utilizzo con il modello di processo MSF CMMI Process Improvement:

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

Vedere anche

Concetti

Personalizzare un processo

Cenni preliminari sui file di modello di processo