Sie sind auf Seite 1von 144

Configuration - SAP Dangerous Goods Management (DGM)

Specify Environment Parameters


Use

In this Customizing activity, you specify environment parameters that control the processes within the SAP Environment, Health and Safety
component.

General Environment Parameters:

Environmental parameter Description

ALE_PHR_SINGLE_DIST Individual distribution of phrases

ALE_REP_DOCMAS_WAIT Wait time in seconds for DOCMAS distribution

ALE_SERIAL_ID Serialization number of the logical system

ALE_TRANSFER_LANGUAGE ALE transfer language

ARCHIV_CV_DVS_POST_LAST_DATE Time of the last run of the postprocessing program

Parameters for the extraction of specification management data into the Business
BW_*
Information Warehouse (SAP BW)

CD_PROTOCOL_SAVE_PERIOD Archiving time in months of the change documents

CD_PROTOCOL_START_DATE Start date of the change document creation

CD_PROTOCOL_START_TIME Start time of the change document creation

CD_NO_CHANGE_DOCS No change document creation

CD_NO_CHANGE_DOCS_AT_SPEC_PHRS No change document creation for specifications and phrases

CGSADM_GWY_AUTH_CHECK Authorization check of SAP gateway in EH&S service administration

CHANGE_AUTH_USAGE Intensified authorization check

CHANGE_NUMBER_CHECK_FUNC obsolete

DEST_SRE_DS Destination for connection between logistics and EH&S systems

EXPORT_CHARACTER_NORM Code page format of exported data

GEN_PHRASE_SORT_ORDER Phrase sorting

IMPEXP_FLG_DELETE_PHYSICAL Specification import deletes physically

Page 1 of 144
IMPORT_CHECK_PROT_EXPIRE_DAYS Number of days after which the import check log is deleted

INH_BACKGROUND_START_CONDITION Inheritance in the background starting from the number

INH_JOB_DELAY Time period to restart of inheritance

INH_RESOLVE_STATUS_CONFLICT Consideration of the status during inheritance

LONGTEXT_FORMAT_SUPPORT Transfer of the formatting from fields with long text function

MULTI_CODEPAGE_SUPPORT Conversion by EH&S NLS

PERS_DATA_ADDRESS_SUBTYPE Info category-subcategory for reading address data for a person

PHRASE_SEE_FREETEXT Phrase key for see free text

QRY_CHECK_FUNC Function module to check search criteria

QRY_HITLIST_MAX_ENTRIES No. of hits for output in hit list when searching for specifications

RE_LAST_DOC_NUMBER Current generated number for export

RE_LAST_EXPORT Date of last export

Number of decimal places to be output (see the solution package for unit of
REP_DECIMAL_OUTPUT
measurement conversion)

REP_IC_NOCSUPDATE Deactivate Update of Instance Control

REP_IMPORT_OS_COMMAND Operating System Command for Report Import

REP_TS_SUPPORT Activate time-spot change marks

REPORT_DMS_SUPPORT Activate DMS access

SEARCH_INDICATOR_SHOW Display of search progress

SETGET_ARCHIVE_DAYS Number of days until the SET/GET memory is deleted

DOS key for XLS file for specification information system (see Set Up Excel
SIS_VALUAT_XLSFILE_DVSKEY
Connection)

SP_AUTH_CHECKS_WITH_SUBCAT Authorization objects with specification type are active

SP_COMPCAT_CONFIDENTIAL Confidential component type

SP_EXT_ECM_STATUS Enhanced program logic on the Status tab page with the use of change numbers

SP_NO_AUTH_CHCK_REF_PROPS Deactivation of authorization check for referenced value assignments

SP_NO_STATUS_LOGIC_AT_SPEC No status logic for specifications

Page 2 of 144
SP_SEARCH_START_ENTER Confirming starts the specification search

SP_WBSTACK_HIDE Workbench navigation stack retained

SP_WB_DATA_REFRESH_AT_SAVE Update of the data display during save

SRE_LY_REPEAT_UPLOAD No. of attempts to upload a template

SRE_WWI_CURSP WWI version on generation server

SUBCHAR_DEFAULT Default Value for the Substance Nature Field in the Specification Header

SUBINFOSYS_DEST RFC destination for the specification information system

SUB_RESTRICTED_AUTH Enhanced authorization check

VPB_CATALOG_CATPIN Key of the backup phrase library

VPB_CATALOG_PHRGRP Key of backup phrase group

Work directory to which documents are copied during secondary data determination (in
WWI_DATA_SERVER_ANCHOR
contrast to WWI server, generation occurs at the same time)

Indicator whether the EH&S workflow for specification management is active ( X or


WF_SUB_FLG_ACTIVE TRUE) or Not (<Empty> or FALSE) (see Check User Exit and Environment
Parameters)

Date in Format YYYYMMDD from which the EH&S workflow for specification
WF_SUB_DATE_FROM management takes data changes to specifications into account (see Check User Exit and
Environment Parameters)

Date in Format YYYYMMDD from which the EH&S workflow for specification
WF_SUB_TIME_FROM management takes data changes to specifications into account (see Check User Exit and
Environment Parameters)

WWI_GENSERVER_ERROR_MAIL Recipient for WWI Deactivation

WWI_GENSERVER_SYN_ANCHOR Temporary directory of the synchronous WWI server

WWI_GENSERVER_SYN_DEST RFC destination of synchronous WWI server

WWI_GENSERVER_SYN_WEB_APPL File type for synchronous WWI server

WWI_INSTALLATION WWI installation (frontend, WWI server)

WWI_IS_UNICODE WWI in Unicode mode

WWI_WEBGUI_MIME_TYPE MIME type of display in SAP GUI for HTML

WWILAYOUT_* Parameters for the settings for Windows Word-processor Integration (WWI)

Page 3 of 144
Environment parameters for the EH&S expert:

Environment Parameter Description

EXPERT_ADD_CALL_ATTEMPTS Additional RFC calls of EH&S expert

EXPERT_DEFAULT_DESTINATION Destination for EH&S expert calls

EXPERT_SECONDS_FOR_DELAY Wait time in seconds between RFC calls of EH&S expert

EXPERT_SUPPR_INFOMSG_IN _BACKGR Display only error messages and warning messages

Environment Parameters for the EH&S-QM Interface:

Environment Parameter Description

EHQMEP_CONTROLKEY Control key for operation

EHQMEP_DESCROPR Description of operation created in inspection plan

EHQMEP_LANGU Language for description of inspection characteristics

EHQMEP_NOTOKCODE Not-OK code

EHQMEP_PROFILE Profile with suggested values

Environment Parameters for Hazardous Substance Management:

Environment Parameter Description

HSM_DIST_BLOCK_SIZE Package size for the distribution of the hazardous substance master

HSM_DIST_LOG_TIME_TO_LIVE Validity period of entries in application log for hazardous substance distribution

HSM_FILL_LAST_DATE Date when the hazardous substance master was last filled

HSM_FILL_LAST_TIME Time when the hazardous substance master was last filled

IHS_HAZ_AMNT_DECOMP_SPEZ SARA: Expand hazardous substances into components

IHS_HAZ_AMNT_HAZARD_CAT_PROP SARA: Value assignment type for hazard classification

IHS_HAZ_AMNT_LAST_START SARA: Last run of the report REHS_HAZARD_AMNT_DET

IHS_HAZ_AMNT_VAL_ASSIGN_TYPE SARA: Value assignment type for component search

Environment Parameters for Product Safety:


Page 4 of 144
Environmental parameter Description

Note:
You can make settings for global label management in the Set Basic Data Customizing activity.

AVGEN_LAST_DATE Date when the worklist was last generated

AVGEN_SHOW_MSG Controls the display of additional generation messages

AVGEN_SPLIT Guide value for package size when generating worklist

JOB_PAST_DAYS Number of days after which the job log is deleted after generation

SRE_DES_SUBSEQ Date of last subsequent shipping

SRE_DS_CHECK_VALID Rating for the shipping check

SRE_DS_COMMIT Number of data records for update

SRE_DS_DELETE Days until shipping order is deleted

SRE_DS_DVS_DEL_PROG Program for deleting DMS documents

SRE_DS_LAST_REFRESH Date when the REFRESH program last ran

SRE_EXP_INITIATOR Initiator for the shipping order

SRE_MAIL_HEADER_PHRASE Phrase for the header line when sending an e-mail

SRE_MAIL_TEXT_PHRASE Mail text phrase for sending an e-mail

Date of last generation of subsequent shipping orders (analogous to


SUBSEQ_LAST_DATE
AVGEN_LAST_DATE)

REPINFOSYS_DEST RFC Destination for the report information system

REPORT_GENERATION_PROTOCOL Protocol for report generation is written

REPORTS_COMPARE_EXT File extension for comparing reports

SRE_DS_MAX_ROWS Maximum number of processed report shipping orders

SRE_DS_SAVE Days until shipping order is saved

SRE_DS_SDSREC Assignment of a function to MSDS contact persons

SRE_DS_SPLIT (Internal) guide value for job size when shipping

SRE_DS_TDID_DELPOS SAPscript ID for the accompanying text in a delivery

SRE_DS_TDID_ORDPOS SAPscript ID for the accompanying text in an order

Page 5 of 144
SRE_DS_TRACE_LEVEL Check level when sending a report

Note:
You can use the activity step Assign Selection Criteria for Environment Parameters in this Customizing activity. However, it is
only relevant in Product Safety for setting up the bill of material transfer (see Specify Environment Parameters and Conditions).

Environment Parameters for Substance Volume Tracking:

Environment Parameter Description

SVT_ARCHIVE_PLAN_DATA Archive planned quantities also

SVT_CLASS_PRAEFIX Prefix for classes in SVT

SVT_EHS_RFCDEST RFC destination for EHS

SVT_LOG_EXPIRY_TIME Time to expiration of application log

SVT_MATERIAL_CLASS Class for quantity relevance

SVT_NOTICHCK_PHR_BANNED Notification check status is not permitted

SVT_NOTICHCK_PHR_NOT_BANNED Notification check Status is permitted

SVT_NOTICHCK_PHR_NEG Notification check with negative status

SVT_NOTICHCK_PHR_POS Notification check with positive status

SVT_PHR_NEG With negative satus

SVT_PHR_POS With positive status

SVT_PHR_SPEEXCL_REG Filtering out specifications

SVT_PRO_PROFILE Status profiles for PP/PI order

SVT_PRO_STATUS User status, lock PP order / PI order

SVT_SO_PROFILE Status profiles sales order

SVT_SO_STATUS User profile, lock sales order

SVT_SUBID_F4_FUNC Module for input help for specifications

SVT_TOLERANCE_PRO Tolerance for production scenario

SVT_TRACKING_DIFF_TIME Time difference for substance volume tracking

SVT_TSCA_PHR_ANNUAL TSCA 12B: Annual registration

SVT_TSCA_PHR_ONE_TIME TSCA 12B: One-time registration

Page 6 of 144
SVT_PHR_POL_INDICAT Labeling of specifications as polymers

Environment Parameters for Dangerous Goods Management:

Environment Parameter Description

DG_DISTRIBUTION_CHANNEL Maximum number of channels

DG_DISTRIBUTION_PACK Package size for distribution

DG_DISTRIBUTION_SAVE IDoc transfer despite errors in the danger goods master records

DG_FILLING_PACK Package size for filling

DG_FILLING_PHRASE_GROUP Phrase group for filling

DG_FILL_EXIT_CHECK User eit for verification of filling and distribution

DG_PAPER_DEFAULT_TEXTPATTERN Default text phrase for delivery note

DG_SUPPRESS_PHR_CHECK Switch off phrase check

DG_UE_CHANGE_NR User exit for processing change number

DG_UE_DGTMD_DGTPK_ENTRIES User exit for DGTMD/DGTPK data records

DG_UE_MAT_FILL User exit for filling UN listed substance data

DG_EVAL_INHERIT_FOR_DELTAFILL Consideration of inheritance during filling

DG_FILL_REAL_REG_WITH_DIR_DGCL Filling of the real substance for direct classification

DG_UE_SUB_FILL obsolete

DG_UE_UN_FILL obsolete

Environment Parameters for Waste Management:

Environment Parameter Description

WAM_DOC_ALERTLIMIT Document search: Cancelation due to number of documents found

WAM_DOC_WARNLIMIT Document search: Warning due to number of documents found

WAM_EA_NO_ACC_CHECK No check for account assignment in disposal processing

WAM_ENTAM_FIELD1 Customer field 1 in disposal processing

WAM_ENTAM_FIELD2 Customer field 2 in disposal processing

Page 7 of 144
WAM_FUNC_BAL_BUILD Determination of disposal document data for waste life-cycle analysis

WAM_FUNC_BAL_CHECK Check of disposal document data for waste life-cycle analysis

WAM_MD_NO_ACC_CHECK No check for account assignment in master data

WAM_MD_NO_DOUBLE_ENTRY_CHECK No check of the integration object

WAM_MN_CONDTAB_LINES_MAX Document Search: Max. lines

WAM_PHRSET_WACATLG Phrase set for waste category

WAM_PROT_EXPIRE_DAYS_SE Application log: Number of days until expiration

WAM_PO_BAPI_USE_OLD Call old order BAPI in EHS-WA

WAM_TREE_ADRESS Name is not read from address

Environment Parameters for Industrial Hygiene and Safety:


Note:
Unless otherwise specified in the documentation for the environment parameters, you need only to edit the activity step
Environment Parameters in the Customizing activity.

Environment Parameter Description

IAL_FLG_DRAW_IPREPID Automatic assignment of an accident notification number

IAL_FLG_NEW_TIMEDATA_TAB New version of the time data tab

QTY_PERSON_CHECK Personnel number check in amounts

DATE_TOLERANCE Tolerance for date entries

DEST_BU RFC destination for business partner

DEST_HR RFC destination for human resources

DEST_PM RFC destination for plant maintenance

P_PATHID Way of performing a standard evaluation of

persons

WA_PATHID Way of performing a standard evaluation of

Relationships in work area

IHS_CHECK_HIGHDATE Check of the valid-to date

Page 8 of 144
when creating a follow-on measurement

IHS_ERQT_ANLS_ESTCAT Value assignment type for search

for measurements

IHS_FAL_PRSTDT_FLG Resetting the status

of the data transfer in the injury/illness log

IHS_MP_DEFAULT_STMFACTOR Overrun factor for short-time values

IHS_MP_DEFAULT_VACLID Default value for the Rating of

Use of an exposure property

IHS_MP_INDEX_HIDE Hide the individual index for an agent type

IHS_MP_XLSFILE_DVSKEY Excel macro for exporting the measurement project

IHS_MP_VERSION_STATUS Status for the versioned measurement project

IHS_MP_EXPOPROFIL_TRANSFER Read the exposure profile during creation

of a measurement project on the workspace manager

IHS_QTY_ALERTLIMIT Threshold for canceling the amount determination

IHS_QTY_WARNLIMIT Threshold for a runtime warning during the

amount determination

IHS_USE_TIMEZONE Switching of the time zone

IHS_ACCUPATTERN_TYPE Work area type of the collective pattern

IHS_PATTERN_TYPE Work area type of the pattern

IHS_ANALYSIS_DEFAULT Default analysis method

IHS_FTEMPLOYEE_HOURS Annual working hours

IHS_FTEMPLOYEE_LIMIT Threshold for full-time employment

IHS_NOTIFICATION_TYPE Notification type in plant maintenance

CD_CHANGE_DOCS_WRITE_AT_IHS Creation of change documents

EHS_REG_DAT_TRACK Activate function for logging access to sensitive personal data

IHS_MP_CONVERT_PPM_MLK_OFF Switch off conversion of ppm to ml/m3

Page 9 of 144
IHS_IAL_REPORTABLE_ABSDAY Accident reporting obligation after calendar days

Environment Parameters for Occupational Health:

Environment Parameter Description

OH_AUD_THRESHOLD Hearing loss threshold value in audiograms

OH_DIACODE_CASESEN Diagnosis codes in uppercase and lowercase

OH_SCH_LAYOUT_VARS Transaction-dependent layout variations in the schedule planning

OHS_UE_PERS_DATA User exit for displaying additional personal data in medical service

OHS_NEW_ANAM_SCREEN Use of a new case history screen

EHS_REG_DAT_TRACK Activate function for logging access to sensitive personal data

OH_FRAME_DIAGNOSIS Description for important diagnoses in partial screen

Behavior of authorization check for persons

OH_PERS_EXT_AUTH Ext. authorization check of persons

OH_VACC_SCHED_ADJUST Comparison between vaccination date and scheduling

Standard settings

Standard environment parameters are provided.

Activities

1. Call the Customizing activity.

2. Check the standard settings and adjust the parameter values to meet your requirements.

Further notes

Note the following for environment parameters where you are required to enter the address number for the data suppliers:

You can determine the address number of the data provider in Customizing for Basic Data and Tools in the IMG activity Specify
Authorization Groups. To do this, call the input help for the Data prov. field in the IMG activity. You will find the value you require in the
Addr. no. field. The address number is not displayed in address management in the Product Safety component.

Dangerous Goods Management

Page 10 of 144
This Implementation Guide contains information on setting up the Dangerous Goods Management (EHS-DGP)
component. All settings delivered in standard Customizing in client 000 are to be used as examples. They are not
complete, nor do they claim to be correct. They do not reflect any particular dangerous goods regulation.
Note that when you make your Customizing settings, you are entering legally-relevant data for your company.

Basic Data and Master Data


In this IMG section, you specify settings for the dangerous goods basic data and the dangerous goods master.

Explanations on the Change Log for Customizing Tables.


Creating change logs is recommended because only then can you establish who edited which table when and which data
constellation existed in a specific error case.

Recommendation

In the DDIC, the Log data changes indicator must be set for the respective table in the technical settings.
SAP recommends that you check for which other tables the Log data changes indicator is also set. The parameter is
effective for all tables in all clients for which the indicator is set.

Further notes

You can display the change log using the transaction SCU3.

Page 11 of 144
If you want to log the data changes in Customizing tables, contact your system administrator who should then make the
following settings for you:

1. Enter the parameter name rec/client.


2. In the Current value, enter the client key or the value ALL for all clients for which logging should be activated.
Note: Client keys must be separated by a comma.
3. Restart the system.

Common Settings

Specify Processing Statuses

Use

In this IMG activity, you specify the processing statuses for the dangerous goods basic data and the dangerous goods
master data.

If you have entered the processing status Released for the dangerous goods basic data, this processing status is transferred
when the dangerous goods master is filled.

Dangerous goods master data must be released explicitly to be used productively. For this reason, setting of a processing
status for dangerous goods master editing is supported.

Dangerous goods master data is only used for checks or printing on documents if it has a processing status that is marked
as released.

Example

You can set the following processing statuses:

Page 12 of 144
 In process

 Released

For this status, set the RelStat indicator.

Standard settings

Default settings are shipped.

Recommendation

We recommend that you assign the status key in such a way that the first digit represents a logical grouping. For example,
"0" could represent all statuses that are "in process." You can then use a generic search (search with "0*") in the
dangerous goods master data screens to find all master data records that are in various processing statuses.

Activities

1. Call the IMG activity.

2. Enter your processing statuses and enter descriptions for them in the languages you use.

Specify Validity Areas

Use

In this IMG activity, you specify the validity areas.

Countries, or countries and regions from the country table, are assigned to the validity area as jurisdictions.

The definition of validity areas is also used by the SAP components:

 Basic Data and Tools

See Specify Validity Areas

 Industrial Hygiene and Safety

See Specify Validity Areas

Example

The validity area "ADR" is composed of ADR member states. All the country keys from these member states must be
assigned to this validity area.
Page 13 of 144
Standard settings

Some examples are delivered in the standard system:

DE Germany
US United States
REG_WORLD World
ADR ADR states

Other validity areas required in different SAP components can be found in the standard settings.

Activities

1. Call the IMG activity.


2. Analyze the jurisdictions of the respective dangerous goods regulation.
Group the jurisdictions to form a validity area.
3. Enter the respective validity area.
4. Select the validity area and choose Assign Validity Area/Country in the navigation.
5. Enter the countries that should be assigned to this validity area.

Further notes

 You cannot delete validity areas that have been used productively.

 Ensure that the validity areas used in dangerous goods management fulfill the following conditions:

o A country can be included in a validity area that encompasses several countries ("ADR", for example).

o In addition, a validity area can exist that contains this country only. This kind of validity area represents
regulations specific to one country (listed goods regulations in Germany, for example).

 Validity area categories are not relevant for dangerous goods management, since generally only the validity area
category REGION is used here. You can specify validity area categories in Customizing for EH&S Basic Data
and Tools under Specify Validity Area Categories.

Page 14 of 144
Specify Mode-of-Transport Categories

Use

In this IMG activity, you can specify your own mode-of-transport categories and assign them to a base mode-of-
transport category.

Standard settings

Default settings are delivered in the standard system.

Activities

1. Choose New Entries.

2. Enter a key for the mode-of-transport category in the MTrCat field.

The customer namespace for your own mode-of-transport categories is 30 - 98.

3. Enter a description for the mode-of-transport category in the DescModeTransCateg. field.

4. Assign the mode-of-transport category to one of the existing base mode-of-transport categories using the input
help for the Base MTC field.

Example

MTrCat Description Base MTC Description

Page 15 of 144
30 Semitrailer 1 Road

Specify Collective Mode-of-Transport Categories

Use

Collective mode-of-transport categories allow you to group mode-of-transport categories.

Requirements

In the IMG activity Specify Collective Mode-of-Transport Categories, you have created collective mode-of-transport
categories and their descriptions for the base mode-of-transport category 07 (collective mode-of-transport categories).

We recommend that you select two-digit numbers between 90 and 99 for collective mode-of-transport categories to
distinguish them visually from mode-of-transport categories and base mode-of-transport categories.

Standard settings

The standard system contains the collective mode-of-transport category All mode-of-transport categories (99). You can
edit the collective mode-of-transport category 99.

Activities

1. Choose New Entries.

2. In the Collective MTC field, select a collective mode-of-transport category using the input help.

3. Assign a mode-of-transport category to the collective mode-of-transport category in the MTrCat field using the
input help.

You cannot assign any other collective mode-of-transport categories to a collective mode-of-transport category.

4. Repeat steps 2 and 3 to assign all required mode-of-transport categories to the collective mode-of-transport
category.

