Oracle Projects API, クライアント拡張およびオープン・インタフェース・リファレンス リリース12 E05609-01

目次

前へ

次へ

Oracle Project Foundation API

この章では、次の情報用のAPIを実装する方法を説明します。

• プロジェクトおよびタスク情報

• 体系情報

• 資源リストおよび資源リスト・メンバー情報

• 依存関係情報

• タスク割当情報

この章では、次のトピックを説明します。

• プロジェクトの定義API
• プロジェクトの定義APIのプロシージャの定義
• プロジェクト定義レコードおよび表のデータ型
• プロジェクトの定義APIの使用方法
• ロード-実行-フェッチAPIを使用したプロジェクトの作成
• 体系API
• 体系APIのプロシージャの定義
• ユーザー定義属性API
• 資源API
• 資源APIのプロシージャの定義
• 計画資源リストAPI
• 計画資源リストAPIの定義
• 資源分解構造API
• 資源分解構造APIのプロシージャの定義
• 依存関係API
• 依存関係APIのプロシージャの定義
• タスク割当API
• タスク割当APIのプロシージャの定義

プロジェクトの定義API

この章では、外部システムのプロジェクト・データをOracle Projectsと統合するために使用できるAPIについて詳しく説明します。また、次のことをリアルタイムで検証するために使用するPL/SQLプロシージャについても詳しく説明します。

• 外部システムに入力したプロジェクトがOracle Projects内で一意であるか

• 特定の機能（プロジェクトの削除など）がOracle Projectsで定義されたビジネス・ルールに従っているか

任意の外部システムを使用して詳細なプロジェクト計画を開発します。その後、プロジェクトAPIを使用して計画をOracle Projectsにプッシュし、計画の情報に基づいてプロジェクトを作成します。プロジェクト計画の展開に伴って外部システムでプロジェクト情報を更新してから、2つのシステムを定期的に同期化します。プロジェクトAPIによってOracle Projectsでタスク情報および作業分解構造（WBS）が更新され、外部システムで行った変更が反映されます。

注意: プロジェクト識別子が必要なプロジェクトAPIを呼び出す場合は、P_PA_PROJECT_IDまたはP_PM_PROJECT_REFERENCEパラメータを渡してプロジェクトを識別する必要があります。

プロジェクトの定義APIのビュー

プロジェクトの定義APIのパラメータ・データを提供するビューを次に示します。ビューの詳細は、Oracle MetaLinkで入手可能なOracle eTRMを参照してください。

PA_OVERRIDE_FIELDS_Vの詳細

次の表に、プロジェクト識別コードが1020で、すべてのクイック入力フィールドが使用可能になっているプロジェクトについて、PA_OVERRIDE_FIELDS_Vビューのいくつかの列の内容を示します。すべての列のIDフィールド値は1020です。

有効な値を選択するために使用するビューのすべてにCODE列とDESCRIPTION列があります。これら2つの列およびLOV_VIEW_NAMEフィールドの値を使用して、クイック入力フィールドの有効な値を取得します。有効な値はCODEフィールドに保存されます。次の表に、クイック入力フィールドの有効な値を示します。

プロジェクトの定義APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_PROJECT_PUB内にあります。

• プロジェクト・プロシージャ

  • CREATE_PROJECT

  • DELETE_PROJECT

  • UPDATE_PROJECT

• ロード-実行-フェッチ・プロシージャ

  • CLEAR_PROJECT

  • EXECUTE_CREATE_PROJECT

  • EXECUTE_UPDATE_PROJECT

  • INIT_PROJECT

  • LOAD_CLASS_CATEGORY

  • LOAD_KEY_MEMBER

  • LOAD_ORG_ROLE

  • LOAD_PROJECT

• チェック・プロシージャ

  • CHECK_CHANGE_PROJECT_ORG_OK

  • CHECK_DELETE_PROJECT_OK

  • CHECK_UNIQUE_PROJECT_REFERENCE

プロジェクトの定義APIのプロシージャ定義

この項では、プロジェクトの定義APIについて、ビジネス・ルールおよびパラメータも含めて説明します。

プロジェクトの定義APIの共通パラメータ

次の説明は、プロジェクトの定義APIを通じて使用される列に該当します。

PM_PROJECT_REFERENCE

Oracle Projectsでプロジェクトの作成に使用するシステムによって、各プロジェクトに一意の番号が割り当てられます。プロジェクト番号を自動生成するか、番号の手動入力をサポートするように、Oracle Projectsを設定できます。

Oracle Projectsで自動採番を設定した場合は、次のことが行われます。

• Oracle Projectsによって自動生成された番号は、SEGMENT1列に保存されます。

• 外部システムによって割り当てられた番号は、PM_PROJECT_REFERENCE列に保存されます。

Oracle Projectsで手動採番を設定した場合、外部システムによって割り当てられた番号はSEGMENT1とPM_PROJECT_REFERENCEの両方に保存されます。

注意: Oracle Projectsのウィンドウには、プロジェクト番号としてSEGMENT1のみが表示されます。したがって、Oracle Projectsを外部システムと統合する予定がある場合は、手動採番をサポートするようにOracle Projectsを設定してください。

プロジェクトおよびタスクの開始日と終了日

ほとんどの外部システムでは、プロジェクトおよびタスクに対して追加の開始日と終了日が保持されます。クライアント機能拡張を使用して（デフォルトのOracle Projectsのプロジェクト日付ではなく）これらの追加の日付を渡す方法は、「プロジェクトおよびタスク日付機能拡張」を参照してください。

CREATE_PROJECT

CREATE_PROJECTは、テンプレートまたは既存のプロジェクトを使用してOracle Projectsでプロジェクトを作成するPL/SQLプロシージャです。

注意: タスクを持つプロジェクトまたはテンプレートをコピーしようとする場合、CREATE_PROJECTでは、新規作成されたプロジェクトにWBS体系はコピーされません。また、「プロジェクトの作成時に作業計画を自動公開」オプションが選択されたテンプレートをコピーしようとする場合にも、CREATE_PROJECTでは、新規作成されたプロジェクトにWBS体系はコピーされません。

このAPIは複合データ型を使用します。詳細は、「複合データ型を使用するAPI」を参照してください。

注意: Oracle Projects APIを使用して付加フレックスフィールドをロードする際に、DFFがコンテキスト依存ではない場合、パラメータATTRIBUTE_CATEGORYには「グローバル・データ要素」などの値が必要です。それ以外の場合、APIによって行はインポートされません。

ビジネス・ルール

Oracle Projectsは次のビジネス・ルールを課します。

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

CREATE_PROJECTのパラメータ

CREATE_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

値が必要なCREATE_PROJECTのパラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

• P_PROJECT_IN

DELETE_PROJECT

DELETE_PROJECTは、Oracle Projectsからプロジェクトとそのタスクを削除するために使用するPL/SQLプロシージャです。

ビジネス・ルール（プロジェクト・レベル）

次の項目のいずれかが存在する場合は、プロジェクトを削除できません。

• イベント

• 支出項目

• 発注配分

• 発注購買依頼

• 仕入先請求書

• 請求書配分

• 資金

• 予算

• 取引約定の取引

• 報酬ルール・セット

• 他のプロジェクトからの参照

ビジネス・ルール（タスク・レベル）

プロジェクトのタスクのいずれかが削除できない場合、そのプロジェクトは削除できません。チェック・プロシージャCHECK_DELETE_TASK_OKを使用して、特定のタスクを削除できるかどうかを確認します。次のいずれかが存在する場合、タスクは削除できません。

• 最上位タスクでのイベント

• 最上位タスクでの資金

• 最上位タスクでの予算

• 最下位タスクでの支出項目

• 最下位タスクでの発注明細

• 最下位タスクでの購買依頼明細

• 最下位タスクでの仕入先請求書（Oracle Payables請求書）

• 最下位タスクでの予算

DELETE_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

値が必要なDELETE_PROJECTのパラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

UPDATE_PROJECT

UPDATE_PROJECTは、外部システムで行った変更を反映するために外部システムからOracle Projectsにプロジェクトおよびタスク情報を更新するPL/SQLプロシージャです。

UPDATE_PROJECTは複合データ型を使用します。複合データ型の詳細は、「複合データ型を使用するAPI」を参照してください。

Oracle Projectsでは、プロジェクトおよびタスク情報に対して行える変更を制限する、プロジェクト・レベルおよびタスク・レベルのビジネス・ルールが課せられます。外部システムで行ったプロジェクトまたはタスクの変更がすべてOracle Projectsで確実に受け入れられるように、外部システムで変更を行う前に、次のルールを確認してください。チェック・プロシージャを使用して、Oracle Projectsでサポートされる変更のタイプを確認することもできます。

更新モード

「更新モード」パラメータには、2つの値（PA_UPD_WBS_ATTRおよびPA_UPD_TASK_ATTR）が指定できます。

値PA_UPD_WBS_ATTRを指定すると、次の効果があります。

• 作業計画バージョンがロックされます。（別のユーザーによってすでにロックされているバージョンは更新できません。）

• ユーザーは、資源、依存関係、予定、一般詳細などのタスク情報を更新できます。

• ユーザーは、インデントの作成、削除、増減や、タスクの移動とコピーなど、作業計画体系の更新を行えます。

値PA_UPD_TASK_ATTRを指定すると、次の効果があります。

• 作業計画バージョンがロック解除されたままになります。

• ユーザーは、日付、依存関係、資源、一般詳細などのタスク情報を更新できます。

ビジネス・ルール（プロジェクト・レベル）

Oracle Projectsは次のビジネス・ルールを課します。

プロジェクト番号、プロジェクト名、プロジェクト・タイプおよびプロジェクト組織

プロジェクト番号、プロジェクト名、プロジェクト・タイプおよびプロジェクト組織には、次のルールが適用されます。

• プロジェクト番号: 支出項目または請求書がプロジェクトに賦課されている場合、プロジェクト番号は変更できません。

  • 新規プロジェクト番号はOracle Projects内で一意にする必要があります。CHECK_UNIQUE_PROJECT_REFERENCE（チェック・プロシージャ）を使用して、新規プロジェクト番号が一意であることを確認してください。

  • 外部システムを使用して当初プロジェクト計画を作成する場合は、手動プロジェクト採番を選択してください。外部システムで自動生成された番号は、Oracle Projects内で一意ではない可能性があり、Oracle Projectsで生成された新規プロジェクト番号に置き換えられます。

• プロジェクト名: 新規プロジェクト名は一意にする必要があります。

• プロジェクト・タイプ: プロジェクトのプロジェクト・タイプ（間接、資産または契約）は変更できません。

• プロジェクト組織: 原価配分明細、収益草案または請求書草案がプロジェクトに賦課されている場合、プロジェクト組織は変更できません。

チーム・メンバーと顧客

次の表に、プロジェクト・チーム・メンバーと顧客に対するルールを示します。

プロジェクト開始日および終了日のルール

プロジェクト開始日および終了日のルールは、次のとおりです。

• プロジェクト開始日および完了日には、プロジェクトに含まれているすべてのタスクの最初のタスク開始日と最後のタスク完了日を含める必要があります。

• 開始日と完了日の両方または完了日のみをブランクにすることができます。ただし、完了日を入力する場合には、開始日を入力する必要があります。

• プロジェクト・ステータスを「クローズ済」に変更した場合、デフォルトの完了日はシステム日付になります。以降にプロジェクトを再オープンすると、デフォルトの完了日はNULLになります。

• 次に示すプロジェクト・フィールドにNULL値を指定した場合は、Oracle Projectsでエラー・メッセージが表示されます。Oracle Projectsでは、これらのフィールドに入力したNULL値は無視され、元の値が保持されます。

  • PROJECT_STATUS

  • PUBLIC_SECTOR_FLAG

  • PROJECT_NUMBER

  • PROJECT_NAME

  • CARRYING_OUT_ORGANIZATION_ID

  • 契約プロジェクトのDISTRIBUTION_RULE（このフィールドにNULL値を指定するとエラーになります。）

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

プロジェクトの労務および非労務請求予定表および間接費計算予定表の属性を更新するためのルール

労務予定表と非労務予定表の属性を更新するためのルールは、次のとおりです。

• 労務予定表タイプを「請求」から「間接費」または「間接費」から「請求」に変更する場合は、LABOR_SCH_TYPE列が必須で、必須の依存列をすべて移入する必要があります。

• 労務または非労務予定表タイプを「請求」から「間接費」に変更する場合は、REV_IND_RATE_SCH_IDおよびINV_IND_RATE_SCH_ID列が必須です。

• 労務予定表タイプを「間接費」から「請求」に変更する場合に、Oracle Project Resource Managementがインストールされていると、JOB_BILL_RATE_SCHEDULE_ID列が必須です。

• 非労務予定表タイプを「間接費」から「請求」に変更する場合は、NON_LABOR_BILL_RATE_ORG_IDおよびNON_LAB_STD_BILL_RT_SCH_ID列が必須です。

• LABOR_SCHEDULE_DISCOUNTが渡される場合は、LABOR_SCHEDULE_DISCOUNT_REASONも必須です。

• LABOR_SCHEDULE_DISCOUNTが渡されない場合は、LABOR_SCHEDULE_DISCOUNT_REASONを渡すことができません。

• NON_LABOR_SCHEDULE_DISCOUNTが渡される場合は、NON_LABOR_SCHEDULE_DISCOUNT_REASONも必須です。

• NON_LABOR_SCHEDULE_DISCOUNTが渡されない場合は、NON_LABOR_SCHEDULE_DISCOUNT_REASONを渡すことができません。

• 渡される予定表IDまたは組織IDは、有効なIDである必要があります。

ビジネス・ルール（タスク・レベル）

Oracle Projectsは、タスク・レベルで次のビジネス・ルールを課します。

情報の共有順序

外部システムとOracle Projectsとの間でタスク情報が共有される順序には、次のルールが適用されます。

• 関連した子タスクをインタフェースするには、Oracle Projectsに親タスクをインタフェースしておく必要があります。

タスク番号、識別コードおよび組織

タスク番号、識別コードおよび組織には、次のルールが適用されます。

• 新規タスク番号はプロジェクト内で一意にする必要があります。チェック・プロシージャCHECK_UNIQUE_TASK_NUMBERを使用して、新規タスク番号がOracle Projects内で一意であることを確認してください。

• 外部システムによってTASK_IDとPM_TASK_REFERENCEの両方がOracle Projectsにプッシュされる場合、Oracle ProjectsではTASK_IDを使用してタスクが識別され、PM_TASK_REFERENCEは入力値（異なる場合）で更新されます。

• 次の項目のいずれかがタスクに賦課されている場合、タスク番号は変更できません。

  • 支出項目

  • 発注配分

  • 発注購買依頼配分

  • 仕入先請求書

  • 仕入先請求書配分

    注意: チェック・プロシージャCHECK_TASK_NUMBER_CHANGE_OKを使用して、Oracle Projectsで特定のタスクの番号が変更可能かどうかを確認してください。

• 次の項目のいずれかがタスクに賦課されている場合、タスク組織は変更できません。

  • 原価配分明細

  • 収益配分明細

  • 請求書草案

タスク開始日および終了日

タスク開始日および終了日には、次のルールが適用されます。

• タスク開始日は次のように設定する必要があります。

  • 親タスクの開始日より後

  • すべてのサブタスクの開始日より前

  • プロジェクトの開始日から完了日までの間

• 完了日がある各タスクには開始日も必要です。

• タスク完了日はプロジェクト完了日より前にする必要があります。

WBSでのタスクの移動

プロジェクトの作業分解構造（WBS）内でタスクを移動する場合には、次のルールが適用されます。

• 請求、予算編成、および資本資産の作成は最上位タスクから駆動されるため、新規の親タスクが同じ最上位タスクに属する場合のみ、サブタスクを移動できます。

• 最上位タスクをサブタスクに変更することはできません。

• サブタスクを最上位タスクに変更することはできません。

タスク属性

タスク属性には、次のルールが適用されます。

• 次のタスク属性はいずれもNULLに変更できません。

  • TASK_NAME

  • PM_TASK_REFERENCE

  • TASK_NUMBER

  • READY_TO_BILL_FLAG

  • READY_TO_DISTRIBUTE_FLAG

  • CARRYING_OUT_ORGANIZATION_ID

  • SERVICE_TYPE_CODE

• 次のタスク属性は制限なしで変更できます。

  • タスク・マネージャ

  • 説明

  • その他のフラグ（前述されていないもの）

  • 労務データと非労務データ

  • 予定表とレート

労務および非労務請求予定表および間接費計算予定表の属性の更新

タスクの労務および非労務予定表の属性を更新するためのルールは、プロジェクトで対応するルールと同じです。「プロジェクトの労務および非労務請求予定表および間接費計算予定表の属性を更新するためのルール」を参照してください。

UPDATE_PROJECTのパラメータ

UPDATE_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

値が必要なUPDATE_PROJECTのパラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

• P_PROJECT_IN

CLEAR_PROJECT

CLEAR_PROJECTは、ロード・プロセス中に設定されたグローバル・データ構造を消去するために使用するロード-実行-フェッチ・プロシージャです。

EXECUTE_CREATE_PROJECT

EXECUTE_CREATE_PROJECTは、ロード・プロセス中にグローバル表内に格納されたデータを使用してプロジェクトとそのタスクを作成するために使用するロード-実行-フェッチ・プロシージャです。

プロジェクトにユーザー定義属性を移入するために、このプロジェクトによってユーザー定義属性プロシージャが呼び出されます。詳細は、「ユーザー定義属性API」を参照してください。

ビジネス・ルール

Oracle Projectsは次のビジネス・ルールを課します。

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

EXECUTE_CREATE_PROJECTのパラメータ

EXECUTE_CREATE_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

EXECUTE_CREATE_PROJECTの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

EXECUTE_UPDATE_PROJECT

EXECUTE_UPDATE_PROJECTは、プロジェクト・データの変更または追加、新規タスクの追加、既存のタスクの更新など、既存のプロジェクトを更新するために使用するロード-実行-フェッチ・プロシージャです。このAPIではタスクは削除されません。ロード・プロセス中にグローバル表に格納されたデータが使用されます。

プロジェクトのユーザー定義属性を更新するために、このプロジェクトによってユーザー定義属性プロシージャが呼び出されます。詳細は、「ユーザー定義属性API」を参照してください。

ビジネス・ルール

Oracle Projectsは次のビジネス・ルールを課します。

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

