UPDATE_PERSON_ADDRESS API errors – spec differs! Need Example!

Question

Hi all,
I’ve tried loading a hard-coded example of following 4 API’s but have not succeeded with any of them. I need an example of how these are supposed to work. Eventually, I want to have 1 PLSQL script that includes:
1 of..
update_person_address or
update_gb_person_address or
cre_or_upd_person_address or
update_pers_addr_with_style together with..
Hr_Assignment_Api.update_emp_asg and
Hr_Assignment_Api.update_emp_asg_criteria
(which both work because I’ve already got a working process setup..)
What I’ve found is the spec I’m using..
(taken from CREATE OR REPLACE PACKAGE Hr_Person_Address_Api AUTHID CURRENT_USER AS/* $Header: peaddapi.pkh 115.27 2004/04/04 20:24:19 tpapired ship $ */ )
..has notes that don’t make sense with the comments section (eg. update_person_address) does not contain all the fields that you use in the actual procedure – no wonder Im getting a ‘PLS-00306: wrong number or types of arguments in call to 'UPDATE_PERSON_ADDRESS'’ error message!
Another example is that ‘p_style’ relates somehow to regions but in abosve API there’s no ‘p_style’ parameter which makes me think do you have to use the update_pers_addr_with_style API with it?
My non-working example looks like:
/* Formatted on 2009/03/26 15:39 (Formatter Plus v4.8.7) */
SET serveroutput ON SIZE 1000000 FORMAT WRAPPED
SET verify OFF
SET feedback OFF
DECLARE
   l_validate           BOOLEAN        DEFAULT FALSE;
   l_effective_date     DATE        := TO_DATE ('16-MAR-2009', 'DD-MON-YYYY');
   l_validate_county    BOOLEAN      DEFAULT FALSE;
   ip_p_address_id      NUMBER         := 28626;
   l_obj                NUMBER;
   l_date_from          DATE        := TO_DATE ('17-FEB-2009', 'DD-MON-YYYY');
   l_date_to            DATE        := TO_DATE ('17-FEB-2059', 'DD-MON-YYYY');
   l_person_id          NUMBER         := 29588;
   l_address_line1      VARCHAR2 (100) := '2 FeatherHill Drive';
   l_address_line2      VARCHAR2 (100) := 'East Clackton';
   l_address_line3      VARCHAR2 (100) := 'Shrops.';
   l_address_line4      VARCHAR2 (100) := 'Inverness';
   l_postcode           VARCHAR2 (30)  := 'SL3 3RT';
   --  l_country              VARCHAR2 (100) := 'GB';
   l_telephone_number   VARCHAR2 (25)  := '0191 111 3478';
    l_party_id           NUMBER;
    l_region_1  VARCHAR2 (25)  := 'DUR';
      l_no_managers_warning            BOOLEAN;
      l_other_manager_warning          BOOLEAN;
      l_assignment_id                  NUMBER         := 29547;
      l_supervisor_id                  NUMBER         := 27928;
      l_default_code_comb_id           NUMBER         := 61635;
   --   l_default_code_comb_id           NUMBER         := 217509;
      l_datetrack_update_mode          VARCHAR2 (30)  := 'UPDATE';
      --  l_datetrack_update_mode          VARCHAR2 (30)  := 'CORRECTION';
      l_organization_id                NUMBER         := 0;
      l_concatenated_segments          VARCHAR2 (240);
      l_soft_coding_keyflex_id         NUMBER;
      l_comment_id                     NUMBER;
      l_people_group_id                NUMBER;
      l_special_ceiling_step_id        NUMBER;
      l_location_id                    NUMBER         := 175;
      l_job_id                         NUMBER         := 7;
      l_position_id                    NUMBER         := 252;
      l_group_name                     VARCHAR2 (30);
      l_org_now_no_manager_warning     BOOLEAN;
      l_spp_delete_warning             BOOLEAN;
      l_entries_changed_warning        VARCHAR2 (30);
      l_tax_district_changed_warning   BOOLEAN;
      l_style                          VARCHAR2 (4)   := 'GB';
   CURSOR csr_ovn
   IS
      SELECT MAX (padd.object_version_number)
        FROM per_addresses padd, per_all_people_f per
       WHERE padd.person_id = per.person_id AND per.person_id = '29588';