5. Save your entries.

Page 16 of 144
Specify Dangerous Goods Regulations

Use

In this IMG activity, you specify the dangerous goods regulations by assigning a validity area and mode-of-transport
category to the respective dangerous goods regulation.

The data records in the dangerous goods master are based on the dangerous goods regulations. This means that each time
you create or change a dangerous goods master data record, you must enter the regulation on which it is based.

Each regulation is identified uniquely by a language-dependent abbreviation, for example:

 "ADR" Accord europeen relativ au transport des marchandises dangereuses par route

 "GGVBinSch" dangerous goods regulation for inland waterways

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.


2. Make the settings for the dangerous goods regulations for the mode-of-transport categories and validity areas
used.

Further notes

In order that the system can derive the dangerous goods descriptions and hazard inducers correctly, you must assign a
regulatory list when you enter dangerous goods data in specification management and when filling the dangerous goods
master.

In order to assign a regulatory list to a dangerous goods regulation, choose Goto -> Details and enter the appropriate
regulatory list in the Regulatory list field under Addit. info. for dangerous goods basic data.

You can assign the dangerous goods regulation to a dangerous goods regulation family via the Value assignment type
input field. The value assignment types correspond to dangerous goods regulation families.

 The grouping of dangerous goods regulations into dangerous goods regulation families enables:

o Flexible processing when changes are made to regulations


Page 17 of 144
o Decentralized processing of the dangerous goods classification by different areas and groups of people

 If you do not enter anything, the system treats the regulation as if it was assigned to the value assignment type
SAP_EHS_1022_023. You can create your own value assignment types and thus dangerous goods regulation
families in Customizing for Basic Data and Tools in the IMG activity Specify Value Assignment Types.

For more information, see the documentation for the Dangerous Goods Management component.

Definition: dangerous goods regulation: Environment, Health and Safety (EHS) - A legal regulation that is relevant for
the transportation of dangerous goods.

Specify Dangerous Goods Classes and Classification Codes

Use

In this IMG activity, you specify the dangerous goods classes and classification codes for the dangerous goods
regulations.

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.


2. Enter the legally required dangerous goods class-classification code combinations for the dangerous goods
regulations.
Notes

The classification code appears in table 3.3 (column 3b) in the restructured dangerous goods regulations ADR, ADNR,
RID, and IMDG. It is used to explain the dangerous goods properties of the UN-listed substances listed.

The exact meaning of the classification code is different depending on the dangerous goods class and can, for example, be
found at the following points in the ADR regulation:

 Class 1: Chapter 2.2.1.1.4

Page 18 of 144
If you want to map class 1 dangerous goods in the system, you can use the Classification code field to specify the
Compatibility group. The compatibility group is used in particular for mixed loading determinations within class
1. In the ADR regulation, 13 compatibility groups are defined. For more information, see Chapter 2.2.1.1.6.

 Class 2: Chapter 2.2.2.1.2 and 2.2.2.1.3

 Class 3, 4.1, 4.2, 4.3, 5.1, 5.2, 6.1, 6.2, 8, and 9: Chapter 2.2.x.1.2; where x is the class without a decimal point.

 Dangerous goods of class 7 do not have a classification code

Examples of classification codes:

UN
Name Cl.Code Explanation
Number
2359 Diallylamine FTC Flammable liquid, toxic, corrosive
Phosphorus,
1381 ST4 Inorganic, toxic, solid
white
Aluminum Substances liable to spontaneous combustion, which, in contact with water,
3051 SW
alkyls emit flammable gases

Further notes

If you enter CBL as a dangerous goods class, the text Combustible Liquid is displayed instead of the dangerous goods class.

Definition: dangerous goods class: Environment, Health and Safety (EHS)- A classification of goods that present a danger
during transport according to the kind of danger they present.

These goods are classified differently under different dangerous goods regulations.
Example ADR regulation: class 3: flammable liquids

Page 19 of 144
Specify Not Dangerous Goods Full/Empty Transport

Use

In this IMG activity, you specify the input help for the following fields in the dangerous goods master:

 Non-Dangerous Goods Full Transport

 Non-Dangerous Goods Empty Transport

This means that you can give a reason why the material in the relevant dangerous goods regulation is not regarded as
dangerous goods.

Standard settings

Standard settings are delivered in the standard system.

Activities

Specify a key along with a description of the reason, and specify the input help in which the key appears by setting the full
transport and empty transport indicators accordingly.

Further notes

The namespaces for customers are:

 1 through 9
Page 20 of 144
 L through Z with the exception of X

Specify Transport Types

Use

In this IMG activity, you specify the transport types in accordance with the corresponding dangerous goods regulation.

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.

2. Enter the transport types permitted in accordance with the dangerous goods regulation.

Definition: transport type- (EHS) - An indicator that specifies how dangerous goods are transported such as by tank,
packaged, closed freight, or bulk.

Specify Hazard Identification Numbers

Use

In this IMG activity, you specify hazard identification numbers (kemler numbers) in accordance with the corresponding
dangerous goods regulation.

Standard settings

No default settings are delivered in the standard system.

Page 21 of 144
Activities

1. Call the IMG activity.

2. Enter all hazard identification numbers together with their language-dependent descriptions.

Definition: hazard identification number- (EHS)

An alphanumeric key displayed in the top half of the warning placard on tank trucks and tank wagons.
It indicates the type of risk, typically 33 indicates "highly flammable liquid."

Specify Danger Labels

Use

In this IMG activity, you specify the danger label numbers in accordance with the corresponding dangerous goods
regulation.

Standard settings

Sample settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Edit the danger label numbers together with their language-dependent descriptions according to the dangerous
goods regulation.

Further notes
Page 22 of 144
You can group danger labels via the Segregation key field. You can therefore, for example, group together danger labels
that only differ in size in the same class.

This is relevant for the dangerous goods check method mixed loading checks. Before you can group the danger labels via
segregation keys, you must process the IMG activity Specify Segregation Keys.

In the Graphics file field, you can store the name of a graphics file for the corresponding hazard label.

You can specify via the field Additional Info if it is a danger label or additional information.

Definition: danger label- (EHS)-Internationally agreed symbols that identify dangerous goods.

Example
Toxic substances in class 6.1 carry a danger label with a black skull and crossbones on a square white background.

Definition: mixed loading check-(EHS)

A check carried out to determine whether dangerous goods can be transported with other goods, in particular other
dangerous goods, in the same transport unit.

Profile for Additional Information

Definition

Helps to determine whether the Danger Label field is a danger label, or additional information or a marking.
Use

If nothing is specified, the Danger Label field is evaluated as a danger label.


No input help is stored here so that any entries are possible.

Page 23 of 144
Specify Packing Instruction Numbers

Use

In this IMG activity, you specify the packing instruction number in accordance with the corresponding dangerous goods
regulation.

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.

2. Enter the packing instruction numbers with language-dependent descriptions according to the applicable
dangerous goods regulations.

Definition: Packing Instruction Number-(EHS)

It is a number that refers to a packaging table or paragraph.


Valid packaging codes are described in packaging tables and paragraphs.

Page 24 of 144
Specify Profiles for User-Defined Dangerous Goods Texts

Use

In this IMG activity, you specify profiles for the dangerous goods user-defined text fields in the dangerous goods master.
This means that you can fill up to 15 fields with user-defined texts from the specification database, depending on the
regulation, and link these fields with output conditions.

 In the EH&S standard system, the value assignment type SAP_EHS_1022_042 (dangerous goods user-defined
texts) is provided.

 The function module DG50_PRICOND_USRDEFTXT is delivered in the standard system as an example of an


output condition.

You can enter dangerous goods user-defined texts both in the specification database, for the real substance and the
dangerous goods classification, and in the dangerous goods master.

During filling, the value assignment instances for the set value assignment type that correspond to the regulation are
stored in the dangerous goods master with the profile. You can access the output conditions via the profiles.

Further notes

If you do not process this IMG activity, you can still provide the dangerous goods user-defined text fields in the dangerous
goods master with output conditions, independently of the regulation, in the IMG activity Specify Output Conditions
and Formatting Methods.

Page 25 of 144
You can store up to 15 dangerous goods user-defined texts for each dangerous goods master record. Filling takes this into
account and allows you to fill up to 15 dangerous goods user-defined texts for each dangerous goods master record.

If you want to fill several dangerous goods user-defined texts, we recommend that you create only one instance and assign
it multiple values. Independent of this recommendation, the information below explains the system behavior when filling
dangerous goods user-defined texts:

 If only one instance exists and if the dangerous goods user-defined texts characteristic has multiple values
assigned, all dangerous goods user-defined texts are filled.

 If more than one instance exists for the same combination of regulation and dangerous goods user-defined text
profile, only the instance with the highest priority is filled. The priority for the instances is determined according
to the usual schema. If the instance with the highest priority has multiple values assigned, all its dangerous goods
user-defined texts are filled.

 If more than one instance exists for different combinations of regulation and dangerous goods user-defined text
profile, the instance with the highest priority is determined for each combination. If the instances have multiple
values assigned, all dangerous goods user-defined texts of the instances with the highest priority in each case are
filled.

The following restriction applies to the points above: If the number of dangerous goods user-defined texts exceeds 15,
only the first 15 are filled.

Specify Categories of Instructions for Enclosure

Use

In this IMG activity, you specify the instructions for enclosure.

Activities

For the individual categories of instructions for enclosure, specify the instructions for enclosure for the respective
dangerous goods regulations.

Category of Instruction for Enclosure

Definition- Specifies the categories of instructions for enclosure for packagings, fixed and portable tanks, IBCs and large
packaging’s, and limited quantities.

Example •P – Packaging, •LQ - Limited Quantities •TANK - Fixed tanks

Instruction for Enclosure

Definition

Page 26 of 144
Describes the enclosure conditions, that is the type of permitted packaging, of IBC, of fixed or portable tanks, or permitted
quantities and maximum weights.
Example

•P001,
•IBC02,
•LP02

Specify Packaging Codes

Use

In this IMG activity, you specify the permitted entries for the packaging code.

Standard settings

Sample settings are supplied.

Activities
1. Call the IMG activity.

2. Specify the permitted packaging codes with their language-dependent descriptions depending on the dangerous
goods regulations.

Definition: packaging code

Environment, Health and Safety (EHS)

The identification of packaging based on UN recommendations.


Packaging codes are identical across international boundaries. The code number is composed of one Arabic numeral for
the packaging type or two numerals for large packaging materials, one or more Latin letters for the basic material, and
another numeral for the packaging category:
 1st character packaging type, such as 1 for drum or 2 for wooden barrel
 2nd and 3rd characters basic material, such as A for steel or H for plastic
 4th character packaging category, such as 1 for bung or 2 for head

Page 27 of 144
Specify Regulatory Basis for Transport Restrictions

Use

In this IMG activity, you specify the regulatory basis for transport restrictions.

The regulatory basis for a transport restriction is a reference to a paragraph, section, or table in a dangerous goods regulation.

Standard settings

No default settings are supplied.

Activities

Enter the regulatory basis for transport restrictions with language-dependent descriptions.

Example

GGVSE, Annex 1, Table 1

Specify Stowage Categories


Use
In this IMG activity, you specify the stowage categories.
Page 28 of 144
Activities
Specify the stowage categories that are used in the dangerous goods regulations IMDG Code and 49 CFR.

Basic Data

Configure Basic Data and Tools for Dangerous Goods Management

In this IMG activity, you set up the specification database so that you can use it in the Basic Data (EHS-DGP-BD)
component.

Activities

Even if you have already set up the specification database, you must process the following IMG activities:

1. Specify Regulatory Lists

Check whether the regulatory lists DG_ADR, DG_CFR, and DG_IATA exist. You use regulatory lists to control the
validity of an identifier for specific dangerous goods regulations. If you use other regulations, create your own regulatory
lists for them and assign them to the dangerous goods regulations in the IMG activity Specify Dangerous Goods
Regulations.

2. Specify Specification Types

 Check whether the specification type LS_UN_SUB exists. The property tree LS_UN_TREE (EH&S dangerous
goods regulations) is assigned to this specification type. Material assignments and referencing are not permitted.

 Check whether the specification type DG_CL_SUB exists. The property property tree DG_CL_TREE (EH&S
dangerous goods classification) is assigned to this specification type. Material assignments and referencing are
permitted.

Customer-specific specification types can also be defined.

3. Check Identification Types


Page 29 of 144
 Check whether the identification types UN, ID, and NA are available for the identification category NUM.

 Check whether the identification types DG and HIS are available for the identification category NAM.

Customer-specific identification types can also be defined.

4. Check Identification Listing

 Check whether the item (IdListItem) 1 and the priorities (IdListPrio) 1, 2, and 3 are defined in the identification
listing D_DANGOOD for the identification category NUM (number) and for the identification types UN, ID, and
NA.

 Check whether the item 1 and the priority 1 are defined in the identification listing D_DGHIS for the
identification category NAM and for the identification type HIS.

All identification types defined under 3) can be used.

5. Specify Value Assignment Types

 Check whether the value assignment type SAP_EHS_1022_023 (dangerous goods classification) of the value
assignment category F (transport classification) exists. The value assignment category F allows transport
classifications to be assigned in value assignment.

 Check whether the value assignment type SAP_EHS_1022_032 (hazard inducer) of the value assignment
category H (hazard-inducing substances) exists. The value assignment category H allows hazard-inducing
substances to be assigned in value assignment. The value assignment type hazard inducer is assigned to the
standard property tree.

 Check whether the value assignment type SAP_EHS_1022_024 (dangerous goods regulations) of the value
assignment category G (dangerous goods additional data) exists. The value assignment category G allows
dangerous goods additional data to be assigned in value assignment.

6. Set Up Property Trees

 Check whether the property tree DG_CL_TREE is set up for dangerous goods classification. This property tree
must contain the value assignment type SAP_EHS_1022_023.

 Check whether the property tree LS_UN_TREE is set up for dangerous goods regulations. This property tree must
contain the value assignment type SAP_EHS_1022_024.

 Check whether the property tree DG_TREE exists.

7. Usage -> Specify Ratings


Check whether the highest priority is set for the ratings whose value assignments you want to use at a future stage
in the dangerous goods master.

Specify Risk Potential

In this IMG activity, you assign values for the classification code, packing group, and packaging ID to a combination of
the dangerous goods regulation, dangerous goods class, and risk potential.

Page 30 of 144
Example

You assign:

 Classification code: F1

 Packing group: II

 Packaging ID: Y

to the combination:

 Regulation: ADR

 Class: 3

 Risk potential (F1,II)

Standard settings

Sample settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Enter a combination of the dangerous goods regulation, dangerous goods class, and risk potential.

3. Assign the classification code, packing group, and packaging ID.

Further notes

The classification code appears in table 3.3 (column 3b) in the restructured dangerous goods regulations ADR, ADNR,
RID, and IMDG. It is used to explain the dangerous goods properties of the UN-listed substances listed.

The exact meaning of the classification code is different depending on the dangerous goods class and can, for example, be
found at the following points in the ADR regulation:

 Class 1: Chapter 2.2.1.1.4

If you want to map class 1 dangerous goods in the system, you can use the Classification code field to specify the
Compatibility group. The compatibility group is used in particular for mixed loading determinations within class
1. In the ADR regulation, 13 compatibility groups are defined. For more information, see Chapter 2.2.1.1.6.

 Class 2: Chapter 2.2.2.1.2 and 2.2.2.1.3

 Class 3, 4.1, 4.2, 4.3, 5.1, 5.2, 6.1, 6.2, 8, and 9: Chapter 2.2.x.1.2; where x is the class without a decimal point.

 Dangerous goods of class 7 do not have a classification code

Examples of classification codes:


Page 31 of 144
UN Number Name Cl.Code Explanation

2359 Diallylamine FTC Flammable liquid, toxic, corrosive

1381 Phosphorus, white ST4 Inorganic, toxic, solid

3051 Aluminum alkyls SW Substances liable to spontaneous

combustion, which, in contact with water, emit flammable gases

Definition: risk potential - (EHS)

It is the rating for dangerous goods relating to the mode of transport and dangerous goods class.
The risk potential is comprised of a dangerous goods letter and a packing group.

Develop Enhancement for Checking Risk Potential

To check dangerous goods classification, you can use the SAP enhancement C10U0001.

You can use this check method to check both the transport classification and the hazard inducer assignment in the dialog
for requirements that are specific to a company.

Page 32 of 144
Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

Check Hazard Inducer Types

In this IMG activity, you check the hazard inducer types and which dangerous goods regulations they are assigned to.

Example

For example, Marine Pollutant is assigned to the dangerous goods regulation IMDG.

Activities

1. Call the IMG activity.

2. Check whether the hazard inducer types are assigned to dangerous goods regulations.

Further notes

During the filling process, the system takes into account only the hazard inducer types supplied by SAP (1, 2, 3, M1, R1,
R2).

Develop Enhancement for Input Help for Specifications

The SAP enhancement C10U0002 is available to you to adapt the input help for specifications in the following places.

 Dangerous goods classification, Hazard inducers tab


Page 33 of 144
 Dangerous goods classification, Transport classification tab

 Hazard inducers, Hazard inducers tab

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

SAP enhancement C10U0002 :


You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.
You can enter a specification in the dangerous goods classification. You can adapt the input help for this specification via
this exit.
Input parameters
• I_ADDINF
Additional information from the dialog (in particular change number and key date)
Output parameters
• E_FLG_USE_DEFAULT_F4
You must set this indicator if the standard input help is to be used (esp1_true). If this is not the case, you must set
the indicator to false (esp1_false).
• X_SUBID
Specification key for searching that is entered manually. This results in the newly selected specification key being
returned.

Master Data

Page 34 of 144
Check Identification Number Types

Use

In this IMG activity, you check the types of identification numbers.

Activities

1. Call the IMG activity.

2. Check whether the following types of identification numbers exist:

o ID (ID number)

o NA (NA number)

o UN (UN number)

Definition: identification number

Environment, Health and Safety (EHS)

A unique key for a UN-listed substance that applies for all dangerous goods regulations.
Identification numbers include UN numbers, ID numbers, and NA numbers.

Page 35 of 144
Specify Labels

Use

In this IMG activity, you specify the labels for printing.

Up to 10 labels can be entered for one dangerous goods master data record.

The labels are stored as short texts.

Standard settings

No default settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Enter the language-dependent short descriptions for the labels.

Specify Water Pollution Classes

Use

In this IMG activity, you specify the water pollution classes.

There are legal regulations for water-polluting substances. To specify exactly what water pollution entails, substances are
classified according to their potential for pollution.

The water pollution class must be output on several documents in dangerous goods management.

Standard settings

No settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Enter the water pollution classes with their language-dependent descriptions.

Definition: water pollution class-Environment, Health and Safety (EHS)


Page 36 of 144
The grouping of substances based on toxicological and physical data. There are three water pollution classes:
 WGK 1: Low hazard to water
 WGK 2: Hazard to water
 WGK 3: Severe hazard to water

There is also the rating "nonhazardous to water."

Specify Combustible Liquid (VbF) Classes

Use

In this IMG activity, you specify the VbF classes.

The VbF class must be output on several documents in dangerous goods management.

Standard settings

No standard settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Enter the VbF classes with language-dependent descriptions.

Definition: VbF class

Environment, Health and Safety (EHS)

A substance classification in accordance with German law on combustible liquids (VbF).


Combustible liquids are classified according to their flash point and miscibility with water, such as the class AI for flash
point < 21 degrees Celsius, not miscible with water.

Specify Storage Hazard Classes

Use
Page 37 of 144
In this IMG activity, you specify the storage hazard class.

The storage hazard class must be output on several documents in dangerous goods management.

Standard settings

No default settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Enter the storage hazard classes with their language-dependent descriptions.

Specify Categories of Package

Use

In this IMG activity, you specify categories of package. You can enter these in shipping under dangerous goods
additional data in the Cat. of Package field.

Standard settings

Default settings are shipped.

Category of Package
Definition

The category of package is derived from the Transport Index and the surface radiation level of a package. It describes
the maximum radiation level directly on the surface and at a distance of 1 meter from the package.
In the dangerous goods regulation ADR, the categories of package are I-WHITE, II-YELLOW, and III-YELLOW. In the
system however, the color description has been omitted to make the code internationally recognizable. Specifying the
color is redundant information that only serves to indicate the color of the danger labels.

Transport Index

Definition

The transport index (TI) describes one hundred times the highest radiation level that is measured at a distance of 1 meter
for packages with radioactive contents.
Use

Page 38 of 144
The transport index must be determined for each package or overpack. It is specified without a unit and with two decimal
places.
To clarify: The radiation level and therefore also the transport index have the unit millisieverts per hour (mSv/h); this is
assumed in the case of the transport index and is therefore not named explicitly.

Develop Enhancement for Writing Change Documents

The SAP enhancement DG100001 is available for developing your own change document writing functions.

Using change document writing, you deactivate the standard change document writing and specify your own for the
Dangerous Goods Master component.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

SAP enhancement DG100001 - You can use this SAP enhancement to define a customer exit to write change documents
for dangerous goods master data and packaging data. The customer exit is in the function group XD10. It is called from
the function DG10_CHANGE_DOC_USER_EXIT.
If the system does not find a customer exit, a standard document description is called. This is stored in the include
LDG1NU03.
The following import parameters can be used:
Import Parameter Meaning
I_STR_OBJ_INFO Information on posting:
Page 39 of 144
- Indicator to specify if posting should be
synchronous (-) or asynchronous (+)
- Change number (*) if no change numbers
were used
- Selection date
I_CALL_STATUS Specifies which processing type is used
(dialog, engineering change management, filling)
to change the data.
All possible variations of this
indicator are defined in the constant
IC_CALL_STATUS in the include DGPM35.
I_BUFTAB Table with dangerous goods master records
(without packaging data) that were posted to the
database for the first time. The field SAVEMODE
specifies if the data records were deleted (D),
added (I), changed (U), or retained ( ).
I_BUFTAB_OLD Table with dangerous goods master records
(without packaging data) from the last
database access. This can be either the data read
at the start of the transaction, or the last
write access made.
I_BUFTAB_PK Table with packaging data records (analogous to
I_BUFTAB).
I_BUFTAB_PK_OLD Table with packaging data records (analogous to
I_BUFTAB_OLD).