EXECUTE_UPDATE_PROJECTのパラメータ

EXECUTE_UPDATE_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

EXECUTE_UPDATE_PROJECTの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

INIT_PROJECT

INIT_PROJECTは、グローバル・データ構造を設定するために使用するロード-実行-フェッチ・プロシージャです。その他のロード-実行-フェッチ・プロシージャでは、Oracle Projectsで新規プロジェクトを作成するために構造が使用されます。

LOAD_CLASS_CATEGORY

LOAD_CLASS_CATEGORYは、グローバルPL/SQL表に区分カテゴリをロードするために使用するロード-実行-フェッチ・プロシージャです。

LOAD_CLASS_CATEGORYのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

LOAD_CLASS_CATEGORYの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_CLASS_CATEGORY（テンプレートの設定によって異なる）

• P_CLASS_CODE（P_CLASS_CATEGORYがNULLでない場合）

LOAD_KEY_MEMBER

LOAD_KEY_MEMBERは、グローバルPL/SQL表にキー・メンバーをロードするために使用するロード-実行-フェッチ・プロシージャです。

LOAD_KEY_MEMBERのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

LOAD_KEY_MEMBERの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PERSON_ID（テンプレートの設定によって異なる）

• P_PROJECT_ROLE_TYPE（P_PERSON_IDがNULLでない場合）

LOAD_ORG_ROLE

LOAD_ORG_ROLEは、クライアント側からサーバー側のPL/SQL表に組織ロールをロードするために使用するロード-実行-フェッチ・プロシージャです。サーバー側では、これらのロールはロード-実行-フェッチ・サイクルで使用されます。

LOAD_ORG_ROLEのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

LOAD_ORG_ROLEの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_RESOURCE_SOURCE_ID（テンプレートの設定によって異なる）

• P_PROJECT_ROLE_TYPE（P_RESOURCE_SOURCE_IDがNULLでない場合）

LOAD_PROJECT

LOAD_PROJECTは、グローバルPL/SQLレコードにプロジェクトをロードするために使用するロード-実行-フェッチ・プロシージャです。

LOAD_PROJECTのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

LOAD_PROJECTの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PROJECT_REFERENCE

• P_PROJECT_NAME

• P_CREATED_FROM_PROJECT_ID

プロジェクト・テンプレートの設定に応じて、次のパラメータが必須になることがあります。

• P_CARRYING_OUT_ORGANIZATION_ID

• P_PUBLIC_SECTOR_FLAG

• P_PROJECT_STATUS_CODE

• P_DESCRIPTION

• P_START_DATE

• P_COMPLETION_DATE

• P_DISTRIBUTION_RULE

• P_CUSTOMER_ID

• P_PROJECT_RELATIONSHIP_CODE

チェック・プロシージャ

次のチェック・プロシージャは、次のことをリアルタイムで検証するために使用するPL/SQLプロシージャです。

• 外部システムに入力したプロジェクト情報がOracle Projects内で一意であるか

• 特定の機能（プロジェクトの削除など）がOracle Projectsで定義されたビジネス・ルールに従っているか

CHECK_CHANGE_PROJECT_ORG_OK

チェック・プロシージャCHECK_CHANGE_PROJECT_ORG_OKを使用して、特定のプロジェクトまたはタスクでCARRYING_OUT_ORGANIZATION_IDフィールドを変更できるかどうかを確認します。

CHECK_CHANGE_PROJECT_ORG_OKのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

CHECK_CHANGE_PROJECT_ORG_OKの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

CHECK_DELETE_PROJECT_OK

チェック・プロシージャCHECK_DELETE_PROJECT_OKを使用して、プロジェクトを削除できるかどうかを確認します。

CHECK_DELETE_PROJECT_OKのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

CHECK_DELETE_PROJECT_OKの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

CHECK_UNIQUE_PROJECT_REFERENCE

チェック・プロシージャCHECK_UNIQUE_PROJECT_REFERENCEを使用して、新規または変更済プロジェクト参照（PM_PROJECT_REFERENCE）が一意であるかどうかを確認します。

CHECK_UNIQUE_PROJECT_REFERENCEのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

CHECK_UNIQUE_PROJECT_REFERENCEの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

プロジェクト定義レコードおよび表のデータ型

以降のページに、APIで使用されるレコードおよび表のデータ型を定義します。

PROJECT_IN_REC_TYPEデータ型

次の表に、PROJECT_IN_REC_TYPEデータ型を示します。

PROJECT_OUT_REC_TYPEデータ型

次の表に、PROJECT_OUT_REC_TYPEデータ型を示します。

PROJECT_ROLE_TBL_TYPEデータ型

次の表に、PROJECT_ROLE_TBL_TYPEデータ型を示します。

CLASS_CATEGORY_TBL_TYPEデータ型

次の表に、CLASS_CATEGORY_TBL_TYPEデータ型を示します。

TASK_IN_TBL_TYPEデータ型

次の表に、TASK_IN_TBL_TYPEデータ型を示します。

注意: このデータ型を使用して既存のプロジェクトのタスクを更新する場合は、WBS体系全体を正しい階層に含める必要があります。

TASK_OUT_TBL_TYPEデータ型

次の表に、TASK_OUT_TBL_TYPEデータ型を示します。

TASK_IN_REC_TYPEデータ型

次の表に、TASK_IN_REC_TYPEデータ型を示します。

CUSTOMER_TBL_TYPEデータ型

このレコード・タイプを使用すると、ユーザーはUPDATE_PROJECT APIに複数の顧客を渡せます。次の表に、CUSTOMER_TBL_TYPEデータ型を示します。

DELIVERABLE_IN_REC_TYPE

次の表に、DELIVERABLE_IN_REC_TYPEデータ型を示します。

DELIVERABLE_OUT_REC_TYPE

次の表に、DELIVERABLE_OUT_REC_TYPEデータ型を示します。

ACTION_IN_REC_TYPE

次の表に、ACTION_IN_REC_TYPEデータ型を示します。

ACTION_OUT_REC_TYPE

次の表に、ACTION_OUT_REC_TYPEデータ型を示します。

プロジェクトの定義APIの使用方法

次の例では、Oracle Projectsとシステムに入力されたプロジェクトおよびタスク情報との間のインタフェースを作成する方法を説明します。会社のビジネス・ニーズに応じて、プロジェクトAPIの実装の複雑度は、ここに示す使用例とは若干異なる場合があります。例を参照する際には、このマニュアル内の他の情報も必要に応じて参照してください。

• プロジェクトAPIの詳細な説明は、「プロジェクトAPI」を参照してください。

• Oracle Projects APIの大部分では、入出力パラメータの標準セットが使用されます。これらのパラメータの説明は、「標準APIパラメータ」を参照してください。

• 複合データ型を使用せずにプロジェクトを作成するためのPL/SQLコードの例は、「ロード-実行-フェッチAPIを使用したプロジェクトの作成」を参照してください。

ステップ1: Oracleデータベースに接続

Oracle Projectsデータへのアクセス時に正しいセキュリティを確保するには、「セキュリティ要件」のステップに従ってください。

ステップ2: ソース・テンプレートまたはプロジェクトの選択

APIを使用してOracle Projectsで新規プロジェクトを作成する場合は、まず新規プロジェクトの作成元とするプロジェクト・テンプレートを選択します。このステップを実行しないと、Oracle Projectsで新規プロジェクトは作成されません。APIビューPA_SELECT_TEMPLATE_Vを使用して、有効なOracle Projectsソース・テンプレートを選択します。

あるいは、ソース・プロジェクトを選択することもできます。テンプレートとプロジェクトとの唯一の違いは、テンプレートのTEMPLATE_FLAGフィールドはYに設定されるという点です。テンプレートに基づいたすべてのプロジェクトおよび元のテンプレートにより、新規プロジェクトでどのクイック入力フィールドが表示されるかが決まります。この項では、ソース・テンプレートに関する説明はすべて、ソース・プロジェクトにも該当します。

ステップ3: ソース・テンプレートのクイック入力フィールドの取得

ソース・テンプレートを選択したら、PA_SOURCE_TEMPLATE_IDを使用して、テンプレートに関連したクイック入力フィールドを取得します。クイック入力フィールドは、Oracle Projectsでテンプレートを作成する際にテンプレートに割り当てます。クイック入力フィールドの詳細は、Oracle Metalinkで入手可能なOracle eTRMで「PA_PROJECT_COPY_OVERRIDES」を参照してください。

PA_OVERRIDE_FIELDS_Vビューには、特定のテンプレートに関連したクイック入力フィールドがすべて表示されます。設計するユーザー・インタフェースには少なくとも「表示名」、「値」および「必須」フィールドが表示されるようにし、「値」フィールドにのみユーザーが情報を入力できるようにする必要があります。

これらの要件を満たすユーザー・インタフェースの例を次に示します。

「クイック入力（上書き可能フィールド）」ウィンドウの例

ステップ4: クイック入力フィールドに有効なデータを入力

値リスト（LOV）では、クイック入力フィールドのほとんどが検証されます。PA_OVERRIDE_FIELDS_Vビューは、有効な行の有効なデータを含むビューの名称を取得し、この名称をLOV_VIEW_NAMEフィールドに返します。プロジェクト管理ツールでこの情報を使用すると、適切なビューに動的にアクセスできます。

たとえば、「資金調達ソース」フィールドにカーソルを置いて「有効な値の取得」を選択すると、プロジェクト管理ツールでは「コード」と「摘要」という2つの列がある画面が表示されます。データベース・ビューPA_CLASS_CATEGORIES_LOV_Vから取得した値は、これら2つの列見出しの下に表示されます。

プロジェクトのクイック入力フィールドの値リストを取得するには、次のビューも使用できます。

• PA_PROJECT_STATUS_CODES_LOV_V

• PA_DISTRIBUTION_RULES_LOV_V

• PA_KEY_MEMBERS_LOV_V

• PA_ORGANIZATIONS_LOV_V

• PA_CUSTOMERS_LOV_V

ステップ5: サーバーへのプロジェクト情報のインタフェース

ツールによっては、複合データ型を使用するAPIを呼び出せないものもあります。複合データ型をサポートしないツールは、補足的なロード-実行-フェッチAPIを呼び出す必要があります。ロード-実行-フェッチAPIには、データの初期化、ロード、実行、フェッチおよび消去を行うプロシージャが含まれています。

これらのAPIは、複合データ型パラメータをサポートしないツールを使用する場合のみ使用してください。ツール（たとえば、Oracle PL/SQLバージョン2.3以上）で複合データ型パラメータがサポートされる場合は、CREATE_PROJECTおよびUPDATE_PROJECT APIを直接呼び出せます。

次の表に、ユーザー・インタフェースの情報とLOAD_PROJECTとの間の関係を示します。

LOAD_PROJECTは、クイック入力値フィールドに入力された値を、対応するパラメータに渡します。既存のプロジェクトを更新するか新規プロジェクトを作成するかに応じて、LOAD_PROJECTは追加のパラメータを渡します。新規プロジェクトを作成する場合、このプロシージャは次のパラメータも渡す必要があります。

• P_PM_PROJECT_REFERENCEは、外部システム内のプロジェクトを識別する一意の参照コードを渡します。

• P_CREATED_FROM_PROJECT_IDは、Oracle Projects内のソース・テンプレートを識別する一意の参照コード（PA_SOURCE_TEMPLATE_ID）を渡します。

プロジェクトに複数のキー・メンバーまたは区分カテゴリがある場合は、プロジェクトに関連付けられたキー・メンバーおよび区分カテゴリごとに、LOAD_KEY_MEMBERおよびLOAD_CLASS_CATEGORYのAPIを呼び出す必要があります。

プロジェクトの作成時、「キー・メンバー」および「区分カテゴリ」クイック入力フィールドは、次の2つの表に示す入力パラメータに関連付けられます。

次の表に、「キー・メンバー」クイック入力フィールドの入力パラメータを示します。

次の表に、「区分カテゴリ」クイック入力フィールドの入力パラメータを示します。

ステップ6: サーバーへのタスク情報のインタフェース

サーバーにプロジェクト関連データをインタフェースしてから、LOAD_TASKを呼び出して、サーバー側のグローバルPL/SQL表にタスク関連データをインタフェースできます。プロジェクト内のタスクごとにLOAD_TASKを1回呼び出します。

重要: サブタスクをロードするには、その前に親タスクをロードする必要があります。

各タスクには少なくとも次の情報を指定する必要があります。

• P_PM_TASK_REFERENCE。外部システム内のタスクを識別する一意の参照コード。

• P_PM_PARENT_TASK_REFERENCE。タスクの親タスクを識別する一意の参照コード。最上位タスクについては、このパラメータはブランクになります。

• P_TASK_NAME。タスクの名称。

LOAD_TASKが渡せるその他のパラメータの名称と説明は、「LOAD_TASK」を参照してください。

ステップ7: サーバー側プロセスの開始

ロード・プロシージャによってプロジェクトおよびタスク・データがOracle ProjectsのグローバルPL/SQL表に正常に移動された後、EXECUTE_CREATE_PROJECTプロシージャを呼び出して、グローバルPL/SQL表にインタフェースしたプロジェクトおよびタスク・データを処理します。標準入出力パラメータに加えて、この実行プロシージャには次のパラメータが必要です。

• 入力パラメータ: P_PM_PRODUCT_CODE（プロジェクトをエクスポートする製品の識別コード）。製品（外部システム）をソースとして設定する際の詳細は、「Oracle Projectsでの製品の設定」を参照してください。

• 出力パラメータ:

  • P_PA_PROJECT_ID（新規プロジェクトに対する一意のOracle Projects識別コード）。

  • P_PA_PROJECT_NUMBER（新規プロジェクトに対する一意のOracle Projects番号）。手動プロジェクト採番をサポートするようにOracle Projectsを設定している場合、P_PA_PROJECT_NUMBERはP_PM_PROJECT_REFERENCEと同一である必要があります。自動採番を実装している場合、このパラメータは自動生成番号を返します。

ステップ8: タスクの戻り値の取得

ロードおよび実行プロシージャによってOracle Projects内にプロジェクトとタスクが作成された後、FETCH_TASKを使用してOracle Projectsから一意のタスク識別コードのそれぞれを返します。このプロシージャのキー・パラメータは、入力パラメータP_TASK_INDEX（単一タスクを指す）と出力パラメータP_PA_TASK_IDおよびP_PM_TASK_REFERENCEです。

タスクごとにプロシージャを呼び出すには、P_TASK_INDEXをステップ変数（1からタスクの合計数まで）として持つループ内でFETCH_TASKを呼び出す単純なプログラムを記述できます。出力パラメータP_TASK_RETURN_STATUSは、APIが特定のタスクを正常に処理したか（「S」）どうかを示します。このパラメータが「E」または「U」を返す場合は、タスクによってエラーが発生しており、フェッチ・プロシージャを停止して関連エラー・メッセージを取得する必要があります。フェッチAPIはエラー・メッセージ・データを返しません。かわりに、次のステップで説明するように、GET_MESSAGESを使用してエラー・テキストを取得します。

ステップ9: エラー・メッセージの取得

Oracle Projects APIのそれぞれに、2つの標準出力パラメータが含まれています。P_RETURN_STATUSは、APIが正常に実行されたかどうかを示します。P_MSG_COUNTは、APIの実行中に検出されたエラー数を示します。

APIで検出されたエラーが1つの場合、APIによってエラー・メッセージ・テキストが返されます。複数のエラーが検出された場合は、GET_MESSAGESを使用して、エラー・メッセージを取得します。詳細は、「GET_MESSAGES」を参照してください。

ステップ 10: ロード-実行-フェッチ・プロセスの終了

フェッチ・プロシージャを実行しエラー・メッセージを取得してから、API CLEAR_PROJECTを呼び出すことでロード-実行-フェッチ・プロセスを終了し、データベースへの変更を保存するかロールバックします。

ロード-実行-フェッチAPIを使用したプロジェクトの作成

次のPL/SQLコードは、ロード-実行-フェッチAPIを使用してプロジェクトを作成するために使用できるスクリプトのサンプルです。

ロード-実行-フェッチAPIでは、標準データ型（VARCHAR2、NUMBERおよびDATE）のパラメータが使用されます。複合データ型は使用されません。

DECLARE
--variables needed to create task hierarchy
level1 NUMBER;
level2 NUMBER;
level3 NUMBER;
a NUMBER := 0;
m NUMBER := 0;
parent_level1 VARCHAR2(30);
parent_level2 VARCHAR2(30);
parent_level3 VARCHAR2(30);
number_of_tasks1 NUMBER; ––number of tasks/level
number_of_tasks2 NUMBER;
number_of_tasks3 NUMBER;
number_of_tasks4 NUMBER;

--variables needed for API standard parameters
l_api_version_number NUMBER :=1.0 ;
l_commit VARCHAR2(1):= ’F’;
l_return_status VARCHAR2(1);
l_init_msg_list VARCHAR2(1);
l_msg_count NUMBER;
l_msg_data VARCHAR2(2000);
l_data VARCHAR2(2000);
l_msg_entity VARCHAR2(100);
l_msg_entity_index NUMBER;
l_msg_index NUMBER;
l_msg_index_out NUMBER;
l_encoded VARCHAR2(1);

--variables needed for Oracle Project specific parameters
l_created_from_project_id NUMBER;
l_pm_product_code VARCHAR2(10);
l_number_of_task_levels NUMBER;
l_project_name VARCHAR2(30);
l_pm_project_reference VARCHAR2(25);
l_project_status_code VARCHAR2(30);
l_distribution_rule VARCHAR2(30);
l_public_sector_flag VARCHAR2(1);
l_carrying_out_organization_id NUMBER;
l_start_date DATE;
l_completion_date DATE;
l_actual_start_date DATE;
l_actual_finish_date DATE;
l_early_start_date DATE;
l_early_finish_date DATE;
l_late_start_date DATE;
l_late_finish_date DATE;
l_person_id NUMBER;
l_project_role_type VARCHAR2(20);
l_class_category VARCHAR2(30);
l_class_code VARCHAR2(30);
l_project_id NUMBER(15);
l_pa_project_number VARCHAR2(25);
l_project_description VARCHAR2(250);
l_customer_id NUMBER;
l_project_relationship_code VARCHAR2(30);
l_task_id NUMBER(15);
l_pm_task_reference VARCHAR2(25);
l_task_index NUMBER;
l_tasks_in pa_project_pub.task_in_tbl_type;
l_task_rec pa_project_pub.task_in_rec_type;
l_key_member_rec pa_project_pub.project_role_rec_type;
l_key_member_tbl pa_project_pub.project_role_tbl_type;
l_task_return_status VARCHAR2(1);
API_ERROR EXCEPTION;

