Progettazione di un modello di integrazione applicativa dei dati

È possibile sviluppare un modello per il servizio di integrazione applicativa dei dati aggiungendo entità e metodi a un file modello. Un'entità descrive un insieme di campi dati, ad esempio può rappresentare una tabella di un database. Un metodo esegue un'attività quale l'aggiunta, l'eliminazione o l'aggiornamento dei dati rappresentati dalle entità. Per ulteriori informazioni, vedere Integrazione di dati business in SharePoint.

Aggiunta di entità

È possibile aggiungere un'entità trascinando un oggetto Entità dalla Casella degli strumenti di Visual Studio nella finestra di progettazione di integrazione applicativa dei dati. Per ulteriori informazioni, vedere Procedura: aggiungere un'entità al modello.

Definire i campi dell'entità in una classe, ad esempio aggiungere un campo denominato Address a una classe Customer. È possibile aggiungere una nuova classe al progetto o utilizzare una classe esistente creata tramite altri strumenti, ad esempio Progettazione relazionale oggetti. Il nome dell'entità e il nome della classe che rappresenta l'entità non devono corrispondere. La classe viene correlata all'entità durante la definizione dei metodi nel modello.

Aggiunta di metodi

Il servizio di integrazione applicativa dei dati chiama i metodi nel modello quando gli utenti visualizzano, aggiungono, aggiornano o eliminano informazioni in un elenco o una Web part basata sul modello. È necessario aggiungere un metodo al modello per ogni attività che l'utente può eseguire. Creare metodi selezionando uno dei cinque tipi di metodo di base nella finestra Dettagli metodo di integrazione applicativa dei dati. Nella tabella riportata di seguito vengono descritti i cinque metodi di base di un modello di integrazione applicativa dei dati:

Definizione dei parametri dei metodi

Quando si crea un metodo, in Visual Studio vengono aggiunti i parametri di input e di output adatti al tipo di metodo. Tali parametri hanno solo una funzione di segnaposto. Nella maggior parte dei casi è necessario modificarli in modo che passino o restituiscano il tipo corretto di dati. Per impostazione predefinita, un metodo Finder restituisce ad esempio una stringa. Nella maggior parte dei casi si desidera modificare il parametro restituito dal metodo Finder in modo che restituisca un insieme di entità. A tale scopo è necessario modificare il descrittore di tipo del parametro. Un descrittore di tipo è un insieme di attributi che descrive il tipo di dati di un parametro. Per ulteriori informazioni, vedere Procedura: definire il descrittore di tipo di un parametro.

In Visual Studio è possibile copiare i descrittori di tipo tra i parametri del modello. È ad esempio possibile definire un descrittore di tipo denominato CustomerTD per il parametro restituito dal metodo GetCustomer. Il descrittore di tipo CustomerTD può quindi essere copiato in Esplora integrazione applicativa dei dati e incollato nel parametro di input del metodo CreateCustomer. In questo modo si evita di definire lo stesso descrittore di tipo più volte.

Istanze di metodo

In Visual Studio quando si crea un metodo viene aggiunta un'istanza di metodo predefinita. Un'istanza di metodo è un riferimento a un metodo, con i valori predefiniti per i parametri. Un singolo metodo può includere più istanze di metodo. Ogni istanza è una combinazione di firma del metodo e set di valori predefiniti. Per ulteriori informazioni, vedere Procedura: definire il descrittore di tipo di un parametro.

Quando si esegue il progetto, vengono visualizzate istanze del metodo in un elenco a discesa sopra l'elenco di SharePoint. Gli utenti possono selezionare istanze del metodo per visualizzare i dati.

Per aggiungere valori predefiniti all'istanza del metodo, è necessario modificare direttamente il codice XML del modello. Per ulteriori informazioni, vedere DefaultValue (la pagina potrebbe essere in inglese).

Aggiunta di descrittori di filtro