Activate Phrasing

Activities

Set the indicator in order to activate the fields provided for assigning phrases so that phrase sets can be assigned.

To execute the program, choose Execute.

Page 40 of 144
Further notes

If you have not activated phrase assignment, you cannot change the phrase sets in phrase set-attribute assignment or add
new entries.

Custom fields are regarded as phrases if they are assigned to the domain CBDUD_FIELD_WITH_PHRASE.

Generate Standard Phrase Sets

Use

In this IMG activity, you create standard phrase sets for all fields that are capable of having phrases assigned in the SAP
component Dangerous Goods Management. The following applies here:

 The phrase sets in the dangerous goods master have the same names as the characteristics in the IMG activity
Specify Assignment Objects for Filling.

Note the following recommendations when you use filling in the dangerous goods master.

o Execute the following IMG activities in the given order:

a) Specify Assignment Objects for Filling


b) Generate Standard Phrase Sets (Basic Data and Tools)

c) Generate Standard Phrase Sets (Dangerous Goods Management)

o Do not change anything regarding the assignment of the phrase sets to the fields in the dangerous goods
master once you have filled the dangerous goods master at least once. Otherwise, the system will not
recognize the phrases generated by filling and they will not then be available in the dangerous goods
master.

o If you edit entries manually, make sure you assign the same phrase set to all hazard inducer types.

 The newly generated phrase sets are automatically assigned to the phrase-enabled fields. In the SAP component
Dangerous Goods Management, you can check the assignments under Phrases -> Edit Phrase Set-to-Attribute
Assignments.

 Phrases are not assigned during this generation.

 Existing assignments of phrase sets to phrase-enabled fields in the SAP component Dangerous Goods
Management are not overwritten by the system.

Activities

Page 41 of 144
Execute this IMG activity after the IMG activity Activate Phrasing.

Caution:

If you do not want to generate a phrase set for a phrase-enabled field, you must then delete this assignment
manually in phrase set-to-attribute assignment.

To set up a new tab page, proceed as follows:


1. Choose New Entries.
2. Enter an alphanumeric key for the tab page.
3. In the Seq. field, use the level of the number you enter to specify which position in relation to the other tab pages the new tab page
is to appear in.
4. Specify the program name to call the tab page.
5. Specify the number of the screen for list display.
6. Specify the number of the screen for detailed display.
7. Set the Visible indicator if the tab page is to be visible in the dangerous goods master.
8. Specify the title that should appear on the tab page in the dangerous goods master.
9. Save your entries.

Authorization Management for Dangerous Goods Management

Page 42 of 144
Specify Authorizations
Use
In this IMG activity you can create roles and generate authorization profiles by means of the profile generator. You can
then assign users to the roles.

Activities
For more information on the procedure, see the Short Description document.

Definition: authorization profile


User and Authorization Management (BC-SEC-USR)
An element of the authorization concept.
Authorization profiles give users access to the SAP System. They contain authorizations, which are identified using the
name of an authorization object and the name of an authorization. If a profile is specified in a user master record, the user
is assigned all of the authorizations defined in this profile.

Short Description of the Procedure for Creating Roles


These instructions describe the procedure for creating simple roles.

Step 1
Enter a name for the role and choose Create Role.
You should note that the roles supplied by SAP begin with the prefix "SAP_". If you are creating your own user roles, do
not use the SAP namespace.

Step 2
On the next screen, describe the functions that the role is to include.

Step 3

Assign transactions to the role on the Menu tab page:


o By specifying the transactions directly
o By assigning menu branches from the SAP menu

The menu options selected in this step are displayed in the Session Manager and on the "SAP Easy Access" logon screen
as the User menu for all users who are assigned to the role.

Step 4
On the Authorizations tab page, choose Change authorization data.
Depending on the transactions you have chosen, the system may display a dialog box that asks you to maintain the
organizational levels. These are authorization fields that occur in several authorizations at the same time and that can be
maintained together, An example is the company code, which occurs in several authorization objects. When you assign
values to the organizational levels, you maintain the authorization fields for all authorizations in the tree display that is
displayed at the same time.

Page 43 of 144
The system displays a tree display for all authorizations that are proposed by SAP for the chosen transactions. The
authorizations already have some values.
o Yellow traffic light icons in the tree display indicate that you need to manually postprocess authorization values. You
enter these values by clicking a white line next to the name of the authorization field. Once you have maintained the
values, the authorizations are regarded as having been manually modified. They are not overwritten if you include
additional transactions and reprocess the authorizations. By clicking the traffic light icon, you can assign full
authorization for the hierarchy level for all unmaintained fields.
o Red traffic light icons indicate that there are organizational levels that do not yet have values. You can enter or change
these values by choosing Org. levels....
o If you want additional functions in the tree display, such as to copy or summarize authorizations, choose Utilities ->
Settings and select the appropriate option.
o Generate an authorization profile for the authorizations by choosing Generate.
o Enter a name for the authorization profile in the next dialog box, or use the valid name in the customer namespace that
is proposed.
o Exit the tree display once the profile is generated.
o If you change the menu selection and call up the menu display for the authorizations again, the system tries to mix the
authorizations for the newly added transactions with the existing authorizations. This may mean that the traffic light
icons turn yellow, as new incomplete authorizations appear in the tree display. You need to either manually assign
values to these, or delete them.
o You can delete an authorization by first deactivating it and then deleting it.
o General authorizations such as spool display and print are not usually stored with transactions. For this purpose, you
can add authorization templates to the existing data. To do this, choose Edit -> Insert authorizations -> From
template... and choose one of the templates (for example, SAP_USER_B Basis authorization for application users or
SAP_PRINT Print authorization). Alternatively, you can create a separate role for these general authorizations
whereby the overview is much clearer.

Step 5
On the Users tab, assign the users to the role.
o The system displays the menu options for the role in the Session Manager as the user menu for the users assigned.
o Otherwise, the generated authorization profiles are automatically entered in the user master records when you perform
the User master record comparison. To do this, choose Compare users on the Users tab page and choose Full
comparison.
o If you do not restrict the period of the assignments and use the default period (current date to 12.31.9999), no further
action is necessary. If you make any other time restrictions, you need to schedule report
PFCG_TIME_DEPENDENCY to run daily. This report automatically updates the user master records. You must also
schedule this report if you are using Organization Management.

Caution
Never enter the generated authorization profiles directly in the user master records, as is the case with authorization
profiles that are created manually. You can only link generated profiles and users by assigning the corresponding role to
the users, and then performing a user master record comparison. During the comparison of the user master records, the
profiles for the role are entered for all users of the role.

Step 6
To transport the role to another system, you must enter the role in a transport request.

Page 44 of 144
o To do this choose Role -> Transport. You can now specify whether or not the user assignment should also be
transported.
o The authorization profiles are transported unless you have explicitly specified that you do not want to transport the
profiles.
o After the import into the target system, you have to perform a complete user master comparison again for hte
imported roles. You can start this comparison manually or use report PFCG_TIME_DEPENDENCY to execute it
automatically, if the report is scheduled to run periodically in the target system.
See also:
For information, choose Help -> Application Help.

Role Maintenance

Interfaces: Filling and Distribution

Common Settings

Specify Checkbox Structure for Dangerous Goods Master

Use
In this IMG activity, you specify the fields in the dangerous goods master that are relevant for filling and distribution and
whether they are update-relevant.

Page 45 of 144
If you do not set the Update indicator, you prevent the system from overwriting fields that would possibly be changed in
the dangerous goods master following filling or distribution.

Example
Regulation: ADR
Field name: BOPOI
Description of field name: Boiling point
Update indicator: set
If the Update indicator is set, the old value in the BOPOI field is overwritten during the next filling or distribution to the
target system. By setting this indicator, you can decide whether the old value for the coefficient of expansion is
overwritten in the dangerous goods master by the new value for the coefficient of expansion and therefore changed.

Activities
1. Call the IMG activity.
2. Enter the field name in accordance with the dangerous goods regulation.
3. Set the Update indicator only if the respective field is relevant for updating.

Further notes
If you have authorization to edit data in the dangerous goods master, you can only update fields for which you have not
set the Update indicator.
If you have authorization to change the dangerous goods master, you should change only the fields for which you have
not set the Update indicator. Changed fields could be overwritten during the next filling by values from specification
management that are no longer valid.

Page 46 of 144
Specify Checkbox Structure for DG Packing Requirement

Use

In this IMG activity, you specify the fields that are relevant for filling and distribution for the packaging requirement that
is dependent on the packaging code.

Example

Regulation: ADR

Field name: AGAUN

Description of field name: Agreement of authority required

Update indicator: set

If the Update indicator is set, the old value in the AGAUN field is overwritten during the next filling or distribution to the
target system. By setting this indicator, you can decide whether the old value for the Agreement of authority required is
overwritten by the new value for the Agreement of authority required and therefore changed.

Activities

1. Call the IMG activity.

2. Enter the field name in accordance with the dangerous goods regulation.
Page 47 of 144
3. Set the Update indicator if the respective field is relevant for updating.

Further notes

If you have authorization to edit data in the dangerous goods master, you can only update the fields for which you have not set
the Update indicator.

Hide Messages in Import Logs

In this IMG activity you specify which messages are to be hidden when the import logs are written.

Activities

1. Using the input help, specify the message class.

For dangerous goods-relevant messages on filling and distribution, this is the message class DGA.

2. Using the input help, specify the message number.

3. Set the Hide msg. indicator.

You need only deselect the Hide msg. indicator to allow a message to be displayed again.

Page 48 of 144
BAdI’s

BAdI: Filter Specifications for Filling

Use

A number of specifications can be assigned to a multiple component material. This multiple assignment leads to a filling
error in the standard system.

This BAdI allows you to filter out from a group of specifications those that you need for filling. When you activate the
BAdI, the system checks which of the specifications is relevant for filling. Only this specification is then filled.

So that a number of specifications can be assigned to a multiple component material and filling can be run without errors,
the NAM-ZDG_FILL identifier must be specified in Customizing. Assign this identifier to the specification for which
filling is to be taken into account.

The BAdI is called in the function module DG07N_FIND_CLASS_AND_SUBID in the function group LDG07NU09
after the specifications belonging to a material were read from the assignment table ESTMJ.
Page 49 of 144
The BAdI is not active in the standard system. Sample coding is shipped.

The BAdI has the method DG_MAT_ASSIGN_FILTER. It checks the specifications and filters out those specifications
that are relevant for filling with the aid of the identifier NAM_ZDG_FILL.

The following parameters are passed:

 X_LG_DGTMD_FILL

Input: Table with all specifications for filling


Output: Reduced table with specifications for filling

 I_VALDAT

Key date for classification key

 X_LOGTAB

Table for error messages

Activities

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.
2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class
field automatically, by assigning a class name based on the name of your implementation.
4. Save your entries and assign the Add-In to a package.
5. To edit a method, double-click its name.
6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod.
statements.
7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not
perform the following step:
8. Choose Activate.
When the application program is executed, the code you created is run through.

Page 50 of 144
BAdI: Consistency Checks for Dangerous-Goods Updating

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

The BAdI enables consistency checks of dangerous goods master data before updating in filling and distribution.

If an error is found in the header data, the check is interrupted and the data records are not updated. If an error is found in
the detail data, the data records are also not updated.

The BAdI replaces the user exit that is specified in the environment parameter DG_FILL_EXIT_CHECK.

The BAdI is not filter-dependent.

Information about the implementation of BAdIs in the context of the enhancement concept is available in the SAP
Library for SAP NetWeaver under BAdIs - Embedding in the Enhancement Framework.

See also

This BAdI uses the interface IF_EX_BADI_EHS_DG_CONSIST_001.

For more information, display the interface in the Class Builder.

BAdI: Enhancements When Saving Master Data

Use

You use this BAdI in distribution and filling to change master data before saving it.

Page 51 of 144
A default implementation exists. The BAdI is not filter-dependent.

Information about the implementation of BAdIs in the context of the enhancement concept is available in the SAP
Library for SAP NetWeaver under BAdIs - Embedding in the Enhancement Framework.

See also

This BAdI uses the interface IF_EX_BADI_EHS_DG_SAVE_001.

For more information, display the interface in the Class Builder.

Filling

Set Up Dangerous Goods Management for Filling


Activities

Make sure that you have edited the following IMG activities in Customizing for Dangerous Goods Management.
 Specify Validity Areas
 Specify Dangerous Goods Regulations
 Specify Dangerous Goods Classes and Classification Codes
 Specify Danger Labels
 Specify Risk Potential
 Check Identification Number Types
 Specify Packaging Codes

Specify Priorities

Use

In this IMG activity, you specify a priority sequence for the validity areas, depending on the dangerous goods regulations.

Page 52 of 144
In specification management, individual value assignment types can have several value assignment instances, only one
of which, however, is used to fill the dangerous goods master. The instance to be used for filling is determined using a
multilevel schema, which also takes into account the priority sequence you specify in this IMG activity.

Requirements

You have processed the following IMG activities.

 Specify Validity Areas

 Specify Dangerous Goods Regulations

Activities

Assign validity areas to the individual dangerous goods regulations and specify their priority.

The higher the numeric value, the lower the priority.

Example

Regulation Priority Validity area

ADR 1 DE

ADR 2 ADR

ADR 3 REG_WORLD

Multilevel schema - When the dangerous goods master is filled, the system fills only the value assignment instance with
the highest priority. (You can fill several dangerous goods user-defined texts and regulation-dependent transport data
using a different method.)

The priority for the instances is determined according to the schema below. If the system cannot make a clear decision at
one level, it passes only the instances with the highest priority to the next decision-making level.

1. Relevancy check
First the system checks whether both the rating and the validity area of the instance are relevant for dangerous goods.
Only instances that fulfill both these criteria are taken into account for determining priorities and finally for filling.

The rating is relevant for dangerous goods if a dangerous goods priority with a value greater than zero is assigned to it in
the IMG activity Specify Ratings.

The validity area is relevant for dangerous goods if one of the following prerequisites is fulfilled:
 The priority with a value greater than zero must be specified in the IMG activity Specify Priorities for the validity
area and the dangerous goods regulation to be filled.
 The validity area of the instance matches the validity area from the definition of the dangerous goods regulation in
the IMG activity Specify Dangerous Goods Regulations.
 The validity area is REG_WORLD.

2. Rating

Page 53 of 144
The system fills the instance whose rating has the highest dangerous goods priority. To do this it evaluates the entries in
the IMG activity Specify Ratings.
If a number of instances have ratings with the same dangerous goods priority, the priority is determined by means of the
validity area.

3. Validity area
The system fills the instance whose validity area has the highest priority. To do this it evaluates the entries in the IMG
activity Specify Priorities for the dangerous goods regulation in the dangerous goods master record and for the respective
validity areas of the individual instances.
If there are no entries for the dangerous goods regulation in the IMG activity Specify Priorities or if no entry matches the
validity areas of the value assignment instances, the system evaluates the definition of the dangerous goods regulations.

4. Definition of dangerous goods regulations


The system fills the instance whose validity area matches the validity area from the dangerous goods regulation definition.
To do this it evaluates the entries in the IMG activity Specify Dangerous Goods Regulations.
If no instance has a validity area that matches the validity areas of the regulation definition, the system checks whether
one of the value assignment instances has the validity area REG_WORLD.

5. Validity area REG_WORLD


If only one instance has the validity area REG_WORLD at this level, the system fills this instance.
If a number of instances have the validity area REG_WORLD, the system cannot determine a clear priority and the value
assignment type is not filled. A corresponding entry is written to the error log.

Specify Assignment Objects for Filling


In this IMG activity you specify which fields from the specification database are to be filled at which positions in the
dangerous goods master. To fill fields outside the standard system, you can specify a user exit.

Standard settings
Standard settings are shipped.
These shipped standard settings allow filling to run as in EH&S Release 2.5.

Page 54 of 144
Distribution (Application Link Enabling (ALE))

Set Up Distribution of Dangerous Goods Master Data Between ERP Systems

Use

In this IMG activity, you set up the distribution of dangerous goods master data. (See also Concept information under
Distribution (Application Link Enabling (ALE)).)

1. Requirements
a) Settings in Customizing for Application Link Enabling (ALE)
i. You have made the necessary settings in Customizing for Application Link Enabling (ALE).
2. Settings in the SAP component Dangerous Goods Management
a) Specify dangerous goods master data to be distributed
i. For manual distribution of dangerous goods master data, choose Dangerous Goods Management ->
Tools -> Dangerous Goods Master Distribution -> Start Distribution.
ii. For automatic distribution of dangerous goods master data, you can use the distribution with change
pointer evaluation function. You can schedule this to run periodically as a report.
Page 55 of 144
b) Check authorizations
i. You require read authorization for all specification data to be distributed, both for manual and
automatic distribution.
ii. You also require the appropriate authorizations for inbound processing in the target system.

Activities

1. Editing the distribution model in Customizing for Application Link Enabling (ALE)

In Customizing for Application Link Enabling (ALE), call the IMG activity Maintain Distribution Model and
Distribute Views.
For more information, see the documentation for the IMG activity.
To guarantee the communication between the systems for distribution, you must make the following entries in the IMG
activity Maintain Distribution Model and Distribute Views using Create BAPI:

Field Entry

Sender/Client: <source system key>

Receiver/Server: <target system key>

Object name/Interface: DangerousGood

Method: SAVREPLICA (distribute to the target systems and

update on the target systems)

Note:

The message type DANGEROUSGOOD is supported.

Then in Customizing for Application Link Enabling (ALE), edit the IMG activity Generate Partner Profiles.

2. Editing settings in the sending and receiving systems

The following objects must already be available on the target system in their required form:

o Entries in Customizing tables


o Materials of the logical key
o Change numbers
o Phrases
3. Checking control data to be distributed
See above "Editing settings in the sending and receiving systems."

4. Checking consistency

A consistency check can be run for the settings in the distribution model and the partner profiles.

To use it, call the IMG activity Check Technical Consistency in Customizing for Application Link Enabling (ALE).

The prerequisite is that the distribution model was distributed and the partner profiles edited in all relevant systems.

Page 56 of 144
5. Handling errors

You can use the EH&S environment parameter DG_DISTRIBUTION_SAVE to determine whether an attempt should be
made to update the IDoc in every case or whether the IDoc should not be updated in the case of an error.

If errors occur when updating, you can check in the import log of the target system which errors occurred.

General Procedure

1. Initial distribution

Start the initial distribution without using change pointer evaluation.

To do this, choose Dangerous goods master -> Send from the initial Dangerous Goods Management screen and do NOT
set the Change pointer evaluation indicator.

You can use the EH&S environment parameter DG_DISTRIBUTION_PACK to specify how many dangerous goods
master objects are to be distributed in one IDoc.

2. Switching on delta distribution

a) Activating change pointers for a message type


Changes to master data objects are logged in the form of change pointers during master data distribution. To activate the
writing of change pointers, in Customizing for Application Link Enabling (ALE) in the IMG activity Activate Change
Pointers for Message Types, set the Active indicator for the message type for which you want to use delta distribution.

b) Activating change pointers for each field


From the SAP Easy Access screen, choose Tools -> ALE -> ALE Development -> IDoc -> Engineering Change
Management -> Define Change-Relevant Fields and enter the message type for which you want to determine fields for
which the SAP system writes change pointers. All relevant data fields are delivered. If necessary, adjust the table to your
requirements.

c) Activating change pointers generally


To generally activate master data distribution using change pointers, in Customizing for Application Link Enabling (ALE)
choose the IMG activity Activate Change Pointers - Generally and set the Active indicator.

d) Scheduling delta distribution as a job


You can perform delta distribution manually or schedule it as a job.
To perform delta distribution manually, from the SAP Easy Access screen choose Tools -> ALE -> ALE Administration ->
Services -> Change Pointers -> Evaluate, enter the message type you require, and choose Execute.
To schedule delta distribution as a job, in Customizing for Application Link Enabling (ALE) in the section Create IDocs
from Change Pointers, choose Define Variants and create a variant. Then in the IMG activity Schedule Jobs create a
job (RBDMIDOC) for the variant. You can set the time at which distribution is performed, for example, immediately after
a change or periodically.

The following applies to the data transfer:

 If a dangerous goods master record is not found in the target system, it is created and given the key that was
transferred.

Page 57 of 144
 If a dangerous goods master record is found in the target system, its data is updated.
 While dangerous goods master data is being sent, the dangerous goods master record is locked against changes. If this
lock cannot be set, the dangerous goods master record cannot be processed. The IDoc switches to error status and a
work item is created.
 Updating can be speeded up if the verification of phrases is switched off. Use the environment parameter
DG_SUPPRESS_PHR_CHECK to do this.

Note:

 In manual distribution change pointers are not taken into account, meaning delta distribution does not take place, but
all selected dangerous goods master records are distributed.
 If the selection date is later than the date of a change number in the source object, the target system executes a data
record split on the selection date when the dangerous goods master data with change numbers is distributed. This
means the change number with change date is not taken into account in the target system because in the period before
the selection date, the data record was not changed in the target system.
 In the IMG activities Specify Checkbox Structure for Dangerous Goods Master and Specify Checkbox Structure
for DG Packing Requirement you specify which fields of the dangerous goods master or the dangerous goods
packing requirements are relevant for distribution and update.

Set Up Distribution of Dangerous Goods Master Data to an SCM

Use
This IMG activity describes the settings you have to make in this system to distribute EH&S data from this system via
Application Link Enabling (ALE) to a Supply Chain Management (SCM) system. You can distribute the following EH&S
data to an SCM system:
 Phrase data
 Hazardous substance data
 Dangerous goods data

The settings in this system are very similar to those settings that you have to make to distribute phrases between two ERP
systems. For more information, see the Implementation Guide (IMG) for Basic Data and Tools under ALE for Phrase
Management.
Since the Environment, Health and Safety (EH&S) component does not exist in the SCM system, and the necessary
business objects for distribution therefore also do not exist, the Customizing settings you need to make there are more
extensive. For more information about these settings, see the IMG in the SCM system.

Activities
Depending on which data you want to distribute, proceed as described in the following IMG activities:
 Set Up Distribution of Phrase Data Between ERP Systems
 Set Up Distribution of Hazardous Substance Data Between ERP Systems
 Set Up Distribution of Dangerous Goods Master Data Between ERP Systems

