1. Fast Formulaの管理
  2. ワークフォース管理機能
機械翻訳について

ワークフォース管理機能

FastFormulaメソッドは、FastFormulaコール間でのみ機能します。 ワークフォース管理はJavaプログラムからレコードを渡し、コール中にこれらの値を格納する必要があるため、これらのワークフォース管理機能を使用して、コール間で値を格納および取得する必要があります。

WSA_GETやWSA_SETなどのFastFormula作業ストレージ領域メソッドを使用しないでください。

関数 摘要 
SET_WRK_NUM(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
P_PARM_VALUE )

P_PARM_NAMEという品目に数値を設定します。 同じ名前の既存のアイテムは上書きされます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • P_PARM_VALUE: 数値。
 
SET_WRK_DATE(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
P_PARM_VALUE )

SET_WRK_NUMと同じですが、日付値の格納に使用されます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • P_PARM_VALUE: 日付値。
 
SET_WRK_TEXT(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
P_PARM_VALUE )

SET_WRK_NUMと同じですが、文字列値の格納に使用されます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • P_PARM_VALUE: 文字列値。
 
GET_WRK_TEXT(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
DEFVAL      ) RETURN VARCHAR2

P_PARM_NAMEという項目の格納された値を取得します。 P_PARM_NAMEというアイテムがない場合は、default-valueを返します。 デフォルト値のデータ・タイプは、アイテムに必要なデータ型です。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • DEFVAL: デフォルト値VARCHAR2
  • RETURN VARCHAR2: varchar値を返します
 
GET_WRK_NUM(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
DEFVAL      ) RETURN NUMBER

GET_WRK_TEXTと同じですが、数値を返すために使用されます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • DEFVAL: デフォルト値NUMBER
  • RETURN VARCHAR2: NUMBER値を返します
 
GET_WRK_DATE(
P_FFS_ID    , 
P_PARM_NAME , 
P_PARM_SEQ  , 
DEFVAL      ) RETURN DATE

GET_WRK_TEXTと同じですが、日付値を返すために使用されます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_PARM_NAME: 任意の英数字の名前。
  • P_PARM_SEQ: 同じPARM_NAMEを持つ複数の値を格納しないかぎり、0に設定します。
  • DEFVAL: デフォルト値DATE
  • RETURN VARCHAR2: DATE値を返します

ルール・パラメータおよびヘッダー値関数

これらのワークフォース管理機能を使用して、ルール・ヘッダーおよびパラメータ値を取得します。 ルール・パラメータ関数で使用される名前は、ルール・テンプレートのパラメータ・ページに入力パラメータ値として表示されます。

関数 摘要 
GET_HDR_TEXT( 
P_RULE_ID     ,
P_COLUMN_NAME ,
DEFVAL       )
RETURN VARCHAR2

この関数を使用して、ルール・テンプレート定義ページの基本情報セクションで設定されるテキスト・フィールド値を取得します。

パラメータ:

  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録3: コンテキストを参照)。
  • P_COLUMN_NAME: 次の有効な列名のいずれかを使用します。
列名 摘要 可能な戻り値
RUN_TBB_LEVEL レポート・レベル DAY, DETAIL, TIMECARD
RULE_EXEC_TYPE ルール実行タイプ CREATE, UPDATE
SUPPRESS_DUP_MSGS 重複メッセージの表示を抑制 Y, N
INCLUDE_EMPTY_TC 空のタイム・カードの処理 Y, N
  • DEFVAL: デフォルト値
  • RETURN VARCHAR2: varchar値を返します
 
FUNCTION get_hdr_num(
P_rule_Id  In Number, p_column_name IN VARCHAR2,
defval       IN Number )
  RETURN Number;

この関数を使用して、ルールまたはルール・テンプレート定義ページの基本情報セクションで数値フィールド値セットを取得します。

パラメータ:

  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録3: コンテキストを参照)。
  • P_COLUMN_NAME: この有効な列名を使用します。
