1 Package ghr_prh_ins AUTHID CURRENT_USER as
2 /* $Header: ghprhrhi.pkh 120.1.12020000.2 2012/07/11 09:30:41 vmididho ship $ */
3
4 --
5 -- ----------------------------------------------------------------------------
6 -- |---------------------------------< ins >----------------------------------|
7 -- ----------------------------------------------------------------------------
8 -- {Start Of Comments}
9 --
10 -- Description:
11 -- This procedure is the record interface for the insert process
12 -- for the specified entity. The role of this process is to insert a fully
13 -- validated row, into the HR schema passing back to the calling process,
14 -- any system generated values (e.g. primary and object version number
15 -- attributes). This process is the main backbone of the ins
16 -- process. The processing of this procedure is as follows:
17 -- 1) If the p_validate parameter has been set to true then a savepoint is
18 -- issued.
19 -- 2) The controlling validation process insert_validate is then executed
20 -- which will execute all private and public validation business rule
21 -- processes.
22 -- 3) The pre_insert business process is then executed which enables any
23 -- logic to be processed before the insert dml process is executed.
24 -- 4) The insert_dml process will physical perform the insert dml into the
25 -- specified entity.
26 -- 5) The post_insert business process is then executed which enables any
27 -- logic to be processed after the insert dml process.
28 -- 6) If the p_validate parameter has been set to true an exception is
29 -- raised which is handled and processed by performing a rollback to the
30 -- savepoint which was issued at the beginning of the Ins process.
31 --
32 -- Pre Conditions:
33 -- The main parameters to the this process have to be in the record
34 -- format.
35 --
36 -- In Parameters:
37 -- p_validate
38 -- Determines if the process is to be validated. Setting this
39 -- boolean value to true will invoke the process to be validated. The
40 -- default is false. The validation is controlled by a savepoint and
41 -- rollback mechanism. The savepoint is issued at the beginning of the
42 -- process and is rollbacked at the end of the process
43 -- when all the processing has been completed. The rollback is controlled
44 -- by raising and handling the exception hr_api.validate_enabled. We use
45 -- the exception because, by raising the exception with the business
46 -- process, we can exit successfully without having any of the 'OUT'
47 -- parameters being set.
48 --
49 -- Post Success:
50 -- A fully validated row will be inserted into the specified entity
51 -- without being committed. If the p_validate parameter has been set to true
52 -- then all the work will be rolled back.
53 --
54 -- Post Failure:
55 -- If an error has occurred, an error message will be supplied with the work
56 -- rolled back.
57 --
58 -- Developer Implementation Notes:
59 -- None.
60 --
61 -- Access Status:
62 -- Internal Development Use Only.
63 --
64 -- {End Of Comments}
65 -- ----------------------------------------------------------------------------
66 Procedure ins
67 (
68 p_rec in out NOCOPY ghr_prh_shd.g_rec_type,
69 p_validate in boolean default false
70 );
71 --
72 -- ----------------------------------------------------------------------------
73 -- |---------------------------------< ins >----------------------------------|
74 -- ----------------------------------------------------------------------------
75 -- {Start Of Comments}
76 --
77 -- Description:
78 -- This procedure is the attribute interface for the insert
79 -- process for the specified entity and is the outermost layer. The role
80 -- of this process is to insert a fully validated row into the HR schema
81 -- passing back to the calling process, any system generated values
82 -- (e.g. object version number attributes).The processing of this
83 -- procedure is as follows:
84 -- 1) The attributes are converted into a local record structure by
85 -- calling the convert_args function.
86 -- 2) After the conversion has taken place, the corresponding record ins
87 -- interface process is executed.
88 -- 3) OUT parameters are then set to their corresponding record attributes.
89 --
90 -- Pre Conditions:
91 --
92 -- In Parameters:
93 -- p_validate
94 -- Determines if the process is to be validated. Setting this
95 -- Boolean value to true will invoke the process to be validated.
96 -- The default is false.
97 --
98 -- Post Success:
99 -- A fully validated row will be inserted for the specified entity
100 -- without being committed (or rollbacked depending on the p_validate
101 -- status).
102 --
103 -- Post Failure:
104 -- If an error has occurred, an error message will be supplied with the work
105 -- rolled back.
106 --
107 -- Developer Implementation Notes:
108 -- None.
109 --
110 -- Access Status:
111 -- Internal Development Use Only.
112 --
113 -- {End Of Comments}
114 -- ----------------------------------------------------------------------------
115 Procedure ins
116 (
117 p_pa_routing_history_id out NOCOPY number,
118 p_pa_request_id in number,
119 p_attachment_modified_flag in varchar2 default null,
120 p_initiator_flag in varchar2 default null,
121 p_approver_flag in varchar2 default null,
122 p_reviewer_flag in varchar2 default null,
123 p_requester_flag in varchar2 default null,
124 p_authorizer_flag in varchar2 default null,
125 p_personnelist_flag in varchar2 default null,
126 p_approved_flag in varchar2 default null,
127 p_user_name in varchar2 default null,
128 p_user_name_employee_id in number default null,
129 p_user_name_emp_first_name in varchar2 default null,
130 p_user_name_emp_last_name in varchar2 default null,
131 p_user_name_emp_middle_names in varchar2 default null,
132 p_notepad in varchar2 default null,
133 p_action_taken in varchar2 default null,
134 p_groupbox_id in number default null,
135 p_routing_list_id in number default null,
136 p_routing_seq_number in number default null,
137 p_noa_family_code in varchar2 default null,
138 p_nature_of_action_id in number default null,
139 p_second_nature_of_action_id in number default null,
140 p_approval_status in varchar2 default null,
141 p_date_notification_sent in date default null,
142 p_object_version_number out NOCOPY number,
143 p_validate in boolean default false
144 );
145 --
146 end ghr_prh_ins;