The procedure involves the following steps:


1. Since standard serialization using the business object cannot be used for distribution to the SCM system, you must
adapt the partner profiles for serialization manually under Maintain Partner Profile Manually. Adapt the outbound
parameters for the profile in the SCM system for the message types PHRMAS (for phrase data),
HAZARDOUSSUBSTANCE (for hazardous substance data), and DANGEROUSGOOD (for dangerous goods data) as
follows:
o Enter 9999 as the packet size.
o As the output mode choose Collect IDocs.
2. Create a variant for serialization for the report RSEOUT00 that is restricted to the message types listed (Logical
Message field) and sends the maximum number of IDocs.
Page 58 of 144
3. Schedule a periodic job for this variant. This report ensures that the IDocs are posted in exactly the order in which they
were created. This prevents the IDocs being posted in parallel, which can lead to errors.

4. Start initial distribution as follows.


o For the initial distribution of phrase data, in the phrase management hit list choose Phrase -> Data Exchange ->
ALE According to Distribution Model.
o For the initial distribution of hazardous substance data, in the Hazardous Substance Management menu choose
Hazardous Substance Master -> Send -> Start Sending.
o For the initial distribution of dangerous goods data, in the Dangerous Goods Management menu choose Tools ->
Dangerous Goods Master Distribution -> Start Distribution.

5. Set up delta distribution as follows if required:


a) Schedule the report RBDMIDOC so that it is run before the report RSEOUT00. We recommend that you
schedule a report that contains both reports in two steps, which are processed in succession.
b) Activate the change pointers for the message types PHRMAS, HAZARDOUSSUBSTANCE, and
DANGEROUSGOOD in one of the following ways:
- Under Activate Change Pointers for Message Types, activate the change pointers for the message types
described.
- In the SAP menu under Tools -> ALE -> ALE Development -> IDoc -> Engineering Change Management ->
Define Change-Relevant Fields, specify for the message types described all fields for which you want to activate
change pointers.
- Under Activate Change Pointers - Generally, activate all change pointers.

BAdI: Convert and Change Data in ALE Distribution

Use

This BAdI allows you to:

 Change dangerous goods data and packaging data before sending the data in the sending system and before posting
the data in the receiving system

 Distribute customer-specific enhancements to the dangerous goods master

The BAdI has two methods for changing data. Both methods are supplied empty. In the standard system, no data is
changed.

1. MODIFY_DGDATA_BEFORE_SENDING
This method is called before the dangerous goods data is transferred to the ALE interface. You can change dangerous
goods data and delete dangerous goods master records depending on the receiving system.

2. MODIFY_DGDATA_AFTER_RECEIVING
This method is called after the IDoc was unpacked in the receiving system and is available in BAPI structures. You can
change the data in the same way as for the above method.

The BAdI has two methods to distribute customer-specific enhancements in the dangerous goods master. Both methods
contain standard implementations to distribute the data without any further actions.

1. TRANSFER_IOTAB_2_EXTENSIONTAB
Page 59 of 144
This method copies the data from the internal dangerous goods table RDGMDIOT to the extension table that serves as the
data container for distribution.

2. TRANSFER_EXTENSIONTAB_2_IOTAB
This method copies the data from the extension table to the dangerous goods table RDGMDIOT.

Activities

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.
2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class
field automatically, by assigning a class name based on the name of your implementation.
4. Save your entries and assign the Add-In to a package.
5. To edit a method, double-click its name.
6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and end method.
statements.
7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not
perform the following step:
8. Choose Activate.
When the application program is executed, the code you created is run through.

Dangerous Goods Checks and Dangerous Goods Documents/EDI

Common Settings

Page 60 of 144
Specify Indicator Profiles for the Material Master
In this IMG activity, you specify the dangerous goods indicator profiles for the material master.
You can assign exactly one indicator profile to each material master record. This assignment enables you to specify
whether the material is:
 Relevant for dangerous goods
 Relevant for dangerous goods and documents
 Relevant for dangerous goods and checks
 Relevant for dangerous goods, checks, and documents

Standard settings
All relevant dangerous goods indicator profiles are delivered in SAP standard Customizing.

Activities
Check the existing dangerous goods indicator profiles to ensure they are complete.

Further notes
If you have implemented template and one-time material processing, you can also specify whether the material is relevant
for template materials or one-time materials.
In the SD process, a material is recognized as relevant for either template materials or one-time materials if it is relevant
for dangerous goods and for template or one-time materials.

Specify DG Management Profiles for SD Documents

In this IMG activity, you specify the dangerous goods management profiles for SD documents.

Page 61 of 144
To output the text for Chapter 1.1.3.6, you must assign a dangerous goods management profile in the SD document
header.

If the dangerous goods management profile is entered in the SD document header, it can be used to control text output.

Standard settings

In SAP standard Customizing, four dangerous goods management profiles for SD documents are supplied for Chapter
1.1.3.6. Three are identified as manually fixed profiles.

Activities

Check to ensure the dangerous goods management profiles exist.

The profiles must have numbers in the intervals 000 - 099 or 200 - 299.

Further notes

If you assign a dangerous goods management profile manually in the SD document header and this profile is not to be
overwritten by a dangerous goods check, then assign a dangerous goods management profile for which you have set the
Fix indicator in Customizing for Dangerous Goods Management.

Specify Date for Determination of DG Master Data

Change numbers enable several data records with varying content and validity statuses to exist for one material number
and dangerous goods regulation in the dangerous goods master.

The dangerous goods master data used for the dangerous goods checks and dangerous goods documents/EDI must have a
specific validity status. The same validity status is relevant for both areas. You specify for each SD document category
which date in the document is to be used as the selection date for reading the dangerous goods master.

For the SD document categories request for quotation (A), quotation (B), scheduling agreement (E), scheduling agreement
with external services (F), and contract (G), you can specify two date fields as selection criteria for reading the dangerous
goods master records. These are the valid-from and valid-to fields. Note that with this setting, the same dangerous goods
master record may be checked twice which could lead to lower performance.

Example

You set the Valid-from date indicator for the SD document category scheduling plan (E) if you want to take the start of
validity into account for this document category when selecting from the dangerous goods master.

You set the Valid-from date indicator and the Valid-to date indicator for the SD document category scheduling plan (E) if
you want to select the dangerous goods master records with the start and end of validity for this document category.
Page 62 of 144
Activities

Select the date field or date fields that you want to take into account when selecting the dangerous goods master.

Further notes

If these fields are not relevant for you, you can create a function module and enter it under a user exit that you can use to
determine the selection date as required.
Use the function module HAZMAT_CALL_USER_FUNC_SEL_DATE as a template but exclude the parameter
I_FUNC_NAME.

If you enter a date from the delivery document for the transport document, the system determines the most current date
from the deliveries in the shipment.

If the date in the SD document is not filled, the system uses the current date.

If no settings were made for a document category, an error is triggered in Dangerous Goods Management

Specify Transit Countries

Use

In this IMG activity, you can specify all transit countries affected according to route, departure, and destination countries.
Entering a route is optional. If you enter a route, this must have been created in Customizing for Sales and Distribution.

For dangerous goods management, all countries and mode-of-transport categories for which you must take dangerous
goods regulations into account must be taken from an SD document. The combination of country and mode-of-transport
category is always relevant for this, as dangerous goods regulations are valid for a mode-of-transport category and a
country or number of countries (represented by a validity area in the SAP system).

The countries are derived from the routes or shipment stages and from the transit country table. The mode-of-transport
categories are derived from the shipping types in the route header or the route or shipment stages.

This IMG activity also serves to identify a shipment route as rollon - rolloff (roro). If you set the RoRo indicator, the
system checks the mode-of-transport categories that are assigned to the base mode-of-transport category04 (Sea) in
addition to the other mode-of-transport categories. This indicator is taken into account when outputting dangerous goods
documents and during EDI processing based on the departure countries and destination countries in the whole itinerary or
the whole shipping route, if the following criteria are fulfilled:

The last stage in which the departure country appears must have the mode-of-transport category Road (01) or Rail (02).

The first stage in which the destination country appears must have the mode-of-transport category Road or Rail.

Page 63 of 144
The stages between the last stage in which the departure country appears and the first stage in which the destination
country appears must have the mode-of-transport category Road or Rail.

Activities

1. Call the IMG activity.

2. Choose Edit -> New entries and specify the route, departure, and destination country.

3. Set the RoRo indicator if you are using a route that includes a roll-on roll-off sea transport.

4. Select the route and choose Assignment of transit countries.

5. Choose Edit -> New entries and enter the data for the fields TransCount, Counter, Sequence, LegIndictr, and Sea/air.

The Counter field enables you to include individual countries in the transit country table several times. This means, for example, that
the change of mode-of-transport category can be mapped within a transit country.

The transit country table is taken into account as follows:

In the sales or shipping document, the transit country table is always taken into account if you have entered a route without stages in
the sales or shipping document.

Exception:

For internal shipments and a route without stages, the transit country table is only taken into account if the Dng.gds transit ctry tab
indicator is set in the route header.

If you have entered a route with stages in the sales or shipping document, the transit country table is taken into account if the Dng.gds
transit ctry tab indicator is set in the route header.

In the shipment document, the transit country table is not taken into account if the shipment header contains a route that is defined
with stages and for which the Dng.gds transit ctry tab indicator is not set. In all other cases, it is taken into account in the shipment
document.

6. If the transit country table is to be taken into account in the sales or shipping document for a route with stages or in the transport
document in addition to the shipment stages, then use the sequence to specify the routes or shipment stages to which the transit
country is to be assigned. Routes or shipment stages are always assigned the transit countries that come between the departure and
destination countries of a stage. Transit countries are in turn assigned the shipping type for the stage. The mode-of-transport category
is derived from the shipping type (preliminary leg, main leg, subsequent leg).

7. If you have entered a route without stages in the shipping or sales document, the shipping types from the route header are used. You
assign the leg indicator to specify which shipping type in the route header is to be assigned to a country.

8. If you have entered a route without stages in the shipping or sales document and want to take into account national conditions for
the mode-of-transport categories sea or air, specify which country is the departure or destination country for this mode-of-transport
category. As standard, these mode-of-transport categories are assigned to the departure and destination countries for shipping if they
are entered in the main leg shipping type in the route header.

Further notes

Page 64 of 144
The departure country in the shipping or sales document is always derived from the shipping point, and the destination country is
always derived from the ship-to party. The departure country for a transport document is derived from the departure nodes of the first
shipment route, and the destination country from the destination nodes of the last shipment route.

The transit country table is read in the shipping, sales, and transport document according to the following procedure:

The system first attempts to find data records using the route, departure, and destination country.

If no data records are found, the transit country table is read without a route. The departure and destination countries in the stage are
always used first.

If no data records are found for this, the departure and destination countries for shipping, sales, or shipment are used to read the transit
country table.

For more information about the derivation of countries and mode-of-transport categories, see the application help for Dangerous
Goods Management.

Base Mode-of-Transport Category

Definition

In the system, the mode-of-transport categories in the standard shipment and any customer-specific mode-of-transport
categories are grouped to form a limited number of base mode-of-transport categories. The base mode-of-transport
categories are:

Base MTC Description


01 Road
02 Rail
03 Inland Waterway
04 Sea
05 Air Cargo
06 Air Passenger
07 Collective Mode-of-Transport Category
08 Tanker
09 Other
20 Pipeline

In the standard shipment, these base mode-of-transport categories are assigned the same mode-of-transport categories
Road (01), Rail (02), Inland Waterway (03), Sea (04), Air Cargo (05), Air Passenger (06), and Pipeline (20).
In Customizing, you can create your own mode-of-transport categories and then assign each of them a base mode-of-
transport category.

Assign Relevant Mode-of-Transport Categories to Modes of Transport

Use

In this IMG activity, you assign the relevant mode-of-transport category to modes of transport.
Page 65 of 144
Activities

1. Check which modes of transport are relevant for dangerous goods management.

2. Assign a mode-of-transport category to the modes of transport. The mode-of-transport category is used to
classify modes of transport in dangerous goods management.

Note about automatic shipment

Select the entries you want shipped and then choose Table view -> Shipment. You can still check the contents of these
entries and then either transfer them into the transfer order you created or delete them.

Definition: mode of transport category-Environment, Health and Safety (EHS)


The type of transport to be used such as road, rail, inland waterway, sea, air (cargo and passenger), or pipeline.
Example
Category 99 (all modes) is used in the U.S. dangerous goods regulation 49 CFR (Code of Federal Regulations). When
materials are transported with category 20 (pipeline), they are not classed as dangerous goods.

Customer Exits

Develop Enhancement for Material Exchange Multi-Component Ex

Using the SAP enhancement DG700003 you can use the following functionalities:

 Material exchange

 Explosion of multiple component materials

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Page 66 of 144
Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

Enhancement DG700003

Functionality

Activating the enhancement DG700003 allows you to make use of two functionalities:

Executing a material exchange

Explosion of multiple component materials

Material exchange:

The dangerous goods master records are determined for the exchanged materials. The dangerous goods checks access these dangerous
goods master records. The dangerous goods data for the exchanged material is output on the delivery note. When dangerous goods
data is dispatched via EDI in the delivery and the shipment, the dangerous goods master records of the exchanged materials are used.

Multiple component explosion:

For the exploded materials, the dangerous goods master records are determined and checked by the dangerous goods checks.

The dangerous goods data for the exploded components is not taken into account on the delivery note and during data transfer via EDI

Prerequisites

Dangerous goods checks:

If the "Document items relevant for checks only" indicator is set in Customizing for the dangerous goods checks (DGA1), at the
interface between the SD document and the main program for the dangerous goods checks only materials for which the dangerous
goods indicator profile is not initial are transferred.

Dangerous goods documents

In the dangerous goods documents, only materials for which the dangerous goods indicator profile is set as relevant for dangerous
goods and dangerous goods documents are taken into account.

In a material exchange, materials that are to be taken into account in the dangerous goods checks and when outputting dangerous
goods data should therefore have a dangerous goods indicator profile that is set at least as relevant for dangerous goods and dangerous
goods documents.

Page 67 of 144
Tasks of the function module exit

The interface of the function module exit contains the assignment table E_CHG_MATTAB in which it is possible to see which
materials were exchanged or exploded in further processing in DG checks and documents.

The function module exit must fulfill the following tasks if further processing is to be successful:

Material exchange:

The number of the exchanged material must be written to the MATNR_CHG field

The FLG_CHG field must be filled as follows:

Blank: No material exchange took place

X: The material exchange was successful

E: An error occurred during the material exchange

Multiple component explosion:

For the exploded materials, the item number of the relevant SD item must be written to the POSNR field

For the exploded materials, the material number of the relevant SD item must be written to the MATNR field

For the exploded materials, the material number of the exploded material must be written to the MATNR_DISLV field

For the material of the SD item, the material number of the SD item must be written to the MATNR_DISLV field

For the material of the SD item and the exploded materials, the FLG_DISLV field should be filled as follows:

Blank: No multiple component explosion took place

X: The multiple component explosion was successful

E: An error occurred during the multiple component explosion

Description of the Parameters of the Function Module Exit DG700003

I_CHK_LIKP

Header data of the current shipping document to be checked

I_CHK_VBAK_WA

Header data of the current sales document to be checked

I_CHK_VTTKVB_WA

Header data of the current shipment document to be checked

I_CHK_LIPS

Page 68 of 144
Item data of the current shipping document to be checked

I_DG_CHK_START

Parameter by means of which the start mode for the dangerous goods checks can be identified (for example, 01: manual check in
shipping document)

I_CHK_VBAPTAB

Item data of the current sales document to be checked

I_CHK_VBEPTAB

Scheduling data of the current sales document to be checked

I_CHK_VTRLPTAB

Item data of the current shipment document to be checked

E_CHG_MATTAB

Table with assignments between the material in the SD item and the exchanged or exploded material

Sample Coding

The following sample coding executes the following tasks:

Exchanges material DG_01 with DG_02

Explodes material DGCOMP into DGCOMP_01 and DGCOMP_02

**********************************************************************

DATA: IDX LIKE SY-TABIX,

TMP_CHG_MATTAB LIKE RDGCHANGE OCCURS 5 WITH HEADER LINE.

* initialization

CLEAR TMP_CHG_MATTAB.

REFRESH TMP_CHG_MATTAB.

LOOP AT E_CHG_MATTAB.

IDX = SY-TABIX.

* material change

IF E_CHG_MATTAB-MATNR = 'DG_01'.

E_CHG_MATTAB-MATNR_CHG = 'DG_02'.

Page 69 of 144
E_CHG_MATTAB-FLG_CHG = 'X'.

MODIFY E_CHG_MATTAB INDEX IDX.

ENDIF.

* dissolving materials

IF E_CHG_MATTAB-MATNR = 'DGCOMP'.

E_CHG_MATTAB-MATNR_DISLV = 'DGCOMP'.

E_CHG_MATTAB-FLG_DISLV = 'X'.

MODIFY E_CHG_MATTAB INDEX IDX.

* append dissolved materials

* DGCOMP has two components: DGCOMP_01 and DGCOMP_02

TMP_CHG_MATTAB-VBELN = E_CHG_MATTAB-VBELN.

TMP_CHG_MATTAB-POSNR = E_CHG_MATTAB-POSNR.

TMP_CHG_MATTAB-MATNR = E_CHG_MATTAB-MATNR.

TMP_CHG_MATTAB-MATNR_DISLV = 'DGCOMP_01'.

TMP_CHG_MATTAB-FLG_DISLV = 'X'.

APPEND TMP_CHG_MATTAB.

CLEAR TMP_CHG_MATTAB.

TMP_CHG_MATTAB-VBELN = E_CHG_MATTAB-VBELN.

TMP_CHG_MATTAB-POSNR = E_CHG_MATTAB-POSNR.

TMP_CHG_MATTAB-MATNR = E_CHG_MATTAB-MATNR.

TMP_CHG_MATTAB-MATNR_DISLV = 'DGCOMP_02'.

TMP_CHG_MATTAB-FLG_DISLV = 'X'.

APPEND TMP_CHG_MATTAB.

CLEAR TMP_CHG_MATTAB.

ENDIF.

ENDLOOP.

* append entries for dissolved materials to export table


Page 70 of 144
APPEND LINES OF TMP_CHG_MATTAB TO E_CHG_MATTAB.

Develop Enh. for Determ. Country/MTC Combination in Shipping


Using the SAP enhancement DG700004 you can develop an enhancement to determine the country-mode of transport
category combination in shipping and sales.

Note:
So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format. Set the
SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing Utilities -> Text
display -> SAPscript.

Activities
1. Create the enhancement.
Either create a new enhancement project or use an existing one.
2. Activate the project.
Your enhancement will only take effect when activated.

Further notes
Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.
You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

The function exit DG700004


Functions
The function exit DG700004 relates to the individual determination of the country/mode of transport category combination in shipping and
sales documents.
In the function module HAZMAT_GET_COUNTRIES_DGMOT, the country/mode of transport category combinations of route, shipping
point, and ship-to party are determined in the SAP standard method.
If you have set the Take transit country table into account indicator in the route header, the system also takes into account all transit countries
with the corresponding mode of transport categories.
If no route is specified, the dangerous goods checks are canceled and a corresponding warning appears.
The function exit DG700004 provides you with the following additional functions:
•Individual enhancement for determining the country/mode of transport category combination in shipping and sales documents as an
alternative to the SAP standard method.
Description of the parameters for the function exit DG 700004
I_VSTEL
Shipping point (country of departure)
I_KUNNR
Customer number (ship-to party -> country of destination)
I_ROUTE
Route
E_FLG_NO_SENDER
Indicator set if no country of departure can be determined
E_FLG_NO_RECEIVER
Indicator set if no country of destination can be determined
I_SEND_COUNTRY
Country of departure (from shipping point)
I_REC_COUNTRY
Country of destination (from ship-to party)
E_FLG_NO_SECTIONS
Indicator set if no route stages can be determined
E_FLG_NO_CTRY_DGMOT
Indicator set if no countries and mode of transport categories can be determined
E_SENDER_COUNTRY
Country of departure
E_RECEIVER_COUNTRY

Page 71 of 144
Country of destination
E_ROUTTAB_WA
Work area with data for the current route
E_SD_PROFILESTAB
Table containing the mode of transport categories and countries determined
E_ERRORTAB
Table containing the log entries
E_USX_LOGTAB
Table with log entries for further processing (for example, in the dangerous goods check log)
E_FLG_TRANSIT
Indicator set for trans-frontier transport
E_FLG_BORDER
Indicator set for trans-regional transport
E_FLG_NO_ROUTE
Indicator set if no route is specified or if no route can be determined
E_FLG_NO_VSART
Indicator set if no main leg shipping type is specified
I_DG_CHK_START
Start mode for dangerous goods checks
I_FILL_USX_LOG
Indicator that specifies whether messages have to be written to the table E_USX_LOGTAB

Develop Enh. for Determ. Country/MTC Combination in Shipment

In Dangerous Goods Management, the system determines the country-mode of transport category combinations using the
data in the SD document. You can determine the country-mode of transport category combination in the SD document
individually using the SAP enhancement DG700002 as an alternative to the SAP standard method.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

==

Page 72 of 144
Functions

The function exit DG700002 relates to individual determination of the country/mode of transport category combination in
the shipment document.

In the function module HAZMAT_GET_CTRYS_DGMOT_TRANS (shipment document), the country/mode of transport


category combinations are determined from the shipment legs in the SAP standard method.

If you have set the Take Table for Transit Countries into Account indicator, the system also takes into account all the
transit countries with the relevant mode of transport categories.

If you have not specified any shipment legs, the dangerous goods checks are canceled and a corresponding message
appears.

The function exit DG700002 provides you with the following additional functions:

• Individual enhancement for determining the country/mode of transport category combination in the shipment
document as an alternative to the SAP standard method.

If the function exit DG700002 is activated, the country/mode of transport cateogry combination can be determined, for
example, using the shipment route (in a similar way to shipping). You do not then necessarily need to maintain the
shipment legs.

Description of Parameters for the Function Exit DG700002

I_VTTKVB_WA

Work area in which you can find the header data for the shipment that is currently to be checked. You do not need to
specify the parameter I_VTTKVB_WA if you run the dangerous goods check in the shipping document and sales
document.

I_VTTSVBTAB

