DBA Data[Home] [Help]

PACKAGE: APPS.PER_PYP_DEL

Source


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;