次の方法で共有


SharePoint で Oracle データベース アダプターを使用する

Visual Studio 用 WCF アダプター サービス開発ウィザードを使用すると、Microsoft BizTalk Adapter for Oracle Database と Microsoft BizTalk Adapter for Oracle E-Business Suite を Microsoft SharePoint の外部データソースとして直接使用できます。 この機能をサポートするサービス開発の追加ウィザードは、Visual Studio で新しい Visual C# Web サイトを作成するための WCF アダプター サービス テンプレートを使用して起動されます。 テンプレートは BizTalk アダプター パックに含まれています。 また、Microsoft Windows Communication Foundation (WCF) 基幹業務 (LOB) アダプター SDK もインストールする必要があります。

SharePoint 操作のサポート

アダプター サービス開発ウィザードは、Microsoft SharePoint と互換性のある Oracle アダプター用の特別なサービス コントラクトを生成します。 ウィザードは、アダプターを Microsoft SharePoint と統合するための次の操作を含むサービス コントラクトを生成します。

  • 創造する: CreateItem_操作でサポートされます。

  • 読む: ReadItem_操作でサポートされます。

  • 更新: UpdateItem_操作でサポートされます。

  • 削除: DeleteItem_操作でサポートされます。

  • クエリ: ReadList 操作でサポートされます。

  • アソシエイト: アソシエイト_操作によりサポートされます。

    次のサービス コントラクトは、例として Microsoft BizTalk Adapter for Oracle Database を使用して生成されました。 アダプターは、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);  
}  

IIS で Oracle データベースをホストする新しい Web サイトを作成する

次の手順では、WCF アダプター サービス開発ウィザードを使用して、Microsoft BizTalk Adapter for Oracle Database をホストする新しい WCF Web サービスを作成する例を示します。 サービス コントラクトには、Sharepoint と直接互換性のある操作が含まれます。 外部データソースとして直接使用できるようにします。 アダプターは、 SCOTT アカウントを使用して Oracle データベースで認証するように構成されています。 SCOTT アカウントがロックされている場合は、SYSDBA として SQL Plus にログインしてアカウントのロックを解除できます。

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

次に、次のコマンドを実行します。

SQL> ALTER USER scott ACCOUNT UNLOCK;  

