DBA Data[Home] [Help]

PACKAGE: APPS.OTA_TFL_API_UPD

Source


1 Package ota_tfl_api_upd as
2 /* $Header: ottfl01t.pkh 120.0 2005/05/29 07:41:52 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< upd >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 --   This procedure is the record interface for the update business
11 --   process for the specified entity. The role of this process is
12 --   to update a fully validated row for the HR schema passing back
13 --   to the calling process, any system generated values (e.g.
14 --   object version number attribute). This process is the main
15 --   backbone of the upd business process. The processing of this
16 --   procedure is as follows:
17 --   1) If the p_validate argument has been set to true then a savepoint
18 --      is issued.
19 --   2) The row to be updated is then locked and selected into the record
20 --      structure g_old_rec.
21 --   3) Because on update arguments which are not part of the update do not
22 --      have to be defaulted, we need to build up the updated row by
23 --      converting any system defaulted arguments to their corresponding
24 --      value.
25 --   4) The controlling validation process update_validate is then executed
26 --      which will execute all private and public validation business rule
27 --      processes.
28 --   5) The pre_update business process is then executed which enables any
29 --      logic to be processed before the update dml process is executed.
30 --   6) The update_dml process will physical perform the update dml into the
31 --      specified entity.
32 --   7) The post_update business process is then executed which enables any
33 --      logic to be processed after the update dml process.
34 --   8) If the p_validate argument has been set to true an exception is
35 --      raised which is handled and processed by performing a rollback to
36 --      the savepoint which was issued at the beginning of the upd process.
37 --
38 -- Pre Conditions:
39 --   The main arguments to the business process have to be in the record
40 --   format.
41 --
42 -- In Arguments:
43 --   p_validate
44 --     Determines if the business process is to be validated. Setting this
45 --     boolean value to true will invoke the process to be validated. The
46 --     default is false. The validation is controlled by a savepoint and
47 --     rollback mechanism. The savepoint is issued at the beginning of the
48 --     business process and is rollbacked at the end of the business process
49 --     when all the processing has been completed. The rollback is controlled
50 --     by raising and handling the exception hr_api.validate_enabled. We use
51 --     the exception because, by raising the exception with the business
52 --     process, we can exit successfully without having any of the 'OUT'
53 --     arguments being set.
54 --
55 -- Post Success:
56 --   The specified row will be fully validated and updated for the specified
57 --   entity without being committed. If the p_validate argument has been set
58 --   to true then all the work will be rolled back.
59 --
60 -- Post Failure:
61 --   If an error has occurred, an error message will be supplied with the work
62 --   rolled back.
63 --
64 -- Developer Implementation Notes:
65 --   None.
66 --
67 -- Access Status:
68 --   Public.
69 --
70 -- {End Of Comments}
71 -- ----------------------------------------------------------------------------
72 Procedure upd
73   (
74   p_rec                 in out nocopy ota_tfl_api_shd.g_rec_type,
75   p_validate            in     boolean default false,
76   p_transaction_type    in     varchar2
77   );
78 --
79 -- ----------------------------------------------------------------------------
80 -- |---------------------------------< upd >----------------------------------|
81 -- ----------------------------------------------------------------------------
82 -- {Start Of Comments}
83 --
84 -- Description:
85 --   This procedure is the attribute interface for the update business
86 --   process for the specified entity and is the outermost layer. The role
87 --   of this process is to update a fully validated row into the HR schema
88 --   passing back to the calling process, any system generated values
89 --   (e.g. object version number attributes).The processing of this
90 --   procedure is as follows:
91 --   1) The attributes are converted into a local record structure by
92 --      calling the convert_defs function.
93 --   2) After the conversion has taken place, the corresponding record upd
94 --      interface business process is executed.
95 --   3) OUT arguments are then set to their corresponding record arguments.
96 --
97 -- Pre Conditions:
98 --
99 -- In Arguments:
100 --   p_validate
101 --     Determines if the business process is to be validated. Setting this
102 --     Boolean value to true will invoke the process to be validated.
103 --     The default is false.
104 --
105 -- Post Success:
106 --   A fully validated row will be updated for the specified entity
107 --   without being committed (or rollbacked depending on the p_validate
108 --   status).
109 --
110 -- Post Failure:
111 --   If an error has occurred, an error message will be supplied with the work
112 --   rolled back.
113 --
114 -- Developer Implementation Notes:
115 --   None.
116 --
117 -- Access Status:
118 --   Public.
119 --
120 -- {End Of Comments}
121 -- ----------------------------------------------------------------------------
122 Procedure upd
123   (
124   p_finance_line_id              in number,
125   p_finance_header_id            in number           default hr_api.g_number,
126   p_cancelled_flag               in varchar2         default hr_api.g_varchar2,
127   p_date_raised                  in out nocopy date,
128   p_line_type                    in varchar2         default hr_api.g_varchar2,
129   p_object_version_number        in out nocopy number,
130   p_sequence_number              in out nocopy number,
131   p_transfer_status              in varchar2         default hr_api.g_varchar2,
132   p_comments                     in varchar2         default hr_api.g_varchar2,
133   p_currency_code                in varchar2         default hr_api.g_varchar2,
134   p_money_amount                 in number           default hr_api.g_number,
135   p_standard_amount              in number           default hr_api.g_number,
136   p_trans_information_category   in varchar2         default hr_api.g_varchar2,
137   p_trans_information1           in varchar2         default hr_api.g_varchar2,
138   p_trans_information10          in varchar2         default hr_api.g_varchar2,
139   p_trans_information11          in varchar2         default hr_api.g_varchar2,
140   p_trans_information12          in varchar2         default hr_api.g_varchar2,
141   p_trans_information13          in varchar2         default hr_api.g_varchar2,
142   p_trans_information14          in varchar2         default hr_api.g_varchar2,
143   p_trans_information15          in varchar2         default hr_api.g_varchar2,
144   p_trans_information16          in varchar2         default hr_api.g_varchar2,
145   p_trans_information17          in varchar2         default hr_api.g_varchar2,
146   p_trans_information18          in varchar2         default hr_api.g_varchar2,
147   p_trans_information19          in varchar2         default hr_api.g_varchar2,
148   p_trans_information2           in varchar2         default hr_api.g_varchar2,
149   p_trans_information20          in varchar2         default hr_api.g_varchar2,
150   p_trans_information3           in varchar2         default hr_api.g_varchar2,
151   p_trans_information4           in varchar2         default hr_api.g_varchar2,
152   p_trans_information5           in varchar2         default hr_api.g_varchar2,
153   p_trans_information6           in varchar2         default hr_api.g_varchar2,
154   p_trans_information7           in varchar2         default hr_api.g_varchar2,
155   p_trans_information8           in varchar2         default hr_api.g_varchar2,
156   p_trans_information9           in varchar2         default hr_api.g_varchar2,
157   p_transfer_date                in date             default hr_api.g_date,
158   p_transfer_message             in varchar2         default hr_api.g_varchar2,
159   p_unitary_amount               in number           default hr_api.g_number,
160   p_booking_deal_id              in number           default hr_api.g_number,
161   p_booking_id                   in number           default hr_api.g_number,
162   p_resource_allocation_id       in number           default hr_api.g_number,
163   p_resource_booking_id          in number           default hr_api.g_number,
164   p_tfl_information_category     in varchar2         default hr_api.g_varchar2,
165   p_tfl_information1             in varchar2         default hr_api.g_varchar2,
166   p_tfl_information2             in varchar2         default hr_api.g_varchar2,
167   p_tfl_information3             in varchar2         default hr_api.g_varchar2,
168   p_tfl_information4             in varchar2         default hr_api.g_varchar2,
169   p_tfl_information5             in varchar2         default hr_api.g_varchar2,
170   p_tfl_information6             in varchar2         default hr_api.g_varchar2,
171   p_tfl_information7             in varchar2         default hr_api.g_varchar2,
172   p_tfl_information8             in varchar2         default hr_api.g_varchar2,
173   p_tfl_information9             in varchar2         default hr_api.g_varchar2,
174   p_tfl_information10            in varchar2         default hr_api.g_varchar2,
175   p_tfl_information11            in varchar2         default hr_api.g_varchar2,
176   p_tfl_information12            in varchar2         default hr_api.g_varchar2,
177   p_tfl_information13            in varchar2         default hr_api.g_varchar2,
178   p_tfl_information14            in varchar2         default hr_api.g_varchar2,
179   p_tfl_information15            in varchar2         default hr_api.g_varchar2,
180   p_tfl_information16            in varchar2         default hr_api.g_varchar2,
181   p_tfl_information17            in varchar2         default hr_api.g_varchar2,
182   p_tfl_information18            in varchar2         default hr_api.g_varchar2,
183   p_tfl_information19            in varchar2         default hr_api.g_varchar2,
184   p_tfl_information20            in varchar2         default hr_api.g_varchar2,
185   p_validate                     in boolean          default false,
186   p_transaction_type             in varchar2
187   );
188 --
189 end ota_tfl_api_upd;