DBA Data[Home] [Help]

PACKAGE: APPS.AME_CNU_UPD

Source


1 Package ame_cnu_upd as
2 /* $Header: amcnurhi.pkh 120.0 2005/09/02 03:55 mbocutt 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 raised.
50 --
51 -- Developer Implementation Notes:
52 --   None.
53 --
54 -- Access Status:
55 --   Internal Development Use Only.
56 --
57 -- ----------------------------------------------------------------------------
58 Procedure upd
59   (p_effective_date in     date
60   ,p_datetrack_mode in     varchar2
61   ,p_rec            in out nocopy ame_cnu_shd.g_rec_type
62   );
63 --
64 -- ----------------------------------------------------------------------------
65 -- |-------------------------------< upd >------------------------------------|
66 -- ----------------------------------------------------------------------------
67 -- {Start Of Comments}
68 --
69 -- Description:
70 --   This procedure is the attribute interface for the datetrack update
71 --   process for the specified entity and is the outermost layer.
72 --   The role of this process is to update a fully validated row into the
73 --   HR schema passing back to the calling process, any system generated
74 --   values (e.g. object version number attributes). The processing of this
75 --   procedure is as follows:
76 --   1) The attributes are converted into a local record structure by
77 --      calling the convert_args function.
78 --   2) After the conversion has taken place, the corresponding record upd
79 --      interface process is executed.
80 --   3) OUT parameters are then set to their corresponding record attributes.
81 --
82 -- Prerequisites:
83 --
84 -- In Parameters:
85 --   p_effective_date
86 --     Specifies the date of the datetrack update operation.
87 --   p_datetrack_mode
88 --     Determines the datetrack update mode.
89 --
90 -- Post Success:
91 --   A fully validated row will be updated for the specified entity
92 --   without being committed.
93 --
94 -- Post Failure:
95 --   If an error has occurred, an error message will be raised.
96 --
97 -- Developer Implementation Notes:
98 --   None.
99 --
100 -- Access Status:
101 --   Internal Development Use Only.
102 --
103 -- {End Of Comments}
104 -- ----------------------------------------------------------------------------
105 Procedure upd
106   (p_effective_date               in     date
107   ,p_datetrack_mode               in     varchar2
108   ,p_rule_id                      in     number
109   ,p_condition_id                 in     number
110   ,p_object_version_number        in out nocopy number
111   ,p_security_group_id            in     number    default hr_api.g_number
112   ,p_start_date                   in out nocopy date
113   ,p_end_date                     in out nocopy date
114   );
115 --
116 end ame_cnu_upd;