ESS（スケジュール済プロセス）の基本と運用

この章の結論

• Fusion のバッチ処理は ESS（Enterprise Scheduler Service）のジョブとして動きます。画面では スケジュール済プロセス（Scheduled Processes） で投入・監視します。
• 1 回の実行は プロセス ID（要求 ID） で識別します。erpintegrations で状態やログを取るときも、この ID を使います。
• 状態は 20 種類あります。終了状態は Succeeded・Warning・Error・Canceled・Expired・Validation Failed・Finished です。Completed は「本処理が終わり後処理中」で、まだ終わっていません。
• BI Publisher のレポートは、ジョブ定義（ジョブ・タイプ BIPJobType）を作るとスケジュール済プロセスとして実行・スケジュールできます。
• 同時に動けないジョブ（非互換）があると Blocked で待たされます。運用設計では、実行順序・頻度・同時実行を決めます。

全体像

用語

用語	意味	例
ジョブ（Job）	処理の実体（実行ファイル）	請求書のインポート処理
ジョブ定義（Job Definition）	パラメータや実行オプションを定めたメタデータ。パッケージ（パス）と名前で識別する	oracle/apps/ess/financials/payables/invoices/transactions の APXIIMPT（Import Payables Invoices）
プロセス（Process）	投入された 1 回の実行。プロセス ID が付く。API では要求 ID（ReqstId）	プロセス ID 14557
プロセス・セット（Process Set）	複数のプロセス（や別のセット）をまとめたもの。ESS ではジョブ・セットと呼ぶ	検証 → 取込 → レポート
サブミッション（Submission）	パラメータや繰り返しスケジュールを指定して実行を依頼すること	毎週月曜に 2 か月間
出力（Output）	PDF・Excel・XML データなどの結果。ログとは別	インポート結果レポート

画面と権限

• ナビゲータ > ツール > スケジュール済プロセス で、投入（Schedule New Process）、検索、詳細の確認を行います。
• 作業領域を使うには、Manage Scheduled Processes（FND_MANAGE_SCHEDULED_PROCESSES_PRIV）を含むロールが必要です。個々のプロセスを実行できるかは、そのプロセスの権限で決まります。
• GL の Import Journals のように、業務の作業領域から投入できるプロセスもあります。

設定・実装の手順

プロセスを投入する

1. ナビゲータ > ツール > スケジュール済プロセス で Schedule New Process をクリックします。
2. 種類は Job のまま、プロセスを選んで OK をクリックします。
3. Process Details で必須のパラメータを入力します。ほかのパラメータの値によって表示されるパラメータもあります。
4. 必要なら Advanced でスケジュール・通知・出力を設定します（下記）。設定しなければ、すぐに 1 回だけ実行されます。
5. Submit をクリックし、表示された プロセス ID を控えます。繰り返しスケジュールを後で取り消すときに必要です。

スケジュール・出力・通知

• Schedule タブ：Run を Using a schedule にして、頻度（Daily、Monthly など）を選びます。日時を個別に指定する User-Defined や、保存済みのスケジュール（Use a Saved Schedule）も使えます。
• Output タブ：Add Output Document で出力を追加し、レイアウトと形式（PDF、Excel、Data（XML））を選びます。Add Destination でプリンタやメールに送れます。
• Notification タブ：Create Notification で宛先（メールアドレスまたはユーザー ID）と条件（例：エラーで終了したとき）を指定します。通知は英語で、時刻は UTC です。

プロセス・セットを投入する

種類で Job Set を選び、Processes タブで各プロセスのパラメータを入力します。プロセス・セット自体にはパラメータがありません。通知は、セットの中の各プロセスではなく、セット全体が終わったときに送られます。

ログと出力を確認する

1. スケジュール済プロセス でプロセスを検索して選びます（必要なら検索結果を更新します）。
2. Process Details タブの Output で、Output Name のリンクから出力を開きます。Output がなければ Log and Output を確認します（添付として出力やログが付きます）。
3. 別の形式が欲しいときは Republish で再出力できます。再実行は不要です。

API では ESSJobExecutionDetailsRF でログと出力を zip で取得できます（erpintegrations）。

状態遷移

代表的な流れ

ジョブにより途中の状態は変わりますが、代表的な流れは次のとおりです。

投入 → Pending Validation → Wait → Ready → Running → Completed（後処理）→ Succeeded／Warning／Error
          └→ Validation Failed（検証で失敗）

途中で起きる状態：Blocked（非互換のプロセスが実行中）、Hold（人が解除するまで止まる）、
                 Paused（自動で起動した別のプロセスを先に動かすため一時停止）

状態の一覧

