未計画プロジェクト・コストのパブリック・イベント
財務プロジェクト・プランで計画外リソースが追加または更新されるたびにOracle PPM Cloudに通知する場合は、ERPビジネス・イベントRESTエンドポイントを使用して機能を有効にする必要があります。
たとえば、プロジェクト・マネージャに未計画プロジェクト・コストを通知する場合は、次のようにします:
- プロジェクト・アプリケーション管理者は、この機能を有効にする必要があります。 Oracle PPM Cloudは、財務プロジェクト・プランに計画外のプロジェクト・コストがある場合にシグナルを送信します。
- 統合開発者は、これらのシグナルをサブスクライブするイベント・ハンドラを作成し、財務プロジェクト・プランの未計画プロジェクト・コストを追跡する必要があります。
UnplannedProjectCostビジネス・イベント・コードの「使用可能」インジケータの設定
ERPビジネス・イベントREST APIを使用して、UnplannedProjectCostビジネス・イベント・コードの有効なインジケータをTRUEに設定します。 設定したら、Oracle Integration Cloudのイベントをサブスクライブして、計画外プロジェクト・コストが識別されたときに追加のアクションを実行できます。
次の例では、ビジネス・イベント・レコードを取得および更新する方法を示します。
ERPビジネス・イベントREST APIの定義 - /fscmRestApi/resources/11.13.18.05/erpBusinessEvents/
- RESTリソースに対してGETリクエストを送信し、UnplannedProjectCostビジネス・イベント・コードのビジネス・イベントIDを取得します。
- RESTリソースでPATCHリクエストを送信して、使用可能インジケータを更新: /fscmRestApi/resources/11.13.18.05/erpBusinessEvents/{ErpBusinessEventId}
JSON形式の要求本文の内容の例:
{
"EnabledFlag": true
}
未計画プロジェクト・コスト・イベントのペイロードの属性
この表は、ペイロードの属性とその説明を示しています。
属性 | 説明 |
---|---|
planVersionId |
財務プロジェクト・プラン・バージョンの一意の識別子。 |
projectID |
プロジェクトの一意の識別子。 |
projectNumber |
プロジェクトの番号。 |
eventType |
パブリック・イベントのタイプ。 |
planningResource |
財務プロジェクト・プランの財務プランニングに使用されるリソース。 |
taskId |
財務プロジェクト・プラン変更の一部として変更されたプロジェクト・タスクの識別子。 |
taskNumber |
タスクの番号。 |
planningElementId |
財務プロジェクト・プランのタスク割当の識別子。 |
resourceName |
財務プロジェクト・プランのタスクに割り当てられたリソースの名前。 |
rbsElementId |
財務プロジェクト・プランに含まれるリソースの識別子。 |
resourceClass |
リソースのリソース区分。 たとえば、労務リソースの場合はLABOR、機材タイプ・リソースの場合はEQUIPMENTです。 |
planningCurrency |
リソースが計画されている通貨。 |
unitOfMeasure |
リソースの単位。 |
totalActualQuantity |
タスクまたはプロジェクトに費やされたリソース工数の合計実績数量(労務および機材を含む)。 |
totalTCActualRawCost |
リソース割当の実績通貨直接費合計値です。 |
totalTCActualBrdndCost |
リソース割当の実績通貨総コスト合計値です。 |
totalPCActualRawCost |
リソース割当のプロジェクト通貨での合計実績直接費金額です。 |
totalPCActualBrdndCost |
リソース割当のプロジェクト通貨での合計実績総コスト金額です。 |
totalPFCActualRawCost |
リソース割当のプロジェクト元帳通貨での合計実績直接費金額です。 |
totalPFCActualBrdndCost |
リソース割当のプロジェクト元帳通貨での合計実績総コスト金額です。 |
totalPlannedQuantity |
リソース割当の合計計画数量。 |
totalTCRawCost |
リソース割当の計画通貨直接費金額の合計。 |
totalTCBrdndCost |
リソース割当の計画総コスト金額合計。 |
totalPCRawCost |
リソース割当の計画通貨直接費の値の合計。 |
totalPCBrdndCost |
リソース割当の計画通貨総原価の値の合計。 |
totalPFCRawCost |
リソース割当の計画プロジェクト元帳通貨直接費合計値です。 |
totalPFCBrdndCost |
リソース割当の計画プロジェクト元帳通貨総原価の値の合計。 |
<?xml version="1.0" encoding="UTF-8"?>
<inputVariable>
<ns0:UnplannedProjectCostInfo xmlns:ns0="http://xmlns.vision.com/apps/projects/control/budgetsAndForecasts/unplannedProjectCost/UnplannedProjectCost" xmlns:xsi="http://www.vision.org/2001/XMLSchema-instance">
<ns0:projectId>300100550701997</ns0:projectId>
<ns0:projectNumber>TM001</ns0:projectNumber>
<ns0:planVersionId>100100464971689</ns0:planVersionId>
<ns0:eventType>UNPLANNED_RESOURCES</ns0:eventType>
<planningResource>
<taskId>100100464971678</taskId>
<taskNumber>1.2</taskNumber>
<planningElementId>100100465342518</planningElementId>
<resourceName>Vision Operations</resourceName>
<rbsElementId>100100464971659</rbsElementId>
<resourceClass>FINANCIAL_ELEMENTS</resourceClass>
<planningCurrency>USD</planningCurrency>
<unitOfMeasure>DOLLARS</unitOfMeasure>
<totalActualQuantity>0</totalActualQuantity>
<totalTCActualRawCost>3000.00000000</totalTCActualRawCost>
<totalTCActualBrdndCost>3000.00000000</totalTCActualBrdndCost>
<totalPCActualRawCost>3000.00000000</totalPCActualRawCost>
<totalPCActualBrdndCost>3000.00000000</totalPCActualBrdndCost>
<totalPFCActualRawCost>3000.00000000</totalPFCActualRawCost>
<totalPFCActualBrdndCost>3000.00000000</totalPFCActualBrdndCost>
</planningResource>
<planningResource>
<taskId>100100464971680</taskId>
<taskNumber>1.1</taskNumber>
<planningElementId>100100465342519</planningElementId>
<resourceName>Vision Operations</resourceName>
<rbsElementId>100100464971659</rbsElementId>
<resourceClass>FINANCIAL_ELEMENTS</resourceClass>
<planningCurrency>USD</planningCurrency>
<unitOfMeasure>DOLLARS</unitOfMeasure>
<totalActualQuantity>0</totalActualQuantity>
<totalTCActualRawCost>3000.00000000</totalTCActualRawCost>
<totalTCActualBrdndCost>3000.00000000</totalTCActualBrdndCost>
<totalPCActualRawCost>3000.00000000</totalPCActualRawCost>
<totalPCActualBrdndCost>3000.00000000</totalPCActualBrdndCost>
<totalPFCActualRawCost>3000.00000000</totalPFCActualRawCost>
<totalPFCActualBrdndCost>3000.00000000</totalPFCActualBrdndCost>
</planningResource>
</ns0:UnplannedProjectCostInfo>
</inputVariable>