Data Conversion from 4.0B to 4.5A for Dangerous Goods Management 

Description

This release note describes the conversion of application and Customizing tables for dangerous goods master data as regards the change from Release 4.0B to 4.5A.

The Dangerous goods regulation field has been included in the key for maintaining data in the whole dangerous goods system. For this reason, the existing key fields "mode of transport category" and "validity area" are no longer required in the Customizing data for application data or "mode of transport category".

Reasons for the Conversion

The conversion was made as dangerous goods data can be maintained more exactly and easily using dangerous goods regulations instead of mode of transport categories and validity areas. Entries such as mode of transport category 'inland waterway' and validity area 'world' are included directly when you create data records with dangerous goods regulations.

Realization

Changes have thus been made to structures, Customizing and application tables. For this reason you must convert the contents of these tables if you used dangerous goods management in a productive system for 4.0A/B or if you want to prepare for your productive system using existing master data and Customizing table entries.

The relationships between the old keys and new keys have been stored in a central Customizing table Dangerous goods regulation (THM063). For integrity purposes, a 1:1 relationship is required between this objects. Two or more "subregulations" must be maintained for regulations that refer to more than one mode of transport type, such as IATA or CFR. This is because their contents are different as regards the individual modes of transport.

As you will probably have to intervene in the conversion process, we made sure that no XPRAs are included. The contents of the Customizing tables are not converted within the tables. Instead, new entities are created and are filled using the old data. You do not have to fill the entities as soon as you change to Release 4.5A; this can also be done at a later date. The conversion must be carried out for productive systems.

Overall process

Data conversion is necessary for the new structures for the dangerous goods master and Customizing tables. A key change for the dangerous goods master (DGTMD) and the Customizing tables is supported. The entities are created in accordance with the dangerous goods regulation (and other possible attributes) and no longer in accordance with the mode of transport type and/or the validity area.

Virtually all Customizing tables for the dangerous goods master are affected by the conversion. Instead of renaming the old Customizing tables, new tables have been created and the old tables will not be used actively in future. An automatic XPRA is therefore not required. Instead, reports are made available for both the areas mentioned above, thereby providing a consistent database.

It is essential that dangerous goods regulations are allocated to mode of transport categories and validity areas. Before conversion, an appropriate table must be constructed using existing data. The table can also be maintained manually at a later stage. There are eight steps in the process:

Construction of Customizing Table for Dangerous Goods Regulations (THM063):

Step 1: Convert the old table for dangerous goods data (TDG63).
Step 2: Check the dangerous goods regulations table and maintain data if required.

Construction of Application Table for Dangerous Goods Material Master Data (DGTMD):

Step 3: Check to see whether you can convert the dangerous goods material master data (DGTMD) at a later stage.
Step 4: Convert table for dangerous goods material master data (DGTMD).

Construction of Regulation-Dependent Customizing Tables:

Step 5: Convert regulation-dependent Customizing tables.
Step 6: Check and maintain regulation-dependent Customizing tables.

Check Referential Integrity:

Step 7: Check and maintain dangerous goods master (DGTMD).
Step 8: Automatic check for referential integrity.

The steps must be carried out in the order given. However, after each step, you can restart the process in one of the previous steps. For example, you may be required to branch once more to dangerous goods regulation maintenance (THM063) (2) after checking the conversion of the dangerous goods material master (DGTMD) (3). You may also have to check and maintain Customizing (6) or master data (7) after you have checked the referential integrity (8).

Step 1 - Convert old tables for dangerous goods regulations (TDG63)

You may not need to carry out this step if little or no data has been maintained in the "Derivations of Regulations" table (TDG63), for example. The following example shows how the data is converted. In the last data record, you can see which overlaps can occur.

Source: TDG63 Target: THM063

MTransCat V.Area DGReg. DGReg. MTransCat V.Area
01 EU ADR ADR 01 EU
01 DE GGVS
GGVS 01 DE
01 USA CFR CFR 01 USA
02 EU RID RID 02 EU
02 DE GGVE GGVE 02 DE
02 USA CFR CFR 02 USA