BEGIN

--PRODUCT RELATED DATA
l_pm_product_code :=’SOMETHING’;

--PROJECT DATA
l_created_from_project_id := 1040;
l_project_name := ’PROJECT_NAME’;
l_pm_project_reference := ’PROJECT_NAME’;
l_project_description := ’PROJECT_DESCRIPTION’;
l_project_status_code := ’’;
--l_distribution_rule := ’COST/COST’;
l_carrying_out_organization_id :=2;
l_start_date :=’01-jan-94’;
l_completion_date :=’31-mar-99’;
l_actual_start_date :=’01-jan-93’;
l_actual_finish_date :=’01-apr-99’;
l_early_start_date :=’01-jan-94’;
l_early_finish_date :=’31-mar-99’;
l_late_start_date :=’01-jan-94’;
l_late_finish_date :=’31-mar-99’;

--KEY MEMBERS DATA
m:= 1;
l_person_id :=’29’;
l_project_role_type :=’PROJECT MANAGER’;
l_key_member_rec.person_id :=29;
l_key_member_rec.project_role_type :=’PROJECT MANAGER’;
l_key_member_tbl(m) := l_key_member_rec;
m:=2;
l_key_member_rec.person_id :=30;
l_key_member_rec.project_role_type :=’Project Coordinator’;
l_key_member_tbl(m) := l_key_member_rec;
m:=3;
l_key_member_rec.person_id :=7;
l_key_member_rec.project_role_type :=’Project Coordinator’;
l_key_member_tbl(m) := l_key_member_rec;

--CLASS CATEGORIES DATA
l_class_category :=’Funding Source’;
l_class_code :=’Federal’;

--TASKS DATA
--Set the number of tasks for every level (there are 4 levels)
number_of_tasks1 := 10;
number_of_tasks2 := 1;
number_of_tasks3 := 1;
number_of_tasks4 := 0;

for level1 in 1..number_of_tasks1 loop
a:= a + 1;
l_task_rec.pm_task_reference :=a;
l_task_rec.task_name :=’TOP LEVEL ’||a;
l_task_rec.pm_parent_task_reference :=’’;
l_task_rec.task_start_date := ’09-MAR-95’;
l_task_rec.task_completion_date := ’05-JUL-95’;
l_task_rec.actual_start_date := ’10-MAR-95’;
l_task_rec.actual_finish_date := ’06-JUL-95’;
l_task_rec.early_start_date := ’09-MAR-95’;
l_task_rec.early_finish_date := ’05-JUL-95’;
l_task_rec.late_start_date := ’09-MAR-95’;
l_task_rec.late_finish_date := ’05-JUL-95’;
--l_task_rec.address_id := 1012;
l_tasks_in(a):= l_task_rec;
parent_level1:= a;
FOR level2 IN 1..number_of_tasks2 LOOP
a:= a + 1;
l_task_rec.pm_task_reference :=a;
l_task_rec.task_name :=’2 LEVEL ’||a;
l_task_rec.pm_parent_task_reference := parent_level1;
l_tasks_in(a) := l_task_rec;
parent_level2 := a;
for level3 IN 1..number_of_tasks3 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name :=’3 LEVEL ’||a;
l_task_rec.pm_parent_task_reference :=
parent_level2;
l_tasks_in(a) := l_task_rec;
parent_level3 := a;
for level4 IN 1..number_of_tasks4 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name :=’Fourth LEVEL
’||a;
l_task_rec.pm_parent_task_reference :=
parent_level3;
l_tasks_in(a) := l_task_rec;
end loop;
end loop;
END LOOP;
end loop;
-----------------------

--INIT_CREATE_PROJECT
pa_project_pub.init_project;
-----------------------
––LOAD_PROJECT
pa_project_pub.load_project( p_api_version_number =>
l_api_version_number
,p_return_status => l_return_status
,p_created_from_project_id =>
l_created_from_project_id
,p_project_name => l_project_name
,p_description =>
l_project_description
,p_pm_project_reference =>
l_pm_project_reference
,p_pa_project_number =>
’rk–test–number’
,p_carrying_out_organization_id =>
l_carrying_out_organization_id
,p_public_sector_flag =>
l_public_sector_flag
,p_customer_id => l_customer_id
,p_project_status_code =>
l_project_status_code
,p_start_date => l_start_date
,p_completion_date =>
l_completion_date
,p_actual_start_date =>
l_actual_start_date
,p_actual_finish_date =>
l_actual_finish_date
,p_early_start_date =>
l_early_start_date
,p_early_finish_date =>
l_early_finish_date
,p_late_start_date =>
l_late_start_date
,p_late_finish_date =>
l_late_finish_date
,p_distribution_rule =>
l_distribution_rule);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------
--LOAD_KEY_MEMBER (loop for multiple key members)
FOR i in 1..1 LOOP
pa_project_pub.load_key_member( p_api_version_number =>
l_api_version_number
,p_return_status => l_return_status
,p_person_id =>
l_key_member_tbl(i).person_id
,p_project_role_type =>
l_key_member_tbl(i).project_role_type );
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
-----------------------
--LOAD_CLASS_CATEGORY (loop for mulitple class categories
--This example has
-- only one )
FOR i IN 1..1 LOOP
pa_project_pub.load_class_category(
p_api_version_number =>
l_api_version_number
,p_return_status => l_return_status
,p_class_category => l_class_category
,p_class_code => l_class_code );
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
-----------------------
--LOAD_TASK (loop for multiple tasks)
FOR i IN 1..a LOOP
pa_project_pub.load_task( p_api_version_number =>
l_api_version_number
,p_return_status => l_return_status
,p_pm_task_reference =>
l_tasks_in(i).pm_task_reference
,p_task_name => l_tasks_in(i).task_name
,p_pm_parent_task_reference =>
l_tasks_in(i).pm_parent_task_reference
,p_task_start_date =>
l_tasks_in(i).task_start_date
,p_task_completion_date =>
l_tasks_in(i).task_completion_date
,p_actual_start_date =>
l_tasks_in(i).actual_start_date
,p_actual_finish_date =>
l_tasks_in(i).actual_finish_date
,p_early_start_date =>
l_tasks_in(i).early_start_date
,p_early_finish_date =>
l_tasks_in(i).early_finish_date
,p_late_start_date =>
l_tasks_in(i).late_start_date
,p_late_finish_date =>
l_tasks_in(i).late_finish_date
,p_address_id =>
l_tasks_in(i).address_id);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
-----------------------
--EXECUTE_CREATE_PROJECT
pa_project_pub.execute_create_project(p_api_version_number =>
l_api_version_number
,p_commit => l_commit
,p_init_msg_list => ’F’
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_return_status => l_return_status
,p_pm_product_code =>
l_pm_product_code
,p_pa_project_id => l_project_id
,p_pa_project_number =>
l_pa_project_number);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------
--FETCH_TASK
FOR l_task_index in 1..a LOOP
pa_project_pub.fetch_task( p_api_version_number =>
l_api_version_number
,p_return_status => l_return_status
,p_task_index => l_task_index
,p_pa_task_id => l_task_id
,p_pm_task_reference =>
l_pm_task_reference
,p_task_return_status =>
l_task_return_status);
IF l_return_status != ’S’
OR l_task_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
-----------------------
--CLEAR_CREATE_PROJECT
pa_project_pub.clear_project;
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------
--HANDLE EXCEPTIONS
EXCEPTION
WHEN API_ERROR THEN
for i in 1..l_msg_count loop
pa_interface_utils_pub.get_messages (
p_msg_data => l_msg_data
,p_data => l_data
,p_msg_count => l_msg_count
,p_msg_index_out => l_msg_index_out );
dbms_output.put_line (’error mesg ’||l_data);
end loop;
WHEN OTHERS THEN
for i in 1..l_msg_count loop
pa_interface_utils_pub.get_messages (
p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_data => l_data
,p_msg_index_out => l_msg_index_out);
dbms_output.put_line (’error mesg ’||l_data);
end loop;
END ;
/

体系API

体系APIを利用すると、外部システムを使用して体系バージョンを作成および変更できます。また、タスクの追加、更新および削除も行えます。

注意: タスク識別子が必要な体系APIを呼び出す場合は、P_PA_TASK_IDまたはP_PM_TASK_REFERENCEパラメータを渡してタスクを識別する必要があります。

体系APIのビュー

次の表に、体系APIのパラメータ・データを提供するビューを示します。ビューの詳細は、OracleMetaLinkで入手可能なOracle eTRMを参照してください。

体系APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_PROJECT_PUB内にあります。

• 体系プロシージャおよびタスク・プロシージャ

  • ADD_TASK

  • APPLY_LP_PROG_ON_CWV

  • BASELINE_STRUCTURE

  • CHANGE_CURRENT_WORKING_VERSION

  • CHANGE_STRUCTURE_STATUS

  • DELETE_STRUCTURE_VERSION

  • DELETE_TASK

  • GET_TASK_VERSION

  • GET_DELETED_TASKS_FROM_OP

  • UPDATE_TASK

• ロード-実行-フェッチ・プロシージャ

  • FETCH_STRUCTURE_VERSION

  • FETCH_TASK

  • FETCH_TASKS

  • FETCH_TASK_VERSION

  • LOAD_STRUCTURE

  • LOAD_TASK

  • LOAD_TASKS

• チェック・プロシージャ

  • CHECK_ADD_SUBTASK_OK

  • CHECK_CHANGE_PARENT_OK

  • CHECK_DELETE_TASK_OK

  • CHECK_TASK_NUMBER_CHANGE_OK

  • CHECK_TASK_MFD

  • CHECK_UNIQUE_TASK_NUMBER

  • CHECK_UNIQUE_TASK_REFERENCE

体系APIのプロシージャ定義

この項では、体系APIについて、ビジネス・ルールおよびパラメータも含めて説明します。

ADD_TASK

ADD_TASKは、Oracle Projectsでプロジェクトのタスクに新規サブタスクを追加するために使用するPL/SQLプロシージャです。レコード・タイプ定義のフィールドごとに、タスク・レコード・タイプは標準データ型（NUMBER、VARCHAR2またはDATE）のパラメータに置き換えられているため、このプロシージャを直接呼び出すことができます。

ビジネス・ルール（タスク・レベル）

Oracle Projectsは、タスク・レベルで次のビジネス・ルールを課します。

• 新規タスクごとに特定プロジェクト内で一意の番号を指定する必要があります。チェック・プロシージャCHECK_UNIQUE_TASK_NUMBERを使用すると、新規タスク番号がプロジェクト内にすでに存在していないことを確認できます。

• 親タスクに次の属性のいずれかがある場合、プロジェクトにサブタスクを作成することはできません。

  • 取引管理

  • 間接費予定表上書き

  • 予算

  • パーセント完了値

  • 資産

  • 支出項目

  • 発注配分

  • 発注購買依頼

  • Oracle Payables請求書

  • Oracle Payables請求書配分

    注意: チェック・プロシージャCHECK_ADD_SUBTASK_OKを使用すると、特定の親タスクにサブタスクを追加できることを確認できます。

• 契約プロジェクトでは、次の属性のいずれかを持つ親タスクにサブタスクを追加することはできません。

  • 労務費乗数

  • 役職請求レート上書き

  • 従業員請求レート上書き

  • 労務乗数

  • 非労務請求レート上書き

  • 役職請求職位上書き

  • 役職割当上書き

    注意: チェック・プロシージャCHECK_ADD_SUBTASK_OKを使用すると、特定の親タスクにサブタスクを追加できることを確認できます。

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

ADD_TASKのパラメータ

ADD_TASKのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

ADD_TASKの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

• P_PM_PROJECT_REFERENCE

• P_STRUCTURE_VERSION_ID

• P_PA_PROJECT_ID

• P_PM_TASK_REFERENCE

• P_PA_TASK_NUMBER

• P_TASK_NAME

• P_PRED_STRING

• P_PRED_DELIMITER

• P_BASE_PERCENT_COMP_DERIV_CODE

• P_SCH_TOOL_TSK_TYPE_CODE

• P_CONSTRAINT_TYPE_CODE

• P_CONSTRAINT_DATE

• P_FREE_SLACK

• P_TOTAL_SLACK

• P_EFFORT_DRIVEN_FLAG

• P_LEVEL_ASSIGNMENTS_FLAG

• P_INVOICE_METHOD

• P_CUSTOMER_ID

• P_GEN_ETC_SOURCE_CODE

• P_MAPPED_TASK_ID

• P_MAPPED_TASK_REFERENCE

• P_EXT_ACT_DURATION

• P_EXT_REMAIN_DURATION

• P_EXT_SCH_DURATION

APPLY_LP_PROG_ON_CWV

APPLY_LP_PROG_ON_CWVは、現行作業中バージョンの体系に関する最新進捗情報を適用するために使用します。

APPLY_LP_PROG_ON_CWVのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

APPLY_LP_PROG_ON_CWVの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_WORKING_STR_VERSION_ID

BASELINE_STRUCTURE

BASELINE_STRUCTUREは、体系バージョンを基本編成するPL/SQLプロシージャです。

BASELINE_STRUCTUREのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

BASELINE_STRUCTUREの必須パラメータは、次のとおりです。

• P_API_VERSION_NUMBER

• P_STRUCTURE_VERSION_ID

• P_PA_PROJECT_ID

CHANGE_CURRENT_WORKING_VERSION

CHANGE_CURRENT_WORKING_VERSIONは、現行作業中バージョンの体系を変更するために使用します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_STRUCTURE_VERSION_ID

• P_PA_PROJECT_ID

CHANGE_STRUCTURE_STATUS

このPL/SQLプロシージャは、体系の公開、発行、再処理、棄却または承認、およびそのステータス・コードの変更を行うために使用します。有効なステータス・コードは次のとおりです。

• STRUCTURE_WORKING

• STRUCTURE_PUBLISHED

• STRUCTURE_SUBMITTED

• STRUCTURE_REJECTED

• STRUCTURE_APPROVED

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_STRUCTURE_VERSION_ID

• P_PA_PROJECT_ID

• P_STATUS_CODE

DELETE_STRUCTURE_VERSION

DELETE_STRUCTURE_VERSIONは、Oracle Projectsから体系バージョンを削除するために使用するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_STRUCTURE_VERSION_ID

DELETE_TASK

DELETE_TASKは、Oracle Projectsでプロジェクトのタスクを削除するために使用するPL/SQLプロシージャです。

ビジネス・ルール（タスク・レベル）

Oracle Projectsは次のビジネス・ルールを課します。

カスケード・タスクの削除

次のルールは、カスケード・タスクの削除に適用されます。カスケード・タスクの削除では、タスクが削除されると、そのサブタスクもすべて削除されます。

タスクがルール1〜8を満たす場合のみ、最上位タスクを削除できます。

タスクがルール4〜8を満たす場合、中位または最下位タスクを削除できます（中位タスクの場合、ルールはその中位タスクの下にある最下位タスクに関連します）。

1. 最上位タスク・イベント（収益、請求など）が存在しない

2. 最上位タスク資金が存在しない

3. 最上位タスク予算が存在しない

4. 最下位タスク支出項目が存在しない

5. 最下位タスク発注明細が存在しない

6. 最下位タスク購買依頼明細が存在しない

7. 最下位タスク仕入先請求書が存在しない

8. 最下位タスク予算が存在しない

非カスケード・タスクの削除

次のビジネス・ルールは、非カスケード・タスクの削除に適用されます。非カスケード・タスクの削除では、タスクを削除すると該当タスクのみが削除され、その下にあるサブタスクはすべて、プロジェクトの作業分解構造内で1レベル上位に移動します。

• 中位タスクは常に削除できます。

• カスケード・タスクの削除では、ルール1〜3を満たす最上位タスクを削除できます。

• カスケード・タスクの削除では、ルール4〜8を満たす最下位タスクを削除できます。

パラメータ

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

GET_TASK_VERSION

GET_TASK_VERSIONは、特定の体系バージョンに対してタスクのタスク・バージョンIDを取得するために使用します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PA_PROJECT_ID

• P_PA_TASK_ID

• P_PA_STRUCTURE_VERSION_ID

GET_DELETED_TASKS_FROM_OP

Oracle Projectsでバージョン使用可作業計画を公開すると、「削除対象」ステータスを持つ作業中バージョンのタスクは削除されるか、「取消済」ステータスに設定されます。GET_DELETED_TASKS_FROM_OPプロシージャは、Oracle Projectsで削除済タスクのリストを取得し、Microsoft Projectなどの統合外部システムでタスクを表示します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャのパラメータはすべてOUTパラメータであるため、必須パラメータはありません。

UPDATE_TASK

UPDATE_TASKは、Oracle Projectsでプロジェクトの既存のタスクを更新するために使用するPL/SQLプロシージャです。レコード・タイプ定義のフィールドごとに、タスク・レコード・タイプは標準データ型（VARCHAR2、NUMBERおよびDATE）を使用するパラメータに置き換えられているため、このプロシージャを直接呼び出すことができます。

ビジネス・ルール（タスク・レベル）

Oracle Projectsは次のビジネス・ルールを課します。

外部システムとOracle Projectsとの間でタスク情報が共有される順序には、次のルールが適用されます。

• 関連した子タスクの定義をインタフェースするには、Oracle Projectsに親タスクの定義をインタフェースしておく必要があります。

タスク番号、識別コードおよび組織には、次のルールが適用されます。

• 新規タスク番号はプロジェクト内で一意にする必要があります。（チェック・プロシージャCHECK_UNIQUE_TASK_NUMBERを使用すると、新規タスク番号がOracle Projects内で一意であるかどうかを確認できます。）

• 外部システムによってTASK_IDとPM_TASK_REFERENCEの両方がOracle Projectsにプッシュされる場合、Oracle ProjectsではTASK_IDを使用してタスクが識別され、PM_TASK_REFERENCEは入力値（異なる場合）で更新されます。

• 次の項目のいずれかがタスクに賦課されている場合、タスク番号は変更できません。

  • 支出項目

  • 発注配分

  • 発注購買依頼配分

  • 仕入先請求書

  • 仕入先請求書配分

    注意: チェック・プロシージャCHECK_TASK_NUMBER_CHANGE_OKを使用すると、Oracle Projectsで特定のタスクの番号が変更可能かどうかを確認できます。

