SAP EHS Regulatory Content Administration Manual
SAP EHS Regulatory Content Administration Manual
Administration Manual
SAP EHS Regulatory Content Administration Manual
Version 1901
F.1. Settings to implement the MSDS Template for EMEA ....................................... 337
F.1.1. File Overview ........................................................................................... 337
F.1.2. Other Settings .......................................................................................... 343
F.1.3. Generation variant ................................................................................... 345
Index .................................................................................................................................. 346
This manual does not replace release notes or functional descriptions for the individual content
products. Release notes are provided for each new version of the individual product to give
an overview over new and changed features. Functional descriptions are provided for each
individual product as detailed documentation on all functions and settings.
This manual describes all available SAP EHS Regulatory Content products. These products
need to be licensed. The manual may describe products that are not licensed by your company
and thus not delivered to your company. If you would like to check your SAP EHS Regulatory
Content license status, please send an e-mail to <Regulatory.Content@sap.com>.
If you are not familiar with SAP EHS Regulatory Content we recommend to use this manual
as a step by step documentation of how to implement SAP EHS Regulatory Content. Each
step which is necessary to implement SAP EHS Regulatory Content is described in the logical
sequence. Links refer to specific settings and related topics.
If you are a more experienced user and are interested in a specific topic you could use the
different appendixes to find the information your are looking for, especially the How To - Ap-
pendix. As a special service all necessary actions throughout the process of implementing
SAP EHS Regulatory Content are collected in this place.
The Technical Settings appendixes are available for all SAP EHS Regulatory Content products.
They contain general settings and information which is relevant for the current release.
User of the printed version should refer to the table of contents and the index to find the infor-
mation they need. The links which are embedded in the PDF file could be used if this document
is viewed on the computer.
The following chapter Structure of this manual gives an overview over the structure of this
manual.
• Introduction: This part gives an introduction to this manual. It provides information how to
use it, conventions used in it and the available support options as well as a short overview
about the SAP EHS Regulatory Content product scope and the appropriate license status.
• Installation: This chapter provides information about the general prerequisites for the imple-
mentation of SAP EHS Regulatory Content as well as an overall implementation procedure.
• Property tree: Beside some general information about property trees this part provides a
detailed step by step description of all activities which are necessary to deal with property
trees.
• Multilanguage phrase library for hazard communication: This part contains all relevant infor-
mation concerning phrases.
• Substance lists and reference data: In this part, guidance is given throughout the process
of implementing regulatory data.
• Expert rules for substance and mixture classification: This section covers all information
necessary for Expert rules.
• Material safety data sheet (MSDS) templates: The aim of this part is to provide information
which is relevant to setup and create MSDS Report Templates.
• How To ...: The aim of this section is to provide fast and easy to use advice on how to perform
different actions throughout the process of implementing SAP EHS Regulatory Content.
• Technical Settings Property Tree: This section provides information about all relevant files,
settings and more concerning the property tree.
• Technical Settings Multilanguage phrase library for hazard communication: All necessary
information with regard to phrases is aggregated in this part. It is structured according to the
different phrase packages.
• Technical Settings Substance lists and reference data: This part of the documentation pro-
vides a collection of all information related to current version of regulatory data.
• Technical Settings Expert rules for substance and mixture classificatin: This section contains
the release related information for the Expert rules. The settings are structured according
to the rule set packages they belong to.
• Technical Settings Material safety data sheet (MSDS) templates: An overview which settings
are relevant for the MSDS Report Templates could be found here.
1.3. Security/Authorization
Starting with the download of the SAP EHS Regulatory Content package, the customer is solely
responsible for the integrity of the content, e.g. to protect the content against manipulation.
The SAP Security Guides provide you with a collection of our guidelines and recommendations
pertaining to SAP system and SAP software security. These documents offer general guide-
lines for securing your SAP systems. Do keep in mind that additional factors are also very
important when securing your overall landscape, such as the usage of a variety of software
packages (SAP and non-SAP). Therefore, we highly recommend you analyze your own risks
and needs and establish your own security policy (or policies). These guides are intended to
assist you in this process, but cannot replace the need for your own customer-specific policies.
For the latest information on security updates see SAP Security Notes.
We strongly recommend to store the SAP EHS Regulatory Content in a restricted environment,
accessible only by authorized persons involved in content implementation or updates. For
further details regarding user authorization in your file system please see the user manual of
your operating system.
In SAP EHS access rights to SAP EHS Regulatory Content can be administrated via autho-
rization profiles. For further details we refer to “User and Role Administration of AS ABAP” and
“Roles for Environment, Health and Safety (EH&S)” in the SAP Library (http://help.sap.com).
1.4. Support
Issues with SAP EHS and SAP EHS Regulatory Content can be reported using the SAP One
Support Lauchpad https://launchpad.support.sap.com/.
Please select one of the following components to ensure fast assignment to the appropriate
subject matter expert.
• EHS-ERC for all incidents related to regulatory list data, phrases, Expert rules and WWI
templates
• EHS-BD-RDF-WWI for incidents related to WWI functionality (other than WWI templates)
• EHS-BD-TLS-OCC for incidents related to OCC functionality (other than regulatory data)
• EHS-BD-TLS-EXP for incidents related to EHS Expert functionality (other than ERC Expert
rules)
1.5. Glossary
EH&S Expert
• define rule sets and create and maintain the corresponding mapping tables
• calculate secondary data based on the rule sets and mapping table for EHS
specification data
OCC offers functionality for manual single substance data loads, automatic
mass loads, as well as update and simulation functionality.
A modified version of Microsoft Word that is called from the SAP system to edit
a document template.
Phrase
A standard text.
Phrase Library
Apart from the active company library, other libraries can be kept for information
purposes.
Rule sets are used to calculate secondary data based on information stored in
EHS specifications.
Template
A template defines the format of a report in the SAP Environment, Health and
Safety component and specifies where data from specification management
and other SAP applications is placed in the document.
When the report is generated, the symbols are replaced with data and the text
is formatted using the features in a word-processing program such as text type,
font size, and color.
Property
The details on a specification in the form of numeric values including the appro-
priate unit of measure, or in the form of textual information.
The details can be linked with information on the source of the data or on the
method of analysis.
• Physical
• Chemical
• Toxicological
• Ecological
• First aid measures
• Safety measures
• Hazard classes
Customizing
Implement SAP functions in your company quickly, safely and cost effectively
Value Assignment
Example:
Accuracy: approx.
Value: 2 g/cm3
Specification
A description that uses identifiers and value assignments such as physical and
chemical properties, medical notes, and details on transport and storage.
• Substances
• Agents
• Packaging
• Waste codes
• Dangerous goods classifications
Characteristic
• Value
• Accuracy
• Ambient pressure
• Method
2.1. Prerequisites
This chapter describes the overall prerequisites in order to implement SAP EHS Regulatory
Content. There might be additional prerequisites which are related to separate parts of the
SAP EHS Regulatory Content. These prerequisites are defined within the respective part of
the documentation.
EHS - Release
• Please see SAP note 568302 for system requirements
EHS Expert/OCC
• Current version of EHS Open Content Connector (OCC) and EHS Expert (see SAP note
568302).
EHS WWI
• Current version of WWI
Customizing
Basic customizing settings are described here. Special customizing activities for the different
parts of SAP EHS Regulatory Content are described in the corresponding chapters.
• Number ranges for phrase keys: To import the phrases related to the Multilanguage
Phrase Library and the Substance Lists and Reference Data the external number range
0E must have the alphanumeric interval from A to ZZZZZZZZZZZZZZZ. Additionally we
recommend to designate the internal number range 0I for numeric values only (interval
100000000000000 to 899999999999999). The number range intervals have to be set in the
customizing activity Specify Number Ranges for Phrases
• Language keys in the phrase management: Before importing the phrase translations the
language keys for the languages which shall be imported must have been set up in the EHS
customizing.
• Units of measurement: Units of measurement are maintained (e.g. for pressure: mmHg as
well as hPa if expansion method for pressure conversion is to be used ); please make sure
that translation into every necessary language is available.
SAP authorisation
• All Expert rules and OCC users need SAP authorization S_RFC authorization for RFC ac-
cess.
• All OCC users need SAP authorization S_TABU_DIS Table Maintenance.
SAP Notes
SAP Note Remark
568302 See for information how to download the latest version of OCC and addi-
tional system requirements.
1061242 EH&S: Availability and performance of WWI and Expert servers
1408534 Import of phrases terminates with a runtime error
1418024 Incomplete long text when you merge phrases
1299868 EH&S Expert/EH&S OCC Unicode support
1407091 Check function for EC numbers
1424476 Phrase import does not update all phrase items
1371276 Identifier/user-defined text languages are not loaded
1434736 Update task: Most important notes
1454105 Uploading/downloading a file does not work
1466900 By mistake phrases were labeled as changed
1367148 needed if "no calculation" functionality of rule sets is used
1381072 Phrase warning: Missing code/graphic
1565029 NotStat rule: Exit functionality for interrupting component explosion
2004802 Comp rule: Composition tree: Average value of ingredients
This list is not exhaustive but contains some general notes as well as important notes of the
last few months. Please check if the appropriate note is available for your EHS release.
Detailed information which steps are necessary to implement SAP EHS Regulatory Content
are collected in the content related check lists:
Important
Before starting the implementation procedure please review the enclosed documenta-
tion.
Caution
It might be necessary to update your EHS or to implement SAP notes.
Tip
Collect all transports contained in the delivery. If you upload all transports at once you
can skip the appropriate upload activities mentioned in the check lists.
SAP EHS Regulatory Content (abbreviated SAP ERC) expert rules for substance and mixture
classification, SAP ERC substance lists and reference data and SAP ERC safety data sheet
templates make use of the new properties and new characteristics. Therefore, property tree
packages are created in order to provide the new standard properties and characteristics as a
predelivery for SAP ERC customers for older EH&S versions as well. These packages contain
everything needed to set up and use the new and enhanced characteristics and classes/prop-
erties added to SAP EH&S in an existing ERP 6.0 EHP3, ERP 6.0 EHP4, ERP 6.0 EHP5, ERP
6.0 EHP6, ERP 6.0 EHP7, or ERP 6.0 EHP8 system.
Each Package contains files for the R/3 Transport Management System (TMS) for new and
changed classes, characteristics, value assignment types and positions in the property tree
STANDARD. Descriptions of classes, characteristics and value assignment types are delivered
in English and German. Help texts are delivered in English and German for SAP Enterprise
Releases. As an additional service, the help texts are delivered also as text documents.
Please read the ReadMe document included in each property tree package carefully BEFORE
starting the implementation of any property tree package, but especially BEFORE starting
the implementation of the property tree package 2015-2 Product Safety (enhancements for
ESComXML Format Version 2-0) and the propert tree package 1711 Product Safety (set up of
new dimensions and new unit of measurements)!
3.1.1. Prerequisites
The EH&S property tree needs to be updated to the latest release status.
Customers must ensure that the earlier property tree packages have already been installed
before loading a new package. If the installation sequence is reversed, some of the changes
within the new package will be overwritten by older packages. New customers may profit from
the combination package in which several property tree packages are combined (see details
and example in Appendix).
An overview about the existing property tree packages and the order of installation is given
in the Appendix.
All classes where new characteristics are added or characteristics are changed should not
have been changed manually because these changes will be overwritten by the transports.
In addition, the flags and parameters of the existing value assignment types such as "Char-
Copy active", "New val. actv.", "Usage profile" etc. will be overwritten by the standard values
(for example Usage profile = PROF001) with the import of the transport requests which in-
clude the value assignment types . Therefore, if any of the classes, characteristics and value
assignment types mentioned in the files “Changes_.....pdf” do already exist or were changed
in the destination system, it is recommended to make a copy of them first before installing
this package. Furthermore, if the property trees STANDARD and OBSOLETE were changed
(which is not recommended), copies should be made of these property trees as well.
A detailed list of transports and files delivered with the property tree package of the corre-
sponding SAP EH&S Regulatory Content Update is given in the Appendix.
3.2. Implementation
The following steps describe how to implement property tree packages. Please note that the
transports within a package or sub-package have to be imported in the order given in the
Appendix. The steps "Allocate phrase sets", "Generate WWI symbols for reports", "Setup Ta-
ble-based Value assignments" and "Check and extend copy/inheritance templates" have to be
done after the import of the transports on each EH&S system. .
To support the SAP ESComXML/EH&S interface based on ESComXML Format Version 1.5,
new properties, new characteristics, changed existing characteristics, new specification types,
new property trees were delivered with property tree package 2014-2 Product Safety or were
set up manually. Details and links to the SAP Help Portal were described in the ReadMe doc-
ument which was delivered with this property tree package 2014-2.
With property tree package 2015-2 Product Safety, the REACH eSDS Annex properties were
changed to support the ESComXML Format Version 2.0 which was published on the Webpage
of the Eurpean Chemical Industry Association (Cefic). Several existing REACH eSDS Annex
properties newly added with 2008-1 PS, 2010-1 PS, or 2014--2 PS were shifted to the property
tree OBSOLETE and were replaced by new properties. Details can be found in the ReadMe
and Changes document included in property tree package 2015-2 PS.
Before property tree transport requests can be imported into an EH&S system, the correspond-
ing files have to be uploaded onto the SAP application server.
Please note that the file names of the transport requests for the SAP Transport Management
System have the following structure:
An example:
The following chapter describes how the upload of property tree package transport request
files has to be performed:
1. Find out the directory name and path of the import queue for the SAP Transport Manage-
ment System.
2. Load the transport files into the import directory using the transaction CG3Z.
3. Attach the transport request to the import queue
1. Find out the directory name and path of the import queue for the SAP Transport Manage-
ment System.
1.1. You may ask your SAP system manager or proceed as follows:
1.2. Run transaction AL11.
1.3. The first part of the directory path is listed after the entry DIR_TRANS, for example
"F:\usr\sap\trans".
1.4. Within this directory two sub-directories exist:
• The sub-directory "cofiles" where the co-files are stored.
• The sub-directory "data" where the data files are stored.
5. Load the transport files into the import directory using the transaction CG3Z.
5.4. Choose in the menu "Extras" -> "Other requests" -> "Add".
5.5. Enter in the field "Transp. Request" the name of the transport request, e.g.
"SH2K102047". The field "Import Queue" is already filled with the selected import
queue.
5.6. Start the process with the push button "Continue". The transport request is added to
the bottom of the import queue with the highest number.
Please note that the listed "Owner" is the SAP user who created the transport request not the
login-user who started the upload process!
3.2.1.2. Settings
The files which need to be uploaded depend on the property tree package and are summarized
in the Appendix.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
6. Check the import by displaying the transport log.
In the following, the steps listed above are described in more detail:
The files which need to be imported depend on the property tree package and are listed
in the Appendix.
4.a. In order to find a transport request more easily in the import queue, a filter can be set.
Choose a column, "Request" for example, by clicking on the column title.
Then choose the pushbutton "Filters (Ctrl + F10)" or press "Ctrl + F10".
Enter the filter criterion in the following window, "SH2*" or "EEI*" for example.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
5.a. Start the import with the pushbutton "Import Request (Ctrl+F11) or press Ctrl+F11.
5.b. Fill in the "Target Client" in the next window.
5.c. On the tab page "Date", set the start date to "Immediate".
5.d. On the tab page "Options", select the option "Leave Transport Request in Queue for
Later Import" .
5.e. On the tab page "Options", select the option "Ignore Invalid Component Version" when
transports which were generated on an ERP 6.0 system are imported in a system with
a lower release (ERP 5.0 = ERP 2004 for example).
5.f. Choose the pushbutton "Continue" to start the import. The status of the transport re-
quest will change first to "Import running" and then to "Request is ready for import
again".
Use "Legend: Import Queue" to obtain more details about the status symbols.
6. Check the import by displaying the transport log.
6.a. After the import is completed, open the transport log for the imported transport request
using the push button "Logs (Ctrl+F4)" or press Ctrl+F4.
6.b. The transport log will be displayed. You may open additional sections by pressing the
"+" pushbutton.
6.c. In general, the status of the import will be "(0) Successfully Completed".
6.d. The status may be "(4) Ended with warning" when transports which were generated
on an ERP 6.0 system are imported in a system with a lower release (ERP 5.0 = ERP
2004 for example). Such warnings because of "different nametabs" can be ignored.
The property tree objects are imported correctly despite the warning.
3.2.2.3. Settings
The files which need to be imported depend on the property tree package and are listed in
the Appendix.
Neither new phrases nor phrase sets nor allocations of phrase sets to standard characteristics
are delivered with a property tree package.
In order to make use of new characteristics which were defined for phrases, phrase sets have
to be set up and allocated to the new characteristics.
This chapter describes in detail how to set up and allocate phrase sets for these new character-
istics. Please note that only characteristics have to be considered which are described as "new,
CHAR 30, multiple phrases" or "new, CHAR 30, single phrase" in the files "Changes_......pdf".
1.c. Choose transaction CG1B "Edit phrase sets" and create manually phrase sets for all
characteristics which are described in the file "Changes....pdf" as "new, CHAR 30,
multiple phrases" or “new, CHAR 30, single phrase”. Enter the characteristic key as
the new phrase set key. Enter the English characteristic description as the phrase set
name in English. Save.
It is recommended to add a German phrase set name as well when you work also
work with a German user interface.
2. During an initial setup: Run customizing activity "Generate Standard Phrase Sets"
2.a. Ensure that no one is working with the affected property tree or is using the affected
properties and characteristics in the EH&S specification workbench.
2.b. If an EH&S system is set up initially the customizing activity "Generate Standard
Phrase Sets" is used in general to create and allocate phrase sets to all characteris-
tics of type CHAR 30. Please note that with ERP 6.0 EHP7 and higher EHPs, this
customizing activity was extended by a list of characteristics which shall be excluded
from phrase set assignment. This list is delivered with the SAP standard deliver and
ensure that CHAR 30 which are not meant to be assigned to phrase sets are excluded
from the generation and assignment of standard phrase sets.
2.c. Navigate to the activity "Generate Standard Phrase Sets" in the SAP customizing
(IMDG) (path within EH&S 3.2 and higher releases: Environment, Health & Safety ->
Basic Data and Tools -> Specification Management -> Specification Data Base Struc-
ture -> Settings for Value Assignment -> Generate Standard Phrase Sets). A complete
overview about this activity is given in the corresponding IMDG activity documentation.
2.d. Start the activity.
2.e. Phrase sets are generated and allocated to all characteristics of type CHAR 30. With
ERP 6.0 EHP7 and higher EPs phrase sets are not generated and allocated to char-
acteristics which are on the exclusion list. Phrases are not allocated to the new phrase
sets. Assignments of phrase sets to characteristics that already exist are not overwrit-
ten by the system.
2.f. Some characteristics defined as CHAR 30 are not meant to be assigned to phrase
sets, for example "Value in Non-Standard Unit". These characteristics shall be used to
store a numerical value and a unit but were unfortunately defined as a free text fields
of CHAR 30. In this case, the assigned phrase set has to be deleted in the table "Edit
phrase set-attribute assignment" (transaction CGAB) after the standard phrase sets
have been created.
If the explanation component shall be used and the phrase sets were generated
by the automatic customizing functionality "Create Standard Phrase Sets", it is neces-
sary to remove the phrase set assignment manually at least from the characteristic
SAP_EHS_0101_002_RULESET. Otherwise the explanation cannot be stored in the
specification database for later use.
2.g. Run transaction CGCZ "Match up master data" with flag "Activate Phras-
ing of Characteristics" only. This function assigns the function module
INTERNAL: SAP CUSTOMER 16 © SAP SE
Property Tree
3.2.3.2. Settings
Phrase sets have to be allocated to new characteristics which are described as "new, CHAR
30, multiple phrases" or "new, CHAR 30, single phrase" in the files "Changes_......pdf". The
corresponding characteristic key can be found in the files "Changes_.....pdf" as mentioned in
the Appendix.
Run transaction CGCZ "Match up master data" with flag "Generate Symbols" only. This will
generate the necessary new WWI symbols for the new characteristics.
Additional information:
In a standard R/3 System automatically created symbols using the transaction CGCZ are gen-
erated with descriptions which are copies of the characteristics descriptions in the logon lan-
guage. The flag "Regenerate Symbol Descriptions" within transaction CGCZ can be used to
generate the symbol descriptions in another language different from the logon language. En-
glish or German are possible symbol descriptions languages when property tree packages are
installed where the characteristics descriptions are delivered in English and German.
If the transaction CGCZ is run with the flag "Match Up Symbols-Phrase-Enabled Characteris-
tics" the symbol definitions for the characteristic symbols that have been changed from phrase-
related to non-phrase-related (or vice versa) will be updated..
For new properties the Table-Based Value Assignment has to be set up newly. For existing
properties were new characteristics were assigned the already existing Table-Based Value
Assignment has to be extended. This chapter describes in detail how to set up the Table-based
Value Assignment in both cases.
Please note, that the property keys of new and extended properties can be found in the files
"Changes_.....pdf" as mentioned in the Appendix.
1.1. Navigate to the activity "Set Up Table-Based Value Assignment" in the SAP customiz-
ing (IMG) (path: Environment, Health & Safety -> Basic Data and Tools -> Specification
Management -> Specification Data Base Structure -> Settings for Value Assignment
-> Set Up Table-Based Value Assignment). A complete overview about this activity is
given in the corresponding IMG activity documentation.
1.2. Start the activity. The following screen appears:
1.3. Choose the entry "Create Entries for the Value Assignments". The window "Filling
Customizing Table for Table-based Value Assignment" appears:
1.4. Enter a property key of a new property or a series of property keys in the field "Value
assgmt type" and start the process (pushbutton "Execute"). A general example for a
property key is SAP_EHS_1023_043 (for property "GHS Classification (List Data").
Select the property keys of the new properties within a specific property tree package
from the file "Changes_.....pdf". The file name for a specific property tree package can
be found in the Appendix.
Please avoid to execute this process with the same property key multiple times be-
cause this would create multiple entries in the customizing table!
1.5. Return to the previous window (push button "Back"):
1.6. Choose the entry "Set Up Table-Based Value Assignment". The complete customizing
table opens. Check all entries for the configured property/properties:
1.7. Return to the previous window (push button "Back"):
1.8. Repeat the steps 1.2 to 1.7 to create the necessary entries for all new properties.
2. Set up Table-based Value Assignment for existing properties with new characteristics
You have to change the configuration of existing properties where new characteristics were
added and which were already configured for the Table-Based Value Assignment. The rec-
ommended procedure is to delete all entries for existing properties with new characteristics
in the customizing table and to create the entries for these properties anew (see the follow-
ing steps 2.1 to 2.14).
If the configuration of the Table-Based Value Assignment for properties with new character-
istics was already changed, then these changes should be documented before deleting the
entries. In this case, an alternative could be not to delete all entries for a changed property
but to update the Table-Based Value Assignment for the existing property only (follow steps
1.1 to 1.8). Then, the new characteristics would be appended to the already existing entries
for this property. The correct order of the characteristics would have to be set up manually.
Please note, that the Table-based Value Assignment customizing table can only be changed
in SAP systems where the direct customizing is enabled. If the direct customizing is disabled
(for example in a production system), then the Table-based Value Assignment should be set
up in a system where the direct customizing is enabled (for example a development system).
The correct entries can be then transported to the system with the disabled customizing
(customizing transport request).
2.1. Navigate to the activity "Set Up Table-Based Value Assignment" in the SAP customiz-
ing (IMG) (path: Environment, Health & Safety -> Basic Data and Tools -> Specification
Management -> Specification Data Base Structure -> Settings for Value Assignment
-> Set Up Table-Based Value Assignment). A complete overview about this activity is
given in the corresponding IMG activity documentation.
2.2. Start the activity. The following screen appears:
2.3. Choose the entry "Set Up Table-Based Value Assignment". The complete customizing
table opens.
2.4. Choose the push button "Position", enter a property key of an existing property with
new characteristics and navigate to this property. Select the property key from the file
"Changes_.....pdf". The specific file name for a certain property tree package can be
found in the Appendix.
2.5. Select all entries for this property.
2.6. Delete the selected entries (push button "Delete").
2.7. Return to the previous window:
2.8. Choose the entry "Create Entries for the Value Assignments". The window "Filling
Customizing Table for Table-based Value Assignment" appears:
2.9. Enter the property key of the property, which entries you deleted in the previous step,
in the field "Value assgmt type":
2.10. Start the process (pushbutton "Execute").
2.11. Return to the previous window:
2.12. Choose the entry "Set Up Table-Based Value Assignment" again. The customizing
table opens. Check all entries for the configured property:
2.13. Return to the previous window (push button "Back"):
2.14. Repeat the steps 2.2 to 2.13 to create the necessary entries for all existing properties
with new characteristics.
In order to copy or inherit information within EH&S, templates are used where the properties
are specified which shall be copied or inherited. Normally, these templates stay unchanged
for some time. However, when new properties are added to the standard property tree these
templates have to be checked and extended, if necessary.
1. Check copy/inheritance templates and assign one of the new properties to an existing tem-
plate, if necessary.
2. It is recommended to proceed as follows:
2.a. Navigate to the substance workbench or run transaction CG02.
2.b. Select "Find Substance" (double-click) on the initial screen. It is not necessary to start
a search and create a hit list.
2.c. Make sure that you are working in the "Edit" mode and not the "Display" mode. You
may change from "Display" to "Edit" mode using the pushbutton "Display <-> Edit (Ctrl
+F1)".
2.d. Navigate in the menu to "Specification" -> "Inheritance" -> "Edit Templates".
2.e. A selection screen opens where you select the template you want to edit. Choose the
pushbutton "Inheritance Templates Detail View". A detail window opens.
2.f. Choose the option "Value assignment type selection" where you can add new proper-
ties to the copy/inheritance template.
2.g. Select a new property. Choose the pushbutton "Transfer (Enter)".
2.h. A new window opens. Choose one of the pushbuttons "Replace" or "Supplement".
2.i. Choose the pushbutton "Transfer (F8)" on the next screen.
2.j. Complete this process by choosing the pushbutton "Save (Ctrl+S)" on the following
selection screen.
2.k. Choose the pushbutton "Transfer (Enter)" to return to the hit list.
Update deliveries include enhancements, customer proposals and corrections to the phrase
library and delivery of new languages.
4.1.1. Prerequisites
The latest version of the CED phrase library needs to be imported according to the respective
sections in this documentation.
Most Expert Rules for Substance and Mixture Classification delivered with a SAP EHS Regu-
latory Content update will require the latest phrase library version.
To determine which CED catalogue is current, have a look at Customizing -> Environment,
Health and Safety -> Basic Data and Tools -> Phrase Management -> Specify Phrase Libraries
and Phrase Groups. Choose the CED library and have a look at details.
If a customer has maintained own graphics by allocation of bitmaps to phrases these alloca-
tions will be overwritten by an update. The same applies for the fields phrase code and phrase
remark at the phrase item level!
The phrase set assignments of the CED Phrase Library are based on the latest SAP EHS
properties tree.
4.1.3. Language/Codepage/Font
4.1.3.1. Prerequisites / important notes
Prior to importing an update, it may be necessary to extend the language setup of your SAP
system. Please see the CED release notes that come with each update for information on
which new languages will be added with the update.
Please note that there are different import files required depending on the language key defi-
nition in your system -details can be found in How To Implement Language Keys.
If you are working in an SAP S/4HANA system environment language key EN is defined to be
US English, while 6N is defined to be Britisch English. PT is defined to be Brazilian Portuguese,
while 1P is defined to be European Portuguese. In this case use the phrase import files for
SAP S/4HANA.
If you are working in an R/3 environment having EN defined as British English and PT as
European Portuguese please use the CED Standard phrase import files after implementation
of the correspondence languages Z8 and Z9.
• To make US English available for all customers including those with non-unicode systems we
decided to deliver this language with a language code coming from the customers reserve.
If Z8 is already used as language in your system, please contact us for further assistance.
Do not import the US English file in this case!
• To make Brazilian available for all customers including those with non-unicode systems we
decided to deliver this language with a language code coming from the customers reserve.
If Z9 is already used as language in your system, please contact us for further assistance.
Do not import the Brazilian file in this case!
• Mexican, Canadian, Vietnamese and Hindi will only be available as Unicode languages.
Please make sure the import file for Unicode files are NOT opened as this might destroy the
data due to incorrect conversion of characters!
• For Hindi please make sure your Regional Options in Windows are set up including Hindi
as the SAP GUI uses the Windows code pages to display these language symbols.
• In Windows XP please check "Install files for complex script and right-to-left languages (in-
cluding Thai)" and "Install files for East Asia languages".
All phrase import files are provided as Unicode files within SAP EHS Regulatory Content with
character standard UTF-8.
For customers still on Non-Unicode systems, we can provide non-Unicode phrase import files
only for languages available on ISO norm character set ISO 8859-1 (often referred to as “ISO
Latin 1”). Please request these languages through our helpdesk. We highly recommend the
use of Unicode files as some special characters cannot be converted for non-Unicode systems.
Serbian using the Central European code page is provided with language key d as proposed
by SAP; a Serbocroatain version using language key 0 is available on request for customers.
Normally 0 should be used for the Cyrillic version of Serbian. A Cyrillic version of Serbian is
not within the scope of ERC languages.
Please see appendix (Languages/Codepages) for further information on code pages and nec-
essary fonts.
4.1.3.3. Setup of language keys for phrase items within the phrase ad-
ministration
All different language keys within the R/3 system are delivered by SAP as standard settings
which the customer should not change. The following language keys have to be adjusted in
the customizing for the phrase management (Specify language selection) to ensure a correct
allocation of translations to phrase items during the library import.
The language keys are presented as two characters in the R/3 application with release R/3 4.x
and higher. Internally they are still handled as one character codes. Therefore single character
language keys are still applied in the import file.
Please see annex (Language keys) for additional information on SAP EHS language keys for
western european languages.
Please see annex (Language keys) for additional information on SAP EHS language keys for
other languages.
4.1.4. Proposals
4.1.4.1. Proposals for changes, corrections or expansions
system. If you rely on regulatory documents or have any other source for your phrase proposal
it is always helpful to attach this information and the related document as well.
In case you find an spelling error you are also welcome to pass this information on to us. We
will get back to you as soon as possible with an information on if and how the phrase texts
should be corrected. Please do not change CED phrases without this process as these might
be overwritten in one of the next updates.
4.2. Implementation
To make use of the phrases following steps have to be done: Create passive phrase catalogue
CED, upload the delivered files and import phrases. The following chapters describe how to
do this.
To create a passive phrase catalogue start the IMG customizing (transaction spro) navigate
to Environment, Health & Safety -> Basic Data and Tools -> Phrase management -> Specify
Phrase Libraries and Phrase Groups.
Requirements : You have already defined the number ranges for the phrase key.
Note
One library has to be the active library.
You can use all libraries available on the market that support the conversion formats of
the SAP component Environment, Health and Safety (EHS).
Publication Date
Version library version
Phr. ChkRtn
Object name ESN_PHRID
Int. no. range 0I
Ext. no. range 0E
Ask your administrator for the upload path on your application server. You may check for the
path also via transaction AL11.
For example :
Use transaction CG3Z for uploading and choose BIN(ary) transfer format as shown in the
screen shot below.
Size of path and filename is limited. It may be necessary to either shorten the import file names
or choose a short directory path to upload the files.
Please check that you upload the correct files for the operating system of your application
server. You may also have to consider if Unicode or Non Unicode system. For non-unicode
files, the update delivery includes import files formatted for MS Windows and UNIX. You can
get info about the OS in R/3 at -> System -> Status. Under the "Host data" header you can
see the operating system used by the R/3 server.
The upload of import files onto the application server and the import into EHS are completely
independent from any language specific settings on the front-end PC, i.e. phrases can be
uploaded and imported with every regional default setting.
Apart from changes to header data (e.g. library date) no changes must be made within the
import file! The library key may contain characters from the English alphabet only (no special
characters).
Note
Be careful when opening and editing Unicode phrase import files. Many text editors are
not suitable for Unicode files any may corrupt the import files.
• "File with path" - Enter the path and file name (same as target file section upload files )
• For all files choose UTF-8 as character standard.
• You can leave all other options blank
• Optional: You can limit the import to certain languages if you want (Button "Language se-
lection" )
• Check the file (F5)
• Carefully check the displayed information before importing the phrases. Make sure you im-
port to the passive CED or TDCLE library, the versions are correct and no errors are dis-
played.
• If necessary approve the message "Date of phr. lib. to be imported is identical to date of
current library", this is just for your information.
• However if the file you want to import is older than the library in your system, you can not
import it. Please make sure you have chosen the correct import file. In section upload files
you can also find information on how to change the header data of your import files.
• Choose "Transfer/start time" (F6)
• Choose "Immediate" or specify a time
• Save
Note
Phrase import files for CED and TDCLE libraries include all phrases of the library,
not only those that are new or updated. Please be aware that all manual changes
made in your CED or TDCLE phrases will be overwritten.
Caution
Please do not set the flag for full import as this will delete your
passive library!
If you are updating your phrase library, we recommend to restrict the phrase selection to
only new and revised phrases. Please use the Phrase created/changed... functionality with
the settings shown in the screenshot:
Note
It is not recommended to press the "Determine target phrase" - button as this may
select phrases as target phrases that are not appropriate or may not have e.g. all
language translations.
Note
The merging process normally does not perform well when processing several thou-
sand phrases at one time. Therefore, we strongly recommend that only a part of the
phrase library is merged at one time (e.g. filtered by phrase groups or phrase keys).
Prior to importing phrase set assignments, the phrases have to be merged into the active
library. After uploading the phrase set assignment file, the assignments should to be imported
into SAP EHS.
• "File with path" - Enter the path and file name (same as target file section upload files )
• Check the "Phrase Set Assignmt" option as shown in the screenshot below
Sometimes none or only a few assignments are imported. If you encounter this error, the first
step would be to run this import several times until no more phrases are assigned to phrase
sets. If this does not help an easy work-around is to change the name of the phrase library in
the import file to the name of your active library. Upload and import this modified file. In section
upload files you can also find information on how to change the header data of your import files.
As the phrase set assignment files are based on the latest SAP EHS standard property tree
there will be warnings in the logfile of the import if your system is not updated with the latest
standard property tree. These warnings can usually be ignored. Customers with valid mainte-
nance contracts for SAP EHS Regulatory Content - expert rules for substance and mixture
classification or - substance lists and reference data receive the latest tree as part of their reg-
ular maintenance. Should you need any additional info on this topic please feel free to contact
us.
Example:
After the question mark has been replaced by the desired value in every phrase item the phrase
is available within the complete scope of translations.
Possibilities for automatic replacement of the placeholder are described in the next chapters.
Example:
Please see SAP Note 1146663 Placeholder phrases for EH&S reports for details on how to
implement the placeholder functionality and how to use it in phrases and WWI templates.
Starting with our release ERC 1705, a new functionality can be used in order to automatically
fill the storage temperature values instead of the placeholders. As a prerequisite some settings
are required in the system:
Other placeholders can also be replaced automatically by developing specific user exits, but
we do not provide standard functionality for them. Please see SAP Note 1373615 for more
information.
These phrase keys must not be within the CED name space! For this two possibilities are
available:
a) The new phrases can be added using the automatic key assignment. In this case the system
itself assigns the phrase keys automatically from the internal number range (0I). However if
these phrases shall be transferred to any other system later on there might be the danger of
overlapping phrase keys concerning the automatically edited keys and the keys of the target
system. An automatic phrase import would then not directly be possible. The phrases had
rather to be loaded as passive library and then to be merged into the active library.
b) New phrases can be added using keys from the external number range (0E). To make these
customer phrases distinguishable from CED phrases the corresponding customer phrase keys
have to start with X or Y only with the exception of those phrases beginning with P (see below).
Please use the following check list as guidance through the phrase library implementation and
as check list after the implementation.
beside Dangerous Goods classification additional data are available for some of the regulations
mentioned above as:
• Transport category
The following chapters describe the initial implementation of SAP EHS Regulatory Content.
If you are using both Product Safety and Dangerous Goods data, you have to do all steps
twice, for each package separately. If the process is different for Product Safety and Dangerous
Goods, it will be mentioned in the documentation.
5.1.1. Prerequisites
The substance lists and reference data require additional customizing activities. These cus-
tomizing entries are described in the respective area in this documentation's appendix. It is
recommended to perform these steps before implementing the substance lists and reference
data.
The following prerequisites exist for implementing and using substance lists and reference
data:
If substance lists and reference data is used with the Expert Rules, the latest data should be
loaded before running the Expert Rules.
This implies importing the newest phrases, too, which is a prerequisite for loading the data
correctly.
If the latest Expert Rules are run on old data, wrong results may be determined.
• Documentation including user manual, release notes, content reports and training presen-
tations.
• Latest SAP EHS Open Content Connector setup
• SAP EHS customizing transports and/or BC sets
• Phrase import files
• Substance lists and reference database
• Mapping database
• Other files like analysis tools, acceptance report
For a complete overview of all files included in this delivery of substance list and reference
data, please see the list of data files.
5.2. Implementation
The following chapters describe how to implement SAP Regulatory Content - substance lists
and reference data. The basic implementation is identical for all packages, both Product safety
and Dangerous Goods. Differences are always highlighted by notes in the relevant chapter.
The implementation process consists of the following steps divided into a technical part and
a part for regulatory experts:
Technical Part
• Install SAP EHS Open Content Connector
• SAP EHS Customizing
• Import of multilingual phrases
• Installing the substance lists and reference database
• Installing the mapping database
• Installation of additional tools
• Manual adjustments
Regulatory Part
• Review Filter Settings
• Use of additional tools
On each front-end computer that is used for substance lists and reference data loads, SAP
EHS Open Content Connector (OCC) needs to be installed. OCC in the latest version is part
of the SAP EHS Expert installation package.
We recommend that you upgrade all OCC installations to the latest service pack.
EHS OCC or OCC is the abbreviation for SAP EHS Open Content Connector.
OCC is an interface based on an open XML format which allows content providers to provide
regulatory content and other data into SAP EHS specifications.
OCC is part of SAP EHS and does not require an additional license. OCC is bundled with
SAP EHS Expert into the same setup package and shares some common functionalities and
program files with Expert.
OCC offers functionalities for manual single substance data loads, automatic mass loads, as
well as update and simulation functionalities.
You will find the installation program for EHS OCC on the current SAP Server Components
CD.
The current EHS OCC Version and patches for EHS OCC are also available on the SAP Sup-
port Portal on SAP Service Marketplace. You can find the patches for EHS OCC on SAP
Service Marketplace under 'Support Packages & Patches' (http://service.sap.com/patches)
Detailed information on how to obtain the latest version of OCC can be found in SAP Note
568302.
On each front-end computer that is used for loads of SAP EHS Regulatory Content - substance
lists and reference data, SAP EHS Open Content Connector (OCC) needs to be installed.
OCC in the latest version is part of the SAP EHS Expert installation package. If your current
OCC version is lower than Service Pack 20, we highly recommend that you upgrade all OCC
installations to the latest version.
Note
For installation local administrator rights might be required. Registry settings will be
added under the following paths:
• HKEY_LOCAL_MACHINE\SOFTWARE\TechniData\EHS-AddOns\Systems
• HKEY_LOCAL_MACHINE\SOFTWARE\TechniData\EHS-AddOns\Instances
• HKEY_CURRENT_USER\Software\EHS-AddOns\Systems
• HKEY_CURRENT_USER\Software\EHS-AddOns\Instances
1. Make sure that your front-end computer fulfills the system requirements listed in chapter
Prerequisites.
2. Download the latest SAP EHS Expert and OCC setup files. See chapter Where to get EHS
OCC for details.
3. Run Expert/OCC Setup
4. Choose Option "Open Content Connector". If Expert rule sets are used on this computer,
additional setup options may be required.
5. ODBC-(Database) drivers to access mapping databases are installed automatically, if they
do not already exist.
Detailed information how to create and test a RFC connection can be found in the following
chapters.
EHS OCC is an Microsoft Windows PC program that is executed on the front-end computer
and not on the SAP EHS application server. This program communicates via RFC connection
with the EHS database using a standardized BAPI interface.
The Remote Function Call destination (RFC destination) in the SAP system has to be set up for
EHS Expert and OCC. It is recommended to use the EHS Administration Service and therefore
a RFC destination for the Administration Server has to be set up additionally.
To set up a RFC destination choose from the SAP Easy Access screen Tools --> Administration
--> Network --> RFC Destination (transaction sm59). The Display and Maintain RFC Destina-
tion screen appears. Then setup the RFC connection for the EHS Service Administration, the
EHS Expert and OCC as follows:
• Connection type: T
• Gateway options: If your SAP system comprises a number of application servers, you
must specify under Gateway Options the gateway under which the EHS management
server has registered itself.
• Description: Enter a text to describe the RFC destination.
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Reg-
istered Server Program.
4. In the Registered Server Program screen area, enter the PROGID entry from your installa-
tion (see How to install EHS Expert or entry in the file SAPRFC.ini) in the program ID field.
5. Save your entries
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit of the EHS Expert (see Extend Entry in Secondary Data Determination). We
recommend to use the same name for your systems in order to transport customizing
settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination.
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Reg-
istered Server Program.
4. In the Registered Server Program screen area, enter a unique identification in the Program
ID field. The program ID corresponds to the PROGID in the SAPRFC.ini.
5. If the SAP system comprises a number of application servers, you must specify under Gate-
way Options the gateway of the application server under which the EHS Expert server has
registered itself. Enter the values for the parameters GWHOST and GWSERV from the
SAPRFC.INI file of the EHS Expert server for the input fields Gateway host and Gateway
service.
6. Save your entries
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit(s) of SAP EHS Regulatory Content - substance lists and reference data (see
Extend Entry in Secondary Data Determination). We recommend to use the same name
for your systems in order to transport customizing settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination: EHS Open Content Connector
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Start
on Frontend Work Station.
4. In the Start on Frontend Work Station Program screen area, enter $shell\ehsOCC.exe
5. Save your entries
To test the RFC destination, you must have started the EHS Expert server and the above step
Create the RFC Destination must have been completed.
• In the SAP Easy Access screen, choose Tools -> Administration -> Administration -> Network
-> RFC Destinations (transaction SM59).
• In the RFC Destinations tree, choose TCP/IP connections -> <name of your RFC destina-
tion> and open the destination with a double-click.
• Choose Test connection.
The test is running successfully if transmission duration times are displayed in the SAP window.
The required user exits are included in the customizing transport Basic Customizing of each
content package for substance lists and reference data. As an alternative, you can create the
user exits manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Import BC-Sets
Please find detailed information about this customizing activity within this document Sec-
tion A.4, “How to import BC sets”
In the example at the bottom you can see the typically used entries for secondary data deter-
mination with Expert rule sets and OCC data loads. The required entries for the specific rule
sets are explicitly given in the functional description of the rule set and in the appendix for SAP
EHS Regulatory Content - substance lists and reference data.
Activities
1. In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
2. Create a new user exit with user exit category SUB_SEDACA using
C1E5_SUB_EXPERT_EVALUATE as Function Module (copy the entry of a DEMO-rule set
as template for your new user exit).
The following environment parameters must be set up for the reference modules
C1E5_SUB_EXPERT_EVALUATE:
• EXPERT_COMMIT_MODE
Specifies the backup mode for secondary data determination by the EHS Expert.
If you enter the value I, the SAP system creates the new data records that were determined
by the EHS Expert without changing other data records.
If you enter the value D, the SAP system deletes all the existing data records and creates
the newly determined data. If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is
set, then only those data records are deleted that were determined during previous runs of
the EHS Expert. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the
data provider (parameter EXPERT_WRITE_OWNER) the SAP system recognizes which
data was determined previously by the EHS Expert.
Note
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.
If you enter the value C the SAP system resets the active indicator for the newest of the
data records and deletes all other existing ones. The number of data records to be de-
activated can be derived from the parameter EXPERT_NUM_OF_DEACT_VALUATION.
The data records that were newly determined by the EHS Expert are also created. If the
EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records
are deleted that were determined during previous runs of the EHS Expert. This helps
you prevent data records being deleted inadvertently. The SAP system uses the da-
ta origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter
EXPERT_WRITE_OWNER) to recognize which data was determined previously by the EHS
Expert.
• EXPERT_DESTINATION
Corresponds with the name of the RFC destination that is entered under Tools -> Adminis-
tration -> Administration -> Network -> RFC Destinations (transaction SM59) (for example
EHS_EXPERT).
• EXPERT_READ_RATING and EXPERT_READ_VALIDITY_AREA
Determine the rating and validity area for which the data is transferred from the SAP system
to the EHS Expert.
• EXPERT_WRITE_RATING and EXPERT_WRITE_VALIDITY_AREA
Determine the rating and validity area with which the data determined is stored in the SAP
system. In the EHS Expert set of rules you can also specifically define a different rating and
validity area that are used when storing data in the system.
• EXPERT_READ_USAGE_1...n and EXPERT_WRITE_USAGE_1...n
These parameters can be used in addition to the two previous parameter pairs. You can
specify any number of usages in the format VACLID/RVLID/EXCLFLG (rating/validity/ex-
clude indicator). The parameter numbering has to start with 1 and has to be consecutive.
Examples
EXPERT_READ_USAGE_1:PUBLIC/REG_EU EXPERT_READ_USAGE_2:PUBLIC/DE/X
In this example, the system reads all data records that are valid in the EU but not in Germany.
EXPERT_WRITE_USAGE_1:PUBLIC/REG_EU
EXPERT_WRITE_USAGE_2:PUBLIC/US
In this example, the system writes all data records that are valid both for the EU and for
the USA.
• EXPERT_WRITE_SOURCE_ID
Data origin that must be created in the IMG activity Specify Data Origin.
The following environment parameters can be set up for the reference module
C1E5_SUB_EXPERT_EVALUATE (not all possible parameters are described here):
• EXPERT_COMMIT_FLG
If you set this indicator to X, the system calls the update function specified in the parameter
EXPERT_COMMIT_FUNCTION after the calculation is finished on the Expert server.
If you do not set this indicator, the EHS Expert server directly calls the update function. In
a productive system, we recommend that you set the indicator so that the Expert server is
available again more quickly for other parallel calls. During development and testing it may
be useful to not set the indicator, so that error messages from the update function are logged
in the log files and so you have the option of displaying the runtime of the update function
on the console or in the event display.
• EXPERT_NUM_OF_DEACT_VALUATION
Determines the number of data records that are not deleted for save mode C, but are set
to inactive.
• EXPERT_PARAMETER_CHANGE_MODE
If you enter the value S (default), the SAP system displays the Determine Secondary Da-
ta dialog box in display mode when starting secondary data determination using the EHS
Expert.
If you enter the value E you can revise the environment parameters in the Determine Sec-
ondary Data dialog box when starting secondary data determination using the EHS Expert.
The environment parameters you specified in Customizing are displayed as default values.
If you enter the value H the SAP system does not display the Determine Secondary Data
dialog box when starting secondary data determination using the EHS Expert.
• EXPERT_RES_BY_SRSID_OWNID_FLG
Set this indicator if in backup modes C or D only data is to be deleted by the EHS Expert
that was determined during previous runs of the EHS Expert.
Warning
If you do not set this indicator, data that has also been entered manually or imported
can be deleted in backup mode C or D by the EHS Expert during secondary data
determination.
• EXPERT_WRITE_OWNER
Data provider that you must have created in the SAP component Product Safety under Tools
-> Addresses -> Edit Data Providers. The data provider must always be entered with 10
digits.
If you do not specify a data provider, the SAP system uses the authorization group for the
specification to determine the respective data provider (see IMG activity Specify Authoriza-
tion Groups). If the SAP system does not find any data providers there, it creates the data
without a data provider.
• EXPERT_HIDDEN_PROCESSING_MODE
ONLINE (default): The EHS Expert run starts immediately after you choose Execute.
BACKGROUND: The EHS Expert runs as a background job. The indicator for the parameter
EXPERT_ASK_FOR_STARTTIME must be set for the start time prompt.
• EXPERT_ASK_FOR_STARTTIME
If you set this indicator, you will be prompted in a dialog box when the EHS Expert is to start
as a background job.
• EXPERT_ADD_PARAM_1...n
You can pass any number of parameters to the set of rules. This means you can make sets
of rules configurable. In the set of rules you must create a fact for this purpose that is mapped
to the external ID P:I_TAB_PARAM in fact mapping.
• EXPERT_WRITE_RUN_DATE
With this parameter, the Expert will write the current date with each run of
the given Expert rule: Enter the value X here, and set the further parame-
ters EXPERT_EXPLANATION_ESTCAT, EXPERT_EXPLANATION_RULE_PROP, and
EXPERT_EXPLANATION_DATE_PROP as described below. Please note that this option
requires the implementation of OSS note no. 1450276!
You set up the explanation component (optional) of the EHS Expert using the following pa-
rameters:
• EXPERT_EXPLANATION_DISPLAY
If you set this parameter to X and allow the set of rules to run in the foreground, the system
displays the explanation immediately after the set of rules run. For sets of rules that run in
the background, the system does not display the explanation automatically.
• EXPERT_EXPLANATION_SAVE
Set this parameter to X if you want to save the explanation for the set of rules run in the
specification. If you set the parameter to X, you must also edit the following parameters:
• EXPERT_EXPLANATION_ESTCAT
In this parameter you specify the value assignment type in which the explanation is to be
saved as a user-defined text. The standard version of the demo sets of rules contains the
entry SAP_EHS_0101_002. This value assignment type is not in a property tree because
the explanation is not displayed as a user-defined text but in the menu.
• EXPERT_EXPLANATION_RULE_PROP
In this parameter you specify the characteristic in which the name of the set of rules is
saved to allow its assignment when displayed at a later stage. The characteristic must be in
the same value assignment type as the user-defined text for the explanation. The standard
version of the demo sets of rules contains the entry SAP_EHS_0101_002_RULESET.
Note
If you run a master data match up, the system automatically appends a phrase set
and a check module to the characteristic. You must remove this check module again.
• EXPERT_EXPLANATION_DATE_PROP
In this parameter you specify the characteristic in which the current date is written with each
rule run. The characteristic must be in the same value assignment type as specified in the
parameter EXPERT_EXPLANATION_ESTCAT. The standard version of the demo sets of
rules contains the entry SAP_EHS_0101_002_RUN_DATE. The last run date is only written
when triggered separately with the parameter EXPERT_WRITE_RUN_DATE. Please note
that this option requires the implementation of OSS note no. 1450276!
• EXPERT_EXPLANATION_TEXTCAT
In this parameter you specify the user-defined text type with which the explanation is to be
saved in the specification. The standard version of the demo sets of rules contains the entry
EX.
• EXPERT_ADD_PARAM_1
In this parameter you specify the path and name of the index / header file of your SAP EHS
Regulatory Content database.
• EXPERT_ADD_PARAM_2
In this parameter you can specify a user name to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_ADD_PARAM_3
In this parameter you can specify a password to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_TAB_FIELD_1
This parameter is the specification key from SAP EHS, it should not be changed.
• EXPERT_TAB_FIELD_2
In this parameter you specify the identifier that OCC should use when looking for substance
data. This is usually either the CAS or the UN number.
• EXPERT_TAB_FIELD_3
In this parameter you specify the identifier that OCC should use for display. Choose an
identifier that is available for all substances like synonym name.
INTERNAL: SAP CUSTOMER 52 © SAP SE
SAP EHS Regulatory Content - sub-
stance lists and reference data
• EXPERT_TAB_FIELD_4
In this parameter you can specify a second identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifier specified in
EXPERT_TAB_FIELD_2 does not give a search result. The main purpose is for loading data
that is not assigned to CAS numbers.
• EXPERT_TAB_FIELD_5
In this parameter you can specify a third identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifiers specified in
EXPERT_TAB_FIELD_2 and EXPERT_TAB_FIELD_4 do not give a search result. The main
purpose is for loading data that is not assigned to CAS numbers, e.g. by using PMN numbers.
EXPERT_COMMIT_FLG
EXPERT_COMMIT_FUNCTION C1E5_SUB_EXPERT_DATA_CHANGE
EXPERT_COMMIT_MODE I
EXPERT_DESTINATION EHS_OCC
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE H
EXPERT_READ_RATING
EXPERT_READ_VALIDITY_AREA
EXPERT_RES_BY_SRSID_OWNID_FLG
EXPERT_RULE_SET CLEO_PS
EXPERT_TAB_FIELD_1 <subid>
EXPERT_TAB_FIELD_2 <identifier>[NUM,CAS]
EXPERT_TAB_FIELD_3 <identifier>[NAM,SYN]
EXPERT_TAB_FIELD_4 <identifier>[NAM,TRIV]
EXPERT_TAB_FIELD_5 <identifier>[NUM,PMN]
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID TECHNIDATA
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
5.2.2.1.2.2. Settings
The required data origin is included in the customizing transport Basic Customizing of each
content package for substance lists and reference data. As an alternative, you can create the
data origin manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
If you maintain the data origins manually, please find the proposed settings for the data origin(s)
To add new data origins use transaction "spro" for the IMG customizing. Navigate to Environ-
ment, Health & Safety ->Basic Data and Tools -> Tools -> Import ans Export -> Basic Settings
for Import and Export -> Specify Data Origins.
The required phrase catalogue is included in the customizing transport Basic Customizing
of each content package for substance lists and reference data. As an alternative, you can
create the phrase catalogue manually with the description below.
Note
Dangerous Goods Basic data package does not require a phrase catalogue, only Prod-
uct Safety and extended Dangerous Goods with packaging data make use of phrases.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
This chapter describes how to create passive phrase catalogue TDCLE and how to setup
number ranges.
To create a passive phrase catalogue start the IMG customizing (transaction spro) navigate
to Environment, Health & Safety -> Basic Data and Tools -> Phrase management -> Specify
Phrase Libraries and Phrase Groups.
Requirements : You have already defined the number ranges for the phrase key.
Note
One library has to be the active library.
You can use all libraries available on the market that support the conversion formats of
the SAP component Environment, Health and Safety (EHS).
Here the interval limits of the internal (0I) and the external number range (0E) must be entered.
The internal number range is assigned by the system itself while the automatic key definition
whereas the external number range must contain all phrase keys which are not produced
automatically but entered manually or by phrase import.
EH&S 2.5B and newer: Implementation Guide for R/3 Customizing (IMG) / Environment, Health
& Safety / Product Safety / Phrase Management / Specify Number Ranges for Phrases
EH&S 3.2 and newer: Implementation Guide for R/3 Customizing (IMG) / Environment, Health
& Safety / Basic Data and Tools / Phrase Management / Specify Number Ranges for Phrases
To import the CED phrases the external number range 0E must have the alphanumeric interval
from A to ZZZZZZZZZZZZZZZ.
We recommend to designate the internal number range 0I for numeric values only (interval
100000000000000 to 899999999999999).
OCC uses a special user defined text type called OCCUNQID (OCC unique record ID) that is
required to link data sets between SAP EHS and the external substance lists and reference
database. In addition, some packages of SAP EHS Regulatory Content - substance lists and
reference data require additional user defined text types like NOL (name on list). These user
defined text types need to be created in SAP EHS customizing.
The required user defined text types are included in the customizing transport Basic Cus-
tomizing of each content package for substance lists and reference data. As an alternative,
you can create the user defined text types manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please find the proposed settings for the User Defined Text Type. .
To add new data origins use transaction "spro" for the IMG customizing. Navigate to Environ-
ment, Health & Safety ->Basic Data and Tools -> Specification Management -> Additional In-
formation for Value Assignment -> Specify User-Defined Text Types.
All data sets and identifiers in the substance lists and reference database are assigned to a
specific regulatory list. These regulatory lists need to be created in SAP EHS customizing.
The required regulatory lists are included in the customizing transport Master Data Customiz-
ing of each content package for substance lists and reference data. As an alternative, you can
create the regulatory lists manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please ask us for details if you want to manually customize regulatory lists for substance lists
and reference data.
Start transaction "spro" and navigate to: Environment, Health and Safety -> Basic Data and
Tools -> Specification Management -> Specification Master -> Specify Regulatory Lists
All data sets in the substance lists and reference data are assigned to a specific literature
source. These literature sources need to be created in SAP EHS customizing.
The required literature sources are included in the customizing transport Master Data Cus-
tomizing of each content package for substance lists and reference data. As an alternative,
you can create the literature sources manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please ask us for details if you want to manually customize literature sources for substance
lists and reference data.
Enter the sources and assign a specification category to each source. You can assign the
source key as required.
You can create new sources at any time, even in a productive system, from the EHS menu by
choosing Basic Data and Tools -> Tools -> Current Settings -> Specify Sources.
Navigate to Environment Health and Safety -> Basic Data and Tools ->Specification Manage-
ment -> Additional Information for Value Assignment -> Specify Sources.
Substance lists and reference data makes use of some additional identifier types that are not
available in the SAP EHS standard. These additional identifier types need to be created in
SAP EHS customizing before substance lists and reference data can be used.
The required additional identifier types are included in the customizing transport Master Data
Customizing of each content package for substance lists and reference data. As an alterna-
tive, you can create the identifier types manually with the description below.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please ask us for details if you want to manually customize identifier types for substance lists
and reference data.
Start transaction "spro" navigate to Environment, Health and Safety -> Basic Data and Tools
-> Specification Management -> Specification Master -> Check Identification Types.
• Mode of Transport
• Dangerous Goods Regulations
• Dangerous Goods Class and Dangerous Goods Letter (Tables THM009, THM010, THM011,
THM012)
• Risk Potentials (Table THM071)
• Hazard Identification Numbers (Table THM031
• Danger Labels (Table THM017)
• Packing Instruction Numbers (Table THM075)
The required additional DG customizing entries are included in the customizing transport DG
Master Data of the substance lists and reference data for dangerous goods Content Package.
As an alternative, you can make the settings manually using the description below.
Most of the customizing required for substance lists and reference data for dangerous goods
is included on two customizing transports available for Unicode and Non-Unicode systems.
Please be aware that these transports include DG master data customizing and should be
carefully checked and tested before used in a system with existing DG customizing.
Note
For international, European and North American regulations we provide additional
packing data. The customizing tables for these data are just available in system releas-
es from ERP 6.0 on. If you use a system release before ERP 6.0 please implement the
customizing transports without packing data only.
Note
Two different options are provided for CFR and TDG: Either data can be provided with
a split by mode of transport (air, road, rail, ...) or combined into one data set. Please
choose the correct customizing transports to support your preferred data model.
Please check that the following modes of transport exist in your system. The entries highlighted
(MTrCat. 7, 8 and 9), most likely do not exist in a system with standard customizing. Only create
these entries if you want to use CFR/TDG data with a split by mode of transport. If combined
CFR/TDG data is used, no entries are required.
-> Environment, Health & Safety -> Dangerous Goods Management -> Basic Data and Master
Data -> Common Settings -> Specify Mode-of-Transport Category
Please check that the following dangerous goods regulations exist in your system. The entries
highlighted, most likely do not exist in a system with standard customizing.
-> Environment, Health & Safety -> Dangerous Goods Management -> Basic Data and Master
Data -> Common Settings -> Specify Dangerous Goods Regulations
Only create the above highlighted entries if you want to use CFR/TDG data with a split by
mode of transport. If combined CFR/TDG data is used, replace these by combined entries as
shown below:
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please contact us for details if you want to customize the DG master data settings manually.
Due to the huge number of customizing entries, these are not listed in this documentation.
SAP EHS offers wide customizing options regarding dangerous goods master data. Mainte-
nance of these customizing settings is done in transaction SPRO at Environment, Health and
Safety - Dangerous Goods Management - Basic Data and Master Data. Here there are three
further sub-nodes, Common Settings, Basic Data, and Master Data, each consisting of multi-
ple customizing items. In the following those customizing activities that may be relevant are
described in detail.
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Dangerous Goods
Classes and Classification Codes:
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Basic Data - Specify Risk Potential:
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Hazard Identification
Numbers:
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Danger Labels:
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Packing Instruction
Numbers: (these entries are just used in RiscClssification for creation of transport documents)
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Categories for En-
closure: (these entries of packing instructions are used in PackingRequirements)
Start transaction SPRO and navigate to Environment, Health and Safety - Dangerous Goods
Management - Basic Data and Master Data - Common Settings - Specify Packing Codes:
(these entries of packing codes are used in PackingRequirements, do not use Packing Codes
(old))
The required validity areas are included in the customizing transport Validity Area Customiz-
ing of each content package for substance lists and reference data. As an alternative, you can
create the validity areas manually with the description below.
Note
Validity areas for SAP EHS Regulatory Content - substance lists and reference data
for dangerous goods are not included in a customizing transport. Please see the next
chapter for details on validity areas required for substance lists and reference data for
dangerous goods.
Note
Validity Area REG_EU is not part of our transports as REG_EU is a standard value
of SAP EHS. As the European Union has new member countries, please carefully
check that validity area REG_EU includes all of the following countries. If countries are
missing, please add them to REG_EU after consultation of the responsible persons.
See also chapter Section 5.2.2.9.3.1, “How to add validity areas” for details on how to
extend existing validity areas.
5.2.2.9.1. Validity Areas for SAP EHS Regulatory Content - substance lists and refer-
ence data for dangerous goods
SAP EHS Regulatory Content - substance lists and reference data for dangerous goods makes
use of the following validity areas, which are not included in the customizing transports. Please
see the chapter about manual customizing below on how to check / add these validity areas.
Upload files
Additional information how to upload files is provided within this document Section 4.2.2.1,
“How to upload files”
Import transports
Please find detailed information about this customizing activity within this document Sec-
tion 3.2.2.1, “How to import transport requests”
Please ask us for details if you want to manually customize validity areas for SAP EHS Reg-
ulatory Content data.
The validity area determines in which jurisdictions values assigned to specifications apply. You
specify validity areas depending on the validity area categories. You can use the validity area
categories to define plants, business areas or regions, for example, as validity areas. You can
assign individual jurisdictions or organizational units at a lower level to each validity area, for
example:
You can assign countries and regions from the country table as validity areas for validity areas
of the category REGION. You can assign other organizational units for validity areas of another
category.
The definition of validity areas is closely linked to the requirements for reports. The validity
areas for this IMG activity are also used in the R/3 component Dangerous Goods Management.
Caution
• Be aware, that the validity area "REG_WORLD" is "empty" and
has the default behaviour to recognize all countries.
• Once you have used a validity area in a productive system, it can
no longer be deleted.
• Newly created validity areas are not evaluated correctly by the
Expert before restarting the Expert Server.
• Please see also SAP Note 603152 - Country Codes for Serbia
and Montenegro
• Press F5 or "New Entry" and enter the Validity area category (e.g. REGION) and the new
area as well as the description. Mark the entry and switch to the navigation sidebar
• Double clicking the "Assign Validity Area/Country" entry the list of countries belonging to
this area opens (- empty). There you can assign all countries that shall belong to this new
validity area.
Through the extended substance search functionality, you will be able to search for list sub-
stances that have new and/or changed data available from SAP EHS Regulatory Content -
substance lists and reference data. The result will be given as a hit list directly in SAP EHS.
Note
This functionality has been integrated as a standard functionality into SAP EHS. Please
do not use the program that was included in previous releases of SAP ERC and use
the standard functionality described below.
Please check in your specification workbench if the extended search functionality "New Data
Available for Substance.." is available: Note 1563938 - No extended search function to search
for updated substances
If this is not the case, please follow the instructions in SAP Note 1563938 - No extended search
function to search for updated substances.
5.2.3. Phrases
SAP EHS Regulatory Content makes use of a multilingual phrase library. The required phrases
are provided as SAP EHS phrase import files for different operating systems.
All phrases are available in English language and in all other languages that a regulatory list
was published, e.g. phrases for the German WGK list will be available in English and German
only.
Each SAP EHS Regulatory Content package includes all necessary phrase import files. The
basic steps for a phrase import are:
Detailed information for all steps will be provided in the following chapters.
Note
Please note that SAP EHS Regulatory Content data is always based on the latest EHS
property tree. If the property tree is not updated, importing phrase set assignments will
cause error messages.
Upload all phrase import files and the phrase set assignment file from your local drive to the
application server.
Ask your administrator for the upload path on your application server. You may check for the
path also via transaction AL11.
For example :
Use transaction CG3Z for uploading and choose BIN(ary) transfer format as shown in the
screen shot below.
Size of path and filename is limited. It may be necessary to either shorten the import file names
or choose a short directory path to upload the files.
Please check that you upload the correct files for the operating system of your application
server. You may also have to consider if Unicode or Non Unicode system. For non-unicode
files, the update delivery includes import files formatted for MS Windows and UNIX. You can
get info about the OS in R/3 at -> System -> Status. Under the "Host data" header you can
see the operating system used by the R/3 server.
The upload of import files onto the application server and the import into EHS are completely
independent from any language specific settings on the front-end PC, i.e. phrases can be
uploaded and imported with every regional default setting.
The following chapters describe in detail how to import phrases into a passive catalogue, merge
them into an active catalogue and assign them to phrase sets.
Choose Data Transfer - > Phrases (Transaction CG31) ; please see screen shot below.
• "File with path" - Enter the path and file name (same as target file section upload files )
• For all files choose UTF-8 as character standard.
• You can leave all other options blank
• Optional: You can limit the import to certain languages if you want (Button "Language se-
lection" )
• Check the file (F5)
• Carefully check the displayed information before importing the phrases. Make sure you im-
port to the passive CED or TDCLE library, the versions are correct and no errors are dis-
played.
• If necessary approve the message "Date of phr. lib. to be imported is identical to date of
current library", this is just for your information.
• However if the file you want to import is older than the library in your system, you can not
import it. Please make sure you have chosen the correct import file. In section upload files
you can also find information on how to change the header data of your import files.
• Choose "Transfer/start time" (F6)
• Choose "Immediate" or specify a time
• Save
Note
Phrase import files for CED and TDCLE libraries include all phrases of the library,
not only those that are new or updated. Please be aware that all manual changes
made in your CED or TDCLE phrases will be overwritten.
Caution
Please do not set the flag for full import as this will delete your
passive library!
To merge phrases from a passive catalogue into the active, use transaction cg12 and start with :
If you are updating your phrase library, we recommend to restrict the phrase selection to
only new and revised phrases. Please use the Phrase created/changed... functionality with
the settings shown in the screenshot:
Note
It is not recommended to press the "Determine target phrase" - button as this may
select phrases as target phrases that are not appropriate or may not have e.g. all
language translations.
Note
The merging process normally does not perform well when processing several thou-
sand phrases at one time. Therefore, we strongly recommend that only a part of the
phrase library is merged at one time (e.g. filtered by phrase groups or phrase keys).
Prior to importing phrase set assignments, the phrases have to be merged into the active
library. After uploading the phrase set assignment file, the assignments should to be imported
into SAP EHS.
• "File with path" - Enter the path and file name (same as target file section upload files )
• Check the "Phrase Set Assignmt" option as shown in the screenshot below
Sometimes none or only a few assignments are imported. If you encounter this error, the first
step would be to run this import several times until no more phrases are assigned to phrase
sets. If this does not help an easy work-around is to change the name of the phrase library in
the import file to the name of your active library. Upload and import this modified file. In section
upload files you can also find information on how to change the header data of your import files.
As the phrase set assignment files are based on the latest SAP EHS standard property tree
there will be warnings in the logfile of the import if your system is not updated with the latest
standard property tree. These warnings can usually be ignored. Customers with valid mainte-
nance contracts for SAP EHS Regulatory Content - expert rules for substance and mixture
classification or - substance lists and reference data receive the latest tree as part of their reg-
ular maintenance. Should you need any additional info on this topic please feel free to contact
us.
5.2.4.1.1. How to setup/update XML substance database for substance lists and refer-
ence data
Note
No database server is needed, any file server with a fast connection and sufficient
storage space is suitable.
Your data implementation or update package contains a setup file e.g. ERC_PS_Region_
2015-2.exe which includes all required database XML files. Please execute this file and choose
the correct path to your SAP EHS Regulatory Content - substance lists and reference data
(Product Safety or Dangerous Goods) database installation. The path must match the entry of
the secondary data determination User Exit for data load, see chapter How to configure the
User Exit.
Note
Please carefully check the installation path if you are updating an existing database to
avoid mixing up e.g. productive and test databases.
In your XML substance database folder, a text file called version.txt is stored which
will have information about the currently installed database. Please check the version
file before updating the database to avoid overwriting your database with the same or
older files.
Note
Customers who have licensed both the SAP EHS Regulatory Content SDS Authoring
and Marketability packages have the possibility to load regulatory lists data from both
packages with one data load.
In case you have licensed both, SDS-Authoring and Marketability, and you load both
packages with one data load, please do not install the SDS-Authoring package for list
data. Instead, please use the Marketability installation file and follow the instructions
there to install the combined content for both packages.
Each installation of the substance lists and reference data XML substance database takes
approximately 1,5 GB for Product Safety and 1,1 GB for Dangerous Goods database.
After installation of the XML files, the structure of the database should look like:
Product Safety:
<path to XML substance database>\ERC-PS\ main folder with index file and version info
(header.xml and version.txt)
<path to XML substance database>\ERC-PS subfolder with all CAS numbers starting with 1
\1
<path to XML substance database>\ERC-PS subfolders for other CAS numbers starting
\... with 2 to 9
<path to XML substance database>\ERC-PS subfolder with all substance groups
\G
<path to XML substance database>\ERC-PS subfolder with all non-substances data, e.g.
\N mixtures and data with no CAS number
<path to XML substance database>\ERC-DG\ main folder with index file and version info
(head.xml and version.txt)
<path to XML substance database>\ERC-DG subfolder with all data for DG regulation
\ADN ADN(R)
<path to XML substance database>\ERC-DG subfolders for other DG regulations
\...
<path to XML substance database>\ERC-DG subfolder with all available UN numbers
\UN
Alternatively extract the files and burn a DVD if no network folder should be used (performance
loss!). The network path for database must be accessible for all users (read access). For
security reasons, access should be limited to persons allowed to load SAP EHS Regulatory
Content - substance lists and reference data. Please note the path to the database in the
installation protocol.
It is possible to have separate databases for Test, Development and Productive systems. This
allows testing of data updates without impact on the productive data load. If you want to do this,
copy the whole database including all subfolders to a different storage location. In addition,
changes to the mapping database and user exit are required to support multiple databases
(see also chapters How to configure the User Exit, How to configure EHS OCC and How to
setup Mapping Database).
Note
Please make sure that you have a fast network connection between your OCC front-
end computer, SAP application server and the storage location of the XML substance
database. WAN connections are usually unsuitable for OCC as large amounts of data
have to be transferred. See also SAP note 1235663 for further hints to improve the
OCC performance.
Substance lists and reference data is provided with a standard mapping database, which
makes use of the latest EHS standard property tree, Substance lists and reference data related
phrases and multilanguage phrase libraries for hazard communication. Use of other properties
or phrase libraries is possible, but not explained in this document. Please contact us for details.
5.2.5.1.1. How to setup/update mapping database for SAP EHS Regulatory Content -
substance lists and reference data
The mapping database file is included in folder 5-Mapping-Database of your SAP EHS Reg-
ulatory Content -substance lists and reference data package. The mapping file is named td_
cleo.mdb for product safety and td_cleo_dg.mdb for dangerous goods.
This mapping database can either be installed locally for each user or used as a central net-
work-database for all users.
• If network access is slow or bandwidth is limited, response time during data load might be
longer. Especially creating the cache will be much slower.
• In rare cases conflicts in opening the database if several persons are loading substance lists
and reference data at the same time
Note
Please make sure that you have a fast network connection between your OCC front-
end computer and the storage location of the mapping database. WAN connections
are usually unsuitable for OCC as large amounts of data have to be transferred. As the
mapping database is used to store cached data for improved performance, this file can
get quite big (over 100 MB). See also SAP note 1235663 for further hints to improve
the OCC performance.
If you are copying the mapping database from a CD/DVD to your local drive/network,
please remove the write protection of the file td_cleo.mdb after copying to your local
drive.
If the active phrase library is different than CUST, changes to the mapping database are re-
quired:
Replace all
Note
If several installations were done for the database (test/dev/prod), we recommend a
separate mapping database for each of the installations.
The OCC mapping database follows the same structure as SAP EHS Expert mapping databas-
es. There are separate mapping tables for properties, phrases and other values:
We recommend replacing the mapping database with the new version included in your update
package as additional phrases and regulatory lists are added in the phrase mapping table.
If you have made your own changes to the mapping database, e.g. renamed identifiers or
phrase mapping changes, please take care to implement your changes also in the new map-
ping database. If your active phrase library is different than CUST, changes to the mapping
database as specified above are required.
You can find the path of your mapping database in the ExpertAdmin tool installed on your front
end computer. On the instances tab there should be entries for e.g. CLEO_PS or CLEO_DG
which specify the path to the current mapping database. Please see Section 5.2.7.1.1, “How
to configure EHS OCC” for details.
Repeat the above steps for all installations of the SAP EHS Regulatory content - substance
lists and reference data mapping database if you are using more than one mapping database
or if each user has a local copy of the mapping database.
Note
We recommend to create a backup copy of your existing mapping database before
overwriting it with the new version of the mapping database.
In all tables, Internal_id means the key/value in the database and External_id the correspond-
ing key/value in SAP EHS.
SAP EHS Regulatory Content includes a tool for Microsoft excel, which uses the simulation
file generated by OCC as input and allows an enhanced analysis of changed data.
The following chapter describes the installation of the tool. Use of the tool is explained in the
update guide for SAP EHS Regulatory Content - substance lists and reference data.
Note
This tool is currently only available for product safety data. You can skip this step if you
are only using dangerous goods.
The Simulation Tool for SAP EHS Regulatory Content - substance lists and reference data
is included in folder 6-UpdateTools and can be installed on front-end computers with a few
simple steps:
Note
In Excel 2013 the default personal templates location is sometimes empty. Please
check in your Excel Options under ->Save ->Default personal templates location
that a folder is specified. Make sure the simulation spreadsheet has been copied
to this folder. If no folder is specified, you can select your own folder to store Excel
templates.
• As an alternative, open cleo_simulation.xlt in Microsoft Excel 97-2003 and choose "Save
as...". Use the option for Excel templates *.xlt and the correct path to the template folder
should be preset. Save as xlt-file to this folder. For MS Excel 2007, open choose cleo_
simulation.xltm and save as "Excel Template with macros" *.xltm
• It is also possible to open the simulation Excel files directly, without specifying them as a
template.
Note
You need to activate the macros in cleo_simulation.xlt / cleo_simulation.xltm or
you will not have access to any of the functionalities of the tool. If you have installed
previous versions of the Simulation Tool for Excel you may want to make a copy before
overwriting with the new version. If you do not want to activate macros, we recommend
using the previous version of the tool which was not making use of any macros but
has limited functionality.
Note
In MS Excel 2007, you need to save this Excel file in a trusted directory or you cannot
activate the macros.
5.2.7. Adjustments
After the initial installation of SAP EHS Regulatory Content - substance lists and reference
data, manual changes are required to adapt OCC and the database to specific settings and
requirements. The following chapters have information on
The following settings in OCC must be created to support the data load of SAP EHS Regulatory
Content - substance lists and reference data.
Note
Please note that everything described in this chapter is only valid for SAP EHS Open
Content Connector (OCC) Service Pack 21 (November 2009) or higher. Please update
OCC to the latest version or contact us for the settings in older OCC versions.
Note
If multiple installations of the database exist for test, development and productive sys-
tems, the below steps must be repeated for all of them. Assign the name of the in-
stances as specified in the user exit parameter EXPERT_RULE_SET and assign the
appropriate mapping database.
Product Safety
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Instance Configuration ...
• Choose Add
• Name: CLEO_PS
• System: EHSOCC
• Mapping: Path to your mapping database TD_CLEO.mdb which was part of the installation in
step "How to setup Mapping Database"
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Preferences ...
• Switch to the Systems tab
• Choose Add
• Name: EHSOCCDG
• Options: All settings should have been automatically copied when the EHSOCCDG key was
created. No changes necessary.
• Choose Apply
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Instance Configuration ...
• Choose Add
• Name: CLEO_DG
• System: EHSOCCDG
• Mapping: Path to your mapping database TD_CLEO_DG.mdb which was part of the installation
in step "How to setup Mapping Database"
5.2.7.2.1. How to configure the User Exit for SAP EHS Regulatory Content - substance
lists and reference data
The user exit for secondary data determination substance lists and reference data needs to
be adapted to the installation path of the XML substance database for Product Safety or the
XML substance database for Dangerous Goods. EXPERT_ADD_PARAM_1 of the User Exit
has to be changed to reflect the path of the database index file of either the productive or the
test database.
Environment, Health & Safety -> Product Safety -> Basic Settings -> Manage User Exits
If multiple installations of the database exist for test, development and productive systems,
copy the UserExit for each separate installation of the database. Change the following two
parameters:
Open Content Connector supports the use of up to 2 alternative search identifier types. For our
product safety data we support the use of a generic key to load substance groups or generic
dust / PNOS information and PMN numbers from TSCA as alternatives for a load by CAS
number.
These alternative searches will only be used if no CAS number is maintained in the list sub-
stance.
Please note that this functionality requires SAP EHS OCC SP37 or higher versions.
If you want to make use of this alternative search, the secondary data determination user exit
has to be extended. Please add the following two parameters if they do not exist:
This will allow you to use the NAM TRIV identifier type to load substances without a CAS
number by the technical key. You can replace NAM TRIV by any other identifier type that you
want to use for this purpose.
You can use the technical key of a substance group or generic entry for this search. For some
common generic entries, we have also created easy to use search keys:
• DUST: This search parameter can be used to load generic dust OEL values and other data
that is available for dust entries. You can also select from various dust sub-categories during
the data load, e.g. organic dust, inorganic dust.
• PNOS: This search parameter can be used to load data for particles/particulates not other-
wise specified.
• WOOD: This search parameter can be used to load data for many kinds of wood dust (hard-
wood, softwood, etc.)
The same functionality can be used to load our data by using the TSCA PMN number instead
of a CAS number.
Example: Maintaining NUM PMN "P-00-1122" in your list substance allows you to load the
same data as you could by maintaining NUM CAS 12032-75-6.
After the implementation of SAP EHS Regulatory Content - substance lists and reference data,
mapping can be changed according to customer needs. The following items can be changed
in the mapping database:
As SAP rule sets and WWI templates are designed to work with our standard mapping, any
changes in mapping may cause changes to SDS template and rule sets. If mapping changes
are required, please contact the Content as a Service team for detailed info and support.
The following chapters describe the mapping database tables and their fields.
Note
Substance lists and reference data for dangerous goods requires mapping changes
depending on the data model you have chosen for North-American DG regulations
(CFR, TDG). Please see the next chapter for details.
No changes are required if you are using CFR and TDG without the split into modes of trans-
port. You can use the TD_CLEO_DG.mdb as provided.
During next start of OCC de select the remaining carrier versions of CFR and TDG so that just
the two mapped entries remain. Store this setting as default and in future you will just see and
load a single regulation for each country in NA region (Canada, US).
If a split into modes of transport for CFR and TDG is required, please use mapping database
TD_CLEO_DG_with_split.mdb instead of the one mentioned above. All settings are already
adapted for split of carrier versions therein.
Note
If you use a system with release before ERP 6.0 it contains no structures for additional
packing data. In this case please use a mapping database named “without pack” only
to suppress those additional data and avoid complications.
The fact mapping table contains the settings for mapping facts in the set of rules or OCC data
to characteristics or other elements in the EHS data model.
The first three fields together form a unique identifier for the fact in the set of rules.
Example how you can add a CAS number as identifier if you load your substance with a PMN
number:
The record mapping table contains the settings for mapping records in the set of rules or OCC
to value assignment types in EHS.
The first two fields together identify the record uniquely in the set of rules.
The phrase mapping table contains the regulations for mapping phrase codes used in the set
of rules or OCC XML files to phrase keys in EHS.
Note
Phrase mapping allows an assignment to be made between an internal and an external
value for any fact value. The phrase does not have to be an EHS phrase. The corre-
sponding conversion takes place if the IsPhrase indicator is set in fact mapping.
Expert generates a warning message if the rule set or OCC reads phrases which are
not contained in the Mapping table.
The phrase mapping table has to be enhanced if a customer uses additional customer specific
phrases.
To suppress the warning message these phrases have to be added manually to the phrase
mapping table.
Tip
We recommend to insert these phrases using the following pattern:
To consider these enhancements for updates of the standard mapping you should label
these manual settings in the database e.g. in the Version column.
The first part of the phrase key (column: External_Id) always signifies the active phrase cata-
logue in EHS.
If the active phrase catalogue in the EHS system is named differently then the mapping has
to be changed (using the replace function in MS Access).
5.2.8. Cache
OCC makes use of a caching functionally to improve the performance of the data load. After
the initial implementation and after each change of the XML database, the cache needs to
be created. The cache will be created automatically by OCC whenever the XML substance
database is changed:
Start OCC for Product Safety for any list substance after you have installed your XML sub-
stance database. The first load after the installation will analyze the database and will store
this information locally in your mapping database (cache).
This process may take from less than a minute to several minutes, depending on your network
speed to the XML substance database and your front-end computer (memory). Only the first
load will take this long, after the cache has been rebuild, load times should be down to only
a few seconds again.
We recommend that the first load is done by somebody with a fast connection to the XML
substance database, e.g. a user working at the same site as the XML substance database
installation.
Note
Do not cancel OCC if it looks like the program has locked up. This process may require
several minutes and in rare cases up to an hour.
Ensure that you have a fast network connection to the OCC mapping database and
the XML substance database. A WAN connection is insufficient for accessing a large
MDB file with the cache.
Make sure that caching of header data is activated, as described in Note 965586 (ac-
tivated automatically as of Support Package 14).
During the initial load, you need to review the filter settings in OCC and adapt them to your
business processes. For each regulatory list, a decision should be made if this list is required
by your business process or not. After reviewing the filter settings, you can define these as the
new standard by clicking the "Default" button in OCC.
The content reports for SAP EHS Regulatory Content - substance lists and reference data
will help you make this decision in case that you are not familiar with some of the content.
Content reports include a short description of the regulatory background and purpose of each
list, information about the SAP EHS property used to load this data and an example data set.
Note
As a general rule, load only lists that are used in your business processes. Data that
is loaded but not used will still create additional work in the update process when you
have to review updated data.
Deselect the following regulations - both under identifiers and regulations - if you want to load
Dangerous Goods data without split by mode of transport:
• CFR_AIR_C
• CFR_AIR_P
• CFR_INWTR
• CFR_RAIL_C
• CFR_RAIL_P
• TDG_INWT_C
• TDG_INWT_P
• TDG_RAIL_C
• TDG_RAIL_P
• TDG_ROAD_P
After reviewing the filter settings, you can define these as the new standard by clicking the
"Default" button.
Note
This chapter describes the Dangerous Goods solution for SAP Transportation Man-
agement. Users of SAP EHS Dangerous Goods can skip this chapter.
In the downloaded Package you can find a compressed ZIP file containing the content for
usage in SAP Transport Management. This file can be uploaded in the Content Import tool of
SAP Transportation Management without any processing steps from your side, e.g. unpacking
in your local file system.
6.1.1. Prerequisites
This chapter describes the prerequisites for using EHS Expert rule sets for secondary data
determination.
All Expert Rules require additional customizing activities such as the creation of separate us-
er-exits and data origins for each rule set.
In addition some Expert Rules require further customizing activities, e.g. additional value as-
signment ratings or user-defined free text categories.
These customizing entries are described for each rule set in the appendices.
It is recommended to perform the customizing activities before setting up the Expert Rules on
the Expert Server.
• Documentation: functional descriptions which describe the general functionalities of the rule
set and release notes which describe the changes compared to the previous versions.
• Expert rule set files and content database(s)
For a complete overview of all files included in this delivery of Expert Rules, please see the
list of Expert rule files.
6.2. Implementation
The following chapters describe how to implement Expert Rules.
you to test new versions of rule sets on the test EHS Expert Server independently from your
productive system. The following chapters describe the required installation steps.
EHS Expert is an independent Windows PC program. This program communicates via RFC
with the EHS database using a standardized BAPI interface.
EHS Expert is called from within EHS. The call is passed on to the Expert server which runs
on a PC. This server reads the EHS specification data via a BAPI interface.
Input facts , which are defined within the rule set and denoted with (IN), are filled with specifi-
cation data via the BAPI interface. Rules define the calculations to be made using these facts
and thus new data for other facts is derived. After all the rules have been processed the output
facts, which are denoted with (OUT), are outputted to the specification database via the BAPI
interface.
The definitions for the facts and rules used by EHS Expert are stored in a rule file. The rule file
is a text file that is automatically created when rules are defined using the rule editor. However
they can be created and edited using any text editor.
The assignment of facts and other parts of the rule set (i.e. records, compositions, internal
phrases) to the specification database elements (e.g. characteristics, value assignment types,
phrase keys etc.) is made via the mapping tables.
The installation program for EHS Expert is available on the current SAP Server Components
CD.
The current EHS Expert Version and respective patches are available on the SAP Support
Portal on the SAP Service Marketplace. You can find the patches for EHS Expert on the SAP
Service Marketplace under 'Support Packages & Patches' (http://service.sap.com/patches).
Detailed information on how to obtain the latest version of EHS Expert can be found in SAP
Note 568302.
The EHS Administration Server and EHS Expert are independent Windows PC programs.
These programs communicate via RFC with the EHS database using a standardized BAPI
interface.
The Remote Function Call destination (RFC destination) in the SAP system has to be set up for
EHS Expert and OCC. It is recommended to use the EHS Administration Service and therefore
a RFC destination for the Administration Server has to be set up additionally.
To set up a RFC destination choose from the SAP Easy Access screen Tools --> Administration
--> Network --> RFC Destination (transaction sm59). The Display and Maintain RFC Destina-
tion screen appears. Then setup the RFC connection for the EHS Service Administration, the
EHS Expert and OCC as follows:
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit of the EHS Expert (see Extend Entry in Secondary Data Determination). We
recommend to use the same name for your systems in order to transport customizing
settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination.
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Reg-
istered Server Program.
4. In the Registered Server Program screen area, enter a unique identification in the Program
ID field. The program ID corresponds to the PROGID in the SAPRFC.ini.
5. If the SAP system comprises a number of application servers, you must specify under Gate-
way Options the gateway of the application server under which the EHS Expert server has
registered itself. Enter the values for the parameters GWHOST and GWSERV from the
SAPRFC.INI file of the EHS Expert server for the input fields Gateway host and Gateway
service.
6. Save your entries
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit(s) of SAP EHS Regulatory Content - substance lists and reference data (see
Extend Entry in Secondary Data Determination). We recommend to use the same name
for your systems in order to transport customizing settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination: EHS Open Content Connector
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Start
on Frontend Work Station.
4. In the Start on Frontend Work Station Program screen area, enter $shell\ehsOCC.exe
5. Save your entries
To test the RFC destination, you must have started the EHS Expert server and the above step
Create the RFC Destination must have been completed.
• In the SAP Easy Access screen, choose Tools -> Administration -> Administration -> Network
-> RFC Destinations (transaction SM59).
• In the RFC Destinations tree, choose TCP/IP connections -> <name of your RFC destina-
tion> and open the destination with a double-click.
• Choose Test connection.
The test is running successfully if transmission duration times are displayed in the SAP window.
The advantage that the windows service has over the console program is that it does not
require that a user be logged on in order to execute the service. Thus a service can be started
automatically as a background process when the system is started up. It is recommend that
the EHS Expert Microsoft Windows service be used and that it be configured using the EHS
Service Administration.
Within the EHS service administration, the EHS management server has the following func-
tions:
You will find a detailed description of the EHS service administration in the SAP help (EHS --
> Basic Data and Tools --> Tools --> EHS Service Administration)
6.2.1.3.1.1. How to configure EHS Expert Server using EHS Service Administration
To call EHS service administration choose in the SAP menu --> Logistics--> Environment,
Health and Safety --> Basic Data and Tools --> Tools WWI and EHS Expert Server Adminis-
tration or use transaction cgsadm.
The system searches dynamically for all EHS management servers that are logged on to the
system and displays the PC names as the search results in the navigation tree.
• Double-click a PC name. The EHS management server is called and a list of all WWI and
EHS Expert servers installed in the system is displayed.
• Choose in the menu Service --> Create --> EHS Expert Server
• Choose a destination by using F4-help and enter a name a description for the EHS Expert
(in the example: EHS_EXPERT)
• Confirm your entries.
• The system enters the following data:
• The values for the selected destination in the RFC Parameters group box (Program ID,
Gateway host and Service)
• A generated service key (<destination/system/sequential number) and an editable service
name with description in the General group box
• The SAPRFC.ini file will be updated automatically on the Expert Server PC using the Pro-
gram ID "EHS_EXPERT_TEST" as PROGID and the Service "EHS_EXPERT_TDG_01"
as DEST .
• Accept your entries.
• The Expert Server will then immediately be started on the PC.
Section 6.2.1.3.1.1, “How to configure EHS Expert Server using EHS Service Administration”
You can configure EHS Expert servers as Microsoft Windows services or as console programs.
The advantage that the windows service has over the console program is that it does not
require that a user be logged on in order to execute the service. Thus a service can be started
automatically as a background process when the system is started up.
The first step is the configuration of the file SAPRFC.ini. This step is the same regardless of
whether Expert is to be used as a Windows Service or as a console program. After this step
has been completed then EHS Expert can be configured (as either a Windows Service or as
a console program) and started.
1. From the EH&S Expert installation directory (e.g. C:\Program Files\EHS\Expert), open the
subdirectory BIN and open the SAPRFC.INI file.
2. Add the following lines to the SAPRFC.INI file:
Note
You can use the SAPGUI entry to find the details for GWHOST and GWSERV:
GWHOST contains the SAP router string including the application server. GWSERV
contains the string sapgw and the system number
3. Save these entries.
Requirements
Standard settings
The EHS Expert server as a Windows service consists of the file EHSEXPSV.EXE that is
automatically copied to the corresponding bin directory for Expert installation (for example, c:
\program files\EHS\Expert\bin). The bin directory should also contain the following three files:
• The administration program SVCADMIN.EXE, which can be used to install, configure, and
check services
• The program library WIN32SVC.DLL
• The EHSSTART.EXE file to automatically start and monitor the WWI generation server or
EHS Expert server as a Windows service
Activities
Example:
During the installation, for each service, a key is created with the name
EhsExpertSvc(<name>) under the main key HKEY_LOCAL_MACHINE\SYSTEM\Current-
ControlSet\Services.
Examples:
1 /F /P /E /L=clean.log deletes all files whose creation date is more than a day ago
and log messages are created in the CLEAN.LOG file in the EHS Expert directory.
1 /P deletes all files whose change date is more than a day ago.
5. Configure the application log for Windows NT or Windows 2000.
• Start the Windows event viewer (EVENTVWR.EXE).
• Change the setting for the application log via Log -> Log settings to the option Overwrite
Events as Needed to prevent an overflow in the event viewer.
6. Test the service.
• Start and stop the EHS Expert Server (Test) service using the SVCADMIN.EXE program
from the bin directory of the Expert installation or the Services control in Windows.
• Call the EHS Expert Server (Test) from the SAP System.
• Use the event viewer to check whether the respective commands in the application log file
have been logged and whether the language-dependent texts for the events are displayed
in the detail view.
• Check whether the service was started automatically on system startup by rebooting the
PC and calling the EHS Expert Server (Test) from the SAP System.
7. To remove an installed service, proceed as follows:
• Log on to the PC with administrator rights.
• Start the service administration program SVCADMIN.EXE from the bin directory for the
Expert installation.
• If necessary, close the current service using the Control and configure services function.
INTERNAL:
• RemoveSAP the CUSTOMER
service using the Uninstall 108
services function. © SAP SE
To start the EHS Expert as a console program, you call the program EHSEXPER.EXE with the
parameter -D <Name of destination>.
If you copied the icons to your desktop when you installed the EHS Expert, change the param-
eter -D accordingly to the entry in your file SAPRFC.INI.
Alternatively, you can call the program on your front end using the menu command Start ->
Programs -> EHS Expert. The default parameter -D is here set to EHS_EXPERT. Therefore you
have to change the parameter if you have defined another destination in your file SAPRFC.INI
(EHS_EXPERT_TDG_01 in the example)
For each rule set a user exit has to be created in the SAP system. A user exit can be created
or changed via the customizing settings EHS -> Basic Data and Tools -> Basic Settings –>
Manage User Exits. The type of user exits for EHS Expert rule sets is SUB_SEDACA.
Please find the proposed user exit settings for the Expert rule sets.
In the example at the bottom you can see the typically used entries for secondary data deter-
mination with Expert rule sets and OCC data loads. The required entries for the specific rule
sets are explicitly given in the functional description of the rule set and in the appendix for SAP
EHS Regulatory Content - substance lists and reference data.
Activities
1. In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
2. Create a new user exit with user exit category SUB_SEDACA using
C1E5_SUB_EXPERT_EVALUATE as Function Module (copy the entry of a DEMO-rule set
as template for your new user exit).
The following environment parameters must be set up for the reference modules
C1E5_SUB_EXPERT_EVALUATE:
• EXPERT_COMMIT_MODE
Specifies the backup mode for secondary data determination by the EHS Expert.
If you enter the value I, the SAP system creates the new data records that were determined
by the EHS Expert without changing other data records.
If you enter the value D, the SAP system deletes all the existing data records and creates
the newly determined data. If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is
set, then only those data records are deleted that were determined during previous runs of
the EHS Expert. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the
data provider (parameter EXPERT_WRITE_OWNER) the SAP system recognizes which
data was determined previously by the EHS Expert.
Note
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.
If you enter the value C the SAP system resets the active indicator for the newest of the
data records and deletes all other existing ones. The number of data records to be de-
activated can be derived from the parameter EXPERT_NUM_OF_DEACT_VALUATION.
The data records that were newly determined by the EHS Expert are also created. If the
EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records
are deleted that were determined during previous runs of the EHS Expert. This helps
you prevent data records being deleted inadvertently. The SAP system uses the da-
ta origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter
EXPERT_WRITE_OWNER) to recognize which data was determined previously by the EHS
Expert.
• EXPERT_DESTINATION
Corresponds with the name of the RFC destination that is entered under Tools -> Adminis-
tration -> Administration -> Network -> RFC Destinations (transaction SM59) (for example
EHS_EXPERT).
• EXPERT_READ_RATING and EXPERT_READ_VALIDITY_AREA
Determine the rating and validity area for which the data is transferred from the SAP system
to the EHS Expert.
• EXPERT_WRITE_RATING and EXPERT_WRITE_VALIDITY_AREA
Determine the rating and validity area with which the data determined is stored in the SAP
system. In the EHS Expert set of rules you can also specifically define a different rating and
validity area that are used when storing data in the system.
• EXPERT_READ_USAGE_1...n and EXPERT_WRITE_USAGE_1...n
These parameters can be used in addition to the two previous parameter pairs. You can
specify any number of usages in the format VACLID/RVLID/EXCLFLG (rating/validity/ex-
clude indicator). The parameter numbering has to start with 1 and has to be consecutive.
Examples
EXPERT_READ_USAGE_1:PUBLIC/REG_EU EXPERT_READ_USAGE_2:PUBLIC/DE/X
In this example, the system reads all data records that are valid in the EU but not in Germany.
EXPERT_WRITE_USAGE_1:PUBLIC/REG_EU
EXPERT_WRITE_USAGE_2:PUBLIC/US
In this example, the system writes all data records that are valid both for the EU and for
the USA.
• EXPERT_WRITE_SOURCE_ID
Data origin that must be created in the IMG activity Specify Data Origin.
The following environment parameters can be set up for the reference module
C1E5_SUB_EXPERT_EVALUATE (not all possible parameters are described here):
• EXPERT_COMMIT_FLG
If you set this indicator to X, the system calls the update function specified in the parameter
EXPERT_COMMIT_FUNCTION after the calculation is finished on the Expert server.
If you do not set this indicator, the EHS Expert server directly calls the update function. In
a productive system, we recommend that you set the indicator so that the Expert server is
available again more quickly for other parallel calls. During development and testing it may
be useful to not set the indicator, so that error messages from the update function are logged
in the log files and so you have the option of displaying the runtime of the update function
on the console or in the event display.
• EXPERT_NUM_OF_DEACT_VALUATION
Determines the number of data records that are not deleted for save mode C, but are set
to inactive.
• EXPERT_PARAMETER_CHANGE_MODE
If you enter the value S (default), the SAP system displays the Determine Secondary Da-
ta dialog box in display mode when starting secondary data determination using the EHS
Expert.
If you enter the value E you can revise the environment parameters in the Determine Sec-
ondary Data dialog box when starting secondary data determination using the EHS Expert.
The environment parameters you specified in Customizing are displayed as default values.
If you enter the value H the SAP system does not display the Determine Secondary Data
dialog box when starting secondary data determination using the EHS Expert.
• EXPERT_RES_BY_SRSID_OWNID_FLG
Set this indicator if in backup modes C or D only data is to be deleted by the EHS Expert
that was determined during previous runs of the EHS Expert.
Warning
If you do not set this indicator, data that has also been entered manually or imported
can be deleted in backup mode C or D by the EHS Expert during secondary data
determination.
• EXPERT_WRITE_OWNER
Data provider that you must have created in the SAP component Product Safety under Tools
-> Addresses -> Edit Data Providers. The data provider must always be entered with 10
digits.
If you do not specify a data provider, the SAP system uses the authorization group for the
specification to determine the respective data provider (see IMG activity Specify Authoriza-
tion Groups). If the SAP system does not find any data providers there, it creates the data
without a data provider.
• EXPERT_HIDDEN_PROCESSING_MODE
ONLINE (default): The EHS Expert run starts immediately after you choose Execute.
BACKGROUND: The EHS Expert runs as a background job. The indicator for the parameter
EXPERT_ASK_FOR_STARTTIME must be set for the start time prompt.
• EXPERT_ASK_FOR_STARTTIME
If you set this indicator, you will be prompted in a dialog box when the EHS Expert is to start
as a background job.
• EXPERT_ADD_PARAM_1...n
You can pass any number of parameters to the set of rules. This means you can make sets
of rules configurable. In the set of rules you must create a fact for this purpose that is mapped
to the external ID P:I_TAB_PARAM in fact mapping.
• EXPERT_WRITE_RUN_DATE
With this parameter, the Expert will write the current date with each run of
the given Expert rule: Enter the value X here, and set the further parame-
ters EXPERT_EXPLANATION_ESTCAT, EXPERT_EXPLANATION_RULE_PROP, and
EXPERT_EXPLANATION_DATE_PROP as described below. Please note that this option
requires the implementation of OSS note no. 1450276!
You set up the explanation component (optional) of the EHS Expert using the following pa-
rameters:
• EXPERT_EXPLANATION_DISPLAY
If you set this parameter to X and allow the set of rules to run in the foreground, the system
displays the explanation immediately after the set of rules run. For sets of rules that run in
the background, the system does not display the explanation automatically.
• EXPERT_EXPLANATION_SAVE
Set this parameter to X if you want to save the explanation for the set of rules run in the
specification. If you set the parameter to X, you must also edit the following parameters:
• EXPERT_EXPLANATION_ESTCAT
In this parameter you specify the value assignment type in which the explanation is to be
saved as a user-defined text. The standard version of the demo sets of rules contains the
entry SAP_EHS_0101_002. This value assignment type is not in a property tree because
the explanation is not displayed as a user-defined text but in the menu.
• EXPERT_EXPLANATION_RULE_PROP
In this parameter you specify the characteristic in which the name of the set of rules is
saved to allow its assignment when displayed at a later stage. The characteristic must be in
the same value assignment type as the user-defined text for the explanation. The standard
version of the demo sets of rules contains the entry SAP_EHS_0101_002_RULESET.
Note
If you run a master data match up, the system automatically appends a phrase set
and a check module to the characteristic. You must remove this check module again.
• EXPERT_EXPLANATION_DATE_PROP
In this parameter you specify the characteristic in which the current date is written with each
rule run. The characteristic must be in the same value assignment type as specified in the
parameter EXPERT_EXPLANATION_ESTCAT. The standard version of the demo sets of
rules contains the entry SAP_EHS_0101_002_RUN_DATE. The last run date is only written
when triggered separately with the parameter EXPERT_WRITE_RUN_DATE. Please note
that this option requires the implementation of OSS note no. 1450276!
• EXPERT_EXPLANATION_TEXTCAT
In this parameter you specify the user-defined text type with which the explanation is to be
saved in the specification. The standard version of the demo sets of rules contains the entry
EX.
• EXPERT_ADD_PARAM_1
In this parameter you specify the path and name of the index / header file of your SAP EHS
Regulatory Content database.
• EXPERT_ADD_PARAM_2
In this parameter you can specify a user name to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_ADD_PARAM_3
In this parameter you can specify a password to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_TAB_FIELD_1
This parameter is the specification key from SAP EHS, it should not be changed.
• EXPERT_TAB_FIELD_2
In this parameter you specify the identifier that OCC should use when looking for substance
data. This is usually either the CAS or the UN number.
• EXPERT_TAB_FIELD_3
In this parameter you specify the identifier that OCC should use for display. Choose an
identifier that is available for all substances like synonym name.
• EXPERT_TAB_FIELD_4
In this parameter you can specify a second identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifier specified in
EXPERT_TAB_FIELD_2 does not give a search result. The main purpose is for loading data
that is not assigned to CAS numbers.
• EXPERT_TAB_FIELD_5
In this parameter you can specify a third identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifiers specified in
EXPERT_TAB_FIELD_2 and EXPERT_TAB_FIELD_4 do not give a search result. The main
purpose is for loading data that is not assigned to CAS numbers, e.g. by using PMN numbers.
EXPERT_COMMIT_MODE I
EXPERT_DESTINATION EHS_OCC
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE H
EXPERT_READ_RATING
EXPERT_READ_VALIDITY_AREA
EXPERT_RES_BY_SRSID_OWNID_FLG
EXPERT_RULE_SET CLEO_PS
EXPERT_TAB_FIELD_1 <subid>
EXPERT_TAB_FIELD_2 <identifier>[NUM,CAS]
EXPERT_TAB_FIELD_3 <identifier>[NAM,SYN]
EXPERT_TAB_FIELD_4 <identifier>[NAM,TRIV]
EXPERT_TAB_FIELD_5 <identifier>[NUM,PMN]
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID TECHNIDATA
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
Without this functionality EHS allows the execution of only one rule set at a time. As such, if
it is necessary to apply more than one rule set to a specification, this can be done either by
several manual calls or by using the Expert Multi Rule Call. The Expert Multi Rule Call supports
background and dialog processing.
• After changing the product composition of a preparation the standard composition has to be
recalculated (run the Composition rule set).
• This change of the standard composition may have an impact on all classification data of
the product, so it is necessary to recalculate the EU classification (run the rule set: DAPEC).
• The hazardous ingredients for the EU MSDS have to be determined as well (run the rule
set HazardComp_EU).
Instead of starting three rule sets manually and one at a time, Expert Multi Rule Call would
trigger the execution of the required rule sets in a predefined order.
The Expert Multi Rule Call functionality is available with ERP 6.0 EHP7 or higher. For lower
versions corresponding consulting solution is offered.
Each rule set has its own data origin, which is used when data instances are written to the
EHS database. As such a user is able to tell when a data instance orginates from a rule set.
The user-exits and data origins should have a descriptive comment indicating, at a minimum,
the purpose, rule set name and version. These comments should be created and kept up to
date in all relevant interface languages if possible.
To add new data origins use transaction "spro" for the IMG customizing. Navigate to Environ-
ment, Health & Safety ->Basic Data and Tools -> Tools -> Import ans Export -> Basic Settings
for Import and Export -> Specify Data Origins.
The following entries can be made for sources: Source description, Author, Source note,
Source category, Date of publication, Order number
Enter the sources and assign a specification category to each source. You can assign the
source key as required.
You can create new sources at any time, even in a productive system, from the EHS menu by
choosing Basic Data and Tools -> Tools -> Current Settings -> Specify Sources.
Navigate to Environment Health and Safety -> Basic Data and Tools ->Specification Manage-
ment -> Additional Information for Value Assignment -> Specify Sources.
Please find the proposed settings for the User Defined Text Type.
To add new data origins use transaction "spro" for the IMG customizing. Navigate to Environ-
ment, Health & Safety ->Basic Data and Tools -> Specification Management -> Additional In-
formation for Value Assignment -> Specify User-Defined Text Types.
There are special cases, where one specification can occur under several different identifiers
in the same regulatory list e.g. there are specifications that are entered several times in the
CAS library under different CAS numbers.
A standard EHS system contains several different commonly used regulatory lists.
Activities:
1. Check if you want to use the predefined regulatory lists already available in the EHS system.
2. Delete the entries you do not require and create new ones if appropriate.
3. Assign a specification category to each newly created regulatory list.
Entries for regulatory lists that have already been used for data maintenance in a productive
system may not be deleted.
Regulatory lists can be entered in the Product Safety screen under Tools -> Current settings.
Start transaction "spro" and navigate to: Environment, Health and Safety -> Basic Data and
Tools -> Specification Management -> Specification Master -> Specify Regulatory Lists
The Expert Rule DangGoods determines special provisions (e.g. SP640) which are written
as phrases into the EHS standard property "Dangerous Goods User-Defined Texts". This rule
also derives special notes for small packaging sizes, (e.g. "If package size is more than 30 l,
packaging group II.") which are also outputted to this property.
Please find the proposed settings for the user defined dangerous goods texts.
User-defined dangerous goods texts are regulation-dependant and may be assigned to spe-
cific dangerous goods user-defined text profiles. The dangerous goods user-defined free texts
themselves are phrases, whereas those phrases written by the standard expert rule Dang-
Goods are CED standard phrases delivered with the CED phrase library. If further dangerous
goods user-defined texts are required, additional phrases need to be created.
To specify dangerous goods user-defined text profiles, use transaction SPRO, choose SAP
Reference IMG and navigate through the activities tree to Environment, Health and Safety -
Dangerous Goods Management - Basic Data and Master Data - Common Settings - Specify
Profiles for User-Defined Dangerous Goods Texts:
It is recommend that you enter as few ratings as possible. This minimizes the report generation
variant maintenance activities, as it is required that a rating be assigned to these variants
otherwise data cannot be outputted in the reports.
Activities :
1. Analyze your organizational structure in order to define the authorizations required to access
specification data.
During filling of the dangerous goods master records, the system evaluates the rating of the
respective value assignments using a specific scheme.
Please find the proposed settings for the value assignment rating.
By assigning a rating to a value assignment, you specify who can access the data or on which
documents the data can be printed. Once a rating has been used in a productive system you
cannot delete it.
To add value assignment rating, go into the customizing using transaction SPRO and navigate
to Environment, Health and Safety -> Basic Data and Tools -> Additional Information for Value
Assignment -> Usage ->Specify Ratings.
Then press F5 or "New Entry" and enter the new ratings as well as the description and save
your entries.
SAP EHS Regulatory Rule Sets can be installed by using SAPSetup (new since 2013-1)
Please find the proposed settings for the instances on the Expert Admin Server.
Some rule sets are delivered with an additional files containing the external tables (file with the
extension .mdb) or additional rules in files with extension .ruc
You can copy the files by using EHS Service Administration or by connecting to the Expert
Server PC directly.
In transaction cgsadm choose the Expert Server PC and transfer the files as described in the
following steps
NOTE:
You will get the following screen and you can choose the path Rules for the files to be
transferred.
4. Press save and the files will be copied to the Expert Server PC
Direct copy
Connect to the Expert Server PC and copy all files in the RULES subdirectory of the Expert
installation.
All Expert rule sets have to be registered on the Expert Server PC. You can do this in the SAP
system using EHS Service Administration or directly on the Expert Server PC with the help of
the Expert Admin Tool. Some rule sets uses additional settings, e.g. IgnoreWarnings. These
additional settings could not be set using EHS Service Administration.
In transaction cgsadm go to the Expert Server PC and select the Expert Server. The Expert
Server has to be started and can then be edited
Logon the Expert Server PC and Start the program Expert Admin (via Start --> Programs -->
EHS or by calling the program ExpertAdmin.exe in the bin directory of the Expert installation.
In addition to the files for the rule sets (ruc files and the mapping data base) some rule sets
provide a separate MS-Access data base
The purpose of it is to allow the user to modify the preconfigured data according to the needs
of the customers.
It is recommended to install this data base in the same directory on the Expert server as the
rule files.
If this external data base is installed somewhere else, the linkage between the rule set and the
external data base must be maintained by defining the file path in the mapping tables.
Example: Record-Mapping –Installation of the external data base in the same directory as the
rule set.
Internal_id External_id
EXT_RANGES T:Ranges/HazardComp_US_externvalues.mdb
Example: Record-Mapping – Full declaration of the path for the external data
Internal_id External_id
EXT_RANGES T:Ranges/C:\Program Files\EHS\Expert\Rules
\HazardComp_US_externvalues.mdb
Example: Fact-Mapping –Installation of the external data base in the same directory as the
rule set.
Internal_id External_id
i_limit_oel T:Threshold;OEL/HazardComp_US_externvalues.mdb
Example: Fact-Mapping –Full declaration of the path for the external data
Internal_id External_id
i_limit_oel T:Threshold;OEL/C:\Program Files\EHS\Expert\Rules
\HazardComp_US_externvalues.mdb
A documentation of the adjustable parameters could be obtained from the respective functional
descriptions of the rule sets.
The fact mapping table contains the settings for mapping facts in the set of rules or OCC data
to characteristics or other elements in the EHS data model.
The first three fields together form a unique identifier for the fact in the set of rules.
Example how you can add a CAS number as identifier if you load your substance with a PMN
number:
The record mapping table contains the settings for mapping records in the set of rules or OCC
to value assignment types in EHS.
The first two fields together identify the record uniquely in the set of rules.
The composition mapping table contains the regulations for mapping compositions in the set
of rules to value assignment types of the category composition in EHS.
The phrase mapping table contains the regulations for mapping phrase codes used in the set
of rules or OCC XML files to phrase keys in EHS.
Note
Phrase mapping allows an assignment to be made between an internal and an external
value for any fact value. The phrase does not have to be an EHS phrase. The corre-
sponding conversion takes place if the IsPhrase indicator is set in fact mapping.
Expert generates a warning message if the rule set or OCC reads phrases which are
not contained in the Mapping table.
The phrase mapping table has to be enhanced if a customer uses additional customer specific
phrases.
To suppress the warning message these phrases have to be added manually to the phrase
mapping table.
Tip
We recommend to insert these phrases using the following pattern:
To consider these enhancements for updates of the standard mapping you should label
these manual settings in the database e.g. in the Version column.
The first part of the phrase key (column: External_Id) always signifies the active phrase cata-
logue in EHS.
If the active phrase catalogue in the EHS system is named differently then the mapping has
to be changed (using the replace function in MS Access).
The EHS Expert is able to write the current date when running an Expert rule, to allow looking
up when a rule was called for the last time on a given substance. For that purpose, the property
"EHS Expert Explanations" was extended by another characteristic "Last Run Date" allowing
to store a date.
To activate writing the last run date, the following user-exit parameters have to be set:
• SDS_1810_APJ_MAIN
• SDS_1810_APJ_MAIN_MY
• SDS_1810_EU_MAIN
• SDS_1810_EU_EXT_MAIN
• SDS_1810_EMEA_MAIN
• SDS_1810_CIS_MAIN
• SDS_1810_GHS_MAIN
• SDS_1810_NA_MAIN
• SDS_1810_LA_MAIN
• SDS_1810_NA_GHS_MAIN
• SDS_1810_RTL_MAIN
• SDS_1810_EMEA_RTL_MAIN
• SDS_1810_EUEXT_RTL_MAIN
In this section general information is provided for installing SDS templates, region-specific and
further information can be found in the appendix.
7.1.1. Prerequisites
This chapter describes the prerequisites which are necessary to use Report Templates.
The safety data sheet (SDS) templates require additional customizing activities, especially
creating identification listings and generation variants.
Please also note that there can be additional customizing neccessary to do resulting from SAP
notes; this might depend on the question if the customer wants to use certain functionality or
not. Please also see the relevant SAP notes. For example for the Trade Secret function, please
add identifiers NAM ZTRADESEC and NAM ZTRADESEC2 and maintain them as desired.
These customizing entries are described in the respective report templates' area in this
documentation's appendix.
The User defined text type KRA has to get assigned to the Specification categorie SUB-
STANCE to be able to maintain it on a REAL_SUB Level.
Within safety data sheets several graphics are needed, such as the GHS pictograms or UN
model regulation labels. Graphic files are used in connection with phrases or methods that are
resolving customizing entries. In order to be able to display these graphics using the SDS WWI
templates the graphic files that are delivered with the ERC package need to be copied to the
WWI installation sub-folder GRAPHICS of all WWI server(s) and relevant local WWI front ends.
The graphic files should be located directly in the GRAPHICS folder without any sub-folders.
It is recommended to perform these steps before implementing the safety data sheet (SDS)
templates.
The implementation of following SAP Notes are necessary in connection with the WWI SDS
templates.
The include functionality and the conditional output are available for systems of EH&S 2004
in ERP 2004 or higher.
Each template also comes with a specification document (formerly known as DataMapping)
that gives detailed overview on the properties and characteristics printed on the SDS.
7.2. Implementation
The following steps describe how to implement safety data sheet (SDS) templates.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
6. Check the import by displaying the transport log.
In the following, the steps listed above are described in more detail:
The files which need to be imported depend on the property tree package and are listed
in the Appendix.
4.a. In order to find a transport request more easily in the import queue, a filter can be set.
Choose a column, "Request" for example, by clicking on the column title.
Then choose the pushbutton "Filters (Ctrl + F10)" or press "Ctrl + F10".
Enter the filter criterion in the following window, "SH2*" or "EEI*" for example.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
5.a. Start the import with the pushbutton "Import Request (Ctrl+F11) or press Ctrl+F11.
5.b. Fill in the "Target Client" in the next window.
5.c. On the tab page "Date", set the start date to "Immediate".
5.d. On the tab page "Options", select the option "Leave Transport Request in Queue for
Later Import" .
5.e. On the tab page "Options", select the option "Ignore Invalid Component Version" when
transports which were generated on an ERP 6.0 system are imported in a system with
a lower release (ERP 5.0 = ERP 2004 for example).
5.f. Choose the pushbutton "Continue" to start the import. The status of the transport re-
quest will change first to "Import running" and then to "Request is ready for import
again".
Use "Legend: Import Queue" to obtain more details about the status symbols.
6. Check the import by displaying the transport log.
6.a. After the import is completed, open the transport log for the imported transport request
using the push button "Logs (Ctrl+F4)" or press Ctrl+F4.
6.b. The transport log will be displayed. You may open additional sections by pressing the
"+" pushbutton.
6.c. In general, the status of the import will be "(0) Successfully Completed".
6.d. The status may be "(4) Ended with warning" when transports which were generated
on an ERP 6.0 system are imported in a system with a lower release (ERP 5.0 = ERP
2004 for example). Such warnings because of "different nametabs" can be ignored.
The property tree objects are imported correctly despite the warning.
Go to: Environment, Health and Safety - Basic Data and Tools - Specification Management -
Specification Master - Check Identification Listings
Add the required Identification Listings via "New Entry" including a header, add the required
identifiers to the definition and save.
Ask your administrator for the upload path on your application server. You may check for the
path also via transaction AL11.
For example :
Use transaction CG3Z for uploading and choose BIN(ary) transfer format as shown in the
screen shot below.
Size of path and filename is limited. It may be necessary to either shorten the import file names
or choose a short directory path to upload the files.
Please check that you upload the correct files for the operating system of your application
server. You may also have to consider if Unicode or Non Unicode system. For non-unicode
files, the update delivery includes import files formatted for MS Windows and UNIX. You can
get info about the OS in R/3 at -> System -> Status. Under the "Host data" header you can
see the operating system used by the R/3 server.
The upload of import files onto the application server and the import into EHS are completely
independent from any language specific settings on the front-end PC, i.e. phrases can be
uploaded and imported with every regional default setting.
You use this function to import report templates (or cover sheet templates and acknowledge-
ment of receipt templates) to the SAP System.
In conjunction with report template export, you can exchange report templates between differ-
ent SAP Systems.
If a UNIX system is used, choose the corresponding import settings to import a windows file.
Then import the dat-file using transaction CG34 "Import Report Templates" or go to Logistics -
> Environment, Health and Safety -> Basic Data and Tools -> Tools -> Data Transfer -> Import
Report Template
• File with path: <path on application server and file with ending .dat>
(Note that each dat-file contains the information to automatically pull the corresponding doc-
file. The doc-file itself should NOT be specified for the import.)
• Character standard: UFT-8
Choose function "Check file". The SAP System checks if the data can be transferred correctly
from the transfer file and matches up the symbols.
Check Symbol Matchup to make sure all symbols are available on system in the correct way.
All entries in the system column must have symbol names. If they do not, check if symbol
generation was carried out on your system.
WWI will automatically open the new template document. Check the template by clicking on
the check-button and save it. If you encounter error messages at this stage, you can directly
take the relevant actions(i.e. set up missing ID-listings, etc.), or you may save the template
anyway and resolve the messages later.
The generation variant makes it possible for only permitted specification data to be output on
a report because it links the report template with a leading validity area and one or more value
assignment ratings.
Or you go to Logistics -> Environment, Health and Safety -> Basic Data and Tools -> Report
Definition -> Edit Generation Variants
In the generation variant the main validity area is defined under "Validity Area"; the area from
which the template will draw its data.
The option "Usage check" is utilized to control the way in which the usages are compared.
There are four options to select: 0, 1, 2 and 3.
If you do not specify a value, the SAP System uses the value 0 as default.
Value 0: The usage is appropriate if - with the same rating used - the generation variant validity
area that is expanded to its countries and regions is the same as or is a subset of the expanded
validity area of the usage with which it is to be compared.
Example: Generation variant: DE Value assignment usage: REG_EU If a safety data sheet is
created for Germany, value assignment instances are also taken into account that are valid
for the validity area REG_EU.
Please see the SAP Help function for all the details on the option.
These validity areas or languages must be addressed directly by the WWI coding in the
template (G-Repeating-Group) to be effective. By the use of these Rating/Validity options, it
is for example possible to give out special phrases in English on a template in Chinese or
Spanish.
A complete overview on the parameters of all generation variants can be found in the document
RGV_XXXX_Configuration.pdf (where XXXX stands for the current release).
1. Find out the directory name and path of the import queue for the SAP Transport Manage-
ment System.
2. Load the transport files into the import directory using the transaction CG3Z.
3. Attach the transport request to the import queue
1. Find out the directory name and path of the import queue for the SAP Transport Manage-
ment System.
1.1. You may ask your SAP system manager or proceed as follows:
1.2. Run transaction AL11.
1.3. The first part of the directory path is listed after the entry DIR_TRANS, for example
"F:\usr\sap\trans".
1.4. Within this directory two sub-directories exist:
• The sub-directory "cofiles" where the co-files are stored.
• The sub-directory "data" where the data files are stored.
5. Load the transport files into the import directory using the transaction CG3Z.
Please note that the listed "Owner" is the SAP user who created the transport request not the
login-user who started the upload process!
Ask your administrator for the upload path on your application server. You may check for the
path also via transaction AL11.
For example :
Use transaction CG3Z for uploading and choose BIN(ary) transfer format as shown in the
screen shot below.
Size of path and filename is limited. It may be necessary to either shorten the import file names
or choose a short directory path to upload the files.
Please check that you upload the correct files for the operating system of your application
server. You may also have to consider if Unicode or Non Unicode system. For non-unicode
files, the update delivery includes import files formatted for MS Windows and UNIX. You can
get info about the OS in R/3 at -> System -> Status. Under the "Host data" header you can
see the operating system used by the R/3 server.
The upload of import files onto the application server and the import into EHS are completely
independent from any language specific settings on the front-end PC, i.e. phrases can be
uploaded and imported with every regional default setting.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
6. Check the import by displaying the transport log.
In the following, the steps listed above are described in more detail:
The files which need to be imported depend on the property tree package and are listed
in the Appendix.
4.a. In order to find a transport request more easily in the import queue, a filter can be set.
Choose a column, "Request" for example, by clicking on the column title.
Then choose the pushbutton "Filters (Ctrl + F10)" or press "Ctrl + F10".
Enter the filter criterion in the following window, "SH2*" or "EEI*" for example.
Please note that property tree transport requests are client dependent and shall be available
after the import only in the selected client.
5.a. Start the import with the pushbutton "Import Request (Ctrl+F11) or press Ctrl+F11.
5.b. Fill in the "Target Client" in the next window.
5.c. On the tab page "Date", set the start date to "Immediate".
5.d. On the tab page "Options", select the option "Leave Transport Request in Queue for
Later Import" .
5.e. On the tab page "Options", select the option "Ignore Invalid Component Version" when
transports which were generated on an ERP 6.0 system are imported in a system with
a lower release (ERP 5.0 = ERP 2004 for example).
5.f. Choose the pushbutton "Continue" to start the import. The status of the transport re-
quest will change first to "Import running" and then to "Request is ready for import
again".
Use "Legend: Import Queue" to obtain more details about the status symbols.
Activation
• Choose Tools - Customizing - Business Configuration Sets - Activation in the SAP menu, or
enter the transaction code SCPR20 in the command field.
• Enter the name of the BC Set which you want to activate.
• Choose Bus.Conf.Set - Activate or the Activate pushbutton.
• Enter the transport request number when asked for a Customizing transport request and
choose Continue.
• A warning that original tables are overwritten by activation of BC Sets appears. Choose one
of the following three options
• To proceed with the activation, choose Activation.
• If several BC Sets are being activated, only those which have not yet sent an error message
are activated.
Simulation
• To simulate activation, choose Simulation.
Simulation tests part of the activation procedure and creates an activation log. The log tells
the user whether the simulated activation reached a certain point. A successful simulation
does not guarantee the success of a subsequent activation. The errors in a simulation would
occur during activation.
Key conflicts occur if there are two data records in a hierarchical BC Set with the same key
but different values. In this case it is not clear which of the values is to be put in the original
tables. The activation is cancelled if key conflicts occur.
Result
The result of activation or simulation can be:
• Activation successful
INTERNAL: SAP CUSTOMER 141 © SAP SE
How To ...
Activation log displayed automatically, data are not, or only partially, written.
• You can display all entries with the Display All pushbutton, or the differences only with the
Only Display Differences pushbutton.
In this example, the BC Set values (in the 1st row) and the values in the table named at the
right (in the 2nd row) are identical.
1.c. Choose transaction CG1B "Edit phrase sets" and create manually phrase sets for all
characteristics which are described in the file "Changes....pdf" as "new, CHAR 30,
multiple phrases" or “new, CHAR 30, single phrase”. Enter the characteristic key as
the new phrase set key. Enter the English characteristic description as the phrase set
name in English. Save.
It is recommended to add a German phrase set name as well when you work also
work with a German user interface.
2. During an initial setup: Run customizing activity "Generate Standard Phrase Sets"
2.a. Ensure that no one is working with the affected property tree or is using the affected
properties and characteristics in the EH&S specification workbench.
2.b. If an EH&S system is set up initially the customizing activity "Generate Standard
Phrase Sets" is used in general to create and allocate phrase sets to all characteris-
tics of type CHAR 30. Please note that with ERP 6.0 EHP7 and higher EHPs, this
customizing activity was extended by a list of characteristics which shall be excluded
from phrase set assignment. This list is delivered with the SAP standard deliver and
ensure that CHAR 30 which are not meant to be assigned to phrase sets are excluded
from the generation and assignment of standard phrase sets.
2.c. Navigate to the activity "Generate Standard Phrase Sets" in the SAP customizing
(IMDG) (path within EH&S 3.2 and higher releases: Environment, Health & Safety ->
Basic Data and Tools -> Specification Management -> Specification Data Base Struc-
ture -> Settings for Value Assignment -> Generate Standard Phrase Sets). A complete
overview about this activity is given in the corresponding IMDG activity documentation.
2.d. Start the activity.
2.e. Phrase sets are generated and allocated to all characteristics of type CHAR 30. With
ERP 6.0 EHP7 and higher EPs phrase sets are not generated and allocated to char-
acteristics which are on the exclusion list. Phrases are not allocated to the new phrase
sets. Assignments of phrase sets to characteristics that already exist are not overwrit-
ten by the system.
2.f. Some characteristics defined as CHAR 30 are not meant to be assigned to phrase
sets, for example "Value in Non-Standard Unit". These characteristics shall be used to
store a numerical value and a unit but were unfortunately defined as a free text fields
of CHAR 30. In this case, the assigned phrase set has to be deleted in the table "Edit
phrase set-attribute assignment" (transaction CGAB) after the standard phrase sets
have been created.
If the explanation component shall be used and the phrase sets were generated
by the automatic customizing functionality "Create Standard Phrase Sets", it is neces-
sary to remove the phrase set assignment manually at least from the characteristic
SAP_EHS_0101_002_RULESET. Otherwise the explanation cannot be stored in the
specification database for later use.
2.g. Run transaction CGCZ "Match up master data" with flag "Activate Phras-
ing of Characteristics" only. This function assigns the function module
INTERNAL: SAP CUSTOMER 144 © SAP SE
How To ...
Additional information:
In a standard R/3 System automatically created symbols using the transaction CGCZ are gen-
erated with descriptions which are copies of the characteristics descriptions in the logon lan-
guage. The flag "Regenerate Symbol Descriptions" within transaction CGCZ can be used to
generate the symbol descriptions in another language different from the logon language. En-
glish or German are possible symbol descriptions languages when property tree packages are
installed where the characteristics descriptions are delivered in English and German.
If the transaction CGCZ is run with the flag "Match Up Symbols-Phrase-Enabled Characteris-
tics" the symbol definitions for the characteristic symbols that have been changed from phrase-
related to non-phrase-related (or vice versa) will be updated..
1.1. Navigate to the activity "Set Up Table-Based Value Assignment" in the SAP customiz-
ing (IMG) (path: Environment, Health & Safety -> Basic Data and Tools -> Specification
Management -> Specification Data Base Structure -> Settings for Value Assignment
-> Set Up Table-Based Value Assignment). A complete overview about this activity is
given in the corresponding IMG activity documentation.
1.2. Start the activity. The following screen appears:
1.3. Choose the entry "Create Entries for the Value Assignments". The window "Filling
Customizing Table for Table-based Value Assignment" appears:
1.4. Enter a property key of a new property or a series of property keys in the field "Value
assgmt type" and start the process (pushbutton "Execute"). A general example for a
property key is SAP_EHS_1023_043 (for property "GHS Classification (List Data").
Select the property keys of the new properties within a specific property tree package
from the file "Changes_.....pdf". The file name for a specific property tree package can
be found in the Appendix.
Please avoid to execute this process with the same property key multiple times be-
cause this would create multiple entries in the customizing table!
1.5. Return to the previous window (push button "Back"):
1.6. Choose the entry "Set Up Table-Based Value Assignment". The complete customizing
table opens. Check all entries for the configured property/properties:
1.7. Return to the previous window (push button "Back"):
1.8. Repeat the steps 1.2 to 1.7 to create the necessary entries for all new properties.
2. Set up Table-based Value Assignment for existing properties with new characteristics
You have to change the configuration of existing properties where new characteristics were
added and which were already configured for the Table-Based Value Assignment. The rec-
ommended procedure is to delete all entries for existing properties with new characteristics
in the customizing table and to create the entries for these properties anew (see the follow-
ing steps 2.1 to 2.14).
If the configuration of the Table-Based Value Assignment for properties with new character-
istics was already changed, then these changes should be documented before deleting the
entries. In this case, an alternative could be not to delete all entries for a changed property
but to update the Table-Based Value Assignment for the existing property only (follow steps
1.1 to 1.8). Then, the new characteristics would be appended to the already existing entries
for this property. The correct order of the characteristics would have to be set up manually.
Please note, that the Table-based Value Assignment customizing table can only be changed
in SAP systems where the direct customizing is enabled. If the direct customizing is disabled
(for example in a production system), then the Table-based Value Assignment should be set
up in a system where the direct customizing is enabled (for example a development system).
The correct entries can be then transported to the system with the disabled customizing
(customizing transport request).
2.1. Navigate to the activity "Set Up Table-Based Value Assignment" in the SAP customiz-
ing (IMG) (path: Environment, Health & Safety -> Basic Data and Tools -> Specification
Management -> Specification Data Base Structure -> Settings for Value Assignment
-> Set Up Table-Based Value Assignment). A complete overview about this activity is
given in the corresponding IMG activity documentation.
2.2. Start the activity. The following screen appears:
2.3. Choose the entry "Set Up Table-Based Value Assignment". The complete customizing
table opens.
2.4. Choose the push button "Position", enter a property key of an existing property with
new characteristics and navigate to this property. Select the property key from the file
"Changes_.....pdf". The specific file name for a certain property tree package can be
found in the Appendix.
2.5. Select all entries for this property.
2.6. Delete the selected entries (push button "Delete").
2.7. Return to the previous window:
2.8. Choose the entry "Create Entries for the Value Assignments". The window "Filling
Customizing Table for Table-based Value Assignment" appears:
2.9. Enter the property key of the property, which entries you deleted in the previous step,
in the field "Value assgmt type":
2.10. Start the process (pushbutton "Execute").
2.11. Return to the previous window:
2.12. Choose the entry "Set Up Table-Based Value Assignment" again. The customizing
table opens. Check all entries for the configured property:
2.13. Return to the previous window (push button "Back"):
2.14. Repeat the steps 2.2 to 2.13 to create the necessary entries for all existing properties
with new characteristics.
1. Check copy/inheritance templates and assign one of the new properties to an existing tem-
plate, if necessary.
2. It is recommended to proceed as follows:
2.a. Navigate to the substance workbench or run transaction CG02.
2.b. Select "Find Substance" (double-click) on the initial screen. It is not necessary to start
a search and create a hit list.
2.c. Make sure that you are working in the "Edit" mode and not the "Display" mode. You
may change from "Display" to "Edit" mode using the pushbutton "Display <-> Edit (Ctrl
+F1)".
2.d. Navigate in the menu to "Specification" -> "Inheritance" -> "Edit Templates".
2.e. A selection screen opens where you select the template you want to edit. Choose the
pushbutton "Inheritance Templates Detail View". A detail window opens.
2.f. Choose the option "Value assignment type selection" where you can add new proper-
ties to the copy/inheritance template.
2.g. Select a new property. Choose the pushbutton "Transfer (Enter)".
2.h. A new window opens. Choose one of the pushbuttons "Replace" or "Supplement".
2.i. Choose the pushbutton "Transfer (F8)" on the next screen.
2.j. Complete this process by choosing the pushbutton "Save (Ctrl+S)" on the following
selection screen.
2.k. Choose the pushbutton "Transfer (Enter)" to return to the hit list.
You can use all libraries available on the market that support the conversion formats of
the SAP component Environment, Health and Safety (EHS).
The internal number range is assigned by the system itself while the automatic key definition
whereas the external number range must contain all phrase keys which are not produced
automatically but entered manually or by phrase import.
EH&S 2.5B and newer: Implementation Guide for R/3 Customizing (IMG) / Environment, Health
& Safety / Product Safety / Phrase Management / Specify Number Ranges for Phrases
EH&S 3.2 and newer: Implementation Guide for R/3 Customizing (IMG) / Environment, Health
& Safety / Basic Data and Tools / Phrase Management / Specify Number Ranges for Phrases
To import the CED phrases the external number range 0E must have the alphanumeric interval
from A to ZZZZZZZZZZZZZZZ.
We recommend to designate the internal number range 0I for numeric values only (interval
100000000000000 to 899999999999999).
ERC supports both models. During the ERC implementation decisions are required based on
the language keys that have been defined in the system, in which ERC shall be implemented.
Major difference is that in previous systems (here references as R/3 systems) the use of so-
called corresponding languages Z8 and Z9 has been supported. This is not supported in SAP
S/4HANA systems, so that only the SAP standard language keys are available. Please note
that the language keys for EN and PT have different meanings in both concepts.
PT European Portuguese
Z9 Brazil Portuguese
After decision for a model has been made, please take care about the following:
Please make sure, that the correct phrase import file from delivery folder 02-Phrases is used.
In both cases the source language is EN
Location for phrase files supporting language key SAP S/4HANA (only ERC3.0 contracts):
\\dwdf212\reg_content\CLEO\ERC_####\11-Deliveries\02-Phrases\03-CED_S4_####. In
Release 1805 there is only a initial version, later releases include also update files.
Please note: the phrase files provided with the regulatory data (library TDCLE) is not deliv-
ered with variants. These files contain all relevant languages in one import file. Thus, the im-
port files from folders \03-ContentData\ProductSafety\3-Phrases and \03-ContentData\Dan-
gerousGoods\EHS\2-Phrases can be used for both models.
• Expert rule sets are independent of the settings above.
• WWI templates are independent of the settings above.
• Report languages for safety data sheets need to be configured according to the settings
above. E.g. if the language keys according to R/3 are applied, then for the US SDS select
the report language Z8. Select EN, if the language keys according to an SAP S/4HANA
system are applied.
Please note: in both models maintain the settings for generation variants in tab Rat-
ing/Validity area under listing Validity Areas as EN as documented in the document
RGV_####_Configuration.pdf (supplied with each release, #### represents release num-
ber).
• "File with path" - Enter the path and file name (same as target file section upload files )
• For all files choose UTF-8 as character standard.
• You can leave all other options blank
• Optional: You can limit the import to certain languages if you want (Button "Language se-
lection" )
• Check the file (F5)
• Carefully check the displayed information before importing the phrases. Make sure you im-
port to the passive CED or TDCLE library, the versions are correct and no errors are dis-
played.
• If necessary approve the message "Date of phr. lib. to be imported is identical to date of
current library", this is just for your information.
• However if the file you want to import is older than the library in your system, you can not
import it. Please make sure you have chosen the correct import file. In section upload files
you can also find information on how to change the header data of your import files.
• Choose "Transfer/start time" (F6)
• Choose "Immediate" or specify a time
• Save
Note
Phrase import files for CED and TDCLE libraries include all phrases of the library,
not only those that are new or updated. Please be aware that all manual changes
made in your CED or TDCLE phrases will be overwritten.
Caution
Please do not set the flag for full import as this will delete your
passive library!
If you are updating your phrase library, we recommend to restrict the phrase selection to
only new and revised phrases. Please use the Phrase created/changed... functionality with
the settings shown in the screenshot:
Note
It is not recommended to press the "Determine target phrase" - button as this may
select phrases as target phrases that are not appropriate or may not have e.g. all
language translations.
Note
The merging process normally does not perform well when processing several thou-
sand phrases at one time. Therefore, we strongly recommend that only a part of the
phrase library is merged at one time (e.g. filtered by phrase groups or phrase keys).
• "File with path" - Enter the path and file name (same as target file section upload files )
• Check the "Phrase Set Assignmt" option as shown in the screenshot below
Sometimes none or only a few assignments are imported. If you encounter this error, the first
step would be to run this import several times until no more phrases are assigned to phrase
sets. If this does not help an easy work-around is to change the name of the phrase library in
the import file to the name of your active library. Upload and import this modified file. In section
upload files you can also find information on how to change the header data of your import files.
As the phrase set assignment files are based on the latest SAP EHS standard property tree
there will be warnings in the logfile of the import if your system is not updated with the latest
standard property tree. These warnings can usually be ignored. Customers with valid mainte-
nance contracts for SAP EHS Regulatory Content - expert rules for substance and mixture
classification or - substance lists and reference data receive the latest tree as part of their reg-
ular maintenance. Should you need any additional info on this topic please feel free to contact
us.
All phrases in column A will no longer be maintained and should be combined with the phrases
listed in column D .
Combining a phrase adds all phrase set assignments from the no longer used phrase (replaced
phrase) to the phrase that's still in use (combined phrase). Additionally all substance value
assignments will be checked and the no longer used phrase key will be replaced by the com-
bined phrase key.
Please see also the SAP EHS documentation for further information on combining phrases.
(example on next page)
Important Notes:
• When combining phrases, the phrase positions will not be changed, e.g. missing translations
in one phrase will not be filled with the existing translation of the other phrase nor will changes
to the phrase text or code be made.
• If a phrase is used directly on a report template, the symbol for this phrase has to be replaced
manually with the phrase key of the combined phrase. Use the "where-used list" functionality
to check if a phrase is used on a report template.
• If a phrase is used, execute the combine as a background job as it might take some time to
update all value assignments with the new phrase key.
• Please note that combining phrases may have an influence on e.g. Expert rule sets or data
loads. It may become necessary to change mapping tables accordingly.
• For combining phrases when using ALE distribution please take notice of SAP NOTE 727174
Example:
The marked phrase N15.00208960 will still be in use after combining, N02.00900510 will be
combined (replaced) and is no longer available after combining.
Please review the retired phrases list and inform us if there are phrases that you still need.
After that, please delete any phrases that you no longer need from your active phrase library:
Phrases deleted from the SAP system are stored in the backup phrase library unless an active
phrase that originated in a passive phrase library is deleted.
To do so, create a hit list with the original phrase, mark the phrase and create a copy
(Phrase_CopyTemplate). Then choose a new phrase key starting with P (for permutation) and
safe the new phrase.
Replace the ? in each language of the new P phrase with the chosen number or customer
specific information, in this case 10, and safe again.
Please do not alter the original CED phrase as your changes might be overwritten in one of
the following updates.
It is also possible to replace the qualifier .? automatically by using special user exits at the
phrase. Please see SAP Note 1373615 for more information.
In addition there is a standard functionality for special qualifiers available, that may insert phras-
es like target organs into another phrase.
Example:
Please see SAP Note 1146663 Placeholder phrases for EH&S reports for details on how to
implement the placeholder functionality and how to use it in phrases and WWI templates.
Note
For installation local administrator rights might be required. Registry settings will be
added under the following paths:
To set up a RFC destination choose from the SAP Easy Access screen Tools --> Administration
--> Network --> RFC Destination (transaction sm59). The Display and Maintain RFC Destina-
tion screen appears. Then setup the RFC connection for the EHS Service Administration, the
EHS Expert and OCC as follows:
4. In the Registered Server Program screen area, enter the PROGID entry from your installa-
tion (see How to install EHS Expert or entry in the file SAPRFC.ini) in the program ID field.
5. Save your entries
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit of the EHS Expert (see Extend Entry in Secondary Data Determination). We
recommend to use the same name for your systems in order to transport customizing
settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination.
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Reg-
istered Server Program.
4. In the Registered Server Program screen area, enter a unique identification in the Program
ID field. The program ID corresponds to the PROGID in the SAPRFC.ini.
5. If the SAP system comprises a number of application servers, you must specify under Gate-
way Options the gateway of the application server under which the EHS Expert server has
registered itself. Enter the values for the parameters GWHOST and GWSERV from the
SAPRFC.INI file of the EHS Expert server for the input fields Gateway host and Gateway
service.
6. Save your entries
INTERNAL: SAP CUSTOMER 164 © SAP SE
How To ...
This entry corresponds to the entry for the EXPERT_DESTINATION parameter for the
user exit(s) of SAP EHS Regulatory Content - substance lists and reference data (see
Extend Entry in Secondary Data Determination). We recommend to use the same name
for your systems in order to transport customizing settings easily.
• Connection type: T
• Description: Enter a text to describe the RFC destination: EHS Open Content Connector
2. Confirm your entries.
3. On the Technical Settings tab page in the Activation Type screen area, set the flag to Start
on Frontend Work Station.
4. In the Start on Frontend Work Station Program screen area, enter $shell\ehsOCC.exe
• In the SAP Easy Access screen, choose Tools -> Administration -> Administration -> Network
-> RFC Destinations (transaction SM59).
• In the RFC Destinations tree, choose TCP/IP connections -> <name of your RFC destina-
tion> and open the destination with a double-click.
• Choose Test connection.
The test is running successfully if transmission duration times are displayed in the SAP window.
Activities
1. In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
2. Create a new user exit with user exit category SUB_SEDACA using
C1E5_SUB_EXPERT_EVALUATE as Function Module (copy the entry of a DEMO-rule set
as template for your new user exit).
The following environment parameters must be set up for the reference modules
C1E5_SUB_EXPERT_EVALUATE:
• EXPERT_COMMIT_MODE
Specifies the backup mode for secondary data determination by the EHS Expert.
If you enter the value I, the SAP system creates the new data records that were determined
by the EHS Expert without changing other data records.
If you enter the value D, the SAP system deletes all the existing data records and creates
the newly determined data. If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is
set, then only those data records are deleted that were determined during previous runs of
the EHS Expert. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the
data provider (parameter EXPERT_WRITE_OWNER) the SAP system recognizes which
data was determined previously by the EHS Expert.
Note
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.
If you enter the value C the SAP system resets the active indicator for the newest of the
data records and deletes all other existing ones. The number of data records to be de-
activated can be derived from the parameter EXPERT_NUM_OF_DEACT_VALUATION.
The data records that were newly determined by the EHS Expert are also created. If the
EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records
are deleted that were determined during previous runs of the EHS Expert. This helps
you prevent data records being deleted inadvertently. The SAP system uses the da-
ta origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter
EXPERT_WRITE_OWNER) to recognize which data was determined previously by the EHS
Expert.
• EXPERT_DESTINATION
Corresponds with the name of the RFC destination that is entered under Tools -> Adminis-
tration -> Administration -> Network -> RFC Destinations (transaction SM59) (for example
EHS_EXPERT).
• EXPERT_READ_RATING and EXPERT_READ_VALIDITY_AREA
Determine the rating and validity area for which the data is transferred from the SAP system
to the EHS Expert.
• EXPERT_WRITE_RATING and EXPERT_WRITE_VALIDITY_AREA
Determine the rating and validity area with which the data determined is stored in the SAP
system. In the EHS Expert set of rules you can also specifically define a different rating and
validity area that are used when storing data in the system.
• EXPERT_READ_USAGE_1...n and EXPERT_WRITE_USAGE_1...n
These parameters can be used in addition to the two previous parameter pairs. You can
specify any number of usages in the format VACLID/RVLID/EXCLFLG (rating/validity/ex-
clude indicator). The parameter numbering has to start with 1 and has to be consecutive.
Examples
EXPERT_READ_USAGE_1:PUBLIC/REG_EU EXPERT_READ_USAGE_2:PUBLIC/DE/X
In this example, the system reads all data records that are valid in the EU but not in Germany.
EXPERT_WRITE_USAGE_1:PUBLIC/REG_EU
EXPERT_WRITE_USAGE_2:PUBLIC/US
In this example, the system writes all data records that are valid both for the EU and for
the USA.
• EXPERT_WRITE_SOURCE_ID
Data origin that must be created in the IMG activity Specify Data Origin.
The following environment parameters can be set up for the reference module
C1E5_SUB_EXPERT_EVALUATE (not all possible parameters are described here):
• EXPERT_COMMIT_FLG
If you set this indicator to X, the system calls the update function specified in the parameter
EXPERT_COMMIT_FUNCTION after the calculation is finished on the Expert server.
If you do not set this indicator, the EHS Expert server directly calls the update function. In
a productive system, we recommend that you set the indicator so that the Expert server is
available again more quickly for other parallel calls. During development and testing it may
be useful to not set the indicator, so that error messages from the update function are logged
in the log files and so you have the option of displaying the runtime of the update function
on the console or in the event display.
• EXPERT_NUM_OF_DEACT_VALUATION
Determines the number of data records that are not deleted for save mode C, but are set
to inactive.
• EXPERT_PARAMETER_CHANGE_MODE
If you enter the value S (default), the SAP system displays the Determine Secondary Da-
ta dialog box in display mode when starting secondary data determination using the EHS
Expert.
If you enter the value E you can revise the environment parameters in the Determine Sec-
ondary Data dialog box when starting secondary data determination using the EHS Expert.
The environment parameters you specified in Customizing are displayed as default values.
If you enter the value H the SAP system does not display the Determine Secondary Data
dialog box when starting secondary data determination using the EHS Expert.
• EXPERT_RES_BY_SRSID_OWNID_FLG
Set this indicator if in backup modes C or D only data is to be deleted by the EHS Expert
that was determined during previous runs of the EHS Expert.
Warning
If you do not set this indicator, data that has also been entered manually or imported
can be deleted in backup mode C or D by the EHS Expert during secondary data
determination.
• EXPERT_WRITE_OWNER
Data provider that you must have created in the SAP component Product Safety under Tools
-> Addresses -> Edit Data Providers. The data provider must always be entered with 10
digits.
If you do not specify a data provider, the SAP system uses the authorization group for the
specification to determine the respective data provider (see IMG activity Specify Authoriza-
tion Groups). If the SAP system does not find any data providers there, it creates the data
without a data provider.
• EXPERT_HIDDEN_PROCESSING_MODE
ONLINE (default): The EHS Expert run starts immediately after you choose Execute.
BACKGROUND: The EHS Expert runs as a background job. The indicator for the parameter
EXPERT_ASK_FOR_STARTTIME must be set for the start time prompt.
• EXPERT_ASK_FOR_STARTTIME
If you set this indicator, you will be prompted in a dialog box when the EHS Expert is to start
as a background job.
• EXPERT_ADD_PARAM_1...n
You can pass any number of parameters to the set of rules. This means you can make sets
of rules configurable. In the set of rules you must create a fact for this purpose that is mapped
to the external ID P:I_TAB_PARAM in fact mapping.
• EXPERT_WRITE_RUN_DATE
With this parameter, the Expert will write the current date with each run of
the given Expert rule: Enter the value X here, and set the further parame-
ters EXPERT_EXPLANATION_ESTCAT, EXPERT_EXPLANATION_RULE_PROP, and
EXPERT_EXPLANATION_DATE_PROP as described below. Please note that this option
requires the implementation of OSS note no. 1450276!
You set up the explanation component (optional) of the EHS Expert using the following pa-
rameters:
• EXPERT_EXPLANATION_DISPLAY
If you set this parameter to X and allow the set of rules to run in the foreground, the system
displays the explanation immediately after the set of rules run. For sets of rules that run in
the background, the system does not display the explanation automatically.
• EXPERT_EXPLANATION_SAVE
Set this parameter to X if you want to save the explanation for the set of rules run in the
specification. If you set the parameter to X, you must also edit the following parameters:
• EXPERT_EXPLANATION_ESTCAT
In this parameter you specify the value assignment type in which the explanation is to be
saved as a user-defined text. The standard version of the demo sets of rules contains the
entry SAP_EHS_0101_002. This value assignment type is not in a property tree because
the explanation is not displayed as a user-defined text but in the menu.
• EXPERT_EXPLANATION_RULE_PROP
In this parameter you specify the characteristic in which the name of the set of rules is
saved to allow its assignment when displayed at a later stage. The characteristic must be in
the same value assignment type as the user-defined text for the explanation. The standard
version of the demo sets of rules contains the entry SAP_EHS_0101_002_RULESET.
Note
If you run a master data match up, the system automatically appends a phrase set
and a check module to the characteristic. You must remove this check module again.
• EXPERT_EXPLANATION_DATE_PROP
In this parameter you specify the characteristic in which the current date is written with each
rule run. The characteristic must be in the same value assignment type as specified in the
parameter EXPERT_EXPLANATION_ESTCAT. The standard version of the demo sets of
rules contains the entry SAP_EHS_0101_002_RUN_DATE. The last run date is only written
when triggered separately with the parameter EXPERT_WRITE_RUN_DATE. Please note
that this option requires the implementation of OSS note no. 1450276!
• EXPERT_EXPLANATION_TEXTCAT
In this parameter you specify the user-defined text type with which the explanation is to be
saved in the specification. The standard version of the demo sets of rules contains the entry
EX.
• EXPERT_ADD_PARAM_1
In this parameter you specify the path and name of the index / header file of your SAP EHS
Regulatory Content database.
• EXPERT_ADD_PARAM_2
In this parameter you can specify a user name to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_ADD_PARAM_3
In this parameter you can specify a password to access your SAP EHS Regulatory Content
database if it is stored in a password protected storage location or web server.
• EXPERT_TAB_FIELD_1
This parameter is the specification key from SAP EHS, it should not be changed.
• EXPERT_TAB_FIELD_2
In this parameter you specify the identifier that OCC should use when looking for substance
data. This is usually either the CAS or the UN number.
• EXPERT_TAB_FIELD_3
In this parameter you specify the identifier that OCC should use for display. Choose an
identifier that is available for all substances like synonym name.
• EXPERT_TAB_FIELD_4
In this parameter you can specify a second identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifier specified in
EXPERT_TAB_FIELD_2 does not give a search result. The main purpose is for loading data
that is not assigned to CAS numbers.
• EXPERT_TAB_FIELD_5
In this parameter you can specify a third identifier that OCC should use when look-
ing for substance data. This is identifier is only used when the identifiers specified in
EXPERT_TAB_FIELD_2 and EXPERT_TAB_FIELD_4 do not give a search result. The main
purpose is for loading data that is not assigned to CAS numbers, e.g. by using PMN numbers.
EXPERT_RULE_SET ZEXP_GHS
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_GHS
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
Standard environment parameters with default values are delivered with some reference func-
tion modules.
Tip
If you want to define your own function modules, display the documentation for the
corresponding reference function module (SE37). Write the new function module anal-
ogous to the reference function module and its interface.
Activities
1. Call the IMG activity.
2. Check if the default settings are correct.
3. You can assign a specification category to a user exit so that this user exit is displayed
depending on the specification category (for example, for user exits on secondary data
determination).
The assignment is relevant only for user exits that relate to specifications.
You can create new sources at any time, even in a productive system, from the EHS menu by
choosing Basic Data and Tools -> Tools -> Current Settings -> Specify Sources.
Navigate to Environment Health and Safety -> Basic Data and Tools ->Specification Manage-
ment -> Additional Information for Value Assignment -> Specify Sources.
• Pressing F5 or "New Entries" you can enter the Specification category like "SUBSTANCE".
You can assign countries and regions from the country table as validity areas for validity areas
of the category REGION. You can assign other organizational units for validity areas of another
category.
The definition of validity areas is closely linked to the requirements for reports. The validity
areas for this IMG activity are also used in the R/3 component Dangerous Goods Management.
Caution
• Be aware, that the validity area "REG_WORLD" is "empty" and
has the default behaviour to recognize all countries.
• Once you have used a validity area in a productive system, it can
no longer be deleted.
• Newly created validity areas are not evaluated correctly by the
Expert before restarting the Expert Server.
• Please see also SAP Note 603152 - Country Codes for Serbia
and Montenegro
• Press F5 or "New Entry" and enter the Validity area category (e.g. REGION) and the new
area as well as the description. Mark the entry and switch to the navigation sidebar
• Double clicking the "Assign Validity Area/Country" entry the list of countries belonging to
this area opens (- empty). There you can assign all countries that shall belong to this new
validity area.
Activities
1. In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
2. Create a new user exit of user exit type SUB_QUERY with the following values:
Your data implementation or update package contains a setup file e.g. ERC_PS_Region_
2015-2.exe which includes all required database XML files. Please execute this file and choose
the correct path to your SAP EHS Regulatory Content - substance lists and reference data
(Product Safety or Dangerous Goods) database installation. The path must match the entry of
the secondary data determination User Exit for data load, see chapter How to configure the
User Exit.
Note
Please carefully check the installation path if you are updating an existing database to
avoid mixing up e.g. productive and test databases.
In your XML substance database folder, a text file called version.txt is stored which
will have information about the currently installed database. Please check the version
file before updating the database to avoid overwriting your database with the same or
older files.
Note
Customers who have licensed both the SAP EHS Regulatory Content SDS Authoring
and Marketability packages have the possibility to load regulatory lists data from both
packages with one data load.
In case you have licensed both, SDS-Authoring and Marketability, and you load both
packages with one data load, please do not install the SDS-Authoring package for list
data. Instead, please use the Marketability installation file and follow the instructions
there to install the combined content for both packages.
Each installation of the substance lists and reference data XML substance database takes
approximately 1,5 GB for Product Safety and 1,1 GB for Dangerous Goods database.
After installation of the XML files, the structure of the database should look like:
Product Safety:
<path to XML substance database>\ERC-PS\ main folder with index file and version info
(header.xml and version.txt)
<path to XML substance database>\ERC-PS subfolder with all CAS numbers starting with 1
\1
<path to XML substance database>\ERC-PS subfolders for other CAS numbers starting
\... with 2 to 9
<path to XML substance database>\ERC-PS subfolder with all substance groups
\G
<path to XML substance database>\ERC-PS subfolder with all non-substances data, e.g.
\N mixtures and data with no CAS number
Alternatively extract the files and burn a DVD if no network folder should be used (performance
loss!). The network path for database must be accessible for all users (read access). For
security reasons, access should be limited to persons allowed to load SAP EHS Regulatory
Content - substance lists and reference data. Please note the path to the database in the
installation protocol.
It is possible to have separate databases for Test, Development and Productive systems. This
allows testing of data updates without impact on the productive data load. If you want to do this,
copy the whole database including all subfolders to a different storage location. In addition,
changes to the mapping database and user exit are required to support multiple databases
(see also chapters How to configure the User Exit, How to configure EHS OCC and How to
setup Mapping Database).
Note
Please make sure that you have a fast network connection between your OCC front-
end computer, SAP application server and the storage location of the XML substance
database. WAN connections are usually unsuitable for OCC as large amounts of data
have to be transferred. See also SAP note 1235663 for further hints to improve the
OCC performance.
• If network access is slow or bandwidth is limited, response time during data load might be
longer. Especially creating the cache will be much slower.
• In rare cases conflicts in opening the database if several persons are loading substance lists
and reference data at the same time
Note
Please make sure that you have a fast network connection between your OCC front-
end computer and the storage location of the mapping database. WAN connections
are usually unsuitable for OCC as large amounts of data have to be transferred. As the
mapping database is used to store cached data for improved performance, this file can
get quite big (over 100 MB). See also SAP note 1235663 for further hints to improve
the OCC performance.
If you are copying the mapping database from a CD/DVD to your local drive/network,
please remove the write protection of the file td_cleo.mdb after copying to your local
drive.
If the active phrase library is different than CUST, changes to the mapping database are re-
quired:
Replace all
Note
If several installations were done for the database (test/dev/prod), we recommend a
separate mapping database for each of the installations.
The OCC mapping database follows the same structure as SAP EHS Expert mapping databas-
es. There are separate mapping tables for properties, phrases and other values:
You can find the path of your mapping database in the ExpertAdmin tool installed on your front
end computer. On the instances tab there should be entries for e.g. CLEO_PS or CLEO_DG
which specify the path to the current mapping database. Please see Section 5.2.7.1.1, “How
to configure EHS OCC” for details.
Repeat the above steps for all installations of the SAP EHS Regulatory content - substance
lists and reference data mapping database if you are using more than one mapping database
or if each user has a local copy of the mapping database.
Note
We recommend to create a backup copy of your existing mapping database before
overwriting it with the new version of the mapping database.
In all tables, Internal_id means the key/value in the database and External_id the correspond-
ing key/value in SAP EHS.
Note
In Excel 2013 the default personal templates location is sometimes empty. Please
check in your Excel Options under ->Save ->Default personal templates location
that a folder is specified. Make sure the simulation spreadsheet has been copied
to this folder. If no folder is specified, you can select your own folder to store Excel
templates.
• As an alternative, open cleo_simulation.xlt in Microsoft Excel 97-2003 and choose "Save
as...". Use the option for Excel templates *.xlt and the correct path to the template folder
should be preset. Save as xlt-file to this folder. For MS Excel 2007, open choose cleo_
simulation.xltm and save as "Excel Template with macros" *.xltm
• It is also possible to open the simulation Excel files directly, without specifying them as a
template.
Note
You need to activate the macros in cleo_simulation.xlt / cleo_simulation.xltm or
you will not have access to any of the functionalities of the tool. If you have installed
previous versions of the Simulation Tool for Excel you may want to make a copy before
overwriting with the new version. If you do not want to activate macros, we recommend
using the previous version of the tool which was not making use of any macros but
has limited functionality.
Note
In MS Excel 2007, you need to save this Excel file in a trusted directory or you cannot
activate the macros.
Note
Please note that everything described in this chapter is only valid for SAP EHS Open
Content Connector (OCC) Service Pack 21 (November 2009) or higher. Please update
OCC to the latest version or contact us for the settings in older OCC versions.
Note
If multiple installations of the database exist for test, development and productive sys-
tems, the below steps must be repeated for all of them. Assign the name of the in-
stances as specified in the user exit parameter EXPERT_RULE_SET and assign the
appropriate mapping database.
Product Safety
A new instance entry has to be configured for Product Safety data:
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Instance Configuration ...
• Choose Add
• Name: CLEO_PS
• System: EHSOCC
• Mapping: Path to your mapping database TD_CLEO.mdb which was part of the installation in
step "How to setup Mapping Database"
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Preferences ...
• Switch to the Systems tab
• Choose Add
• Name: EHSOCCDG
• Options: All settings should have been automatically copied when the EHSOCCDG key was
created. No changes necessary.
• Choose Apply
• Execute OCC: ->Start -> Programs -> EHS -> Open Content Connector
• Choose: Options -> Instance Configuration ...
• Choose Add
• Name: CLEO_DG
• System: EHSOCCDG
• Mapping: Path to your mapping database TD_CLEO_DG.mdb which was part of the installation
in step "How to setup Mapping Database"
Environment, Health & Safety -> Product Safety -> Basic Settings -> Manage User Exits
If multiple installations of the database exist for test, development and productive systems,
copy the UserExit for each separate installation of the database. Change the following two
parameters:
The first three fields together form a unique identifier for the fact in the set of rules.
The first two fields together identify the record uniquely in the set of rules.
Note
Phrase mapping allows an assignment to be made between an internal and an external
value for any fact value. The phrase does not have to be an EHS phrase. The corre-
sponding conversion takes place if the IsPhrase indicator is set in fact mapping.
Expert generates a warning message if the rule set or OCC reads phrases which are
not contained in the Mapping table.
To suppress the warning message these phrases have to be added manually to the phrase
mapping table.
Tip
We recommend to insert these phrases using the following pattern:
To consider these enhancements for updates of the standard mapping you should label
these manual settings in the database e.g. in the Version column.
If the active phrase catalogue in the EHS system is named differently then the mapping has
to be changed (using the replace function in MS Access).
To activate writing the last run date, the following user-exit parameters have to be set:
All documents are available in folder 0-Documentation. This information should be reviewed
prior to continuing the update process.
This process may take from less than a minute to several minutes, depending on your network
speed to the database and your front-end computer (memory). Minimum requirements are 512
MB memory, we recommend 1 GB for the initial load.
Only the first load will take this long, after the cache has been rebuild, load times should be
down to only a few seconds again.
We recommend that the first load is done by somebody with a fast connection to the database,
e.g. someone working at the same site as the database installation.
After reviewing the filter settings, you can define these as the new standard by clicking the
"Default" button.
Note
With the SAP EHS Regulatory Content 2009-1 update we have provided enhanced
functionality for the list substance search which performs much faster than older version
of the program. Please check the technical details of this update and make sure that
the new version of the program is installed to avoid long run times or time-out issues.
2. Specify the path to the file erc_update_<version>.txt which can be found in folder 6-Up-
dateTools.
3. Combine with any other search option, e.g. SUBID or identifiers and execute the search.
4. A hit list of all list substances will be created that potentially have new or updated regulatory
data available.
5. We recommend saving the created hit list so you have it available in the future without re-
running the query.
Note
We also provide a file erc_new_group_assignments_<version>.txt. This file can be
used in the same way as described above, however it generates a list of substances
with new group assignments compared to the last release.
Note
For performance reasons, we are only checking the changes on a per substance level
not on single data sets. As a result you may have substances on your hit list for which
you do not get any new or changed data when you try to load them. This is the case if
• You have not licensed all regional packages for SAP EHS Regulatory Content - sub-
stance lists and reference data and the changes are in an area you have not licensed.
• You have switched off certain lists/regions in your filter settings; changed data there-
fore will not be displayed.
• You have decided not to load certain data and/or groups in the past for this substance,
if the change is in one of these data sets, it will not be displayed.
1. Create a hit list of substances either manually or as described in the last chapter of this
guide.
2. Select (all) substances
3. Start the secondary data determination and choose SAP ERC Product Safety Data (or a
comparable entry available in your system)
->Utilities -> Secondary Data -> Determination -> SAP ERC Product Safety Data
4. Select a substance and press "Set Filters"
5. Set data options "Load Changes Only" and optionally "Use Substance Groups"
1. Open Excel and create a new spreadsheet using the installed ERC_simulation.xltm as a
template:
-> File -> New -> New from template -> General Templates -> ERC_simulation.xltm
2. When prompted, enable macros
3. Open the spreadsheet with the new and revised list substance data you created during the
data load simulation if it is no longer open
4. Click the button Import OCC Data. The tool will check for any open OCC simulation file
and ask for your confirmation to import the data. If no spreadsheet with OCC data is found,
please either copy the data manually or open the correct file (starting with occSimu_*.csv)
5. Click the button Start Analysis to analyze the imported OCC data.
6. Save the new spreadsheet
The Simulation spreadsheet offers some functionality for a first analysis of new and changed
data:
• Two lines per dataset, the first one (white background) is the new SAP EHS Regulatory
Content data. The second line (grey background) is existing data in SAP EH&S
• Pairs of related data are assigned a unique record number in column A, e.g. 1_CLEO and
1_EHS
• Column A: Unique record number for pairs of related data, e.g. 1_CLEO and 1_EHS
• Column B: Substance ID of SAP EH&S (SubID)
• Column C: Group ID of SAP ERC => Data is from a generic group, not for the substance itself
• Column E: Mode - "New" , "Change" or "Inactivated"
• Column F: Property - this is the property or identifier with the new/changed data
• Column H: CAS number or identifier type
• Column I: Name of the substance
Example 2: Select all records that have a new entry for notification status
Example 4: Select all records with new or changed data for New Zealand:
If only a few substances need to be updated or if you want to exclude some data from being
updated, the manual process is the best choice.
If the data analysis in the previous chapters has not shown any critical changes and a lot of
substances have new data available, the autoload functionality should be used.
A manual update load is almost identical to an initial data load, except for two differences:
The option " Load Changes Only " is set and you can compare the new data with the already
existing data in SAP EH&S directly in OCC.
1. Create a hit list of substances either manually or as described in Section A.39.4, “Hit List
of List Substances”
2. Select (all) substances
3. Start the secondary data determination and choose SAP ERC Product Safety Data (or a
comparable entry available in your system)
->Utilities -> Secondary Data -> Determination -> SAP ERC Product Safety Data
4. If you have selected more than one substance, select a substance from the following screen
and press "Set Filters"
5. Set data options "Load Changes Only" and optionally "Use Substance Groups"
6. Select "Apply to All Substances"
7. Back on the OCC substance list, select the " Ok / Show Regulatory Data" button
8. Compare new and changed data to existing data in SAP EH&S
9. Make your choices on load/no load/etc.
10.Save data to EH&S
The autoload functionality is different from a standard load as no user interactivity is possible
after a choice of options and filters/regulatory lists was made. All changed and new data will
be automatically loaded into the existing list substances in SAP EH&S.
1. Create a hit list of substances either manually or as described in Section A.39.4, “Hit List
of List Substances”
2. Select (all) substances
3. Start the secondary data determination and choose CLEO Product Safety (or a comparable
entry available in your system)
->Utilities -> Secondary Data -> Determination -> SAP ERC Product Safety Data
4. Select a substance from the following screen and press "Set Filters"
5. Set data options "Load Changes Only" and optionally "Use Substance Groups"
6. Select "Apply to All Substances"
7. Select the "Autoload" button
Note
If a new group was assigned to a substance, the group information will not be loaded
using the autoload functionality combined with the "load changes only" option. This
is the intended behaviour to avoid unintentional group assignments which were not
reviewed by your regulatory experts.
If new or changed data becomes available within an existing group, your choices in the
past decide if the data will be loaded:
• If a group was loaded in the past, all new and changed data will be loaded as well.
• If a group was set to "no load" in the past, new and changed data will be ignored
and not loaded.
Tip
We recommend to set up separate Expert Server PCs for your test and for your pro-
ductive system.
Recommended components (without OCC installation on this PC) are shown in the following
screenshot:
When you have installed EHS Expert successfully, a directory is created on your PC with the
name that you specified during installation (default name: C:\Program Files\EHS\Expert). This
directory contains all the relevant subdirectories and files.
• The subdirectory RULES is the default directory for your sets of rules and already contains
sample sets of rules.
• The subdirectory LOG is used to store log files for EHS Expert if log creation is activated.
• The subdirectory BIN contains executable programs
Note
You can use the SAPGUI entry to find the details for GWHOST and GWSERV:
GWHOST contains the SAP router string including the application server. GWSERV
contains the string sapgw and the system number
3. Save these entries.
The system searches dynamically for all EHS management servers that are logged on to the
system and displays the PC names as the search results in the navigation tree.
• Double-click a PC name. The EHS management server is called and a list of all WWI and
EHS Expert servers installed in the system is displayed.
• Choose in the menu Service --> Create --> EHS Expert Server
• Choose a destination by using F4-help and enter a name a description for the EHS Expert
(in the example: EHS_EXPERT)
• Confirm your entries.
• The system enters the following data:
• The values for the selected destination in the RFC Parameters group box (Program ID,
Gateway host and Service)
• A generated service key (<destination/system/sequential number) and an editable service
name with description in the General group box
• The SAPRFC.ini file will be updated automatically on the Expert Server PC using the Pro-
gram ID "EHS_EXPERT_TEST" as PROGID and the Service "EHS_EXPERT_TDG_01"
as DEST .
• Accept your entries.
• The Expert Server will then immediately be started on the PC.
Standard settings
The EHS Expert server as a Windows service consists of the file EHSEXPSV.EXE that is
automatically copied to the corresponding bin directory for Expert installation (for example, c:
\program files\EHS\Expert\bin). The bin directory should also contain the following three files:
• The administration program SVCADMIN.EXE, which can be used to install, configure, and
check services
• The program library WIN32SVC.DLL
• The EHSSTART.EXE file to automatically start and monitor the WWI generation server or
EHS Expert server as a Windows service
Activities
1. Log on as local administrator to the PC
2. Start the MS-DOS prompt and change to the bin directory for EHS Expert installation
3. Install the service by calling the EHSEXPSV file together with command line parameters as
follows: EHSEXPSV.EXE -I -N<name> -D<destination>.
Example:
During the installation, for each service, a key is created with the name
EhsExpertSvc(<name>) under the main key HKEY_LOCAL_MACHINE\SYSTEM\Current-
ControlSet\Services.
• Start REGEDIT.EXE via Start\Run\regedit.exe
• Choose the key EhsExpertSvc(<name>)\Parameter.
• Change the parameters if required.
• Destination: name of logical SAP R/3 destination
• Idle Time: (default value = 1000 ms)
• InitialServerCount: Number of EHS Expert server threads that are created directly after
the service is started. (Default value = 1)
• MaximumServerCount: Maximum number of EHS Expert server threads. As soon as
the maximum is reached, a warning is logged. The service main thread then only func-
tions as a database server. (Default value = 20)
• MaximumServerCount: Maximum number of EHS Expert server threads. As soon as
the maximum is reached, a warning is logged. The service main thread then only func-
tions as a database server. (Default value = 20)
• LogDirOptions: (Default value = 1 /F /P /E /L=clean.log)
Examples:
1 /F /P /E /L=clean.log deletes all files whose creation date is more than a day ago
and log messages are created in the CLEAN.LOG file in the EHS Expert directory.
1 /P deletes all files whose change date is more than a day ago.
5. Configure the application log for Windows NT or Windows 2000.
• Start the Windows event viewer (EVENTVWR.EXE).
• Change the setting for the application log via Log -> Log settings to the option Overwrite
Events as Needed to prevent an overflow in the event viewer.
6. Test the service.
• Start and stop the EHS Expert Server (Test) service using the SVCADMIN.EXE program
from the bin directory of the Expert installation or the Services control in Windows.
• Call the EHS Expert Server (Test) from the SAP System.
• Use the event viewer to check whether the respective commands in the application log file
have been logged and whether the language-dependent texts for the events are displayed
in the detail view.
• Check whether the service was started automatically on system startup by rebooting the
PC and calling the EHS Expert Server (Test) from the SAP System.
7. To remove an installed service, proceed as follows:
• Log on to the PC with administrator rights.
• Start the service administration program SVCADMIN.EXE from the bin directory for the
Expert installation.
• If necessary, close the current service using the Control and configure services function.
• Remove the service using the Uninstall services function.
If you copied the icons to your desktop when you installed the EHS Expert, change the param-
eter -D accordingly to the entry in your file SAPRFC.INI.
Alternatively, you can call the program on your front end using the menu command Start ->
Programs -> EHS Expert. The default parameter -D is here set to EHS_EXPERT. Therefore you
have to change the parameter if you have defined another destination in your file SAPRFC.INI
(EHS_EXPERT_TDG_01 in the example)
To specify dangerous goods user-defined text profiles, use transaction SPRO, choose SAP
Reference IMG and navigate through the activities tree to Environment, Health and Safety -
Dangerous Goods Management - Basic Data and Master Data - Common Settings - Specify
Profiles for User-Defined Dangerous Goods Texts:
By assigning a rating to a value assignment, you specify who can access the data or on which
documents the data can be printed. Once a rating has been used in a productive system you
cannot delete it.
To add value assignment rating, go into the customizing using transaction SPRO and navigate
to Environment, Health and Safety -> Basic Data and Tools -> Additional Information for Value
Assignment -> Usage ->Specify Ratings.
Then press F5 or "New Entry" and enter the new ratings as well as the description and save
your entries.
A.47.1. Overview
The SAP EHS Regulatory Content Expert Rule Sets can now be installed with the help of SAP
Setup on the Expert-Server.
Note
SAP ERC Rule Sets can be installed and updated on the Expert Server either
with the help of SAP Setup or manually. However for an individual rule set It is not
recommended to use both methods. Therefore if SAP Setup has been used for a
particular rule set, future updates should also be performed using SAP Setup.
For initial installations of SAP ERC Rule Sets the SAP Setup can be used as
detailed below.
However for an update of rule sets using SAP Setup the following additional steps
are required:
1) Backup of existing rule sets - make a copy of the <EXPERT>\Rules directory
2) Start the setup for rule sets and install new versions (existing rule instances
will be overwritten)
3) Make customer specific changes in the mapping databases and external value
databases
In case of intermediate corrections of ruc-files, the instance in the registry needs
to be changed manually (by using ExpertAdmin or transaction cgsadm).
For the next regular update SAPSetup can then again be used, but the intermedi-
ate version of the ruc-file will not be deleted by SAPSetup. This has no impact on
the functionality. The intermediate version of the ruc-file can be deleted manually.
• Installation: Copy rule set files into the specified Rules Directory on the Expert Server PC
and create registry settings for all needed instances.
• Registration: Create registry settings for all needed instances. The rule set files need to be
transferred manually.
1. Use SAP Setup to install all needed Expert Rule Sets on a test or QA Expert Server
2. Perform all tests and make necessary adjustments to the mapping mdbs or external tables
on the test or QA Expert server
3. Use SAP Setup’s registration option to create all registry settings needed on any Production
Expert Servers.
4. Transfer Rule Set files from the test or QA Expert Server to the Production Expert Server(s)
This procedure will ensure necessary registry entries are created for all rules, while also en-
suring consistency between QA and Production environments. Detailed steps for this proce-
dure follow below.
A yellow dot indicates a change in the selection list. A green plus sign next to a rule set package
or rule set name indicates that this rule set will be installed.
If you deselect an installed SAP front end component in this list, a red minus sign indicates
that this rule set package or rule set will be deinstalled.
You can select all rule files in one click by choosing "Select all".
When updating from one SAP ERC release to the next SAP ERC release (e.g. from ERC1605
to ERC1611) it is important to choose "Select all" that all rule sets are updated and new rule
sets are installed on the Expert Server PC.
Procedure
• Create a backup of the .mdb files before installation, as the files get overwritten during the
installation process.
• Start SetupERC_<package>.exe (e.g. SetupERC_GLOBAL.exe)
• The installation starts and a progress screen is displayed.
• Choose next
• The list of EHS Regulatory Content rule sets is displayed.
• Choose the rule sets from "Installation"
• Select the rule sets that you want to install or deselect the ones you want to remove.
A yellow dot indicates a change in the selection list. A green plus sign next to a rule set
package or rule set name indicates that this rule set will be installed.
If you deselect an installed SAP front end component in this list, a red minus sign indicates
that this rule set package or rule set will be uninstalled.
• Choose next
Once the installation is complete, a confirmation screen is displayed. The rule sets are now
successfully installed.
• Verify the mapping databases and the settings in the external tables and adapt them if nec-
essary.
Procedure
• Create a backup of the .mdb files before installation (just as a precaution, the files are not
overwritten during the registration process)
• Start SetupERC_<package>.exe (e.g. SetupERC_GLOBAL.exe)
• The installation starts and a progress screen is displayed.
• Choose next
A yellow dot indicates a change in the selection list. A green plus sign next to a rule set
package or rule set name indicates that this rule set will be registered.
If you deselect an installed SAP front end component in this list, a red minus sign indicates
that this rule set package or rule set will be uninstalled.
• Choose next
Once the registration is complete, a confirmation screen is displayed. The rule sets are now
successfully registered.
• Copy the rule set files form the Test or QA Expert Server to the Productive Expert Server.
Some rule sets are delivered with an additional files containing the external tables (file with the
extension .mdb) or additional rules in files with extension .ruc
You can copy the files by using EHS Service Administration or by connecting to the Expert
Server PC directly.
NOTE:
You will get the following screen and you can choose the path Rules for the files to be
transferred.
4. Press save and the files will be copied to the Expert Server PC
Direct copy
Connect to the Expert Server PC and copy all files in the RULES subdirectory of the Expert
installation.
Result
Using the rules in the set of rules, the EHS Expert determines data for the selected specifi-
cations and writes it to the database. When writing the data, the EHS Expert uses the data
you specified in the IMG activity Manage User Exits under the corresponding parameters for
the EHS Expert user exit for rating, validity area, data provider, and data origin, or the data
changed manually in the Expert: Parameter Entry for Data Determination dialog box.
The save mode specified in Customizing or in this dialog box determines whether existing data
records are overwritten, or whether new data records are just added. If the newly determined
data is identical to the data determined at an earlier stage, the system does not delete or create
data if save mode I is not set.
You can use and edit the data that was written to the database by the EHS Expert in the same
way as data entered manually.
Note
Here you should note that if during subsequent manual processing the data origin and
data provider differ from the corresponding parameters of the EHS Expert run, a new
value assignment instance is created in a new EHS Expert run – even if the values
then match.
To activate the explanatory tool for an Expert rule, the following steps have to be performed:
• Additional user-exit parameters have to be set according to the Expert rule's functional de-
scription. The default settings are:
• EXPERT_EXPLANATION_SAVE = X (invokes the explanation)
• EXPERT_EXPLANATION_ESTCAT = SAP_EHS_0101_002 (property the explanation is
stored at)
• EXPERT_EXPLANATION_RULE_PROP = SAP_EHS_0101_002_RULESET (character-
istic within the property given above to save the user-exit name)
• EXPERT_EXPLANATION_TEXTCAT = EX (defines the user-defined free text category to
be used for the XML stream)
• (optional) EXPERT_EXPLANATION_DISPLAY = X (has the explanation displayed auto-
matically after the rule set run)
• Create the user-defined free text category defined above (EX in the default case).
• Make sure that the characteristic defined above (default: SAP_EHS_0101_002_RULESET)
is not with phrases and remove the phrase set assignment if necessary. Please note that the
phrase set assignment may be made automatically with standard property tree upgrades;
in this case this has to be undone manually!
• If you want to have the current date written with the explanation each time you run the Expert
rule, the following parameters are required in addition:
• (optional) EXPERT_WRITE_RUN_DATE = X (invoking saving the date)
• (optional) EXPERT_EXPLANATION_DATE_PROP = SAP_EHS_0101_002_RUN_DATE
(characteristic where the date is stored)
Some of the standard expert rules use the sub rule GS_IDENT, which has an external table
GS_ident_externvalues.mdb where some parameters for the explanation can be customized
individually. For details on these parameters please refer to the rule set's functional description.
This is accomplished by using a specific rating “UPO” for the user provided output information.
This user provided output (UPO) is merged into the rules output and has precedence over the
information derived by the rule logic. This UPO does not need to cover all rules output fields. If
partial information is given, the rule takes the UPO and adds its output as derived by the normal
calculation. The logic which UPO information can be provided and how the logic form merging
this UPO input into the rules output is rule-specific and will be documented in the functional
description of the individual rules. If no UPO is given, the rule derives its result as normal.
From the vendor safety data sheet for the mixture it is derived that the mixture has a water
pollution class 2, which is the classification that the user would like to get as output from the
rule. This information can be maintained with a rating UPO (user provided output) in the WGK
output property as follows:
This information is then merged into the result of the WGK rule in precedence over the usual
result leading to a WGK of 2 for the mixture:
The UPO information regarding the water pollution class has been merged into the rules result.
Regulatory Basis, Reference and output usage are standard results, while the Water Pollution
Class is merged from the UPO rated instance. To indicate that UPO has been considered, the
source note is followed by the letters UPO
For each rule set instance that shall be logged the logging needs to be activated separately;
this is especially important when sub rules are used, i.e. for DangGoods and NotStat.
To find out which instance is called for a given rule set, please check the user-exit parameter
EXPERT_RULE_SET, or refer to the documentation for the sub rules used.
To activate the logging please go to the Application Parameters tab page and tick the "Log-
ging" flag at the rule set instance to enable the RFC logging, and set the log level to 5 to set
the so-called Exp logging to an appropriate level of detail.
Caution
Please do not forget to deactivate the logging afterwards, since an activated log level
has a negative impact on the Expert's performance.
4. Run the rule set in EHS
5. Download the files EXP*.log and RFC*.log from the logging directory within the EHS Service
Administration
You can download the files via the menu: Utilities --> File from Server
Choose the logging directory on the Expert Server PC; default is the directory LOG in the
Expert installation directory
NOTE:
Mark the files to be transferred and choose the storage path on you computer afterwards
To activate the logging please tick the "Log Data Exchange" flag at the rule set instance to
enable the RFC logging, and set the log level to 5 to set the so-called Exp logging to an
appropriate level of detail. (see screenshot)
3. Run the rule set in EHS
4. Download the files EXP*.log and RFC*.log from the logging directory (the logging directory
can be specified, default is the directory LOG in the Expert installation directory.)
Caution
Please do not forget to deactivate the logging afterwards, since an activated log level
has a negative impact on the Expert's performance.
The purpose of it is to allow the user to modify the preconfigured data according to the needs
of the customers.
It is recommended to install this data base in the same directory on the Expert server as the
rule files.
If this external data base is installed somewhere else, the linkage between the rule set and the
external data base must be maintained by defining the file path in the mapping tables.
Example: Record-Mapping –Installation of the external data base in the same directory as the
rule set.
Internal_id External_id
EXT_RANGES T:Ranges/HazardComp_US_externvalues.mdb
Example: Record-Mapping – Full declaration of the path for the external data
Internal_id External_id
EXT_RANGES T:Ranges/C:\Program Files\EHS\Expert\Rules
\HazardComp_US_externvalues.mdb
Example: Fact-Mapping –Installation of the external data base in the same directory as the
rule set.
Internal_id External_id
i_limit_oel T:Threshold;OEL/HazardComp_US_externvalues.mdb
Example: Fact-Mapping –Full declaration of the path for the external data
Internal_id External_id
i_limit_oel T:Threshold;OEL/C:\Program Files\EHS\Expert\Rules
\HazardComp_US_externvalues.mdb
A documentation of the adjustable parameters could be obtained from the respective functional
descriptions of the rule sets.
• CHANGES_in_mapping_table_____ExpFactMap
• CHANGES_in_mapping_table_____ExpPhraseMap
• CHANGES_in_mapping_table_____ExpRecordMap
• CHANGES_in_mapping_table_____ExpGroupMap
Changes which have been made concerning the externvalues database are also documented
here, e.g.
• Changes_in_external_table____GHS_table
• Table_Changes_in_external_table_not_P_Statements
There are three different cases of mapping changes: new entries, changed entries, and deleted
entries.
Every changed, new, or deleted entry is added to the HISTORY.mdb as a new line.
If there is a change, it is additionally checked if the given entry already exists in the
HISTORY.mdb (i.e. if it has already been changed in a former version); if this is the case, the
matching entry is updated and the old version information is preserved as described below.
Version:
• the version number without a preceding "V", e.g. "1.5"
• if a line is updated, the old Version entry is replaced by the new one
With the help of the History database the key-user can easily adopt the Mapping to a newly
delivered version, if the company has fitted the mapping to their needs by adding , deleting or
changing phrases from the standard mapping database delivered by SAP.
Go to: Environment, Health and Safety - Basic Data and Tools - Specification Management -
Specification Master - Check Identification Listings
Add the required Identification Listings via "New Entry" including a header, add the required
identifiers to the definition and save.
If a UNIX system is used, choose the corresponding import settings to import a windows file.
Then import the dat-file using transaction CG34 "Import Report Templates" or go to Logistics -
> Environment, Health and Safety -> Basic Data and Tools -> Tools -> Data Transfer -> Import
Report Template
• File with path: <path on application server and file with ending .dat>
(Note that each dat-file contains the information to automatically pull the corresponding doc-
file. The doc-file itself should NOT be specified for the import.)
• Character standard: UFT-8
Choose function "Check file". The SAP System checks if the data can be transferred correctly
from the transfer file and matches up the symbols.
Check Symbol Matchup to make sure all symbols are available on system in the correct way.
All entries in the system column must have symbol names. If they do not, check if symbol
generation was carried out on your system.
Or you go to Logistics -> Environment, Health and Safety -> Basic Data and Tools -> Report
Definition -> Edit Generation Variants
In the generation variant the main validity area is defined under "Validity Area"; the area from
which the template will draw its data.
The option "Usage check" is utilized to control the way in which the usages are compared.
There are four options to select: 0, 1, 2 and 3.
If you do not specify a value, the SAP System uses the value 0 as default.
Value 0: The usage is appropriate if - with the same rating used - the generation variant validity
area that is expanded to its countries and regions is the same as or is a subset of the expanded
validity area of the usage with which it is to be compared.
Example: Generation variant: DE Value assignment usage: REG_EU If a safety data sheet is
created for Germany, value assignment instances are also taken into account that are valid
for the validity area REG_EU.
Please see the SAP Help function for all the details on the option.
These validity areas or languages must be addressed directly by the WWI coding in the
template (G-Repeating-Group) to be effective. By the use of these Rating/Validity options, it
is for example possible to give out special phrases in English on a template in Chinese or
Spanish.
A complete overview on the parameters of all generation variants can be found in the document
RGV_XXXX_Configuration.pdf (where XXXX stands for the current release).
Requirements
• Standard name
Usually components in SDSs are listed by name that allows to identify the component with
a commonly used name. The name should be given in the language of the SDS. Often
regulations or best practices require a specific name that is used in some regulations or for
registration purposes (e.g. name from REACH registration in EU SDS section 3)
• trade secret name
Some regulations allow that a name of a component can be discarded (e.g. standard name
replaced by the words “trade secret” or replaced by a more generic name). This name is an
alternative name to the standard name
• Collect all names at a dedicated identifier (e.g. NAM PROD) by manually or logic-based
copying them from all potential sources (e.g. NAM ANNEXI, NAM EINECS, NAM ENCS, …).
Translation gaps can be either closed by translation or by use of a language independent
entry.
• Create an identification listing in customization, that holds all potential sources (e.g. NAM
ANNEXI, NAM EINECS, NAM ENCS, …) in a prioritized sort sequence. As translation gaps
will occur (e.g. NAM ANNEXI not available for all substances and only in selected lan-
guages), a language independent identifier should be given (e.g. NAM SYN) as fallback at
the lowest priority in the listing.
The trade secret name has to be included in a separate ID listing which is then used for the
disclosure of trade secret names.
secret applies (e.g. “proprietary ingredient” this needs to be maintained as separate identifier,
(e.g. NAM TRADESEC2) and is entered on position 2 of the listing.
Technical limitations
As the component type in the composition tab controls the output of trade secret identifiers,
this trigger cannot be provided in value assignment types with specification listing (instead
of composition) only. In this case always the standard identifier will be disclosed.
• More than one identifier per type
If more than one relevant identifier is found by the WWI functions (e.g. NAM PROD DE
is maintained twice), it can occur that the first found identifier is disclosed in the column
for component names, while the second found identifier is disclosed in the column for com-
ponent numbers instead of e.g. the CAS-number. This can be avoided by consistent data
maintenance. It can be avoided technically, if all name identifiers in the ID listing are listed
for position 1 and all number identifiers are listed for position 2.
Further component type/ID listing combinations can be maintained. For all component types
that are not maintained at an environment parameter the ID listing D_VALPOS is used as
default. If no entries are given in the environment parameters the ID listing D_VALPOS is
used for standard name output and trade secret name output as well.
Example:
For this setup the NAM PROD needs to be maintained with all translations (or if missing
translations should be allowed all available translations plus one language independent
entry for NAM PROD)
• Complex ID listing for standard identifier output D_NTSIDLID
For this setup the NAM PROD (and only this one) should have a language independent
entry to make sure that always an output is found.
• ID listing for trade secret identifier output D_TSIDLID
This setup support to discard the CAS-No. with a name identifier (e.g. Proprietary Ingre-
dient)
• Simple ID listing for trade secret identifier output D_TSIDLID
This setup results in disclosure of a trade secret name instead of a standard name. No
INTERNAL: SAP CUSTOMER 230 © SAP SE
numbers are printed, so the CAS-number can be discarded for trade secret components.
How To ...
1. Masking the component identity, while the component identity is being claimed as a trade
secret.
2. Masking the component concentration, while the component concentration is being claimed
as a trade secret.
3. Masking both the component identity and concentration.
Note: The US section 3 would be identical, with the exception of the HMIRA phrase, which
would be missing.
This is achieved by using the component type ZTRADECONC. When the relevant component
in the product Standard composition is maintained with this component type, the template
outputs “Trade Secret (HazardComp range)" instead of just the HazardComp range (see case
2 in mock-up above).
1. If "ignore Expert rule range" is not maintained, then the HazardComp ranges will be generic
ranges. This means that all ranges for all disclosed components will be generic ranges.
2. If "ignore Expert rule range" is maintained, then the HazardComp ranges will be copied
directly from the Standard composition. This is the case where at least some of the disclosed
components are not trade secrets, and thus have their true concentrations/ranges (from the
Standard composition) disclosed in section 3.
This is achieved by using the component type ZTRADESCON. When the relevant component
in the product Standard composition is maintained with this component type, the template
outputs NAM ZTRADESEC instead of NAM PROD for the chemical name. The CAS number
is replaced by NAM ZTRADESEC2. “Trade Secret (HazardComp range)” is output instead of
just the HazardComp range (see case 3 in mock-up above).
Note: The same considerations regarding the HazardComp range as above apply here.
The HMIRA phrase is output in section 3 of the Canada SDS (see mock-up above) if one of
the based on the following logic: If the HazardComp contains a component with one of the
component types ZTRADESEC, ZTRADECONC or ZTRADESCON in a CA instance, then the
phrase is output.
REP_TS_IDLID4 D_NTSIDLID*
*The component type ZTRADECONC for masking concentration (see Case 2 above) has the
D_NTSIDLID ID Listing as the masked Concentration is written by the HazComp rule.
The Component types of the components can be ZTRADESCON (masking component identity
and conc.) or TRADESEC (masking component identity only).
In order to make use of the latest ERC Phrase Library, ERC Substance Lists and Reference
Data, ERC Expert Rules, and ERC WWI Templates, the contents of the latest Property Tree
Package 1810 Product Safety and of the other existing property tree packages have to be
implemented before implementing the other parts of SAP ERC Update 1810. Please note that
changes to the EH&S property tree will be officially delivered with the SAP release ERP 6.0
EhP8 and lower EHPs with specific support packages. In addition, the EH&S property trees are
also available in SAP S/4 HANA on-premise 1511, SAP S/4 HANA on-premise 1610, and SAP
S/4 HANA on-premise 1709. More details about the delivery of property tree enhancements
can be found in SAP Note 1761696.
• Folder "Update": In this folder the latest property tree package is included and corrections
to former property tree packages - if neccessary (see Chapter 1 below).
• Folder "Initial": New ERC customers with an ERC 3.0 licence may need to update their
EH&S property tree in order to make proper use of the other ERC products like phrases, rule
sets, regulatory data or WWI templates. Therefore, all necessary property tree packages are
summarized in this folder which are needed to update the EH&S standard property tree for
SAP systems with releases ranging from ERP 6.0 EhP3 up to ERP 6.0 EhP8 (see Chapter
2 below).
Please read the ReadMe document included in every property tree package carefully BEFORE
starting the implementation of any property tree package!
The existing property tree packages which were delivered in the past and are needed to bring
the EH&S property tree of a new ERC customer up-to-date are summarized in Chapter 2.
General Information
File name Description
ReadMe_EHS_Property_Tree_Package_1810_ Summary of installation steps (text docu-
PS.pdf ment)
Changes_EHS_Property_Tree_Package_1810_ Summary of new and enhanced properties
PS.pdf and characteristics included in this package
(text document)
Help_Texts_EN_EHS_Property_Tree_Package_ Summary of help texts in English (text docu-
1810_PS.pdf ment)
Help_Texts_DE_EHS_Property_Tree_Package_ Summary of help texts in German (text docu-
1810_PS.pdf ment)
Transports
Please note that for each transport two files are delivered: Files with names starting with a "K"
are the co-files, files with names starting with a "R" are the data files.
Please note that the Folder "Initial" is available on the SAP Market Place for ERC 3.0
Customers only!
Example:
• A customer with an ERP 6.0 EhP3 system should first check in SAP Note 1761696 whether
the Support Package implemented in the customer's SAP ERP 6.0 EhPx system includes
already the update up to 2015-1 (in delivery client 000), for example.
• If yes, the customer can take over the standard properties and property trees from the deliv-
ery client 000 to the working client XYZ (tools see SAP EH&S customizing) so that the prop-
erty tree in client XYZ is updated to 2015-1. After that, the property tree packages 2015-2
(number 18), 1605 (number 19), 1611 (number 20), 1705 (number 21), 1711 (number 22),
1805 (number 23), and 1810 (number 24) shall be implemented.
• If no, the customer shall implement the combination package Version 3-0 which updates
the property tree up to 2011-2. After that, the property tree packages 2012-1 (number 12) ,
2012-2 (number 13), 2013-2 (number 14), 2014-1 (number 15), 2014-2 (number 16), 2015-1
(number 17), 2015-2 (number 18), 1605 (number 19), 1611 (number 20), 1705 (number 21),
1711 (number 22), 1805 (number 23), and 1810 (number 24) shall be implemented.
21 SAP EH&S Property Tree Package 1705 ERP 6.0 1611 -> ERP 6.0 1705
Product Safety
22 SAP EH&S Property Tree Package 1711 ERP 6.0 1705 -> ERP 6.0 1711
Product Safety
23 SAP EH&S Property Tree Package 1805 ERP 6.0 1711 -> ERP 6.0 1805
Product Safety
24 SAP EH&S Property Tree Package 1810 ERP 6.0 1805 -> ERP 6.0 1810
Product Safety
If a customer needs earlier property tree packages, please set up a ticket in the SAP Helpdesk
with component EHS-ERC.
14 SAP EH&S Property Tree Package 2013-2 ERP 6.0 EhP7 (third part) -> ERP 6.0
Product Safety EhP7 2013-2
15 SAP EH&S Property Tree Package 2014-1 ERP 6.0 EhP7 2013-2 -> ERP 6.0
Product Safety 2014-1
16 SAP EH&S Property Tree Package 2014-2 ERP 6.0 2014-1 -> ERP 6.0 2014-2
Product Safety
17 SAP EH&S Property Tree Package 2015-1 ERP 6.0 2014-2 -> ERP 6.0 2015-1
Product Safety
18 SAP EH&S Property Tree Package 2015-2 ERP 6.0 2015-1 -> ERP 6.0 2015-2
Product Safety
19 SAP EH&S Property Tree Package 1605 ERP 6.0 2015-2 -> ERP 6.0 1605
Product Safety
20 SAP EH&S Property Tree Package 1611 ERP 6.0 1605 -> ERP 6.0 1611
Product Safety
21 SAP EH&S Property Tree Package 1705 ERP 6.0 1611-> ERP 6.0 1705
Product Safety
22 SAP EH&S Property Tree Package 1711 ERP 6.0 1705 -> ERP 6.0 1711
Product Safety
23 SAP EH&S Property Tree Package 1805 ERP 6.0 1711 -> ERP 6.0 1805
Product Safety
24 SAP EH&S Property Tree Package 1810 ERP 6.0 1805 -> ERP 6.0 1810
Product Safety
Standard
File name Description
01_documents
CED_Changes_1810.xlsx Excel file with an overview of new, changed and retired
phrases
CED_ReleaseNote_1810.pdf Release Note for current version
Phrase_Services_Proposals.xls Proposal template for customer suggestions
02_phrases
1_ced_1810_standard_complete.dat Phrase import file including all phrases in all standard
languages except US English (Z8) and Brazilian Por-
tuguese (Z9) for Unicode systems
1_ced_1810_standard_update.dat Phrase import file including revised and new phrases in
all standard languages
2_ced_1810_usenglish_Z8_ Phrase import file including all phrases in US English
complete.dat via Z8 customer correspondence language
2_ced_1810_usenglish_Z8_ Phrase import file including revised and new phrases in
update.dat US English (Z8)
3_ced_1810_brazilian_Z9_ Phrase import file including all phrases in Brazilian Por-
complete.dat tuguese via Z9 customer correspondence language
3_ced_1810_brazilian_Z9_ Phrase import file including revised and new phrases in
update.dat Brazilian Portuguese (Z9)
4_ced_1810_arabic_hebrew_ Phrase import file including all phrases Unicode Phrase
complete.dat import file Arabic and Hebrew
4_ced_1810_arabic_hebrew_ Phrase import file including revised and new phrases in
update.dat Arabic and Hebrew
03_psets
Example: N05.00314600 In the event of fire, cool tanks with water spray.
N05.00314600
7xxxx R phrases
0xxxx
04.00 First aid measures
1xxxx Inhalation
2xxxx Skin
3xxxx Eye
4xxxx Ingestion
5xxxx Physician
6xxxx Protection of first aides
0xxxx General phrases
05.00 Fire fighting measures
1xxxx Suitable / unsuitable extinguishing media
2xxxx Specific Hazards from burning
3xxxx Special information for fire fighters
0xxxx Further information
06.00 Accidental release measures
1xxxx Personal precautions
2xxxx Environmental precautions
3xxxx Methods for clean up
0xxxx Further information
07.00 Handling and storage
1xxxx Handling - Technical measures / precautions
2xxxx Handling - Save handling advice
3xxxx Storage-technical measures / storage precautions
4xxxx Storage - incompatible materials
5xxxx Storage - packing material
0xxxx Further information
08.00 Exposure control / personal protection
1xxxx Engineering methods to reduce exposure
2xxxx Control parameters
3xxxx Personal protection - respiratory
4xxxx Personal protection - Hand
5xxxx Personal protection - Eye
6xxxx Personal protection - Skin / Body
7xxxx Hygiene measures
0xxxx Further information
09.00 Physical and chemical properties
1xxxx Form
2xxxx Colour
3xxxx Odour
4xxxx Other physical chemical properties
5xxxx pH
6xxxx Changes in state
7xxxx Decomposition
8xxxx Flash point
9xxxx Solubility
0xxxx Further information
10.00 Stability and reactivity
1xxxx Conditions to avoid
2xxxx Materials to avoid
3xxxx Hazardous decomposition products
0xxxx Further information
11.00 Toxicology information
1xxxx Acute toxicity
2xxxx Local effects
3xxxx Chronic / long term effects
4xxxx Specific effects e. g. mutagenicity
5xxxx Symptoms / organs / useful expressions
0xxxx Further information
12.00 Ecological information
1xxxx Possible effects, environmental fate etc.
2xxxx Ecotoxicity
0xxxx Further information
13.00 Disposal considerations
1xxxx Waste from residues / unused products
2xxxx Contaminated packaging
0xxxx Further information
14.00 Transport information
1xxxx Proper Shipping names English only (unnecessary
2xxxx with the EHS2.2-tree)
These phrases are headers and sub headers of the MSDS chapters and names of properties
and characteristics.
H* MLL-CED-Header
E* EHS-CED-Header
=> these phrases may then be allocated to phrase sets provided that they are part of the active
library
C.2.3. Language/Codepages
Language Language ISO-Norm SAP R/3 Mi- Mi- Font (Mi-
group character Stan- crosoft-Code-crosoft-Code-crosoft) in
set dard-Code- page page in which phras-
page (based SAP R/3 es are sup-
on ISO- plied by CED
Norm)
Western English ISO 8859-1 1100 1252 (iden- 110 ARIAL.TTF
European tical with
Danish R/3 Code-
page 1100)
Dutch
Finnish
French
German
Italian
Norwegian
Portuguese
Spanish
Swedish
Brazilian
US English
Greek Greek ISO 8859-7 1700 1253 1704 ARIAL
GREEK.TTF
Central Eu- Albanian ISO 8859-2 1401 1250 1404 ARIAL
ropean CE.TTF
Croatian
Czech
Hungarian
Polish
Romanian
Slovakian
Slovenian
Serbian
Cyrillic Russian ISO 8859-5 1500 1251 1504 ARIAL
CYR.TTF
Bulgarian
Macedo-
nian
Ukrainian
Turkish Turkish ISO 8859-9 1610 1254 1614 ARIAL
TUR.TTF
Baltic Estonian ISO 8859-4 1900 1257 1904 ARIAL
BALTIC.TTF
Latvian
Lithuanian
Nordic Icelandic ISO ARIAL MS
8859-10 Unicode
AP-Latin English ISO 8859-1 110 1252 1100 ARIAL.TTF
Indonesian
Malay
AP-TChin Traditional 8300 950 (BIG 5) 8300 mingliu.ttc
Chinese -
not all char-
acters sup-
ported!
AP-SChin Simplified 8400 936 (GB 8400 Simsun.ttc
Chinese 2312)
AP- Japanese 8000 932 8000 msmincho.ttc
Japanese
AP-Korean Korean 8500 949 8500 batang.ttc
AP-Thai Thai 8600 874 8600 tahoma.ttc
Unicode Canadian 4103 ARIAL MS
French Unicode
French
Mexican
Spanish
Hindi (AP)
Vietnamese
(AP)
Traditional
Chinese
(AP)
Phrase language Language keys for phrase im- Language key presentation in
port phrase administration
English E EN
English_GB 6N*
Danish K DA
Dutch N NL
Finnish U FI
French F FR
German D DE
Greek G EL
Italian I IT
Norwegian O NO
Portuguese P PT
Portuguese_PT 1P*
Spanish S ES
Swedish V SV
1
Bulgarian W BG
Croatian 6 HR
Czech C CS
Estonian 9 ET
Hungarian H HU
Icelandic b IS
Latvian Y LV
Lithuanian X LT
Macedonian MK
Polish L PL
Romanian 4 RO
Russian R RU
Slovakian Q SK
Slovenian 5 SL
Turkish T TR
Ukrainian 8 UK
Brazilian Portuguese & Z9
Canadian French 3F
US English ; Z8
Mexican Spanish - Also used 1X
for all other Spanish speaking
countries in Latin America
Serbian d SH
1
* for SAP S/4HANA systems
Indonesian i ID
Malay 7 MS
Simplified Chinese 1 ZH
Traditional Chinese M ZF
Japanese J JA
Korean 3 KO
Thai 2 TH
Hindi HI
Vietnamese VI
Phrase language Language keys for phrase im- Language key presentation in
port phrase administration
Arabic A AR
Hebrew B HE
The settings are divided into separate chapters for the different regulatory data packages.
ProductSafety
File name Description
0-Documentation
ERC_1901_changed_phrases.xlsx Overview of new and revised phrases
Availability of the content reports depends on the li-
censed ERC package:
ERC_ContentReport_ Content Report Inventories Data
Inventories.pdf
ERC_ContentReport_Americas.pdf Content Report American Data
ERC_ContentReport_APJ.pdf Content Report Asia-Pacific Data
ERC_ContentReport_EMEA.pdf Content Report Europe, Middle-East & Africa Data
ERC_ContentReport_SDS- Content Report SDS Authoring Package
Authoring.pdf
ERC_ContentReport_ Content Report Marketability Package
Marketability.pdf
ERC_PS_Data_ReleaseNote_1901.pdf Latest Substance Lists and Reference Data Release
Note for Product Safety
ERC_PS_Training_EN.pdf SAP EHS Regulatory Content Training Workshop Pre-
sentation
ERC_ListOverview_1901.xlsx Overview of lists by region and country and assignment
to properties
TLV_Stmt_of_Position.pdf ACGIH® Statement of Position Regarding the TLVs®
and BEIs®
JSOH_Characteristics_of_OELs_ Japan Society of Occupational Health - Additional infor-
and_Instructions_for_Users.pdf mation regarding OEL values
1-OCC
readme.txt Info file on how to obtain OCC
2-Customizing\Initial
K900546.NE5 Substance Lists and Reference Data - Product Safe-
ty - Basic Customizing transport (User Exit, Data Ori-
gin, Free Text Types, passive Phrase Library, identifier
types) (Unicode)
K902701.NE5 Substance Lists and Reference Data - Product Safety -
Consolidated customizing transport Validity Areas (Uni-
code)
K902917.NE5 Substance Lists and Reference Data - Product Safety
- Consolidated customizing transport (Regulatory Lists
and Literature Sources) (Unicode)
R900546.NE5 Substance Lists and Reference Data - Product Safe-
ty - Basic Customizing transport (User Exit, Data Ori-
gin, Free Text Types, passive Phrase Library, identifier
types) (Unicode)
R902701.NE5 Substance Lists and Reference Data - Product Safety -
Consolidated customizing transport Validity Areas (Uni-
code)
R902917.NE5 Substance Lists and Reference Data - Product Safety
- Consolidated customizing transport (Regulatory Lists
and Literature Sources) (Unicode)
3-Phrases
1_erc_1901_unicode.DAT Unicode phrase import file (all languages)
2_erc_1901_usenglish_unicode.DAT Unicode Phrase import file US English (only import if
you use Z8 for US English)
3_erc_1901_brazilian_unicode.DAT Unicode Phrase import file Brazilian Portuguese (only
import if you use Z9 for Brazilian Portuguese)
4_erc_1901_pset_unicode.DAT Unicode phrase set assignment import file
4-Database
ERC_PS_<Region>_1901.exe Substance Lists and Reference Data - Product Safety -
Database setup/update program
5-Mapping
td_cleo.mdb Substance Lists and Reference Data - Product Safety -
Mapping Database
6-UpdateTools
erc_new_group_assignments_ Update file to create hit list substances with new group
1901.txt assignments
ERC_simulation.xlt Template for simulation (MS Excel 97- 2003)
ERC_simulation.xltm Template for simulation (MS Excel 2007)
erc_update_1901.txt Update file to create hit list of changed list substances
The Substance Lists and Reference Data installation package for Dangerous Goods includes
the following files:
Caution
For system releases older than ERP 6.0 use transports and mapping database without
pack data only because structures for those additional data are not available in your
system.
You might use the correct mapping database and rename this one in TD_CLEO_DG.mdb.
The settings are grouped according to the respective rule set packages.
comp
GWPO
HDCOMP
HHAZ
RespiratoryProtection
The settings for the rule sets and sub rule sets are:
Comp
Value 355
GWPO
HDCOMP
HHAZ
RespirationProtection
GS_BASE_1_1
comp
GWPO
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_GWPO
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_GWPO
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
HDCOMP
HHAZ
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_HHAZ
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_HHAZ
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
RespirationProtection
Source
Data Origin
ZEXP_COMP Composition
ZEXP_GWPO Global Warming Potential
ZEXP_HDCMP Hazardous Decomposition Products
ZEXP_HHAZ Health Hazard
ZEXP_RESPR Respiratory Protection
GHS
Hazcomp GHS
GHS
Hazcomp GHS
GS_BASE_1_1
GS_PHYSCHEM_1_2
GS_IDENT
GHS_SUB_PB2009_2_7
GHS_SUB_PB2011_2_1
GHS_SUB_PB2013_1_8
GHS_SUB_PB2017_1_0
Name GHS_SUB_PB2017_1_0
Rule File GHS_sub_pb2017_V1-0.ruc
GHS_EXPL_2_4
GHS_LABEL_2_0
GHS_PURE_1_4
GHS
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_GHS
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_GHS
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
Hazcomp GHS
Source
Data Origin
Validity Area
PK HC_GHS - Pakistan
QA HC_GHS - Qatar
SA HC_GHS - Saudi Arabia
LK HC_GHS - Sri Lanka
AE HC_GHS - United Arab Emirates
UY HC_GHS - Uruguay
HK HC_GHS - Hong Kong
MO HC_GHS - Macao
Regulatory List
Dapec
GHS EU
File name Description
GHS_EU_1810.ruc Rule File
GHS_EU_1810.mdb Mapping Database
GHS_EU_externvalues.mdb External Database
GHS__global_externvalues.mdb External Database used by all GHS rule sets
GS_ident_externvalues.mdb the external database
GS_ident_externvalues.mdb must be located
in the same directory
GHS_sub_pb2013_V1-8.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS_label_V2-02.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS_pure_V1-42.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS_expl_V2-4.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GS_base_V1-11.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GS_physchem_V1-22.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS_EU__HISTORY.mdb database for the documentation of the
changes in the mapping database and the ex-
ternal database
GHS__global_externvalues__HISTORY.mdb database for the documentation of the
changes in the global external database (used
by all GHS rule sets)
ReleaseNote_EMEA_1810.pdf Release Note
GHS_EU_1810.pdf Functional Description
GHS RU
File name Description
GHS_RU_1810.ruc Rule File
GHS_RU_1810.mdb Mapping Database
GHS_RU_externvalues.mdb External Database
GHS__global_externvalues.mdb External Database used by all GHS rule sets
GS_ident_externvalues.mdb the external database
GS_ident_externvalues.mdb must be located
in the same directory
GHS_sub_pb2011_V2-1.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS_label_V2-02.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GHS TR
EU to GHS
HazardComp EU
RS RestSub
HazardComp EMEA
HazardComp CIS
HazardComp TR
CLNOT
CMR EU
Detergents
ICPE
Maladies Professionelles
MAL Code
Medical Surveillance
NL GAM
PIC EU
RegInfo AL
RegInfo CH
RegInfo CZ
RegInfo DE
RegInfo DK
RegInfo HU
RegInfo IT
RegInfo LV
RegInfo NL
RegInfo PL
RegInfo RO
RegInfo RS
RegInfo SE
RegInfo SI
RegInfo TR
Seveso III
StFV
TA Luft
TRGS510
TRGS900
VbF AT
VOC CH
VOC EU
VOC PaintCoat
Youth&Mothers
DAPEC
GHS EU
GHS RU
GHS TR
Name IgnoreWarnings
Value 322
EU to GHS
HazardComp EU
Name ZEXP_RA17
Mapping Database REACH_Annex_XVII_Warnings_1810.mdb
Rule File REACH_Annex_XVII_Warnings_1810.ruc
Additional Settings
Name IgnoreWarnings
Value 322
RS RestSub
HazardComp EMEA
HazardComp CIS
HazardComp TR
CLNOT
CMR EU
Detergents
ICPE
MAL Code
Maladies Professionnelles
Medical Surveillance
NL GAM
PIC EU
Name IgnoreWarnings
Value 322
RegInfo AL
RegInfo CH
RegInfo CZ
RegInfo DE
RegInfo DK
Additional Settings
Name IgnoreWarnings
Value 322
RegInfo HU
RegInfo IT
RegInfo LV
RegInfo NL
RegInfo PL
RegInfo RO
RegInfo RS
RegInfo SE
RegInfo SI
Additional Settings
Name IgnoreWarnings
Value 322
RegInfo TR
Seveso III
StFV
TA Luft
TRGS510
Name ZEXP_TR510
Mapping Database TRGS510_1810.mdb
Rule File TRGS510_1810.ruc
Additional Settings
Name IgnoreWarnings
Value 322
TRGS900
VbF AT
VOC CH
VOC EU
Additional Settings
Name IgnoreWarnings
Value 322
VOC PaintCoat
Youth&Mothers
LCID
GS_BASE_1_1
GS_PHYSCHEM_1_2
GS_IDENT
COMP_LEC50
GHS_SUB_PB2009_2_7
GHS_SUB_PB2013_1_8
GHS_EXPL_2_4
Name GHS_EXPL_2_4
Rule File GHS_expl_V2-4.ruc
GHS_LABEL_2_0
GHS_PURE_1_4
Dapec
GHS EU
GHS RU
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA RU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_GHSRU
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_GHSRU
EXPERT_WRITE_VALIDITY_AREA RU
GHS TR
EU to GHS
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_EU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RTGHS
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RTGHS
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
HazardComp EU
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA TR
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_KK17
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_KK17
EXPERT_WRITE_VALIDITY_AREA TR
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_EU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RA17
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RA17
EXPERT_WRITE_VALIDITY_AREA REG_EU
RS RestSub
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA RS
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RSRST
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RSRST
EXPERT_WRITE_VALIDITY_AREA RS
HazardComp EMEA
HazardComp CIS
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_HCCIS
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_HC_RU
EXPERT_WRITE_VALIDITY_AREA RU
HazardComp TR
CLNOT
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_EU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_CLNOT
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_CLNOT
EXPERT_WRITE_VALIDITY_AREA REG_EU
CMR EU
Detergents
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_EU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_DETR
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_DETR
EXPERT_WRITE_VALIDITY_AREA REG_EU
ICPE
TRGS510
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA DE
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_TR510
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_LGK
EXPERT_WRITE_VALIDITY_AREA DE
MAL Code
Maladies Professionnelles
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA FR
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_F_MP
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_F_MP
EXPERT_WRITE_VALIDITY_AREA FR
Medical Surveillance
NL GAM
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA NL
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_NLGAM
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_NLGAM
EXPERT_WRITE_VALIDITY_AREA NL
PIC EU
RegInfo AL
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA AL
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_AL
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_AL
EXPERT_WRITE_VALIDITY_AREA AL
RegInfo CH
RegInfo CZ
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA CZ
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_CZ
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_CZ
EXPERT_WRITE_VALIDITY_AREA CZ
RegInfo DE
RegInfo DK
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA DK
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_DK
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_DK
EXPERT_WRITE_VALIDITY_AREA DK
RegInfo HU
RegInfo IT
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA IT
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_IT
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_IT
EXPERT_WRITE_VALIDITY_AREA IT
RegInfo LV
RegInfo NL
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA NL
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_NL
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_NL
EXPERT_WRITE_VALIDITY_AREA NL
RegInfo PL
RegInfo RO
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA RO
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_RO
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_RO
EXPERT_WRITE_VALIDITY_AREA RO
RegInfo RS
RegInfo SE
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA SE
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_SE
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_SE
EXPERT_WRITE_VALIDITY_AREA SE
RegInfo SI
RegInfo TR
EXPERT_COMMIT_MODE D
EXPERT_DESTINATION EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA TR
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_RI_TR
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_RI_TR
EXPERT_WRITE_VALIDITY_AREA TR
Seveso III
StFV
TA Luft
EXPERT_WRITE_VALIDITY_AREA DE
TRGS 900
VbF AT
EXPERT_WRITE_VALIDITY_AREA AT
VOC CH
VOC EU
EXPERT_WRITE_VALIDITY_AREA REG_EU
VOC PaintCoat
WGK
EXPERT_RULE_SET ZEXP_WGK
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_WGK
EXPERT_WRITE_VALIDITY_AREA DE
EXPERT_WRITE_USAGE_1 PUBLIC/AT
Youth&Mothers
LCID
EXPERT_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_EU
EXPERT_RES_BY_SRSID_OWNID_FLG X
EXPERT_RULE_SET ZEXP_LCID
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_LCID
EXPERT_WRITE_VALIDITY_AREA REG_EU
Source
Data Origin
Validity Area
Rating
Regulatory List
Identifier NAM
Please note: for NotStat, there are two different variants delivered, ProdComp and StandComp.
Depending on the variant chosen for the installation, the respective files need to be selected.
NotStat
File name Description
NotStat_frame_master_1810.ruc Rule File
NotStat_frame_master_ProdComp_1810.mdb Mapping Database (ProdComp variant)
NotStat_frame_master_StandComp_1810.mdb Mapping Database (StandComp variant)
NotStat_externvalues.mdb External Database
NotStat_1810.ruc sub rule (core logic)
NotStat_sub_TSCA12b_1810.ruc sub rule (TSCA 12b)
NotStat_sub_expl_1810.ruc sub rule (Explanation Component)
GS_ident_externvalues.mdb the external database
GS_ident_externvalues.mdb must be located
in the same directory
GS_base_V1-11.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
GS_ident_V1-0.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
NotStat_frame_master__HISTORY.mdb database for the documentation of the
changes in the mapping database and the ex-
ternal database
ReleaseNote_RegStatus_1810.pdf Release Note
Notstat_1810.pdf Functional Description
RestrictionStatus
File name Description
RestrictionStatus_1810.ruc Rule File
RestrictionStatus_1810.mdb Mapping Database
RestrictionStatus_externvalues.mdb External Database
GS_base_V1-11.ruc sub rule set which must be installed once as a
separate instance on the Expert-Server-PC
RestrictionStatus__HISTORY.mdb database for the documentation of the
changes in the mapping database and the ex-
ternal database
ReleaseNote_RegStatus_1810.pdf Release Note
RestrictionStatus_1810.pdf Functional Description
Please note: for NotStat, there are two different variants delivered, ProdComp and StandComp.
Depending on the variant chosen for the installation, the respective files need to be selected.
NotStat
RestrictionStatus
GS_BASE_1_1
GS_IDENT
NOTSTAT_SUB_1810
Name NOTSTAT_SUB_1810
Rule File NotStat_1810.ruc
NOTSTAT_SUB_TSCA12B_1810
NOTSTAT_SUB_EXPL_1810
NotStat
RestrictionStatus
Source
Data Origin
Rating
DangGoods
Please note: there are two different variants of the DangGoods rule set available: global and
local. Depending on your license you may receive different files for the main rule DangGoods,
which are both indicated below separated by slashes. In such cases the delivered files have
to be chosen respectively.
DangGoods
GS_BASE_1_1
GS_PHYSCHEM_1_2
GS_IDENT
DG_SUB_1810
GHS_SUB_PB2017_1_0
DG_SUB_GAS_1810
DG_RQ_1810
DangGoods
EXPERT_WRITE_OWNER
EXPERT_WRITE_RATING PUBLIC
EXPERT_WRITE_SOURCE_ID ZEXP_DG
EXPERT_WRITE_VALIDITY_AREA REG_WORLD
Source
Data Origin
Identifier NAM
MSDSMaker
MSDSMaker
GS_BASE_1_1
GS_PHYSCHEM_1_2
MSDSRULE_SUB_4_1
Name MSDSRULE_SUB_4_1
Rule File MSDSRule_sub_V4-1.ruc
MSDSMaker
Source
Data Origin
IDListing ZISIEU1050
IDList SDS EU Identifiers
IDListPos 1 1 1 1 1
IDListPrio 1 2 3 4 5
IDCategory NAM NAM NAM NAM NAM
IDType RCS ANNEXI IUPAC CAS SYN
IDListing ZISIEU1051
IDList SDS EU Identifiers
IDListPos 1
IDListPrio 1
IDCategory NUM
IDType CAS
IDListing D_ESC_SUB
IDList Substance Name for ESCom
IDListPos 1 1 1
IDListPrio 1 2 3
IDCategory NAM NAM NAM
IDListing D_ESC_EC
IDList EC Number for ESCom
IDListPos 1 1 1 1
IDListPrio 1 2 3 4
IDCategory NUM NUM NUM NUM
IDType EC EINECS ELINCS NLP
The WWI template for the annex to the European eSDS was completely remodeled with ERC
2015-2 in order to reflect the ESComXML Format V2.0 as published by CEFIC.
EHS properties and characteristics, phrases and phrase-sets as well as the template have
been adapted requiring a new data maintenance after ERC 2015-1 for a proper output of the
eSDS. Details can be found in the documentation (SDS_XXXX_EU_Specification.pdf, where
XXXX is the current release).
Note that the adaptation to the ESComXML Format V2.0 that is being introduced with ERC
2015-2 refers only to the content (ERC) and apart from the EHS standard properties not to
the EHS system itself, i.e. the import and export of xml-files to and from EHS as well as data
migration from old properties to the new properties and characteristics is not in scope for SAP
EHS Regulatory Content and therefore not covered by this document.
General information on the Exposure Scenario Management can be found in the SAP applica-
tion help (http://help.sap.com/) for Exposure Scenario Management (EHS-SAF-ESM). Partic-
ularly helpful in connection to the template will also be the “Structure of Exposure Scenarios”.
The use of the European WWI templates for the eSDS requires several prerequisites:
• SAP Note 2052892 - Solution package: Output exposure scenarios on EU safety data
sheets. An important prerequisite hereby is to assure that the user exits MIC_REG_ST,
ES_CS_INCL, and SUB_FOR_ES as well as the report symbols E_ES_STAT1,
E_ES_STAT2, E_ES_FILT, and the environment parameters E_ES_STAT1_COMPARE and
E_ES_STAT2_COMPARE are created/available on the EHS system as described in the SAP
Note.
• The identification types ES_UUID, ES_DT_STMP, and CS_UUID (Identification Cat. NUM)
are needed because they are used within the WWI template. Make sure these Identification
types are available in the EHS system. See also IMG activity Environment, Health and Safety
- -> Basic Data and Tools - -> Specification Management - -> Specification Master - -> Check
Identification Types. Within SAP ERP 6.0 EhP 7 these identification types are available by
default.
• The identification listings D_ESC_SUB and D_ESC_EC need to be available. For the default
settings please refer to the tables above.
• By default, it is recommended to set phrase keys for the two environment parameters
E_ES_STAT1_COMPARE and E_ES_STAT2_COMPARE, e.g. CUST-H02.00100034 and
CUST-H01.00400017, respectively. This avoids warning messages during report genera-
tion for system configurations that allow detailed error analysis, e.g. when the environment
parameter REPORT_GENERATION_PROTOCOL is set to "X". Details on the functionality
around the two aforementioned environment parameters can be found in the SDS Template
Documentation.
The data maintenance concept is explained in the SDS template documentation. Note that
the ESCom phrases are technically provided as a separate phrase group (ESCOM) based on
ESCom Phrase Catalogue V2.0 by CEFIC. Updates to this separate phrase group are sched-
uled in line with officially published new versions of the ESCom Phrase Catalogue. Desired
changes have therefore to be addressed directly to the ESCom phrases group.
I P
Identification listings Phrase catalogue, 29, 56, 152
Setup, 133, 133, 225 CED, 29
Identifier types, 60, 176 Substance lists and reference data, 55
Substance lists and reference data, 60 Phrase sets, 14
Import, 132 Allocation, 14, 142
Merge, 32, 76, 156 Phrase set assignment, 34, 78, 158
Phrases, cg31, 31, 74, 154 Phrase Variants
Report templates, 135, 226 Creation, 162
Transport, stms, 12, 132, 139 Phrases, 26
Appendix, 239
L Check Implementation, 37
Language keys Checklist, 37
Implementation, 153 Combine/Retire, 160
Literature source, 59, 116, 175 File overview, 29
Expert Rules, 116 General Information, 26
Substance lists and reference data, 59 General Settings, 240
Log files, Exp-log, RFC-log, 220 Language keys, 246
Language/Codepages, 244
M Name spaces, 241
Mapping database Phrase groups, 240
Cache, 82, 183 Implementation, 29
MS Access, 81 Import, 31, 74
Setup, 82 Individual changes, 36, 37
MSDS Report Template, 130, 131, 132 Language/Codepage/Font, 27
EU Prerequisites, 26
File Overview, 337 Proposal, 28
Europe, 337 Standard, 239
Customizing, 343 File Overview, 239
Generation variant, 345 Structure, 26
General Information, 130 Substance lists and reference data, 73
Implementation, 132, 137 Property Tree, 9
Checklist, 137 Check Implementation, 24
Import, 135 Checklist, 24
Prerequisites, 130 File Overview, 10
Multi Rule Call, 115 File overview, 234
General Information, 9
N Implementation, 10
Number ranges, 56, 153 Package overview, 235
Prerequisites, 9
O
OCC, 41, 41 R
Download, 42 Regulatory Data, 39
Filter, Regulatory List, 94 Check Implementation, 95
Installation, 42, 162 Checklist, 95, 96, 96
Open Content Connector, 42 Dangerous Goods, 251, 255
Customizing, 255 V
File overview, 251, 255 Validity area, 67, 71, 179
User exit settings, 254 Value Assignment Rating, 119, 120, 206
File overview, 41
Implementation, 41 W
Product Safety, 249
Windows Service, EHS Expert Server, 107,
Customizing, 251
204
User exit settings, 250
WWI Symbol, 17
ProductSafety
Generation, 17, 145
File Overview, 249
Regulatory lists, 58, 118, 175
Expert Rules, 117
Substance lists and reference data, 58
RFC connection, 43, 43, 99, 99, 163
Expert Rules, 99
Test, 46, 103, 166
S
SAP Setup Tool, 207
SAPRFC.INI, 106, 202
Secondary data, 216
Setup, EHS Expert, 199
Simulation Tool, 84, 185
Substance lists and reference data
Adjustment, 85
Mapping, 90
OCC, 85
User exit, 88
General Information, 39
Update, simulation, hit list, 193
T
Table Based Value Assignment, 18, 18, 146
Templates, 23
Property tree, 24, 152
Transports (see Import)
U
Upload files
Expert rules, EHS Expert server, 121, 213
Phrases, 30, 74, 134, 139
Property tree, 11, 138
UPO, 218
User Defined Dangerous Goods Texts, 119,
206
Expert Rules, 119
User Defined Text Types, 57, 117, 117, 174
OCCUNQID, NOL, Free text, 57
User Exit, 47, 173
Expert Rules, 109
Explanation component, 48, 109, 167
Search functionality, 181