Condividi tramite

Creare un pacchetto e distribuire soluzioni SharePoint

  • Articolo

In genere, una soluzione SharePoint viene distribuita in un server SharePoint usando un file di pacchetto della soluzione (con estensione wsp). È possibile usare Visual Studio per organizzare gli elementi del progetto SharePoint in funzionalità e creare un pacchetto per distribuire le funzionalità di SharePoint.

Questo argomento contiene informazioni sui seguenti aspetti:

Creare funzionalità e pacchetti

È possibile usare Visual Studio per raggruppare elementi di SharePoint correlati in una funzionalità. Ad esempio, una funzionalità per una definizione di elenco contatti può includere l'istanza dell'elenco e la definizione dell'elenco. È possibile combinare questi due elementi in un'unica funzionalità a scopo di distribuzione. Per altre informazioni sulle funzionalità, vedere Blocco predefinito: funzionalità.

Successivamente, è possibile creare un pacchetto di soluzione SharePoint (con estensione wsp) per aggregare più funzionalità, definizioni del sito, assembly e altri file in un singolo pacchetto, che archivia i file in un formato necessario da SharePoint per distribuire i file nel server. Per altre informazioni, vedere Blocco predefinito: soluzioni.

Supporto degli strumenti di creazione di funzionalità e creazione di pacchetti

È possibile usare gli strumenti di sviluppo di SharePoint in Visual Studio per organizzare rapidamente i file di SharePoint in funzionalità e pacchetti di soluzioni per semplificare la distribuzione. Per configurare il pacchetto di funzionalità e soluzione, è possibile usare gli strumenti seguenti.

  • Progettazione funzionalità e Progettazione pacchetti.

  • Esplora pacchetti, una finestra degli strumenti.

  • Esplora soluzioni.

Progettazione funzionalità e progettazione pacchetti

È possibile creare funzionalità, impostare ambiti e contrassegnare altre funzionalità come dipendenze tramite Progettazione funzionalità. La finestra di progettazione visualizza anche il file XML finale che descrive ogni funzionalità. Per altre informazioni, vedere Creare funzionalità di SharePoint.

Applicare la funzionalità a un sito Web o a un gruppo specifico di siti Web impostandone l'ambito in Progettazione funzionalità. Se una funzionalità viene attivata per un singolo sito Web, la funzionalità funziona solo in quel particolare sito Web. Se una funzionalità viene attivata per una raccolta siti, gli elementi della funzionalità si applicano all'intera raccolta siti. Per altre informazioni, vedere Ambito elemento.

Se la funzionalità si basa su altre funzionalità, è possibile impostare una dipendenza di attivazione delle funzionalità per contrassegnare le funzionalità dipendenti prima di rendere disponibile la funzionalità. Una dipendenza di attivazione delle funzionalità controlla se le funzionalità dipendenti sono già attivate in tale ambito. Per altre informazioni, vedere Dipendenze di attivazione e ambito.

In Progettazione pacchetti è possibile raggruppare gli elementi di SharePoint in un singolo pacchetto della soluzione e configurare se reimpostare il server Web durante la distribuzione. Per impostare il tipo di server di distribuzione, usare la finestra Proprietà . La finestra di progettazione genera anche il file XML che descrive il contenuto del pacchetto. Per altre informazioni, vedere Creare pacchetti di soluzioni SharePoint.

Durante la distribuzione, il servizio Internet Information Services (IIS) viene arrestato per copiare i file della soluzione nel server SharePoint. Usando Progettazione pacchetti in Visual Studio, è possibile selezionare se il server Web deve essere riavviato. Per configurare se la soluzione viene distribuita in un server Web front-end o in un server applicazioni, usare la finestra Proprietà . Per altre informazioni, vedere Elemento soluzione (soluzione).

Esplora pacchetti

Per integrare Progettazione funzionalità e Progettazione pacchetti, è possibile usare Esplora pacchetti per raggruppare i file di SharePoint in Funzionalità e pacchetti. Inoltre, è possibile visualizzare la visualizzazione gerarchica del pacchetto, delle funzionalità, degli elementi del progetto SharePoint e dei file. Packaging Explorer è una finestra degli strumenti che è possibile usare per completare le attività seguenti:

  • Aprire file e elementi del progetto SharePoint.

  • Trascinare e rilasciare elementi del progetto SharePoint da una funzionalità a un'altra.

  • Trascinare e rilasciare elementi del progetto SharePoint e Funzionalità da un pacchetto a un altro.

  • Aggiungere una nuova funzionalità a un pacchetto.

  • Aprire una finestra di progettazione di funzionalità o pacchetti.

  • Convalidare funzionalità e pacchetti.

    Gli strumenti di sviluppo di SharePoint in Visual Studio dispongono di regole di convalida per garantire che il pacchetto della soluzione sia formato correttamente. Inoltre, le regole verificano che il file di soluzione con estensione wsp possa essere distribuito e attivato correttamente in un server SharePoint. Per altre informazioni su XML Schema per le funzionalità, vedere Schemi delle funzionalità.

    È possibile aggiungere regole di convalida personalizzate delle funzionalità e dei pacchetti al sistema di progetto SharePoint. Per altre informazioni, vedere Procedura: Creare regole di convalida dei pacchetti e funzionalità personalizzate per le soluzioni SharePoint.

    Per altre informazioni su Packaging Explorer, vedere Procedura: Aggiungere e rimuovere funzionalità e elementi a un pacchetto tramite Esplora pacchetti.