• 次の項目のいずれかがタスクに賦課されている場合、タスク組織は変更できません。

  • 原価配分明細

  • 収益配分明細

  • 請求書草案

  タスク開始日および完了日には、次のルールが適用されます。

• タスク開始日は次のように設定する必要があります。

  • 親タスクの開始日より後

  • すべてのサブタスクの開始日より前

  • プロジェクトの開始日から完了日までの間

• 完了日がある各タスクには開始日も必要です。

• タスク完了日はプロジェクト完了日より前にする必要があります。

プロジェクトの作業分解構造（WBS）内でタスクを移動する場合には、次のルールが適用されます。

• 請求、予算編成および資本資産の作成は最上位タスクから駆動されるため、新規の親タスクが同じ最上位タスクに属するかぎり、サブタスクを移動できます。

• 最上位タスクをサブタスクに変更することはできません。

• サブタスクを最上位タスクに変更することはできません。

タスク・フィールドおよび属性の変更には、次のルールが適用されます。

• 値がNULLのタスク・フィールドは更新できません。NULLでない有効な値を持つフィールドのみが更新されます。

• 次のタスク・フィールドはいずれもNULLに変更できません。

  • TASK_NAME

  • PM_TASK_REFERENCE

  • TASK_NUMBER

  • READY_TO_BILL_FLAG

  • READY_TO_DISTRIBUTE_FLAG

  • CARRYING_OUT_ORGANIZATION_ID

  • SERVICE_TYPE_CODE

• 次のタスク属性は制限なしで変更できます。

  • タスク・マネージャ

  • 説明

  • 前述されていないその他のフラグ

  • 労務データと非労務データ

  • 予定表とレート

計画検証の実行

P_OP_VALIDATE_FLAGパラメータに「N」を設定した場合、計画データのタイプを指定するための余分な検証を消去します。不要な計画検証はシステム・パフォーマンスを遅くします。

サード・パーティの計画ツールをOracle Projectsと統合するためにこのAPIを使用している場合、P_OP_VALIDATE_FLAGを「N」に設定する必要があります。サード・パーティの計画ツールが次の検証を実行できる場合、このパラメータを「N」に設定してください。

• タスクおよびアクティビティ間の依存関係

• プロジェクト予定日とタスク予定日

APIを使用して前述の広範囲な検証を実行しないレガシー・システムからデータをアップロードしている場合、P_OP_VALIDATE_FLAGを「Y」に設定する必要があります。Oracle Projectsでのデータ整合性を確実にするために、計画データを検証する必要があります。

UPDATE_TASKのパラメータ

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PM_PRODUCT_CODE

• P_PM_PROJECT_REFERENCE

• P_PA_PROJECT_ID

• P_PM_TASK_REFERENCE

• P_PA_TASK_ID

• P_TASK_NAME

• P_PA_TASK_NUMBER

• P_TASK_DESCRIPTION

• P_PRED_STRING

• P_PRED_DELIMITER

• P_BASE_PERCENT_COMP_DERIV_CODE

• P_SCH_TOOL_TSK_TYPE_CODE

• P_CONSTRAINT_TYPE_CODE

• P_CONSTRAINT_DATE

• P_FREE_SLACK

• P_TOTAL_SLACK

• P_EFFORT_DRIVEN_FLAG

• P_LEVEL_ASSIGNMENTS_FLAG

• P_INVOICE_METHOD

• P_CUSTOMER_ID

• P_GEN_ETC_SOURCE_CODE

• P_FINANCIAL_TASK_FLAG

• P_MAPPED_TASK_ID

• P_MAPPED_TASK_REFERENCE

• P_DELIVERABLE

• P_EXT_ACT_DURATION

• P_EXT_REMAIN_DURATION

• P_EXT_SCH_DURATION

• P_ETC_EFFORT

• P_PERCENT_COMPLETE

FETCH_STRUCTURE_VERSION

FETCH_STRUCTURE_VERSIONは、作業計画および財務体系の体系バージョンIDを返すロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

FETCH_TASK

FETCH_TASKは、タスクに関連した出力パラメータをフェッチするために使用するロード-実行-フェッチ・プロシージャです。FETCH_TASKは、正常に処理されたタスクをグローバルPL/SQL表にロードするために使用します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_TASK_INDEX

FETCH_TASKS

FETCH_TASKSは、FETCH_TASKへの複数の呼出しを処理するFETCH_TASKのラッパーです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_TASK_INDEX

FETCH_TASK_VERSION

FETCH_TASK_VERSIONは、タスクのバージョン識別子を返すロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_TASK_INDEX

LOAD_STRUCTURE

LOAD_STRUCTUREは、体系データをロードするために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

LOAD_TASK

LOAD_TASKは、グローバルPL/SQL表にタスクをロードするために使用するロード-実行-フェッチ・プロシージャです。

ビジネス・ルール（タスク・レベル）

Oracle Projectsは次のビジネス・ルールを課します。

• 親タスクはサブタスクより前にロードする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_TASK_NAME

• P_PA_TASK_NUMBER

• P_PRED_STRING

• P_PRED_DELIMITER

• P_BASE_PERCENT_COMP_DERIV_CODE

• P_SCH_TOOL_TSK_TYPE_CODE

• P_CONSTRAINT_TYPE_CODE

• P_CONSTRAINT_DATE

• P_FREE_SLACK

• P_TOTAL_SLACK

• P_EFFORT_DRIVEN_FLAG

• P_LEVEL_ASSIGNMENTS_FLAG

• P_INVOICE_METHOD

• P_CUSTOMER_ID

• P_GEN_ETC_SOURCE_CODE

• P_FINANCIAL_TASK_FLAG

• P_MAPPED_TASK_ID

• P_MAPPED_TASK_REFERENCE

• P_EXT_ACT_DURATION

• P_EXT_REMAIN_DURATION

• P_EXT_SCH_DURATION

• P_ETC_EFFORT

• P_PERCENT_COMPLETE

LOAD_TASKS

LOAD_TASKSは、グローバルPL/SQL表にタスクをロードするために使用するロード-実行-フェッチ・プロシージャです。このプロシージャのパラメータは、LOAD_TASKのパラメータと同じです。

チェック・プロシージャ

次のチェック・プロシージャは、次のことをリアルタイムで検証するために使用するPL/SQLプロシージャです。

• 外部システムに入力したタスク情報がOracle Projects内で一意であるか

• 特定の機能（タスクの削除など）がOracle Projectsで定義されたビジネス・ルールに従っているか

CHECK_ADD_SUBTASK_OK

チェック・プロシージャCHECK_ADD_SUBTASK_OKを使用して、サブタスクを親タスクに追加できるかどうかを確認します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_CHANGE_PARENT_OK

チェック・プロシージャCHECK_CHANGE_PARENT_OKを使用して、ある親タスクのタスクを別の親タスクに移動できるかどうかを確認します。同じ最上位タスクを維持するかぎり、タスクは移動できます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_DELETE_TASK_OK

チェック・プロシージャCHECK_DELETE_TASK_OKを使用して、タスクを削除できるかどうかを確認します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_TASK_NUMBER_CHANGE_OK

チェック・プロシージャCHECK_TASK_NUMBER_CHANGE_OKを使用して、タスクの番号を変更できるかどうかを確認します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_TASK_MFD

チェック・プロシージャCHECK_TASK_MFDを使用して、Microsoft Projectなどの外部計画システムをOracle Projectsと統合する場合に、外部計画システムで削除されたタスクをOracle Projectsで削除できるかどうかを確認します。公開済バージョンが存在しない場合、Oracle Projectsでタスクは即座に削除されます。Oracle Projectsで作業中の作業計画バージョンが公開されると、タスクは削除対象または取消済としてマークされます。このプロシージャは、取引があるタスクが削除されることを防ぎます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_UNIQUE_TASK_NUMBER

チェック・プロシージャCHECK_UNIQUE_TASK_NUMBERを使用して、新規または変更済タスク番号がプロジェクト内で一意であるかどうかを確認します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CHECK_UNIQUE_TASK_REFERENCE

チェック・プロシージャCHECK_UNIQUE_TASK_REFERENCEを使用して、新規または変更済タスク参照（PM_TASK_REFERENCE）が一意であるかどうかを確認します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

ユーザー定義属性API

ユーザー定義属性APIを使用すると、外部システムのユーザー定義属性をOracle Projectsと統合できます。

ユーザー定義属性を使用すると、ビジネスのニーズに対応するために、プロジェクトおよびタスクに関して無制限の情報を取得できます。ユーザー定義属性は、実装チームによって定義されます。ユーザー定義属性は、コーディングなしで高度なプロジェクトおよびタスク属性を提供し、複雑な検証付きの構成可能なユーザー・インタフェースを特徴としています。ユーザー定義属性の詳細は、『Oracle Projects基礎』のプロジェクトのユーザー定義属性および『Oracle Projectsインプリメンテーション・ガイド』のユーザー定義属性の設定に関する項を参照してください。

ユーザー定義属性プロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_PROJECT_PUB内にあります。

• LOAD_EXTENSIBLE_ATTRIBUTE

• LOAD_EXTENSIBLE_ATTRIBUTES

これらのプロシージャは、次のロード-実行-フェッチ・プロシージャによって呼び出されます。

• Execute_Create_Project

• Execute_Update_Project

グローバル定数

PA_PROJECT_PUBパッケージには、P_TRANSACTION_TYPEパラメータに使用されるグローバル定数が含まれています。次の表にグローバル定数を示します。

LOAD_EXTENSIBLE_ATTRIBUTE

このAPIは、指定されたプロジェクトおよびタスクに対して特定の属性グループの単一属性値をロードします。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

次の表に、このプロシージャの必須パラメータを示します。

パラメータ要件

前の表で「必須」列に番号が含まれる場合、値が必須であるかどうかは次の論理によって決まります。

「必須」列に同じ番号があるパラメータのうち、いずれか1つにのみ値を指定する必要があります。たとえば、P_TASK_IDとP_TASK_REFERENCEは両方とも「必須」列に番号1があるため、P_TASK_IDまたはP_TASK_REFERENCEに値を指定する必要があります。

LOAD_EXTENSIBLE_ATTRIBUTES

これは、API呼出しごとに1000属性のバッチで属性値をロードするバルク・ロードAPIです。このプロシージャは、LOAD_EXTENSIBLE_ATTRIBUTE APIを呼び出します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

次の表に、このプロシージャの必須パラメータを示します。

ユーザー定義属性APIの使用方法

ユーザー定義属性の特徴として、単一行属性と複数行属性がサポートされています。これは、外部システムからユーザー定義属性を統合する際に考慮する必要がある重要な概念です。

単一および複数行属性グループ

この例では、プロジェクトに対して2つの属性グループ、プロジェクト複雑度とアプリケーション加重が定義されています。

プロジェクト複雑度は単一行属性グループで、多数の情報レコードを表示します。各レコードは表内で1行に表示され、ページ内に複数の列があります。

次の図に、これらのグループが入力画面でどのように表示されるかを示します。

入力画面における属性グループの例

単一行属性グループの統合

次の表に、単一行属性グループであるプロジェクト複雑度のデータを示します。

API LOAD_EXTENSIBLE_ATTRIBUTESによるバルク・アプローチを使用してこの情報をロードするには、PL/SQLレコードを使用して表内の各セルをロードします。単一行のセルはすべて、共通の属性行識別子を使用して識別されます。

注意: 属性と値のペアは、LOAD_EXTENSIBLE_ATTRIBUTE APIを使用して1つずつロードすることもできます。

次の表に、属性行識別子によって属性を単一行に挿入する方法を示します。

複数行属性グループの統合

次の表に、複数行属性グループであるアプリケーション加重のデータを示します。

ここに示された情報をロードするには、PL/SQLレコードを使用して前述の表内の各セルをロードします。単一行のセルはすべて、共通の属性行識別子を使用して識別できます。

次の表に、LOAD_EXTENSIBLE_ATTRIBUTESバルク・ロードAPIを使用してこの情報をロードするための論理アプローチを示します。

この例では、属性行識別子を使用して属性を単一行にグループ化する方法を示します。バルク・ロード・アプローチを使用すると、複数の属性グループ（単一行と複数行の両方）をAPIへの1回の呼出しでロードできます。

LOAD_EXTENSIBLE_ATTRIBUTE APIの使用例

次のサンプル・スクリプトでは、LOAD_EXTENSIBLE_ATTRIBUTE APIを使用してユーザー定義属性グループに対して単一属性と値のペアを統合する方法を示します。

/*
Name: EATESTPACKAGE.SQL
Purpose: Package for the project amg api procedures’ wrappers.
*/
create or replace package pa_EA_test as
procedure create_project_EA(
created_from_project_id number
,project_name varchar2
);
end pa_EA_test;
/
CREATE OR REPLACE PACKAGE BODY PA_EA_TEST as
procedure create_project_EA(
created_from_project_id number
,project_name varchar2
) as
--This package is an example of how the LOAD_EXTENSIBLE_ATTRIBUTE API can be used
--to integrate a single attribute/value pair for a user-defined attribute group.

--variables needed to create task hierarchy
level1 number;
level2 number;
level3 number;
a number := 0;
m number := 0;
parent_level1 varchar2(30);
parent_level2 varchar2(30);
parent_level3 varchar2(30);
parent_level4 varchar2(30);
parent_level5 varchar2(30);
number_of_tasks1 number;
number_of_tasks2 number;
number_of_tasks3 number;
number_of_tasks4 number;
number_of_tasks5 number;
number_of_tasks6 number;
temp_msg_data varchar2(2000);

--variables needed for api standard parameters
l_api_version_number number := 1.0;
l_commit varchar2(1) := ’T’;
l_return_status varchar2(1);
l_init_msg_list varchar2(1) := ’T’;
l_msg_data varchar2(2000);
l_msg_entity varchar2(100);
l_msg_entity_index number;
l_msg_index number;
l_encoded varchar2(1);
l_work_flow_started varchar2(1);
t1 varchar2(10);
t2 varchar2(100);
l_data varchar2(200);
t3 varchar2(2000);
l_msg_count number;
l_msg_index_out number;

--variables needed for oracle project specific parameters
l_created_from_project_id number;
l_pm_product_code varchar2(10);
l_number_of_task_levels number;
l_project_name varchar2(30);
l_project_number varchar2(80);
l_pm_project_reference varchar2(25);
l_project_status_code varchar2(30);
l_distribution_rule varchar2(30);
l_public_sector_flag varchar2(1);
l_carrying_out_organization_id number;
l_start_date date;
l_completion_date date;
l_actual_start_date date;
l_actual_finish_date date;
l_early_start_date date;
l_early_finish_date date;
l_late_start_date date;
l_late_finish_date date;
l_person_id number;
l_project_role_type varchar2(20);
l_class_category varchar2(30);
l_class_code varchar2(30);
l_project_id number(15);
l_pa_project_number varchar2(25);
l_project_description varchar2(250);
l_customer_id number;
l_project_relationship_code varchar2(30);
l_task_id number(15);
l_pm_task_reference varchar2(25);
l_task_index number;
project_loop number;
l_tasks_in pa_project_pub.task_in_tbl_type;
l_task_rec pa_project_pub.task_in_rec_type;
l_key_member_rec pa_project_pub.project_role_rec_type;
l_key_member_tbl pa_project_pub.project_role_tbl_type;
l_task_return_status varchar2(1);
l_short_name varchar2(10);
l_role_list_id number;
l_work_type_id number;
l_calendar_id number;
l_location_id number;
l_probability_member_id number;
l_project_value number;
l_opp_value_currency_code varchar2(15) := ’USD’;
l_expected_approval_date date;
api_error exception;
l_org_member_rec pa_project_pub.project_role_rec_type;
l_org_member_tbl pa_project_pub.project_role_tbl_type;
l_task_version_id number;
l_encoded_msg varchar2(4000);
l_decoded_msg varchar2(4000);
l_final_msg varchar2(4000);
l_structure_type varchar2(25);
l_structure_version_name varchar2(25);
l_structure_version_id varchar2(25);
l_structure_description varchar2(150);
l_long_name varchar2(80);
v_time_before number;
l_ATTR_GRP_ROW_INDEX number;
l_ATTR_GRP_INTERNAL_NAME varchar2(15);
l_ATTR_INTERNAL_NAME varchar2(15);
l_ATTR_DISP_VALUE varchar2(15);

BEGIN
v_time_before := DBMS_UTILITY.get_time;
--PRODUCT RELATED DATA
l_pm_product_code := ’MSPROJECT’;
--PROJECT DATA
l_created_from_project_id := created_from_project_id;
l_project_name := project_name;
l_project_number := project_name;
l_pm_project_reference := project_name;
l_project_description := project_name;
l_long_name := project_name;
l_project_status_code := ’’;
l_carrying_out_organization_id := 244;
l_start_date := ’01-jan-00’;
l_completion_date := ’31-mar-05’;
l_actual_start_date := ’01-jan-01’;
l_actual_finish_date := ’01-apr-05’;
l_early_start_date := ’01-jan-01’;
l_early_finish_date := ’01-apr-05’;
l_late_start_date := ’01-jan-01’;
l_late_finish_date := ’01-APR-05’;
l_role_list_id := 1000 ;
l_work_type_id := 10020;
l_calendar_id := 550;
l_location_id := 1;
l_probability_member_id := 1005;
l_project_value := 1000;
l_expected_approval_date := ’31-mar-99’;

--KEY MEMBERS DATA
l_key_member_rec.person_id := 53;
l_key_member_rec.project_role_type := ’PROJECT MANAGER’;
l_key_member_tbl(1) := l_key_member_rec;
--CLASS CATEGORIES DATA
l_class_category := ’Product’;
l_class_code := ’Non-classified’;

