AI用のコスト・アドバイザのためのFusion EPMの準備

ターゲットEPM環境で、ユーザー名を選択して「設定およびアクション」を開き、「ダウンロード」を選択して、EPM自動化インストーラをダウンロードします。クライアントのダウンロードとインストールおよびWindowsでのEPM自動化のインストールを参照してください。

C:\EPMAutomateなどの安定したデプロイメント・フォルダを、個々のユーザー・プロファイル・フォルダの外部に作成します。認可されたオペレータへのアクセスを制限し、デプロイメント・ファイル、データ、資格証明およびログの管理に必要な権限を付与します。

このトピックの例では、C:\EPMAutomateを使用します。別の場所を選択する場合は、ConfigFile.batのパスとそれに応じてコマンドを更新します。

ConfigFile.bat、EPM_Cost_Advisor_for_AI_Onboarding.batおよびInstruction.txtを直接含む、抽出されたパッケージ・フォルダを見つけます。抽出によって外部フォルダが作成された場合は、そのフォルダを開いてパッケージ・フォルダを見つけます。パッケージの内容をC:\EPMAutomateに直接コピーし、サブフォルダを保持します。構成ファイルがC:\EPMAutomate\ConfigFile.batにあることを確認します。

Lifecycle Management (LCM)スナップショットZIPを圧縮したままにします。指定されたファイル名を保持します。ドキュメント化された構成設定とコスト・アドバイザのメタデータおよびデータ・ファイルのみを変更します。

パス、問合せ文字列またはフラグメントなしで、それぞれのHTTPSベースURLを記録します。EPM環境では、/epmcloudを省略します。アイデンティティ・ドメインの場合、OAuthトークン・エンドポイント・パスを省略します。サインイン・リダイレクトURLを使用しないでください。

宛先の接続時に、EPM環境URLおよびアイデンティティ・ドメインURLフィールドにこれらの値を保持します。

アイデンティティ・ドメインとEPM環境の承認済ペアを記録します。この接続の認可は、選択したEPM環境に適用されます。デプロイメントに別のアイデンティティ・ドメインが必要な場合は、機密アプリケーションをアクティブ化する前に、EPMおよびアイデンティティ・ドメインの管理者に、サポートされているドメイン・アクセスまたはフェデレーション構成を確認して完了してもらってください。構成は、EPMリリースおよびテナンシの設定によって異なります。

オンボーディング・バッチを実行する前に、デプロイメント・アカウントと統合アカウントを作成または識別し、そのロールを割り当てます。バッチを実行するアカウントには、デプロイメント・フォルダへのアクセス権と、アプリケーション構成をターゲットEPM環境にインポートする権限が必要です。指定されたバッチはimportUsers=FALSEを使用するため、ユーザーまたはそのアプリケーション・ロール割当はインポートされません。

継続的なファイル配信のために、関連付けられたアイデンティティ・ドメインでアクティブな専用統合アカウントを作成または再利用し、ターゲットEPM環境でプロビジョニングします。個々の管理者の個人アカウントではなく、svc_cost_advisor_epm_uploadなどの操作ユーザー名を使用します。「統合ユーザー名」フィールドの正確なサインイン・ユーザー名を記録します。このユーザー名はJWTのsub値になります。表示名またはOAuthクライアントIDを使用しないでください。ユーザー名によって、EPMでプロビジョニングされたユーザーが識別されることを確認します。

EPM管理者に、統合で使用されるファイルのアップロード、リスト、ダウンロードおよび削除に必要なロールのみを付与してもらいます。ターゲット・パスで変更されたファイルを置換する場合は、削除が必要です。アップロード権限だけでは不十分です。割り当てられたロールと、ロールを承認した管理者を記録します。継続的な配信に必要なロールは、アプリケーション構成のインポートに必要なロールとは異なる場合があります。

ユーザーおよび役割の設定については、Creating Userおよび Assigning Rolesを参照してください。ファイル操作の要件については、アップロード、ファイルのリスト、ダウンロードおよびファイルの削除を参照してください。

EPM_URL、EPM_USERNAME、EPM_AUTOMATE、EPM_PASSWORD_FILE、EPM_SNAPSHOT_PATH、EPM_SNAPSHOT_NAMEおよびEPM_INTEGRATION_PATHを設定します。EPM_SNAPSHOT_NAMEから.zip拡張子を省略します。指定されたバッチは、EPM_IDENTITY_DOMAINをサインイン・コマンドに渡しません。コスト・アドバイザ宛先のアイデンティティ・ドメインURLを個別に設定します。

EPM_AUTOMATEをインストールされたepmautomate.batのフルパスに設定します。デプロイメント・フォルダの例では、次のパッケージ・パスを使用します。