I consumer del modello potrebbero desiderare di recuperare le istanze di un'entità che corrispondono ad alcuni criteri. Per abilitare questa funzionalità, è possibile aggiungere un descrittore di filtro a un metodo. I descrittori di filtro consentono ai consumer del modello di filtrare set di risultati del metodo passando valori ai metodi prima che vengano eseguiti. Per ulteriori informazioni, vedere Procedura: aggiungere parametri di filtro alle operazioni per limitare le istanze del sistema esterno (la pagina potrebbe essere in inglese).

In SharePoint sono disponibili diverse funzionalità che consentono agli utenti di specificare valori di filtro. Le Web part di integrazione applicativa dei dati offrono, ad esempio, una casella di testo di filtro. Gli utenti possono limitare i dati in un elenco digitando un valore nella casella di testo. Per ulteriori informazioni sull'aggiunta di un descrittore di filtro a un metodo, vedere Procedura: aggiungere un descrittore di filtro a un metodo Finder.

Proprietà del descrittore di filtro

È necessario impostare il valore delle proprietà Descrittori di tipo associati, Nome e Tipo di un descrittore di filtro. Tutte le altre proprietà sono facoltative.

La proprietà Descrittori di tipo associati mette in relazione il descrittore di filtro con un parametro di input. Quando un utente specifica un valore di filtro, il servizio di integrazione applicativa dei dati passa tale valore nel metodo tramite il parametro di input.

La proprietà Tipo descrive il criterio di filtro da utilizzare. In SharePoint il criterio di filtro selezionato influisce sul testo visualizzato nell'interfaccia utente. Per un criterio di filtro Criteri di confronto, ad esempio, il testo è uguale a viene visualizzato come controllo di una Web part di integrazione applicativa dei dati. Per ulteriori informazioni su ogni criterio di filtro, vedere Tipi di filtri supportati dal servizio di integrazione applicativa dei dati (la pagina potrebbe essere in inglese).

Per ulteriori informazioni sulle proprietà di un descrittore di filtro, vedere FilterDescriptor (la pagina potrebbe essere in inglese).

Specifica dei valori predefiniti

In alcuni casi l'utente potrebbe non specificare un valore di filtro. È possibile specificare un valore predefinito aggiungendolo all'istanza del metodo o impostandolo nel codice del metodo. Per ulteriori informazioni sull'aggiunta di un valore predefinito all'istanza del metodo, vedere MethodInstance (la pagina potrebbe essere in inglese). Per un esempio di come impostare il valore predefinito di un parametro di input nel codice del metodo, vedere Procedura: aggiungere un descrittore di filtro a un metodo Finder.

Convalida del modello

È possibile convalidare il modello durante lo sviluppo. In Visual Studio vengono identificati i problemi che possono impedire il comportamento previsto del modello. Tali problemi vengono visualizzati nell'Elenco errori di Visual Studio.

È possibile convalidare un modello facendo clic con il pulsante destro del mouse nella finestra di progettazione di integrazione applicativa dei dati e scegliendo Convalida. Per correggere un errore, fare doppio clic su di esso nell'elenco. Lo stato attivo dell'interfaccia utente viene impostato sul campo appropriato.

Possono verificarsi errori di convalida quando le regole del modello vengono violate in qualche modo. Se, ad esempio, la proprietà IsCollection di un descrittore di tipo viene impostata su true, ma non esistono descrittori di tipo figlio, verrà visualizzato un errore di convalida. Per comprendere alcuni errori visualizzati nell'Elenco errori di Visual Studio potrebbe essere necessario fare riferimento alle regole di un modello di integrazione applicativa dei dati. Per ulteriori informazioni sulle regole di un modello di integrazione applicativa dei dati, vedere Schema BDCMetadata (la pagina potrebbe essere in inglese).

Debug della soluzione contenente il modello