-- EXTENSIBLE ATTRIBUTES DATA
l_ATTR_GRP_ROW_INDEX := 1;
l_ATTR_GRP_INTERNAL_NAME:= ’Project Complexity’;
l_ATTR_INTERNAL_NAME := ’AIM Project Type’;
l_ATTR_DISP_VALUE := ’AIM’;
--TASKS DATA
-- Set the number of tasks for every level (there are 6 levels)
number_of_tasks1 := 5;
number_of_tasks2 := 2;
number_of_tasks3 := 0;
number_of_tasks4 := 0;
number_of_tasks5 := 0;
number_of_tasks6 := 0;
a := 0;
for level1 in 1..number_of_tasks1 loop
a:= a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name := ’TOP LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := ’’;
l_task_rec.task_start_date := ’01-jan-00’;
l_task_rec.task_completion_date := ’31-mar-05’;
l_task_rec.actual_start_date := ’01-JAN-01’;
l_task_rec.actual_finish_date := ’01-APR-05’;
l_task_rec.early_start_date := ’01-JAN-01’;
l_task_rec.early_finish_date := ’01-APR-05’;
l_task_rec.late_start_date := ’01-JAN-01’;
l_task_rec.late_finish_date := ’01-APR-05’;
l_tasks_in(a) := l_task_rec;
parent_level1 := a;
FOR level2 IN 1..number_of_tasks2 LOOP
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name := ’2 LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := parent_level1;
l_tasks_in(a) := l_task_rec;
parent_level2 := a;
for level3 IN 1..number_of_tasks3 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name :=’3 LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := parent_level2;
l_tasks_in(a) := l_task_rec;
parent_level3 := a;
for level4 IN 1..number_of_tasks4 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name := ’4 LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := parent_level3;
l_tasks_in(a) := l_task_rec;
for level5 IN 1..number_of_tasks5 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name := ’5 LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := parent_level4;
l_tasks_in(a) := l_task_rec;
for level6 IN 1..number_of_tasks6 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name := ’6 LEVEL ’|| a;
l_task_rec.pm_parent_task_reference := parent_level5;
l_tasks_in(a) := l_task_rec;
end loop;––6th level
end loop;––5th level
end loop;––4th level
end loop;––3rd level
end loop;––2nd level
end loop;––1st level
-----------------------
dbms_output.put_line(’Total tasks processed. ’||l_tasks_in.count);
-----------------------

--INIT_CREATE_PROJECT
pa_project_pub.init_project;
-----------------------
--dbms_output.put_line(’Before load_project’);

--LOAD_PROJECT
pa_project_pub.load_project( p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_created_from_project_id => l_created_from_project_id
,p_project_name => l_project_name
,p_long_name => l_long_name
,p_description => l_project_description
,p_pm_project_reference => l_pm_project_reference
,p_pa_project_number => l_project_number
,p_carrying_out_organization_id => l_carrying_out_organization_id
,p_public_sector_flag => l_public_sector_flag
,p_customer_id => l_customer_id
,p_project_status_code => l_project_status_code
,p_start_date => l_start_date
,p_completion_date => l_completion_date
,p_actual_start_date => l_actual_start_date
,p_actual_finish_date => l_actual_finish_date
,p_early_start_date => l_early_start_date
,p_early_finish_date => l_early_finish_date
,p_late_start_date => l_late_start_date
,p_late_finish_date => l_late_finish_date
,p_role_list_id => l_role_list_id
,p_work_type_id => l_work_type_id
,p_calendar_id => l_calendar_id
,p_location_id => l_location_id
,p_probability_member_id => l_probability_member_id
,p_project_value => l_project_value
,p_opp_value_currency_code => l_opp_value_currency_code
,p_expected_approval_date => l_expected_approval_date
,p_distribution_rule => l_distribution_rule);
if l_return_status != ’S’ then
raise api_error;
end if;
-----------------------
dbms_output.put_line(’Before Loading Extensible Attributes’);
pa_project_pub.load_extensible_attribute(
p_api_version_number => l_api_version_number,
x_return_status => l_return_status,
P_ATTR_GRP_ROW_INDEX => l_ATTR_GRP_ROW_INDEX,
P_ATTR_GRP_INTERNAL_NAME => l_ATTR_GRP_INTERNAL_NAME,
P_ATTR_INTERNAL_NAME => l_ATTR_INTERNAL_NAME,
P_ATTR_DISP_VALUE => l_ATTR_DISP_VALUE );
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------
--dbms_output.put_line(’Before load_structure’);
--LOAD_PROJECT
l_structure_type := ’FINANCIAL’;
pa_project_pub.load_structure(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => l_structure_type
);
if l_return_status != ’S’ then
raise api_error;
end if;
-----------------------

--LOAD_KEY_MEMBER (loop for multiple key members)
pa_project_pub.load_key_member(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_person_id => l_key_member_tbl(1).person_id
,p_project_role_type => l_key_member_tbl(1).project_role_type
);
IF l_return_status != ’S’ THEN
RAISE API_ERROR;
END IF;
-----------------------
--dbms_output.put_line(’bef load task’);
-----------------------

--LOAD_TASK (loop for multiple tasks)
FOR i IN 1..a LOOP
pa_project_pub.load_task(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_pm_task_reference => l_tasks_in(i).pm_task_reference
,p_task_name => l_tasks_in(i).task_name
,p_pm_parent_task_reference => l_tasks_in(i).pm_parent_task_reference
,p_task_start_date => l_tasks_in(i).task_start_date
,p_task_completion_date => l_tasks_in(i).task_completion_date
,p_actual_start_date => l_tasks_in(i).actual_start_date
,p_actual_finish_date => l_tasks_in(i).actual_finish_date
,p_early_start_date => l_tasks_in(i).early_start_date
,p_early_finish_date => l_tasks_in(i).early_finish_date
,p_late_start_date => l_tasks_in(i).late_start_date
,p_late_finish_date => l_tasks_in(i).late_finish_date
,p_address_id => l_tasks_in(i).address_id
);
IF l_return_status != ’S’ THEN
RAISE API_ERROR;
END IF;
END LOOP;
--dbms_output.put_line(’bef execute create project’);
-----------------------

--EXECUTE_CREATE_PROJECT
pa_project_pub.execute_create_project(
p_api_version_number => l_api_version_number
,p_commit => l_commit
,p_init_msg_list => ’T’
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_return_status => l_return_status
,p_workflow_started => l_work_flow_started
,p_pm_product_code => l_pm_product_code
,p_pa_project_id => l_project_id
,p_pa_project_number => l_pa_project_number
);
--dbms_output.put_line (’status ’||l_return_status || ’ msg count
’||l_msg_count);
IF l_return_status in( ’E’, ’U’ ) THEN
dbms_output.put_line( ’l_msg_data ’||l_msg_data );
dbms_output.put_line( ’Error count ’||l_msg_count );
l_msg_count := fnd_msg_pub.count_msg;
FOR l_counter IN REVERSE 1..l_msg_count LOOP
PA_UTILS.Get_Encoded_Msg(
p_index => l_counter
,p_msg_out => l_encoded_msg);
fnd_message.set_encoded(l_encoded_msg);
l_decoded_msg := fnd_message.get;
l_final_msg := l_final_msg || nvl(l_decoded_msg, l_encoded_msg);
dbms_output.put_line( ’ERROR MESSAGE CODE: ’|| l_counter|| ’ :
’||l_encoded_msg );
dbms_output.put_line( ’ERROR MESSAGE TEXT: ’|| l_counter|| ’ : ’||
l_final_msg );
END LOOP;
ELSE
dbms_output.put_line( ’l_return_status ’|| l_return_status|| ’ ’||l_msg_data
);
END IF;
IF l_return_status != ’S’ THEN
RAISE API_ERROR;
END IF;
dbms_output.put_line (’Project Id ’||l_project_id);
--dbms_output.put_line(’bef execute fetch task’);
-----------------------

--FETCH_TASK
FOR l_task_index in 1..a LOOP
pa_project_pub.fetch_task(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_task_index => l_task_index
,p_pa_task_id => l_task_id
,p_pm_task_reference => l_pm_task_reference
,p_task_return_status => l_task_return_status
);
IF l_return_status != ’S’ OR l_task_return_status != ’S’ THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
END IF;
END LOOP;
--dbms_output.put_line(’bef execute fetch str workplan’);
-----------------------
--FETCH_TASK
pa_project_pub.fetch_structure_version(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => ’WORKPLAN’
,p_pa_structure_version_id => l_task_version_id
,p_struc_return_status => l_task_return_status
);
IF l_return_status != ’S’ THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
ELSE
dbms_output.put_line (’ Workplan Str ver id ’||l_task_version_id );
END IF;
--dbms_output.put_line(’bef execute fetch str financial’);
pa_project_pub.fetch_structure_version(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => ’FINANCIAL’
,p_pa_structure_version_id => l_task_version_id
,p_struc_return_status => l_task_return_status);
IF l_return_status != ’S’ THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
ELSE
dbms_output.put_line (’ Financial Str ver id ’||l_task_version_id );
END IF;
-----------------------

--CLEAR_CREATE_PROJECT
pa_project_pub.clear_project;
IF l_return_status != ’S’ THEN
RAISE API_ERROR;
END IF;
-----------------------
--HANDLE EXCEPTIONS
--COMMIT;
DBMS_OUTPUT.put_line(’Time elapsed in secs :’ || (DBMS_UTILITY.get_time –
v_time_before)/(100));
EXCEPTION
WHEN API_ERROR THEN
dbms_output.put_line( ’In Exception’ );
for i in 1..l_msg_count loop
pa_interface_utils_pub.get_messages(
p_data => l_data
,p_msg_index => i
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_msg_index_out => l_msg_index_out
);
dbms_output.put_line (’error mesg ’||l_data);
end loop;
end create_project_EA;
end pa_ea_test;
/

LOAD_EXTENSIBLE_ATTRIBUTES APIの使用例

次のサンプル・スクリプトでは、LOAD_EXTENSIBLE_ATTRIBUTES APIを使用して、文字列属性と数値属性の両方を含む、3つの属性を持つ複数行属性グループをロードする方法を示します。

REM Using the LOAD_EXTENSIBLE_ATTRIBUTES bulk call
REM Instructions to run this file to create a prjoject and add tasks to
FINANCIAL str.
REM Change the following parameters
REM l_created_from_project_id
REM l_project_name
REM l_project_number
REM l_pm_project_reference
REM l_project_description
REM l_long_name
REM
REM --Set the number of tasks for every level (there are 6 levels)
REM number_of_tasks1 := 2;
REM number_of_tasks2 := 3;
REM number_of_tasks3 := 0;
REM number_of_tasks4 := 0;
REM number_of_tasks5 := 0;
REM number_of_tasks6 := 0;
set serveroutput on;
execute dbms_application_info.set_client_info(458);
execute fnd_global.apps_initialize(1179, 20432, 275);
execute dbms_application_info.set_client_info(458);
-- PL/SQL example on how to create a project using the LOAD/EXECUTE/FETCH
-- mechanism
DECLARE
--variables needed to create task hierarchy
level1 NUMBER;
level2 NUMBER;
level3 NUMBER;
a NUMBER := 0;
m NUMBER := 0;
parent_level1 VARCHAR2(30);
parent_level2 VARCHAR2(30);
parent_level3 VARCHAR2(30);
parent_level4 VARCHAR2(30);
parent_level5 VARCHAR2(30);
number_of_tasks1 NUMBER; -- number of tasks/level
number_of_tasks2 NUMBER;
number_of_tasks3 NUMBER;
number_of_tasks4 NUMBER;
number_of_tasks5 NUMBER;
number_of_tasks6 NUMBER;
temp_msg_data VARCHAR2(2000);
--variables needed for API standard parameters
l_api_version_number NUMBER :=1.0;
l_commit VARCHAR2(1):= ’F’;
l_return_status VARCHAR2(1);
l_init_msg_list VARCHAR2(1);
l_msg_data VARCHAR2(2000);
l_msg_entity VARCHAR2(100);
l_msg_entity_index NUMBER;
l_msg_index NUMBER;
l_encoded VARCHAR2(1);
l_work_flow_started VARCHAR2(1);
t1 varchar2(10);
t2 varchar2(100);
l_data varchar2(200);
t3 VARCHAR2(2000);
l_msg_count NUMBER;
l_msg_index_out NUMBER;

--variables needed for Oracle Project specific parameters
l_created_from_project_id NUMBER;
l_pm_product_code VARCHAR2(10);
l_number_of_task_levels NUMBER;
l_project_name VARCHAR2(30);
l_project_number VARCHAR2(80);
l_pm_project_reference VARCHAR2(25);
l_project_status_code VARCHAR2(30);
l_distribution_rule VARCHAR2(30);
l_public_sector_flag VARCHAR2(1);
l_carrying_out_organization_id NUMBER;
l_start_date DATE;
l_completion_date DATE;
l_actual_start_date DATE;
l_actual_finish_date DATE;
l_early_start_date DATE;
l_early_finish_date DATE;
l_late_start_date DATE;
l_late_finish_date DATE;
l_person_id NUMBER;
l_project_role_type VARCHAR2(20);
l_class_category VARCHAR2(30);
l_class_code VARCHAR2(30);
l_project_id NUMBER(15);
l_pa_project_number VARCHAR2(25);
l_project_description VARCHAR2(250);
l_customer_id NUMBER;
l_project_relationship_code VARCHAR2(30);
l_task_id NUMBER(15);
l_pm_task_reference VARCHAR2(25);
l_task_index NUMBER;
project_loop NUMBER;
l_tasks_in pa_project_pub.task_in_tbl_type;
l_task_rec pa_project_pub.task_in_rec_type;
l_ea_rec
pa_project_pub.PA_EXT_ATTR_ROW_TYPE;
l_key_member_rec
pa_project_pub.project_role_rec_type;
l_key_member_tbl
pa_project_pub.project_role_tbl_type;
l_task_return_status VARCHAR2(1);
l_short_name VARCHAR2(10);
l_role_list_id NUMBER;
l_work_type_id NUMBER;
l_calendar_id NUMBER;
l_location_id NUMBER;
l_probability_member_id NUMBER;
l_project_value NUMBER;
l_opp_value_currency_code VARCHAR2(15) := ’USD’;
l_expected_approval_date DATE;
API_ERROR EXCEPTION;
l_org_member_rec
pa_project_pub.project_role_rec_type;
l_org_member_tbl
pa_project_pub.project_role_tbl_type;
l_task_version_id NUMBER;
l_encoded_msg VARCHAR2(4000);
l_decoded_msg VARCHAR2(4000);
l_final_msg VARCHAR2(4000);
l_structure_type VARCHAR2(25);
l_structure_version_name VARCHAR2(25);
l_structure_version_id VARCHAR2(25);
l_structure_description VARCHAR2(150);
l_long_name VARCHAR2(80);
v_time_before NUMBER;

-- Extensible Attr variables;
l_row_identifier_arr pa_num_1000_num:= pa_num_1000_num();
l_attr_group_int_name pa_vc_1000_30 := pa_vc_1000_30();
l_attr_int_name pa_vc_1000_30 := pa_vc_1000_30();
l_attr_value_str pa_vc_1000_150 := pa_vc_1000_150();
l_attr_value_num pa_num_1000_num:= pa_num_1000_num();
l_attr_value_date pa_date_1000_date:= pa_date_1000_date();
BEGIN
v_time_before := DBMS_UTILITY.get_time;
PA_INTERFACE_UTILS_PUB.Set_Global_Info(
p_api_version_number => l_api_version_number
,p_responsibility_id => 20432
,p_user_id => 1179
,p_advanced_proj_sec_flag => ’Y’
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_return_status => l_return_status
);
dbms_application_info.set_client_info(458);
for project_loop in 1..1 loop

--PRODUCT RELATED DATA
l_pm_product_code :=’MSPROJECT’;

--PROJECT DATA
l_created_from_project_id := 13086;
l_project_name := ’zk0425_11’;
l_project_number := l_project_name;
l_pm_project_reference := l_project_name;
l_project_description := l_project_name;
l_long_name := ’Long name AMG project’ ||
l_project_name;
l_project_status_code := ’’;
l_carrying_out_organization_id :=244;
l_start_date :=’01-jan-94’;
l_completion_date :=’31-mar-15’;
l_actual_start_date :=’01-jan-94’;
l_actual_finish_date :=’01-apr-15’;
l_early_start_date :=’01-jan-94’;
l_early_finish_date :=’31-mar-15’;
l_late_start_date :=’01-jan-94’;
l_late_finish_date :=’31-mar-16’;
l_role_list_id :=1000 ;
l_work_type_id :=10020;
l_calendar_id :=550;
l_location_id :=1;
l_probability_member_id :=1005;
l_project_value :=1000;
l_expected_approval_date := ’31-mar-99’;

--KEY MEMBERS DATA
m:= 1;
l_person_id :=’56’;
l_project_role_type :=’PROJECT MANAGER’;
--CLASS CATEGORIES DATA
l_class_category :=’Product’;
l_class_code :=’Non-classified’;

--TASKS DATA
--Set the number of tasks for every level (there are 6 levels)
number_of_tasks1 := 2;
number_of_tasks2 := 1;
number_of_tasks3 := 0;
number_of_tasks4 := 0;
number_of_tasks5 := 0;
number_of_tasks6 := 0;
a := 0;
for level1 in 1..number_of_tasks1 loop
a:= a + 1;
l_task_rec.pm_task_reference :=a;
l_task_rec.task_name :=’TOP LEVEL ’||a;
l_task_rec.pm_parent_task_reference :=’’;
l_task_rec.actual_start_date := ’10-MAR-95’;
l_task_rec.actual_finish_date := ’06-JUL-10’;
l_task_rec.early_start_date := ’09-MAR-95’;
l_task_rec.early_finish_date := ’05-JUL-10’;
l_task_rec.late_start_date := ’09-MAR-95’;
l_task_rec.late_finish_date := ’05-JUL-10’;
l_task_rec.scheduled_start_date := ’01-jan-01’;
l_task_rec.scheduled_finish_date := ’31-dec-05’;
l_tasks_in(a):= l_task_rec;
parent_level1:= a;
FOR level2 IN 1..number_of_tasks2 LOOP
a:= a + 1;
l_task_rec.pm_task_reference :=a;
l_task_rec.task_name :=’2 LEVEL ’||a;
l_task_rec.scheduled_start_date := ’01-jan-02’;
l_task_rec.scheduled_finish_date := ’31-dec-07’;
l_task_rec.pm_parent_task_reference := parent_level1;
l_tasks_in(a) := l_task_rec;
parent_level2 := a;
for level3 IN 1..number_of_tasks3 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name :=’3 LEVEL ’||a;
l_task_rec.pm_parent_task_reference := parent_level2;
l_tasks_in(a) := l_task_rec;
parent_level3 := a;
for level4 IN 1..number_of_tasks4 loop
a := a + 1;
l_task_rec.pm_task_reference := a;
l_task_rec.task_name
:=’Fourth LEVEL ’||a;
l_task_rec.pm_parent_task_reference
:= parent_level3;
l_tasks_in(a) := l_task_rec;
for level5 IN 1..number_of_tasks5 loop
a := a + 1;
l_task_rec.pm_task_reference
:= a;
l_task_rec.task_name := ’Fifth LEVEL ’||a;
l_task_rec.pm_parent_task_reference :=
parent_level4;
l_tasks_in(a) := l_task_rec;
for level6 IN 1..number_of_tasks6 loop
a := a + 1;
l_task_rec.pm_task_reference
:= a;
l_task_rec.task_name := ’Sixth LEVEL
’||a;
l_task_rec.pm_parent_task_reference :=
parent_level5;
l_tasks_in(a) := l_task_rec;
end loop; --6th level
end loop; --5th level
end loop; --4th level
end loop; --3rd level
END LOOP; --2nd level
end loop; --1st level
-----------------------
dbms_output.put_line(’Total tasks processed. ’||l_tasks_in.count);
--can be used to exit this script and see how many tasks should have been
--created
-----------------------

