Usare l'adapter di database Oracle con SharePoint

Articolo
07/21/2023

La Creazione guidata servizio adapter WCF per Visual Studio consente di utilizzare direttamente l'adapter Microsoft BizTalk per Oracle Database e l'adapter Microsoft BizTalk per Oracle E-Business Suite come origine dati esterna in Microsoft SharePoint. L'Aggiunta guidata sviluppo di servizi che supporta questa funzionalità viene avviata con il modello servizio adapter WCF per la creazione di un nuovo sito Web Visual C# in Visual Studio. Il modello è incluso in BizTalk Adapter Pack. È inoltre necessario installare Microsoft Windows Communication Foundation (WCF) Line of Business Adapter SDK ( LOB).

Supporto delle operazioni di SharePoint

La procedura guidata Sviluppo servizio adapter genera un contratto di servizio speciale per gli adattatori Oracle compatibili con Microsoft SharePoint. La procedura guidata genererà un contratto di servizio che include le operazioni seguenti per l'integrazione dell'adattatore con Microsoft SharePoint:

Creare: Supportato dall'operazione di CreateItem_.
Leggere: Supportato dall'operazione di ReadItem_.
Aggiornamento: Supportato dall'operazione di UpdateItem_.
Elimina: Supportato dall'operazione di DeleteItem_.
Query: Supportato dall'operazione ReadList.
Associare: Supportato dall'operazione Associate_.

