Sviluppare nuove definizioni di sito personalizzate e creare file di definizione di aggiornamento (Office SharePoint Server)

  • Articolo

Contenuto dell'articolo:

  • Prima di sviluppare nuove definizioni di sito personalizzate

  • Sviluppare nuove definizioni di sito personalizzate

  • Informazioni sui file di definizione di aggiornamento

  • Creare i file di definizione di aggiornamento

  • Registrare le informazioni dei file di definizione di aggiornamento in un foglio di lavoro

Prima di sviluppare nuove definizioni di sito personalizzate

Prima di aggiornare siti basati su definizioni di sito personalizzate, è necessario eseguire i passaggi seguenti per accertarsi che tutte le pagine e gli elenchi derivati dalle definizioni di sito personalizzate continueranno a funzionare in seguito all'aggiornamento.

Nota

Se non si è ancora pronti ad aggiornare i siti basati su una definizione di sito personalizzata (ad esempio se la definizione di sito è stata ottenuta da un provider di soluzioni e non ne è ancora stata resa disponibile una nuova versione), è possibile procedere a un aggiornamento graduale a partire da altri siti e lasciare quelli basati sulla definizione personalizzata precedente in esecuzione nell'ambiente. Successivamente, quando si ottiene una nuova definizione di sito personalizzata, sarà possibile creare il file di definizione di aggiornamento e aggiornare solo i siti basati sulla definizione.

  1. **Ottenere o sviluppare nuove definizioni di sito personalizzate ed elementi personalizzati   **Se si desidera mantenere le funzionalità di siti basati su una definizione personalizzata, è necessaria una nuova definizione di sito personalizzata che includa tutte le funzionalità necessarie più le eventuali nuove funzionalità desiderate. Se sono stati ottenuti una definizione di sito personalizzata o elementi personalizzati da un provider di soluzioni, verificare se il provider dispone di una nuova versione. In caso contrario, potrebbe essere necessario svilupparne una propria.

  2. **Creare un file di definizione di aggiornamento di un sito   **È inoltre necessario creare un file di mapping tra gli elementi personalizzati della definizione di sito personalizzata precedente e quelli della nuova definizione, in modo che ogni elemento nel sito (ad esempio una pagina personalizzata) possa essere aggiornato al nuovo elemento corrispondente.

  3. **Creare file di definizione di aggiornamento dei modelli di pagina   **Per Microsoft Office SharePoint Portal Server 2003, è inoltre necessario creare file di definizione di aggiornamento per la conversione dei modelli di pagina, ad esempio il modello della home page, in nuovi layout di pagina. I layout di pagina in Microsoft Office SharePoint Server 2007 sostituiscono i modelli di pagina di SharePoint Portal Server 2003 ed è necessario specificare il layout di pagina da utilizzare per ogni tipo di pagina. Per ulteriori informazioni sui layout di pagina, vedere Pianificare pagine Web.

Importante

Se si crea un modello di sito basato su una delle definizioni predefinite di SharePoint Portal Server 2003, il processo di aggiornamento potrebbe sovrascrivere alcuni file o personalizzazioni contenuti nel modello di sito. È necessario ricreare qualsiasi modello di sito creato da una definizione di sito di SharePoint Portal Server 2003. È necessario ricreare il modello da una definizione di sito equivalente di Microsoft Office SharePoint Server 2007 per effettuare il provisioning di nuovi siti dopo l'aggiornamento.

Durante il processo di preaggiornamento la nuova definizione di sito personalizzata ed eventuali file di definizione di aggiornamento vengono copiati nella directory di installazione in modo da essere disponibili al momento dell'aggiornamento delle raccolte siti.

Sviluppare nuove definizioni di sito personalizzate