Esplora soluzioni

È possibile usare Esplora soluzioni per spostarsi e aprire i file del progetto SharePoint. Usare il menu di scelta rapida in Esplora soluzioni per aggiungere funzionalità, ricevitori di eventi di funzionalità e risorse funzionalità. Inoltre, è possibile aprire Progettazione funzionalità e Finestre di progettazione pacchetti per configurare le funzionalità e i pacchetti per la distribuzione.

Distribuire soluzioni SharePoint

Dopo aver personalizzato le funzionalità e il pacchetto in Visual Studio, è possibile creare un file con estensione wsp da distribuire nei server SharePoint. È possibile usare Visual Studio per eseguire il debug e testare .wsp solo nel server SharePoint nel computer di sviluppo. Per altre informazioni su come distribuire le soluzioni SharePoint in un server SharePoint remoto, vedere Distribuzione di una soluzione.

È anche possibile personalizzare i passaggi di distribuzione nel computer di sviluppo. Per altre informazioni, vedere Distribuire, pubblicare e aggiornare i pacchetti della soluzione SharePoint.

Distribuire file nelle soluzioni SharePoint

In genere, quando si aggiunge un elemento di progetto SharePoint alla soluzione SharePoint, vengono inclusi tutti i file necessari. I file che possono essere compilati (file di codice) vengono incorporati nell'assembly di output della soluzione. Tuttavia, potrebbe anche essere necessario aggiungere file non compilabili, ad esempio .xml, .txt o file di risorse, a un progetto di SharePoint. Questi file non vengono inseriti automaticamente nella soluzione. Per assicurarsi che siano inseriti in un pacchetto, aggiungere i file a una cartella mappata o a un elemento di progetto SharePoint.

I file aggiunti alle cartelle mappate vengono copiati automaticamente nell'hive di SharePoint quando la soluzione viene distribuita. I file aggiunti a un elemento di progetto di SharePoint vengono distribuiti nel percorso specificato nella proprietà Percorso di distribuzione per ogni file, che viene parzialmente impostato in base alla proprietà Tipo di distribuzione. Per impostazione predefinita, il valore della proprietà Tipo di distribuzione è NoDeployment, il che significa che il file non viene distribuito con la soluzione. È necessario impostare un altro valore per la proprietà per includere il file nel pacchetto.

Ad esempio, per aggiungere un file XML a un progetto SharePoint, eseguire una di queste azioni:

  • Aggiungere una cartella mappata "Layout" di SharePoint al progetto. Viene creato in Esplora soluzioni una cartella denominata Layouts con una sottocartella per il progetto. Aggiungere il file con estensione xml alla nuova sottocartella. Per impostazione predefinita, il file viene distribuito nel file system di SharePoint in .. \TEMPLATE\LAYOUTS\<Nome> cartella. Per informazioni su come aggiungere cartelle mappate, vedere Procedura: aggiungere e rimuovere cartelle mappate.

  • Aggiungere il file xml alla cartella di un elemento di progetto SharePoint e quindi modificare la proprietà Tipo di distribuzione del file xml da NoDeployment a un'altra impostazione, ad esempio RootFile o ElementFile. L'impostazione tipo di distribuzione appropriata dipende dal file e dal progetto. Per altre informazioni sulle impostazioni delle proprietà Tipo di distribuzione, vedere Sviluppare soluzioni SharePoint.

    Se un file aggiunto non si applica a un progetto specifico nella soluzione, è possibile aggiungere un progetto SharePoint vuoto alla soluzione e quindi aggiungervi altri file. Un'altra alternativa per la distribuzione di file in SharePoint, in particolare nel database del contenuto, consiste nell'aggiungere un modulo al progetto e quindi aggiungere i file al modulo. Per altre informazioni, vedere Usare i moduli per includere i file nella soluzione.

Vedi anche