列名 摘要 可能な戻り値
RUN_TBB_LEVEL レポート・レベル DAY, DETAIL, TIMECARD
  • DEFVAL: デフォルト値
  • RETURN Number: 数値を返します
 
GET_RVALUE_NUMBER(
P_RULE_ID     ,
P_VALUE_NAME ,
DEFVAL       )
RETURN NUMBER

この関数を使用して数値を取得します。ルールの「ルール・パラメータ」セクションで設定します。

ノート: ルール・テンプレートは、P_VALUE_NAMEの名前を使用して、ルール・テンプレートの「パラメータ」セクションに移入します。

パラメータ:

  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_VALUE_NAME: 大文字のアルファベットとアンダースコアのみ使用します。 ルール・テンプレートでは、この名前を使用して「パラメータ」ページの「Formulaパラメータ名」セクションに移入します。
  • DEFVAL: デフォルト値
  • RETURN NUMBER: 数値を返します
 
GET_RVALUE_TEXT(
P_RULE_ID     ,
P_VALUE_NAME ,
DEFVAL       ) 
RETURN VARCHAR2

GET_RVALUE_NUMBERと同じですが、文字列値が返されます。

パラメータ:

  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_VALUE_NAME: 大文字のアルファベットとアンダースコアのみ使用します。 ルール・テンプレートでは、この名前を使用して「パラメータ」ページの「Formulaパラメータ名」セクションに移入します。
  • DEFVAL: デフォルト値
  • RETURN NUMBER: varchar値を戻します
 
GET_RVALUE_DATE(
P_RULE_ID     ,
P_VALUE_NAME ,
DEFVAL       )
RETURN DATE

GET_RVALUE_NUMBERと同じですが、日付値が返されます。

パラメータ:

  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_VALUE_NAME: 大文字のアルファベットとアンダースコアのみ使用します。 ルール・テンプレートでは、この名前を使用して「パラメータ」ページの「Formulaパラメータ名」セクションに移入します。
  • DEFVAL: デフォルト値
  • RETURN NUMBER: 戻り日付値

その他の関数

関数 摘要 
ADD_RLOG(
P_FFS_ID    ,  
P_RULE_ID   ,
P_LOG_TEXT )

トレースおよびデバッグ用のログを作成します。 この関数を持つすべてのログは、「時間管理」作業領域の「ルール処理詳細の分析」ページに表示されます。 「処理結果」セクションの「ルール処理ログ」列に表示されます。

パラメータ:

  • P_FFS_ID: HWM_FFS_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_RULE_ID: HWM_RULE_IDコンテキストを使用します(付録2: コンテキストを参照)。
  • P_LOG_TEXT: ログまたはデバッグのための任意の文字列。
 
GET_OUTPUT_MSG1(P_APP_SHORT_NAME,
P_MESSAGE_NAME  ,
TOKEN1_NAME     ,
TOKEN1_VALUE   )
RETURN VARCHAR2

時間入力ルールFormulaでは、この関数を使用して、出力用のデータ・リポジトリ・メッセージを書式設定します。

ノート: データ・リポジトリの出力として渡されるメッセージには、適切な書式設定に適切なGET_OUTPUT_MSG関数を使用する必要があります。

この関数は、単一のトークンを持つメッセージ・コードに使用します。 ワークフォース管理で使用するために書式設定された、出力用の1つのトークンを含む単一のメッセージ文字列を作成します。

パラメータ:

  • P_APP_SHORT_NAME: 3文字のアプリケーション短縮名(多くの場合、FND)
  • P_MESSAGE_NAME: FND_MESSAGES表に定義されているメッセージ・コード
  • TOKEN1_NAME: FND_MESSAGES表に定義されているトークン名
  • TOKEN1_VALUE: トークン値
  • RETURN VARCHAR2: 出力可能なフォーマット済メッセージ

例:

message_name: 
'HWM_FF_TER_PERIOD_GT_MAX_WRN'

 message_text :  
 The hours entered for the period exceed the maximum limit {DEF_LIMIT} defined for the time card.

  from fnd_messages 