Utilizzare questo processo per creare definizioni di sito personalizzate in un ambiente di sviluppo. Per ulteriori informazioni, vedere il Software Development Kit (SDK) di Windows SharePoint Services su MSDN .

  1. Creare le definizioni di sito personalizzate a partire da una definizione di sito disponibile nel nuovo ambiente.

    • Le definizioni di sito sono archiviate nella cartella seguente:

      %COMMONPROGRAMFILES%\Microsoft Shared\Web Server extensions\12\TEMPLATE\SiteTemplates\ NOME

      dove NOME corrisponde al nome della definizione di sito (ad esempio, AZIONE). Creare una cartella per la nuova definizione di sito e denominare la nuova cartella utilizzando tutte lettere maiuscole.

    • I file XML utilizzati per registrare i modelli di sito vengono archiviati nel percorso seguente:

      %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\LCID\XML\webtempnome.xml

      dove nome corrisponde al nome della definizione di sito con la differenza che è in lettere minuscole (ad esempio, azione) e LCID all'identificatore delle impostazioni locali per la lingua del modello (ad esempio 1040 per l'italiano).

  2. Creare una nuova versione del file webtempnome.xml per ogni definizione di sito personalizzata disponibile in SharePoint Portal Server 2003, dove nome è il nome della definizione di sito. È possibile creare file webtempnome.xml a partire dai file delle definizioni di sito standard forniti con il nuovo prodotto (ambiente).

  3. Dopo aver completato correttamente il processo di aggiornamento, copiare i modelli pagina utilizzati per SharePoint Portal Server 2003 nella cartella della raccolta pagine master nella radice di una raccolta siti aggiornata. Per ulteriori informazioni, vedere Pianificare pagine Web.

    Creare inoltre i layout di pagina mediante le pagine di destinazione personalizzate corrispondenti di SharePoint Portal Server 2003. Prima di eseguire l'aggiornamento, salvare una copia delle pagine di destinazione personalizzate. Dopo aver completato correttamente il processo di aggiornamento, caricare i layout di pagina nella cartella della raccolta pagine master nella radice della raccolta siti.

  4. Verificare le definizioni di sito nell'ambiente di sviluppo creando un nuovo sito basato sulla definizione.

Dopo aver creato e testato le nuove definizioni di sito, è possibile creare i file di definizione di aggiornamento che definiscono il mapping tra le definizioni di sito precedenti e quelle nuove.

Informazioni sui file di definizione di aggiornamento

Un file di definizione di aggiornamento del sito descrive la modalità di mapping tra una definizione di sito personalizzata precedente e una nuova. L'obiettivo di un file di definizione di aggiornamento consiste nel fornire agli sviluppatori uno strumento per convertire i siti precedenti in equivalenti nuovi in grado di sfruttare tutti i miglioramenti offerti dal nuovo ambiente.

Per Microsoft Office SharePoint Server 2007, non vi sono file di definizione di aggiornamento per modelli di pagina specifici. Un modello di pagina è un file ASPX (Active Server Page Extenstion) che definisce la struttura di una pagina. Il vantaggio dei modelli di pagina consiste nella possibilità di creare nuove pagine basate sul modello invece di crearle in un editor di pagine Web compatibile con Microsoft Office SharePoint Server 2007. I modelli di pagina vengono archiviati nella radice della raccolta siti e sono condivisi in tutta la raccolta.

In Microsoft Office SharePoint Server 2007, i modelli di pagina vengono utilizzati per la maggior parte delle pagine del sito portale. Ciò significa che tutte le nuove definizioni di sito per Microsoft Office SharePoint Server 2007 includono modelli di pagina e che numerose pagine del portale basate sulla definizione del sito portale standard del prodotto (ambiente) precedente si basano invece su diversi layout di pagina nel nuovo prodotto. Il processo di aggiornamento sposta le pagine del portale dal prodotto precedente alle pagine che utilizzano i layout di pagina del nuovo prodotto. I modelli di pagine del prodotto precedente vengono spostati nell'insieme predefinito di layout di pagina fornito con il nuovo prodotto. Se l'insieme predefinito di layout di pagina non soddisfa le esigenze specifiche, è possibile creare un insieme personalizzato e specificare un file di definizione di aggiornamento per stabilire il mapping tra le pagine del portale precedenti e i nuovi layout di pagina.

