1 Package per_pyp_del as
2 /* $Header: pepyprhi.pkh 120.6.12010000.1 2008/07/28 05:30:34 appldev ship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< del >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 -- This procedure is the record interface for the delete process
11 -- for the specified entity. The role of this process is to delete the
12 -- row from the HR schema. This process is the main backbone of the del
13 -- business process. The processing of this procedure is as follows:
14 -- 1) If the p_validate parameter has been set to true then a savepoint is
15 -- issued.
16 -- 2) The controlling validation process delete_validate is then executed
17 -- which will execute all private and public validation business rule
18 -- processes.
19 -- 3) The pre_delete process is then executed which enables any
20 -- logic to be processed before the delete dml process is executed.
21 -- 4) The delete_dml process will physical perform the delete dml for the
22 -- specified row.
23 -- 5) The post_delete process is then executed which enables any
24 -- logic to be processed after the delete dml process.
25 -- 6) If the p_validate parameter has been set to true an exception is raised
26 -- which is handled and processed by performing a rollback to the
27 -- savepoint which was issued at the beginning of the del process.
28 --
29 -- Pre Conditions:
30 -- The main parameters to the business process have to be in the record
31 -- format.
32 --
33 -- In Parameters:
34 -- p_validate
35 -- Determines if the process is to be validated. Setting this
36 -- boolean value to true will invoke the process to be validated. The
37 -- default is false. The validation is controlled by a savepoint and
38 -- rollback mechanism. The savepoint is issued at the beginning of the
39 -- process and is rollbacked at the end of the process
40 -- when all the processing has been completed. The rollback is controlled
41 -- by raising and handling the exception hr_api.validate_enabled. We use
42 -- the exception because, by raising the exception with the business
43 -- process, we can exit successfully without having any of the 'OUT'
44 -- parameters being set.
45 --
46 -- Post Success:
47 -- The specified row will be fully validated and deleted for the specified
48 -- entity without being committed. If the p_validate parameter has been set
49 -- to true then all the work will be rolled back.
50 --
51 -- Post Failure:
52 -- If an error has occurred, an error message will be supplied with the work
53 -- rolled back.
54 --
55 -- Developer Implementation Notes:
56 -- None.
57 --
58 -- Access Status:
59 -- Internal Development Use Only.
60 --
61 -- {End Of Comments}
62 -- ----------------------------------------------------------------------------
63 Procedure del
64 (
65 p_rec in per_pyp_shd.g_rec_type,
66 p_validate in boolean default false,
67 p_salary_warning out nocopy boolean
68 );
69 --
70 -- ----------------------------------------------------------------------------
71 -- |---------------------------------< del >----------------------------------|
72 -- ----------------------------------------------------------------------------
73 -- {Start Of Comments}
74 --
75 -- Description:
76 -- This procedure is the attribute interface for the delete
77 -- process for the specified entity and is the outermost layer. The role
78 -- of this process is to validate and delete the specified row from the
79 -- HR schema. The processing of this procedure is as follows:
80 -- 1) The attributes are converted into a local record structure by
81 -- explicitly coding the attribute parameters into the g_rec_type
82 -- datatype.
83 -- 2) After the conversion has taken place, the corresponding record del
84 -- interface process is executed.
85 --
86 -- Pre Conditions:
87 --
88 -- In Parameters:
89 -- p_validate
90 -- Determines if the process is to be validated. Setting this
91 -- Boolean value to true will invoke the process to be validated.
92 -- The default is false.
93 --
94 -- Post Success:
95 -- The specified row will be fully validated and deleted for the specified
96 -- entity without being committed (or rollbacked depending on the
97 -- p_validate status).
98 --
99 -- Post Failure:
100 -- If an error has occurred, an error message will be supplied with the work
101 -- rolled back.
102 --
103 -- Developer Implementation Notes:
104 -- The attrbute in parameters should be modified as to the business process
105 -- requirements.
106 --
107 -- Access Status:
108 -- Internal Development Use Only.
109 --
110 -- {End Of Comments}
111 -- ----------------------------------------------------------------------------
112 Procedure del
113 (
114 p_pay_proposal_id in number,
115 p_object_version_number in number,
116 p_validate in boolean default false,
117 p_salary_warning out nocopy boolean
118 );
119 --
120 end per_pyp_del;