Kontakt

Ansicht
Dokumentation

/SAPCE/IUTR_MUN_VILL_CHANGE - Change Municipality/Village Properties

/SAPCE/IUTR_MUN_VILL_CHANGE - Change Municipality/Village Properties

PERFORM Short Reference   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

You use this function module to change the properties of a municipality/village such as the name, the type or code of the municipality/village as well as its assignment to township, country and city (note that, in Turkey, you use the city code to identify the province). The function module makes these changes in the /SAPCE/IUTR_MV table and, in the case of municipality/village names, in the /SAPCE/IUTR_MVTX table.

You specify the parameters as follows:

  • The existing properties of the municipality/village in the following import parameters:
  • IV_COUNTRY

  • IV_CITY_CODE

  • IV_COUNTY_CODE

  • IV_TOWNSHIP_CODE

  • IV_MUNVILL_CODE

So that the system can identify the municipality/village that you want to change, specifying values for the above parameters is mandatory.
  • The properties with which you want to replace existing properties in the corresponding fields of the IS_MUNVILL and IV_MUNVILL_TYPE import parameters
  • If you want to change the name of a municipality/village, you must also specify the corresponding language key in the IV_SPRAS import parameter structure.
Note, the system uses only the language key that you define in this parameter. It does not use any language keys that you specify in the IS_MUNVILL-SPARS parameter.

The return value of the EV_DB_UPDATE export parameter indicates whether the function module has run successfully:

  • 'X' ,,Successful run
  • No value,,No entries have been created in the address database

Example

The examples below illustrate how you can use this function module to change the properties of a municipality/village entry:

  • You want to reassign the municipality/village to a different township, county and city
In addition to the mandatory import parameters, you specify the new city, county and township codes in the IS_MUNVILL import parameter structure.
The system changes the city, county and township assignments for the given municipality/village in the /SAPCE/IUTR_MV and the /SAPCE/IUTR_MVTX tables to the new values.
  • You want to change the type and name of a municipality/village in a given language:
In addition to the mandatory import parameters, you also specify the following data:
  • A municipality/village type in the IV_MUNVILL_TYPE import parameter

  • A language key in the IV_SPRAS parameter

  • A new municipality/village name in the TOWNSHIP_NAME parameter field of the IS_MUNVILL import parameter structure

The system changes the municipality/village type in the /SAPCE/IUTR_MV table and the name of the municipality/village in the /SAPCE/IUTR_MVTX table in the specified language
  • You want to complete the following steps in a single run:
  • Reassign the municipality/village to a different township, county and city

  • Change the name of the municipality/village in a given language

  • Change the municipality/village type

In addition to the mandatory import parameters, you also specify a new city code, county code, township code and a language key in the IS_MUNVILL parameter structure. The system makes the following changes:
  • Changes the city, county and township assignments for the given municipality/village in the /SAPCE/IUTR_MV and /SAPCE/IUTR_MVTX tables

  • Changes the municipality/village type in the /SAPCE/IUTR_MV table

  • Changes the municipality/village name in the /SAPCE/IUTR_MVTX table in the specified language

Notes

Further information





Parameters

EV_DB_UPDATE
IS_MUNVILL
IV_CITY_CODE
IV_COUNTRY
IV_COUNTY_CODE
IV_MUNVILL_CODE
IV_MUNVILL_TYPE
IV_SPRAS
IV_TOWNSHIP_CODE

Exceptions

GENERAL_FAULT
INPUT_ERROR

Function Group

CE/SAPLIUTR_ADDRESS_UPDATE

Addresses (Business Address Services)   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.

Length: 5160 Date: 20240426 Time: 132614     sap01-206 ( 63 ms )