Procedura dettagliata: creare un campo personalizzato, un tipo di contenuto, una definizione di elenco e un'istanza di elenco

Articolo
08/11/2011

Nella procedura seguente viene illustrato come creare in SharePoint un campo personalizzato definito Nome paziente, nonché un tipo di contenuto in cui viene utilizzato il campo. Viene anche illustrato come aggiungere al progetto una definizione di elenco, con una relativa istanza, in cui vengono utilizzati il tipo di contenuto e il campo nuovi.

In questa procedura dettagliata vengono illustrate le attività seguenti:

Creazione e personalizzazione di un campo.
Creazione e personalizzazione di un tipo di contenuto in cui viene utilizzato il campo.
Creazione e personalizzazione di una definizione di elenco.
Creazione e personalizzazione di un'istanza di elenco della relativa definizione.
Visualizzazione del nuovo campo nel tipo di contenuto e nell'istanza di elenco.

Nota

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

Edizioni supportate di Microsoft Windows e SharePoint. Per ulteriori informazioni, vedere Requisiti per lo sviluppo di soluzioni SharePoint.
Visual Studio 2010.

Creazione di un elemento del campo personalizzato

Creare innanzitutto un elemento del campo personalizzato come progetto SharePoint in Visual Studio denominato Nome paziente.

Per creare un elemento del campo personalizzato

Visualizzare la finestra di dialogo Nuovo progetto selezionando Nuovo nel menu File, quindi facendo clic su Nuovo progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.
Fare clic su Progetto SharePoint vuoto nel riquadro Modelli, modificare il nome del progetto in CustomField1, quindi fare clic su OK.

Viene visualizzata la Personalizzazione guidata SharePoint. Il modello Progetto vuoto viene utilizzato per gli elementi del campo personalizzato per i quali non è disponibile alcun modello specifico.
Nella pagina Specificare il sito e il livello di sicurezza per il debug immettere l'URL per il sito del server SharePoint a cui si desidera aggiungere il nuovo elemento del campo personalizzato o utilizzare il percorso predefinito (http://<system name>/).
Nella sezione Selezionare il livello di attendibilità per la soluzione SharePoint utilizzare il valore predefinito Distribuisci come soluzione creata mediante sandbox.

Per ulteriori informazioni sulle soluzioni create mediante sandbox e quelle della farm, vedere Considerazioni sulle soluzioni create mediante sandbox.
Scegliere Fine. Il progetto dovrebbe essere visualizzato in Esplora soluzioni.
Aggiungere un elemento del progetto Elemento vuoto al progetto. A tal fine, fare clic sul nodo di progetto del campo (CustomField1) in Esplora soluzioni, quindi scegliere Aggiungi nuovo elemento dal menu Progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.
Nel riquadro Modelli selezionare Elemento vuoto, mantenere il nome predefinito EmptyElement1, quindi fare clic su Aggiungi.

Nel file Elements.xml in EmptyElement1 aggiungere quanto riportato di seguito dopo il tag <Elements>:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>

In questo modo viene aggiunto un campo denominato Nome paziente.

Importante
Quando si aggiunge un campo personalizzato, è necessario specificare gli attributi ID, Tipo, Nome, DisplayName e Gruppo affinché il campo venga visualizzato correttamente in SharePoint. Il completamento delle istruzioni indica erroneamente che sono necessari solo i primi tre attributi quando in effetti sono richiesti tutti e cinque gli attributi.

Premere F5 per eseguire e distribuire il progetto in SharePoint.

Se viene visualizzato un messaggio indicante che il debug degli script è disabilitato, fare clic su Sì per continuarlo.
Se si tratta del primo debug di un'applicazione Web in Visual Studio, verrà richiesto se si desidera modificare il file di configurazione Web per attivare il debug. Scegliere Sì.
Nella parte superiore della pagina Web di SharePoint fare clic sul pulsante Azioni sito, quindi scegliere Impostazioni sito.
Nella sezione Raccolte della pagina Impostazioni sito fare clic sul collegamento Colonne del sito.
Nella pagina Raccolta colonne del sito scorrere verso il basso fino all'intestazione Colonne personalizzate e notare il nuovo elemento del campo aggiunto, ovvero Nome paziente.
Chiudere il browser.

Creazione di un tipo di contenuto personalizzato

Creare un tipo di contenuto, basato sull'elenco Contatti di SharePoint, in cui viene utilizzato il nuovo campo creato nella procedura precedente.

Per creare un tipo di contenuto personalizzato

Aggiungere un tipo di contenuto al progetto. A tal fine, fare clic sul nodo del progetto in Esplora soluzioni, quindi scegliere Aggiungi nuovo elemento dal menu Progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.
Nel riquadro Modelli selezionare Tipo di contenuto e utilizzare il nome predefinito, ovvero ContentType1.
In Personalizzazione guidata SharePoint selezionare Contatto come tipo di contenuto sul quale basare il nuovo, quindi scegliere Fine.

