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