Oracle® Hyperion® Financial Management コネクターでは、コマンド をチェーンで使用して、Oracle Hyperion Financial Management (HFM) バージョン 11.1.2.4.x または 11.2.x とやり取りできます。例えば、Oracle HFM からデータをファイルとして抽出し、Wdata テーブル にアップロードするチェーンを作成できます。
重要: このコネクターは HFM システムに接続するために Workiva によって構築されましたが、弊社のサポートチームはワークスペース内でこのコネクターの構成をヘルプすることしかできません。
メモ: Oracle HFM バージョン 9.3.1 から 11.1.2.3 に接続するには、Oracle HFM Legacy コネクタ を使用します。
前提条件
接続を設定するには、以下のものが必要です:
- Oracle HFM に使用するサーバー。
HFMスイート全体(JDK、サポート資産などを含む)がインストールされていること。 - のインストール:
- HFM にバンドルされている Java ランタイム。 2026 年現在、通常は OracleJava Runtime Environment (JRE) 8 です。このランタイムは、システムレベルのJREとしてインストールする必要があります。
-
このランタイム 、コマンドラインから使用する必要があります。
ターミナル(Linux)またはコマンドプロンプト/PowerShell(Windows)を開き、java -versionと入力してテストできます。応答は次のようになるはずです:(バージョン1.8.xはJRE 8です)Java バージョン "1.8.0_481" Java(TM) SE ランタイム環境 (ビルド 1.8.0_481-b10) Java HotSpot(TM) 64 ビットサーバー VM (ビルド 25.481-b10、混合モード)使用しない場合は、PATH 環境変数 を調整する必要があります。
メモ: 他の JVM を使用しようとすると、コネクターが正しく動作しない場合があります。これは Oracle HFM Java ライブラリのいくつかのレガシー要件が原因です。
-
メモ: HFM Application Service をホストする Enterprise Performance (EPM) サーバーマシンに GroundRunner をインストールします。 GroundRunnerがOracle HFMインスタンスと異なるサーバーまたはネットワーク上で実行されている場合、Workivaはトラブルシューティングのサポートを提供できません。
- Oracle Enterprise Performance (EPM) システムインスタンスとそのHFM ホームディレクトリへのパス。
- EPM Shared Services Registry に表示される HFM サーバーのクラスター名称。
-
Oracle HFM インスタンスとの認証に使用される Oracle HFM 統合ユーザー。
注: 統合ユーザーは、Microsoft® Active Directory® (MSAD) ユーザーではなく、Reporting および Extended Analytics に必要なデータに使用することができる Native Directory ユーザーである必要があります。MSADユーザーはまだ必要だが、その目的はGroundRunnerと通信することである。
-
Oracle HFM とリレーショナルデータベースでタスクを実行する GroundRunner。
メモ: 接続を有効にするには、GroundRunner の統合ユーザーに HFM ホームディレクトリへの実行権限が必要です。
チェーンの作成と構築の際には、識別子の確認をお勧めします:
- あなたのWorkiva管理者
- Oracle HFMの管理者
- ネットワークおよびインフラストラクチャエンジニアリングチーム
Oracle HFM への接続をセットアップ
接続をセットアップするには、IT 管理者がサーバーを構成し、ワークスペース所有者が Oracle HFM への接続を作成します。
ステップ1.サーバーの構成
- Oracle HFM で統合ユーザーを作成し、Reporting と Extended Analytics へのアクセス権を付与します。
- Oracle HFM にアクセスできるサーバー:
-
HFM にバンドルされている Java ランタイムをインストールします。これはJava Runtime Environment 8 以上になります。
注: Javaをインストールする際、Java Development Kit(JDK)とJava Runtime Environment(JRE)のどちらをインストールするかを尋ねられることがあります。必要なのはJREだけである。
- Oracle HFM でパッケージ化された JVM へのパス(通常、JRE の
JAVA_HOMEと、binフォルダ)をシステムのPATH に追加します。 - GroundRunner 実行エージェント をダウンロード、インストール、アクティベートします。
- Workiva のホストドメインを許可する。
-
ステップ 2.Oracle HFM コネクターの設定
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 compare_arrows をクリックし、右上の作成 をクリックします。
-
コネクター接続 で、Oracle Hyperion Financial Management とサーバーにインストールされている GroundRunner を選択する。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、接続の詳細を入力します:
メモ: 正しい値については、Oracle HFM 管理者にお問い合わせください。
プロパティ 詳細 ユーザー名 Oracle HFM 統合ユーザーのユーザー名を入力します。 パスワード Oracle HFM 統合ユーザーのパスワードを入力します。 EPMホーム Oracle EPM システムの HFM ホームディレクトリへのパスを入力
デフォルトは次のとおりです:C:/Oracle/Middleware/EPMSystem11R1.EPMインスタンス EPM システムへのパスを入力します。
デフォルトは次のとおりです:C:/Oracle/Middleware/user_projects/epmsystem1.HFMクラスタ Oracle HFM サーバーのクラスター名称を入力します(EPM Shared Services レジストリに表示されます)。 注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。
- コネクターで使用するワークスペース環境 を選択し、保存 をクリックします。
- 接続をテストするには、 Oracle HFMコネクターの Extract Membersコマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
負荷分散されたサーバーでHFMコネクターを使用できますか?
ロードバランシングは HFM に組み込まれており、チェーンではコントロールできませんが、コネクター設定時に ClusterName フィールドに構成を入力することができます。
Oracle HFMへの接続に失敗する
接続先の Oracle HFM クラスター名称と Oracle HFM 統合ユーザーの認証情報を確認します。
コネクターは空白の出力を返却するか、何も応答しない
GroundRunner が Oracle HFM JAR ファイルと通信できるように、HFM ホームディレクトリと EPM インスタンスへのパスを確認します。
コネクターは"insufficient permissions"エラーを返します。
Oracle HFM 統合ユーザーが、Read only ではなく、Read and Write の両方 のアクセス権を持っていることを確認してください。
メモ: GroundRunnerが依存するMSADユーザーも、チェーンが相互作用するファイルを含むディレクトリへの十分なRead/Writeアクセス権を持っている必要があります。
コマンドは正常終了コードを返却するが、出力はない。
スライスクリア、データコピー、データベースへのデータ抽出 、またはファイルへのデータ抽出 コマンドは成功したが出力がない場合、その「Expand only」プロパティが選択されていないことを確認する。テスト中など、抽出のないメンバーを表示する場合は「閲覧のみ」を選択します。
複数のサーバーにインストールすると認証エラーが発生する
記録から次のような線が見つかります:
INFO:ファイル reg.properties が検索できませんでした。これが検索されたら、reg.propertiesファイルを、OracleMiddlewareからコピー
先 :
Oracle\Middleware\user_projects\epmsystem1\config\foundation\11.1.2.0.