Table in which you can find the shipment legs for the shipment that is currently to be checked. You do not need to specify
the parameter I_VTTSVBTAB if you run the dangerous goods check in the shipping document and sales document.

I_VTSPVBTAB

Table in which you can find the assignment of the shipment legs to the shipment items, in other words which deliveries
are to be transported on which shipment legs. You do not need to specify the parameter I_VTSPVBTAB if you run the
dangerous goods check in the shipping document and sales document.

I_VTRLKTAB

Table in which you can find the header data for the deliveries that belong to the shipment document. You do not need to
specify the parameter I_VTRLKTAB if you run the dangerous goods check in the shipping document and sales document.

I_VTTPVBTAB

Table in which you can find the shipment items

Page 73 of 144
E_SD_PROFILESTAB

Table in which you can find the countries and mode of transport categories determined

E_ERRORTAB

Table in which you can find the log entries

E_ROUTTAB_WA

Work area in which you can find the fields for the route table

E_USX_LOGTAB

Table with log entries for further processing (to the log for dangerous goods checks, for example)

E_FLG_IND_SHIPMENT

Indicator that is set for individual shipments

E_FLG_ONE_MOT

Indicator that is set for shipment with only one mode of transport category

E_FLG_NO_CTRY_DGMOT

Indicator that is set if an error occurs while the countries and mode of transport categories are being read

E_FLG_TRANSIT

Indicator that is set for transfrontier shipment

E_FLG_BORDER

Indicator that is set for transregional shipment

E_FLG_NO_ROUTE

Indicator that is set if no route is specified or if no route can be determined

E_FLG_NO_VSART

Indicator that is set if no main leg shipping type is specified

E_FLG_DET_WITH_NO_STAGES

Indicator that is set if countries and mode of transport categories are not determined using the shipment legs

I_DG_CHK_START

Page 74 of 144
Start mode for dangerous goods checks

I_FILL_USX_LOG

Indicator that specifies whether messages have to be written to the table E_USX_LOGTAB

Develop Enhancement for Country/Mode-of-Transport Category C

In Dangerous Goods Management, the system determines the country-mode of transport category combination based on
the SD document. You can add to the country-mode of transport category combinations using the SAP enhancement
DG700001.

If you use the SAP enhancement DG700001, you can:

 Add additional data records, meaning country-mode of transport category combinations

 Select individual data records with regard to their relevance for dangerous goods checks and dangerous goods
documents

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

==

Functionality

In the function modules HAZMAT_GET_COUNTRIES_DGMOT (shipping and sales documents) and


HAZMAT_GET_CTRYS_DGMOT_TRANS (shipment documents), all country/mode of transport category combinations are determined
from the route for shipping and sales documents and from the shipment leg for shipment documents.

Page 75 of 144
If you have set the indicator Take transit country table into account, the system takes all transit countries with the respective mode of
transport categories into account.

The function exit DG70001 provides you with the following additional functions:

• You can add additional country/mode of transport category combinations.

Depending on your business process, you can add additional country/mode of transport category combinations in the table
E_SD_PROFILESTAB.

• You can set data records as relevant for checks and documents.

Using the DGCHECK and DGPAP fields in the E_SD_PROFILESTAB table, the system controls whether a data record is relevant for
checks or documents. You can set whether, for example, data records should be neither checked nor printed on the delivery note, or whether
they should be printed but not checked.

As standard, meaning when the customer exit is not activated, the following logic applies:

All data records are check-relevant and document-relevant with the following exception:

Data records with mode of transport category 20 (pipeline) are fundamentally not check-relevant or document-relevant.

Examples of Business Processes that can be Covered by the Enhancement

Pipeline transport

Business process:

You are transporting a material via pipeline. As there is no dangerous goods regulation for the mode of transport category pipeline, you do
not want the dangerous goods checks to run. You do, however, want to ensure that from the destination address of the pipeline transport a
data record with the country of the destination point and the mode of transport category 'road' is printed on the delivery note. A dangerous
goods check is to be run for this data record.

Solution:

You map this business process by inserting additional data records in the table E_SD_PROFILESTAB and initialize the fields DGCHECK
and DGPAP in the data records with mode of transport category 20.

Combined transport

Business process:

You are transporting the materials that you have entered in the SD document using a forwarding agent. The forwarding agent is to transport
the materials by truck to the railway station and from there, the materials are to be transported by rail. For time and cost reasons, rail transport
is often not possible so that further transport by truck is necessary. Per route stage or leg stage, you can only specify one shipping type.

Solution:

You map this business process, for example, by adding an additional data record with the mode of transport category 'road' via the customer
exit in accordance with the forwarding agent and marking it as check-relevant and document-relevant if necessary.

For more information, see the application help under Special Case: Pipeline Transport.

Not taking countries and mode of transport categories into account

Page 76 of 144
There are country/mode of transport category combinations that are not part of a dangerous goods regulation. If these combinations are taken
into account when the dangerous goods master records are determined, errors occur in the dangerous goods checks, when dangerous goods
data is output on the delivery note, when dangerous goods data is sent via EDI from shipping and shipment documents, and when tremcards
are output.

In this enhancement, you can mark these records as not check relevant and not document relevant. The function module
DG70_CHK_CTRY_MOT is available to you for this.

For more information, see note 0383389.

The customer exit DG 700001 is located in the function group XD71. You will find the standard handling (if the customer exit is not
activated) in the function module HAZMAT_STANDARD_PROFILES.

Description of the Customer Exit Parameters for DG700001

I_VSTEL

Shipping point for the current delivery (delivery document) to be checked or the current expected delivery (sales document) to be checked.
You do not need to specify the parameter I_VSTEL if you run the dangerous goods check in the shipment document.

I_KUNNR

Customer number of the current delivery (delivery document) to be checked or the current expected delivery (sales document) to be checked.
You do not need to specify the parameter I_KUNNR if you run the dangerous goods check in the shipment document.

I_ROUTE

Route of the current delivery (delivery document) to be checked or the current expected delivery (sales document) to be checked. You do not
need to specify the parameter I_ROUTE if you run the dangerous goods check in the shipment document.

I_SEND_COUNTRY

Country of departure of the current delivery (delivery document) to be checked or the current expected delivery (sales document) to be
checked. You do not need to specify the parameter I_SEND_COUNTRY if you run the dangerous goods check in the shipment document.

I_REC_COUNTRY

Destination country of the current delivery (delivery document) to be checked or the current expected delivery (sales document) to be
checked. You do not need to specify the parameter I_REC_COUNTRY if you run the dangerous goods check in the shipment document.

I_VTTKVB_WA

Work area in which the header data for the current transport to be checked is located. You do not need to specify the parameter
I_VTTKVB_WA if you run the dangerous goods check in the shipping and sales documents.

I_VTTSVBTAB

Table in which the shipment legs of the current transport to be checked are located. You do not need to specify the parameter
I_VTTSVBTAB if you run the dangerous goods check in the shipping and sales documents.

I_VTSPVBTAB

Table in which the assignment of the shipment legs to the transport items is located, meaning which deliveries are transported in which legs.
You do not need to specify the parameter I_VTSPVBTAB if you run the dangerous goods check in the shipping and sales documents.

I_VTRLKTAB
Page 77 of 144
Table in which the header data for the deliveries belonging to the shipment document is located. You do not need to specify the parameter
I_VTRLKTAB if you run the dangerous goods check in the shipping and sales documents.

E_SD_PROFILESTAB

Table in which the countries and mode of transport categories determined are located. You can add additional entries to the table via the user
exit or, using the DGCHECK and DGPAP fields, you can control whether the corresponding data record is relevant for checks or documents.

E_ERRORTAB

Table in which log entries are located

E_USX_LOGTAB

Table with log entries for further processing (to the log for dangerous goods checks, for example)

I_DG_CHK_START

Start mode for dangerous goods checks

I_FILL_USX_LOG

Indicator that specifies whether messages have to be written to the table E_USX_LOGTAB

Notes

If you have set the mode of transport category 20 (pipeline) as document-relevant, you must also have entered dangerous goods master
records. If no dangerous goods master records exist, the system terminates the creation of the delivery note, for example.

Develop Enhancement for Editing DG Data in Shipping Document


Using the SAP enhancement DG800001 you can display more data in a screen exit from the Dangerous Goods Additional Data in Shipping
screen.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format. Set the SAPscript
display if required in the structure screen of the Implementation Guide (IMG) by choosing Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP original, but in a
namespace reserved for the customer.

Page 78 of 144
You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online manual.

Functionality

With the enhancement DG800001, it is possible to display other data on the SAPLDG801000 (dangerous goods additional data in the
shipping document) screen in a screen exit, for example, data on the appendix table LIPSDGAP (for exploded materials).

Prerequisites

Data transfer from SAPLDG801000 screen to SAPLXD718000 screen using the function module exit EXIT_SAPLDG80_001

Data transfer from SAPLXD718000 screen to SAPLDG801000 screen using the function module exit EXIT_SAPLDG80_002

OK handling of the SAPLXD718000 screen in the function module exit EXIT_SAPLDG80_003

Create the SAPLXD718000 screen as a subscreen

Note:

The OK code handling for the screen exit SAPLXD718000 is done in the function module exit EXIT_SAPLDG80_003. The function codes
used should be in a different namespace from the function codes used by SAP as the OK handler cannot distinguish between SAP and
customer function codes.

Develop Enhancement for Editing DG Data in Sales Document


Using the SAP enhancement DG800002 you can display more data in a screen exit from the Dangerous Goods Additional Data in Sales
screen.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format. Set the SAPscript
display if required in the structure screen of the Implementation Guide (IMG) by choosing Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP original, but in a
namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online manual.

Functionality

Page 79 of 144
With the enhancement DG800002, it is possible to display other data on the SAPLDG802000 (dangerous goods additional data in the sales
document) screen in a screen exit, for example, data on the appendix table VBEPDGAP (for exploded materials).

Prerequisites

Data transfer from SAPLDG802000 screen to SAPLXD718100 screen using the function module exit EXIT_SAPLDG80_004

Data transfer from SAPLXD718100 screen to SAPLDG801000 screen using the function module exit EXIT_SAPLDG80_005

OK handling of the SAPLXD718100 screen in the function module exit EXIT_SAPLDG80_006

Create the SAPLXD718100 screen as a subscreen

Note:

The OK code handling for the screen exit SAPLXD718100 is done in the function module exit EXIT_SAPLDG80_006. The function codes
used should be in a different namespace from the function codes used by SAP as the OK handler cannot distinguish between SAP and
customer function codes.

The function code used must be linked into the next screen processing of the SAPMV45B program (transaction: VFBS).

Business Add-ins

BAdI: Selection and Determination of DG Master Data

Use

This BAdI allows you to select individual dangerous goods master records from the database and then to determine a
dangerous goods master record, dependent on selection criteria.

The method DG_MASTER_SELECT is called in the function module HAZMAT_RECORD_READ_FROM_DB and is


processed instead of the intended logic to read dangerous goods master records from the database. You can use the
module HAZMAT_RECORD_READ_FROM_DB as a template for developing your own method.

The method DGTMD_RECORD_DETERMINE is called in the function module


HAZMAT_GET_DGTMD_RECORD_FRAME and processed instead of the intended logic to determine the relevant
dangerous goods master record using predefined selection criteria. You can use the module
HAZMAT_GET_DGTMD_RECORD_FRAME as a template for developing your own method.

Example

In the method DG_MASTER_SELECT you can fill additional dangerous goods master records into the export table
E_BUFTAB. In the method DGTMD_RECORD_DETERMINE, the relevant dangerous goods master record can be
determined from these preselected data records that are in the import table I_DGTMD_TAB, using the selection criteria in
the import parameters.

BAdI: Integration of Shipment Document 001

Use

This Business Add-In (BAdI) is used in Transportation Processing and Dangerous Goods Management (EHS-DGP)
components.
Page 80 of 144
The BAdI is used for enhancements when additional screen fields are used in the shipment document. It allows you to
implement an additional maintenance table in the shipment document, tab page 'Dangerous Goods'.

There is no default implementation and the BAdI is not filter-dependent.

For information about implementing BAdIs as part of the Enhancement Concept, see SAP Library for SAP NetWeaver
under BAdIs - Embedding in the Enhancement Framework.

See also

This BAdI uses the interface IF_EX_BADI_EHSDG_SH_001.


For more information, see the interface in the Class Builder.

Specify Regulation Profile


In this IMG activity, you define regulation profiles.
This enables you to specify, depending on the material, the dangerous goods regulations for which the following
additional dangerous goods regulations are to be used in SD processing (shipping, sales):
 Exemption
 Reportable quantity
 Exemption highly viscous
 Listed goods

Example
You can specify for a particular material that the regulation Exemption is only used for the regulation ADR.

Activities
Create a profile and assign one or more regulations to this profile under Regulation/Profile Assignment.

Specify Indicator Category

In this IMG activity, you specify which regulation profiles should be available in the phrase sets for the indicators for
additional dangerous goods regulations:
 Exemption
 Reportable quantity
 Exemption highly viscous
 Listed goods
 Excepted quantity

Page 81 of 144
The indicator categories 0001 - 0005 are standard system customizations.

Additional indicator categories are not evaluated in the standard system.

Example

The assignment 0005 = Befreite Menge is fixed. In the application, this means also the 0005 is used as a selection in the
input help for the excepted quantity.

Activities
Assign regulation profiles for the phrase set to the indicators via Assignment Indicator Category/Regulation Profile.

Specify Relevant Dangerous Goods Master Tables

Use

In this IMG activity, you specify the dangerous goods master tables that are to be read for the respective dangerous goods
processes.

If you assign only the necessary tables, you improve the performance of your system.

Standard settings

Default settings are supplied.

Activities

You can assign the dangerous goods master tables listed below to the dangerous goods checks:
 DGTPK Dangerous goods packaging, old table
 CCDUTPACK Dangerous goods packaging, new table
 CCDUTSPROV Special packing provisions
 CCDUTTRAPPR Transport restrictions
 CCDUTDGREL Product release
 CCDUTCARR Provisions for carriage

You can assign the dangerous goods master tables listed below to the dangerous goods documents/EDI:
 CCDUTTRAPPR Transport restrictions
 CCDUTDGREL Product release
Page 82 of 144
 CCDUTCARR Provisions for carriage

The tables DGTPK, CCDUTPACK, and CCDUTSPROV are not available for the dangerous goods documents/EDI.
Instead, you can output packaging data via the product release.

To assign a dangerous goods master table to a dangerous goods process, set the Read Table indicator.

Specify Indicators for Transport

Use

Indicators for transport replace the existing dangerous goods indicators used in the product release and in the dangerous
goods supplement. You can define your own indicators for transport, whereas the previously used dangerous goods
indicators were predefined by the system.

In this Customizing activity, you create your own indicators for transport and assign these the dangerous goods
regulations for which you want to use the indicators for transport. You can also specify whether you want to use the
indicators for transport in the product release, in the dangerous goods supplement, or in both.

Note: If you do not assign any dangerous goods regulations to an indicator for transport, the indicator for transport is used
for all regulations that you have created in Customizing.

Requirements

You have created the dangerous goods regulations that are relevant for you in the Specify Dangerous Goods Regulations
Customizing activity.

Standard settings

Corresponding indicators for transport for the previously used dangerous goods indicators are shipped with the standard
system.

Activities

1. Create an indicator for transport and enter the name of the indicator for transport in the language you require.

2. Select the indicator for transport.

3. Choose Assignment to Regulation.

4. Assign the corresponding dangerous goods regulations to the indicator for transport.

Page 83 of 144
Show Dangerous Goods Indicators in Dangerous Goods Supplement

Use

During a transitional period, you can select this checkbox to display the previously used dangerous goods indicators in the
dangerous goods supplement, in addition to the indicators for transport.

You can show or hide the dangerous goods indicators at any time.

Note: Dangerous goods indicators and indicators for transport are not linked to each other. Changes to dangerous goods
indicators are not automatically applied to the indicators for transport # and vice versa.

Dangerous Goods Checks

Activate Dangerous Goods Checks


To carry out dangerous goods checks in a client, you must activate the dangerous goods checks in this IMG activity.
The dangerous goods check method describes how the check is executed on the activation of the dangerous goods
checks under FM for activation check.
Page 84 of 144
You use the Document items relevant for checks only indicator to specify if all document items or only those relevant for
dangerous goods are to be transferred to dangerous goods management. Document items relevant for dangerous goods
must have a dangerous goods indicator profile in the material master. This profile must be marked as relevant for
checks.
If you have not set the Document items relevant for checks only indicator, all document items are transferred to the
dangerous goods checks. The following document items are then checked in accordance with the item category:
 Normal items
These items are always checked.
 Value items
These items are checked only if the material is assigned to a dangerous indicator profile in the material master. In
the sales document, value items are checked only if they are relevant for delivery.
 Text items
These items are checked only if the material is assigned to a dangerous indicator profile in the material master. In
the sales document, text items are checked only if they are relevant for delivery.
 Packing items
These document items are not checked.
You define item categories in Customizing for Sales and Distribution.
Standard settings
There is an SAP standard method for activation checks for dangerous goods checks (function module
HAZMAT_CHK_ACTIVE). This method checks using the Dangerous goods checks active indicator to be set in this IMG
activity.
The Document items relevant for checks only indicator is also set in the standard.
In the standard system, template processing and one-time processing, dynamic classification and dangerous goods
integration in Handling Unit Management (in shipping documents) are not active.

Note:
You can activate template and one-time material processing in this IMG activity. You can make other settings for
template and one-time material processing under the IMG node Template and One-Time Material Processing in
Customizing for Dangerous Goods Management.
If you activate dynamic classification, then you must specify the dangerous goods profile for materials that are to be
classified dynamically in the IMG activity, Specify Indicator Profiles for the Material Master.

Recommendation
If you generally have a lot of document items and few dangerous goods items, set the Document items relevant for checks
only indicator.

Activities

1. Call the IMG activity.


2. Check whether the SAP standard method entry is available.
3. If required, enter your own method. The function module interface must be identical to the interface of the SAP
standard method HAZMAT_CHK_ACTIVE.
4. Set the Dangerous goods checks active indicator to activate the dangerous goods checks.
5. Set the Document items relevant for checks only indicator if only the dangerous goods relevant document items are to
be transferred to dangerous goods management.
6. Do not set the Document items relevant for checks only indicator if all items are to be transferred to dangerous goods
management.
7. Set the Template material processing active indicator if you want to use template and one-time material processing.
8. Set the HU Integration Active indicator, to activate Handling Unit Integration (in shipping documents). See further
notes.
Page 85 of 144
Further notes
You can only activate HU integration if the status Incomplete for packing is not set in the status groups for the entries G1
and G2 in the incompleteness control for sales and shipping documents.
If you want to use the product release for fully packaged goods at the same time as HU integration, you must specify the
dangerous goods packaging status in the material master for the dangerous goods material.
If you want to use HU integration, and you have already released the products, you can use report
DGP_PACK_STATUS_SET. This report fills the dangerous goods packaging status in the material master with the value
Packaged (PACKEDPROD) for all dangerous goods materials that have already been released.

Restrictions
Dangerous goods integration in Handling Unit Management is limited to manual processing of shipping document
(transactions VL01N and VL02N). Within this processing, it is limited to the Pack and Selection of permitted packaging
materials functions. The Automatic packing, Per Part Qty und If Full functions are not supported.
Dangerous goods processing is also not integrated in the Packing Station function. A notification indicates that the
system does not support the packing of dangerous goods materials if the HU integration is active and a dangerous goods
material is to be packed.
Definition: dangerous goods check method

Environment, Health and Safety (EHS)

A check method that compares data from the sales and distribution document with data from the dangerous goods master.

Dangerous goods check methods are realized as function modules (user exits). You can assign a response type
(information, warning, error, or termination) for each method in Customizing for Dangerous Goods Management.

The following methods are delivered in the standard system:

 Check for completeness of data

 Check for permissibility of mode of transport category

 Check for "poisonous by inhalation"

Definition: dangerous goods indicator profile

Environment, Health and Safety (EHS)

A profile of settings for the material master.


The dangerous goods indicator profile controls whether a material in the material master is relevant for:
 Dangerous goods
 Dangerous goods and dangerous goods documents
 Dangerous goods and dangerous goods checks
 Dangerous goods, dangerous goods checks, and dangerous goods documents

This indicator profile is used for controlling the following applications:


 Checks
 Documents/EDI

Page 86 of 144
Specify Dangerous Goods Check Methods

Use

Dangerous goods checks are implemented in the form of function modules as user exits. In this IMG activity, you assign
the function modules and define a dangerous goods check method.

Standard settings

The following function modules are delivered in the standard system:

 HAZMAT_CHK_VARIOUS - check if data is complete

This check method handles errors, for example, if no route was entered in the delivery header or no dangerous
goods master record could be determined.

 HAZMAT_CHK_MOT - check if mode-of-transport category is approved

Checks the 'Transp not approved' field in the dangerous goods master. If this indicator is set, the system processes
the reaction set up in the check schema.

 HAZMAT_CHK_PIH - poisonous by inhalation check

Checks the 'hazard zone' field in the dangerous goods master. If a hazard zone has been entered, the system
processes the reaction set up in the check schema.

 DG63_CHK_INIT_HEADER

The function module is used as an initialization module for header check methods, in other words dangerous
goods check methods for which all dangerous goods master records for the current document must be available,
for example, mixed loading checks.
The function module collects all dangerous goods master records and packaging data records for the current
document.

 DG63_CHK_MLOAD

The function module is used for checking prohibitions of mixed loading.

 DG63_HU_CHK_INIT_MPACK (Simple Mixed Pack. Check (Std.) Initialization)

Page 87 of 144
Initialization function module for the simple mixed packaging check. The function module is only relevant if
dangerous goods integration is active in Handling Unit Management (in the sales document). The module collects
the data for the selected delivery item when packaging in a handling unit.

 DG63_HU_CHK_MPACK (Simple Mixed Packaging Check (Std.))

Mixed packaging check for the delivery item when packaging in a handling unit. The system checks that the UN
numbers are the same for the dangerous goods relevant materials. The function module is only relevant if
dangerous goods integration is active in Handling Unit Management (in the sales document).

There are sample entries for dangerous goods check methods for these function modules in standard Customizing.