Un file di definizione di aggiornamento per una definizione di sito è costituito dalle sezioni seguenti:

  • **WebTemplate   **Specifica le informazioni sull'aggiornamento per il modello Web nel suo complesso. In questa sezione, è necessario un tag WebTemplate per ogni file di definizione di aggiornamento.

  • **Lists   **Specifica le informazioni di aggiornamento per ogni elenco o raccolta del modello. Nella sezione Lists è necessario un tag List per ogni elenco o raccolta.

  • **Files   **Specifica le informazioni di aggiornamento per le singole pagine del modello. Nella sezione Files è necessario un tag File per ogni pagina non personalizzata del modello.

  • **AppliedSiteFeature   **Specifica le informazioni di aggiornamento per le funzionalità a livello di raccolta siti o di sito secondario incluse nel modello. Nelle sezioni AppliedSiteFeature e AppliedWebFeature è necessario un tag Feature per ogni funzionalità di ciascun livello inclusa nel modello.

  • **AppliedWebFeature   **Specifica le informazioni di aggiornamento per le funzionalità a livello di sito secondario incluse nel modello. Nella sezione AppliedWebFeature è necessario un tag Feature per ogni funzionalità di ciascun livello inclusa nel modello.

Nell'esempio seguente, tratto da uno dei file installati in Microsoft Office SharePoint Server 2007, viene descritto il formato per un file di definizione di aggiornamento di un modello di pagina.

<SPSSiteUpgraderConfig>
    <PublishingPageLayoutMappings>
        <PublishingPageLayoutMapping WebTemplateId="20" PublishingPageLayout="/_catalogs/masterpage/defaultlayout.aspx"/>
        <PublishingPageLayoutMapping WebTemplateId="22" PublishingPageLayout="/_catalogs/masterpage/welcomelayout2.aspx"/>
    </PublishingPageLayoutMappings>
</SPSSiteUpgraderConfig>

Nell'esempio è possibile notare il mapping stabilito tra un modello di sito Web e un modello di pagina. In altre parole, il modello di sito Web con ID=20 è mappato al layout di pagina defaultlayout.aspx. Ciò significa che ogni sito che utilizza l'ID modello 20 disporrà di una home page (in genere default.aspx) con un layout di pagina definito da defaultlayout.aspx.

Assicurarsi di includere le voci nel file di definizione di aggiornamento del modello di pagina per le pagine di destinazione personalizzate di SharePoint Portal Server 2003 che verranno utilizzate per i layout di pagina in Microsoft Office SharePoint Server 2007. Queste voci impostano un ID modello di sito Web sul nome della pagina di destinazione di SharePoint Portal Server 2003 che verrà utilizzata come layout di pagina.

Creare i file di definizione di aggiornamento

Assegnare al file di definizione di aggiornamento un nome univoco che inizia con il nome della definizione di sito. Ad esempio, per una definizione di sito denominata "STS1", denominare il file di definizione di aggiornamento "STS1_upgrade.xml".

I file di definizione di aggiornamento devono essere installati nella cartella seguente:

%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\Config\Upgrade

Per ulteriori informazioni sulla creazione di file di definizione di aggiornamento, con un esempio di file di definizione di aggiornamento, vedere gli argomenti File di definizione di aggiornamento (informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=109945&clcid=0x410) (informazioni in lingua inglese) e Schema della definizione di aggiornamento (informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=109946&clcid=0x410) (informazioni in lingua inglese) nello SDK di Microsoft Windows SharePoint Services 3.0 su MSDN.

Per ulteriori informazioni sulla distribuzione di file di definizione di aggiornamento e di nuove definizioni di sito, vedere Distribuire i file di definizione di aggiornamento e le nuove definizioni di sito (Office SharePoint Server). Per ulteriori informazioni sulla creazione di file di definizione di aggiornamento, ad esempio sugli elementi da includere nei file e nello schema, vedere Aggiornamento delle personalizzazioni di SharePoint Portal Server 2003 a SharePoint Server 2007 (informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=105294&clcid=0x410) (informazioni in lingua inglese) in MSDN Library.

Registrare le informazioni dei file di definizione di aggiornamento in un foglio di lavoro

Registrare i nomi e i percorsi di tutti i file di definizione di aggiornamento che è necessario creare nel foglio di lavoro Custom templates and mapping files (informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=73751&clcid=0x410) (informazioni in lingua inglese) .

Scaricare questo manuale

Per agevolare la lettura e la stampa, questo argomento è incluso nel manuale scaricabile seguente:

Per un elenco completo dei manuali disponibili che è possibile scaricare per Office SharePoint Server 2007, vedere Downloadable content for Office SharePoint Server 2007 (informazioni in lingua inglese).