1 Package ame_rlu_ins AUTHID CURRENT_USER as
2 /* $Header: amrlurhi.pkh 120.0 2005/09/02 04:02 mbocutt noship $ */
3 -- ----------------------------------------------------------------------------
4 -- |------------------------< set_base_key_value >----------------------------|
5 -- ----------------------------------------------------------------------------
6 -- {Start of Comments}
7 -- Description:
8 -- This procedure is called to register the next ID value from the database
9 -- sequence.
10 --
11 -- Prerequisites:
12 --
13 -- In Parameters:
14 -- Primary Key
15 --
16 -- Post Success:
17 --
18 -- Post Failure:
19 --
20 -- Developer Implementation Notes:
21 -- None.
22 --
23 -- Access Status:
24 -- Internal Development Use Only.
25 --
26 -- {End of Comments}
27 -- ----------------------------------------------------------------------------
28 procedure set_base_key_value
29 (p_item_id in number
30 ,p_rule_id in number);
31 --
32 -- ----------------------------------------------------------------------------
33 -- |------------------------------< insert_dml >------------------------------|
34 -- ----------------------------------------------------------------------------
35 -- {Start Of Comments}
36 --
37 -- Description:
38 -- This procedure calls the dt_insert_dml control logic which handles
39 -- the actual datetrack dml.
40 --
41 -- Prerequisites:
42 -- This is an internal private procedure which must be called from the ins
43 -- procedure and must have all mandatory attributes set (except the
44 -- object_version_number which is initialised within the dt_insert_dml
45 -- procedure).
46 --
47 -- In Parameters:
48 -- A Pl/Sql record structure.
49 --
50 -- Post Success:
51 -- Processing contines.
52 --
53 -- Post Failure:
54 -- No specific error handling is required within this procedure.
55 --
56 -- Developer Implementation Notes:
57 -- None.
58 --
59 -- Access Status:
60 -- Internal Row Handler Use Only.
61 --
62 -- {End Of Comments}
63 -- ----------------------------------------------------------------------------
64 Procedure insert_dml
65 (p_rec in out nocopy ame_rlu_shd.g_rec_type
66 ,p_effective_date in date
67 ,p_datetrack_mode in varchar2
68 ,p_validation_start_date in date
69 ,p_validation_end_date in date
70 );
71 --
72 -- ----------------------------------------------------------------------------
73 -- |---------------------------------< ins >----------------------------------|
74 -- ----------------------------------------------------------------------------
75 -- {Start Of Comments}
76 --
77 -- Description:
78 -- This procedure is the record interface for the insert process
79 -- for the specified entity. The role of this process is to insert a fully
80 -- validated row, into the HR schema passing back to the calling process,
81 -- any system generated values (e.g. primary and object version number
82 -- attributes). This process is the main backbone of the ins business
83 -- process. The processing of this procedure is as follows:
84 -- 1) We must lock parent rows (if any exist).
85 -- 2) The controlling validation process insert_validate is then executed
86 -- which will execute all private and public validation business rule
87 -- processes.
88 -- 3) The pre_insert process is then executed which enables any
89 -- logic to be processed before the insert dml process is executed.
90 -- 4) The insert_dml process will physical perform the insert dml into the
91 -- specified entity.
92 -- 5) The post_insert process is then executed which enables any
93 -- logic to be processed after the insert dml process.
94 --
95 -- Prerequisites:
96 -- The main parameters to the process have to be in the record
97 -- format.
98 --
99 -- In Parameters:
100 -- p_effective_date
101 -- Specifies the date of the datetrack insert operation.
102 --
103 -- Post Success:
104 -- A fully validated row will be inserted into the specified entity
105 -- without being committed.
106 --
107 -- Post Failure:
108 -- If an error has occurred, an error message will be raised.
109 --
110 -- Developer Implementation Notes:
111 -- None.
112 --
113 -- Access Status:
114 -- Internal Development Use Only.
115 --
116 -- {End Of Comments}
117 -- ----------------------------------------------------------------------------
118 Procedure ins
119 (p_effective_date in date
120 ,p_rec in out nocopy ame_rlu_shd.g_rec_type
121 );
122 --
123 -- ----------------------------------------------------------------------------
124 -- |---------------------------------< ins >----------------------------------|
125 -- ----------------------------------------------------------------------------
126 -- {Start Of Comments}
127 --
128 -- Description:
129 -- This procedure is the attribute interface for the insert
130 -- process for the specified entity and is the outermost layer. The role
131 -- of this process is to insert a fully validated row into the HR schema
132 -- passing back to the calling process, any system generated values
133 -- (e.g. object version number attributes). The processing of this
134 -- procedure is as follows:
135 -- 1) The attributes are converted into a local record structure by
136 -- calling the convert_args function.
137 -- 2) After the conversion has taken place, the corresponding record ins
138 -- interface process is executed.
139 -- 3) OUT parameters are then set to their corresponding record attributes.
140 --
141 -- Prerequisites:
142 --
143 -- In Parameters:
144 -- p_effective_date
145 -- Specifies the date of the datetrack insert operation.
146 --
147 -- Post Success:
148 -- A fully validated row will be inserted for the specified entity
149 -- without being committed.
150 --
151 -- Post Failure:
152 -- If an error has occurred, an error message will be raised.
153 --
154 -- Developer Implementation Notes:
155 -- None.
156 --
157 -- Access Status:
158 -- Internal Development Use Only.
159 --
160 -- {End Of Comments}
161 -- ----------------------------------------------------------------------------
162 Procedure ins
163 (p_effective_date in date
164 ,p_item_id in number
165 ,p_rule_id in number
166 ,p_usage_type in varchar2 default null
167 ,p_security_group_id in number default null
168 ,p_priority in number default null
169 ,p_approver_category in varchar2 default null
170 ,p_start_date in out nocopy date
171 ,p_end_date in out nocopy date
172 ,p_object_version_number out nocopy number
173 );
174 --
175 end ame_rlu_ins;