Workiva サポートセンター

Oracle® Essbase® コネクターでは、コマンド をチェーンで使用して Oracle Essbase と対話することができます。例えば、このコネクターを使えば、次のことができる：

• Oracle Essbaseでの計算、MaxL、レポートスクリプトの実行
• Essbaseデータベース、アプリケーション、変数のリストと管理
• Oracle Essbaseでのファイルのアップロード、ダウンロード、削除

メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。

前提条件

接続を有効にするには、コネクターは Oracle Essbase Java® API を使用し、基本ユーザー名とパスワード認証で保護されます。接続を設定するには、以下のものが必要です：

• コネクターに設定されたGroundRunner
• Oracle Essbaseでコネクター用に設定された統合ユーザー
• 統合ユーザーの認証情報
• 統合ユーザーは、コネクターが実行するコマンドに適用される権限を持っている必要があります。
• 接続するEssbaseインスタンスのベースURL
• 接続するEssbaseクラスタの名称。
• EssbaseクライアントJavaアーカイブ（JAR）ファイルへのパス：
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Essbaseインスタンスが埋め込みモードを有効にしているかどうか

互換性に関する通知： Workiva は、このコネクターをバージョン 11.1.2.2.x、11.1.2.3、11.1.2.4、および 11.2 でのみテストおよび検証しました。Workiva は、未テストのバージョンでこのコネクターが希望どおりに動作することを保証できません。

EssbaseクライアントJARファイルの場所

接続を有効にするには、コネクターは Oracle Essbase インストールにあるクライアント JAR ファイルを必要とします。

• Microsoft® Windows® のデフォルトパス：C:㊟EssbaseJavaAPI<version_#> ㊟lib
• Linuxのデフォルトパス：/ユーザー名/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib。

GroundRunner と Oracle Essbase が異なるサーバーにインストールされている場合は、JAR ファイルを GroundRunner のサーバー上のフォルダにコピーし、コネクタのJava API Path プロパティにフォルダへのパスをメモします。

Oracle Essbase コネクターの設定

注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。

1. チェーンビルダー から、接続 compare_arrows をクリックし、右上の作成 をクリックします。
2. Connector Connection で、Oracle Essbase と、コネクターで使用する GroundRunner を選択します。
   
3. [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。

4. プロパティ で、コネクターの詳細を入力します：
   

   プロパティ	詳細
   ユーザー名称	コネクターの Essbase 統合ユーザーのユーザー名を入力します。
   パスワード	User Nameプロパティのパスワードを入力します。
   インスタンスURL	接続するEssbaseインスタンスのベースURLを、先頭のプロトコルを含めて入力します。多くの場合、http://100.0.0.1 のようなIPアドレスです。
   クラスター名称	接続先のクラスターを入力します。デフォルトはEssbaseCluster です。
   Java API パス	EssbaseインスタンスのクライアントJARファイルへのパスを入力します： GroundRunner と Essbase が 同じサーバー にインストールされている場合、Essbase インストールの JAR ファイルへのパスを入力します。 GroundRunner と Essbase が異なるサーバー にインストールされている場合は、JAR ファイルのコピーを含む GroundRunner のサーバー上のフォルダへのパスを入力します。
   埋め込みモード有効	Essbaseインスタンスで埋め込みモードが有効になっている場合は、このボックスをチェックします。 (スタンドアロンの Oracle Hyperion® 環境では通常、埋め込みモードが有効になっています)。

   注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。

5. 接続に使用する環境を選択し、保存します。
6. 接続をテストするには、 コネクターのList Applicationsコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。

トラブルシューティング

このセクションでは、Oracle Essbase コネクター自体およびそのコマンドの両方に関する潜在的な問題を取り上げます。

 スレッド "main" で例外が発生 [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

エラー: com.essbase.api.base.EssException：プロバイダーサーバーに接続できません。

エラー: com.essbase.api.base.EssException：olap サービスに接続できません。Essbase Server に接続できません。エラー:Essbase エラー(1042003)：ネットワークエラー [11001]：Essbase-Cluster1]の名称情報の取得に失敗しました：olap サービスに接続できません。Essbase Server に接続できません。エラー:Essbase エラー(1042003)：ネットワークエラー [11001]：Essbase-Cluster1]の名称情報の取得に失敗しました。

olap ファイル・オブジェクトを作成できません。Essbase エラー(1030014)：ESSAPI関数に渡されたオブジェクトタイプが無効です。