For the check method with the function module HAZMAT_CHK_VARIOUS, you must enter sequence 1 in each
dangerous goods check schema. No usage profile is required for this check method. If you define a usage profile for the
method, this will not be taken into account.

If you want to change the function module HAZMAT_CHK_VARIOUS, you must create a copy, change it, and define
the new function module as a check method. Otherwise your changes will be overwritten by the SAP standard version of
the module every time you update.

Prerequisites:

The check method with the function module DG63_CHK_INIT_HEADER must be before the first header check method.

Activities

1. Call the IMG activity.

2. Define function modules as dangerous goods check methods and enter the language-dependent descriptions in all
application languages you use.
Only assign function modules whose interface corresponds to the interface for the function modules in the function group
DG63.

3. Assign check method types to the function module as required.

Specify check method type '01' if the check method determines an indicator used to print texts on transport documents, for
example. When you call dangerous goods checks during the course of indicator determination for dangerous goods
documents/EDI in shipment documents, only these check methods from the check schema are processed.

 Specify check method type '02' so that header check methods (for example, mixed loading checks) are recognized as
such.

 Specify check method type '03' so that header initialization check methods are recognized as such.

 Specify check method type '04' so that the initialization check methods (for example, for the simple mixed packaging
check or to check the individual items) are recognized in dangerous goods integration in Handling Unit Management.

 Specify check method '05' so that header check methods (such as simple mixed packaging check) are recognized in
dangerous goods integration in Handling Unit Management.

 Specify check method '06' so that the initialization check methods (for example, for a check of the packaging or check
of individual items of packaging) are recognized in dangerous goods integration in Handling Unit Management.
Page 88 of 144
 Specify check method '07' so that header check methods (such as the check of the gross mass for packaging)are
recognized in dangerous goods integration in Handling Unit Management.

You can use check methods '04' and '06' or '05' and '07' to start initialization and header check methods at different points
in time.

In the shipment document, you can determine the following indicators using your own check methods:

 Dangerous goods management profile for SD documents (GG_DG_RDGLKPRO-PROLI)

 Listed goods (E_CHK_PAP_FLAGSTAB-DGPAS)

 Reportable quantities (E_CHK_PAP_FLAGSTAB-DGREPQU)

In shipping and sales documents, you can determine the following indicators using your own check methods:

 Dangerous goods management profile for SD documents

 Exemption

 Reportable quantities

 Exemption highly viscous

 Listed goods

The dangerous goods management profile is a parameter of the interface to the main program and is transferred to the
shipping or sales header. The remaining indicators are stored in the database and added to the shipping document at item
level or to the sales document at schedule line level.

The rating of a check method as 'indicator determination method' is only required for shipment documents, as the
indicators are determined there dynamically by calling dangerous goods checks within dangerous goods documents/EDI.
In this case, only indicator determination methods are processed. This is guaranteed by the assignment of check method
types.

The indicators are determined in shipping documents when the dangerous goods checks are started in the dialog. The
indicators are stored in the database (tables LIPSDG) and are later taken into account by dangerous goods documents/EDI
if these are started in shipping documents.

The indicators are determined in sales documents when dangerous goods checks are started in the dialog. The indicators
are stored in the database (table VBEPDG).

Further notes

If you create your own function modules for dangerous goods check methods, you must retain the interface used for the
function modules delivered in the standard system. To do this, use one of the function modules named above as a
template. These function modules are found in the function group DG63.

Page 89 of 144
Specify Usage Profiles for Dangerous Goods Check Methods

Use

In this IMG activity, you specify the usage profiles for dangerous goods check methods.

Using this IMG activity, you can set the check methods to run in accordance with the mode-of-transport category, validity
area, and function.
These context-dependent usage profiles improve performance considerably. For example, you can restrict the check
method "poisonous by inhalation" to the validity area USA, the mode-of-transport category 99 (all mode-of-transport
categories), and the function recipient country. The system then just checks in this context.

If you do not enter a usage profile for a check method, the check method for all countries and mode-of-transport
categories for the document is processed. This means that for every material/country/mode-of-transport category
combination in the document, the system attempts to find a dangerous goods master record that can be checked with the
check method.

A usage profile key is composed of the following elements:

 Dangerous goods check method

 Mode-of-transport category

 Validity area

You must also specify which function the countries (or regions) in the validity area are to perform for the shipment during
the check. The following functions are supported:

1 Departure country

2 Transit country

3 Destination country

4 Departure and transit country

5 Transit and destination country

6 Departure and destination country

Page 90 of 144
7 Departure, transit, and destination country

During the dangerous goods checks, these countries are determined as follows:

 Departure country in sales and shipping documents from the shipping point

 In shipment documents from the departure nodes in the first shipment stage

 Transit country from the route or shipment stages or the transit country table

 Destination country in sales and shipping documents from the ship-to party

 In shipment documents from the destination country for the last shipment stage

To check the usage profiles, all country/mode-of-transport category combinations are determined from the document. A
check method is processed if the mode-of-transport category and at least one country in the validity area are present in the
document. If you do not define a usage profile for a check method, the check method is always processed.

When you define usage profiles, you must take into account that the mode-of-transport category and validity area in the
profile are used during the processing of the check method to read the relevant dangerous goods master record that is used
for the check. Because of this, you should always enter the usage profile for a check method with regard to the dangerous
goods regulations you are using in the dangerous goods master.

Requirements

You have defined dangerous goods check methods in the IMG activity Specify Dangerous Goods Check Methods.

You have defined validity areas in the IMG activity Specify Validity Areas.

Activities

1. Call the IMG activity.

2. Specify the usage profile by assigning a dangerous goods check method, a mode-of-transport category, and a
validity area to the profile.

3. Assign a function to this usage profile.

This assignment is optional.

Example

The check method Permissibility of mode-of-transport category (function module HAZMAT_CHK_MOT) must be
carried out for each regulation mapped in the dangerous goods master. You could specify the following usage profiles for
this usage profile, for example:

ModeTransportCat. Validity Area Dangerous Goods Regulation

Road(01) REG_ADR ADR

Page 91 of 144
Rail(02) REG_RID RID

Inland waterway(03) REG_ADNR ADNR

Sea(04) REG_WORLD IMDG

 The dangerous goods regulation that is defined by mode-of-transport category and validity area in Customizing for
Dangerous Goods Management is used in the dangerous goods master. The third column in the above example
contains the corresponding dangerous goods regulation for dangerous goods master records on which the example is
based.

 If transport takes place on the mode-of-transport category road and goes through a country in the validity area
REG_ADR, the materials are checked using the dangerous goods master record with the dangerous goods regulation
ADR. If transport also takes places on mode-of-transport category rail and goes through a country in the validity area
REG_RID, the materials are also checked using the dangerous goods master record with the dangerous goods
regulation RID.

 If you define several usage profiles for a combination of check method and mode-of-transport category, the profile
with the most restricted validity area is used to read the dangerous goods master record.

This corresponds to the 5-levels concept (non-overlapping principle of the validity areas) for the dangerous goods master.
For more information, see the application help under Dangerous Goods Master -> Checking Validity Areas.

Further notes

 Entries for check method 1 (GENERAL CHECKS) are ignored when the check methods are processed.

 Entries for check methods that are identified as initialization check methods for header checks ('03') only make
sense if the same usage profile is available for the header check methods on which they are based, since otherwise
the dangerous goods master records are not available for all validity areas.

Incompleteness Control for SD Documents


Instructions for Incompleteness Status in Dangerous Goods Management

When you define a dangerous good check schema, you assign check methods and set for each check method whether a
document can be saved and any follow-on activities can be prevented if this check method determines the complete
reaction for the check schema. If the options 'Save' and 'Document block' are set, the incompleteness status that you set
here for the dangerous goods checks is set in shipping documents.

The V50UC-DGOODS1 and V50UC-DGOODS2 fields are used to define this incompleteness status. V50UC-DGOODS1
is used if save with incompleteness status is allowed in Customizing. V50UC-DGOODS2 is used if saving is not allowed.
To ensure a consistent run, V50UC-DGOODS1 must be assigned an incompleteness status that allows the delivery to be
saved as a follow-up action (when defining the corresponding status group, the 'Delivery' column must NOT be flagged).

Page 92 of 144
V50UC-DGOODS2 must be assigned an incompleteness status that prevents the delivery from being saved as a follow-up
action (when defining the corresponding status group, the 'Delivery' column must be flagged).

In standard Customizing, the status groups G1 and G2 are shipped. Check whether you can transfer the status groups, for
example, whether G1 can be assigned to the field V50UC-DGOODS1 and G2 to the field V50UC-DGOODS2.

If the Document block indicator is set in the IMG activity Specify Dangerous Goods Check Schemas, that means for return
code 1 and 2, the system writes a corresponding entry in the incompleteness log for sales using the VGGP field in the
table RV45A_UV. The system takes the status group 2, which means that creating a shipping document with reference to
the order is prohibited.

Instructions for the Sales and Distribution IMG

In the following IMG activities, you define when a sales document or sales activity should be regarded as incomplete and
how the system should respond when you create a document.

The system can make an entry in the incompletion log for the following data:

 Sales document header data

 Sales document item data

 Sales document schedule line data

 Sales activity data

 Partner data in sales documents, deliveries and sales activities

 Delivery header data

 Delivery item data

Note

Note that different procedures can be assigned to the partners in the documents if they have different partner functions.
However, the required data for a partner function is relevant for all procedures.

You can generate entries for texts and prices in the incompletion log although there may not be a procedure defined for
this:

The system only makes an entry for texts if it is marked as obligatory in the text determination settings.

Entries for pricing can be made in the sales document if the PRSOK field in the incompletion procedure for sales items is
copied and set to blank or zero in pricing. This is used for obligatory prices that are not available in the document, or for
errors that occur when converting quantities and foreign currencies.

The CEPOK field in the incompletion procedure for sales items allows you to make an entry in the incompletion log if the
price deviates from the expected customer price too much.

Special features in the incompletion log for shipping processing

Page 93 of 144
Dynamically determined document characteristics:

During document processing, the system determines field entries in the procedure with the prefix (table name) 'V50UC'.
Unlike other cases, these entries do not correspond to a missing entry in a database table but, similar to pricing, indicate
complex document characteristics. This kind of incompletion cannot necessarily be processed by filling an empty field.
For example, the log may indicate that the batches of an item have not been assigned completely, so you may have to
change the main item quantities or the split quantities.

Follow-up activities that you can control:

You can use the incompletion log to control follow-up activities such as picking, goods movement (posting goods issue),
and packing (deliveries only).

If the incompletion log determines for a delivery that the follow-up function 'delivery' is not possible, you cannot save the
document. This delivery is not included in collective processing and the collective processing log contains information to
that effect.

Example

For example, the standard system checks whether the "purchase order number" field at header level in an order is
complete.

This field is used in the incompletion procedure for orders. The procedure is assigned to all those sales document types
which need a purchase order number and which therefore should be checked for completion.

If you do not enter any data in this field when processing a sales document you will receive a warning.

The order can be saved but its status group means that it will be blocked for all subsequent functions. Once you have
entered the purchase order number in the document, the block will be lifted.

The relevant specifications for warnings and blocks are defined in the purchase order number field in the incompletion
procedure.

Note on transport interface

In the transport, all objects which were maintained in Customizing for controlling incomplete documents are transported.
In the correction which is created for the transport, you can check the transport orders in the tables and delete the entries
which should not be transported.

Specify Incompleteness Procedures

Instructions for Sales and Distribution IMG

In this IMG activity, you define the incompleteness procedures that should apply to the various incompleteness objects.
Page 94 of 144
In an incompleteness procedure you group together the fields that are to be checked for completeness. If you have not
entered data in one of the fields in the document, the document is incomplete. Depending on the status group you can
block certain subsequent activities for the document.

For every field in the procedure you also have to define whether a warning message should be issued during processing if
no data is entered in this field. This function does not exist in delivery processing. When you select the control field, it has
no further consequences.

Requirements

You must have defined the status groups to be able to assign them to the fields you have selected for a procedure (see
Define Status Groups section).

Activities

1. Check to what extent you can adopt the defaults for the incompleteness procedures that are defined in the
standard system.

2. Change the specified incompleteness procedures according to your requirements. Define new incompleteness
procedures, if necessary. Bear in mind that you have to do this for every incompleteness object.

Further notes

Incompleteness procedure 50 is defined for incomplete texts in sales document processing. If you want to assign your own
status group to this procedure, you need to process View V_TVUF directly with the transaction for Maintain table view.
Note that the changes you make in this transaction affect all sales document categories.

Page 95 of 144
Assign Incompleteness Procedures

Instructions for Sales and Distribution IMG

In this step, you assign procedures to the different incompleteness objects.

Specify Status Groups

Instructions for Sales and Distribution IMG

In this IMG activity, you use status groups to define the status of incomplete sales and distribution documents. Then
assign the status group to the fields in an incompleteness procedure.

In the status group, you define which functions may be carried out for an incomplete sales and distribution document, or
for the items where a field entry is missing. You use this function to block a document for delivery, billing, or pricing. In
addition, you can check at header level whether the general data is complete.

Example

Fields that are defined for deliveries do not also have to apply to the billing document. If you allocate the relevant status
group to these fields in the incompleteness procedure, you can create a billing document for the incomplete sales order
but not a delivery.

Activities

1. Check to what extent you can use the defaults for status groups that are defined in the standard system.

Page 96 of 144
2. Change the existing status groups according to your requirements. Create new groups, if necessary.

3. Afterwards specify status groups for fields in the incompleteness procedures (see section Define
Incompleteness Procedures).

Specify Dangerous Goods Check Schemas


Use
In this IMG activity, you combine dangerous goods check methods into one dangerous goods check schema and set up
a reaction for each check schema and check method that influences how the SD document is processed further.
Requirements
The dangerous goods incompleteness status must have been created in status management for SD documents (see chapter:
Incompleteness Control for SD Documents).
New messages must be created using the ABAP Workbench.
Standard settings
Sample settings are delivered.
Activities
1. Call the IMG activity.
2. Create a new check schema and record descriptions in the required languages.
3. Select the required dangerous goods check schema.
4. Choose Assignment check schema/check methods in the navigation.
5. Assign a sequence number for the dangerous goods check method.
Note:
You MUST have entered the check method with the function module HAZMAT_CHK_VARIOUS in each check
schema as check method with sequence 1, or if you want to change this module, you must have entered your own
module for the completeness check.
The check methods are processed in the sequence specified.
The initialization module DG63_CHK_INIT_HEADER must come before the first header check method (for
example, mixed loading checks).
6. Assign a reaction type to the respective check method.
You can enter the following reaction types:
Page 97 of 144
Value Meaning

I Information

W Warning

E Error

A Termination due to negative check results

X Termination due to positive check results

When processing the dangerous goods check methods, an overall reaction for the dangerous goods check schema is
determined from the reactions of the check methods that have 'reacted'. For this, A > E > W > I/X. The strictest reaction
type determines the overall reaction for the check schema. If several check methods react with the same reaction type, the
save setting decides which method determines the overall reaction. Reaction type A leads to a termination of the
dangerous goods check schema. Dangerous goods check methods present in the dangerous goods check schema are not
processed any further. The system exits the dangerous goods check. Reaction type X leads to a termination of the
dangerous goods check schema for the current material. The system proceeds to the next SD document item.

For dangerous goods checks in sales, a complete reaction is determined for each expected delivery and the complete
reaction for the document results from the strictest reaction of the individual expected deliveries.

7. Assign a message class and message number to the respective dangerous goods check method.

The message set up is displayed in the dialog box for the dangerous goods check and written to the check log. For the
check method you entered in the schema with sequence 1, you need not make these entries if you use the standard SAP
module HAZMAT_CHK_VARIOUS. This sets both entries. If you replace this module with one of your own, you must
assign it a message class and number.

8. If the SD document is to be blocked (shipment document) or the incompleteness status is to be set (sales and shipping
document), set DocBlk (document block).

9. If the SD documents are to be saved after the dangerous goods check is finished, set either SaCoPr or SaOnli.

The SaCoPr indicator has no relevance for dangerous goods checks in sales as documents cannot be created using
collective processing in sales.

In the shipping document, the SaOnli indicator controls the structure of the dialog box used to display the message set up
here in the SD document. If the indicator is set, a selection of functions to save the document is also displayed in the
dialog box. As the indicator is set according to the dangerous goods check method and reaction, you can specify if the
person processing the document is to be permitted to save it in the case of reactions of type "E = Error", for example. The
person processing the document can then decide whether to save the document or not.

You use the SaCoPr indicator to specify if the document can be saved in collective processing. In the shipment document,
the setting 'do not save' (the SaCoPr and/or SiOnli fields are not set) cannot be processed for technical reasons. This
setting is automatically changed to 'save with document block' (SaOnli and DocBlk indicators).

Page 98 of 144
You use the DocBlk indicator in the sales and shipping document to set the previously set incompleteness status that
prevents subsequent functions. If the incompleteness status is set in the sales document, the system prevents a shipping
document being created with a reference to this job.

In the shipment document, a block indicator is set in the shipment header. The block indicator or incompleteness status is
removed if a new check has positive results. Sales and shipping documents are not saved if you only set the DocBlk
indicator and do not set the SaCoPr and SiOnli indicators.

Definition: dangerous goods check method


Environment, Health and Safety (EHS)

A check method that compares data from the sales and distribution document with data from the dangerous goods master.
Dangerous goods check methods are realized as function modules (user exits). You can assign a response type
(information, warning, error, or termination) for each method in Customizing for Dangerous Goods Management.
The following methods are delivered in the standard system:
 Check for completeness of data
 Check for permissibility of mode of transport category
 Check for "poisonous by inhalation"

Definition: dangerous goods check schema

Environment, Health and Safety (EHS)

A check schema assigned to the dangerous goods check method.

Assign Dangerous Goods Check Schemas

Page 99 of 144
Assign DG Check Schemas for Sales Documents

Use

In this IMG activity, you specify in which context dangerous goods check schemas are used in sales documents.

You use the following criteria:

 Sales organization

 Sales document category

You can only enter sales document categories that are supported for dangerous goods management (see the
possible entries help (F4) for sales document categories).

 Sales document type

The dangerous goods check schema determination routine defined in one of the previous IMG activities checks the table
entered in this IMG activity and processes the dangerous goods check schema it finds.

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.

2. Choose Edit -> New Entries.

3. Enter the sales organization, sales document category, and sales document type and assign a dangerous goods
check schema to this context.

Further notes

The check schemas are determined according to the following logic:

The first step reads:

a) Sales organization/sales document category/sales document type


If this fails, it reads:

b) Sales organization/sales document category


Then it reads:

c) Sales document category/sales document type


Then it reads:

d) Sales document category only


If no check schema is found, it reads without:
Page 100 of 144
e) Sales organization/sales document category/sales document type

If is still finds no check schema, a message is displayed and the dangerous goods checks are not processed.

Using this processing logic, it is possible, for example, that the same check schema is always assigned to a sales document
category, independent of the sales organization and sales document type.

Definition: sales organization

Sales and Distribution (SD)

A organizational unit in Logistics that structures the company according to its sales requirements.
A sales organization is responsible for selling materials and services.

Assign DG Check Schemas for Shipping Documents

Use
In this IMG activity, you specify the context in which dangerous goods check schemas are to be used in shipping
documents.

You use the following criteria:


 Sales organization
 Shipping document category
o You can only enter shipping document categories that are supported for dangerous goods management (see
the possible entries help (F4) for SD document categories).
 Delivery type
o The dangerous goods check schema determination routine defined in one of the previous IMG activities
checks the table entered in this IMG activity and processes the dangerous goods check schema it finds.

Standard settings
A sample setting is delivered in the standard system.

Activities
1. Call the IMG activity.
2. Choose Edit -> New Entries.

Page 101 of 144


3. Enter the sales organization, shipping document category, and delivery type and assign a dangerous goods check
schema to this context.

Further notes
The check schemas are determined according to the following logic:
The first step reads:
a) Sales organization/shipping document category/shipping document type

If this fails, it reads:


b) Sales organization/shipping document category

Then it reads:
c) Shipping document category/shipping document type

Then it reads:
d) Shipping document category only

If no check schema is found, it reads without:


e) Sales organization/shipping document category/shipping document type
If it still finds no check schema, a message is displayed and the dangerous goods checks are not processed.
Using this processing logic, it is possible, for example, that the same check schema is always assigned to a shipping
document category, independent of the sales organization and shipping document type.

Assign DG Check Schemas for Shipment Documents

Use

In this IMG activity, you specify the context in which dangerous goods check schemas are to be used in shipment
documents.

You use the following criteria:

 Transportation planning point

 Shipment type

Page 102 of 144


The dangerous goods check schema determination routine specified in one of the subsequent IMG activities checks the
table entered in this IMG activity and the dangerous goods check schema found is processed.

Standard settings

Default settings are shipped.

Activities

1. Call the IMG activity.

2. Enter the transportation planning point, shipment type, and assign the key a dangerous goods check schema.

Further notes

The SD document category is predefined here and cannot be edited, as only category 8 is currently supported for shipment
documents.

The check schemas are determined according to the following logic:

The first step reads:

a) Transportation planning point/shipment document category/shipment type

If this fails, it reads:

b) Transportation planning point/shipment document category

Then it reads:

c) Shipment document category/shipment type

Then it reads:

d) Shipment document category only

If no check schema is found, it reads without:

e) Transportation planning point/shipment document category/shipment type

If it still finds no check schema, a message is displayed and the dangerous goods checks are not processed.

Using this processing logic, it is possible, for example, that the same check schema is always assigned to a shipment
document category, independent of the transportation planning point and shipment type.

Page 103 of 144


Assign DG Check Schema Determination Routines

Assign for Sales and Shipping Documents

In this IMG activity, you specify the dangerous goods check schema determination routines for shipping and sales
documents.

Dangerous goods check schema determination decides which dangerous goods check schemas are used in a shipping
document or sales document.

Dangerous goods check schema determination is carried out using a dangerous goods check schema determination
procedure (function module).

A dangerous goods check schema determination procedure can be assigned to a sales organization. When determining
the dangerous goods check schema determination routine, the system first searches for an entry that has been assigned a
sales organization. If no such entry is found, the system searches for another entry that has not been assigned a sales
organization.

Standard settings

