Profitability Webサービスのカスタム・スクリプトを作成するには:

1. Webサービスに対して有効にするサーバーを設定します。Oracle Enterprise Performance Management System Installation and Configuration Guideを参照してください。

2. コーディング時に、「ProfitabilityService」サービス名を選択します。(詳細は、Profitability and Cost Managementサンプル・クライアント・ファイルの使用を参照してください。)

3. Webサービス・クライアントを作成し、実行する操作を選択します。

   • 使用可能な操作のリストは、Profitability Webサービスの操作を参照してください。

   • 各操作のパラメータの詳細な説明は、OTNドキュメント・ライブラリ内のOracle Hyperion Profitability and Cost Management Web Service API Reference - Profitability Services (WebサービスJavaDoc)を参照してください。

4. オプション: .batまたは.shスクリプトを使用してプログラムを実行するには、新しく作成したWebサービス・クライアント名と一致する既存のファイルを編集します。

  サンプル・クライアント環境を設定するには:

1. コマンド・ウィンドウを開きます。

2. オプション: Oracle Hyperion Enterprise Performance Management Workspaceがインストールされているマシンと同じマシン上で作業していない場合は、サンプルにアクセスするマシンにフォルダ%EPM_ORACLE_HOME%/products/Profitability/samples/wsclientをコピーします。

   たとえば、C:\wsclientです。

3. ProfitabilityServiceと関連付けられているSecurityPolicyがUSERNAME_WITH_SAML_TOKENの場合、以下にリストされたソース・フォルダから次のファイルをwsclientフォルダにコピーします。

   手順4で、hpm_ws_client.propertiesファイル内にこれを構成設定として指定できます。

   表 9. サンプル・クライアントに必要なファイル

   ソース・フォルダ	ファイル名
   %EPM_ORACLE_HOME%/../user_projects/domains/EPMSystem/config/fmwconfig	jps-config.xml
   %EPM_ORACLE_HOME%/../user_projects/domains/EPMSystem/config/fmwconfig	<<Associated keystore file.XXXX.jks>>
   ファイルベース・セキュリティを使用している場合は、%EPM_ORACLE_HOME%/../user_projects/domains/EPMSystem/config/fmwconfig	cwallet.sso

4. ローカル設定に合うようにhpm_ws_client.propertiesファイルを編集します:

               
   #Open the HPCM WSDL URL which is to be accessed. For example:
   http://localhost:19000/profitability/ProfitabilityService?WSDL (or) {DRIVE_LETTER}:/{FILE_PATH}/FILE_NAME.wsdl hpcm.wsdl.url=http://localhost:19000/profitability/ProfitabilityService?WSDL
   
   #Delimiter used to separate String literals in paramters 
   string.delimiter=_
   
   # Delimiter used to separate logical entities in parameters
   # For example, when passing multiple POVs at a time, please use this to delimit POVs
   # For example: 2009_January_Actual#2009_March_Actual when passing 2 POVs
   string.logical.delimiter=#
   
   # SecurityPolicy associated with ProfitabilityService, that needs to be used by Sample Client.
   # The sample client is programmed to work with only one of 2 values:
   # a. USERNAME_TOKEN
   # b. USERNAME_WITH_SAML_TOKEN
   hpcm.service.security.policy=USERNAME_TOKEN
   
   ## These next two values are needed only when the security policy is
   ## USERNAME_TOKEN
   #HSS user name for the Profitability user.
   hss.username=admin
   
   #Password for the username above.
   hss.password=password123
   
   ## These next three values are needed only when the security policy is
   ## USERNAME_WITH_SAML_TOKEN
   
   # Full Path of the jps-config.xml file in use.
   jps.config.file=C:/wsclient/jps-config.xml
   
   #WSS Recipient key alias name used.
   wss.recipient.key.alias=adminalias
   
   # WSS Credential Store Framework key used.
   wss.csf.key=epmpcm.credentials
   
            

5. オプション: Oracle Enterprise Performance Management Workspaceがインストールされているマシンと同じマシン上で作業していない場合は、JDeveloper 11.1.1.6.0をダウンロードしてローカルにインストールし、適切なJAVA_HOMEおよびMIDDLEWARE_HOMEフォルダを取得します。

6. コマンドまたはシェル・ウィンドウから、次の環境変数を設定します:

   表 10. サンプル・クライアント環境の変数

   環境変数	場所
   JAVA_HOME	Java Development Kitが使用可能な場所: Windowsの場合、SET JAVA_HOME=C:/Oracle/Middleware/jdk160_29と入力します UNIXの場合、export JAVA_HOME=/usr/c/Oracle/Middleware/jdk160_29と入力します
   MIDDLEWARE_HOME	Oracle Middlewareホームがインストールされている場所。 Windowsの場合、SET MIDDLEWARE_HOME=C:/Oracle/Middlewareと入力します UNIXの場合、export MIDDLEWARE_HOME=/usr/c/Oracle/Middlewareと入力します

7. コマンド・ウィンドウで、C:\wsclientに移動し、次のコマンドを入力します:

   hpm_ws_client.bat -help

   使用可能なすべての関数のリストが表示されます。

8. サンプル・クライアント・ファイルに指定されているフォーマットおよび操作を使用して、カスタム・スクリプトを構築します。サンプル・クライアント・ファイルの使用を参照してください。

  サンプル・クライアント・ファイルを使用するには:

1. コマンド・ウィンドウで、C:\wsclientに移動します。サンプル・クライアント環境の設定を参照してください。

2. 次のコマンドを入力します:

   hpm_ws_client.bat - help

   使用可能な機能のリストは、Profitability Webサービスの操作を参照してください。

3. 実行する操作を選択し、次のフォーマットでコマンドを入力します:

   hpm_ws_client.bat - help <operation_name>

   たとえば、getPovs操作の使用詳細を取得するには、次のフォーマットでコマンドを入力します:

   hpm_ws_client.bat - help getPovs

4. サンプル・クライアント・ファイルを使用して操作を実行するには、次のフォーマットでコマンドを入力します:

   hpm_ws_client.bat <operation_name> <<parameters>>

   • 例1: すべてのアプリケーションのリスト

     たとえば、使用可能なすべてのアプリケーションのリストを取得するには、次のコマンドを入力します:

     hpm_ws_client.bat getApplications

   • 例2: すべてのPOVのリスト

     たとえば、特定のアプリケーションのすべてのPOVのリストを取得するには、次のコマンドを入力します:

     hpm_ws_client.bat getPovs <<application name>>

   • 例3: ステージの取得

     たとえば、アプリケーションのステージを取得するには、次のコマンドを入力します:

     hpm_ws_client.bat getStages <<application name>>

  ソース・コードを再コンパイルするには:

1. コマンドまたはシェル・ウィンドウを開き、common.components.homeフォルダの場所を指定します。

   このフォルダは、MIDDLEWARE_HOME/oracle_commonとして定義されています。MIDDLEWARE_HOMEは、次のように設定されています:

   • Windowsの場合: SET MIDDLEWARE_HOME=C:/Oracle/Middleware

   • UNIXの場合: export MIDDLEWARE_HOME=/usr/c/Oracle/Middleware

2. 次のいずれかの方法を使用して、フォルダの場所をAntに渡します:

   • コマンドライン・パラメータとして。例:

     ant -Dcommon.components.home=C:/Oracle/Middleware/oracle_common

   • build.propertiesファイルで、編集のためにファイルを開き、common.components.home変数の定義のコマンドを解除します。例:

     common.components.home=C:/Oracle/Middleware/oracle_common

3. ソース・コードを再コンパイルします。