インセンティブ報酬参加者バージョン2

論理ビジネス・オブジェクト

IC : インセンティブ報酬 : インセンティブ報酬参加者

関係

次の表では、このサービス・データ・オブジェクトが他のサービス・データ・オブジェクトまたはビジネス・オブジェクト・サービスとどのように関連しているかについて説明します。

関係タイプ	オブジェクトまたはサービス
Handles	インセンティブ報酬参加者詳細フレックスフィールドSDO
Handles	インセンティブ報酬参加者プランSDO
Handles	インセンティブ報酬参加者プラン・ターゲットSDO
Handles	インセンティブ報酬終了参加者SDO
Handles	インセンティブ報酬参加者詳細SDO
Handles	インセンティブ報酬参加者ロールSDO
Handles	インセンティブ報酬参加者プラン追加属性SDO
Handles	インセンティブ報酬参加者プラン検索SDO

holdParticipantPayment

参加者の(ヘッダー)支払保留をYに設定して、参加者を支払プロセスから除外します。このメソッドには、最初の3つのパラメータの1つが必要です。不明な値またはnull値には0を渡してください。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
personId	string	個人の一意の識別子
partyId	long	パーティの一意識別子
participantId	long	関係者の一意識別子
orgId	long	ビジネス・ユニットの一意識別子
holdReason	string	支払保留の事由

応答ペイロード

要素名	タイプ	摘要
result	int	支払を保留する参加者数

terminateParticipant