区分	状態	意味
進行中	Pending Validation／Wait／Ready	実行前の検証中、検証済みで待機中、実行の直前
進行中	Running／Completed	本処理の実行中、本処理が終わり後処理（通知・出力の作成）中
進行中	Blocked／Paused	非互換のプロセスの終了待ち、別のプロセスを先に動かすための一時停止
進行中	Canceling／Retrying／Error Auto-Retry	取消中、エラー後に自動で再実行される予定
進行中	Schedule Ended	スケジュールの最後の投入が済んだ（関連プロセスはまだ動いている場合がある）
要対応	Hold／Error Manual Recovery	人が解除するまで止まっている、管理者が終了状態にする必要がある
終了	Succeeded／Warning／Error	正常終了、警告付きで終了、エラーで終了
終了	Canceled／Expired／Validation Failed	取消済み、スケジュールが終わり実行されなかった、検証で失敗
終了	Finished	スケジュールで動くセットなどで、関係するプロセスがすべて終わった

自動化のポーリングでは、終了状態だけを「終わった」と判定します。Completed や Blocked で処理を打ち切らないようにします。

BI Publisher レポートのジョブ化

BI Publisher（公式ドキュメントでは Oracle Analytics Publisher と表記）のレポートは、ジョブ定義を作るとスケジュール済プロセスとして実行できます。スケジュール、出力の配信、erpintegrations からの投入もできるようになります。

手順

1. 設定および保守（Setup and Maintenance）で、Application Extensions 機能領域のタスク Manage Enterprise Scheduler Job Definitions and Job Sets for Financial, Supply Chain Management, and Related Applications を開きます（ERP・SCM の場合）。タスクが見えなければ、オファリングで機能 Enterprise Scheduler Job Definitions and Job Sets を有効にします。
2. Manage Job Definitions タブで Create をクリックします。
3. 次の値を入力します。

項目	設定
Display Name	利用者がプロセスを選ぶときの表示名
Name	英数字だけ（空白・記号は不可）
Job Application Name	FscmEss（ERP・SCM の場合）
Job Type	BIPJobType
Report ID	Shared Folders 配下のフォルダから始まるレポートのパス。.xdo まで書く
Enable submission from Scheduled Processes	選択したまま（Enterprise Manager からの投入は選択しない）

4. Parameters サブタブで、利用者が入力するパラメータを定義します。データモデルのパラメータと同じ順序 で定義します。
5. User Properties サブタブは、必要な情報がない限り作成・変更しません。
6. Save and Close をクリックします。RUN_ で始まる権限（例：Name が MyProcess1 なら RUN_MYPROCESS1）が自動で作られるので、セキュリティ・コンソールでロールに割り当てます。

パラメータの注意

• データ型は Boolean、Date or time、Number、String です。
• 日付は、BIPJobType のジョブでは書式 yyyy-MM-dd を選び、レポートのデータモデルも同じ書式にします。
• String の選択肢は、10 個以下なら Choice list、それより多ければ List of values を使います。Choice list の値が 500 を超えると投入時にエラーになります。
• 値の一覧の元（List of Values Sources）は削除しません。削除しても名前が残るため、同じ名前で作り直せなくなります。

コード例：ジョブ定義の設計シート

設計書には、画面の項目と同じ単位で値を書いておくと、移送や再作成が楽になります（値は例）。

カスタム ESS ジョブ定義の設計例

Task: Manage Enterprise Scheduler Job Definitions and Job Sets for Financial, Supply Chain Management, and Related Applications
DisplayName: JP01 未払請求書一覧（カスタム）
Name: XxApOpenInvoicesRpt            # 英数字のみ
JobApplicationName: FscmEss
JobType: BIPJobType
ReportId: Custom/Financials/Payables/XxApOpenInvoices.xdo
DefaultOutputFormat: Excel
EnableSubmissionFromScheduledProcesses: true
EnableSubmissionFromEnterpriseManager: false
Parameters:                          # データモデルの P_BU_NAME, P_FROM_DATE の順に定義
  - Prompt: 営業単位
    DataType: String
    PageElement: List of values      # 選択肢が 10 を超えるため
  - Prompt: 請求書日付（自）
    DataType: Date or time
    PageElement: Date only           # 書式は yyyy-MM-dd
GeneratedPrivilege: RUN_XXAPOPENINVOICESRPT   # セキュリティ・コンソールでロールに付与

データモデルの作り方は BI Publisher を参照してください。

依存関係と非互換性

実行順序をつなぐ

• プロセス・セット：複数のプロセスを直列・並列などの順序で動かします。セットの中に別のセットを入れることもできます。
• 自動で起動される後続プロセス：インポートのように、1 つのプロセスが子プロセスを起動するものがあります（例：Load Interface File for Import の子ジョブ Transfer File と Load File to Interface）。
• 外部からの制御：前のジョブの終了を erpintegrations で確認してから次を投入する方法です。OIC で組み立てることが多くなります。

公式のベストプラクティスは、カスタムのジョブ・セットを増やしすぎないよう勧めています。ジョブにパラメータを追加すると、セット側にも反映が必要になり、保守の手間が大きいためです。

非互換性（Incompatibility）

非互換なプロセスは同時に実行できません。後から投入したほうは Blocked になり、先のプロセスが終わると自動で動きます。