Il contratto di servizio seguente è stato generato usando per l'adapter Microsoft BizTalk per Oracle Database come esempio. L'adattatore è configurato per fornire l'accesso alla tabella EMP

    [System.ServiceModel.ServiceContractAttribute()]  
    public interface ISCOTT_EMP {  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadList(System.Nullable<int> Limit);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void CreateItem(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void UpdateItem_EMPNO(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void DeleteItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] Associate_DEPTNO(System.Nullable<decimal> DEPTNO);  
}

Creare un nuovo sito Web per ospitare il database Oracle in IIS

Questi passaggi forniscono un esempio di utilizzo della Creazione guidata servizio adapter WCF per creare un nuovo servizio Web WCF che ospita l'adapter Microsoft BizTalk per Oracle Database. Il contratto di servizio includerà operazioni direttamente compatibili con SharePoint. In modo che possa essere utilizzata direttamente come origine dati esterna. L'adapter è configurato per l'autenticazione con il database Oracle usando l'account SCOTT . Se l'account SCOTT è bloccato, è possibile sbloccare l'account accedendo a SQL Plus come SYSDBA.

<Oracle Installation Bin Directory>\Sqlplus.exe SYS AS SYSDBA

Quindi eseguire il comando seguente.

SQL> ALTER USER scott ACCOUNT UNLOCK;

Creare il nuovo progetto sito Web

Aprire Visual Studio.
In Visual Studio scegliere Nuovo dal menu File e quindi fare clic su Progetto.
Nella finestra di dialogo Nuovo progetto espandere Altri linguaggi e fare clic su Visual C#. Trovare il servizio adapter WCF nell'elenco dei modelli e fare clic su di esso per selezionarlo.

Nota

Il modello del servizio adapter WCF non è disponibile se l'adapter BizTalk Pack 2013 non è installato. Nei sistemi x64 installare sia le versioni x86 che x64 di BizTalk Adapter Pack 2013.
Specificare ScottEMP come nome e quindi fare clic su OK. Viene avviata la Creazione guidata servizio adapter WCF .
Nella pagina Introduzione fare clic su Avanti.
Nella pagina Scegli operazioni specificare l'associazione oracleDBBinding .
Fare clic sul pulsante Configura . Viene visualizzata la finestra di dialogo Configura adattatore .
Nella scheda Sicurezza selezionare Nome utente nella casella di riepilogo a discesa Tipo di credenziale client .
Immettere SCOTT come Nome utente e immettere la password corretta per l'account SCOTT. La password predefinita per l'account SCOTT è tiger.
Fare clic sulla scheda Proprietà URI , immettere l'indirizzo IP o il nome host per il server Oracle nella casella ServerAddress .
Immettere il nome corretto dell'istanza del servizio di database Oracle nella casella ServiceName . È possibile copiare le informazioni sul nome dell'istanza da Oracle Enterprise Manager.
Premere il pulsante OK nella finestra di dialogo Configura adattatore
Nella pagina Scegli operazioni della procedura guidata fare clic sul pulsante Connetti e attendere alcuni istanti per la compilazione delle categorie per il database Oracle.
Dopo aver aggiunto le categorie nell'elenco Selezionare una categoria , scorrere verso il basso fino a SCOTT ed espanderlo. Espandere quindi Tabella e fare clic sulla voce della tabella EMP .
Nell'elenco Categorie e operazioni disponibili selezionare tutte le operazioni nell'elenco e fare clic sul pulsante Aggiungi . Tutte le operazioni vengono aggiunte all'elenco Categorie e operazioni aggiunte .
Nella pagina Scegli operazioni fare clic sul pulsante Avanti .
Nella pagina Configura comportamenti di servizio ed endpoint impostare il comportamento del servizio UseServiceCertificatesu false per questo esempio. Fare quindi clic sul pulsante Avanti .
Nella pagina Configura associazione e indirizzo dell'endpoint di servizio fare clic sul pulsante Applica . Fare quindi clic sul pulsante Avanti .
Nella pagina Riepilogo fare clic sul pulsante Fine .
Fare clic sull'opzione di menu Compila e quindi su Compila soluzione. Verificare che la compilazione del progetto sia riuscita senza errori.

Pubblicare il nuovo servizio in IIS

Per questo esempio si pubblicherà il servizio host dell'adapter nel server Web IIS locale.

In Esplora soluzioni per Visual Studio fare clic con il pulsante destro del mouse sul progetto ScottEmp e scegliere Proprietà. Vengono visualizzate le schede project Designer.
Fare clic sulla scheda Web e quindi sull'opzione Usa server Web IIS locale .
Fare clic sul pulsante Crea directory virtuale .
Aprire un Web browser per l'indirizzo http://localhost/ScottEmp/ISCOTT_EMP.svcdel servizio . Dovrebbe essere visualizzato un messaggio che indica che è stato creato un servizio, che indica che l'adapter è ospitato in IIS.

Aggiungere l'origine dati esterna a un sito di SharePoint tramite SharePoint Designer

Questa sezione descrive come aggiungere il servizio WCF come origine dati esterna a un nuovo sito Web tramite SharePoint Designer.

Aprire SharePoint Designer e creare un nuovo sito Web.
In SharePoint Designer espandere Navigazione e fare clic su Tipi di contenuto esterno nell'elenco Oggetti sito.
Fare clic sul pulsante di menu Tipo di contenuto esterno per creare un nuovo tipo di contenuto esterno.
Fare clic sul testo accanto a Nome per modificare il nome del nuovo tipo di contenuto esterno. Immettere OracleEMP come nome.
Fare clic sul collegamento di testo accanto a Sistema esterno, che indica Fare clic qui per individuare origini dati e operazioni esterne. Verrà aperto il Designer Operation per il tipo di contenuto esterno OracleEMP.
Fare clic sul pulsante Aggiungi connessione nella schermata di individuazione.
Nella finestra di dialogo Selezione tipo origine dati esterna scegliere Servizio WCF e fare clic sul pulsante OK .
Nella finestra di dialogo Connessione WCF immettere nella casella URL metadati del serviziohttps://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl
Nella casella URL endpoint di servizio immettere https://localhost/ScottEmp/ISCOTT_EMP.svc
Fare clic sul pulsante OK per chiudere la finestra di dialogo Connessione WCF.
Dopo aver popolato le informazioni sull'origine dati, espandere l'origine https://localhost/ScottEmp/ISCOTT_EMP.svc dati ed espandere Metodi Web.
Fare clic con il pulsante destro del mouse sul metodo Web ReadList e scegliere Nuova operazione elenco di lettura. Viene avviata la finestra di dialogo di configurazione Leggi elenco.
Nella finestra di dialogo Leggi elenco fare clic su Parametri restituiti e fare clic su EMPNO negli elementi origine dati. Fare clic sul mapping all'identificatore.
Fare clic su Fine nella finestra di dialogo Leggi elenco.
Salvare la nuova origine dati esterna digitando CTRL+s.

Testare la connessione all'origine dati esterna

Nel nuovo sito Web fare clic sul pulsante Crea elenchi e moduli . Viene visualizzata la finestra di dialogo Crea elenco e modulo per OracleEMP.
Immettere OracleEMP_List per Nome elenco e fare clic sul pulsante OK .
Dopo aver creato l'elenco, fare clic sul pulsante Visualizzazione riepilogo nel menu.
Fare clic su OracleEMP_List in Elenchi esterni.
Fare clic sul pulsante Anteprima nel browser nel menu per testare l'operazione ReadList dell'adattatore.

Risolvere problemi

Nei computer a 64 bit è necessario assicurarsi che siano installati anche i componenti client Oracle a 32 bit. Ciò è dovuto al fatto che Visual Studio e le procedure guidate verranno eseguite come processo a 32 bit che richiede l'accesso ai componenti a 32 bit durante lo sviluppo.

Condividi tramite