新しい Web サイト プロジェクトを作成する

  1. Visual Studio を開きます。

  2. Visual Studio の [ ファイル ] メニューの [ 新規作成 ] を選択し、[ プロジェクト] をクリックします。

  3. [ 新しいプロジェクト ] ダイアログ ボックスで、[ その他の言語 ] を展開し、[ Visual C#] をクリックします。 テンプレートの一覧で WCF アダプター サービス を探し、それをクリックして選択します。

    BizTalk アダプター パック 2013 がインストールされていない場合、 WCF アダプター サービス テンプレートは使用できません。 x64 システムでは、BizTalk アダプター パック 2013 の x86 バージョンと x64 バージョンの両方をインストールします。

  4. 名前として ScottEMP を指定し、[OK] をクリック しますWCF アダプター サービス開発ウィザードが起動します。

  5. [説明] ページで [次へ] をクリックします。

  6. [ 操作の選択 ] ページで、 oracleDBBinding バインドを 指定します。

  7. [ 構成 ] ボタンをクリックします。 [ アダプターの構成 ] ダイアログが表示されます。

  8. [セキュリティ] タブで、[クライアント資格情報の種類] ドロップダウン リスト ボックスで [ユーザー名] を選択します。

  9. ユーザー名として SCOTT を入力し、SCOTT アカウントの正しいパスワードを入力します。 SCOTT アカウントの既定のパスワードは tiger です。

  10. [ URI プロパティ ] タブをクリックし、[ ServerAddress ] ボックスに Oracle サーバーの IP アドレスまたはホスト名を入力します。

  11. [ServiceName] ボックスに正しい Oracle データベース サービス インスタンス名を入力します。 Oracle Enterprise Manager からインスタンス名の情報をコピーできます。

  12. [アダプターの構成] ダイアログの [OK] ボタンを押す

  13. ウィザードの [ 操作の選択 ] ページで、[ 接続 ] ボタンをクリックし、Oracle データベース用にカテゴリがビルドされるまでしばらく待ちます。

  14. カテゴリが [ カテゴリの選択 ] リストに追加されたら、 SCOTT まで下にスクロールして展開します。 次に、[ テーブル] を展開し、 EMP テーブルエントリをクリックします。

  15. [ 利用可能なカテゴリと操作 ] ボックスの一覧で、一覧のすべての操作を選択し、[ 追加 ] ボタンをクリックします。 すべての操作が[ 追加されたカテゴリと操作 ]リストに追加されます。

  16. [ 操作の選択 ] ページで、[ 次へ ] ボタンをクリックします。

  17. [ サービスとエンドポイントの動作の構成 ] ページで、この例の UseServiceCertificate Service の動作を false に設定します。 次に、[ 次へ ] ボタンをクリックします。

  18. [ サービス エンドポイントのバインドとアドレスの構成 ] ページで、[ 適用 ] ボタンをクリックします。 次に、[ 次へ ] ボタンをクリックします。

  19. [ 概要 ] ページで、[ 完了 ] ボタンをクリックします。

  20. [ ビルド ] メニュー オプションをクリックし、[ ソリューションのビルド] をクリックします。 エラーなしでプロジェクトのビルドが成功したことを確認します。

新しいサービスを IIS に発行する

この例では、アダプター ホスト サービスをローカル IIS Web サーバーに発行します。

  1. Visual Studio のソリューション エクスプローラーで、 ScottEmp プロジェクトを右クリックし、[ プロパティ] をクリックします。 [プロジェクト デザイナー] タブが表示されます。

  2. [ Web ] タブをクリックし、[ ローカル IIS Web サーバーの使用 ] オプションをクリックします。

  3. [ 仮想ディレクトリの作成 ] ボタンをクリックします。

  4. サービス アドレス http://localhost/ScottEmp/ISCOTT_EMP.svcに Web ブラウザーを開きます。 アダプターが IIS でホストされていることを示す "サービスを作成しました" というメッセージが表示されます。

SharePoint Designer を使用して SharePoint サイトに外部データ ソースを追加する

このセクションでは、SharePoint Designer を使用して、WCF サービスを外部データ ソースとして新しい Web サイトに追加する方法について説明します。

  1. SharePoint Designer を開き、新しい Web サイトを作成します。

  2. SharePoint Designer で、[ナビゲーション] を展開し、[サイト オブジェクト] リストの [外部コンテンツ タイプ] をクリックします。

  3. [ 外部コンテンツ タイプ ] メニュー ボタンをクリックして、新しい外部コンテンツ タイプを作成します。

  4. [名前] の横にあるテキストをクリックして、新しい外部コンテンツ タイプの名前を編集します。 名前として 「OracleEMP 」と入力します。

  5. [ 外部システム ] の横にあるテキスト リンクをクリックします。このリンク をクリックすると、外部データ ソースと操作が検出されます。 OracleEMP 外部コンテンツ タイプの操作デザイナーが開きます。

  6. 検出画面で [ 接続の追加] ボタンをクリックします。

  7. [外部データ ソースの種類の選択] ダイアログで、[ WCF サービス ] を選択し、[ OK ] ボタンをクリックします。

  8. [WCF 接続] ダイアログの [ サービス メタデータ URL ] ボックスに「 https://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl

  9. サービス エンドポイント URL ボックスにhttps://localhost/ScottEmp/ISCOTT_EMP.svcを入力します。

  10. [ OK ] ボタンをクリックして、[WCF 接続] ダイアログを閉じます。

  11. データ ソース情報が設定されたら、 https://localhost/ScottEmp/ISCOTT_EMP.svc データ ソースを展開し、 Web メソッドを展開します。

  12. ReadList Web メソッドを右クリックし、[新しいリストの読み取り操作] をクリックします。 [リストの読み取り] 構成ダイアログが起動します。

  13. [読み取りリスト]ダイアログボックスで 、[戻り値パラメータ ]をクリックし、[データ ソース要素]の [EMPNO ]をクリックします。 識別子にマップをクリックします。

  14. [リストの読み取り] ダイアログで [完了] を クリックします。

  15. Ctrl + s キーを押して、新しい外部データ ソースを保存します。

外部データ ソース接続をテストする

  1. 新しい Web サイトで、[ リストとフォームの作成 ] ボタンをクリックします。 [Create List and Form for OracleEMP]\(OracleEMP のリストとフォームの作成\) ダイアログが表示されます。

  2. リスト名 に「OracleEMP_List 」と入力し、[ OK ] ボタンをクリックします。

  3. リストが作成されたら、メニューの [概要ビュー ] ボタンをクリックします。

  4. [外部リスト] の OracleEMP_List をクリックします。

  5. メニューの [ ブラウザーでプレビュー ] ボタンをクリックして、アダプターの ReadList 操作をテストします。

トラブルシューティング

  • 64 ビット コンピューターでは、32 ビットの Oracle クライアント コンポーネントもインストールされていることを確認する必要があります。 これは、Visual Studio とそのウィザードが、開発中に 32 ビット コンポーネントへのアクセスを必要とする 32 ビット プロセスとして実行されるためです。