P_MESSAGE_NAME: HWM_FF_TER_PERIOD_GT_MAX_WRN
TOKEN1_NAME:    'DEF_LIMIT'
TOKEN1_VALUE:    8

    OUT_MSG = get_output_msg1 ( 'HWM' , P_MESSAGE_NAME, TOKEN1_NAME  , TOKEN1_VALUE)

GET_OUTPUT_MSG2(P_APP_SHORT_NAME,
P_MESSAGE_NAME  ,
TOKEN1_NAME     ,
TOKEN1_VALUE  ,
TOKEN2_NAME     ,
TOKEN2_VALUE   )
RETURN VARCHAR2

時間入力ルールFormulaでは、この関数を使用して、出力用のデータ・リポジトリ・メッセージを書式設定します。

2つのトークンを使用するメッセージを除き、GET_OUTPUT_MSG1と同じです。

 
GET_OUTPUT_MSG( P_APP_SHORT_NAME ,
P_MESSAGE_NAME   )
RETURN VARCHAR2

時間入力ルールFormulaでは、この関数を使用して、出力用のデータ・リポジトリ・メッセージを書式設定します。

トークンがないメッセージを除き、GET_OUTPUT_MSG1と同じです。

 
get_msg_tags 
p_msg_tags   IN VARCHAR2 )
  RETURN VARCHAR2

ワークフォース・コンプライアンス・ルールでのみ使用されます。 カンマ区切りのタグをメッセージに追加します。

サンプル:

 pTagVals = ' tag1, tag2, Compliance '
 tm = get_msg_tags(pTagVals)  ||  get_output_msg1 ( 'FND' ,pMsgCd ,tkn , val )

FUNCTION time_hhmm_to_dec(
time_dec IN NUMBER )
  RETURN NUMBER;
この関数は、時間を10進数に変換します。たとえば、2.59 hhmmを2.983 decに変換します。 
FUNCTION raise_error(
    p_ffs_id   IN NUMBER ,
    p_rule_id   IN NUMBER ,
    p_message_text IN varchar2 )
return number ;
処理を停止し、致命的なエラーを発生させます。 
FUNCTION get_measure_from_time(
start_time IN date,
stop_time IN date )
  RETURN NUMBER;
開始および停止のdate_timeスタンプを使用して期間(メジャー)を計算します。 
FUNCTION get_date_day_of_Week(
 p_in_date   IN date )
  RETURN VARCHAR2;
短い(3文字)大文字の曜日(MONやTUEなど)を返します。 
FUNCTION get_is_date_same_as_dow(
    p_in_date   IN date ,
    p_in_day_of_week   IN VARCHAR2 )
  RETURN VARCHAR2;
日付と曜日の文字列を比較し、YESまたはNoを返します。 
FUNCTION is_date_between(
compare_date  IN date, 
start_time  IN date,
stop_time   IN date  )
  RETURN number;

compare_dateがstart_timeとstop_timeの間にあるかどうかを確認します。

  • 日時が開始日と終了日の間である場合、関数は1を返します。
  • 日時が開始日と終了日の間にない場合、関数は0を返します。
 
FUNCTION get_current_date
  RETURN date;
現在のサーバーの日時を返します。 日時はユーザーのタイム・ゾーンに基づいていません。 
FUNCTION get_current_time (
 o_staus_log	varchar2,
 o_current_time  date,
 resource_id	 NUMBER,
 zone_type	IN varchar2,
 zone_code  	IN varchar2,
 gmt_offset   IN  number,
)
  RETURN  O_STATUS  VARCHAR2;

指定されたリソース、タイムゾーン・タイプなどの現在のタイムスタンプを取得します。

入力:

resource_id: if resource Id provided function will return current time based on resource (person) time zone.
If Resource ID is not provided or to get current time for specific time zone:
 zone_type - valid Values ' ZONE' , ' OFFSET'
zone_code   Zone code, if Zone type set to 'Zone'
 gmt_offset   gmt Offset, if zone type is set to ' OFFSET'

Outputs
o_current_time : current time for specified user/time zone, If Status is ''SUCCESS'