Questa operazione consente di aprire il file Elements.xml del tipo di contenuto per modificarlo.
Nella sezione <FieldRefs> di Elements.xml copiare e incollare quanto riportato di seguito:
```
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>
```
L'ID di FieldRef utilizzato in questo argomento si riferisce all'ID del campo creato per il campo personalizzato.
Premere F5 per eseguire e distribuire il progetto.
Nella parte superiore della pagina Web di SharePoint fare clic sul pulsante Azioni sito, quindi scegliere Impostazioni sito.
Nella sezione Raccolte della pagina Impostazioni sito fare clic sul collegamento Tipi di contenuto del sito.
Nella pagina Raccolta tipi di contenuto del sito notare il nuovo tipo di contenuto appena creato, ovvero CustomField1 - ContentType1. Fare clic su di esso per visualizzarne i campi. Nell'elenco di campi per CustomField1 - ContentType1 notare che è stato aggiunto il campo Nome paziente.
Chiudere il browser.

Creazione di una definizione e di un'istanza di elenco

Creare una definizione e un'istanza di elenco in cui verranno utilizzati il nuovo tipo di contenuto e il campo. Poiché si desidera che la definizione di elenco venga generata in base al tipo di contenuto appena creato, si utilizzerà il modello di elemento del progetto Definizione di elenco da tipo di contenuto.

Per creare una definizione e un'istanza di elenco

Aggiungere una definizione di elenco al progetto. A tal fine, fare clic sul nodo del progetto in Esplora soluzioni, quindi scegliere Aggiungi nuovo elemento dal menu Progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.
Nel riquadro Modelli selezionare Definizione di elenco da tipo di contenuto e utilizzare il nome predefinito, ovvero ListDefinition1.
Nella casella Selezionare il nome visualizzato della definizione di elenco lasciare il valore predefinito CustomField1 - ListDefinition1.
Nell'elenco Selezionare il tipo di contenuto da utilizzare per la definizione di elenco utilizzare solo il valore predefinito CustomField1 - ContentType1.

Questa operazione consente di creare una definizione di elenco personalizzabile basata sul nuovo elenco Contatti modificato.
Selezionare la casella Aggiungi un'istanza di elenco per la definizione di elenco per aggiungere un elemento del progetto di istanza di elenco al progetto. L'istanza di elenco sarà un'istanza della nuova definizione di elenco.
Scegliere Fine. La definizione di elenco dovrebbe essere visualizzata in Esplora soluzioni.

Personalizzazione della definizione di elenco

Personalizzare la definizione di elenco aggiungendovi un nuovo campo denominato Nome paziente.

Importante
Il valore dell'attributo Name nel file Elements.xml della definizione di elenco deve corrispondere al nome della cartella dell'elemento del progetto di definizione di elenco, altrimenti durante l'esecuzione del progetto si verificherà un errore. Per assicurarsi che l'attributo Name corrisponda al nome della cartella, viene utilizzato il parametro sostitutivo (o token) $ProjectItemName$. Quando il progetto SharePoint viene assemblato e distribuito, questo token viene convertito nell'effettivo nome della cartella della definizione di elenco. Se l'attributo Name viene impostato su un valore diverso rispetto a questo token, l'applicazione potrebbe non funzionare correttamente. Per ulteriori informazioni, vedere Parametri sostituibili.

Il valore dell'attributo Name nel file Elements.xml della definizione di elenco deve corrispondere al nome della cartella dell'elemento del progetto di definizione di elenco, altrimenti durante l'esecuzione del progetto si verificherà un errore. Per assicurarsi che l'attributo Name corrisponda al nome della cartella, viene utilizzato il parametro sostitutivo (o token) $ProjectItemName$. Quando il progetto SharePoint viene assemblato e distribuito, questo token viene convertito nell'effettivo nome della cartella della definizione di elenco. Se l'attributo Name viene impostato su un valore diverso rispetto a questo token, l'applicazione potrebbe non funzionare correttamente. Per ulteriori informazioni, vedere Parametri sostituibili.

Per aggiungere un campo alla definizione di elenco

In Esplora soluzioni fare doppio clic sul file Schema.xml in ListDefinition1 per visualizzarlo.

Nel file Schema.xml sono definiti tutti i campi e gli altri elementi della definizione di elenco, ad esempio nome e indirizzo. Si noti che in corrispondenza dell'elemento <Fields> all'inizio del file la definizione del campo seguente è stata aggiunta dal tipo di contenuto:
```
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE" />
```
Premere F5 per eseguire e distribuire il progetto.
Sotto la sezione Elenchi della barra Avvio veloce di SharePoint fare clic sul collegamento CustomField1 - ListInstance1.

Si tratta dell'istanza di elenco per la nuova definizione di elenco. Si noti che il nuovo campo Nome paziente non viene ancora visualizzato come colonna nell'istanza di elenco.
Scegliere Elenco dalla scheda del menu Strumenti elenco nella parte superiore della pagina, quindi fare clic sul pulsante Modifica visualizzazione nella barra multifunzione.
Nell'elenco di nomi di colonne disponibili selezionare Nome paziente, quindi scegliere OK. Notare che il campo Nome paziente adesso viene visualizzato nell'istanza di elenco.