Passaggio 2: Creare un file di definizione dell'applicazione per le operazioni del componente business Siebel

Tempo di completamento: 15 minuti

Obiettivo: L'Data Catalog aziendale espone e incorpora i dati dalle applicazioni line-of-business (LOB) nei portali. Per incorporare questi dati nel sito portale, è necessario compilare un file di definizione dell'applicazione utilizzabile da Microsoft Office SharePoint Server.

Lo strumento Editor definizione Data Catalog business consente di creare un file di definizione dell'applicazione per il Data Catalog aziendale. Questo strumento genera automaticamente il codice XML per il file di definizione. Pertanto, non è necessario creare manualmente il file in un editor XML.

Lo scopo dell'applicazione Microsoft Office SharePoint Server che si sta creando consiste nell'eseguire un'operazione di query sul componente Business account per recuperare un elenco di record. A tale scopo, è necessario completare un set di attività nell'Editor definizione di business Data Catalog. In questo argomento vengono fornite istruzioni su come eseguire queste attività.

Prerequisiti

• È necessario che l'Editor definizione Data Catalog business sia installato come parte di Microsoft Office SharePoint Server 2007 SDK.

• È necessario aver pubblicato il servizio WCF, come descritto nel passaggio 1: Pubblicare le operazioni del componente business Siebel come servizio WCF.

Creazione di un file di definizione dell'applicazione

In questa sezione vengono fornite istruzioni dettagliate per creare un file di definizione dell'applicazione per il servizio WCF.

Connettersi al servizio WCF e creare entità

È necessario connettersi al servizio WCF per estrarre il linguaggio WSDL (Web Services Description Language) per il servizio. Da WSDL, l'Editor definizione Data Catalog business estrae i metodi. Questi metodi possono essere usati per creare entità. Per questo esempio, è necessario creare un'entità per l'operazione di query nel componente Account business.

Per connettersi al servizio WCF e creare entità

1. Avviare l'Editor definizione Data Catalog business. Nel menu Start fare clic su Microsoft Business Data Catalog Definition Editor.

2. Nello strumento fare clic su Aggiungi sistema LOB.

3. Nella finestra Aggiungi sistema LOB fare clic su Connetti al servizio Web.

4. Nella casella URL digitare l'URL per il servizio WCF. L'URL deve essere nel formato seguente:

   https://<computer_name>/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl
   

   dove, BusinessObjects_Account_Account_Operation.svc è il file di servizio creato per il contratto Siebel.

   L'URL che è necessario digitare è disponibile quando si verifica se il servizio WCF viene pubblicato correttamente, come descritto nel passaggio 1: Pubblicare le operazioni del componente business Siebel come servizio WCF.

5. Fare clic su Connetti.

6. Fare clic sulla scheda Aggiungi metodo Web per visualizzare le operazioni selezionate nella Creazione guidata servizio adapter WCF. Verrà visualizzato il metodo Query .

   

7. Trascinare il metodo Query nell'area di progettazione e quindi fare clic su OK.

8. Nella finestra di dialogo Immettere il nome del sistema LOB digitare un nome nella casella Nome sistema LOB . Per questo esempio, digitare Siebel_Accounte quindi fare clic su OK. Un'entità, Entity0, viene creata nell'Editor definizione Data Catalog business.

   Importante

   Lo strumento Editor definizione Data Catalog business non gestisce i tipi di dati enumerati. Lo strumento Editor definizione Data Catalog business importa quindi i campi finché non rileva un tipo di dati enumerato e ignora i campi rimanenti. Lo strumento Editor definizione Data Catalog business restituisce anche un errore. È possibile ignorare questo errore e continuare facendo clic su OK. È possibile aggiungere manualmente i campi obbligatori nel file di definizione dell'applicazione in una fase successiva.

9. Modificare i nomi delle entità in modo da usare nomi più descrittivi. Per questo esempio modificare Entity0 in Account.

   1. Espandere il nodo Siebel_Account e quindi espandere il nodo Entità .

   2. Selezionare il nodo Entity0 .

   3. Nel riquadro Proprietà digitare Account nel campo Nome .

      

Specificare le intestazioni di nome utente e password per i metodi

Quando si crea un servizio WCF per le operazioni del componente business selezionato nel sistema Siebel, sono state specificate intestazioni di nome utente e password come parte della configurazione del comportamento dell'endpoint (passaggio 1: Pubblicare le operazioni del componente business Siebel come servizio WCF). È necessario specificare gli stessi valori per le proprietà del metodo.

Per specificare le intestazioni di nome utente e password per il metodo Query

1. Nel riquadro Oggetti metadati espandere il nodo Account e quindi espandere il nodo Metodi .