The system supports HAZMAT_CHK_FIND_SCHEMA as a standard routine. This standard routine is structured to fit the
standard settings in the dangerous goods check schema (see the IMG activity Specify Dangerous Goods Check
Schemas).

Activities

1. Call the IMG activity.

2. Check if the standard routine HAZMAT_CHK_FIND_SCHEMA is present in the system.

Further notes

You can develop your own dangerous goods check schema determination routines that determine the check schema
according to your criteria. They must have the same interface as the SAP standard method
HAZMAT_CHK_FIND_SCHEMA. Assign function modules with this interface only.

Page 104 of 144


Assign for Shipment Documents

In this IMG activity, you specify the dangerous goods check schema determination routines for shipment documents.

The dangerous goods check schema determination determines which dangerous goods check schema is used in a shipment
document.

The dangerous goods check schema determination is represented in a dangerous goods check schema determination
routine (function module).

A dangerous goods check schema determination routine can be assigned to a transportation planning point. When
determining dangerous goods check schema determination routines, the system first looks for an entry with transportation
planning point assignment. If no such entries exist, the system then looks for an entry without transportation planning
point assignment.

Standard settings

The system supports HAZMAT_CHK_FIND_SCHEMA as a standard routine. This standard routine is tailored to fit the
standard settings for the dangerous goods check schema (see IMG activity Specify Dangerous Goods Check Schemas).

Activities

1. Call the IMG activity.

2. Check if the standard routine HAZMAT_CHK_FIND_SCHEMA exists in the system.

Further notes

You can develop your own dangerous goods check schema determination routines that determine the check schema
according to your criteria. They must have the same interface as the SAP standard method
HAZMAT_CHK_FIND_SCHEMA. Assign function modules with this interface only.

Page 105 of 144


Merge Item and Delivery Scheduling Data for Expected Deliver
Using the SAP enhancement DG600001 you can merge item data and delivery schedule data for expected deliveries.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

SAP enhancement DG600001. Functionality

Expected deliveries are formed for the dangerous goods checks in the sales document. Before these deliveries are created,
the item data and schedule line data in the sales document that are relevant for dangerous goods are combined to form a
data structure (RDGDATAC). If there are, for example, two relevant delivery schedule lines for one item, this results in
two combined data records. The expected deliveries are determined in the table with the merged data records.
The function exit DG600001 enables you to determine the merged data records yourself as an alternative to the SAP
standard method. For more information about the logic of the SAP standard method, see the application help.

Description of the Parameters for the Customer Exit DG600001

FLG_WE_EQ_AG

Indicator that specifies whether the ship-to party at item level matches the sold-to party at header level.

I_KUNNR

Page 106 of 144


Sold-to party

I_DG_CHK_START

Start mode for dangerous goods checks. The start mode can be used to control outputs; for example, information can be
output in start mode 08 or 09, but not in start mode 10, which runs in the background.

 08: Manual start by pushbutton

 09: Automatic start before the sales document is saved

 10: Automatic start during initial data transfer (background)

I_VBAP_DGPOSTAB

Sales items that are relevant to dangerous goods

I_VBEP_DGSLINETAB

Sales schedule lines that are relevant to dangerous goods

I_VBPATAB

Partner table

E_MIXTAB

Table with merged item data and schedule line data

E_USX_LOGTAB

Error table. This is where error messages (E messages) are logged.

Determination of Expected Deliveries


Using the SAP enhancement DG600002 you can determine expected deliveries.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

Page 107 of 144


2. Activate the project.

Your enhancement will only take effect when activated.

Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

=SAP enhancement DG600002. Functionality

Expected deliveries are formed for the dangerous goods checks in the sales document. According to the SAP standard
method the following criteria are checked:

 Ship-to party

 Goods issue date

 Shipping point

 Route

 Arrival time

With this enhancement you can create an expected delivery according to your own criteria.

Description of the Parameters of the Customer Exit DG600002

I_EXPDEL_WA

Work area with current data record from the merge table for item and delivery schedule data

I_LOOP_COUNTER

Current counter reading of the merge table I_MIXTAB

I_MIXTAB_ENTRIES

Number of data records in I_MIXTAB

E_FLG_LAST

Indicator: Last data record in I_MIXTAB reached

I_DG_CHK_START

Page 108 of 144


Start mode for dangerous goods checks. You can control outputs using the start mode; for example, in start mode
08 or 09 information can be output, in start mode 10 that runs in the background, information cannot be output.

 08: Manual start by pushbutton

 09: Automatic start before saving the sales document

 10: Automatic start on initial data transfer (background)

E_FLG_CTXT

Indicator: Current expected delivery is compiled

OLD_I_EXPDEL_WA

Work area with last data record from merge table I_MIXTAB

I_MIXTAB

Merge table for item and schedule line data. A loop runs over this table and the respective current record is passed to a
work area (I_EXPDEL_WA).

I_EXPDEL

Current expected delivery

I_EXPDEL

Error table. This is where error messages (E messages) are logged.

Log Header for Expected Delivery


Using the SAP enhancement DG600003 you can write a log header for an expected delivery.

Note:

So that you can jump to the enhancement documentation, you must have set the text display to SAPscript format.
Set the SAPscript display if required in the structure screen of the Implementation Guide (IMG) by choosing
Utilities -> Text display -> SAPscript.

Activities

1. Create the enhancement.

Either create a new enhancement project or use an existing one.

2. Activate the project.

Your enhancement will only take effect when activated.

Page 109 of 144


Further notes

Unlike modifications, enhancements are basically not affected if you apply a later release as they are not made in the SAP
original, but in a namespace reserved for the customer.

You will find the general procedure for creating enhancements in the enhancement transaction under Utilities -> Online
manual.

SAP enhancement DG600003. Functionality

For each expected delivery, a log header is written to the dangerous goods check log, which lists the data that is valid for
the entire expected delivery, in particular the criteria for creating the expected delivery. In the SAP standard method, this
data includes:

 Ship-to party

 Goods issue date

 Shipping point

 Route

 Arrival time

If you determine the expected deliveries yourself using the enhancement DG600002, it is useful to include the
corresponding selection parameters in the log header using the enhancement DG600003.

Description of the Parameters for the Customer Exit DG600003

I_HEAD_VALDATE

Selection date for reading the dangerous goods master record

I_SEL_DATE_DOUBLE

Indicator: Two selection dates were used for reading the dangerous goods master record (possible, for example,
for "Valid from" and "Valid to")

I_FLG_PROFILES

Indicator: Usage profiles were taken into account when the check methods were executed

I_ROUTTAB_WA

Work area with route data

I_FLG_SY_DATUM

Indicator: The current date was used as the selection date for the dangerous goods master record

I_FLG_HEADER_EXPDEL_REACTION
Page 110 of 144
Indicator: Header error for data determination for expected delivery

I_CHK_METHODSTAB

Table with check methods for all countries and mode of transport categories

I_SD_PROFILESTAB

Table with country/mode of transport category combinations

I_NO_PROFILES_TAB

Table with check methods for the check schema currently being executed without usage profile

I_EXPDEL

Expected delivery

BAdI: Custom Error Control for Dangerous Goods Checks


This BAdI allows you to control the behavior of the dangerous goods checks. This means you can influence how the
system further processes the SD documents.

Using the methods listed below, you can change the entries in the error table E_DG_CHK_LOGTAB and the value of the
return code E_DG_CHK_SD_RC - depending on the start parameter I_DG_CHK_START and other parameters, for
example, transaction, sales organization, or delivery type.

 DG_CHK_REACT_SHIPP_DETERMINE

The method for shipping documents contains parts of the main function module for the dangerous goods checks in
the standard coding.

 DG_CHK_REACT_ORDER_DETERMINE

The method for sales documents contains no standard coding.

 DG_CHK_REACT_TRANS_DETERMINE (shipment document)

The method for shipment documents contains no standard coding.

The BAdI is active in the standard system. It is called during background processing at the end of the main function
module for dangerous goods checks: for the shipping document at the end of the function module
HAZMAT_CHK_FRAME in start mode 3, for the sales document at the end of the function module
HAZMAT_CHK_FRAME_ORDER in start mode 10, and for the shipment document at the end of the function module
HAZMAT_CHK_FRAME_TRANS in start mode 6.

The BAdI is suitable for multiple usage and is not filter-dependent. No sample coding is supplied.

Activities

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.
Page 111 of 144
If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.
2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class
field automatically, by assigning a class name based on the name of your implementation.
4. Save your entries and assign the Add-In to a package.
5. To edit a method, double-click its name.
6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod.
statements.
7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not
perform the following step:
8. Choose Activate.
When the application program is executed, the code you created is run through.

Dangerous Goods Documents/EDI

Manage User Exits

In this IMG activity, you manage the user exits that you can use to print out dangerous goods standard texts on dangerous
goods documents and for EDI.

Example

In user exit management, the user exit category PHR_TEXT exists with the following function modules that are relevant
for the dangerous goods documents:

 DG50_PRICOND_ADNR10011_STDT

 DG50_PRICOND_ADNRDECLA_STDT
Page 112 of 144
 DG50_PRICOND_ADR10011_STDT

 DG50_PRICOND_ADRDECLA_STDT

 DG50_PRICOND_EXCPQUAN_STDT

 DG50_PRICOND_SHIPDECLA_STDT

The function module HAZMAT_PRI_COND_ADAPT is shipped to adapt the interface if you are upgrading from EH&S
Release 2.2 to 2.7. The module should be used whenever you have already created your own function modules and want
to use them.
When you create a new function module, enter the name of the function module directly in the relevant field. Note in this
case that you are creating a new function module in the Customer namespace and not in the standard system. In the
relevant function group, you must create a Top include that contains the following instructions:
type-pools tr, esp1, esp7, esp11, esp12.

Standard settings

A sample user exit is shipped.

Note:

In the assigned function module, a check is made for the "limited quantity" indicator. If the indicator is set, the phrase text
is output.

Recommendation

If you want to define your own function modules, call the documentation for the corresponding reference function module
(SE37). Write the new function module analogous to the reference module and its interface.

Activities

1. Call the IMG activity.


2. Check whether the user exit category PHR_TXT is created.
3. When you enter the function modules, note that you must also enter the function module
HAZMAT_PRI_COND_ADAPT if you want to make use of your existing modules.

Further notes

Using the phrase set, you can specify:

 Whether the dangerous goods standard texts are output at header or item level

 Whether the corresponding phrases are also taken into account in EDI processing

You enter the corresponding user exit of the category PHR_TXT in the phrase header under User exit name.

Page 113 of 144


Specify Output Conditions and Formatting Methods

In this IMG activity, you specify the output conditions and formatting methods for the data in the dangerous goods
documents.
The output conditions and formatting methods apply to the output of texts in connection with fields in the dangerous
goods master as well as other fields that are required for print output.
Output conditions and formatting methods should be developed as function modules.

Example

The following function modules are delivered in the standard system as sample output conditions:

 DG50_PRICOND_BULK

 DG50_PRICOND_HIGHVISCO

 DG50_PRICOND_HIGHVISCOTXT

The following function modules are delivered in the standard system as sample formatting methods:

 DG50_GETSYMB_AGGRSTATE

 DG50_GETSYMB_CONT_WASTE

 DG50_GETSYMB_DESCRIPTION

 DG50_GETSYMB_DGCLDCBL

Page 114 of 144


 DG50_GETSYMB_HAZINDSUB

 DG50_GETSYMB_HAZINDSUBMP

 DG50_GETSYMB_HAZINDSUBRQ

 DG50_GETSYMB_HAZNOTES

 DG50_GETSYMB_HYGROSCOP

 DG50_GETSYMB_SECDGCLASS

For a description of the function modules, see the function module documentation.

Standard settings

Standard settings are delivered in the standard system.

Activities

1. Call the IMG activity.

2. Choose Edit -> New entries.

3. Choose the field name for the required field using the value help.

4. Choose Enter. The short description for the field name is displayed.

5. Choose the required function module or enter the required function module.

If the output condition is also to be taken into account when determining data via EDI processing, set the EDI indicator.

Further notes

Note that the number of function modules in the system influences performance when printing dangerous goods
documents. For more information about dangerous goods standard texts, see the application help.

Page 115 of 144


Definition: dangerous goods documents

Environment, Health and Safety (EHS)

The documents that contain dangerous goods standard texts and dangerous goods-specific texts.

Specify Languages

In this IMG activity, you specify the languages permitted for the output of transport documents.

Two aspects must be taken into account:

1. Permitted primary languages:

The primary language is taken from the SD document (SD). The language defined in the customer condition table
is used. If no language is defined for the customer, the language of the recipient country (ship-to party) is used.

The system checks whether this language is a valid dangerous goods language.

If this is the case, the dangerous goods texts are output in these languages.

If neither of the languages is a valid dangerous goods language, the system derives the secondary language for the
primary language.

2. Specifying the language of the forwarding country:

You can also specify dangerous goods data in the language of the forwarding country as well as in the primary
language.

3. Deriving a secondary language:

In this step, you specify the intended secondary language.

This entry is used if the check carried out in point 1 has a negative result. The language-dependent descriptions
are then output in both the primary and secondary languages.
Page 116 of 144
Only one secondary language can be specified for a validity area and mode of transport category.

Standard settings

No settings are delivered for this in the standard system.

Activities

1. Call the IMG activity.

2. Entering the permitted primary languages

a) Choose Permitted Primary Languages.

b) Enter the primary languages for each validity area - mode of transport category combination and set the
AllLang indicator.

3. Specifying the derivation of secondary languages

a) Choose Derivation of Secondary Language.

b) Enter the secondary language for each validity area - mode of transport category combination.

Only one secondary language is permitted for each validity area and mode of transport category. The secondary
language must exist as a permitted primary language.

4. Choosing the output of the language of the forwarding country

a) Choose Take Forwarding Country into Account.

b) Specify for the various dangerous goods regulations whether dangerous goods data should appear in the
language of the forwarding country on the transport documents. To do this, set the LngFrwCtry indicator.

Page 117 of 144


Define Profiles for DG Text Pattern

Use

In this Customizing activity, you define the text pattern profile. Text master profiles refer to message types (see
Customizing activity Assign Text Pattern Profile to Message Types). Text pattern profiles allow you to control which text
pattern is used for a message type. Text patterns control the dangerous goods information that is printed, depending on the
regulations.

Standard settings

Example settings are delivered.

Activities

Create the required profiles for text patterns with their language-dependent descriptions.

Example

Text Pattern Prof. Text Pattern Prof. Descr.

DEL_NOTE Issue to delivery note

Assign Text Pattern Profile to Output Types

Use

In this IMG activity, you assign text pattern profiles to the different message types. Text pattern profiles refer to message
types. They allow you to control which text pattern should be used for a message type. Text patterns control the dangerous
goods information that is printed, depending on regulations.

Standard settings

Example settings are delivered.

Activities

Create a data record for the required message types and assign a text pattern profile.

Example

Page 118 of 144


Application for message conditions Message type Text pattern profile

V2 LD00 DEL_NOTE

Specify Output Control for EDI Processing

Use

In this IMG activity, you specify how the system is to react if errors occur whilst dangerous goods segments are being
transferred to EDI processing.

You have the following options:

1. If you set the EDITerminate indicator and errors occur when collecting data from the dangerous goods area, no
other data is transferred from SD and EDI processing is terminated.

2. If you do not set the indicator, EDI processing is completed with the SD data and without the dangerous goods
data.

3. If the EDITerminate indicator is not set but an error occurs when transferring dangerous goods data, a message
is sent to the person appointed as EDI administrator.

Requirements

You must have specified an EDI administrator. Otherwise, all system users will receive the message.

You enter the EDI administrator in Customizing for IDoc Interface/Application Link Enabling (ALE) under IDoc
Administration.

Activities

1. Call the IMG activity.

2. Set the EDI termination indicator according to the sales document category.

Page 119 of 144


Specify Forms

In this IMG activity, you define forms for dangerous-goods relevant transport documents.

Activities

1. Call the IMG activity.

2. Create the required form in the language you require.

3. Specify all the required subobjects.

Import Text Pattern Phrases

Different dangerous goods regulations sometimes require different dangerous goods information or require the
information in a different sequence. By using text patterns it is possible to output dangerous goods information in
accordance with the requirements of the respective dangerous goods regulation.

Text patterns contain symbols and Include statements that are implemented at the time of print formatting. They are
created and edited as phrases with the SAPscript editor under Basic Data and Tools -> Phrases in the EH&S menu.

Sample text patterns are supplied.

Activities

1. Import the sample text pattern phrases together with the EH&S sample phrase library.
2. The procedure required for this is described under Import Sample Templates.
3. After you have installed the SAP EH&S Release 2.7 and imported the sample phrase library, you must call the
report DGCTPATT once in order to generate the formatting of the text pattern phrases.
4. As existing formats are lost when exporting and importing phrase long texts, the formatting of the text pattern
phrases in the sample phrase library is stored internally in the SAPscript text.
5. To use the text pattern phrases, you must copy them to the active library.

Further notes

Page 120 of 144


The text pattern phrases are assigned to the phrase group 30.00 and can be selected using that group.

Business Add-Ins (BAdIs)

BAdI: Output of Dangerous Goods Data

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

The BAdI enables you to intervene when determining dangerous goods data for output on documents or via EDI.

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.

2. On this screen, enter a short description for your implementation in the Implementation Short Text field.

3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing
Class field automatically, by assigning a class name based on the name of your implementation.

4. Save your entries and assign the Add-In to a package.

5. To edit a method, double-click its name.

6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod.
statements.

7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this,
do not perform the following step:

8. Choose Activate.
When the application program is executed, the code you created is run through.

Standard settings

The BAdI is active in the standard system.

The BAdI is not filter-dependent.

See also

Methods

Page 121 of 144


Determination of Relevant Data Records for DG Master Enhancement

Template and One-Time Material Processing

Settings for Template and One-Time Material Processing

Template and one-time material processing makes it easier for you to handle logistics processes including dangerous
goods checks and dangerous goods documents for substances whose description, properties, and dangerous goods data
vary. The time and effort spent on dangerous goods classification is reduced considerably, particularly for substances that
you only want to ship once.

Requirements

For template and one-time material processing you create materials in the material master and assign them an appropriate
indicator profile in the Basic Data 2 view. Specifically for template material processing, you also create dangerous goods
master records for these materials. You do not create dangerous goods master records for the one-time materials. For more
information on the options available with template and one-time material processing, see the application help.

Activities

 Activate template and one-time material processing in the IMG activity Activate Dangerous Goods Checks. If
you have activated template and one-time material processing in this IMG activity, it is also possible to specify in
detail which logistics processes are to use template and one-time material processing. For these detailed settings,
use the IMG activities under the Specify Determination Routines for Template and One-Time Materials and
Specify Validity for Template and One-Time Material Processing nodes.

 In the IMG activity Specify Indicator Profiles for the Material Master, specify the profiles you need for
template and one-time material processing.

 Edit the IMG activity Specify Incompleteness Procedures to set incompleteness control for SD documents in
template and one-time material processing. Here you can specify that further processing of documents stays
forbidden as long as the data you require is not yet complete.

Page 122 of 144


Specify Fields for Template and One-Time Material Processing

Use

In this IMG activity, you specify which fields can be edited for template and one-time material processing. You have the
option of deciding in each case depending on the dangerous goods regulation and field name whether a field can be edited.
You must make a separate entry for template materials and one-time materials.

Example

Regulation: ADR

Field name: COEFFICIENT OF EXPANSION

Data Entry for Template Material Permitted indicator: set

If you set the Data Entry for Template Material Permitted indicator, the field for editing in the SD document is ready for
input if you are editing a material that is set as a template material by its dangerous goods indicator profile.

Activities

1. Depending on the dangerous goods regulation, enter the field name.

2. Set the indicators if you want to edit the field in the SD document.

Further notes

If you have not yet edited any data, you can set up an initial database where, in the standard system, all fields are set as
not ready for input for template materials, and for one-time materials all fields are set as ready for input. This follows the
assumption that you have already specified a large amount of information for template materials and you only have a few
necessary entries still to add; for one-time materials, however, you have only a limited amount of specified information
and still need to add the majority of the entries necessary.

The fields for one-time material processing are only visible on the screen if they are marked as ready for input.

The fields for template material processing are visible on the screen if the Field Visible for Template Material
Processing indicator is set, regardless of whether the fields are ready for input or not.

If you change the Field Visible for Template Material Processing indicator for a single combination of field and
dangerous goods regulation, the system transfers this change to all combinations of the field with other dangerous goods
regulations when you save.

Page 123 of 144


Specify Fields for Template and One-Time Material Processing

Use

In this IMG activity, you specify which fields can be edited for template and one-time material processing. You have the
option of deciding in each case depending on the dangerous goods regulation and field name whether a field can be edited.
You must make a separate entry for template materials and one-time materials.

Example

Regulation: ADR

Field name: COEFFICIENT OF EXPANSION

Page 124 of 144


Data Entry for Template Material Permitted indicator: set

If you set the Data Entry for Template Material Permitted indicator, the field for editing in the SD document is ready for
input if you are editing a material that is set as a template material by its dangerous goods indicator profile.

Activities

1. Depending on the dangerous goods regulation, enter the field name.

2. Set the indicators if you want to edit the field in the SD document.

Further notes

If you have not yet edited any data, you can set up an initial database where, in the standard system, all fields are set as
not ready for input for template materials, and for one-time materials all fields are set as ready for input. This follows the
assumption that you have already specified a large amount of information for template materials and you only have a few
necessary entries still to add; for one-time materials, however, you have only a limited amount of specified information
and still need to add the majority of the entries necessary.

The fields for one-time material processing are only visible on the screen if they are marked as ready for input.

The fields for template material processing are visible on the screen if the Field Visible for Template Material
Processing indicator is set, regardless of whether the fields are ready for input or not.

If you change the Field Visible for Template Material Processing indicator for a single combination of field and
dangerous goods regulation, the system transfers this change to all combinations of the field with other dangerous goods
regulations when you save.

Specify Determination Routines for Template and One-Time Materials

Specify Determination Routine for Sales and Shipping Documents

In this IMG activity you specify which logic the system uses to check whether template and one-time material processing
is to be used in shipping and sales. Depending on the respective sales organization you can specify function modules that
run this check. If you do not make an entry in the Sales organization field, the function module is used for all sales
organizations.