Return  O_STATUS   (   'SUCCESS',            'FAILED') - Status
o_staus_log: If Status is Failed, information for failure

FUNCTION get_duration_start_to_now (
 o_staus_log    varchar2,
 o_calculated_Hours   number,
 resource_id  IN NUMBER,
  start_Time  IN date,
 start_zone_type   IN  varchar2,
 start_zone_code  IN  varchar2,
  start_gmt_offset  IN  number  )
  RETURN O_STATUS  VARCHAR2;

ユーザーのタイムゾーンまたは指定されたゾーンとオフセットに基づいて、start_timeから現在の時間までの期間を計算します。

入力:

resource_id: if resource Id provided function will return current time based on resource (person) time zone.
start_Time: Start Date time, of duration to current time
If Resource ID is not provided or to get current time for specific time zone:
 zone_type - valid Values ' ZONE' , ' OFFSET'
zone_code   Zone code, if Zone type set to 'Zone'
 gmt_offset   gmt Offset, if zone type is set to ' OFFSET'

Outputs 
o_calculated_Hours: Calculated duration(hours) time for specified user/time zone, If Status is ''SUCCESS'

Return  O_STATUS   (   'SUCCESS',            'FAILED') - Status
o_staus_log: If Status is Failed, information for failure

get_unprocessed_event_set 
( staus_log out varchar2,
 row_count  out number,
 event_rs_key out varchar2,
  resource_id   IN NUMBER,
 start_date      IN date,
  end_date        IN date )
  RETURN STATUS  VARCHAR2;

(executeQuery)と同様に、特定のリソースおよび日付範囲に対して未処理のイベントを選択します。 この関数は、識別されたデータをキャッシュします。 get_unprocessed_event_rec関数を使用して、各行をループ・スルーおよび取得します。

STATUS TEXT出力。 要求ステータス。指定可能な値は次のとおりです。

  • 'NO_REC_FOUND'
  • 'SUCCESS'
  • 'FAILED'

status_log TEXT「FAILED」ステータスおよび対応するプロセス・データに関連する詳細情報を含む出力ログ・ファイル。

row_count  NUMBER  Number of rows selected
event_rs_key  Text  - Output row set key required for get_unprocessed_event_rec function
  resource_id  NUMBER  Input Resource Id used to select records
 start_date   date  Start Date for row selection
  end_date     date   End date for row selection

get_unprocessed_event_rec 
(staus_log  out   varchar2,
 Event_Type out   varchar2,
 Event_Time out   date,
 Event_InOut  out   varchar2,
 event_rs_key  IN VARCHAR2 ,
 row_index  IN NUMBER  ) 
RETURN STATUS  VARCHAR2;

get_unprocessed_event_set関数で選択した個々の行を取得します。

STATUS TEXT出力。 要求ステータス。指定可能な値は次のとおりです。

  • 'NO_REC_FOUND'
  • 'SUCCESS'
  • 'FAILED'

staus_log TEXT「FAILED」ステータスおよび対応するプロセス・データに関連する詳細情報を含む出力ログ・ファイル。

Event output information: Event_Type, Event_Time, Event_InOut 
event_rs_key  Text  - Input row set key from get_unprocessed_event_set function

row_index   use index from 0 to row_count from get_unprocessed_event_set function to loop through and select rows

get_null_ff_text()
  RETURN VARCHAR2;
時間ルールまたはFormulaのNULL値を取得します。 戻り値はテキストです。 
get_null_ff_num ()
  RETURN NUMBER  ;
時間ルールまたはFormulaのNULL値を取得します。 戻り値は数値です。 
get_null_ff_date ()
  RETURN date;
時間ルールまたはFormulaのNULL値を取得します。 戻り値は日付です。

データ・アクセス・ビュー・エントリ(DAVE)関数

これらの関数を使用すると、現在のタイム・カード期間に使用できない時間リポジトリ・データをフィルタおよび集計できます。 各DAVE機能の詳細は、「ワークフォース管理FastFormulaのDAVE機能」の章に含まれています。