2. Fare clic sul nodo Query e nel riquadro Proprietà fare clic sul pulsante con i puntini di sospensione (...) nel campo Proprietà .

3. Nella finestra di dialogo Editor raccolta PropertyView fare clic su Aggiungi e nel riquadro Proprietà digitare HttpHeaderUserName per il campo Nome . Analogamente, digitare MyUserHeader per il campo PropertyValue . Selezionare System.String per il campo Tipo .

   

4. Nella finestra Editor raccolta PropertyView fare clic su Aggiungi e nel riquadro Proprietà digitare HttpHeaderPassword per il campo Nome . Analogamente, digitare MyPassHeader per il campo PropertyValue . Selezionare System.String per il campo Tipo .

5. Fare clic su OK.

Configurare una singola Sign-On per la connessione a un sistema Siebel

Al termine dell'esecuzione di tutte le procedure descritte in questo argomento, sarà stato creato un XML di definizione dell'applicazione che può essere importato in un'applicazione SharePoint. Dall'applicazione si richiameranno le operazioni del componente aziendale Siebel (esposte come metodi Web) per recuperare i dati pertinenti dal sistema Siebel. Per abilitare questa operazione, è necessario creare un mapping tra un utente nel sistema Siebel e l'utente nell'applicazione SharePoint. Questo mapping viene creato nel sito Web Amministrazione centrale SharePoint dopo aver importato il codice XML di definizione dell'applicazione.

Per creare il mapping, tuttavia, è necessario impostare una proprietà SecondarySsoApplicationId nell'editor di definizione di Business Data Catalog.

Per impostare la proprietà SecondarySsoApplicationId

1. Nel riquadro Oggetti metadati espandere il nodo Siebel_Account e quindi espandere il nodo Istanze .

2. Fare clic su Siebel_Account_Instance e nel riquadro Proprietà fare clic sul pulsante con i puntini di sospensione (...) nel campo Proprietà .

3. Nella finestra Editor raccolta PropertyView fare clic su Aggiungi e nel riquadro Proprietà digitare SecondarySsoApplicationId per il campo Nome . Analogamente, digitare SiebelSSO per il campo PropertyValue . Selezionare System.String per il campo Tipo .

   

4. Fare clic su OK.

Requisito: eseguire un'operazione di query nel componente Account Business

Il primo requisito di questo esempio consiste nel creare una definizione di applicazione che può essere usata per eseguire un'operazione di query sul componente Business account. Per ottenere questo requisito, è necessario eseguire il set di attività seguente:

• Nel metodo Query creare un filtro ed eseguirne il mapping al parametro in cui viene eseguita l'operazione Query. Per il componente Account business, si eseguirà una query usando il parametro SearchExpr . Si eseguirà quindi il mapping del filtro al parametro SearchExpr .

• Creare un'istanza del metodo Finder per il metodo Query. Un metodo Finder recupera un elenco di record in base a un filtro.

Per creare un filtro ed eseguirne il mapping al parametro SearchExpr

1. Creare un filtro per il metodo Query.

   1. Nel riquadro Oggetti metadati espandere il nodo Account e quindi espandere il nodo Metodi .

   2. Espandere il metodo Query, fare clic con il pulsante destro del mouse su Filtri e quindi scegliere Aggiungi filtro.

      

   3. Nel riquadro Proprietà digitare SearchExpression per il campo Nome .

   4. Per la proprietà FilterType selezionare Uguale a.

      

2. Eseguire il mapping del filtro al parametro SearchExpr nel metodo Query.

   1. Nel riquadro Oggetti metadati espandere il nodo Account e quindi espandere il nodo Metodi .

   2. Espandere il metodo Query e quindi espandere il nodo Parametri .

   3. Espandere il nodo AccountQueryInputRecord e quindi espandere il secondo nodo AccountQueryInputRecord .

   4. Fare clic sul nodo SearchExpr e nel riquadro Proprietà selezionare SearchExpression nell'elenco FilterDescriptor.

      

      Importante

      AccountQueryInputRecord contiene anche un nodo QueryFields, che a sua volta contiene un nodo Item. È necessario eliminare il nodo Elemento . In caso contrario, l'operazione di query sul componente Business account potrebbe non fornire i risultati desiderati. Per eliminare il nodo Elemento , fare clic con il pulsante destro del mouse sul nodo e quindi scegliere Elimina.

Per creare un'istanza del metodo Finder per il metodo Query

1. Nel riquadro Oggetti metadati espandere il nodo Account e quindi espandere il nodo Metodi .

2. Espandere il nodo Query , fare clic con il pulsante destro del mouse su Istanze e quindi scegliere Aggiungi istanza del metodo per aprire la finestra Crea istanza del metodo.

   

3. Nella finestra Crea istanza del metodo fare clic su Finder per Il tipo di istanza del metodo.