The standard system contains the function module DG95_DET_PROC_ACTIVE. This module checks whether the entries
in the following IMG activities correspond with the entries in the SD document.

 Specify Permitted Combinations for Sales Documents

 Specify Permitted Combinations for Shipping Documents

For more information, see the documentation for these IMG activities.

Page 125 of 144


Specify Determination Routine for Shipment Documents

In this IMG activity you specify which logic the system uses to check whether template and one-time material processing
is to be used in transportation. Depending on the respective transportation planning point you can specify function
modules that run this check. If you do not make an entry in the Transportation planning point field, the function module is
used for all transportation planning points.

The standard system contains the function module DG95_DET_PROC_ACTIVE. This module checks whether the entries
in the following IMG activity correspond with the entries in the shipment document.

 Specify Permitted Combinations for Shipment Documents

For more information, see the documentation for this IMG activity.

Specify Permitted Combinations for Sales Documents

In this IMG activity you specify the combinations of the following three items that are to be supported by template and
one-time material processing.

 Sales organization

 Document category for sales

 Sales document type

Standard settings

Template and one-time material processing is possible in sales with the following SD document categories:

 Request for quotation

 Quotation

 Order

 Scheduling agreement

Page 126 of 144


 Scheduling agreement with external services

 Contract

 Order without charge

In the standard system the fields for the sales organization and sales document type are not filled. This means that the
listed sales document categories are supported for all sales organizations and also for all corresponding sales document
types. If you make explicit entries, you exclude the unnamed combinations.

In the standard system the combinations you specify in this IMG activity are checked by the determination method
DG95_DET_PROC_ACTIVE. For more information, see Specify Determination Routine for Sales and Shipping
Documents.

Activities

If you want to limit the specified combination possibilities, you have the following options:

 Delete sales document categories from the list

 Make explicit entries

Example

You want template and one-time material processing to support the document category Request for quotation only in the
sales organization 0001, but then for all sales document types offered. Make the following entry:

Sales document
SOrg. DocCatSal
type

0001 Request for quotation

Make sure that you overwrite the original entry (without naming the sales organization 0001 explicitly). If this entry is
retained, it cancels out the required limitation with its multiple combination options.

Page 127 of 144


Specify Permitted Combinations for Shipment Documents

In this IMG activity you specify the combinations of the following three items that are to be supported by template and
one-time material processing.

 Transportation planning point

 Document category for shipment

 Shipment type

Standard settings

Template and one-time material processing is possible in transportation for the SD document category Shipment.

In the standard system the fields for the transportation planning point and shipment type are not filled. This means that the
shipment document category is supported for all transportation planning points and also for all corresponding shipment
types. If you make explicit entries, you exclude the unnamed combinations.

In the standard system the combinations you specify in this IMG activity are checked by the determination method
DG95_DET_PROC_ACTIVE. For more information, see Specify Determination Routine for Shipment Documents.

Activities

If you want to limit the specified combination possibilities, you have the following options:

 Delete shipment document categories from the list

 Make explicit entries

Example

You want template and one-time material processing to support the document category Shipment only in the
transportation planning point 0001, but then for all shipment types offered. Make the following entry:

ShipmntTy
TrspP DocCatShm
p

0001 Shipment

Make sure that you overwrite the original entry (without naming the sales organization 0001 explicitly). If this entry is
retained, it cancels out the required limitation with its multiple combination options.

Page 128 of 144


Business Add-Ins (BAdIs)

BAdI: Rescheduling in Shipment Document

Use

This BAdI is used to add more dangerous goods master records to the records that have already been read.

If you change the shipping type specified in sales or shipping in the course of transportation planning, the dangerous
goods master records you require for further processing are missing. The system will then issue an error message.

The method ENLARGE_MASTER_DATA is integrated in the scope of the dangerous goods checks in the shipment
document (HAZMAT_CHK_FRAME_TRANS) and in the filling module for EDI in the shipment document
(HAZMAT_EDI_READ_SHIP). It can be used in template and one-time material processing.

Example

You had intended to deliver an article by road. Accordingly, the system reads the dangerous goods master record with the
dangerous goods regulation ADR into the dangerous goods document table. If you then decide to transport the article by
rail, the dangerous goods master record with the dangerous goods regulation RID is required. The BAdI adds the RID
dangerous goods master record.

Dangerous Goods Product Release


Convert Dangerous Goods Indicators Into Indicators for Transport
Use

In this Customizing activity, you convert the dangerous goods indicators used in the product release into the
corresponding indicators for transport for all dangerous goods-relevant materials.

The dangerous goods indicators are assigned to the following indicators for transport:

Page 129 of 144


Dangerous goods
Indicator for transport
indicator

Product Is Released RELEASED

Transport Not Permitted NOT_PERM

Not Dangerous Goods NOT_DG

LQ LQ

Excepted Quantity EQ

RQ RQ

Consumer Commodity CC

Packed Goods PACK_GOOD

Requirements

In the Specify Dangerous Goods Regulations Customizing activity, you have created the dangerous goods regulations
that are assigned to the indicator for transport.

The indicator for transport assigned to the dangerous goods indicator has been created in the Define Indicators for
Transport Customizing activity.

Activities

Carry out this Customizing activity to convert the dangerous goods indicators into indicators for transport in the product
release.

Indicators for transport that differ from the standard indicators (and their values) are not affected by this Customizing
activity.

Note: If this Customizing activity is carried out more than once, multiple indicators for transport are not created. In each
case, however, the values from the dangerous goods indicators are used. Indicators for transport deleted manually can be
created again.

Page 130 of 144


Specify Indicators for Transport

Use

Indicators for transport replace the existing dangerous goods indicators used in the product release and in the dangerous
goods supplement. You can define your own indicators for transport, whereas the previously used dangerous goods
indicators were predefined by the system.

In this Customizing activity, you create your own indicators for transport and assign these the dangerous goods
regulations for which you want to use the indicators for transport. You can also specify whether you want to use the
indicators for transport in the product release, in the dangerous goods supplement, or in both.

Note: If you do not assign any dangerous goods regulations to an indicator for transport, the indicator for transport is used
for all regulations that you have created in Customizing.

Requirements

You have created the dangerous goods regulations that are relevant for you in the Specify Dangerous Goods Regulations
Customizing activity.

Standard settings

Corresponding indicators for transport for the previously used dangerous goods indicators are shipped with the standard
system.

Activities

1. Create an indicator for transport and enter the name of the indicator for transport in the language you require.

2. Select the indicator for transport.

3. Choose Assignment to Regulation.

4. Assign the corresponding dangerous goods regulations to the indicator for transport.

Page 131 of 144


Business Add-Ins (BAdIs)

BAdI: Dangerous Goods Product Release

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.

2. On this screen, enter a short description for your implementation in the Implementation Short Text field.

3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing
Class field automatically, by assigning a class name based on the name of your implementation.

4. Save your entries and assign the Add-In to a package.

5. To edit a method, double-click its name.

6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod.
statements.

7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this,
do not perform the following step:

Page 132 of 144


8. Choose Activate.
When the application program is executed, the code you created is run through.

Standard settings

The BAdI is active in the standard system.

The BAdI is not filter-dependent.

Example

Methods

OK Code Processing for Product Release Functions

Preprocessing for Product Release Functions

Incoming Check of Selection Parameters

Transfer of Heading and Icon for Second Tab Page

Call of Intermediate Screen to Create Product Releases

BAdI: Button in Product Release

Use

This BAdI allows you to activate a maximum of type customer-specific pushbuttons in product release in the dangerous
goods master. If an active implementation exists for the BAdI, the pushbuttons are displayed on the right next to the
existing pushbuttons. You can implement jumps to your own screens via the pushbuttons.

The BAdI is called in the subroutine L_OKCODE_HANDLER in the function group CBDU_DL05. The function codes
BUTT1 and BUTT2 are assigned to the pushbuttons.

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then
choose one of them by choosing Create, and continue as follows:

1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
The system displays the initial screen for creating Business Add-In implementations.
2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class
field automatically, by assigning a class name based on the name of your implementation.
4. Save your entries and assign the Add-In to a package.
5. To edit a method, double-click its name.
6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod.
statements.
Page 133 of 144
7. Save and activate your code. Navigate back to the Change Implementation screen.
Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not
perform the following step:
8. Choose Activate.
When the application program is executed, the code you created is run through.

Example

Methods

Call of Assigned Screen

Write Data to Buffer

Set Icon Structure

Handling Unit Integration

Activate Dangerous Goods Checks

To carry out dangerous goods checks in a client, you must activate the dangerous goods checks in this IMG activity.

The dangerous goods check method describes how the check is executed on the activation of the dangerous goods
checks under FM for activation check.

You use the Document items relevant for checks only indicator to specify if all document items or only those relevant for
dangerous goods are to be transferred to dangerous goods management. Document items relevant for dangerous goods
must have a dangerous goods indicator profile in the material master. This profile must be marked as relevant for
checks.
Page 134 of 144
If you have not set the Document items relevant for checks only indicator, all document items are transferred to the
dangerous goods checks. The following document items are then checked in accordance with the item category:

 Normal items
These items are always checked.

 Value items
These items are checked only if the material is assigned to a dangerous indicator profile in the material master. In
the sales document, value items are checked only if they are relevant for delivery.

 Text items
These items are checked only if the material is assigned to a dangerous indicator profile in the material master. In
the sales document, text items are checked only if they are relevant for delivery.

 Packing items
These document items are not checked.

You define item categories in Customizing for Sales and Distribution.

Standard settings

There is an SAP standard method for activation checks for dangerous goods checks (function module
HAZMAT_CHK_ACTIVE). This method checks using the Dangerous goods checks active indicator to be set in this IMG
activity.

The Document items relevant for checks only indicator is also set in the standard.

In the standard system, template processing and one-time processing, dynamic classification and dangerous goods
integration in Handling Unit Management (in shipping documents) are not active.

Note:

You can activate template and one-time material processing in this IMG activity. You can make other settings for
template and one-time material processing under the IMG node Template and One-Time Material Processing in
Customizing for Dangerous Goods Management.

If you activate dynamic classification, then you must specify the dangerous goods profile for materials that are to be
classified dynamically in the IMG activity, Specify Indicator Profiles for the Material Master.

Recommendation

If you generally have a lot of document items and few dangerous goods items, set the Document items relevant for checks
only indicator.

Activities

1. Call the IMG activity.


2. Check whether the SAP standard method entry is available.
3. If required, enter your own method. The function module interface must be identical to the interface of the SAP
standard method HAZMAT_CHK_ACTIVE.
4. Set the Dangerous goods checks active indicator to activate the dangerous goods checks.
Page 135 of 144
5. Set the Document items relevant for checks only indicator if only the dangerous goods relevant document items
are to be transferred to dangerous goods management.

Do not set the Document items relevant for checks only indicator if all items are to be transferred to dangerous
goods management.

6. Set the Template material processing active indicator if you want to use template and one-time material
processing.
7. Set the HU Integration Active indicator, to activate Handling Unit Integration (in shipping documents). See
further notes.

Further notes

You can only activate HU integration if the status Incomplete for packing is not set in the status groups for the entries G1
and G2 in the incompleteness control for sales and shipping documents.

If you want to use the product release for fully packaged goods at the same time as HU integration, you must specify the
dangerous goods packaging status in the material master for the dangerous goods material.

If you want to use HU integration, and you have already released the products, you can use report
DGP_PACK_STATUS_SET. This report fills the dangerous goods packaging status in the material master with the value
Packaged (PACKEDPROD) for all dangerous goods materials that have already been released.

Restrictions

Dangerous goods integration in Handling Unit Management is limited to manual processing of shipping document
(transactions VL01N and VL02N). Within this processing, it is limited to the Pack and Selection of permitted packaging
materials functions. The Automatic packing, Per Part Qty und If Full functions are not supported.

Dangerous goods processing is also not integrated in the Packing Station function. A notification indicates that the
system does not support the packing of dangerous goods materials if the HU integration is active and a dangerous goods
material is to be packed.

Specify Status of Dangerous Goods Packaging for Material Mas

Use

In this Customizing activity, you define the dangerous goods packaging status for the material master.

You can assign precisely one dangerous goods packaging status to each material master record:
Page 136 of 144
 Packed item (package), PACKEDPROD

The material is packaged completely to comply with dangerous goods regulations. It is no longer packed in a
package that is suitable for dangerous goods in HU Management.

 Semi-packed item (in inner packaging), SEMIPACKED

The material is a loose item. It is packaged in a secure inner packaging that is suitable for dangerous goods and is
sent to stock or to the warehouse like this.

 Unpacked goods ,NOTPACKED

The material is a loose item without specifically-assigned packaging that is suitable for dangerous goods.

 Dangerous goods packaging, PACKMATDG

The material is a packaging material that is approved for packaging dangerous goods.

 Dangerous goods packaging LQ, PACKMATLQ

The material is a packaging material that can be used to package dangerous goods taking into account the limited
quantity regulation.

Standard settings

All relevant dangerous goods packaging statuses are delivered in the standard system.

Activities

Check the completeness of the dangerous goods packaging statuses that are available.

Further notes

The dangerous goods packaging status is used for dangerous goods materials and packaging materials that are suitable for
dangerous goods.

 Dangerous goods materials:

For dangerous goods materials, the purpose of the dangerous goods packaging status is to control the article release
and the HU integration processes separately.
This means that you only need to enter the dangerous goods packaging status if you have activated Handling Unit
Integration and are using the dangerous goods article release at the same time.
SAP recommends that you enter the dangerous goods packaging status if you use both loose items and semipacked
items in the handling unit integration and, therefore, are using different levels of packaging (outer, single, and inner
packaging). By doing this, you can make sure that, for example, semi-packed items are not packed in single
packaging.

 Packaging relevant for dangerous goods:

This allows the system to differentiate between packaging with a specific dangerous goods legal approval from LQ
packaging (limited quantities, small quantity rules), that do not require any official approval (specification type
Page 137 of 144
packaging approval). In the dialog box, you can only select the packaging method that is identified accordingly for
handling units that are relevant for dangerous goods.

Define Approval Code Types

Use

In this Customizing activity, you define the types of approval code. The type of approval code is a characteristic in the
value assignment type UN Packaging Code (SAP_EHS_1025_001) for the specification type Packaging Code Approval.

Standard settings

Example settings are supplied.

Activities

Enter the permitted approval code with its language-dependent descriptions.

Example

Types of Approval Code Descr. of Type of Approval Code

UN UN

Specify Level of Dangerous Goods Packaging

Use

In this Customizing activity, you define the levels of dangerous goods packaging.

If you pack delivery items that contain dangerous goods and the dangerous goods integration in the handling unit has been
activated, you can assign a dangerous goods packaging level to each handling unit.

For this assignment, you must define the following:


Page 138 of 144
 Outer packaging (OUT)

The handling unit (packaging) is relevant to ensure compliance with dangerous goods regulations.

 Single packaging (SGL)

The handling unit (packaging) is relevant to ensure compliance with dangerous goods regulations.

 Inner packaging (INP)

The handling unit (packaging) is not relevant to ensure compliance with dangerous goods regulations.

Standard settings

Customizing in the standard system contains relevant dangerous goods packaging levels.

Activities

Check the completeness of the available dangerous goods packaging levels.

BAdI: Dangerous Goods: HU Integration 001

Use

Business Add-In (BAdI) BADI_EHSDG_HU_001 initializes, defines the ready for input status, and preassigns default
values for those screen fields on the screen for entering Handling Unit (HU) data relevant to dangerous goods. In addition,
it is possible to navigate from the screen to another process.

The following methods are implemented for the BAdI:

 HU_DIALOG_INIT

Initializes screen fields, defines the ready for input status, and preassigns default values

 HU_DIALOG_BUTTON_PRESS

Defines a navigation from the screen using a pushbutton to define the dangerous goods data of the handling unit

 HU_DIALOG_BUTTON_DEF

Defines a pushbutton for screen navigation

 HU_VENUM_SYNCHRONIZE

Page 139 of 144


Updates the handling unit number (internal number) generated

Standard settings

The BAdI is active in the standard shipment. It cannot be used more than once and is not filter-dependent. Sample source
code is not shipped with the system.

BAdI: Dangerous Goods: HU Integration 002

Use

Business Add-In (BAdI) BADI_EHSDG_HU_002 is used in Dangerous Goods Management (EHS-DGP) to determine
and check data relevant to dangerous goods for creating a handling unit (HU).

The following methods are implemented for the BAdI:

 HU_DIALOG_CHECK

Call the dangerous goods checks for handling units when Continue is selected in the dialog box. Checks for packaging
and mixed packing are then carried out.

 PROP_PACKCODE

Call a system proposal to determine the permitted packaging code based on the specified packaging data of the
materials to be packed. The result of the system proposal (the intersection of the permitted packaging code across all
materials specified) is shown in an ALV grid. The selected packaging code is transferred from the ALV grid to the
Packaging Code screen field.
In the default implementation for determining the permitted packaging code, the level of dangerous goods packaging
and the type of instruction for enclosure are evaluated. Outer- and single packaging are taken into account as the level
of dangerous goods packaging. The system does not make a proposal for inner packaging, but you can enter the data
manually. Packed goods ('P') and limited quantities ('LQ') are evaluated as the type of instruction for enclosure.

 PROP_PACKMAT

Call a system proposal to determine the permitted packing materials based on the selected packaging code. The result
of the system proposal(the intersection of the permitted packing materials across all specified materials) is shown in
an ALV grid. The selected packing material is transferred from the ALV grid to the screen field Packing Material.
In the default implementation for determining the permitted packing materials, the level of the dangerous goods
packaging, the type of instruction for enclosure, and the dangerous goods packaging status are evaluated. Outer and
single packaging are taken into account as the level of dangerous goods packaging. The system does not make a
proposal for inner packaging, but you can enter the data manually. Packed goods ('P') and limited quantities ('LQ') are
evaluated as the type of instruction for enclosure. As packing materials, only materials with material type Packaging
('VERP') are taken into account. These must also have a dangerous goods packaging status, dangerous goods
packaging ('PACKMATDG') or LQ packaging ('PACKMATLQ').

Standard settings

The BAdI is active as standard. However, it cannot be used more than once and is not filter-dependent.

This BAdI uses the interface IF_EX_BADI_EHSDG_HU_002.

Page 140 of 144


For more information, see the interface in the Class Builder.

Information about implementing BAdIs as an enhancement is available from SAP NetWeaver Library by choosing
Business Add-Ins (BAdIs) - Implementation of BAdIs.

BAdI: Dangerous Goods: Dynamic Classification 001

Use

This Business Add-In (BAdI) is used in Dangerous Goods Management (EHS-DGP).

It allows enhancements during the use of dynamic classification for dangerous goods.

You use this BAdI to automatically generate replacement materials for dynamic classification.

No default implementation is shipped with the standard system.

Information about implementing BAdIs as an enhancement is available from the SAP NetWeaver Library at Business
Add-Ins (BAdIs) - Implementation of BAdIs.

This BAdI uses the interface IF_EX_BADI_EHSDG_DYN_001.

For more information, see the interface in the Class Builder.

Exceptions to Dang. Goods Regulations

Define Assignment Profiles for Exceptions to Dangerous Goods

Use

In this IMG activity, you define assignment profiles for exceptions to dangerous goods regulations.

Page 141 of 144


You use the assignment profile to define the positions within Dangerous Goods Management for which an exception can
be selected.

Note

You can enhance the assignment objects using the Business Add-In Exceptions to DG Regulations: Other Assignment
Objects.

Standard settings

The following sample entries are available:

Assignment Profile Description


1 Assignment of Exception in the Specification and in DG Master
2 Assignment of Exception Only in DG Master
3 Assignment of Exception Only in Handling Unit (Header)
4 Assignment to HU Items
5 Assignment to HU Header and HU Items
6 Assignment to Master Data, HU Header, and HU Items

Activities

 Enter the required assignment profiles with their language-dependent descriptions.

 Assign the required assignment objects to the assignment profiles.

Restrictions

If you use the dangerous goods integration in handling unit management, you can only assign exceptions to dangerous
goods regulations to a handling unit (header) or handling unit item if the dangerous goods checks are activated and
dangerous goods checks have been performed for the shipping document.

Business Add-Ins (BAdIs)

BAdI: Exceptions to Dangerous Goods Regulations: Other Assig

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

It allows enhancements when you use exceptions to dangerous goods regulations.

The BAdI allows you to implement a search help, as well as a where-used list for exceptions.
Page 142 of 144
There is no default implementation and the BAdI is not filter-dependent.

Information about the implementation of BAdIs in the context of the enhancement concept is available in the SAP
Library for SAP NetWeaver under BAdIs - Embedding in the Enhancement Framework.

See also

This BAdI uses the interface IF_EX_BADI_EHSDG_EXC_001.

For more information, see the interface in the Class Builder.

BAdI: Exceptions to DG Regulations: Consistency Check

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

It allows enhancements during the use of exceptions to dangerous goods regulations in Dangerous Goods Management.

You use this BAdI to check the consistency of exceptions to dangerous goods regulations assigned in the dangerous goods
master or Handling Unit Management.

Default implementations are shipped with the standard system.

Information about implementing BAdIs as an enhancement is available in SAP NetWeaver Library at Business Add-Ins
(BAdIs) - Implementation of BAdIs.

This BAdI uses the interface IF_EX_BADI_EHSDG_EXC_002.

For more information, see the interface in the Class Builder.

BAdI: Exceptions to DG Regulations: Change Data During ALE D

Use

This Business Add-In (BAdI) is used in the Dangerous Goods Management (EHS-DGP) component.

You use this BAdI to define enhancements that are executed if you distribute exceptions to dangerous goods regulations
by Application Link Enabling (ALE). The enhancements are executed at the following positions:

When you post exceptions to dangerous goods regulations to the receiving side

When you distribute exceptions to dangerous goods regulations to the sending side

You use this BAdI to transfer additional data to these positions by ALE or to add your own data filter.

Information about implementing BAdIs as an enhancement is available in SAP NetWeaver Library at Business Add-Ins
(BAdIs) - Implementation of BAdIs.

This BAdI uses the interface IF_EX_BADI_EHSDG_EXC_003.


Page 143 of 144
For more information, see the interface in the Class Builder.

Page 144 of 144

Das könnte Ihnen auch gefallen