SET EPM_PASSWORD_FILE=C:\EPMAutomate\Epmpassword.epw
SET EPM_SNAPSHOT_PATH=C:\EPMAutomate\Cost_Advisor_for_AI_Snapshot
SET EPM_SNAPSHOT_NAME=Cost_Advisor_for_AI_Onboarding_Snapshot
SET EPM_INTEGRATION_PATH=C:\EPMAutomate\Cost_Advisor_for_AI_Integration

管理者のワークステーションで、EPM自動化を実行できるコマンド・プロンプトを開きます。PASSWORDおよびKEYを値に置き換え、次を実行します。

epmautomate encrypt PASSWORD KEY "C:\EPMAutomate\Epmpassword.epw"

別のEPM_PASSWORD_FILEパスを指定した場合は、その正確なパスを最終引数として使用します。生成されたファイルが存在し、そのパスがConfigFile.batのEPM_PASSWORD_FILEと一致することを確認します。構成ファイルを保存します。

特殊文字を含むコマンド構文およびパスワードについては、encryptを参照してください。

バッチでは、EPM自動化環境でこのファイルが使用されます。AI宛先接続のコスト・アドバイザでは、証明書ベースのOAuthが使用されます。宛先設定でデプロイメント・パスワードまたは暗号化されたパスワード・ファイルを入力またはアップロードしないでください。

財務チームおよびEPM管理者と協力して、提供されたコスト・アドバイザ・メタデータおよびデータ・ファイルの組織および財務データをロードする前に確認します。Metadata_Provider.csv、Metadata_Department.csv、Metadata_Entity.csv、Metadata_Model.csv、Metadata_Intent.csvおよびCost_Data.csvは、ローカルのCost_Advisor_for_AI_Integrationフォルダに保持します。指定されたファイル名、ヘッダー、および列の順序を保持します。バッチは、6つのすべてのファイルをEPM inboxにアップロードし、その内容をロードします。

コスト・アドバイザのメタデータとデータ・ファイルで、統合で想定される識別子と期間を使用していることをEPM管理者に確認してください。EPM_INTEGRATION_PATHを変更すると、ローカル・ソース・フォルダが変更されます。インポートされたパイプラインのEPM入力パスは変更されません。

METADATALOADコマンドとACTUALDATALOADコマンドの両方を更新します。

期間はデータ統合期間マッピングに存在する必要があります。指定されたコマンドは、IMPORTMODE=Replace、EXPORTMODE=Merge、SEND_MAIL=AlwaysおよびATTACH_LOGS=Yを使用します。EPM管理者に、ターゲット環境のこれらの設定を確認してもらいます。runPipelineを参照してください。

開始する前に、ターゲット環境、アカウント、構成値、資格証明、コスト・アドバイザ・メタデータおよびデータ・ファイルおよびパイプライン・パラメータを確認します。バッチは、次の処理を順番に実行します。

1. ターゲットEPM環境にサインインします。
2. Cost_Advisor_for_AI_Onboarding_Snapshot.zipをimportUsers=FALSEとともにアップロードおよびインポートします。ユーザーとそのアプリケーション・ロールを個別に準備します。importSnapshotを参照してください。
3. 5つのメタデータ・ファイルおよびCost_Data.csvをinboxにアップロードします。
4. METADATALOADを実行して、5つのメタデータ・ディメンションをロードし、アプリケーションをリフレッシュします。
5. ACTUALDATALOADを実行します。これは、コスト、クレジット、データおよびユーザー統合についてinbox/Cost_Data.csvを読み取ります。
6. サイン・アウトします。

デプロイメント・ファイルへのアクセスを許可されたアカウントを使用して、Windowsデプロイメント・ホストにサインインします。コマンド・プロンプトを開き、次を実行します:

cd /d C:\EPMAutomate
EPM_Cost_Advisor_for_AI_Onboarding.bat

必要に応じてデプロイメント・パスを調整します。バッチが終了するまで、コマンド・ウィンドウを開いたままにします。

バッチ出力を確認し、パッケージのログ・フォルダにログインします。EPMで、「移行」を開き、「レポート」、「移行ステータス」の順に選択します。インポート・ステータスおよびエラーをレビューします。ライフサイクル管理の移行へのアクセスおよび移行ステータス・レポートのの生成を参照してください。

バッチは、Cost_Advisor_for_AI_EPMAutomate_YYYYMMDD_HHMMSS.logをバッチの横のlogsフォルダに書き込みます。データ統合でMETADATALOADおよびACTUALDATALOADの実行結果を確認し、必要なデータがロードされたことを確認します。

オンボーディング・ハンドオフのバッチ・ログを使用して、インポートおよびパイプライン結果を保持します。

ステップが失敗した場合は、EPM管理者と協力して完了したステップを特定し、リカバリ手順を確認してから、バッチを再実行してください。再実行すると、スナップショットがインポートされ、ローカル・ファイルが再ロードされます。EPM準備の問題の解決を参照してください。