1 Package pay_pur_upd as
2 /* $Header: pypurrhi.pkh 120.0 2005/05/29 08:01 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< upd >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 -- This procedure is the record interface for the update
11 -- process for the specified entity. The role of this process is
12 -- to perform the datetrack update mode, fully validating the row
13 -- for the HR schema passing back to the calling process, any system
14 -- generated values (e.g. object version number attribute). This process
15 -- is the main backbone of the upd process. The processing of
16 -- this procedure is as follows:
17 -- 1) Ensure that the datetrack update mode is valid.
18 -- 2) The row to be updated is then locked and selected into the record
19 -- structure g_old_rec.
20 -- 3) Because on update parameters which are not part of the update do not
21 -- have to be defaulted, we need to build up the updated row by
22 -- converting any system defaulted parameters to their corresponding
23 -- value.
24 -- 4) The controlling validation process update_validate is then executed
25 -- which will execute all private and public validation business rule
26 -- processes.
27 -- 5) The pre_update process is then executed which enables any
28 -- logic to be processed before the update dml process is executed.
29 -- 6) The update_dml process will physical perform the update dml into the
30 -- specified entity.
31 -- 7) The post_update process is then executed which enables any
32 -- logic to be processed after the update dml process.
33 --
34 -- Prerequisites:
35 -- The main parameters to the process have to be in the record
36 -- format.
37 --
38 -- In Parameters:
39 -- p_effective_date
40 -- Specifies the date of the datetrack update operation.
41 -- p_datetrack_mode
42 -- Determines the datetrack update mode.
43 --
44 -- Post Success:
45 -- The specified row will be fully validated and datetracked updated for
46 -- the specified entity without being committed for the datetrack mode.
47 --
48 -- Post Failure:
49 -- If an error has occurred, an error message will be raised.
50 --
51 -- Developer Implementation Notes:
52 -- None.
53 --
54 -- Access Status:
55 -- Internal Development Use Only.
56 --
57 -- ----------------------------------------------------------------------------
58 Procedure upd
59 (p_effective_date in date
60 ,p_datetrack_mode in varchar2
61 ,p_rec in out nocopy pay_pur_shd.g_rec_type
62 ,p_disable_units_check in boolean default false
63 ,p_disable_range_overlap_check in boolean default false
64 );
65 --
66 -- ----------------------------------------------------------------------------
67 -- |-------------------------------< upd >------------------------------------|
68 -- ----------------------------------------------------------------------------
69 -- {Start Of Comments}
70 --
71 -- Description:
72 -- This procedure is the attribute interface for the datetrack update
73 -- process for the specified entity and is the outermost layer.
74 -- The role of this process is to update a fully validated row into the
75 -- HR schema passing back to the calling process, any system generated
76 -- values (e.g. object version number attributes). The processing of this
77 -- procedure is as follows:
78 -- 1) The attributes are converted into a local record structure by
79 -- calling the convert_args function.
80 -- 2) After the conversion has taken place, the corresponding record upd
81 -- interface process is executed.
82 -- 3) OUT parameters are then set to their corresponding record attributes.
83 --
84 -- Prerequisites:
85 --
86 -- In Parameters:
87 -- p_effective_date
88 -- Specifies the date of the datetrack update operation.
89 -- p_datetrack_mode
90 -- Determines the datetrack update mode.
91 --
92 -- Post Success:
93 -- A fully validated row will be updated for the specified entity
94 -- without being committed.
95 --
96 -- Post Failure:
97 -- If an error has occurred, an error message will be raised.
98 --
99 -- Developer Implementation Notes:
100 -- None.
101 --
102 -- Access Status:
103 -- Internal Development Use Only.
104 --
105 -- {End Of Comments}
106 -- ----------------------------------------------------------------------------
107 Procedure upd
108 (p_effective_date in date
109 ,p_datetrack_mode in varchar2
110 ,p_user_row_id in number
111 ,p_object_version_number in out nocopy number
112 ,p_row_low_range_or_name in varchar2 default hr_api.g_varchar2
113 ,p_display_sequence in number default hr_api.g_number
114 ,p_row_high_range in varchar2 default hr_api.g_varchar2
115 ,p_disable_units_check in boolean default false
116 ,p_disable_range_overlap_check in boolean default false
117 ,p_effective_start_date out nocopy date
118 ,p_effective_end_date out nocopy date
119 );
120 --
121 end pay_pur_upd;