DBA Data[Home] [Help]

PACKAGE: APPS.BEN_PEI_UPD

Source


1 Package ben_pei_upd as
2 /* $Header: bepeirhi.pkh 120.0 2005/05/28 10:33:59 appldev noship $ */
3 --
4 -- ----------------------------------------------------------------------------
5 -- |---------------------------------< upd >----------------------------------|
6 -- ----------------------------------------------------------------------------
7 -- {Start Of Comments}
8 --
9 -- Description:
10 --   This procedure is the record interface for the update
11 --   process for the specified entity. The role of this process is
12 --   to perform the datetrack update mode, fully validating the row
13 --   for the HR schema passing back to the calling process, any system
14 --   generated values (e.g. object version number attribute). This process
15 --   is the main backbone of the upd process. The processing of
16 --   this procedure is as follows:
17 --   1) Ensure that the datetrack update mode is valid.
18 --   2) The row to be updated is then locked and selected into the record
19 --      structure g_old_rec.
20 --   3) Because on update parameters which are not part of the update do not
21 --      have to be defaulted, we need to build up the updated row by
22 --      converting any system defaulted parameters to their corresponding
23 --      value.
24 --   4) The controlling validation process update_validate is then executed
25 --      which will execute all private and public validation business rule
26 --      processes.
27 --   5) The pre_update process is then executed which enables any
28 --      logic to be processed before the update dml process is executed.
29 --   6) The update_dml process will physical perform the update dml into the
30 --      specified entity.
31 --   7) The post_update process is then executed which enables any
32 --      logic to be processed after the update dml process.
33 --
34 -- Prerequisites:
35 --   The main parameters to the process have to be in the record
36 --   format.
37 --
38 -- In Parameters:
39 --   p_effective_date
40 --     Specifies the date of the datetrack update operation.
41 --   p_datetrack_mode
42 --     Determines the datetrack update mode.
43 --
44 -- Post Success:
45 --   The specified row will be fully validated and datetracked updated for
46 --   the specified entity without being committed for the datetrack mode.
47 --
48 -- Post Failure:
49 --   If an error has occurred, an error message will be supplied with the work
50 --   rolled back.
51 --
52 -- Developer Implementation Notes:
53 --   None.
54 --
55 -- Access Status:
56 --   Internal Development Use Only.
57 --
58 -- {End Of Comments}
59 -- ----------------------------------------------------------------------------
60 Procedure upd
61   (
62   p_rec			in out nocopy 	ben_pei_shd.g_rec_type,
63   p_effective_date	in 	date,
64   p_datetrack_mode	in 	varchar2
65   );
66 --
67 -- ----------------------------------------------------------------------------
68 -- |---------------------------------< upd >----------------------------------|
69 -- ----------------------------------------------------------------------------
70 -- {Start Of Comments}
71 --
72 -- Description:
73 --   This procedure is the attribute interface for the datetrack update
74 --   process for the specified entity and is the outermost layer.
75 --   The role of this process is to update a fully validated row into the
76 --   HR schema passing back to the calling process, any system generated
77 --   values (e.g. object version number attributes). The processing of this
78 --   procedure is as follows:
79 --   1) The attributes are converted into a local record structure by
80 --      calling the convert_args function.
81 --   2) After the conversion has taken place, the corresponding record upd
82 --      interface process is executed.
83 --   3) OUT parameters are then set to their corresponding record attributes.
84 --
85 -- Prerequisites:
86 --
87 -- In Parameters:
88 --   p_effective_date
89 --     Specifies the date of the datetrack update operation.
90 --   p_datetrack_mode
91 --     Determines the datetrack update mode.
92 --
93 -- Post Success:
94 --   A fully validated row will be updated for the specified entity
95 --   without being committed.
96 --
97 -- Post Failure:
98 --   If an error has occurred, an error message will be supplied with the work
99 --   rolled back.
100 --
101 -- Developer Implementation Notes:
102 --   None.
103 --
104 -- Access Status:
105 --   Internal Development Use Only.
106 --
107 -- {End Of Comments}
108 -- ----------------------------------------------------------------------------
109 Procedure upd
110         (
111          p_pl_extract_identifier_id    in  number,
112          p_effective_start_date        out nocopy date,
113          p_effective_end_date          out nocopy date,
114          p_pl_id                       in  number    default hr_api.g_number,
115          p_plip_id                     in  number    default hr_api.g_number,
116          p_oipl_id                     in  number    default hr_api.g_number,
117          p_third_party_identifier      in  varchar2  default hr_api.g_varchar2,
118          p_organization_id             in  number    default hr_api.g_number,
119          p_job_id                      in  number    default hr_api.g_number,
120          p_position_id                 in  number    default hr_api.g_number,
121          p_people_group_id             in  number    default hr_api.g_number,
122          p_grade_id                    in  number    default hr_api.g_number,
123          p_payroll_id                  in  number    default hr_api.g_number,
124          p_home_state                  in  varchar2  default hr_api.g_varchar2,
125          p_home_zip                    in  varchar2  default hr_api.g_varchar2,
126          p_business_group_id           in  number    default hr_api.g_number,
127          p_object_version_number       in  out nocopy number,
128          p_effective_date              in  date,
129          p_datetrack_mode	       in  varchar2
130         );
131 --
132 end ben_pei_upd;