2.0 Business Process

Capture the business process that the application supports . This can be describe through a process diagram or a business capability model

Reporting

Queries End User Documentation

3.0 Application Feature Overview

Information about the existent Workbooks and the respective BW queries.

4.0 Functional Specification

4.1 General Data/Calculations 

This section will approach the concepts/definitions that will be used in all the reports and required to understand the data from the reports.

Could be specific fields, closing activities, additional information to work and understand the reports.

Data Flow

Datasources : 

• DTS_EHS_ESTDH (EHS: Report Header): extracts data from table ESTDH via the Function Module Z_WBW_DTS_EHS_ESTDH. The date of status change ZREPRDAT is obtained by look up in table DRAP.

Master Data dataflow

Specifications (0EHS_SPEC):

Attributes:

0EHS_SPEC attributes are loading from the standard datasource 0EHS_SPEC_ATTR.

The following zones are updated by the customer exit:

• ZZIDTYPE = ESTRI-idtype for ESTRI-langu = "EN". (first value)
• ZZIDCAT = ESTRI-idcat for ESTRI-langu = "EN". (first value)
• ZZNUNCAS = ESTRI-ident for ESTRI-idtype= "NUM", ESTRI-idcat="CAS" and  ESTRI-langu = "".
• ZZNANINT = ESTRI-ident for ESTRI-idtype= "NAM", ESTRI-idcat="Z_INTERNAL" and  ESTRI-langu = "".
• ZZNUNCE = ESTRI-ident for ESTRI-idtype= "NUM", ESTRI-idcat="EINECS" and  ESTRI-langu = "" or for ESTRI-idtype= "NUM", ESTRI-idcat=" CE" and  ESTRI-langu = "" or for ESTRIidtype= "NUM", ESTRI-idcat="Z_LISTNUM" and  ESTRI-langu = "".
• ZZNANPLC =  ESTRI-ident for ESTRI-idtype= "NAM", ESTRI-idcat="Z_PLC" and  ESTRI-langu = "".
• ZZOWNER =   ESTRI-ident for ESTRI-idtype= "NAM", ESTRI-idcat="Z_OWNER" and  ESTRI-langu = "".
• ZZPORTFO =   ESTRI-ident for ESTRI-idtype= "NUM", ESTRI-idcat="Z_PORTFO" and  ESTRI-langu = "".
• ZZOBSFLG = "X" if:
        - ESTRI-ident = "OBSOLETE" for ESTRI-idtype= "NAM", ESTRI-idcat="Z_PLC" and  ESTRI-langu = "".
        - ESTRI-ident = " *OBS*" for ESTRI-idtype= "NAM", ESTRI-idcat="PROD" and  ESTRI-langu = "" or "E".
• ZZCRDAT = ESTRH-CRDAT.
  
  

Phrases extraction (texts of the classes characteristics) :

One datasource DTS_ZBW_ESTPP is used to update the texts of the EHS properties. The InfoObjects concerned are:

• C_OLDVAL "Old value"
• C_NEWVAL "New value"
• C_EHSRMK "Remarks" (do not concern this application)
• C_EXREASN "Reason of exemption" (do not concern this application)
• C_NOTEXR "Reason of notif exemption" (do not concern this application)
• C_TYPEDOSS "Type of dossier" (do not concern this application)
• C_USAGEJP "Product Usage Code" (do not concern this application)

The texts of the InfoObjects are updated only if the SID already exists.

The datasource DTS_ZBW_ESTPP is based on the view ZBW_ESTPP between ESTPH (EHS: Phrase Header) and ESTPP (EHS: Phrase Item).

It is restricted to the customer phrase library (ESTPH-catpin= "CUST") and to english texts (ESTPP-langu = "E"). 

Characteristic (C_ATWRT)

Attributes:

C_ATWRT attributes are loading from a flat file (DTS_C_ATWRT_FF).

This loading is not scheduled.

The file contains 2 attributes :

• Magnitude Geographie / Zone (C_ZONE): it contains the zone (AP, EU, LA, NA, WW) used for the Assessment report (first tab).
• Assessment report flag (C_ASSRFLG): "X" if the characteristic must be included in the Assessment report.

Flat file directory: https://drive.google.com/open?id=0B03hryo6pwqdbXhJd1VhVXJBbW8

Updated by EHS admin or IT.

Value Assignment Type (CLASS) (C_ESTCAT):

Attributes:

C_ATWRT attributes are loading from a flat file (DTS_C_ESTCAT_FF).

The file loading is not scheduled.

The file contains 3 attributes :

• Magnitude Geographie / Zone (C_ZONE): it contains the zone (AP, EU, LA, NA, WW) used for the Assessment report (first tab) for the modification type "Delete" when the characteristic value is empty.
• Assessment report flag (C_ASSRFLG): "X" if the characteristic must be included in the Assessment report.
• IH Report flag (C_IHFLG): "X" if the characteristic must be included in the IH report.

Flat file directory: https://drive.google.com/open?id=0B03hryo6pwqdbXhJd1VhVXJBbW8

Updated by EHS admin or IT.

Report Generation Variant (C_SBGVID)

Attributes:

C_SBGVID attributes are loading from a flat file (DTS_C_SBGVID_ATTR).

The file loading is not scheduled.

The file contains 2 attributes :

• Magnitude Geographie / Zone (C_ZONE): it contains the zone (AP, EU, LA, NA, WW) used for the Documents generation report.
• Report Type (C_DREPTYP): it contains the doc type (EU Label, certificate, TDS,...) used for the Documents generation report.

Flat file directory: https://drive.google.com/open?id=0B03hryo6pwqdbXhJd1VhVXJBbW8

Updated by EHS admin or IT.

Partner Email information : 

GDPR

The Partner's Email information come from ADR6 table (stored in DSO  DPEHRS07 from WP1 and  DPEHRS08 from PF1), this information is filled only for EHS Partners.

The information is filled by lookup in Report Shipping flow between the Propagation and Business Layer (DBEHRS01 on WP1 and DBEHRS02 on PF1).

The Logic used in the lookup is the following : 

• We read KNVK information stored in DSO  DPEHRS05, to take the Partner information with the condition : CVDDH Receip ID = KNKV Contact Personn.
• The corresponding KNVK lines are used tu read data from ADR6 table with the following condition : 
  • IF KNVK Person Number = ADR6 Person Number AND KNVK Adress Number = ADR6 Adress Number  → Email information filling
  • Else : KNVK Person Number = ADR6 Person Number → Email information filling
  • Else KNVK Adress Number = ADR6 Adress Number  → Email information filling
    

The information is stored in the BW targets below : so all queries created on the BW targets below could integrate the email address data

MVEHRS01 Report Shipping Multi

CREHRS02 Repport Shipping Cube (Solvay)

DBEHRS02  Report Shipping business layer (Solvay)

CREHRS01 Repport Shipping Cube (Rhodia)

DBEHRS01 Report Shipping business layer (Rhodia)

The field impacted is C_EMAILID E-Mail Address

This development was  done in the scope of the following of SDS reports (Safety Data Sheet) . The report are mandatory in the REACH program (Europeen reglementation) 

SDS reports are  produced either sent to customer legal provision to customer who purchased Solvay products+ we must send the SDS for all the major changes for all the buyer customers in the last 12 months.

The GBU can used the BW report or directy on the ECC system in the mail error address generated each time the sending to the customer is not working, BW reports provide the mail of the customer. (

from PF1 system is customer Sold to and WP1 customer Ship to)

Dependencies with other applications

DSO DPEHKP01 and DBEHAD02 are used for the RCS KPI application (EHS KPI).

Data loadings

Info providers and objects loaded

Main Process Chains

4.2 Process Detail 

4.2.1.  Report/Process Definition 

This section represents the process with detail information for the application. Can include specific or special cases, complex logics , calculations, flows, among others.

Main queries

All reports are available via workbooks published in the Roles menu.

Role menu "EHS Reporting - ADMIN Reports" (ZR_RCS_CA_M51)

• Assessment Report

When modifying data in the Pure Substances, it may have an impact on the Safety Data Sheet.
In order to simplify the communication process between the HazCom team and the SDS Writers, a report has been designed in BW that 
1) lists in the first tab the changes made to the Pure Substances. A change can be a deletion, an insertion or an update (in which case the old and new value are displayed)
2) lists in the following tabs all the products that contain these Pure Substances and at which concentration AND that have a released SDS in the zone
Then the Zone SDS Writer can easily identify which products may be impacted by the change and if the SDS needs to be revised accordingly.
This report is only available to the Admin team, it will be sent to the SDS Writers when needed.

 Tab 1:
BEx Query = BW - EHS - Assesment Report (Core Query) (BW_QRY_DBEHS001_0001)
List of EHS classes and characteristics displayed in the report are filtered using the attributes C_ATWRT__C_ASSRFLG and C_ESTCAT__C_ASSRFLG.
 
 Tab 2: 
BEx Query = BW - EHS - Product List (Core Query) (BW_QRY_DBEHS002_0001)
Exception aggregation "First value" for the ratio "Substance % in Material" for the Ref. Characteristic "C_SBGVID".
Filter on substances (C_SPEC2) : replacement path on query BW_QRY_DBEHS001_0001

• Shared Pure Sub
  

 The aim of this report is to see which Authorization group are using which Pure Sub in their Prod com.

The report is based on the Legal and Standard compositions of the Prod com. The Pure substances in the compositions are displayed by the "general" authorization groups of the Prod com.

The ratio "NB Authorization Group" count the number of times that a distinct "General" Authorization group uses the Pure Sub.

BEx Query = EHS - Shared Pure Sub (BW_QRY_MVEHAD01_0001)

Exception Aggregation "Count for all detailed values" for the ratio "NB Authorization Group" for the Ref. Characteristic "C_EHSAUTG".

• Pure Sub with Revision Document

 The aim of this report is to see which Pure Sub have a Revision document in SAP. When a substance has a revision document, some details on the document are displayed.

BEx Query = EHS: Revision Documents (BW_QRY_MVEHAD03_0001)

Role menu "EHS Reporting - SDS Reports" (ZR_RCS_CA_M45)

• EHS Report Generation
  

This report lists all the EHS documents with a released status: SDSs but also labels, transport documents, composition report and certificates.

The status of the product (obsolete or not) is also displayed, which is a good tool to check that we don't keep active documents for obsolete products.

The first tab is a dashboard that gives a summary and the second one provides the details of each document published: which language, created by whom and when. So it is also a good tool to check that there are no SDSs that were created more than 3 years ago.

 Tab 1:
BEx Query = BW - EHS - Spec & reports per GBU (Core Query) (BW_QRY_MVEHDG01_001)
Type of reports is an attribute of the Report generation variant (C_SBGVID__C_DREPTYP).
 
  Tab 2: 
BEx Query = BW - EHS - Report generation (Core Query) (BW_QRY_MVEHDG01_002)
Ratio "Last validation" = current day - generation date.

• SDS Shipping Reporting
  
  

This report lists all the orders that triggered a successful SDS sending or an error. In case of error, the reason is clearly explained: "SDS missing", "Technical error", "Occasional customer".
It is similar to the transaction CVD1 but offers several advantages: search by GBU, easy export to Excel, additionnal data (order number, customer)
Another advantage of having the report in BW is that we included directly some data from the order: especially the order number and customer information. It therefore becomes very easy to check how many SDSs were sent to a particular customer in a given period of time for example.
First tab is an overview page and second tab is a detailed view, where each line corresponds to one sales order.

 Tab 1:
BEx Query = BW – EHS - Report Shipping dashboard(Core Query) (BW_QRY_CREHRS01_001)

  Tab 2: 
BEx Query = BW – EHS - Report Shipping details(Core Query) (BW_QRY_CREHRS01_002)

Broadcast

IH report

• EHS - IH Report Weekly Broadcast (BD_EHS_001):

Technical name of object = BW_QRY_DBEHS001_0002 

This query is similar to "BW - EHS - Assesment Report (Core Query)" (BW_QRY_DBEHS001_0001) (first tab of the workbook Assessment report) but restricted to some Value Assignment Types (flag c_ihflg = "X") and to the changes that occured the previous week.

Format = XLS_XML

Variable Assignment = no filter in the broadcast settings 

Scheduling = every monday at 8:00am

Destination = Sent by email to Nathalie Berne. 

Documents generation

The documents generation report is split into 5 quarterly broadcasts sent by email to the product Stewards 

• Quaterly SDS generation report to Product Stewards - HazCom (BD_EHS_DG_001), 

• Quaterly SDS generation report to Product Stewards - SSP (BD_EHS_DG_002), 

• Quaterly SDS generation report to Prod. Stewards - Polyamide (BD_EHS_DG_003), 

• Quaterly SDS generation report to Prod. Stewards - Novecare (BD_EHS_DG_004),

• Quaterly SDS generation report to Prod. Stewards - Others (BD_EHS_DG_005):

Technical name of object = 7919WZ35DF7VENEQZTYBT0HBH (BW_WBK_EHS_0001). 