4. Fare clic su Return from Return TypeDescriptor section . Click Return from Return TypeDescriptor section.

   

5. Fare clic su OK.

6. Nel riquadro Proprietà digitare QueryAccount per il campo Nome .

   

Rimuovere i parametri del tipo System.Nullable

I parametri restituiti per la funzione Query possono contenere parametri di tipo System.Nullable. A causa della presenza di questi parametri nella definizione dell'applicazione, è possibile che venga visualizzato un errore durante la presentazione di dati Siebel in un portale di SharePoint. È quindi necessario rimuovere i parametri del tipo System.Nullable dalla definizione dell'applicazione.

Inoltre, per ogni parametro di tipo System.Nullable, Business Data Catalog Definition Editor crea un altro parametro di tipo System.Boolean e aggiunge "Specified" al nome del parametro. Ad esempio, il parametro AccountRole è di tipo System.Nullable. L'editor di definizione business Data Catalog aggiunge quindi un parametro AccountRoleSpecified all'elenco di parametri. È necessario rimuovere anche tali parametri.

Nota

È possibile visualizzare il tipo di parametro selezionando il parametro nell'Editor definizione Data Catalog business e esaminando il valore della proprietà TypeName nel riquadro Proprietà.

Nota

È possibile ignorare questo passaggio se l'applicazione non contiene parametri di tipo System.Nullable.

Per rimuovere i parametri del tipo System.Nullable per il metodo Query

1. Nel riquadro Oggetti metadati espandere il nodo Account e quindi espandere il nodo Metodi .

2. Espandere il nodo Query e quindi espandere il nodo Parametri .

3. Espandere il nodo Return (Restituisce ) e quindi espandere il secondo nodo Return (Restituisci ).

4. Fare clic con il pulsante destro del mouse sul parametro da eliminare e quindi scegliere Elimina.

5. Nella finestra di dialogo fare clic su OK.

Esportare la definizione dell'applicazione in un file

È stata creata una definizione dell'applicazione che contiene i metadati dell'istanza di sistema Siebel. È necessario esportare questa definizione in un file XML, che può essere importato in Microsoft Office SharePoint Server.

Per esportare la definizione dell'applicazione in un file

1. Fare clic con il pulsante destro del mouse sul nodo Siebel_Account nel riquadro Oggetti metadati e quindi scegliere Esporta.

2. Salvare il file come Siebel_Account.xml.

Modificare il file di definizione dell'applicazione in modo da includere parametri specifici

Come accennato in precedenza in questo argomento, lo strumento Editor definizione Data Catalog business non gestisce i tipi di dati enumerati. Lo strumento Editor definizione Data Catalog business importa i campi finché non rileva un tipo di dati enumerato e ignora i campi rimanenti. Alcuni campi desiderati nell'applicazione potrebbero quindi essere omessi. È possibile modificare manualmente il file di definizione dell'applicazione in modo da includere tali campi.

Nota

È necessario assicurarsi che i parametri aggiunti siano presenti nel file con estensione cs generato dalla Creazione guidata servizio adapter WCF nel passaggio 1: Pubblicare le operazioni del componente business Siebel come servizio WCF.

In questo file di definizione dell'applicazione verranno aggiunti o rimossi parametri restituiti per il metodo QueryAccount .

Per modificare il file di definizione dell'applicazione

1. Aprire il file di definizione dell'applicazione, Siebel_Account.xml, usando Visual Studio o qualsiasi altro editor.

2. Modificare il file di definizione dell'applicazione per sostituire i parametri per il metodo QueryAccount .

   1. Nel file di definizione dell'applicazione cercare quanto segue:

      <TypeDescriptor TypeName="BDC.AccountQueryRecord,Siebel_Account" Name="Item">
      

   2. All'interno del <TypeDescriptors> tag sostituire gli elementi esistenti <TypeDescriptor> con gli elementi seguenti:

      
      <TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Id" />
      <TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Country" />
      <TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Name" />
      <TypeDescriptor TypeName="System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=<token>" Name="Location" />
      

   3. Salvare e chiudere il file.

   Suggerimento

   È possibile importare di nuovo il file di definizione dell'applicazione aggiornato nello strumento Editor definizione Data Catalog business per visualizzare i campi appena aggiunti. Tuttavia, prima di importare, è necessario rimuovere l'applicazione "Siebel_Account" esistente dallo strumento Editor definizione Data Catalog business.

Passaggi successivi

È ora necessario creare un'applicazione SharePoint per recuperare i dati da un sistema Siebel. Per istruzioni, vedere Passaggio 3: Creare un'applicazione SharePoint per recuperare dati da Siebel .

Vedere anche

Esercitazione 1: Presentazione di dati da un sistema Siebel in un sito di SharePoint