1. HCM共通機能の使用
  2. エレメント入力検証Formulaタイプ

エレメント入力検証Formulaタイプ

エレメント入力検証Formulaを使用して、1つ以上のエレメント・エントリ値を検証できます。このFormulaタイプを使用して、エレメント・エントリ値のデフォルト値を指定することもできます。

さらに、他のエントリ値のユーザーのエントリに基づいてエントリ値を計算することもできます。

次のフィールドの「エレメント要約」ページで、Formulaを選択します。

ページ・セクション

フィールド

目的

Formulaが実行されるタイミング

「エレメント詳細」または「エレメント適格」

検証Formula

他のエントリ値の入力に基づいて、エレメントの1つ以上のエントリ値を検証します。

エレメント・エントリを保存するとき。

「エレメント詳細」または「エレメント適格」

計算Formula

これらのエントリ値または他のエントリ値から入力を受け取る計算Formulaを使用して、1つ以上のエントリ値の値を指定します。

エレメント・エントリを保存するとき。

「エレメント詳細」または「エレメント適格」

デフォルトFormula

1つ以上のエントリ値のデフォルト値を指定します。

エレメント・エントリを作成するとき。

入力値

検証Formula

1つのエントリ値を他のエントリ値とは別に検証します。

値を入力するとき。
ノート: エレメント適格レベルのFormulaは、常にエレメント・レベルの同等のFormulaを上書きします。

このタイプのすべてのFormulaで使用できるコンテキストは次のとおりです。

  • LEGISLATIVE_DATA_GROUP_ID

  • DATE_EARNED

  • EFFECTIVE_DATE

次のコンテキストは、エレメントまたはエレメント適格レベルのFormulaでのみ使用できます。入力パラメータ・レベルの検証Formulaでは使用できません。

  • PERSON_ID

  • PAYROLL_RELATIONSHIP_ID

  • PAYROLL_TERM_ID

  • PAYROLL_ASSIGNMENT_ID

  • HR_RELATIONSHIP_ID

  • HR_TERM_ID

  • HR_ASSIGNMENT_ID

このタイプのFormulaで使用できる入力変数を次に示します。

Formulaの使用

入力変数

コメント

入力パラメータ・レベルの検証Formula

entry_value

検証する値を渡します。入力変数をエレメント入力パラメータの適切なタイプとして宣言する必要があります。

エレメントまたはエレメント適格レベルの検証Formula

入力値に対応する任意のエレメント入力パラメータ名。

入力パラメータ名のスペースは、入力変数名ではアンダースコアに置き換えます。

名前に大文字または小文字のどちらを使用してもかまいません。

デフォルトFormula

なし

かわりにデータベース・アイテムまたは他のロジックを使用します。

計算Formula

入力値の任意のエレメント入力パラメータ名。

スペースをアンダースコアに置き換えます。

使用可能なエントリ値をすべて指定する必要はありません。

このタイプのFormulaで使用できる戻り値は次のとおりです。

Formulaの使用

戻り値

コメント

任意のレベルの検証Formula。

formula_status

'S' (成功)または'E' (エラー)のいずれかである必要があります。必須です。

任意のレベルの検証Formula。

formula_message

検証が失敗すると、メッセージのテキストがユーザーに渡されます。オプションです。

デフォルトFormula

入力値の任意のエレメント入力パラメータ名。

戻り値によって、エレメントまたはエレメント適格レコードの入力パラメータで指定された任意のデフォルト値が上書きされます。

計算Formula

入力値の任意のエレメント入力パラメータ名。

使用可能なすべてのエントリ値を返す必要はありません。入力変数または他のエントリ値として渡されたエントリ値を戻すことができます。

使用できるサンプルFormulaを次に示します。

  • 入力パラメータ・レベルの検証Formula

  • エレメントまたはエレメント適格レベルの検証Formula

  • エレメントまたはエレメント適格レベルの計算Formula

  • エレメントまたはエレメント適格レベルのデフォルトFormula

入力パラメータ・レベルの検証Formula:

inputs are entry_value(date)
if(entry_value = '01-APR-2008' (date)) then
(
formula_message = 'Valid date'
formula_status = 'S'
)
else(formula_message = 'Invalid date'
formula_status = 'E'
)
return formula_message, formula_status

エレメントまたはエレメント適格レベルの検証Formula:

inputs are hours_worked, rate, earning_date(date), comment(text)
if(hours_worked > 80) then
(
formula_message = 'You are within the working limit.
'formula_status = 'S'
)
else
(
formula_message = 'You have worked too many hours.
'formula_status = 'E'
)
return formula_message, formula_status

エレメントまたはエレメント適格レベルの計算Formula:

inputs are hours_worked, rate, comment(text)
if(hours_worked > 80) then
(
rate = rate * 1.2 
comment = 'Your rate has been increased'
)
return rate, comment

エレメントまたはエレメント適格レベルのデフォルトFormula:

if(CATEGORY = 'S') then
(
rate = 20
)
else
(
rate = 30
)
rate_code = 'B'
return rate, rate_code