It is an Analyser workbook similar to the Analysis workbook  "EHS Report Generation", only the second tab is not based on the same query in order to filter on the reports that were generated before 2 years ago. The workbook is based on the queries "BW - EHS - Spec & reports per GBU (Core Query)" (BW_QRY_MVEHDG01_001) and "BW - EHS - Report generation (Broadcast)" (BW_QRY_MVEHDG01_003). An exception in the query BW_QRY_MVEHDG01_003 highlights the reports generated more than 3 years ago.

Format = XLS

Variable Assignment = filter on a list of Autorization groups (the list is different for each Broadcast)

Scheduling = every quarter, executed via the Process Chain PC_EHS_DG_BCAST_001.

Destination = Sent by email to EHS HazCom support and a list of product stewards (the list is different for each Broadcast)

5.0 Non-functional Descriptions 

5.1 Usability

Usability is about the ease with which a User can learn to start using the solution and the ease with which they can use the system.  In addition to ease of learning and ease of use, usability also includes areas such as ease of recall, error avoidance and handling, accessibility among others e.g., 99% of metadata entry Users who have use the Maintenance Dashboard should be able to change filters, extract etc., when required.  Maintenance data will be centrally stored in the Google Cloud platform, which will be available to other applications e.g., and Dashboards if needed.

5.2 Regulatory Compliance

Software systems must comply with legal and regulatory e.g., GDPR requirements, this can change depending on country, organisation industry and / or region.  The software systems must be secure from unauthorized access.  The Maintenance Dashboard will comply with Solvay’s regulations and compliance e.g., access only granted to authorized Users.

5.3 Security

Security refers to essential aspects that assure a solution and its components will be protected against unauthorized access or malware attacks.  Important considerations related to security aspects of a system are User authentication, User authorization or User access privileges, data theft, malware attacks, data encryption, and maintaining audit trails, e.g., only Users with administrator access shall be able to create new accounts and assign data access privileges to the new accounts e.g.,

• All data will be encrypted in the dashboard
• Only authorised Users / Administrative Users will be able to access data.
• Maintenance data will be split between either SCO or ECO, and Users will only have authority to one Entity data.

5.4 Performance

Performance defines how fast a software system or a particular section of it responds to certain User actions under a certain workload.  In most cases, this metric explains how long a User must wait before the target operation happens e.g., the page renders, a transaction is processed, etc., given the overall number of Users now.  Performance requirements may describe background processes invisible to Users, e.g., backup and speed of data transfers. 

5.5 Reliability

Reliability is the ability of a solution or its component to perform its required functions without failure under predefined conditions for a specified time / period.  Reliability can possibly be specified in terms of average time system runs before failure occurs, percentage of operations completed successfully within a time / period, maximum acceptable failure probability, or number of failures within a period.  Reliability aspects are in reference to (but not limited to) evaluation of the system to be considered as reliable, classification of reliability defining failures vs. regular failures, and the impact of failure on business operations.  The Maintenance Dashboard will display data from the previous refresh of data.   

5.6 Scalability

Scalability refers to the degree to which a solution can evolve to handle increased amounts of work.  The increased amount of work could be in terms of the user base, transactions, data, network traffic, or other factors e.g., the system should be able to handle an additional load of a maximum of 5,000 Users every month for the next 6 months without any noticeable performance impacts.  

5.7 Compatibility

Interoperability is the degree to which the solution is compatible with other components.  It is a measure of how effectively the system interoperates with other software systems and how easily it integrates with external hardware devices.

Interoperability aspects to be discussed during elicitation are in reference to (but not limited to) software systems to be interfaced with along with data / messages to be exchanged and any standard data formats, hardware components to be integrated with, and any standard communication protocols to be followed e.g., Order Management system will push the order file into a secured file transfer protocol server from where it will be loaded into the system through a daily job.  To guarantee between Google Cloud platform and SAP BW Queries e.g., BW_QRY_MVPMOR01_0002, Solvay has introduced a new tool called Xtract (Xtract).

5.8 Availability

Availability is the degree to which the solution is operable and accessible when required. It is a measure of time during which the system is fully operational e.g., available for use and sometimes included as a Service Level Agreement (SLA) considering its criticality to the business, e.g., the system shall be at least 99% available on weekdays between 09:00 to 18:30 Central European Time (CET).

5.9 Refresh of the Data

Frequency, data, and time of the data refresh in the data product.