1. Oracle BI PublisherのREST API
  2. クイック・スタート

クイック・スタート

REST APIを使用して環境を設定し、Oracle BI Publisherの最初のレポートを作成するには、次の手順を実行します。

  • 手順1 アカウント情報の取得

  • 手順2 cURLのインストール

  • 手順3 レポートの詳細の取得

手順1: アカウント情報の取得

アカウント管理者から、REST APIを使用してレポートを管理できる適切なアカウント資格証明を取得します。具体的には、次のものが必要となります。

  • Oracle BI Publisherのユーザー名とパスワード

  • Oracle BI PublisherインスタンスのURL。

手順2: cURLのインストール

このドキュメント内の例では、cURLコマンド行ツールを使用して、Oracle BI PublisherのREST APIにアクセスする方法を示しています。

サーバーに安全に接続するには、Verisign CA証明書に対して信頼できることを証明するSSL認証局(CA)の証明書ファイルまたはバンドルを備えたSSL対応バージョンのcURLをインストールする必要があります。関連項目:

Windows 64ビット・システムにcURLをインストールするには、次の手順を実行します。

  1. ブラウザで、cURLホーム・ページ(http://curl.haxx.se)に移動し、左のナビゲーション・メニューで「Download」をクリックします。

  2. 「cURL Releases and Downloads」ページで、使用しているオペレーティング・システムに対応したcURLソフトウェアのSSL対応バージョンを見つけ、ZIPファイルをダウンロードするリンクをクリックしてソフトウェアをインストールします。

  3. 「cURL CA Certs」ページ(http://curl.haxx.se/docs/caextract.html)にナビゲートし、cURLをインストールしたフォルダにca-bundle.crt SSL CA証明書バンドルをダウンロードします。

  4. コマンド・ウィンドウを開いて、cURLをインストールしたディレクトリにナビゲートし、cURL環境変数CURL_CA_BUNDLEをSSL認証局(CA)証明書バンドルの場所に設定します。次に例を示します。

    C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

これで、cURLを使用してOracle BI Publisherにリクエストを送信する準備ができました。

手順3: レポートの詳細の取得

次のcURLコマンドを実行して既存のレポート定義を返します。

curl --u username:password -H "Accept:application/json" -X GET http://host:port/xmlpserver/services/rest/v1/reports/<reportPath>

たとえば、/Sample Lite/Published Reporting/Reports/Balance Letterにあるレポート定義を取得するには、次のようにします。

curl --u jsmith:mypassword1 -H "Accept:application/json" -X GET http://example.com/xmlpserver/services/rest/v1/reports/%2FSample%20Lite%2FPublished%20Reporting%2FReports%2FBalance%20Letter