Data conflicts if there is an n:1 relationship between mode of transport category - validity area combinations and dangerous goods regulations, and not a 1:1 relationship. This can be seen in the example of the CFR regulation. In this case you must maintain the data. This is also necessary if not all of the combinations of mode of transport category and validity area that were used previously have been maintained in table TDG63.

Activities

    1. Call transaction DGU1.
    2. Set the "Conversion" indicator. If you set the "deletion of existing entries" indicator, existing entries in the target table will be deleted.
    3. Carry out the transaction by choosing "Execute" or "F8".

Step 2 - Check the table for dangerous goods regulations and maintain if necessary

The data in the dangerous goods regulation table (THM063) is used for converting the dangerous goods material master and the remaining Customizing tables that are dependent on the mode of transport category at a later stage. You must make sure that a secondary key is clearly defined for the mode of transport category/validity area combination. A 1:1 relationship is thus created between this combination and a dangerous goods regulation. In the following example, the new entries are shown in a different colour. The entries with dangerous goods regulation CFR were deleted and two new entries adopted.

THM063 Dangerous goods regulation

DGReg. Cat V.Area
ADR 01 EU
GGVS 01 DE
RID 02 EU
GGVE 02 DE
CFR_1
01 USA
CFR_2 02 USA

Activities

Call the IMG activity

Define dangerous goods regulations .

Step 3 - Check subsequent conversion of dangerous goods master data (DGTMD)

Errors may occur during the conversion of DGTMD and therefore you should check the THM063 table and edit it as required (step 2).

In this step, you can use a check routine to find out whether a conversion will run successfully. If so, the data can be actually converted in step 4.

If not, you must adapt the table THM063 (step 2) or dangerous goods master (DGTMD).

  • If the combination of mode of transport category and validity area is part of a dangerous goods regulation, then you must also adopt this in the THM063 table.
  • If this combination does not form part of a dangerous goods regulation, you must check whether the entry should be made in the dangerous goods master table (DGTMD).

Activities

    1. Call the transaction DGUD.
    2. Do not change the "Check for consistency" indicator.
    3. Carry out the transaction by choosing "Execute" or "F8".

Step 4 - Convert dangerous goods master data (DGTMD)

In carrying out the conversion, the system overwrites the old contents of the fields in the DG Regulation column with the entries in table THM063. In the following example, the changed field contents are represented differently:

DGTMD (before)

Material MTransCat V.Area DGReg.
4711 01 EU ADR
4711 01 EU
4712 01 DE
GGVS
4712 01 DE ADR
4712 02 EU
4712 02 DE GGVE
4715 01 USA CFR
4715 02 USA

DGTMD (after)

Material DGReg. MTransCat V.Area
4711 ADR 01 EU
4711 ADR 01 EU

4712 GGVS 01 DE
4712 GGVS 01 DE
4712 RID 02
4712 GGVE 02 DE
4715 CFR_1 01 USA
4715 CFR_2 02 USA

It may be that a conversion in the table DGTMD is not possible due to the contents of table THM063. This is the case if a combination of mode of transport category and validity area from the DGTMD does not exist in the THM063 table. If this is the case, you must maintain the entries in the THM063 table. As the system uses this data for converting the Customizing tables (step 5) you must adhere strictly to the existing sequence of data.

Activities

    1. Call transaction DGUM.

Step 5 - Convert regulation-dependent Customizing tables

Finally, the following Customizing tables must be converted:
* Transport Categories (TDG03/04),
* Dangerous Goods Classes (TDG09/10),
* Dangerous Goods Letters (TDG11/12),
* Danger Labels (TDG17/18)
* Hazard Identification Numbers (TDG31/32)

All the above-mentioned tables are converted using the dangerous goods master data. The following table contents of the DGTMD are adopted for transport categories and hazard identification numbers in the examples as described below:

DGTMD

Material DGReg. MTransCat V.Area TransCat1 TransCat2 HazIDNo.
4711 ADR 01 EU 2 22
4711 ADR 01
EU 2 1 23
4712 GGVS 01 DE 2 4 223
4712 GGVS 01 DE 1 22
4712 RID 02 EU 1 3 22
4712 GGVE 02 DE 3 224
4715 CFR_1 01 USA 2 22
4715 CFR_2 02 USA 2

The following example shows conversion using transport classifications (TDG03/04). The example applies to this view only. Only the tables are converted.

TDG03/04 THM003/004
MTransCat TransCat Description DGReg. TransCat Description
01 1 tank ADR 1 tank
01 2 packaged
GGVS 1 tank
02 1 tank ADR 2 packaged
02 3 in bulk GGVS 2 packaged
02 4 in containers CFR_1 2 packaged
RID 1 tank
RID 3 in bulk
GGVE 3 in bulk

The conversion report can be called again at any time as the old data still exists in the system as before. You should delete the entries in the target tables before restarting the system. This function is available as an option (indicator) in the reports.

In the following example, the last entry in the TDG03/04 tables is not converted as it is not used anywhere in DGTMD. You are informed of this in the log. The system was also unable to convert transport category 4 to mode of transport category 01, or to convert 2 to 02. This is because they did not exist in the original table. The reason for this was inconsistency in the original data that was, for example, caused by deleting Customizing entries. Errors like these also appear in the log.

The hazard identification number table cannot access mode of transport categories as key fields. The following example shows the process using the ADR and GGVS regulations:

TDG31/32 THM031/032
HazIDNo Description DGReg. HazIDNo. Description
20 inert gas ADR 22 refrigerated gas
22
refrigerated gas GGVS 22 refrigerated gas
223 refriger. combust gas. RID 22 refrigerated gas
23 combustible gas CFR_1 22 refrigerated gas
GGVS 223 refrigerated gas
ADR 23 combustible gas
CFR_2 23 combustible gas

Also in this example the system could not convert an entry (hazard identification number 20) as it was not used in the dangerous goods master (DGTMD). Hazard identification number 224 (for GGVE) could also not be converted as it did not exist in the Customizing table. Corresponding messages appear in the log.

Activities

    1. Call transaction DGU0.
    2. Depending on which table you want to convert, set the indicator for:
    • Transport categories
    • Dangerous goods classes and letters
    • Danger labels
    • Hazard identification numbers
    3. In addition, flag the target tables in which you first want to delete all existing entries.
    4. Carry out the transaction by choosing "Execute" or "F8".

Step 6 - Check and maintain regulation-dependent Customizing tables

The generated contents of the Customizing tables are produced using application table DGTMD. As the data here has mostly been maintained using the mode of transport categories, it can be the case that in the previous step, entries were generated that are not valid with regard to dangerous goods laws. These entries must be deleted in this step.

Furthermore in this step, you should check and maintain Customizing in general. If the generated entries differ greatly from your expectations you can revise the application table in step 7 and then convert the Customizing tables again in step 5.

Activities

Call the following IMG activities:

Step 7 - Check and maintain dangerous goods master (DGTMD)

In this step you should delete or change all entries in the dangerous goods master that are incorrect for dangerous goods. This affects entries for which entries were first generated in Customizing (step 5) and then deleted (step 6). For this, you may be required to find the affected data records (using SE16) and either change or delete these online.

Step 8 - Automatic Check for referential integrity

Referential integrity between the converted data (Customizing and application) is vital. You do this by carrying out a report. This check, and the check for correctness in the THM063 data records (step 3) are carried out in a report. You can use settings on the selection screen in this report to decide which checks are to be carried out.

Activities

    1. Call transaction DGUC.
    2. Do not change the "Check for ref. integrity" indicator.
    3. Flag the Customizing tables that you want to check.
    4. Carry out the transaction by choosing "Execute" or "F8".