BEGIN
   DBMS_OUTPUT.PUT_LINE ('######################################');
   DBMS_OUTPUT.PUT_LINE ('UPDATE of EXISTING Employees Details..');
   DBMS_OUTPUT.PUT_LINE ('#######################################');
   OPEN csr_ovn;
   FETCH csr_ovn
    INTO l_obj;
   CLOSE csr_ovn;
   Hr_Person_Address_Api.update_person_address
                             (p_validate              => l_validate,
                              p_effective_date         => l_effective_date,
                              p_validate_county            => l_validate_county,
                              p_address_id                 => ip_p_address_id,
                              p_object_version_number      => l_obj,
                              p_date_from                  => l_date_from,
                              p_date_to                    => l_date_to,
                              p_person_id                  => l_person_id,
--   p_primary_flag    => 'N',
                              p_address_type               => NULL,
                              p_comments                   => NULL,
                              p_address_line1              => l_address_line1,
                              p_address_line2              => l_address_line2,
                              p_address_line3              => l_address_line3,
                              p_town_or_city               => NULL,
                              p_region_1          => l_region_1, --NULL,
                              p_region_2                   => NULL,
                              p_region_3                   => NULL,
                              p_postal_code                => l_postcode,
                              p_country                    => l_address_line4,
                              p_telephone_number_1         => l_telephone_number,
                              p_telephone_number_2         => NULL,
--  p_telephone_number_3           => NULL,
  ,p_addr_attribute_category       IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute1               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute2               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute3               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute4               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute5               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute6               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute7               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute8               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute9               IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute10              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute11              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute12              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute13              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute14              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute15              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute16              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute17              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute18              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute19              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_addr_attribute20              IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information13             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information14             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information15             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information16             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information17             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information18             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information19             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2
  ,p_add_information20             IN     VARCHAR2 DEFAULT Hr_Api.g_varchar2 */
                              p_party_id                   => l_party_id
   COMMIT;
EXCEPTION
   WHEN OTHERS
   THEN
      RAISE NO_DATA_FOUND;
--      DBMS_OUTPUT.PUT_LINE (   '..and failure looks like..: ' || SQLERRM );
END;
COMMIT ;
EXIT;Please provide a working example of how this API is used.
Many thanks
Steven

Answer 1

hi,
Ran your code with some minor tweaks on my instance and it works !! Find below the code that I ran.
Cheers
DECLARE
l_validate BOOLEAN DEFAULT FALSE;
l_effective_date DATE;-- := TO_DATE ('16-MAR-2009', 'DD-MON-YYYY');
l_validate_county BOOLEAN DEFAULT TRUE;
ip_p_address_id NUMBER := 19990;
l_obj NUMBER;
l_date_from DATE;-- := TO_DATE ('17-FEB-2009', 'DD-MON-YYYY');
l_date_to DATE;-- := TO_DATE ('17-FEB-2059', 'DD-MON-YYYY');
l_person_id NUMBER := 2257;
l_address_line1 VARCHAR2 (100) := '2 FeatherHill Drive';
l_address_line2 VARCHAR2 (100) := 'East Clackton';
l_address_line3 VARCHAR2 (100) := 'Shrops.';
l_address_line4 VARCHAR2 (100) := 'Inverness';
l_postcode VARCHAR2 (30) := 'SL3 3RT';
l_country VARCHAR2 (100) := 'GB';
l_telephone_number VARCHAR2 (25) := '0191 111 3478';
l_party_id NUMBER;
l_region_1 VARCHAR2 (25) := 'DUR';
l_no_managers_warning BOOLEAN;
l_other_manager_warning BOOLEAN;
l_assignment_id NUMBER := 2297;
l_supervisor_id NUMBER := 47470;
l_default_code_comb_id NUMBER := 248531;
-- l_default_code_comb_id NUMBER := 217509;
l_datetrack_update_mode VARCHAR2 (30) := 'UPDATE';
-- l_datetrack_update_mode VARCHAR2 (30) := 'CORRECTION';
l_organization_id NUMBER := 81;
l_concatenated_segments VARCHAR2 (240);
l_soft_coding_keyflex_id NUMBER;
l_comment_id NUMBER;
l_people_group_id NUMBER;
l_special_ceiling_step_id NUMBER;
l_location_id NUMBER := 9527;
l_job_id NUMBER := 2035;
l_position_id NUMBER := null;
l_group_name VARCHAR2 (30);
l_org_now_no_manager_warning BOOLEAN;
l_spp_delete_warning BOOLEAN;
l_entries_changed_warning VARCHAR2 (30);
l_tax_district_changed_warning BOOLEAN;*/
l_style VARCHAR2 (4) := 'GB';
CURSOR csr_ovn
IS
SELECT MAX (padd.object_version_number)
FROM per_addresses padd, per_all_people_f per
WHERE padd.person_id = per.person_id AND per.person_id = 2257;
BEGIN
DBMS_OUTPUT.PUT_LINE ('######################################');
DBMS_OUTPUT.PUT_LINE ('UPDATE of EXISTING Employees Details..');
DBMS_OUTPUT.PUT_LINE ('#######################################');
OPEN csr_ovn;
FETCH csr_ovn
INTO l_obj;
CLOSE csr_ovn;
Hr_Person_Address_Api.update_person_address
(p_validate => l_validate,
p_effective_date => sysdate,
p_validate_county => l_validate_county,
p_address_id => ip_p_address_id,
p_object_version_number => l_obj,
p_date_from => sysdate,
p_date_to => l_date_to,
/*p_person_id => l_person_id,
p_primary_flag => 'Y',
p_address_type => 'PHCA',
p_comments => NULL,*/
p_address_line1 => l_address_line1,
p_address_line2 => l_address_line2,
p_address_line3 => l_address_line3,
p_town_or_city => NULL,
p_region_1 => l_region_1, --NULL,
p_region_2 => NULL,
p_region_3 => NULL,
p_postal_code => l_postcode,
p_country => l_address_line4,
p_telephone_number_1 => l_telephone_number,
p_telephone_number_2 => NULL,
p_telephone_number_3 => NULL
/* ,p_addr_attribute_category => NULL
,p_addr_attribute1 => NULL
,p_addr_attribute2 => NULL
,p_addr_attribute3 => NULL
,p_addr_attribute4 => NULL
,p_addr_attribute5 => NULL
,p_addr_attribute6 => NULL
,p_addr_attribute7 => NULL
,p_addr_attribute8 => NULL
,p_addr_attribute9 => NULL
,p_addr_attribute10 => NULL
,p_addr_attribute11 => NULL
,p_addr_attribute12 => NULL
,p_addr_attribute13 => NULL
,p_addr_attribute14 => NULL
,p_addr_attribute15 => NULL
,p_addr_attribute16 => NULL
,p_addr_attribute17 => NULL
,p_addr_attribute18 => NULL
,p_addr_attribute19 => NULL
,p_addr_attribute20 => NULL
,p_add_information13 => NULL
,p_add_information14 => NULL
,p_add_information15 => NULL
,p_add_information16 => NULL
,p_add_information17 => NULL
,p_add_information18 => NULL
,p_add_information19 => NULL
,p_add_information20 => NULL*/
-- ,p_party_id => 8246
COMMIT;
EXCEPTION
WHEN OTHERS
THEN
RAISE NO_DATA_FOUND;
DBMS_OUTPUT.PUT_LINE ( '..and failure looks like..: ' || SQLERRM );
END;
COMMIT ;
EXIT;