1 Package ben_bvr_upd as
2 /* $Header: bebvrrhi.pkh 120.0 2005/05/28 00:54:51 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 supplied with the work
50 -- rolled back.
51 --
52 -- Developer Implementation Notes:
53 -- None.
54 --
55 -- Access Status:
56 -- Internal Development Use Only.
57 --
58 -- {End Of Comments}
59 -- ----------------------------------------------------------------------------
60 Procedure upd
61 (
62 p_rec in out nocopy ben_bvr_shd.g_rec_type,
63 p_effective_date in date,
64 p_datetrack_mode in varchar2
65 );
66 --
67 -- ----------------------------------------------------------------------------
68 -- |---------------------------------< upd >----------------------------------|
69 -- ----------------------------------------------------------------------------
70 -- {Start Of Comments}
71 --
72 -- Description:
73 -- This procedure is the attribute interface for the datetrack update
74 -- process for the specified entity and is the outermost layer.
75 -- The role of this process is to update a fully validated row into the
76 -- HR schema passing back to the calling process, any system generated
77 -- values (e.g. object version number attributes). The processing of this
78 -- procedure is as follows:
79 -- 1) The attributes are converted into a local record structure by
80 -- calling the convert_args function.
81 -- 2) After the conversion has taken place, the corresponding record upd
82 -- interface process is executed.
83 -- 3) OUT parameters are then set to their corresponding record attributes.
84 --
85 -- Prerequisites:
86 --
87 -- In Parameters:
88 -- p_effective_date
89 -- Specifies the date of the datetrack update operation.
90 -- p_datetrack_mode
91 -- Determines the datetrack update mode.
92 --
93 -- Post Success:
94 -- A fully validated row will be updated for the specified entity
95 -- without being committed.
96 --
97 -- Post Failure:
98 -- If an error has occurred, an error message will be supplied with the work
99 -- rolled back.
100 --
101 -- Developer Implementation Notes:
102 -- None.
103 --
104 -- Access Status:
105 -- Internal Development Use Only.
106 --
107 -- {End Of Comments}
108 -- ----------------------------------------------------------------------------
109 Procedure upd
110 (
111 p_bnft_vrbl_rt_id in number,
112 p_effective_start_date out nocopy date,
113 p_effective_end_date out nocopy date,
114 p_cvg_amt_calc_mthd_id in number default hr_api.g_number,
115 p_vrbl_rt_prfl_id in number default hr_api.g_number,
116 p_business_group_id in number default hr_api.g_number,
117 p_bvr_attribute_category in varchar2 default hr_api.g_varchar2,
118 p_bvr_attribute1 in varchar2 default hr_api.g_varchar2,
119 p_bvr_attribute2 in varchar2 default hr_api.g_varchar2,
120 p_bvr_attribute3 in varchar2 default hr_api.g_varchar2,
121 p_bvr_attribute4 in varchar2 default hr_api.g_varchar2,
122 p_bvr_attribute5 in varchar2 default hr_api.g_varchar2,
123 p_bvr_attribute6 in varchar2 default hr_api.g_varchar2,
124 p_bvr_attribute7 in varchar2 default hr_api.g_varchar2,
125 p_bvr_attribute8 in varchar2 default hr_api.g_varchar2,
126 p_bvr_attribute9 in varchar2 default hr_api.g_varchar2,
127 p_bvr_attribute10 in varchar2 default hr_api.g_varchar2,
128 p_bvr_attribute11 in varchar2 default hr_api.g_varchar2,
129 p_bvr_attribute12 in varchar2 default hr_api.g_varchar2,
130 p_bvr_attribute13 in varchar2 default hr_api.g_varchar2,
131 p_bvr_attribute14 in varchar2 default hr_api.g_varchar2,
132 p_bvr_attribute15 in varchar2 default hr_api.g_varchar2,
133 p_bvr_attribute16 in varchar2 default hr_api.g_varchar2,
134 p_bvr_attribute17 in varchar2 default hr_api.g_varchar2,
135 p_bvr_attribute18 in varchar2 default hr_api.g_varchar2,
136 p_bvr_attribute19 in varchar2 default hr_api.g_varchar2,
137 p_bvr_attribute20 in varchar2 default hr_api.g_varchar2,
138 p_bvr_attribute21 in varchar2 default hr_api.g_varchar2,
139 p_bvr_attribute22 in varchar2 default hr_api.g_varchar2,
140 p_bvr_attribute23 in varchar2 default hr_api.g_varchar2,
141 p_bvr_attribute24 in varchar2 default hr_api.g_varchar2,
142 p_bvr_attribute25 in varchar2 default hr_api.g_varchar2,
143 p_bvr_attribute26 in varchar2 default hr_api.g_varchar2,
144 p_bvr_attribute27 in varchar2 default hr_api.g_varchar2,
145 p_bvr_attribute28 in varchar2 default hr_api.g_varchar2,
146 p_bvr_attribute29 in varchar2 default hr_api.g_varchar2,
147 p_bvr_attribute30 in varchar2 default hr_api.g_varchar2,
148 p_object_version_number in out nocopy number,
149 p_ordr_num in number default hr_api.g_number,
150 p_effective_date in date,
151 p_datetrack_mode in varchar2
152 );
153 --
154 end ben_bvr_upd;