Professional Documents
Culture Documents
A.28. SAP EHS Regulatory Content - substance lists and reference data (Product
Safety) Update Data Load ........................................................................................ 107
A.28.1. Review Regulatory Changes ................................................................ 107
A.28.2. Update Cached Data ............................................................................ 108
A.28.3. Review New Filter Settings ................................................................... 108
A.28.4. Hit List of List Substances .................................................................... 108
A.28.4.1. Simulate Data Load ................................................................... 110
A.28.4.2. Analyze Changed Data .............................................................. 111
A.28.4.3. Load Changes to SAP EH&S .................................................... 112
A.29. SAP EHS Regulatory Content - substance lists and reference data (Danger-
ous Goods) Update Data Load ................................................................................. 114
A.29.1. Review Regulatory Changes ................................................................ 114
A.29.2. Update Cached Data ............................................................................ 114
A.29.3. Review New Filter Settings ................................................................... 114
A.29.4. Analyze Changed Data ......................................................................... 114
A.29.5. Load Changes to SAP EH&S ............................................................... 115
A.29.5.1. Manual update load ................................................................... 115
A.29.5.2. Mass Load / Autoload ................................................................ 116
A.30. How to add user-defined DG texts .................................................................. 116
A.31. How to add a value assignment rating ............................................................ 117
A.32. SAP Setup for SAP EHS Regulatory Content Expert Rule Sets ...................... 117
A.32.1. Overview ............................................................................................... 117
A.32.2. Installation on the Test or QA Expert Server ......................................... 122
A.32.3. Installation on the Productive Expert Server ......................................... 123
A.33. How to load rule sets onto the Expert server .................................................. 123
A.34. How to register rule sets ................................................................................. 124
A.35. How to adjust external table values ................................................................ 126
A.36. How to adjust the Group Mapping ................................................................... 127
A.37. How to use the History.mdb ............................................................................ 127
A.38. How to setup identification listings .................................................................. 128
A.39. How to import report templates ....................................................................... 129
A.40. How to create generation variant .................................................................... 129
A.41. How to disclose component names ................................................................. 130
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 the SAP Ad-
ministration manual as a step by step documentation of how to implement SAP EHS Regula-
tory Content.
User of the printed version should refer to the table of contents to find the information 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.
• Update: This chapter provides information about the general prerequisites in order to update
SAP EHS Regulatory Content as well as an update overall procedure.
• Property tree: This part provides a check list of all activities which are necessary to update
the property tree. It also provides information about all relevant files and settings.
• Multilanguage phrase library for hazard communication: This part contains all relevant infor-
mation concerning phrases. It is structured according to the different phrase packages.
• Substance lists and reference data: In this part, guidance is given throughout the process
of updating regulatory data. This part of the documentation provides a collection of all infor-
mation related to current version of regulatory data.
• Expert rules for substance and mixture classification: This section covers all information
necessary for Expert rules. This section contains the release related information for the
Expert rules. The settings are structured according to the rule set packages they belong to
as well as a consolidated overview listing of all licensed packages.
• Material safety data sheet (MSDS) templates: The aim of this part is to provide information
which is relevant to update MSDS Report Templates.
• How To ...: The aim of this section is to provide fast and easy to use advice on how to perform
all necessary actions throughout the process of updating SAP EHS Regulatory Content.
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)
EHS - Release
EHS Expert/OCC
• Current version of EHS Open Content Connector (OCC) and EHS Expert (see SAP note
568302).
• Please check if SAP note 1409995 is implemented to improve handling of identifiers in dif-
ferent languages
EHS WWI
• Current version of WWI
We recommend that you always apply the most recent patch for WWI, regardless of the
Support Package and EH&S version you are using.
Customizing
SAP authorisation
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
1409995 EHS OCC: Using the ISO language code for Unicode data
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
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 update your SAP EHS Regulatory Content
are collected in the content related check lists:
Important
Before starting the update procedure please review the enclosed documentation.
Caution
It might be necessary to upgrade your installation of OCC/Expert or to update your
EHS or to implement SAP notes.
Tip
Collect all transports contained in the update. If you upload all transports at once you
can skip the appropriate upload activities mentioned in the check lists.
In order to make use of the latest Expert Rules, Substance Lists and Regulatory Data the
contents of the latest property tree package 1810 Product Safety and of the other existing
property tree packages have to have been implemented before implementing other content
of the ERC update 1810.
Property tree packages contain everything needed to set up and use the new and enhanced
characteristics and classes/properties 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. More
details about the delivery of property tree enhancements can be found in SAP Note 1761696.
Please read the ReadMe document included in each property tree package carefully BEFORE
starting the implementation of any property tree package!
Detailed information on how to execute the single steps are provided in How-To-documents:
General Information
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.
Detailed information on how to execute the single steps will be provided in this How-To-doc-
uments:
Standard
Based on feedback from our customers that there is no regulatory requirement for SDS in
Filipino, we have decided to stop the support of the Filipino (Tagalog) language. We will no
longer provide new translations into this language as part of our updates nor will we update
the existing translations in the future.
Detailed information on how to execute the single steps will be provided by following the links
in the check list above or in the How-To-documents listed below:
ProductSafety
Note
No actions required for update from version 1810 to 1901.
Dangerous Goods
All steps to import and merge phrases and phrase sets are just necessary if you use packaging
data.
Detailed information on how to execute the single steps will be provided by following the links
in the check list above or in the How-To-documents listed below:
Note
Please choose only one single MDB depending on your application
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.
Detailed information on how to execute the single steps will be provided in these How-To-
documents:
comp
GWPO
HDCOMP
HHAZ
RespiratoryProtection
GHS
Hazcomp GHS
Dapec
GHS EU
GHS RU
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
NotStat
RestrictionStatus
DangGoods
MSDSMaker
Note
The settings on the Expert Server can now be done by using SAP Setup for ERC
Rule Sets. For more details see Readme_SAPSetup_RuleSets.
Alternatively it is possible to maintain the settings manually via the Expert Admin Tool or within
the transaction CGSADM. The settings for unchanged instances are documented in the SAP
EHS Regulatory Content Administration Manual which is also included in the delivery.
Name ZEXP_DETR
Mapping Database Detergents_1810.mdb
Rule File Detergents_1810.ruc
Additional Settings
Name IgnoreWarnings
Value 322
Additional Settings
Name IgnoreWarnings
Value 322
Name IgnoreWarnings
Value 322
Value 322
Name ZEXP_HCGHS
Mapping Database Hazcomp_GHS_1810.mdb
Rule File Hazcomp_GHS_1810.ruc
Additional Settings
Name IgnoreWarnings
Value 322
Value 322
Name ZEXP_SDS
Mapping Database MSDSRule_1810.mdb
Rule File MSDSRule_1810.ruc
Additional Settings
Name IgnoreWarnings
Value 322
Note
The settings for the sub rule set are automatically installed when using SAP Setup
for ERC Rule sets.
In case SAPSetup is not used the below listed settings have to be maintained via the Expert Ad-
min Tool or within the transaction CGSADM for the current release.The settings for unchanged
instances are documented in the SAP EHS Regulatory Content Administration Manual which
is also included in the delivery.
The settings for unchanged instances are documented in the SAP EHS Regulatory Content
Administration Manual which is also included in the delivery.
Detailed information on how to execute the single steps will be provided in this How-To-doc-
uments:
With ERC1810, the following SAP Note have become a prerequisite for the SDS templates.
The recommendations for the setup of Report Generation Variants in comparison to the pre-
vious delivery have been changed for:
SDS_RS: An additional validity area has been added, Sort. 9, ValAreaCat REGION, Val.Area
RS, U. 2, LA EN.
For details please refer to the Report Generation Variant recommendation list RGV_1810_
Configuration.pdf.
Additional settings
Different then for earlier releases, it is recommended to set the two environment param-
eters E_ES_STAT1_COMPARE and E_ES_STAT2_COMPARE to default values of CUST-
H02.00100034 and CUST-H01.00400017, respectively. For earlier releases we recommend-
ed the default setting to leave those parameters empty. The new setting avoids warning mes-
sages during report generation 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.
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.
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
C14K_PHRASECHARACT_CHECK to all characteristics where phrase sets have
been assigned (see transaction CGAB). This enables the system to call an assigned
phrase set in the specification data base. If the phrase set was deleted in the table "Edit
phrase set-attribute assignment" (transaction CGAB) before carrying out this transac-
tion, then the function module C14K_PHRASECHARACT_CHECK is deleted in the
corresponding CHAR 30-characteristic and this characteristic can be filled as a free
text field.
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.
• "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)
•INTERNAL:
Choose "Immediate" or specify a time
SAP CUSTOMER 76 © SAP SE
• Save
How To ...
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.
Note
For installation local administrator rights might be required. Registry settings will be
added under the following paths:
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
INTERNAL: SAP CUSTOMER 87 © SAP SE
How To ...
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_NUM_OF_DEACT_VALUATIONS 1
EXPERT_PARAMETER_CHANGE_MODE S
EXPERT_READ_RATING PUBLIC
EXPERT_READ_VALIDITY_AREA REG_WORLD
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
In this IMG activity, you can define function modules for the user exits of the SAP component
Environment, Health and Safety for the following areas: Type SUB_SEDACA Secondary Data
Determination
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.
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.
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.
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 A.24, “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
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"
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).
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
• In column "Mode" each record is marked as either new, changed or inactivated
• Filter options for all fields, e.g. by property or regulatory list
• New records are highlighted bold red (complete line)
• In changed records, only important changes are highlighted bold red
• Inactivated records are highlighted in italics (complete line)
• In the top right corner a summary is given (number of substances and records)
• 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:
There are two different options to load new and changed data into your existing list substances
in SAP EH&S.
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.28.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.28.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.
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.
• Table Customer UN Numbers allows you to maintain a list of UN numbers you are using
• Query Impact Analysis gives you an overview which of the UN numbers currently in use are
affected by the changes if the table Customer UN Numbers is maintained
A number of classification versions are omitted in the updated regulations and now we deleted
all the variants in our database. In all the cases you are using these deleted variants it is
necessary to replace the listed substance now.
You can search Table Changes or the result of the impact analysis for all deleted variants.
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.
With this release we added the new regulation ADN and removed ADNR. So please revise all
your specifications affected. Load a new ADN instance and delete the ADNR instance.
We harmonized the unique IDs of RID and ADN instances with ADR in this release. It might
happen that OCC during load do not recognize the present RID instance and a new one is
loaded additionally. In this cases you should delete the old RID instance, so that the specifica-
tion do not show two instances of the same regulation.
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.
->Utilities -> Secondary Data -> Determination -> CLEO Dangerous Goods
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 "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.
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.
->Utilities -> Secondary Data -> Determination -> CLEO Dangerous Goods
4. Select a substance from the following screen and press "Set Filters"
5. Set data options "Load Changes Only" and "Use Substance Groups"
6. Select "Apply to All Substances"
7. Select the "Autoload" button
Note
If a new variant or regulation was assigned to a UN number, the new data 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 expert.
If new or changed data becomes available within an existing group/DG variant, your
choices in the past decide if the data will be loaded::
• If a group/variant was loaded in the past, all new and changed data will be loaded
as well.
• If a group/variant was set to "no load" in the past, new and changed data will be
ignored and not loaded.
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:
• Specify the value assignment type the profile shall be used with (standard is
SAP_EHS_1022_042 provided with the EHS standard property tree)
• (optional) Select the function module used for output conditions
(DG50_PRICOND_USRDEFTXT is delivered with the standard)
• Save your settings
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.32.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.
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.
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 133 © 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).