• Global：どんな条件でも同時に実行できない
• Domain-Specific：別の条件（たとえば同じ対象を処理する場合など）も一致したときだけ同時に実行できない
• 自己非互換：同じプロセスの別の投入が動いている間は開始できない。ログに “one or more requests are currently pending for definition” と出ます

Blocked の原因は、スケジュール済プロセス でプロセスを選び、Status Details タブの Incompatibility を開くと確認できます。対処は、待つ、相手を取り消す、相手を保留（Hold）にする、のいずれかです。

運用設計

ジョブは「誰が・いつ・何を・どの順で」動かすかを一覧（ジョブ運用表）で管理します。

ジョブ運用表（例）

No,プロセス名,投入方法,スケジュール,投入ユーザー,前提ジョブ,通知,失敗時の対応
1,Load Interface File for Import（AP 請求書）,erpintegrations,日次 02:00,連携用ユーザー,-,OIC から運用チームへ,ログ確認後に原因を修正して再投入
2,Import Payables Invoices,importBulkData 内で投入,日次（1 に続く）,連携用ユーザー,1,同上,Correct Import Errors で修正
3,Validate Payables Invoices,スケジュール済プロセス,日次 03:00,AP 担当,2,エラー時に AP 担当,保留の内容を確認
4,JP01 未払請求書一覧（カスタム）,スケジュール済プロセス,毎週月曜 07:00,AP 担当,3,メールで出力を配信,BIP のログを確認

公式のベストプラクティス（Best Practices for Scheduled Processes）の要点は次のとおりです。

• 同時に動かしすぎない：同時に実行できる数には上限があります（値はサービスの構成で決まる）。1 分を超えるプロセスは利用の少ない時間帯に回します。
• 頻度は必要な範囲で長めにする：通常 5 分かかる処理を 4 分おきに予約しない、といった考え方です。
• 順序を決める：先に終わっている必要がある処理を洗い出します。
• Web サービスからの連続投入に注意する：画面と違い、API では短時間に大量の投入ができてしまいます。投入の間隔を設計します。
• 処理イベントを発生させるプロセスは定期実行しない：Send Pending LDAP Requests、Auto-Provision Roles for All Users などは必要なときだけ実行します。
• カスタムは最小限にする：まず標準のプロセスを使い、必要なら標準を複製するより BI Publisher ベースで新しく作ります。テスト環境で試してから本番に入れます。

運用で決めておくことです。投入ユーザーが退職などで無効になったときの定期プロセスの扱い、メンテナンスでの停止時間の影響、キューの混雑や長時間実行の監視方法などを決めます。いずれも公式のベストプラクティスに項目があります。

落とし穴とベストプラクティス

よくあるミス

• Completed を終了と判定し、出力ができる前に次の処理へ進む。
• 繰り返しスケジュールの最初のプロセス ID を控えず、後で取り消せずに困る。
• 同じジョブを短い間隔で大量に投入し、自己非互換で Blocked が連鎖する。
• カスタム・ジョブ定義のパラメータの順序がデータモデルと違い、値がずれて渡る。
• 日付パラメータの書式がデータモデルと合わず、レポートが空になる。
• 標準のジョブ定義を複製して改造し、制約に引っかかる。

• ジョブ定義のパッケージ名・定義名・パラメータ順は、標準ジョブの定義画面で確認できます（標準はアスタリスク付き。参照したら Cancel で閉じる）。erpintegrations の JobName や ParameterList を作るときに使います。
• ユーザー名に空白を含むユーザーでカスタム・ジョブ定義を作ると、他の利用者の投入でエラーになることがあります。

試験対策ポイント

ESS 自体を扱う認定試験はありませんが、各業務の実装試験で「どのプロセスを、どの順で、どのパラメータで動かすか」が問われます（出題テーマの目安です）。

• GL 模擬テスト：Import Journals、転記、再評価・換算などの期間締めプロセス
• AP 模擬テスト：Import Payables Invoices、検証、支払、会計処理のプロセス
• OIC 模擬テスト：外部からのジョブ投入と完了の受け取り

覚えておくことです。

• 終了状態と途中の状態の区別（Completed は終了ではない）
• Blocked は非互換が原因で、Status Details の Incompatibility で確認する
• BI Publisher のジョブ定義は BIPJobType、パラメータはデータモデルと同じ順序

公式ドキュメント

• What are scheduled processes?
• Statuses of Scheduled Processes
• Submit Scheduled Processes and Process Sets
• View Output from Scheduled Processes
• Resolve Blocked or Incompatible Processes
• Process Sets
• Best Practices for Scheduled Processes（26D）
• Create Job Definitions to Run Reports as Scheduled Processes
• Define Parameters for Job Definitions
• View Details About Predefined Scheduled Processes

関連ページ

• ERP Integration Service（erpintegrations）による自動化
• FBDI（ファイルベース・データ・インポート）の仕組みと手順
• BI Publisher（データモデル・レイアウト・バースティング・スケジュール）
• REST API・ESS チートシート
• 自動化演習：erpintegrations で取込ジョブを実行・監視する