--INIT_CREATE_PROJECT
pa_project_pub.init_project;
-----------------------
--dbms_output.put_line(’Before load_project’);

--LOAD_PROJECT
pa_project_pub.load_project( p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_created_from_project_id =>
l_created_from_project_id
,p_project_name => l_project_name
,p_long_name => l_long_name
,p_description => l_project_description
,p_pm_project_reference => l_pm_project_reference
,p_pa_project_number => l_project_number
,p_carrying_out_organization_id =>
l_carrying_out_organization_id
,p_public_sector_flag => l_public_sector_flag
,p_customer_id => l_customer_id
,p_project_status_code => l_project_status_code
,p_start_date => l_start_date
,p_completion_date => l_completion_date
,p_actual_start_date => l_actual_start_date
,p_actual_finish_date => l_actual_finish_date
,p_early_start_date => l_early_start_date
,p_early_finish_date => l_early_finish_date
,p_late_start_date => l_late_start_date
,p_late_finish_date => l_late_finish_date
,p_role_list_id => l_role_list_id
,p_work_type_id => l_work_type_id
,p_calendar_id => l_calendar_id
,p_location_id => l_location_id
,p_probability_member_id=>l_probability_member_id
,p_project_value => l_project_value
,p_opp_value_currency_code =>
l_opp_value_currency_code
,p_expected_approval_date=>l_expected_approval_date
,p_distribution_rule => l_distribution_rule);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------
--dbms_output.put_line(’Before load_structure’);
--LOAD_PROJECT
l_structure_type := ’FINANCIAL’;
pa_project_pub.load_structure( p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => l_structure_type
);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------

--LOAD_CLASS_CATEGORY (loop for mulitple class categories–This example has
-- only one )
FOR i IN 1..1 LOOP
pa_project_pub.load_class_category(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_class_category => l_class_category
,p_class_code => l_class_code );
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
dbms_output.put_line(’bef load task’);
-----------------------

--LOAD_TASK (loop for multiple tasks)
FOR i IN 1..a LOOP
pa_project_pub.load_task( p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_pm_task_reference =>
l_tasks_in(i).pm_task_reference
,p_task_name =>
l_tasks_in(i).task_name
,p_pm_parent_task_reference =>
l_tasks_in(i).pm_parent_task_reference
,p_task_start_date =>
l_tasks_in(i).task_start_date
,p_task_completion_date =>
l_tasks_in(i).task_completion_date
,p_actual_start_date =>
l_tasks_in(i).actual_start_date
,p_actual_finish_date =>
l_tasks_in(i).actual_finish_date
,p_early_start_date =>
l_tasks_in(i).early_start_date
,p_early_finish_date =>
l_tasks_in(i).early_finish_date
,p_late_start_date => l_tasks_in(i).late_start_date
,p_late_finish_date => l_tasks_in(i).late_finish_date
,p_scheduled_start_date => l_tasks_in(i).scheduled_start_date
,p_scheduled_finish_date => l_tasks_in(i).scheduled_finish_date
,p_address_id =>
l_tasks_in(i).address_id);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
END LOOP;
-----------------------
dbms_output.put_line(’bef load ext attr’);

--LOAD_EXTENSIBLE_ATTRIBUTE
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(1) := 1;
l_attr_group_int_name(1) := ’Application Weightings’;
l_attr_int_name(1) := ’Product Family’;
l_attr_value_str(1) := ’Financials’;
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(2) := 1;
l_attr_group_int_name(2) := ’Application Weightings’;
l_attr_int_name(2) := ’Application Module’;
l_attr_value_str(2) := ’Assets’;
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(3) := 1;
l_attr_group_int_name(3) := ’Application Weightings’;
l_attr_int_name(3) := ’Default Weighting’;
l_attr_value_num(3) := 0.6;
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(4) := 2;
l_attr_group_int_name(4) := ’Application Weightings’;
l_attr_int_name(4) := ’Product Family’;
l_attr_value_str(4) := ’Financials’;
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(5) := 2;
l_attr_group_int_name(5) := ’Application Weightings’;
l_attr_int_name(5) := ’Application Module’;
l_attr_value_str(5) := ’General Ledger’;
l_row_identifier_arr.extend;
l_attr_group_int_name.extend;
l_attr_int_name.extend;
l_attr_value_str.extend;
l_attr_value_num.extend;
l_attr_value_date.extend;
l_row_identifier_arr(6) := 2;
l_attr_group_int_name(6) := ’Application Weightings’;
l_attr_int_name(6) := ’Default Weighting’;
l_attr_value_num(6) := 0.4;
dbms_output.put_line(’bef load ext attr API CALL’);
pa_project_pub.load_extensible_attributes(
p_api_version_number => l_api_version_number
,x_return_status => l_return_status
,P_ATTR_GRP_ROW_INDEX => l_row_identifier_arr
,P_ATTR_GRP_INTERNAL_NAME=> l_attr_group_int_name
,P_ATTR_INTERNAL_NAME => l_attr_int_name
,P_ATTR_VALUE_STR => l_attr_value_str
,P_ATTR_VALUE_NUM => l_attr_value_num
,P_ATTR_VALUE_DATE => l_attr_value_date
);
dbms_output.put_line(’After load ext attr’);
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
--dbms_output.put_line(after load ext attr’);
-----------------------
--dbms_output.put_line(’bef execute create project’);
-----------------------

--EXECUTE_CREATE_PROJECT
pa_project_pub.execute_create_project(p_api_version_number =>
l_api_version_number
,p_commit => l_commit
,p_init_msg_list => ’F’
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_return_status => l_return_status
,p_workflow_started => l_work_flow_started
,p_pm_product_code => l_pm_product_code
,p_pa_project_id => l_project_id
,p_pa_project_number =>
l_pa_project_number
);
--dbms_output.put_line (’status ’||l_return_status || ’ msg count
’||l_msg_count);
IF l_return_status in( ’E’, ’U’ )
THEN
dbms_output.put_line( ’l_msg_data ’||l_msg_data );
dbms_output.put_line( ’Error count ’||l_msg_count );
l_msg_count := fnd_msg_pub.count_msg;
FOR l_counter IN REVERSE 1..l_msg_count LOOP
PA_UTILS.Get_Encoded_Msg(p_index => l_counter,
p_msg_out => l_encoded_msg);
fnd_message.set_encoded(l_encoded_msg);
l_decoded_msg := fnd_message.get;
l_final_msg := l_final_msg || nvl(l_decoded_msg, l_encoded_msg);
dbms_output.put_line( ’ERROR MESSAGE CODE: ’|| l_counter|| ’ :
’||l_encoded_msg );
dbms_output.put_line( ’ERROR MESSAGE TEXT: ’|| l_counter|| ’ : ’||
l_final_msg );
END LOOP;
ELSE
dbms_output.put_line( ’l_return_status ’|| l_return_status|| ’
’||l_msg_data );
END IF;
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
dbms_output.put_line (’Project Id ’||l_project_id);
--dbms_output.put_line(’bef execute fetch task’);
-----------------------

--FETCH_TASK
FOR l_task_index in 1..a LOOP
pa_project_pub.fetch_task( p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_task_index => l_task_index
,p_pa_task_id => l_task_id
,p_pm_task_reference => l_pm_task_reference
,p_task_return_status => l_task_return_status);
IF l_return_status != ’S’
OR l_task_return_status != ’S’
THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
END IF;
END LOOP;
--dbms_output.put_line(’bef execute fetch str workplan’);
-----------------------

--FETCH_TASK
pa_project_pub.fetch_structure_version(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => ’WORKPLAN’
,p_pa_structure_version_id => l_task_version_id
,p_struc_return_status =>
l_task_return_status);
IF l_return_status != ’S’
THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
ELSE
dbms_output.put_line (’ Workplan Str ver id ’||l_task_version_id );
END IF;
--dbms_output.put_line(’bef execute fetch str financial’);
pa_project_pub.fetch_structure_version(
p_api_version_number => l_api_version_number
,p_return_status => l_return_status
,p_structure_type => ’FINANCIAL’
,p_pa_structure_version_id => l_task_version_id
,p_struc_return_status =>
l_task_return_status);
IF l_return_status != ’S’
THEN
dbms_output.put_line (’error text ’|| SUBSTR (SQLERRM , 1 , 240));
RAISE API_ERROR;
ELSE
dbms_output.put_line (’ Financial Str ver id ’||l_task_version_id );
END IF;
-----------------------

--CLEAR_CREATE_PROJECT
pa_project_pub.clear_project;
IF l_return_status != ’S’
THEN
RAISE API_ERROR;
END IF;
-----------------------

--HANDLE EXCEPTIONS
end loop;
DBMS_OUTPUT.put_line (
’Time elapsed in secs :’ ||
(DBMS_UTILITY.get_time – v_time_before) / (100)
);
EXCEPTION
WHEN API_ERROR THEN
dbms_output.put_line( ’In Exception’||sqlerrm );
for i in 1..l_msg_count loop
pa_interface_utils_pub.get_messages (
p_encoded => FND_API.G_TRUE,
p_data => l_data
,p_msg_index => i
,p_msg_count => l_msg_count
,p_msg_data => l_msg_data
,p_msg_index_out => l_msg_index_out );
dbms_output.put_line (’error mesg :’||l_data);
end loop;
END ;
/

資源API

任意のシステムを使用して、労務資源と非労務資源の両方を追跡および編成できます。その後、資源APIを使用して、資源リストとそれに含まれる資源をOracle Projectsにエクスポートできます。それに応じて、Oracle Projectsで資源情報が更新されます。資源および資源リストの変更に伴って、システム内の情報を更新し、2つのシステムを定期的に同期化してください。

注意: 資源リスト識別子を必要とする資源APIを呼び出す場合は、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDパラメータを渡して資源リストを識別します。資源識別子を必要とする資源APIを呼び出す場合は、P_RESOURCE_ALIASまたはP_RESOURCE_LIST_MEMBER_IDパラメータを渡して資源を識別します。

資源APIのビュー

次の表に、資源APIのパラメータ・データを提供するビューを示します。ビューの詳細は、OracleMetaLinkで入手可能なOracle eTRMを参照してください。

資源APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_RESOURCE_PUB内にあります。

• 資源リストおよび資源リスト・メンバー・プロシージャ

  • ADD_RESOURCE_LIST_MEMBER

  • CREATE_RESOURCE_LIST

  • DELETE_RESOURCE_LIST

  • DELETE_RESOURCE_LIST_MEMBER

  • SORT_RESOURCE_LIST_MEMBERS

  • UPDATE_RESOURCE_LIST

  • UPDATE_RESOURCE_LIST_MEMBER

• ロード-実行-フェッチ・プロシージャ

  • CLEAR_CREATE_RESOURCE_LIST

  • CLEAR_UPDATE_MEMBERS

  • EXEC_CREATE_RESOURCE_LIST

  • EXEC_UPDATE_RESOURCE_LIST

  • FETCH_RESOURCE_LIST

  • FETCH_PLAN_FORMAT

  • FETCH_RESOURCE_LIST MEMBER

  • INIT_CREATE_RESOURCE_LIST

  • INIT_UPDATE_RESOURCE_LIST

  • LOAD_RESOURCE_LIST

  • LOAD_RESOURCE_FORMAT

  • LOAD_MEMBERS

  • LOAD_PLANNING_RESOURCE

資源APIのプロシージャの定義

この項では、資源APIについて、ビジネス・ルールおよびパラメータも含めて説明します。

ADD_RESOURCE_LIST_MEMBER

ADD_RESOURCE_LIST_MEMBERは、資源メンバーを既存の資源リストに追加するPL/SQLプロシージャです。

ビジネス・ルール

1. 呼出し元モジュールは、RESOURCE_LIST_NAMEまたはRESOURCE_LIST_IDを渡せます。

2. 呼出し元モジュールがRESOURCE_LIST_NAMEとRESOURCE_LIST_IDの両方を渡す場合、APIはRESOURCE_LIST_IDを使用します。

3. 資源リストがグループ化されている場合、有効な資源グループ別名を渡す必要があります。

4. P_RESOURCE_ATTR_VALUEの値は、P_RESOURCE_TYPEの値に対応する必要があります。たとえば、P_RESOURCE_TYPEがEMPLOYEEである場合、P_RESOURCE_ATTR_VALUEの個人識別コードが有効である必要があります。

   注意: Oracle Projectsにおける資源タイプの詳細は、『Oracle Projects基礎』の資源タイプに関する項を参照してください。

5. 呼出し元モジュールがRESOURCE_GROUPおよびRESOURCE_MEMBERパラメータに対してこのAPIに情報を渡す場合、APIはまず資源グループの存在を確認します。資源グループが存在しない場合、APIは資源グループを作成してから、資源を作成します。

6. 指定した資源メンバーがすでに存在する場合、このAPIはエラーを返しません。かわりに、成功の戻りステータスと、既存の資源メンバーのRESOURCE_LIST_MEMBER_IDを返します。

注意: 特定の資源に対して1つの取引属性のみを格納できるため、このAPIは単一のRESOURCE_ATTR_VALUE（PERSON_ID、JOB_IDなどを保持する可能性がある）のみを受け入れます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERS ION_NUMBER

• P_RESOURCE_ TYPE_CODE

• P_RESOURCE_ ATTR_VALUE

• P_RESOURCE_ ALIAS

CREATE_RESOURCE_LIST

CREATE_RESOURCE_LISTは、資源リストを作成し、オプションで資源リスト・メンバーを作成するPL/SQLプロシージャです。

このAPIは複合データ型を使用します。詳細は、「複合データ型を使用するAPI」を参照してください。

ビジネス・ルール

• P_GROUP_RESOURCE_TYPEの有効な値は、EXPENDITURE_CATEGORY、REVENUE_CATEGORY、ORGANIZATIONおよびNONEです。

• 資源リスト名は一意にする必要があります。

• 呼出し元プログラムがP_MEMBER_TBL（オプション）を渡す場合、このAPIは関連資源リスト・メンバー・レコードを作成します。

• 資源リストがグループ化されている場合、有効な資源グループ別名を渡す必要があります。

• P_RESOURCE_ATTR_VALUEの値は、P_RESOURCE_TYPEの値に対応する必要があります。たとえば、P_RESOURCE_TYPEがEMPLOYEEである場合、P_RESOURCE_ATTR_VALUEの個人識別コードが有効である必要があります。

• GROUP_RESOURCE_TYPEの値がNONEの場合、このAPIは資源グループINパラメータを無視します。

• 資源グループ別名を指定しない場合、グループ資源タイプはNONEにする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERS ION_NUMBER

• RESOURCE_L IST_NAME

• GROUP_ RESOURCE_TYPE

• RESOURCE_TYPE_CODE

• RESOURCE_ ATTR_VALUE

• RESOURCE_ALIAS

UPDATE_RESOURCE_LIST

UPDATE_RESOURCE_LISTは、既存の資源リストを更新するPL/SQLプロシージャです。既存の資源リスト・メンバーの更新、新規の資源リスト・メンバーの追加も行います。

このAPIは複合データ型を使用します。詳細は、「複合データ型を使用するAPI」を参照してください。

ビジネス・ルール

• 呼出し元モジュールは、RESOURCE_LIST_NAMEまたはRESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがRESOURCE_LIST_NAMEとRESOURCE_LIST_IDの両方を渡す場合、このAPIはRESOURCE_LIST_IDを使用します。

• 資源リストに有効なメンバーがすでに含まれている場合、GROUPED_BY_TYPEを変更することはできません。

• 次のフィールドはいつでも変更できます。

  • RESOURCE LIST NAME

  • DESCRIPTION

  • START DATE

  • END DATE

• 一意の新規資源リスト名を入力する必要があります。

• MEMBER_TBLにメンバー・レコードを含めることで、既存の資源リスト・メンバーの更新や、新規の資源リスト・メンバーの追加を行えます。資源リスト・メンバーがすでに存在する場合は、次のフィールドを更新できます。

  • ALIAS。P_NEW_ALIASを指定します。

  • SORT_ORDER。P_SORT_ORDERを指定します。

    注意: 別名は資源グループ内で一意にする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• RESOURCE_TYPE_CODE

• RESOURCE_ ATTR_VALUE

• RESOURCE_ALIAS

DELETE_RESOURCE_LIST

DELETE_RESOURCE_LISTは、指定した資源リストを削除するPL/SQLプロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDを使用します。

• 次の場合は、資源リストを削除できません。

  • その資源リスト別にプロジェクト実績を集計する。

  • 予算によってその資源リストが使用される。

  • リストに資源リスト・メンバーが含まれる。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

DELETE_RESOURCE_LIST_MEMBER

DELETE_RESOURCE_LIST_MEMBERは、指定した資源リスト・メンバーを削除するPL/SQLプロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。呼出し元モジュールは、P_ALIASまたはP_ALIAS_MEMBER_IDも渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDを使用します。

• 次の場合は、資源リスト・メンバーを削除できません。

  • その資源リスト・メンバー別にプロジェクト実績を集計する。

  • 予算によってその資源リスト・メンバーが使用される。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

SORT_RESOURCE_LIST_MEMBERS

SORT_RESOURCE_LIST_MEMBERSは、指定した資源リスト内で資源メンバーのソート順を更新するPL/SQLプロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDを使用します。