参加者の終了日。支払プロセスでは、最初に報酬終了日が参照されます。この値がNullの場合は、アクティブな終了日が使用されます。支払シートには、参加者の終了日後に処理された支払は含まれません。このメソッドには、最初の3つのパラメータのいずれかが必要です。不明な値またはnull値の場合は0を渡してください。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
personId	string	個人の一意の識別子
partyId	long	パーティの一意識別子
participantId	long	関係者の一意識別子
orgId	long	ビジネス・ユニットの一意識別子
activeEndDate	{http://xmlns.oracle.com/adf/svc/types/}date-Date	日付の書式はYYYY-MM-DDです
compensationEndDate	{http://xmlns.oracle.com/adf/svc/types/}date-Date	日付の書式はYYYY-MM-DDです

応答ペイロード

要素名	タイプ	摘要
result	int	失効した関係者のリスト

assignCOMPRoleToParticipant

報酬ロールを関係者に割り当てます。ロールが報酬プラン、支払プランまたは支払グループに割り当てられている場合は、ロールを介してこれらのエンティティに関係者を割り当てます。このメソッドには、最初の3つのパラメータのいずれかが必要です。不明な値またはnull値の場合は0を渡してください。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
personId	string	個人の一意の識別子
partyId	long	パーティの一意識別子
participantId	long	関係者の一意識別子
orgId	long	ビジネス・ユニットの一意識別子
roleId	long	ロールの一意識別子
assignmentStartDate	{http://xmlns.oracle.com/adf/svc/types/}date-Date	日付の書式はYYYY-MM-DDです
assignmentEndDate	{http://xmlns.oracle.com/adf/svc/types/}date-Date	日付の書式はYYYY-MM-DDです

応答ペイロード

要素名	タイプ	摘要
result	int	指定された参加者に対して作成された報酬ロール割当レコードの数。

processParticipantTargetIncentive

報酬プランの減額になるように、参加者のターゲット・インセンティブ金額を変更します。ビジネス・ユニット名、参加者名、プラン名およびターゲット・インセンティブ金額は必須です。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
participantTargetIncentive	インセンティブ報酬参加者プラン・ターゲットSDO	参加者ターゲット・インセンティブのサービス・データ・オブジェクトの入力リスト

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬参加者プラン・ターゲットSDO	変更された参加者ターゲット・インセンティブのサービス・リスト・データ・オブジェクトを返します

automaticTerminateParticipant

このプロセスでは、システム・パラメータに関して、参加者報酬プランおよび支払プランを終了するとともに、参加者も自動的に終了します。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
terminateParticipant	インセンティブ報酬終了参加者	自動終了参加者のサービス・データ・オブジェクトの入力リスト。

応答ペイロード

要素名	タイプ	摘要
result	string	自動参加者の終了機能にエラー(ある場合)のリストを返します。

assignRoleToParticipant

関係者へのロールの割当

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
participantRole	インセンティブ報酬参加者ロールSDO	関係者ロール割当の入力サービス・データ・オブジェクト

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬参加者ロールSDO	割り当てられた参加者ロールの出力サービス・データ・オブジェクト

mergeParticipantDetail

新しい関係者詳細レコードをマージします。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
participantDetail	インセンティブ報酬参加者詳細	参加者詳細の入力サービス・データ・オブジェクト

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬参加者詳細	マージされた参加者詳細のサービス・データ・オブジェクトを返します

terminateActiveParticipant

アクティブな参加者の終了。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
terminateParticipant	インセンティブ報酬終了参加者	関係者の終了のサービス・データ・オブジェクトの入力

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬終了参加者	終了した参加者のサービス・データ・オブジェクトを返します

findParticipantPlan

関係者報酬プランの検索に使用される操作。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	参加者プランを検索する基準
BusinessUnitName	string	ビジネス・ユニット名
PlanName	string	報酬プラン名
ParticipantName	string	関係者名
PartyNumber	string	パーティ番号
PartyId	long	パーティ識別子
ParticipantEmail	string	参加者Eメール・アドレス
PersonNumber	string	個人番号
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	レスポンスのすべての翻訳を取得する共通データ・オブジェクト

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬参加者プラン検索SDO	基準に一致する参加者プランのリスト

updateParticipantPlan

参加者コンポーネント・プラン詳細の更新に使用する操作。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
srpCompensationPlanDetail	インセンティブ報酬参加者プランSDO	参加者プランを更新するためのサービス・データ・オブジェクト。

応答ペイロード

要素名	タイプ	摘要
result	インセンティブ報酬参加者プランSDO	更新された参加者プランを返します

getDfltObjAttrHints

サービス・データ・オブジェクトのラベルやオブジェクト属性のラベルなど、指定されたサービス・データ・オブジェクトとロケールに対応するユーザー・インタフェース・ヒントを取得する操作です。前提条件として、このサービスに対して定義されたgetEntityList操作を呼び出して、viewName要求ペイロード要素に使用可能な値のリストを取得します。

ライフ・サイクル・ステータス: Active

要求ペイロード

要素名	タイプ	摘要
viewName	string	サービス・データ・オブジェクトの内部名である、サービス・ビュー使用名。 getEntityList操作の応答ペイロード内の<name>要素の値を指定します。
localeName	string	ロケールベースのユーザー・インタフェース・ヒントを評価する際に使用するロケール。 localeNameはISO 639-1形式です。

応答ペイロード

要素名	タイプ	摘要
result	{http://xmlns.oracle.com/adf/svc/types/}ObjAttrHints	指定したサービス・データ・オブジェクトのラベルおよびユーザー・インタフェース・ヒントと、名前と値のペア形式でのその属性

getServiceLastUpdateTime

サービス定義で参照されるスキーマ・ファイルが最後に変更された日時を返す操作です。

ライフ・サイクル・ステータス: Active

要求ペイロード

応答ペイロード

要素名	タイプ	摘要
result	{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp	ISO 8601形式による、サービス定義が最後に変更された日時。

getEntityList

このサービスに対して定義されているサービス・データ・オブジェクトのリストを取得する操作です。

ライフ・サイクル・ステータス: Active

要求ペイロード

応答ペイロード

要素名	タイプ	摘要
result	{http://xmlns.oracle.com/adf/svc/types/}ServiceViewInfo	このサービスに対して定義されているサービス・データ・オブジェクトのリスト。それぞれのサービス・データ・オブジェクトについて、QName、内部名、およびcreate、update、merge、deleteの各操作をそのオブジェクトに対して実行できるかどうかを示すブール値が結果に含まれます。

セキュリティ

次の表に、サービス操作の実行に必要な権限と、各権限の付与先の職務ロールを示します。

サービス操作から権限へのマッピング

工程名	権限コード	権限名	権限の説明
すべての操作	CN_MAINTAIN_INCENTIVE_COMPENSATION_PARTICIPANT_DETAIL_PRIV	インセンティブ報酬参加者詳細の保守	インセンティブ報酬アプリケーションがクレジット、達成、支給、係争および支払を計算および管理する個人または組織のインセンティブ報酬詳細を管理する、アナリストへの参加者の割当を許可します。個人または組織には、従業員、営業担当、パーティ、サプライヤ契約、パートナまたはサード・パーティの再販契約者を指定できます。

権限と職務ロールのマッピング

権限コード	付与先職務ロール・コード	付与先職務ロール名	付与先職務ロール摘要
CN_MAINTAIN_INCENTIVE_COMPENSATION_PARTICIPANT_DETAIL_PRIV	ORA_CN_INCENTIVE_COMPENSATION_PARTICIPANT_PLAN_MANAGEMENT_DUTY	インセンティブ報酬参加者スナップショット管理	参加者のインセンティブ・プランおよびトランザクションの割当と保守