È possibile eseguire il debug del codice procedendo come per qualsiasi codice in Visual Studio. Per eseguire il debug del codice, impostare punti di interruzione nelle posizioni desiderate all'interno del codice, quindi avviare il debugger. Verrà aperto il sito di SharePoint. In SharePoint creare un elenco o una Web part che utilizzi i dati di integrazione applicativa. Sarà quindi possibile eseguire il codice un'istruzione alla volta. Per ulteriori informazioni sul debug di progetti SharePoint, vedere Risoluzione dei problemi relativi alle soluzioni SharePoint.

È possibile inoltre eseguire il debug del codice negli assembly personalizzati che si aggiungono al progetto. Tuttavia, per eseguire il debug del codice in un assembly personalizzato, è necessario aggiungere l'assembly al pacchetto della soluzione. Per ulteriori informazioni, vedere Procedura: aggiungere e rimuovere assembly aggiuntivi.

Per ulteriori informazioni sull'aggiunta di un assembly personalizzato al progetto, vedere Procedura: includere un assembly personalizzato in una funzionalità di integrazione applicativa dei dati.

Configurazione della sicurezza del servizio di integrazione applicativa dei dati

Può essere necessario modificare le impostazioni di sicurezza in SharePoint prima di eseguire il debug della soluzione. A tale scopo, aprire l'applicazione del servizio di integrazione applicativa dei dati nel sito Web di Amministrazione centrale SharePoint 2010. Nella finestra di dialogo Imposta autorizzazioni archivio metadati aggiungere l'account utente, quindi selezionare una delle opzioni seguenti:

Per ulteriori informazioni su queste impostazioni, vedere Gestione del servizio di integrazione applicativa dei dati (la pagina potrebbe essere in inglese).

È inoltre possibile impostare autorizzazioni di sicurezza per singoli modelli o per tipi di contenuto esterni. Per ulteriori informazioni su come impostare le autorizzazioni di sicurezza di un modello, vedere Gestione del modello di integrazione applicativa dei dati (la pagina potrebbe essere in inglese). Per ulteriori informazioni su come impostare le autorizzazioni di sicurezza di un tipo di contenuto esterno, vedere Gestione del tipo di contenuto esterno (la pagina potrebbe essere in inglese).

Ritrazione dei modelli danneggiati

Quando il debugger viene avviato per la prima volta, in Visual Studio l'intero modello viene distribuito in SharePoint. Successivamente il modello verrà aggiornato ogni volta in SharePoint con le eventuali modifiche apportate tra le varie distribuzioni.

In determinate circostanze potrebbe essere necessario ritrarre completamente il modello da SharePoint, ad esempio quando viene danneggiato. Per ridistribuire il modello in SharePoint, impostare la proprietà Aggiornamento incrementale del modello su False, quindi avviare il debugger. La proprietà Aggiornamento incrementale viene visualizzata nella finestra Proprietà quando si seleziona il nodo che rappresenta il modello in Esplora integrazione applicativa dei dati. Per impostazione predefinita, il nome del modello è BdcModel1.

Modifica dei nomi dell'identificatore di entità nel modello

Se si modifica il nome di un identificatore dopo avere distribuito il modello, è possibile che venga restituito un errore di distribuzione. Non è possibile correggere questo errore impostando la proprietà Aggiornamento incrementale del modello su False. È necessario recuperare manualmente il modello, quindi distribuire nuovamente la soluzione. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi alle soluzioni SharePoint. È possibile evitare questo errore impostando la proprietà Aggiornamento incrementale su False prima di distribuire inizialmente il modello.

Individuazione di documentazione per gli elementi del modello di integrazione applicativa dei dati

In Visual Studio viene aggiunto un elemento XML al modello di ogni entità, metodo o altro elemento creato. Gli attributi degli elementi vengono visualizzati come proprietà nella finestra Proprietà. Per informazioni sugli elementi e sugli attributi generati in Visual Studio durante la progettazione del modello, vedere Schema BDCMetadata (la pagina potrebbe essere in inglese).

Argomenti correlati