• 資源グループ別名を指定する場合、このAPIはその資源グループの下にある資源のみをソートします。それ以外の場合、このAPIは資源リスト内のすべての資源をソートします。

• 資源は別名または資源名別にソートできます。P_SORT_BY PARAMETERの有効な値は、ALIASおよびRESOURCE_NAMEです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_SORT_BY

UPDATE_RESOURCE_LIST_MEMBER

UPDATE_RESOURCE_LIST_MEMBERは、別名を更新し、資源リスト・メンバーを使用可能または使用不可にするPL/SQLプロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDを使用します。

• P_ENABLED_FLAGを使用して、資源メンバーを使用可能または使用不可にできます。パラメータ値がNULLまたはY以外の値として渡される場合、列の値は変わりません。

  注意: 別名は資源グループ内で一意にする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

CLEAR_CREATE_RESOURCE_LIST

CLEAR_CREATE_RESOURCE_LISTは、初期化ステップ中に設定されたグローバル・データ構造を消去するために使用するロード-実行-フェッチ・プロシージャです。このAPIプロシージャにはパラメータがありません。

CLEAR_UPDATE_MEMBERS

CLEAR_UPDATE_MEMBERSは、ロード-実行-フェッチ更新APIの初期化ステップ中に設定されたグローバル・データ構造を消去するために使用するロード-実行-フェッチ・プロシージャです。

EXEC_CREATE_RESOURCE_LIST

EXEC_CREATE_RESOURCE_LISTは、複合API CREATE_RESOURCE_LISTを実行するために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RETURN_STATUS

EXEC_UPDATE_RESOURCE_LIST

EXEC_UPDATE_RESOURCE_LISTは、複合API UPDATE_RESOURCE_LISTを実行するために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

FETCH_MEMBERS

FETCH_MEMBERSは、資源リスト・メンバーに対してグローバル出力構造から資源メンバーをフェッチするために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

FETCH_RESOURCE_LIST

FETCH_RESOURCE_LISTは、資源リストに対してグローバル出力構造から資源リスト識別子を1度に1つずつフェッチするために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

INIT_CREATE_RESOURCE_LIST

INIT_CREATE_RESOURCE_LISTは、他のロード-実行-フェッチ・プロシージャで使用されるグローバル・データ構造を設定するために使用するロード-実行-フェッチ・プロシージャです。

INIT_UPDATE_MEMBERS

INIT_UPDATE_MEMBERSは、他のロード-実行-フェッチ・プロシージャで使用されるグローバル・データ構造を設定するために使用するロード-実行-フェッチ・プロシージャです。

LOAD_MEMBERS

LOAD_MEMBERSは、資源リスト・メンバーのグローバル入力構造をロードするために使用するロード-実行-フェッチ・プロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、APIはP_RESOURCE_LIST_IDを使用します。

• 資源リストがグループ化されている場合、有効な資源グループ別名を渡す必要があります。

• P_RESOURCE_ATTR_VALUEの値は、P_RESOURCE_TYPEの値に対応する必要があります。たとえば、P_RESOURCE_TYPEがEMPLOYEEである場合、P_RESOURCE_ATTR_VALUEの個人識別コードが有効である必要があります。

  注意: Oracle Projectsにおける資源タイプの詳細は、『Oracle Projects基礎』の資源タイプに関する項を参照してください。

• 呼出し元モジュールが資源グループと資源メンバーの両方のパラメータに対してこのAPIに情報を渡す場合、APIはまず資源グループの存在を確認します。資源グループが存在しない場合、APIは資源グループを作成してから、資源を作成します。

• 指定した資源メンバーがすでに存在する場合、このAPIはエラーを返しません。かわりに、成功の戻りステータスと、既存の資源メンバーの資源リスト・メンバー識別コードを返します。

  注意: 特定の資源に対して1つの取引属性のみを格納できるため、このAPIは単一のRESOURCE_ATTR_VALUE（PERSON_ID、JOB_IDなどを保持する可能性がある）のみを受け入れます。

• P_ENABLED_FLAGを使用して、資源メンバーを使用可能または使用不可にできます。パラメータ値がNULLまたはY以外の値として渡される場合、列の値は変わりません。

  注意: 別名は資源グループ内で一意にする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

LOAD_RESOURCE_LIST

LOAD_RESOURCE_LISTは、資源リストのグローバル入力構造をロードするために使用するロード-実行-フェッチ・プロシージャです。

ビジネス・ルール

• P_GROUP_RESOURCE_TYPEの有効な値は、EXPENDITURE_CATEGORY、REVENUE_CATEGORY、ORGANIZATIONおよびNONEです。

• 資源リスト名は一意にする必要があります。

• 呼出し元プログラムがP_MEMBER_TBL（オプション）を渡す場合、このAPIは関連資源リスト・メンバー・レコードを作成します。

• 資源リストがグループ化されている場合、有効な資源グループ別名を渡す必要があります。

• P_RESOURCE_ATTR_VALUEの値は、P_RESOURCE_TYPEの値に対応する必要があります。たとえば、P_RESOURCE_TYPEがEMPLOYEEである場合、P_RESOURCE_ATTR_VALUEの個人識別コードが有効である必要があります。

• GROUP_RESOURCE_TYPEの値がNONEの場合、このAPIは資源グループINパラメータを無視します。

• 資源グループ別名を指定しない場合、グループ資源タイプはNONEにする必要があります。

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDのみを使用します。

• 資源リストに有効なメンバーがすでに含まれている場合、GROUPED_BY_TYPEを変更することはできません。

• 次のフィールドはいつでも変更できます。

  • RESOURCE_LIST_NAME

  • DESCRIPTION

  • START DATE

  • END DATE

• 既存の資源リスト・メンバーの更新や、新規の資源リスト・メンバーの追加を行うには、MEMBER_TBLにメンバー・レコードを含めます。資源リスト・メンバーがすでに存在する場合は、次のフィールドを更新できます。

  • ALIAS。P_NEW_ALIASを指定します。

  • SORT_ORDER。P_SORT_ORDERを指定します。

• P_ALIASの値は、メンバー・レコードをフェッチするキーとして使用できます。

  注意: 別名は資源グループ内で一意にする必要があります。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

計画資源リストAPI

この項では、計画資源リストとともに使用するAPIを説明します。

計画資源リストAPIのビュー

次の表に、計画資源リストAPIのパラメータ・データを提供するビューを示します。これらのビューで返される情報は、Oracle Projectsで計画資源に含めることができます。

ビューの詳細は、Oracle Metalinkで入手可能なOracle eTRMを参照してください。

計画資源リストAPIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_PLAN_RES_LIST_PUB内にあります。

• 計画資源リストおよび計画資源リスト・メンバー・プロシージャ

  • CREATE_RESOURCE_LIST

  • UPDATE_RESOURCE_LIST

  • DELETE_RESOURCE_LIST

  • DELETE_PLANNING_RESOURCE

  • DELETE_PLAN_RL_FORMAT

• ロード-実行-フェッチ・プロシージャ

  • EXEC_CREATE_RESOURCE_LIST

  • EXEC_UPDATE_RESOURCE_LIST

  • FETCH_RESOURCE_LIST

  • FETCH_PLAN_FORMAT

  • FETCH_RESOURCE_LIST_MEMBER

  • INIT_CREATE_RESOURCE_LIST

  • INIT_UPDATE_RESOURCE_LIST

  • LOAD_RESOURCE_LIST

  • LOAD_RESOURCE_FORMAT

  • LOAD_PLANNING_RESOURCE

計画資源リストAPIのレコードおよび表のデータ型

以降のページに、計画資源リストAPIで使用されるレコードおよび表のデータ型を定義します。

Plan_Res_List_IN_Recデータ型パラメータ

これは、計画資源リスト・レコード構造です。計画資源リストを作成するたびに、または既存の計画資源リストを更新するときに、計画資源リスト・レコードを渡す必要があります。デフォルト属性は、変更する必要がある場合のみ渡す必要があります。

Plan_Res_List_OUT_Recデータ型パラメータ

これは計画資源リスト・レコード構造で、新規作成された計画資源リストの資源リスト識別子をOUTパラメータとして格納します。資源書式および資源リスト・メンバーを作成する際、システムによってこの資源リスト識別子の値が渡されます。

Plan_RL_Format_In_Tblデータ型パラメータ

レコード・タイプPlan_RL_Format_In_Tblは、Plan_RL_Format_In_Recの表です。

Plan_RL_Format_In_Recデータ型パラメータ

これは計画資源リスト書式構造です。資源書式を作成する際に、計画資源リスト書式レコードを渡す必要があります。資源書式は更新中に追加または削除できます。次の表に、Plan_RL_Format_In_Recの属性を示します。

Plan_RL_Format_Out_Tblデータ型パラメータ

レコード・タイプPlan_RL_Format_Out_Tblは、Plan_RL_Format_Out_Recの表です。次の表に、Plan_RL_Format_Out_Recの属性を説明します。

Plan_RL_Format_Out_Recデータ型パラメータ

これは計画資源書式レコード構造で、新規資源リスト書式の資源リスト書式識別子をOUTパラメータとして格納します。

Planning_Resource_In_Tblデータ型パラメータ

レコード・タイプPlanning_Resource_In_Tblは、Planning_Resource_In_Recの表です。次の表に、Planning_Resource_In_Recの属性を説明します。

Planning_Resource_In_Recデータ型パラメータ

これは計画資源リスト・メンバー・レコード構造です。計画資源リストを作成または更新するたびに、資源リスト・メンバー・レコードを渡す必要があります。デフォルト属性は、変更または更新する必要がある場合のみ渡す必要があります。

Planning_Resource_Out_Tblデータ型パラメータ

レコード・タイプPlanning_Resource_Out_Tblは、Planning_Resource_Out_Recの表です。次の表に、Planning_Resource_Out_Recの属性を説明します。

Planning_Resource_Out_Recデータ型パラメータ

これは計画資源リスト・メンバー・レコード構造で、新規資源リスト・メンバーの資源リスト・メンバー識別子をOUTパラメータとして格納します。

計画資源リストAPIの定義

この項では、計画資源リストAPIについて、ビジネス・ルールおよびパラメータも含めて説明します。

CREATE_RESOURCE_LIST

CREATE_RESOURCE_LISTは、資源リスト、対応する資源書式、および資源リスト・メンバーを作成できるPL/SQLプロシージャです。

このAPIは複合データ型を使用します。詳細は、「複合データ型を使用するAPI」を参照してください。

ビジネス・ルール

• CREATE_RESOURCE_LISTは、資源リスト・パラメータを検証し、資源リストを作成します。

• システムによって資源リストが正常に作成されると、資源書式が作成され、CREATE_RESOURCE_LISTにパラメータとして渡されます。

• システムで資源リストに資源書式を追加できない場合、APIは失敗します。

• システムによって資源書式が正常に追加されると、計画資源が処理されます。計画資源の作成に失敗すると、APIは失敗します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで表示できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PLAN_RES_LIST_REC

• P_PLAN_RL_FORMAT_TBL

• P_PLANNING_RESOURCE_IN_TBL

UPDATE_RESOURCE_LIST

UPDATE_RESOURCE_LISTは、資源リスト、対応する資源書式、および計画資源を更新できるPL/SQLプロシージャです。資源書式は更新できないため、資源書式が作成されます。このプロシージャを使用すると、既存の計画資源の更新や、計画資源が存在しない場合には新規計画資源の作成も行えます。

このAPIは複合データ型を使用します。詳細は、「複合データ型を使用するAPI」を参照してください。

ビジネス・ルール

• 呼出し元モジュールは、RESOURCE_LIST_NAMEまたはRESOURCE_LIST_IDを渡せます。

• 呼出し元モジュールがRESOURCE_LIST_NAMEとRESOURCE_LIST_IDの両方を渡す場合、このAPIはRESOURCE_LIST_IDを使用します。

• 次のフィールドはいつでも変更できます。

  • RESOURCE LIST NAME

  • DESCRIPTION

  • START DATE

  • END DATE

• 一意の新規資源リスト名を入力する必要があります。

• 書式P_PLAN_RL_FORMAT_TBLを渡すことで、新規資源書式を計画資源リストに追加できます。

• P_PLANNING_RESOURCE_IN_RECで計画資源を渡すことで、既存の計画資源の更新や、新規計画資源の追加を行えます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PLAN_RES_LIST_REC

• X_PLAN_RES_LIST_REC

• P_PLAN_RL_FORMAT_TBL

• X_PLAN_RL_FORMAT_TBL

• P_PLANNING_RESOURCE_IN_TBL

• X_PLANNING_RESOURCE_OUT_TBL

• X_MSG_COUNT

• X_MSG_DATA

• X_RETURN_STATUS

DELETE_RESOURCE_LIST

DELETE_RESOURCE_LISTは、資源リストと、その資源リストに属する、対応する計画資源および資源書式を削除できるPL/SQLプロシージャです。

ビジネス・ルール

• 呼出し元モジュールは、P_RESOURCE_LIST_NAMEまたはP_RESOURCE_LIST_IDを渡せます。

• 計画資源リストが削除されると、その資源に属する資源書式および計画資源もすべて削除されます。

• 呼出し元モジュールがP_RESOURCE_LIST_NAMEとP_RESOURCE_LIST_IDの両方を渡す場合、このAPIはP_RESOURCE_LIST_IDを使用します。

• 財務計画または作業計画で参照されている計画資源リストは削除できません。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RES_LIST_ID

• X_MSG_COUNT

• X_MSG_DATA

• X_RETURN_STATUS

DELETE_PLANNING RESOURCE

DELETE_PLANNING_RESOURCEは、使用中でない計画資源を削除したり、使用中の計画資源を使用不可にできるPL/SQLプロシージャです。

ビジネス・ルール

呼出し元モジュールは、有効な資源リスト・メンバーIDを含む表を渡します。このプロシージャは、使用中でない各リスト・メンバーを削除したり、使用中の各リスト・メンバーを使用不可にします。リスト・メンバーIDが存在しない場合、プロシージャはエラー・メッセージを生成せず、「成功」の結果を返します。

パラメータ

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_RESOURCE_LIST_MEMBER_ID

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

DELETE_PLAN_RL_FORMAT

このプロシージャは、資源リストから1つ以上の資源書式を削除します。

ビジネス・ルール

呼出し元モジュールは、有効な資源書式IDの表と、それらが属する資源リストのIDを渡す必要があります。その書式の計画資源がリストに存在しない場合、APIは資源リストから各書式を削除します。計画資源が存在する場合、資源書式をリストから削除することはできません。

パラメータ

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_RES_LIST_ID

• P_PLAN_RL_FORMAT_TB

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

EXEC_CREATE_RESOURCE_LIST

EXEC_CREATE_RESOURCE_LISTは、複合API CREATE_RESOURCE_LISTを実行するために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

EXEC_UPDATE_RESOURCE_LIST

EXEC_UPDATE_RESOURCE_LISTは、複合API UPDATE_RESOURCE_LISTを実行するために使用するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

FETCH_RESOURCE_LIST

FETCH_RESOURCE_LISTは、資源リストに対してグローバル出力構造から資源リスト識別子を1度に1つずつフェッチするために使用するロード-実行-フェッチ・プロシージャです。これはステータスおよび新規のRESOURCE_LIST_ID（存在する場合）を返します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_RESOURCE_LIST_ID

• X_LIST_RETURN_STATUS

FETCH_PLAN_FORMAT

FETCH_PLAN_FORMATは、計画資源書式のステータスおよび新規のPLAN_RL_FORMAT_IDを返すロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_PLAN_RL_FORMAT_ID

• X_FORMAT_RETURN_STATUS

FETCH_RESOURCE_LIST_MEMBER

FETCH_RESOURCE_LIST_MEMBERは、資源リスト・メンバーのステータスおよび新規のRESOURCE_LIST_MEMBER_ID（存在する場合）を返すロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_RESOURCE_LIST_MEMBER_ID

• X_MEMBER_RETURN_STATUS

INIT_CREATE_RESOURCE_LIST

INIT_CREATE_RESOURCE_LISTは、資源書式および資源リスト・メンバーに対してグローバル一時表を設定するために使用するロード-実行-フェッチ・プロシージャです。また、資源リストのレコード構造を初期化します。このプロシージャにパラメータはありません。

INIT_UPDATE_RESOURCE_LIST

INIT_UPDATE_RESOURCE_LISTは、資源書式および資源リスト・メンバーに対してグローバル一時表を初期化するために使用するロード-実行-フェッチ・プロシージャです。これは資源リストのレコード構造も初期化します。このプロシージャにパラメータはありません。

LOAD_RESOURCE_LIST

LOAD_RESOURCE_LISTは、資源リストのグローバル・レコードに値をロードできるロード-実行-フェッチ・プロシージャです。

ビジネス・ルール

• 新規の計画資源リストを作成する場合、次のパラメータを渡す必要があります。

  • P_RESOURCE_LIST_NAME

  • P_START DATE

• 新規の計画資源リストを作成する場合、次のパラメータはオプションです。

  • P_DESCRIPTION

  • P_END_DATE

  • P_JOB_GROUP_ID

  • P_JOB_GROUP_NAME

  • P_USE_FOR_WP_FLAG

  • P_CONTROL_FLAG

• 計画資源リストを更新する場合、次のパラメータを更新できます。

  • P_RESOURCE_LIST_NAME

  • P_START_DATE

  • P_DESCRIPTION

  • P_END_DATE

  • P_JOB_GROUP_ID

  • P_JOB_GROUP_NAME

  • P_USE_FOR_WP_FLAG

  • P_CONTROL_FLAG

• 更新する必要がある資源を識別するには、P_RESOURCE_LIST_ID識別子を渡します。この識別子はPA_RESOURCE_LISTS_Vビューから取得できます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RESOURCE_LIST_NAME

• P_DESCRIPTION

• P_JOB_GROUP_ID

• X_RETURN_STATUS

LOAD_RESOURCE_FORMAT

資源書式のグローバル表に値をロードできます。このプロシージャは表を移入し、件数を増分します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

LOAD_PLANNING_RESOURCE

計画資源のグローバル表をロードできます。このプロシージャは表を移入し、件数を増分します。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RES_FORMAT_ID

• P_RECORD_VERSION_NUMBER

• P_PROJECT_ID

資源分解構造API

この項では、資源分解構造とともに使用するAPIを説明します。このAPIを使用すると、資源分解構造の作成、プロジェクトへの割当および更新を行えます。

資源分解構造APIのビュー

次の表に、資源分解構造APIのパラメータ・データを提供するビューを示します。これらのビューで返される情報は、Oracle Projectsで資源分解構造に含めることができます。

ビューの詳細は、OracleMetaLinkで入手可能なOracle eTRMを参照してください。

資源分解構造APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_RBS_PUB内にあります。

• 資源分解構造プロシージャ

  • CREATE_RBS

  • COPY_RBS_WORKING_VERSION

  • UPDATE_RBS

  • INIT_RBS_PROCESSING

  • LOAD_RBS_HEADER

  • LOAD_RBS_VERSION

  • LOAD_RBS_ELEMENTS

  • FETCH_RBS_HEADER

  • FETCH_RBS_VERSION

  • FETCH_RBS_ELEMENT

  • EXEC_CREATE_RBS

  • EXEC_UPDATE_RBS

  • FREEZE_RBS_VERSION

  • ASSIGN_RBS_TO_PROJECT

資源分解構造APIのレコードおよび表のデータ型

以降のページに、資源分解構造APIで使用されるレコードおよび表のデータ型を定義します。

Rbs_Header_Rec_Typデータ型パラメータ

これは資源分解構造のヘッダー・レコード構造です。資源分解構造ヘッダーを作成または更新する場合、資源分解構造を渡す必要があります。デフォルト属性は、変更する必要がある場合のみ渡します。

Rbs_Version_Rec_Typデータ型パラメータ

これは資源分解構造のバージョン・レコード構造です。資源分解構造を作成する際は、特定のバージョン属性が必要な場合のみ、バージョン・レコードを渡します。デフォルトでは、資源分解構造ヘッダーを作成するたびに、システムによって作業中バージョンが作成されます。資源分解構造を更新する際は、バージョン名や役職グループなどのバージョン属性を更新する場合のみ、バージョン・レコードを渡します。現行作業中バージョンのみ更新できます。バージョン属性は、PA_RBS_VERSIONS_AMG_Vビューから読み取ることができます。

Rbs_Elements_Tbl_Typデータ型パラメータ

レコード・タイプRbs_Elements_Tbl_Typは、Rbs_Elements_Rec_Typの表です。次の表に、Rbs_Elements_Rec_Typの属性を説明します。

Rbs_Elements_Rec_Typデータ型パラメータ

これは資源分解構造の要素レコード構造です。資源分解構造要素を作成または更新するたびに、要素レコード構造を渡します。デフォルト属性は、変更または更新する必要がある場合のみ渡します。

RESOURCE_SOURCE_ID

RESOURCE_SOURCE_IDパラメータには、資源分解構造要素を構成する資源識別子が移入されます。要素がルールの場合、システムによってRESOURCE_SOURCE_IDとして-1が渡されます。要素がインスタンスの場合、システムによって資源識別コードが渡されます。

次に、識別コードを持つ資源タイプを示します。

• BOM_LABOR: PA_BOM_LABOR_RES_VビューからBOM労務IDを取得します。

• BOM_EQUIPMENT: PA_BOM_EQUIPMENT_RES_VビューからBOM機材IDを取得します。

• NAMED_PERSON: PA_EMPLOYEES_RES_Vビューから個人IDを取得します。

• EVENT_TYPE: PA_EVENT_TYPES_RES_VビューからイベントIDを取得します。

• EXPENDITURE_CATEGORY: PA_EXPEND_CATEGORIES_RES_Vビューから支出カテゴリIDを取得します。

• EXPENDITURE_TYPE: PA_EXPENDITURE_TYPES_RES_Vビューから支出タイプIDを取得します。

• ITEM_CATEGORY: PA_ITEM_CATEGORY_RES_Vビューから品目カテゴリIDを取得します。

• INVENTORY_ITEM: PA_ITEMS_RES_Vビューから品目IDを取得します。

• JOB: PA_JOBS_RES_Vビューから役職IDを取得します。

• ORGANIZATION: PA_ORGANIZATIONS_RES_Vビューから組織IDを取得します。

• NON_LABOR_RESOURCE: PA_NON_LABOR_RESOURCES_RES_Vビューから非労務資源IDを取得します。

• RESOURCE_CLASS: PA_RESOURCE_CLASS_RES_Vから資源区分IDを取得します。

• ROLE: PA_PROJECT_ROLES_RES_Vビューからプロジェクト・ロールIDを取得します。

• SUPPLIER: PA_VENDORS_RES_Vビューから仕入先IDを取得します。

Rbs_Elements_Tbl_Out_Typデータ型パラメータ

レコード・タイプRbs_Elements_Tbl_Out_Typは、Rbs_Elements_Rec_Out_Typの表です。

Rbs_Elements_Rec_Out_Typデータ型パラメータ

これは、新規の資源分解構造要素の出力値を格納する資源分解構造の要素レコード構造です。次の表に、Rbs_Elements_Rec_Out_Typの属性を説明します。

資源分解構造APIのプロシージャの定義

この項では、資源分解構造APIについて、ビジネス・ルールおよびパラメータも含めて説明します。

CREATE_RBS

CREATE_RBSプロシージャを使用すると、RBSヘッダー、RBSバージョンおよびRBSの階層の要素で構成される資源分解構造（RBS）を作成できます。

ビジネス・ルール

• CREATE_RBSは資源分解構造を作成します。最低でも、CREATE_RBSは資源分解構造のヘッダーおよび作業中バージョンを作成します。

• バージョン・レコードが移入されない場合、CREATE_RBSはP_HEADER_RECパラメータに格納されたデータを使用してバージョン・レコードを作成します。

• バージョン情報が渡される場合、バージョン開始日は、ヘッダー・レコードの「有効日:自」以降にする必要があります。

• 階層の要素が渡される場合、CREATE_RBSは資源分解構造階層全体を作成することもできます。

• 資源分解構造バージョンの階層のルート要素は、バージョン自体です。バージョンは更新可能要素ではありません。ユーザーが代替要素を指定しても、システムではすべて無視されます。

• 資源分解構造階層の要素ごとに、次の情報を渡す必要があります。

  • RBS_LEVEL

  • PROCESS_TYPE

  • PARENT_RES_ELEMENT_ID

  • RESOURCE_TYPE_ID

  • RESOURCE_SOURCE_IDまたはRESOURCE_SOURCE_CODE

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_HEADER_REC

• X_RBS_HEADER_ID

• X_RBS_VERSION_ID

• X_ELEMENTS_TBL

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

COPY_RBS_WORKING_VERSION

このプロシージャを使用すると、既存の確定済バージョンから資源分解構造の作業中バージョンを作成できます。

ビジネス・ルール

1. 呼出し元モジュールは、次のいずれかを渡す必要があります。

   • 資源分解構造ヘッダー（名称またはID）および確定済資源分解構造バージョンのバージョン番号

   • 確定済資源分解構造バージョンのバージョンID

   この情報によって現行作業中バージョンとしてコピーされるバージョンが指定されます。既存の作業中バージョンは、指定された確定済バージョンのコピーで上書きされます。

2. 現行作業中バージョンのレコード・バージョン番号は、ロック目的でも必要になります。

パラメータ

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_REC_VERSION_NUMBER

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

UPDATE_RBS

UPDATE_RBSプロシージャを使用すると、資源分解構造ヘッダーおよびバージョンの更新や、要素レコードの削除、更新または追加を行えます。

ビジネス・ルール

• UPDATE_RBSを使用すると、資源分解構造バージョン、ヘッダーまたは要素を個別に、またはそれぞれを組み合せて更新できます。

• P_HEADER_REC、P_VERSION_RECおよびP_ELEMENTS_TBLがNULLの場合は、何も更新されません。

• 存在しない資源分解構造に対してUPDATE_RBSが呼び出された場合は、「**** データが見つかりません ****」というエラー・メッセージを返して停止します。

• P_ELEMENTS_TBLが移入された場合、データはPROCESS_TYPE 'D'、'U'、'A'の順に処理されます。

• UPDATE_RBSのルート・ノードまたは要素レコードは、システム生成のため削除できません。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_HEADER_REC

• P_VERSION_REC

• P_ELEMENTS_TBL

• X_ELEMENTS_TBL

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

INIT_RBS_PROCESSING

INIT_RBS_PROCESSINGは、資源分解構造を作成および更新するためのグローバル一時表を初期化するロード-実行-フェッチ・プロシージャです。

LOAD_RBS_HEADER

LOAD_RBS_HEADERは、資源分解構造のグローバルPL/SQLレコードにヘッダー・レコード情報をロードするロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_NAME

• P_EFFECTIVE_START_DATE

• X_RETURN_STATUS

LOAD_RBS_VERSION

LOAD_RBS_VERSIONは、グローバルPL/SQLレコードにバージョン・レコード情報をロードするロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_NAME

• P_VERSION_START_DATE

• X_RETURN_STATUS

LOAD_RBS_ELEMENTS

LOAD_RBS_ELEMENTSは、グローバルPL/SQL表に要素レコード情報をロードするロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PARENT_ELEMENT_ID

• P_RESOURCE_TYPE_ID

• P_PROCESS_TYPE

• X_RETURN_STATUS

FETCH_RBS_HEADER

FETCH_RBS_HEADERは、RBS_HEADER_IDを取得し、ヘッダーの成功またはエラー・ステータスを呼出し元プロシージャに返すロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RBS_HEADER_ID

• X_RETURN_STATUS

FETCH_RBS_VERSION

FETCH_RBS_VERSIONは、RBS_VERSION_IDおよびバージョン成功ステータスを取得するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RBS_VERSION_ID

• X_RBS_VER_RETURN_STATUS

• X_RETURN_STATUS

FETCH_RBS_ELEMENT

FETCH_RBS_ELEMENTは、RBS_ELEMENT_IDおよび入力した指数値の成功値を取得するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RBS_ELEMENT_INDEX

• X_RBS_ELEMENT_ID

• X_RETURN_STATUS

EXEC_CREATE_RBS

EXEC_CREATE_RBSは、資源分解構造作成プロセスを実行するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

EXEC_UPDATE_RBS

EXEC_UPDATE_RBSは、資源分解構造更新プロセスを実行するロード-実行-フェッチ・プロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

FREEZE_RBS_VERSION

FREEZE_RBS_VERSIONは、現行作業中資源分解構造バージョンを確定し、新規作業中バージョンを作成できるプロセスです。

ビジネス・ルール

• 作業中資源分解構造バージョンを確定するには、次のパラメータのうち1つ以上を渡す必要があります。

  • RBS_VERSION_ID

  • RBS_HEADER_ID

  • RBS_HEADER_NAME

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_RBS_VERSION_ID

• P_RBS_VERSION_RECORD_VER_NUM

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

ASSIGN_RBS_TO_PROJECT

ASSIGN_RBS_TO_PROJECTは、資源分解構造をプロジェクトに割り当てるプロセスです。資源分解構造のヘッダーIDとプロジェクトIDを指定する必要があります。

ビジネス・ルール

• 資源分解構造および資源分解構造の割当先プロジェクトを指定する必要があります。

• プロジェクト情報を渡すには、次のいずれかを渡します。

  • P_PROJECT_IDフィールドのプロジェクト識別子

  • P_PROJECT_REFERENCEフィールドのプロジェクト参照

• 資源分解構造情報を渡すには、次のいずれかを渡します。

  • P_RBS_HEADER_IDフィールドの資源分解構造ヘッダー識別子

  • P_RBS_HEADER_NAMEフィールドの資源分解構造ヘッダー名

• 資源分解構造は、プロジェクト・レポートまたはプログラム・レポート（あるいはその両方）の目的で割り当てることができます。

• 資源分解構造をプロジェクトの主報告資源分解構造にするかどうかを指定することもできます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_API_VERSION_NUMBER

• P_PROJECT_ID

• P_RBS_HEADER_ID

• X_RETURN_STATUS

• X_MSG_COUNT

• X_ERROR_MSG_DATA

依存関係API

依存関係APIのビュー

依存関係APIのパラメータ・データを提供するビューを次に示します。ビューの詳細は、OracleMetaLinkで入手可能なOracle eTRMを参照してください。

依存関係APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_PROJECT_PUB内にあります。

• CREATE_DEPENDENCY

• UPDATE_DEPENDENCY

• DELETE_DEPENDENCY

依存関係APIのプロシージャの定義

この項では、依存関係APIを説明します。

CREATE_DEPENDENCY

CREATE_DEPENDENCYは、プロジェクト内の依存関係を作成するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_MSG_COUNT

• P_MSG_DATA

• P_RETURN_STATUS

• P_PM_PRODUCT_CODE

• P_PM_PROJECT_REFERENCE

• P_PA_PROJECT_ID

• P_STRUCTURE_VERSION_ID

• P_PM_TASK_REFERENCE

• P_PA_TASK_ID

• P_PM_PRED_REFERENCE

• P_PA_PRED_ID

UPDATE_DEPENDENCY

UPDATE_DEPENDENCYは、既存のプロジェクト内の依存関係を更新するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_MSG_COUNT

• P_MSG_DATA

• P_RETURN_STATUS

• P_PM_PRODUCT_CODE

• P_PM_PROJECT_REFERENCE

• P_PA_PROJECT_ID

• P_STRUCTURE_VERSION_ID

• P_PA_TASK_ID

• P_PA_PRED_ID

• P_PM_TASK_REFERENCE

• P_PM_PRED_REFERENCE

• P_PA_TASK_ID

• P_PA_PRED_ID

DELETE_DEPENDENCY

DELETE_DEPENDENCYは、既存のプロジェクト内の依存関係を削除するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_MSG_COUNT

• P_MSG_DATA

• P_RETURN_STATUS

• P_PM_PRODUCT_CODE

• P_PM_PROJECT_REFERENCE

• P_PA_PROJECT_ID

• P_STRUCTURE_VERSION_ID

• P_PM_TASK_REFERENCE

• P_PA_TASK_ID

• P_PM_PRED_REFERENCE

• P_PA_PRED_ID

タスク割当API

タスク割当APIは、タスク割当および定期データを挿入、更新および削除するための外部システム用インタフェースを提供します。

タスク割当ビュー

タスク割当APIのパラメータ・データを提供するビューを次に示します。ビューの詳細は、OracleMetaLinkで入手可能なOracle eTRMを参照してください。

タスク割当APIのプロシージャ

この項で説明するプロシージャを次に示します。これらのプロシージャは、パブリックAPIパッケージPA_TASK_ASSIGNMENTS_PUB内にあります。

• LOAD_TASK_ASSIGNMENTS

• LOAD_TASK_ASGMT_PERIODS

• EXECUTE_CREATE_TASK_ASGMTS

• EXECUTE_UPDATE_TASK_ASGMTS

• CREATE_TASK_ASSIGNMENTS

• CREATE_TASK_ASSIGNMENT_PERIODS

• UPDATE_TASK_ASSIGNMENTS

• DELETE_TASK_ASSIGNMENTS

• UPDATE_TASK_ASSIGNMENT_PERIODS

• FETCH_TASK_ASSIGNMENTS

• CONVERT_PM_TAREF_TO_ID

• INIT_TASK_ASSIGNMENTS

タスク割当APIのレコードおよび表のデータ型

以降のページに、タスク割当APIで使用されるレコードおよび表のデータ型を定義します。

ASSIGNMENT_IN_REC_TYPE

次の表に、ASSIGNMENT_IN_REC_TYPEデータ型を示します。

ASSIGNMENT_OUT_REC_TYPE

次の表に、ASSIGNMENT_OUT_REC_TYPEデータ型を示します。

TASK_DEL_REC_TYPE

次の表に、TASK_DEL_REC_TYPEデータ型を示します。

TASK_ASGMT_DEL_TYPE

次の表に、TASK_ASGMT_DEL_TYPEデータ型を示します。

ASSIGNMENT_PERIODS_TYPE

次の表に、ASSIGNMENTS_PERIODS_TYPEデータ型を示します。

タスク割当APIのプロシージャの定義

この項では、タスク割当APIについて、ビジネス・ルールおよびパラメータも含めて説明します。

LOAD_TASK_ASSIGNMENTS

LOAD_TASK_ASSIGNMENTSは、クライアント側からサーバー側のPLSQL表にタスク割当を移動するPL/SQLプロシージャです。このプロシージャは、LOAD/EXECUTE/FETCHサイクルで使用されます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

LOAD_TASK_ASSIGNMENT_PERIODS

LOAD_TASK_ASSIGNMENT_PERIODSは、クライアント側からサーバー側のPLSQL表にタスク割当の定期データを移動するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

EXECUTE_CREATE_TASK_ASGMTS

EXECUTE_CREATE_TASK_ASGMTSは、PLSQL表のデータを使用してタスク割当を作成するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

EXECUTE_UPDATE_TASK_ASGMTS

EXECUTE_UPDATE_TASK_ASGMTSは、タスク割当を更新するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

CREATE_TASK_ASSIGNMENTS

CREATE_TASK_ASSIGNMENTSは、割当レコードの表を受け入れることでタスク割当を作成するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_TASK_ASSIGNMENTS_IN

• P_TASK_ASSIGNMENTS_OUT

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

CREATE_TASK_ASSIGNMENT_PERIODS

CREATE_TASK_ASSIGNMENT_PERIODSは、割当レコードの表と定期データの表を受け入れることでタスク割当と定期データを作成するPL/SQLプロシージャです。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_TASK_ASSIGNMENTS_IN

• P_TASK_ASSIGNMENTS_OUT

• P_TASK_ASSIGNMENT_PERIODS_IN

• P_TASK_ASSIGNMENT_PERIODS_OUT

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA

UPDATE_TASK_ASSIGNMENTS

UPDATE_TASK_ASSIGNMENTSは、タスク割当を更新するPL/SQLプロシージャです。このAPIを使用すると、ユーザーは作業計画バージョンをロックせずにタスクの資源割当を更新できます。また、複数のユーザーがタスクの資源割当を更新できます。

このプロシージャのすべてのパラメータの説明は、Oracle Integration Repositoryで参照できます。Oracle Integration Repositoryは、このマニュアルの「はじめに」で説明されています。

このプロシージャの必須パラメータは次のとおりです。

• P_TASK_ASSIGNMENTS_IN

• P_TASK_ASSIGNMENTS_OUT

• X_RETURN_STATUS

• X_MSG_COUNT

• X_MSG_DATA