CTG 10B Documentation Reference Manual

Compliance &
Transparency – Gas
CTG 10B
Documentation
Reference Manual
CSP03 v00
31.08.2014
Notes
© Copyright 2014 QuantityWare GmbH. All rights reserved.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services
mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in
Germany and in several other countries all over the world. All other product and service names mentioned
are the trademarks of their respective companies.
Microsoft, Windows, SQL-Server, Powerpoint and Outlook are registered trademarks of Microsoft
Corporation.
These materials and the information therein are subject to change without notice. These materials are
provided by the company QuantityWare GmbH for informational purposes only. There is no implied
representation or warranty of any kind, and QuantityWare GmbH shall not be liable for errors or omissions
with respect to the materials provided. The only warranties for the products and services of QuantityWare
GmbH are those set forth in the express warranty statements accompanying such products and services, if
any. No statement within this document should be construed as constituting an additional warranty.
CTG 10B Reference Manual – CSP03 v00
ii
Contents
COMPLIANCE & TRANSPARENCY – GAS CTG 10B .................................................................. I
DOCUMENTATION REFERENCE MANUAL CSP03 V00 ............................................................ I
Notes .................................................................................................................................ii
Contents ........................................................................................................................... iii
Version History .................................................................................................................vi
1
Introduction .......................................................................................................... 1
2
Documentation overview ..................................................................................... 2
3
The Gas Measurement Cockpit ........................................................................... 6
4
3.1
Introduction ................................................................................................. 6
3.2
Structure of the Gas Measurement Cockpit (GMC) ................................... 7
3.3
GMC Methodology .................................................................................... 15
3.4
GMC Tab strip details ............................................................................... 15
3.5
GMC Documentation ................................................................................ 24
3.6
Summary .................................................................................................. 24
Cockpit Test Scenarios ...................................................................................... 25
4.1
Introduction ............................................................................................... 25
4.2
Test Scenario – Definition......................................................................... 26
4.3
Test Scenario – Delivery........................................................................... 27
4.4
Access to the Customer Test Scenario Tool ............................................ 28
4.5
The Customer Test Scenario Tool ............................................................ 29
4.6
Running customer specific test scenarios ................................................ 38
4.7
Summary .................................................................................................. 39
CTG 10B Reference Manual – CSP03 v00
iii
5
6
7
8
9
CTG Configuration Template ............................................................................. 40
5.1
Introduction ............................................................................................... 40
5.2
Unit of measure definitions – SAP tables ................................................. 41
5.3
Accessing the UoM configuration data – Gas Measurement Cockpit ...... 58
5.4
Quantity conversion configuration – SAP tables ...................................... 61
5.5
Conversion group mapping to bulk oil & gas products ............................. 63
5.6
Quantity conversion configuration – QuantityWare tables ....................... 64
5.7
QuantityWare IMG access ........................................................................ 67
5.8
Summary .................................................................................................. 68
SAP QCI Enhancements of Legacy Configurations .......................................... 69
6.1
Introduction ............................................................................................... 69
6.2
Parameter range check settings ............................................................... 69
6.3
Conversion group documentation ............................................................. 72
6.4
Quantity value synchronization ................................................................. 73
6.5
Summary .................................................................................................. 73
CTG Customizing Transactions ......................................................................... 74
7.1
Introduction ............................................................................................... 74
7.2
QuantityWare Customizing Transactions ................................................. 74
7.3
Summary .................................................................................................. 76
Natural Gas Components – Physical Properties Data ...................................... 77
8.1
Introduction ............................................................................................... 77
8.2
Physical properties - data set description ................................................. 78
8.3
Fundamental constants and properties of dry air ..................................... 83
8.4
Tests for physical property data ............................................................... 84
8.5
Summary .................................................................................................. 86
Natural Gas & LNG Measurement ..................................................................... 87
9.1
Introduction ............................................................................................... 87
9.2
Basic definitions of natural gas quantities and measurements ................ 87
9.3
High level description of the basic measurement principles ..................... 92
9.4
Summary .................................................................................................. 95
CTG 10B Reference Manual – CSP03 v00
iv
10
Measurement Cockpit - Security ....................................................................... 96
11
Protection of Intellectual Property ...................................................................... 99
12
Abbreviations ................................................................................................... 102
13
Specific CTG documentation rules .................................................................. 104
14
Basic System Settings ..................................................................................... 105
CTG 10B Reference Manual – CSP03 v00
v
Version History
CSP03 v00
31.08.2014
Initial Release
CTG 10B Reference Manual – CSP03 v00
vi
1
Introduction
CTG (Compliance & Transparency – Gas) is delivered within the Bulk Calculations Solution
(BCS) and activated for implementation and installation test with a license key.
For CTG 10B this document provides:
An overview of all documentation delivered for CTG
Links to related documents
Detailed documentation for specific areas
Read this document and - depending on your project roles - the related documents carefully
before you install QuantityWare CTG 10B or start your CTG 10B implementation project.
This document is constantly updated to reflect all CTG enhancements delivered
with all BCS CSP deliveries. The Release Notes for BCS CSPs can be found
here: http://support.quantityware.com  CTG Documentation 
Documentation Overview
CTG 10B Reference Manual – CSP03 v00
1
2
Documentation overview
The following CTG 10B documents are either published as a chapter of this document, or
available via the published link at one of the sub-sections of http://support.quantityware.com  CTG Documentation:
BCS Technical Installation Documentation (SAP ERP releases 4.72 or ECC 600)
Audience:
SAP basis experts performing the installation
Content:
Describes the technical requirements and procedures to be followed
during the technical installation of the BCS.
Publication:
Separate Document
Direct link:
Technical Installation Documentation - ECC 600
Technical Installation Documentation - 4.72
CTG Project Assessment and Implementation Guidelines (PAIG):
Audience:
Project team lead responsible for CTG implementation & project
members
Content:
Describes a high-level project methodology which enables the
successful design and configuration of quantity conversion solutions
that run in an SAP Oil & Gas ERP system, based upon business
requirements.
Publication:
Separate Document
Direct link:
PAIG
CTG Gas Measurement Cockpit (GMC):
Audience:
CTG implementation project team-lead and project members, as well as
petroleum measurement specialists wishing to use the GMC.
Content:
Describes the GMCs methodology, structure and content.
Publication:
This document
Direct Link:
Chapter 3 The Gas Measurement Cockpit– page 6
CTG 10B Reference Manual – CSP03 v00
2
CTG Cockpit Test Scenarios:
Audience:
CTG implementation project team-lead and project members, as well as
petroleum measurement specialists wishing to use the GMC.
Content:
Describes the theory behind and the definition of, quantity conversion
automated test scenarios.
Publication:
This document
Direct Link:
Chapter 4 Cockpit Test Scenarios - page 25
CTG Configuration Template:
Audience:
CTG project implementation members.
Content:
Lists all QuantityWare CTG 10B template tables and the number of
entries delivered. Explains how to access and analyze the data via the
GMC.
Publication:
This document
Location:
Chapter 5 CTG Configuration Template – page 40
CTG Supported Standards:
Audience:
Project members implementing CTG and petroleum measurement
specialists.
Content:
Lists all measurement standards that are implemented with CTG 10B
and provides detailed technical implementation information.
Publication:
Separate Document
Location:
CTG Supported Standards
CTG SAP QCI Enhancements of Legacy Configurations:
Audience:
Project members implementing CTG
Content:
Describes the functional possibilities provided by QuantityWare for the
SAP QCI, in detail.
Publication:
This document
Location:
Chapter 6 SAP QCI Enhancements of Legacy Configurations – page 69
CTG 10B Reference Manual – CSP03 v00
3
CTG Customizing:
Audience:
Project members implementing CTG
Content:
Describes CTG customizing options which can be accessed from the
GMC.
Publication:
This document
Location:
Chapter 7 CTG Customizing Transactions - page 74
CTG Physical Property Data
Audience:
Project members implementing CTG
Content:
Describes the physical property data for CTG which can be accessed
from the Gas Measurement Cockpit (GMC) in detail.
Publication:
This document
Location:
Chapter 8 Natural Gas Components – Physical Properties Data- page
77
CTG Natural Gas & LNG Measurement:
Audience:
Project members implementing CTG.
Content:
Describes the fundamentals of natural gas and LNG measurements with
respect to quantity conversion calculations.
Publication:
This document
Location:
Chapter 9 Natural Gas & LNG Measurement – page 87
CTG Measurement Cockpit - Security:
Audience:
Project members implementing CTG.
Content:
Lists the QuantityWare single & composite roles delivered with BCS
10B which can be assigned to GMC users.
Publication:
This document
Location:
Chapter 10 Measurement Cockpit - Security – page 96
CTG Protection of Intellectual Property:
Audience:
Project members implementing CTG.
Content:
Describes the QuantityWare Intellectual Property security measures.
Publication:
This document
Location:
Chapter 11 Protection of Intellectual Property– page 99
CTG 10B Reference Manual – CSP03 v00
4
In addition to the above listed documents, QuantityWare publishes CTG notes
which are also an integral part of the CTG documentation.
All code corrections published via Note are included in the immediately
following CSP.
For an overview of Note validity, see section 5 of Note 000029 – “Additional
Installation Information”.
All available notes can be found at http://support.quantityware.com  CTG
Documentation  Section: Notes. The associated files must be downloaded
from the QuantityWare DataLounge: http://datalounge.quantityware.com
CTG 10B Reference Manual – CSP03 v00
5
3
The Gas Measurement Cockpit
3.1
Introduction
The software package CTG 10B is one important part of the overall QuantityWare solution for
the oil industries. The complete solution consists of:
QuantityWare Audit Services
QuantityWare Consulting Services
QuantityWare Software Package
QuantityWare Training Services
QuantityWare Support Services
Information about all services can be found at www.quantityware.com.
The Gas Measurement Cockpit (GMC) is the single access point for measurement specialists
and technical consultants to the QuantityWare CTG solution.
maintain
and
enhance
complex,
measurement
standard
Here you design, monitor,
based
quantity
conversion
implementations that run within the SAP Oil & Gas ERP system. The Gas Measurement Cockpit
(GMC) provides an easy-to-use user interface (UI), which is structured so that measurement
experts and technical consultants can organize their work efficiently.
After you log on to your SAP ERP system, enter transaction code
/n/QTYW/COCKPIT_GAS to launch the Gas Measurement Cockpit (GMC)
Make sure that the required authorization profiles are assigned to your user
The technical installation team has to enter the CTG license via the GMC as
well for the installation and implementation test
CTG 10B Reference Manual – CSP03 v00
6
3.2
Structure of the Gas Measurement Cockpit (GMC)
3.2.1 GMC Overview
The GMC provides five Tab pages:
3.2.1.1 Units of Measurement
Here you define, create, change, display and monitor unit of measurement (UoM) settings.
Detailed documentation of the UoM concepts is provided. You perform natural gas property
conversions between different reference conditions, e.g. heating values or densities. You also
define the UoM compliance settings and prepare the UoM Compliance Analysis in this tab page.
All calculations and results can be easily printed for further processing.
CTG 10B Reference Manual – CSP03 v00
7
3.2.1.2 Print Standards Lists:
Here you display and print lists of physical property data sets, compression factors and LNG
specific data, as well as volume correction factors for NGL. Natural gas and LNG long term
contracts specify detailed calculation procedures and property data to be utilized for custody
transfer, which you monitor and verify here.
CTG 10B Reference Manual – CSP03 v00
8
3.2.1.3 QCI Configuration & Products
Here you display and monitor the QCI conversion group settings for various selection criteria
and control the assignment of your conversion groups to your material/product master data. You
can also “explain” a conversion group definition and print out audit reports for conversion
groups. You can analyze business documents (material documents, physical inventory
documents and deliveries) with respect to the additional quantity conversion values.
CTG 10B Reference Manual – CSP03 v00
9
3.2.1.4 Lab Calculations:
Here you perform (in client 045) natural gas, LNG and LPG/NGL property calculations based on
various measurement standards and on laboratory data; you prepare quantity conversion
default data for goods movement calculations, starting with a sophisticated gas component
analyzer tool.
Test Tools: Here you execute all QuantityWare test reports and your own test scenarios that
ensure the correctness of the quantity conversion implementations in your system (see Chapter:
3.3 GMC Methodology for details).
The tab page that is active when you leave the GMC transaction will be the one you see when
you next use the GMC.
CTG 10B Reference Manual – CSP03 v00
10
3.2.2 GMC Overview - Menus
From the GMC menu you have access via the following menu points to relevant transactions
and information resources:
3.2.2.1 Cockpit
Enter or check the QuantityWare CTG license, read the detailed online documentation,
determine the QuantityWare support package status or navigate to the Petroleum Measurement
Cockpit:
CTG 10B Reference Manual – CSP03 v00
11
3.2.2.2 Goto
Navigate to all QuantityWare customizing transactions and create or change data if the client
settings allow this; fast access to most important customizing transactions is also available:
CTG 10B Reference Manual – CSP03 v00
12
3.2.2.3 Environment
Navigate to related applications like the QuantityWare calculator or the tank management
transaction:
CTG 10B Reference Manual – CSP03 v00
13
3.2.2.4 QuantityWare.com
Navigate to the relevant QuantityWare website pages, e.g. support site ,QuantityWare
DataLounge download site:
CTG 10B Reference Manual – CSP03 v00
14
3.3
GMC Methodology
The five tab strips are organized so that they group complex implementation project sub tasks
into “Task Packages”, as well as organizing regular monitoring and error analysis tasks in a
structured way. The QuantityWare Project Assessment and Implementation Guidelines (PAIG)
Methodology provides the underlying design logic for the GMC. For more details read the
separate PAIG documentation for CTG.
3.4
GMC Tab strip details
3.4.1 Units of Measurement
Correct UoM definitions and intra-conversion factors are the basis of all quantity conversions.
You need to ensure that all UoM are correctly defined. For example, you frequently need to
control whether heating values that you report are accurate, or data from business partners is
consistent with your data. You also need to define whether stock quantities for a specific UoM
are kept within your system:
CTG 10B Reference Manual – CSP03 v00
15
QuantityWare also provides a sophisticated UoM comparison tool allows you to compare UoM
definitions that are delivered in BC sets with UoM definitions in your system clients.
CTG 10B Reference Manual – CSP03 v00
16
The UoM Compliance Analysis is also available in this tab page:
3.4.2 Print Standards Lists
When either adding a new product line or changing conversions for existing products, the
“second task package” is the definition of the correct measurement standard, or several
standards, as well as specific rules which may apply for different countries/business contracts.
You need to compare legacy system results with available standards - a process which is
usually considerably easier when ranges of complex correction factors can be printed. During
general operations, you may also need to explain your conversion results to an independent
CTG 10B Reference Manual – CSP03 v00
17
inspector and thus need to print the relevant data. Basically, four different types of standards
are relevant for your gas quantity conversion configuration, defining:
Standards defining the detailed calculation model
Standards defining correction factors due to pressure and temperature on product volumes
and energies
Standards defining calculations of densities and heating values from composition including
physical property data
Standards defining the conversion factors between UoM of one dimension
CTG 10B Reference Manual – CSP03 v00
18
3.4.3 QCI Configuration & Products
You obtain an overview of the QuantityWare delivered conversion groups, organized via product
groups, and inspect and cross check the settings.
In this example, you display all LNG conversion groups delivered with the QuantityWare CTG
template. From this list, you can directly navigate to all detailed conversion group settings or
print a conversion group explanation statement by clicking on the description of a conversion
group: You may utilize these conversion groups as references as well as for laboratory
calculations in your client 045. You cannot use the template conversion groups for production
calculations with a CTG license.
CTG 10B Reference Manual – CSP03 v00
19
CTG 10B Reference Manual – CSP03 v00
20
3.4.4 Lab Calculations
The basis of all natural gas property calculations is the molar composition of a natural gas or
LNG. Here you enter any molar composition - or analyze composition data from standard
movement default tables - and perform calculations using laboratory data. All data can be
printed out in great detail, ensuring maximum transparency and accuracy of your calculations:
3.4.5 Test Tools
All conversion settings need rigorous testing and quality control. All QuantityWare test reports
can be executed from here. You can also use the QuantityWare test tool to develop your own
test scenarios without any ABAP programming. All your test scenarios can be executed with
one click at any time; you can transport the tests easily within your system landscape, and write
log data of the test execution, thus ensuring compliance and quantity assurance. This brings
CTG 10B Reference Manual – CSP03 v00
21
maximum security to your business operators for their day to day business as well as for your
company profits.
The GMC does not require a separate installation test. It is the central access point to all
QuantityWare test tools that are delivered with CTG 10B. In template client 045 you execute the
QuantityWare installation test as well as the QuantityWare test scenarios to ensure the
correctness of the quantity conversion implementations in your system:
From this tab, you can either:
In client 045 run all available test programs with one click and obtain the test result within
seconds
In client 045 run your selection of QuantityWare test programs which you combine to one
test run
CTG 10B Reference Manual – CSP03 v00
22
Run your own tests scenarios that you have created in house based on your specific
configuration settings (e.g. rounding of UoM)
All test programs contain a listed print out of all tests performed, so that if executed individually,
these lists can be inspected, printed and compared with manually calculated results.
QuantityWare recommends that you create your own customer specific test
scenarios that contain your manually calculated results (cross checked by at
least two experts) and check the system calculation against these results. This
way, a high degree of automation is ensured, as well as system compatibility
with your measurement standards during productive usage.
In all other relevant clients, where the QuantityWare BC set is not activated, you execute your
defined UoM Compliance Analysis test via this tab page, as well as your own test scenarios,
which you define during the CTG 10B implementation:
CTG 10B Reference Manual – CSP03 v00
23
3.5
GMC Documentation
Detailed online documentation is available within the GMC, which explains all measurement
concepts and all available tools.
3.6
Summary
The GMC provides an easy-to-use, structured, single point of access to all parties responsible
for the configuration, control and development of quantity conversion policy and implementation.
The GMCs functionality brings Transparency and enables the definition and realization of GRCpromoting procedures for the “bottom-line” of an energy companies business – bulk product
movements.
CTG 10B Reference Manual – CSP03 v00
24
4
Cockpit Test Scenarios
4.1
Introduction
An important aspect in the definition and configuration of complex quantity conversion
calculations is to ensure that the calculation results are reproducible, stable and based on e.g.
contractual agreements between business partners, measurement standards and governmental
requirements.
QuantityWare delivers a complete configuration template for CTG 10B that contains all
customizing configuration that is required to access all petroleum measurement standard
implementations.
After you have installed CTG 10B in your system, you test this basic configuration
implementation delivered with the BC set in client 045 (recommended client) where you have
activated the relevant QuantityWare BC set. You run the implementation and installation from
the GMC Test Tool tab with one click. The GMC is part of CTG 10B and provides the central
user interface for Gas Measurement Experts and Consultants to CTG 10B.
After you have defined your relevant conversion groups based on copies from the QuantityWare
configuration template, as well as all conversion model settings (e.g. unit of measure rounding,
input parameters, range checks etc.), you need to cross check the calculation results with an
independent calculation procedure. Ultimately, this has to be a semi manual process (typically
using a spread sheet and a pocket calculator, or results from a legacy system).
QuantityWare delivers a test scenario tool which you utilize to define your own test scenarios for
your configuration settings (e.g. conversion group and related settings) in your system. This test
scenario tool can be accessed via the Gas Measurement Cockpit as well. This documentation
describes how to use the test tool.
Typically in your QA system, you define test scenarios based on your company specific
conversion group configurations which can then be run at any time in the system. After
definition and testing, transport the test scenarios from your QA system, to all relevant systems
in your landscape but specifically, your production system. A log can be written to the database
for each test scenario run, providing a protocol of the test results for later auditing. You may
also save a snapshot of each test scenario during a scenario run to the database. Such a
snapshot can be written to the database if a scenario runs without error. The snapshot contains
all relevant configuration data (customizing settings) and the test scenario data. If a scenario
CTG 10B Reference Manual – CSP03 v00
25
runs into an error, you simply compare the snapshot data with the then current system data in
order to determine if a change of the scenario or the related configuration has caused the error.
For one scenario you may create exactly one snapshot. Once you have created your own test
scenarios, you should run these tests and write the results to the log tables at least after:
You install a new CTG support package (CSP) or note
You install an SAP Oil & Gas ERP related note or package
Tests can also be scheduled regularly or executed irregularly to ensure that configuration is
consistent.
4.2
Test Scenario – Definition
A QuantityWare test scenario is an automated, conversion group based calculation, where the
calculation parameters (Scenario ID, conversion group with reading group and unit of measure
(UoM) group) and the expected calculation results (quantity values and parameters) are defined
in the system.
During a test scenario run, which you can trigger at any point in time, the system calculates the
actual results (quantity values and parameters) and compares these actual results with your
expected results. If all expected and actual results match, the scenario has been executed
without error and reports the status “green - o.k.”; otherwise the differences are reported as “red
- not o.k.” and marked as such in the details list which is printed for each scenario.
You also have the option to define a test scenario such that it runs “green –
o.k.” if a pre-defined error message is encountered. This way, you e.g.
automatically test that parameter range limits are correctly defined or that
quantity deviations are within the specified limits.
Example:
You have configured your LPG conversion group Z721 for production, which is a copy of the
QuantityWare template conversion group Q721. Your UoM group contains the units L15 (Liter
@ 15 °C), KG (Kilogram in vacuo) and KGA (Kilogram in air). You have defined rounding of all
relevant UoM based on your business requirements in your test client, which is also relevant for
production.
CTG 10B Reference Manual – CSP03 v00
26
For a transaction volume quantity of 10,000 L at 20 °C and a base density in vacuo of 500 kg/m³
you expect the following results:
VCF observed to base: 0.98467
Base density in air: 498.9 kg/m³ (rounded to 1 decimal)
Quantity: 9847 L15 (rounded to 0 decimals)
Quantity: 4923 KG (rounded to 0 decimals)
Quantity: 4913 KGA (rounded to 0 decimals)
You enter these expected results when you create the test scenario in the system. During a test
scenario run, the system compares the actual results with these expected results. Since the
expected results are very sensitive to all customizing and configuration settings, you thus
ensure that all settings are stable in your system landscape and that the calculation is based on
the measurement standards and calculation models as defined during your project
implementation work.
4.3
Test Scenario – Delivery
From CTG 10B CSP02 onwards, QuantityWare delivers more than 500 test
scenarios as part of the BC Set template, which you can access in your CTG
template client 045.
These test scenarios are delivered for two reasons:
1) To provide an additional high precision test matrix which extends the standard
QuantityWare CTG 10B implementation and installation test. All scenarios are designed
to run without errors within the QuantityWare CTG 10B client 045, where the BC set
has been activated
2) Provide realistic examples for consultants implementing CTG 10B to ease definition of
customer specific test scenarios
CTG 10B Reference Manual – CSP03 v00
27
4.4
Access to the Customer Test Scenario Tool
The Customer Test Scenario Tool can be accessed via the GMC (transaction
/n/qtyw/cockpit_gas):
As shown in the screen shot above, two push buttons are available. “Run my test” and “Maintain
my test”.
CTG 10B Reference Manual – CSP03 v00
28
4.5
The Customer Test Scenario Tool
You can create up to 1.000.000 test scenarios in your system. All test scenarios can be
transported to any required system and client within your system landscape. Test scenario
creation typically takes place in your quality assurance system.
4.5.1 Maintaining customer specific test scenarios
If you select “Maintain my tests” push button, you have the following options in the field
“Activity”:
Display scenarios
Create scenarios
Copy scenarios
Change scenarios
Delete scenarios
Export scenarios (customizing request)
Analyze scenarios
Analyze logs
CTG 10B Reference Manual – CSP03 v00
29
4.5.2 Display scenarios
If you select this activity, you choose a range of scenarios that will be listed:
You can inspect the scenario details by clicking on a single scenario number or application ID:
CTG 10B Reference Manual – CSP03 v00
30
4.5.3 Create Scenarios
Enter the Scenario ID (four character field), a description and the conversion group for the test
scenario, as well as a unit of measure group that contains the UoM for which the quantity
conversion is executed:
After you hit return the system displays the relevant parameters from the reading group that is
linked to the conversion group:
CTG 10B Reference Manual – CSP03 v00
31
For your scenario, you may select whether you want to compare the results of:
Parameters and quantities
Quantities only
Parameters only
CTG 10B Reference Manual – CSP03 v00
32
Then you change the parameter results and/or quantity results, or save the test scenario directly
by selecting the “Save” push button.
4.5.4 Change Scenarios
Here, you can edit an existing scenario.
4.5.5 Copy Scenario
Allows you to copy an existing scenario to a new scenario.
4.5.6 Delete Scenarios
Allows you to define a range of scenarios from which you can then select individual, or multiple
scenarios for deletion:
4.5.7 Export Scenarios
Allows you to define a range of scenarios from which you can then select individual, or multiple
scenarios for inclusion into a customizing transport into another client or system within your
system landscape:
CTG 10B Reference Manual – CSP03 v00
33
4.5.8 Analyze scenarios
Allows you to define a range of scenarios from which you can then select individual, or multiple
scenarios for error analysis. Requires that a snapshot for the scenario is available on the
snapshot database:
CTG 10B Reference Manual – CSP03 v00
34
If you click the Scenario number for the scenario which reported an error, you compare the
actual scenario definition with the definition stored in the snapshot database:
If you click on any other overview field (e.g. Appl., Run date, Run time), you can compare the
actual configuration settings with the settings stored in the snapshot database. If differences are
found, the different entries will be shown in the detailed analysis screen:
CTG 10B Reference Manual – CSP03 v00
35
You click on the error line to display the setting which is different:
In this example, a different UoM rounding setting is apparently causing the scenario to run into
an error, which you can now easily rectify.
CTG 10B Reference Manual – CSP03 v00
36
If a scenario runs into an unexpected error and neither the scenario nor the configuration are
showing any differences, the ABAP code base is the only remaining source of error. Then you
should run the installation test in client 045 to ensure a validated code base in that system and
check that the code base is consistent through all systems in your system landscape.
4.5.9 Analyze logs
If a test scenario runs into an error, you have to analyze the reason for the error. Here you
display and change all logs that have reported an error. You may set the log error status (none
– in process – complete – confirmed) and write a comment line into the log:
Note that error logs may only be archived if the log status is set to “confirmed”.
CTG 10B Reference Manual – CSP03 v00
37
4.6
Running customer specific test scenarios
If you select the “Run my tests” push button, you have the option to run all test scenarios, or
one set of user specified scenarios. Here you may also display the log of your scenario runs, set
an indicator that writes a log protocol and/or snapshot for the scenario execution results, or
maintain the log database (including archiving of log data) for your historic log protocols:
The results of each scenario run are listed as shown in the next screen print:
By clicking on the summary lines, you can inspect all details of each scenario run:
CTG 10B Reference Manual – CSP03 v00
38
Note: all these activities require a careful semi-manual procedure where you
calculate your expected results independently from the system results and use
at least a four eyes principle to validate your results.
4.7
Summary
The QuantityWare Test Scenario Tool provides easy-to-use management functions for all of
your important quantity conversion test scenarios. With these scenarios, you continuously
monitor and check the correctness of your productive CTG implementations, thus providing
maximum security and stability for all logistics processes, which rely on accurate and well
defined quantity conversion data for bulk products. Governance, Risk Management and Control
procedures should always include such a state-of-the-art test procedure for natural gas bulk
quantity values.
CTG 10B Reference Manual – CSP03 v00
39
5
CTG Configuration Template
5.1
Introduction
This chapter lists all customizing tables for which entries are delivered with the CTG 10B
template and provides selected technical configuration details.
QuantityWare delivers customizing configuration data (template data) as part of one BC set,
which CTG customers have to activate in one new test client (045) in order to run the
QuantityWare CTG implementation test and validate the CTG installation. Another purpose of
the template is the provision of a complete blueprint for each customer.
QuantityWare delivers language-dependent entries in English (EN), French (FR), Spanish (ES)
and Portuguese (PT) for all customizing template data which is visible to the business user.
All customizing data can be accessed via the QuantityWare Gas Measurement
Cockpit (GMC), transaction /n/qtyw/cockpit_gas
If you require detailed information how to access all CTG 10B customizing data see Chapter 7
CTG Customizing Transactions
QuantityWare strongly recommends that customers import/activate the
template configuration (e.g. conversion groups) in one development system
client 045 only where customers copy the required data into their own name
space (Z*) and distribute this configuration into all other clients and systems
The template configuration data can be divided into three parts:
Unit of measure definitions – SAP customizing tables
Quantity conversion configuration – SAP customizing tables
Quantity conversion configuration – QuantityWare customizing tables
CTG 10B Reference Manual – CSP03 v00
40
5.2
Unit of measure definitions – SAP tables
QuantityWare delivers all required Unit of Measure (UoM) definitions (392 entries) and
dimension ID definitions (66 entries) as part of the template. These definitions have been
carefully checked. In addition 191 ISO/UNECE code definitions are delivered. The UoM
definitions fall into three categories:
UoM definitions which are part of the SAP client 000 template and which are not
adjusted/corrected by QuantityWare with respect to quantity conversions – SAP UoM
UoM definitions which are part of the SAP client 000 template and which are corrected by
QuantityWare with respect to quantity conversion – SAP UoM corrected
New QuantityWare UoM definitions which are not part of the SAP client 000 template –
QuantityWare UoM
5.2.1 List of tables
The following list contains all table names for the UoM configuration for which entries are
delivered. Language-dependent table entries are delivered in English (EN), French (FR),
Spanish (ES) and Portuguese (PT):
Table
Entries
Description
delivered
T006
Units of Measurement
392
T006A
Assign Internal to Language-Dependent Unit
1568
T006B
Assignment of commercial to internal unit of measurement
1568
T006C
Assignment of external technical to internal unit of measure
1568
T006D
Dimensions
66
T006D_OIB
Add-On Extension for Dimensions
66
T006I
ISO codes for units of measurement
191
T006J
ISO Codes for Unit of Measure Texts
764
T006T
Dimension Texts
264
T006_OIB
Units of Measurement, Additional Definitions
392
5.2.2 ISO (UNECE) codes
The listed ISO / UNECE codes are delivered. QuantityWare has compared these codes with
UNECE recommendation 20 (2006) and assigned an ISO / UNECE code to all 392 SAP UoM
where a code is defined. For UoM that carry a temperature or pressure definition, the
corresponding ISO / UNECE code has also been assigned, but the primary flag is always set for
the UoM without temperature or pressure specifications:
CTG 10B Reference Manual – CSP03 v00
41
ISO / UNECE code
23
28
2J
2K
Description
ISO / UNECE code
Description
gram per cubic
B1
barrel (U.S.) per day
centimeter
B11
joule per kilogram kelvin
kilogram per square
B15
joule per mole
meter
B22
kiloampere
cubic centimeter /
second
B25
cubic foot per hour
B34
kilobecquerel p.
kilogram
kilogram/cubic
2M
centimeter per second
2X
meter per minute
B35
kilogram per liter
2Z
millivolt
B42
kilojoule per kilogram
3B
megajoule
B44
kilojoule per mole
3E
pound per pound
B45
kilomole
3H
kilogram per kilogram
B47
kilonewton
4G
microliter
B49
kiloohm
4H
micrometer
B73
meganewton
4K
milliampere
B75
megaohm
4O
microfarad
B78
megavolt
4P
newton per meter
B8
joule per cubic meter
4T
picofarad
B84
microampere
5A
barrel per minute
B98
microsecond
5I
standard cubic foot
BAR
bar
87
pound per cubic foot
BLL
barrel (U.S.)
A18
becquerel per kilogram
BTU
British thermal unit (IT)
A39
cubic meter per kilogram
BZ
million Btu
A40
cubic meter per mole
C10
millifarad
A44
decaliter
C15
millijoule
A48
degree Rankine
C16
millimeter per second
A87
gigaohm
C18
millimol
A93
gram per cubic meter
C19
mole per kilogram
A94
gram per mole
C22
millinewton per meter
A97
hectopascal
C24
millipascal seconds
ACR
acre
C26
millisecond
AMP
ampere
C29
millitesla
ANN
year
C31
milliwatt
AZ
Btu per pound
C34
mole
B0
Btu per cubic foot
C36
mole per cubic meter
CTG 10B Reference Manual – CSP03 v00
decimeter
42
ISO / UNECE code
Description
ISO / UNECE code
Description
C38
mole per liter
FTK
square foot
C39
nanoampere
FTQ
cubic foot
C41
nanofarad
GB
gallon (U.S.) per day
C45
nanometer
GE
pound per gallon (U.S.)
C47
nanosecond
GJ
gram per milliliter
newton/square
GK
gram per kilogram
millimeter
GL
gram per liter
C60
ohm centimeter
GLI
gallon (imperial)
C61
ohm meter
GLL
gallon (U.S.)
C65
pascal second
GM
gram per square meter
C86
reciprocal cubic meter
C91
reciprocal kelvin
C56
C93
reciprocal meter
squared
GP
GQ
milligram per cubic
meter
microgram per cubic
meter
C96
reciprocal pascal
GRM
gram
CDL
candela
GV
gigajoule
CEL
degree Celsius
HAR
hectare
CLT
centiliter
HLT
hectoliter
CMK
square centimeter
HTZ
hertz
CMQ
Cubic centimeter
HUR
hour
CMT
centimeter
INH
inch
D10
siemens per meter
INK
square inch
D30
terajoule
INQ
cubic inch
D33
tesla
J2
joule per kilogram
D41
ton per cubic meter
JK
megajoule per kilogram
D46
voltampere
D53
watt per meter kelvin
D74
kilogram per mole
JOU
joule
D87
millimole per kilogram
KEL
kelvin
DAY
day
KGM
kilogram
DMQ
cubic decimeter
KGS
kilogram per second
DMT
decimeter
KHZ
kilohertz
FAH
degree Fahrenheit
KJO
kilojoule
FAR
farad
KMH
kilometer per hour
FC
thousand cubic feet
KMK
square kilometer
FOT
foot
KMQ
kilogram per cubic meter
JM
CTG 10B Reference Manual – CSP03 v00
megajoule per cubic
meter
43
ISO / UNECE code
Description
ISO / UNECE code
Description
KMT
kilometer
MTK
square meter
KPA
kilopascal
MTQ
cubic meter
KTN
kilotonne
MTR
meter
KVA
kilovolt ampere
MTS
meter per second
KVT
kilovolt
MVA
megavolt ampere
KWH
kilowatt hour
MWH
megawatt hour
KWT
kilowatt
NA
milligram per kilogram
L2
liter per minute
NEW
newton
LBR
pound (avoirdupois)
OHM
ohm
LD
liter per day
ONZ
ounce
LTN
long ton (U.S.)
OZA
fluid ounce (U.S.)
LTR
liter
PAL
pascal
M1
milligram per liter
PS
pound-force per sq. inch
M9
million Btu per 10³ ft³
PTL
liquid pint (U.S.)
MAW
megawatt
QTL
Liquid quart (U.S.)
MBR
millibar
RPM
revolutions per minute
MGM
milligram
MHZ
megahertz
MIK
square mile
SEC
second
MIN
minute
SMI
mile
MLT
milliliter
STN
short ton (U.S.)
MMK
square millimeter
TD
therm
MMQ
cubic millimeter
TNE
tonne (1000 kg)
MMT
millimeter
VLT
volt
MON
month
WEE
week
MPA
megapascal
WTT
watt
MQH
cubic meter per hour
YDK
square yard
MQS
cubic meter per second
YDQ
cubic yard
meter per square
YRD
yard
MSK
S4
square meter per
second
second
5.2.3 Dimensions
With the CTG 10B template, 66 dimension IDs are delivered. 55 dimension IDs are identical
(when comparing relevant fields) with the SAP template - 11 dimension IDs are delivered new
by QuantityWare (marked with orange).
CTG 10B Reference Manual – CSP03 v00
44
Dimension
Text
Dimension
Text
AAAADL
No dimension
POINTS
points
ACBAC
acid/base capacity
POWER
power
ACCEL
acceleration
PRESS
pressure
CAPACI
electric capacity
PROPOR
proportion
COMP_F
compression factor
RESIST
electric resistance
CONDUC
conductivity
SPAEQU
spec. equivalent
DENSI
Density
SPARAD
spec.act.radioac.sub
ECURR
electric current
SPEED
speed
ENERGY
Energy
SPENER
heating value (mass)
ENPTIM
oil & gas prod. rate
SPHCAP
spec. heat capacity
EVARA
vaporization speed
SPREST
sp. elec. resistance
FORCE
Force
STEXKZ
dust explosion ratio
FREQU
Frequency
SURFAC
area
GASCON
gas constant
SURFTE
surface tension
GRSVOL
gross volume
SURINV
reciprocal area
HVALUE
heating value(vol.)
TEMP
temperature
HVLMOL
heating value(molar)
TEMPRT
rate of temp. change
HYDROL
hydrolysis rate
THCOND
heat conductivity
INVDEN
reciprocal density
TH_EXP
thermal expansion
LENGTH
Length
TIME
time
LIGHT
luminous intensity
TKONZ
particle concentrat.
MAGNFD
magnet. field dens.
VISDYN
dynamic viscosity
MASALC
mass - alcohol
VISKIN
kinematic viscosity
MASFLO
mass flow
VMASS
mass
MASS
mass or weight
VOLALC
volume - alcohol
MASSBD
mass coverage
VOLFLO
volume flow rate
MOENER
am. subst. energy
VOLGAS
volume (LNG, gas)
MOLMAS
molar mass
VOLLIQ
volume (LNG, liquid)
MOLPRO
mole fraction
VOLTAG
electr. tension
MOLQU
amount of substance
VOLUME
volume
MOLVOL
molar volume
VPROPO
volume proportion
MPROPO
mass proportion
V_P_H
volume per height
CTG 10B Reference Manual – CSP03 v00
45
Dimension
Text
Dimension
Text
WALC
weight - alcohol
WGHTA
weight
5.2.4 SAP UoM
The following UoM are delivered from the SAP UoM template which are identical to the SAP
UoM definitions with respect to quantity conversion – language-dependent texts may differ, as
well as technical key settings:
No
Dimension text
MU
Measurement unit text
1
acceleration
MS2
meter per second squared
2
density
KGV
kilogram per cubic meter
3
electr. tension
V
volt
4
electric current
A
ampere
5
electric resistance
6
OHM
ohm
energy
J
joule
7
force
N
newton
8
frequency
HZ
hertz
9
heating value(vol.)
KJD
kilojoule per cubic decimeter
10
heating value(vol.)
KW1
kilowatt hour per cubic meter
11
heating value(vol.)
KWM
kilowatt hour per cubic meter
12
heating value(vol.)
MBF
MMBtu(IT) per cubic foot
13
luminous intensity
CD
14
mass proportion
GHG
gram per hectogram
15
mass proportion
M%
percent mass
16
mass proportion
M%O
permille mass
17
mass proportion
MGG
milligram per gram
18
mass proportion
MPB
mass parts per billion
19
mass proportion
MPM
mass parts per million
20
mass proportion
MPT
mass parts per trillion
21
power
MGW
megawatt
22
power
W
watt
23
proportion
1
one
24
time
JHR
year (365 days)
25
time
MON
month (30 days)
26
volume proportion
MLK
milliliter per cubic meter
27
volume proportion
V%O
permille (volume)
28
volume proportion
VPB
parts per billion (volume)
candela
CTG 10B Reference Manual – CSP03 v00
46
29
volume proportion
VPM
parts per million (volume)
30
volume proportion
VPT
parts per trillion (volume)
5.2.5 SAP UoM corrected
The following UoM are delivered with CTG 10B as copies from the SAP UoM template with
changes as indicated:
A UoM marked with yellow background color carries non-critical changes from a quantity
conversion point of view, however, these have to be checked (e.g. display decimal setting)
A UoM marked with red carries critical changes from a quantity conversion point of view
No Dimension text
MU
Measurement unit text
1
No dimension
API
API gravity
2
No dimension
RDA
relative density (air) - gas
3
No dimension
RDW
relative density (water,60 °F)
4
acid/base capacity
C36
mole per cubic meter
5
acid/base capacity
C38
mole per liter
6
am. subst. energy
JMO
joule mole
7
amount of substance
B45
kilomole
8
amount of substance
LBM
pound mole
9
amount of substance
MMO
millimole
10 amount of substance
MOL
mole
11 area
ACR
acre (bsd on U.S. survey foot)
12 area
CM2
square centimeter
13 area
FT2
square foot
14 area
HAR
hectare
15 area
IN2
square inch
16 area
KM2
square kilometer
17 area
M2
square meter
18 area
MI2
square mile
19 area
MM2
square millimeter
20 area
YD2
square yard
21 compression factor
CBA
reciprocal bar
22 compression factor
CKP
reciprocal kilopascal
23 compression factor
CPA
reciprocal pascal
24 compression factor
CPI
reciprocal psi
25 conductivity
D10
siemens per meter
26 density
A93
gram per cubic meter
CTG 10B Reference Manual – CSP03 v00
47
No Dimension text
MU
Measurement unit text
27 density
B34
kilogram per cubic decimeter
28 density
D41
tonne per cubic meter
29 density
GLI
gram per liter
30 density
GQ
microgram per cubic meter
31 density
MGL
milligram per liter
32 density
MGQ
milligram per cubic meter
33 density
RHO
gram per cubic centimeter
34 dust explosion ratio
MPZ
meter pascal per second
35 dynamic viscosity
MPS
millipascal second
36 dynamic viscosity
PAS
pascal second
37 electr. tension
B78
megavolt
38 electr. tension
KV
kilovolt
39 electr. tension
MV
millivolt
40 electric capacity
4O
microfarad
41 electric capacity
4T
pikofarad
42 electric capacity
C10
millifarad
43 electric capacity
C41
nanofarad
44 electric capacity
F
farad
45 electric current
B84
microampere
46 electric current
C39
nanoampere
47 electric current
KA
kiloampere
48 electric current
MA
milliampere
49 electric resistance
A87
gigaohm
50 electric resistance
B75
megaohm
51 electric resistance
KOH
kiloohm
52 energy
BTU
British thermal unit (IT)
53 energy
KJ
kilojoule
54 energy
KWH
kilowatt hour
55 energy
KWN
kilowatt hour -15 °C c.,sup.
56 energy
MBD
million Btu(IT) - 60 °F c.,s.
57 energy
MBT
million Btu (IT)
58 energy
MBW
million Btu(IT) - 60 °F s.,w.
59 energy
MEJ
megajoule
60 energy
MJ
millijoule
61 energy
MWH
megawatt hour
62 force
B47
kilonewton
CTG 10B Reference Manual – CSP03 v00
48
No Dimension text
MU
Measurement unit text
63 force
B73
meganewton
64 frequency
KHZ
kilohertz
65 frequency
MHZ
megahertz
66 frequency
PMI
revolution per minute
67 heat conductivity
WMK
watt per meter kelvin
68 heating value (mass)
JKG
joule per kilogram
69 heating value (mass)
KJK
kilojoule per kilogram
70 heating value(molar)
JOM
joule per mole
71 heating value(vol.)
B/F
Btu per cubic foot
72 heating value(vol.)
BC1
Btu/cubic foot at 15.025/60/SD
73 heating value(vol.)
BC2
Btu/cubic foot at 14.73/60/SD
74 heating value(vol.)
BC3
Btu/cubic foot at 14.65/60/SD
75 heating value(vol.)
BC4
Btu/cubic foot at 15.025/60/SW
76 heating value(vol.)
BC5
Btu/cubic foot at 14.73/60/SW
77 heating value(vol.)
BC6
Btu/cubic foot at 14.65/60/SW
78 heating value(vol.)
JM3
joule per cubic meter
79 heating value(vol.)
M/F
MMBtu(IT) per 1000 cubic feet
80 heating value(vol.)
MJM
megajoule per cubic meter
81 hydrolysis rate
LMS
liter per mole second
82 kinematic viscosity
M2S
square meter per second
83 length
CM
centimeter
84 length
DM
decimeter
85 length
FT
foot
86 length
IN
inch
87 length
KM
kilometer
88 length
M
meter
89 length
MI
mile
90 length
MIM
micrometer
91 length
MM
millimeter
92 length
NAM
nanometer
93 length
YD
yard
94 magnet. field dens.
MTE
millitesla
95 magnet. field dens.
TES
tesla
96 mass coverage
GM2
gram per square meter
97 mass coverage
KGF
kilogram per square meter
CTG 10B Reference Manual – CSP03 v00
49
No Dimension text
MU
Measurement unit text
98 mass flow
KGS
kilogram per second
99 mass or weight
G
gram
100 mass or weight
KG
kilogram
101 mass or weight
KT
kilotonne
102 mass or weight
LB
pound (avoirdupois)
103 mass or weight
LTO
ton, long (2240 lb)
104 mass or weight
MG
milligram
105 mass or weight
OZ
ounce (avoirdupois)
106 mass or weight
STO
ton, short (2000 lb)
107 mass or weight
TO
tonne ("metric ton" in U.S.)
108 mass proportion
GKG
gram per kilogram
109 mass proportion
KGK
kilogram per kilogram
110 mass proportion
MGK
milligram per kilogram
111 molar mass
GM
gram per mole
112 molar mass
KGM
kilogram per mole
113 molar volume
M3M
cubic meter per mole
114 mole fraction
MOM
mole fraction
115 particle concentrat.
TM3
reciprocal cubic meter
116 points
P
points
117 power
D46
volt ampere
118 power
KVA
kilovolt ampere
119 power
KW
kilowatt
120 power
MVA
megavolt ampere
121 power
MW
milliwatt
122 pressure
BAR
bar (absolute)
123 pressure
C56
newton per square millimeter
124 pressure
HPA
hectopascal
125 pressure
KPA
kilopascal
126 pressure
MBA
millibar
127 pressure
MPA
megapascal
128 pressure
PA
pascal
129 pressure
PSI
pound-force per square Inch
130 rate of temp. change
KMS
kelvin per second
131 reciprocal area
M2I
one per square meter
132 sp. elec. resistance
OCM
ohm centimeter
133 sp. elec. resistance
OM
ohm meter
CTG 10B Reference Manual – CSP03 v00
50
No Dimension text
MU
Measurement unit text
134 spec. equivalent
MMK
millimole per kilogram
135 spec. equivalent
MOK
mole per kilogram
136 spec. heat capacity
JKK
joule per kilogram kelvin
137 spec.act.radioac.sub
BQK
becquerel per kilogram
138 spec.act.radioac.sub
KBK
kilobecquerel per kilogram
139 speed
2M
centimeter per second
140 speed
2X
meter per minute
141 speed
KMH
kilometer per hour
142 speed
M/S
meter per second
143 speed
MMS
millimeter per second
144 surface tension
MNM
millinewton per meter
145 surface tension
NM
newton per meter
146 temperature
CEL
degree Celsius
147 temperature
FAH
degree Fahrenheit
148 temperature
K
kelvin
149 temperature
R
degree Rankine
150 thermal expansion
TEC
reciprocal degree Celsius
151 thermal expansion
TEF
reciprocal degree Fahrenheit
152 thermal expansion
TEK
reciprocal kelvin
153 time
10
day
154 time
H
hour
155 time
MIN
minute
156 time
MIS
microsecond
157 time
MS
millisecond
158 time
NS
nanosecond
159 time
S
second
160 time
WCH
week
161 vaporization speed
WTL
kilogram per second sq. meter
162 volume
4G
microliter
163 volume
BB6
barrel [42 gallons(U.S.)] 60°F
164 volume
BBL
barrel [42 gallons(U.S.)]
165 volume
CCM
cubic centimeter
166 volume
CDM
cubic decimeter
167 volume
CTL
centiliter
168 volume
DAL
dekaliter
CTG 10B Reference Manual – CSP03 v00
51
No Dimension text
MU
Measurement unit text
169 volume
FT3
cubic foot
170 volume
GLL
gallon (U.S.)
171 volume
HL
hectoliter
172 volume
IG6
gallon (imperial) - 60 °F
173 volume
IGL
gallon [imperial]
174 volume
IN3
cubic inch
175 volume
L
liter
176 volume
L12
liter - 12 °C
177 volume
L15
liter - 15 °C
178 volume
L20
liter - 20 °C
179 volume
L26
liter - 26 °C
180 volume
L5
liter - 5 °C
181 volume
L60
liter - 60 °F
182 volume
M15
cubic meter - 15 °C
183 volume
M3
cubic meter
184 volume
MBL
thousand barrel
185 volume
MC1
one thousand ft³ 15,025 PSI
186 volume
MC2
one thousand ft³ 14,73 PSI
187 volume
MC3
one thousand ft³ 14,65 PSI
188 volume
MCF
thousand cubic feet
189 volume
ML
milliliter
190 volume
MMQ
cubic millimeter
191 volume
OZA
fluid ounce (U.S.)
192 volume
PT
pint (U.S. liquid)
193 volume
QT
quart (U.S. liquid)
194 volume
SCF
cubic foot - standard U.S.
195 volume
SM3
cubic meter - standard ISO
196 volume
UG6
gallon (U.S.) 60 °F
197 volume
UGL
gallon (U.S.)
198 volume
YD3
cubic yard
199 volume flow rate
C3S
cubic centimeter per second
200 volume flow rate
GPH
gallon (U.S.) per hour
201 volume flow rate
LPH
liter per hour
202 volume flow rate
M3S
cubic meter per second
203 volume flow rate
MQH
cubic meter per hour
204 volume per height
BP2
barrel per half inch
CTG 10B Reference Manual – CSP03 v00
52
No Dimension text
MU
Measurement unit text
205 volume per height
BP4
barrel per quater of an inch
206 volume proportion
KMK
cubic meter per cubic meter
207 volume proportion
V%
percent (volume)
5.2.6 QuantityWare UoM
The following QuantityWare UoM definitions are delivered with CTG 10B:
No
Dimension
MU
Measurement unit text
1
No dimension
CBR
rounding UoM - combustion(gas)
2
No dimension
CRD
rounding UoM -compression(gas)
3
No dimension
PRD
rounding UoM - pressure (gas)
4
No dimension
R10
rounding phys. prop. 10 dec.
5
No dimension
R11
rounding phys. prop. 11 dec.
6
No dimension
RP0
rounding phys. prop. 0 dec.
7
No dimension
RP1
rounding phys. prop. 1 dec.
8
No dimension
RP2
rounding phys. prop. 2 dec.
9
No dimension
RP3
rounding phys. prop. 3 dec.
10
No dimension
RP4
rounding phys. prop. 4 dec.
11
No dimension
RP5
rounding phys. prop. 5 dec.
12
No dimension
RP6
rounding phys. prop. 6 dec.
13
No dimension
RP7
rounding phys. prop. 7 dec.
14
No dimension
RP8
rounding phys. prop. 8 dec.
15
No dimension
RP9
rounding phys. prop. 9 dec.
16
No dimension
TRD
rounding UoM -temperature(gas)
17
No dimension
VCF
Volume corr. factor - oil
18
density
GMI
gram per milliliter
19
density
K15
kilogram per cubic meter 15 °C
20
density
KCM
kilogram per cubic meter, 1 d.
21
density
KGL
kilogram per liter
22
density
LMG
ton,long per 1000 gallon(U.S.)
23
density
LPB
ton,long per barrel(U.S.)
24
density
LTG
ton,long per gallon(U.S.)
25
density
MTB
metric ton per barrel(U.S.)
26
density
MTG
metric ton per gallon(U.S.)
CTG 10B Reference Manual – CSP03 v00
53
No
Dimension
MU
Measurement unit text
27
density
PPC
pound per cubic foot
28
density
PPG
pound per gallon(U.S.)
29
density
SMG
ton,short per 1000 gal.(U.S.)
30
density
STB
ton,short per barrel(U.S.)
31
density
STG
ton,short per gallon(U.S.)
32
density
TMG
metric ton per 1000 gal.(U.S.)
33
energy
GI0
gigajoule - 0 °C comb., inf.
34
energy
GI1
gigajoule - 15 °C comb.,inf.
35
energy
GI2
gigajoule - 20 °C comb., inf.
36
energy
GI5
gigajoule - 25 °C comb.,inf.
37
energy
GJ0
gigajoule - 0 °C comb., sup.
38
energy
GJ1
gigajoule - 15 °C comb.,sup.
39
energy
GJ2
gigajoule - 20 °C comb., sup.
40
energy
GJ5
gigajoule - 25 °C comb.,sup.
41
energy
GJL
gigajoule
42
energy
KWI
kilowatt hour -15 °C c.,inf.
43
energy
MBI
million Btu(IT) - 60 °F c.,i.
44
energy
MBU
million Btu(IT)
45
energy
MKC
million kilocalorie (th)
46
energy
MKJ
million kilojoule
47
energy
QAD
quad (1015 Btu(IT))
48
energy
THM
therm (EC)
49
energy
THU
therm (U.S.)
50
energy
TJ
terajoule
51
gas constant
RSI
SI unit J /( mol * K)
52
gross volume
GB6
barrel (U.S.) - 60 °F, gross
53
gross volume
GBL
barrel(U.S.), gross
54
gross volume
GG6
gallon(U.S.) - 60 °F, gross
55
gross volume
GGL
gallon(U.S.), gross
56
gross volume
L2G
liter - 20 °C , gross
57
gross volume
L5G
liter - 15 °C , gross
58
gross volume
LG
liter, gross
59
gross volume
MG3
cubic meter, gross
60
heating value (mass)
BUP
Btu(IT) per pound
61
heating value (mass)
MJK
megajoule per kilogram
62
heating value(molar)
BUM
Btu(IT) per mole
CTG 10B Reference Manual – CSP03 v00
54
No
Dimension
MU
Measurement unit text
63
heating value(molar)
KJL
kilojoule per mole
64
heating value(molar)
MJL
megajoule per mole
65
heating value(vol.)
BCF
Btu(IT) per cubic foot
66
mass
VKG
kilogram (vacuum)
67
mass
VLB
pound (U.S.) (vacuum)
68
mass
VLT
ton, long (2240 lb), vacuum
69
mass
VTO
tonne (vacuum)
70
mass - alcohol
KAL
kilogram (alcohol)
71
mass - alcohol
TAL
tonne (alcohol)
72
mass or weight
LT2
lto, 2 decimals TEMPLATE
73
mass or weight
T2
tonne, 2 decimals TEMPLATE
74
mass proportion
PPP
pound per pound
75
molar mass
KKM
kilogram per kilomole
76
molar mass
LSM
pound per mole
77
molar volume
M3K
cubic meter per kilomole
78
mole fraction
MOP
mole %
79
oil & gas prod. rate
BOE
barrel of oil per day (OIL)
80
oil & gas prod. rate
BOY
barrel of oil per year (OIL)
81
oil & gas prod. rate
CFE
cubic foot gas per day (GAS)
82
oil & gas prod. rate
CFY
cubic foot gas per year (GAS)
83
oil & gas prod. rate
CME
cubic meter gas per day (GAS)
84
oil & gas prod. rate
CMY
cubic meter gas per year (GAS)
85
oil & gas prod. rate
GJD
gigajoule per day (ALL)
86
oil & gas prod. rate
GJY
gigajoule per year (ALL)
87
oil & gas prod. rate
MBE
million BTU per day (ALL)
88
oil & gas prod. rate
MBY
million BTU per year (ALL)
89
oil & gas prod. rate
MLE
cubic meter LNG per day (LNG)
90
oil & gas prod. rate
MLY
cubic meter LNG per year(LNG)
91
oil & gas prod. rate
MOE
cubic meter oil per day (OIL)
92
oil & gas prod. rate
MOY
cubic meter oil per year (OIL)
93
oil & gas prod. rate
TCE
tonne of coal per day (COAL)
94
oil & gas prod. rate
TLE
tonne LNG per day (LNG)
95
oil & gas prod. rate
TLY
tonne LNG per year (LNG)
96
oil & gas prod. rate
TOE
tonne of oil per day (OIL)
97
oil & gas prod. rate
TOY
tonne of oil per year (OIL)
CTG 10B Reference Manual – CSP03 v00
55
No
Dimension
MU
Measurement unit text
98
pressure
BGA
bar (gauge)
99
pressure
PSA
pound-force p. square Inch (a)
100
reciprocal density
BMT
barrel per metric ton
101
reciprocal density
BPL
barrel per long ton
102
reciprocal density
BPS
barrel per short ton
103
reciprocal density
GLT
gallon(U.S.) per long ton
104
reciprocal density
GMT
gallon(U.S.) per metric ton
105
reciprocal density
GPP
gallon(U.S.) per pound
106
reciprocal density
GST
gallon(U.S.) per short ton
107
reciprocal density
LKG
liter per kilogram
108
reciprocal density
MPK
cubic meter per kilogram
109
volume
BB0
barrel 0 decimals TEMPLATE
110
volume
CFT
cubic foot
111
volume
CM0
cubic meter - 0 °C metering
112
volume
CM5
cubic meter - 15 °C metering
113
volume
CMT
cubic meter - 20 °C metering
114
volume
L23
liter - 23 °C
115
volume
L2A
liter 20 °C - 100 % alcohol
116
volume
L30
liter - 30 °C
117
volume
L85
liter - 85 °F
118
volume
M3X
cubic meter LNG liq. -165 °C
119
volume
M60
cubic meter - 60 °F
120
volume (LNG, gas)
M3G
cubic meter (gas) of LNG
121
volume (LNG, gas)
M3Y
cubic meter (gas) of LNG std.
122
volume (LNG, liquid)
BLQ
barrel - LNG - liquid
123
volume (LNG, liquid)
CFC
cubic foot - LNG -257,8 °F
124
volume (LNG, liquid)
CFL
cubic foot - LNG - liquid
125
volume (LNG, liquid)
M3C
cubic meter - LNG -161 °C
126
volume (LNG, liquid)
M3L
cubic meter - LNG - liquid
127
volume (LNG, liquid)
M3Z
cubic meter - LNG -165 °C
128
volume - alcohol
GA6
gallon (U.S.) (alcohol) -60 °F
129
volume - alcohol
LA2
liter (alcohol) - 20 °C
130
volume - alcohol
LA5
liter (alcohol) - 15 °C
131
volume - alcohol
MA2
cubic meter (alcohol) - 20 °C
132
volume - alcohol
MA5
cubic meter (alcohol) - 15 °C
133
volume - alcohol
MAL
cubic meter (alcohol)
CTG 10B Reference Manual – CSP03 v00
56
No
Dimension
MU
Measurement unit text
134
volume flow rate
BLD
barrel per day
135
volume flow rate
BLH
barrel per hour
136
volume flow rate
BLM
barrel per minute
137
volume flow rate
CMM
cubic meter per minute
138
volume flow rate
F3D
cubic foot per day
139
volume flow rate
F3H
cubic foot per hour
140
volume flow rate
F3M
cubic foot per minute
141
volume flow rate
GPD
gallon (U.S.) per day
142
volume flow rate
LPD
liter per day
143
volume flow rate
LPM
liter per minute
144
volume flow rate
LPS
liter per second
145
volume flow rate
M3D
cubic meter per day
146
volume flow rate
UGM
gallon (U.S.) per minute
147
volume per height
MBM
cubic meter per meter
148
weight
KGA
kilogram in air
149
weight
KTA
kilotonne in air
150
weight
LBA
pound in air
151
weight
LTA
ton, long in air
152
weight
STA
ton, short in air
153
weight
TOA
tonne in air
154
weight - alcohol
KAA
kg(air, alcohol)
155
weight - alcohol
TAA
tonne (air, alcohol)
As indicated in the summary above, for all language-dependent UoM tables, entries with
translated texts for English (EN), French (FR), Spanish (ES) and Portuguese (PT) are delivered.
CTG 10B Reference Manual – CSP03 v00
57
5.3
Accessing the UoM configuration data – Gas Measurement Cockpit
You access and check all UoM configuration data directly from the GMC, from tab strip “Units of
Measurement”. Here you navigate to the UoM maintenance transaction “SAP units -> Maintain”
or display lists of UoM in your logon client “SAP Units -> Show” for various selection criteria. If
you select “UoM Tools –> Client/Compare, you can analyze the QuantityWare CTG 10B BC set
and compare UoM delivered within that BC set with UoM definitions in any client in your system:
CTG 10B Reference Manual – CSP03 v00
58
CTG 10B Reference Manual – CSP03 v00
59
By clicking on a UoM ID, you inspect the details of the UoM comparison:
CTG 10B Reference Manual – CSP03 v00
60
5.4
Quantity conversion configuration – SAP tables
QuantityWare delivers the complete quantity conversion configuration as part of the template.
These definitions are maintained in SAP and QuantityWare customizing tables. In this section
we list all SAP tables for which QuantityWare delivers template configuration entries and
provide a short content description for each table. Conversion groups, reading groups, range
check groups and tolerance groups are all defined within the name range Q000 to QSZZ (see
section “Details - conversion group mapping to bulk oil & gas products” for mapping to bulk oil
products)
5.4.1 List of tables
The following list contains all table names for which entries are delivered. Language-dependent
table entries are delivered in English (EN), French (FR), Spanish (ES) and Portuguese (PT) if
not indicated otherwise:
Table
Delivery / Number of
Description
entries
OIB07
Quantity Conversion Interface Parameter
304
OIB07T
Quantity Conversion Interface Parameter
1216 (4 * 302)
OIB07_HELP
OIB01
OIB01T
OIB04
OIB06
OIB06T
OIB05
OIB_CONV_RDGRP
OIB_CONV_UOM
OIB_CONV_UOM_TX
Quantity Conversion Interface Parameter:
F1 & F4 Help
174
Definition of Conversion Groups
423 + 1 (QWWW)
Conversion Group Text
1692 (4 * 423)
Function module definition
(API/AGA/Customer functions)
3718 + 1 (QWWW)
HPM Unit of Measurement Group:
Definition
14
Unit of Measure group description
56 (4 * 13)
Oil unit of measure groups
153
Link Conversion group - Reading group
423 + 1(QWWW)
Assignment of Units between Conv. Group
and T006
896
Assignment of Units between Conv. Group
896 (ONLY EN, not visible
and T006 – UoM descriptions
to business user)
CTG 10B Reference Manual – CSP03 v00
61
OIB_RDGRDEF
OIB_RDGRDEFT
OIB_READINGGROUP
OIB_RDGGROUPT
OIB_PPP_HEADER
OIB_PPP_HEADERT
Definition of Reading Groups
316 + 1 (QWWW)
Description of Reading Group Definition
1264 + 4(QWWW)
Reading group : Define parameters for a
conversion group
2210 + 1(QWWW)
Description of reading group parameter
8840 + 4(QWWW)
Header data: physical properties of
3 (for LPG): Q9 & QH &
hydrocarbons
QI
Header table: phys. properties of
hydrocarb.: Description
12 (for LPG)
Physical properties data table
48 (for LPG)
T100C
Configurable message handling – SAP QCI
9
TBRG
Authorization groups
2
TBRGT
Authorization Group Names
2 (EN only)
USR10
User master authorization profiles
2
USR11
User Master Texts for Profiles (USR10)
2
USR12
User Master Authorization Values
10
USR13
Short Texts for Authorizations
10 (EN only)
UST10S
User master: Single profiles
5
UST12
User master: Authorizations
12
OIB_PPP_DATA
CTG 10B Reference Manual – CSP03 v00
62
5.5
Conversion group mapping to bulk oil & gas products
QuantityWare conversion groups (and the associated reading groups and range groups) follow
the QuantityWare naming convention as described in the table below:
Conversion group
Product group
Q00* - Q0U*
Products handled by industry practice formula (e.g. linear density
correction)
Crude Oil & Products
ASTM D 1250
Q0V* - Q0Z*
ASTM D 1250-52 products
Q1*
Crude Oil
Q2*
Refined Products
Q3*
Special Applications “Chemicals”
Q4*
Lubricating Oils
Other Standards
Q5*
Asphalt, Bitumen, Road Tar
Q7*
LPG – Liquefied Petroleum Gas
Q9*
Industrial Aromatic Hydrocarbons & Bulk Chemicals
QI*
Renewable Fuels & similar products
QS*
Solids (e.g. sulfur)
Natural Gas
QU*
LNG – Liquefied Natural Gas – CTG
QV*
Natural gas – high and low pressure pipeline – CTG
QWWW
MQCI zero model conversion group - technical
CTG 10B Reference Manual – CSP03 v00
63
5.5.1 Accessing the conversion group configuration data – Gas Measurement Cockpit
Via the GMC you display a list of all template conversion groups if you are logged on to the
client where the BC set /QTYW/CTG_10B has been installed:
Start the cockpit using transaction /n/QTYW/COCKPIT_GAS
Choose tab strip “QCI Configuration & Products”
Select “QuantityWare delivery” (note the documentation button for further information)
5.6
Quantity conversion configuration – QuantityWare tables
QuantityWare delivers the complete quantity conversion configuration as part of the template.
These definitions are maintained in SAP and QuantityWare customizing tables. In this section
we list all QuantityWare tables for which QuantityWare delivers template configuration entries
and provide a short content description for each table.
CTG 10B Reference Manual – CSP03 v00
64
5.6.1 List of tables
The following list contains all table names for which entries are delivered. Language-dependent
table entries are delivered in English (EN), French (FR), Spanish (ES) and Portuguese (PT).
Table
/QTYW/FLTP
/QTYW/ASTM_TAB1
Description
Test entry of FLTP to check
BC Set activation
Table for ASTM Table 1
conversion factors
Delivery / Number of entries
1
56
Table for ASTM Table 1 UoM
/QTYW/ASTM_UOM
Mapping (SAP UoM to ASTM
23
UoM)
/QTYW/AIR_Z
/QTYW/COMP_CHEM
/QTYW/GAS_ASSIGN
/QTYW/GAS_MAIN
Dry air compression factors for
conversion groups
Define empirical formula and
atomic component numbers
Assign parameter names for
main gas components
Main natural gas physical
constants
3
57
32
4
ISO 13443 factors for
/QTYW/ISO13443
conversion between ref.
105
conditions
/QTYW/LNG_K1_DET
/QTYW/LNG_K2_DET
/QTYW/LNG_K_HEAD
/QTYW/LNG_OMDET
/QTYW/LNG_OMVOL
ISO 6578 k1 factors (LNG) for
conversion groups
ISO 6578 k2 factors (LNG) for
conversion groups
ISO 6578 Correction factors
for volume reduction (LNG)
ISO 6578 Orthobaric molar
volumes (LNG)
ISO 6578 Orthobaric molar
volumes (LNG)
135
135
15
90
10
CTG 10B Reference Manual – CSP03 v00
65
/QTYW/RDGRD_CHCK
/QTYW/RDGRT_CHCK
/QTYW/READINGCCK
/QTYW/READINGCKT
Definition of Reading Group
Range Check Tables
Description of Reading Group
Check Table Definition
Reading group : Define ranges
for QW checks
Description of reading group
check parameter
133
532 (133 * 4)
1744
6976
Tolerance group for unit of
/QTYW/TOLGRP
measure specific tolerance
1
check
Tolerance group for unit of
/QTYW/TOLGRPT
measure specific tolerance
4
check - description
Tolerance group for unit of
/QTYW/TOLGRP_UOM
measure specific tolerance
17
check – UoM limits
/QTYW/UOM_ROUND
/QTYW/API_RDW
/QTYW/API_RDW_TX
/QTYW/LPG_CON_D
Define UoM rounding for CTG
& CTG
Assignment of Units between
Conv. Group and T006
2
Assignment of Units between
2 (ONLY EN, not visible to
Conv. Group and T006
business user)
LPG ISO 6578:1991 Annex A
normative constants - header
LPG ISO 6578:1991 Annex A
/QTYW/LPG_CON_H
22
& H normative constants header
54 (Q761, Q762, Q763, Q765)
8 (Q761, Q762, Q763, Q765,
Q781, Q782, Q783, Q785)
LPG ISO 6578:1991 Annex A
/QTYW/LPG_CON_HT
normative constants - header
32
text
/QTYW/MQCI_DOC
/QTYW/SORTCOMP
Online MQCI documentation
data
Define sorting sequence of
chemical parameter table
54 (Q7** LPG only)
24
CTG 10B Reference Manual – CSP03 v00
66
5.7
QuantityWare IMG access
You access all configuration data from the GMC via the QuantityWare IMG:
A detailed description is provided in Chapter 7 CTG Customizing Transactions.
CTG 10B Reference Manual – CSP03 v00
67
5.8
Summary
A clearly-defined template of values describing calculations parameters, as well as the
background knowledge as to where the values can be found within SAP DDIC forms the basis
of a reliable quantity calculations environment. Without such an extensive framework, true
transparency and accurate representation of the calculations required by business processes
and their regulatory bodies cannot be practically validated. For the first time in the SAP Oil &
Gas environment, QuantityWare has presented a clearly-defined reference configuration
template to meet customers’ needs.
CTG 10B Reference Manual – CSP03 v00
68
6
SAP QCI Enhancements of Legacy Configurations
6.1
Introduction
There are several ways in which quantity conversion calculations can be approached, all of
which are comprised of distinct “calculation steps”. A sequence of calculation steps, typically
including calculation procedures of measurement parameters, the conversion of different kinds
of quantities (“dimensions” in SAP terminology), as well as rounding procedures, comprise the
basic definition of the conversion model.
Different conversion models are defined in national and international measurement standards
and are in use within the oil & gas and chemicals industries.
Technically, the implementation of a specific model should be independent of the interface by
which the model-based conversion algorithms are accessed.
The standard SAP QCI (Quantity Conversion Interface) provides one calculation model which is
integrated within the technical interface. This model can be enhanced via BAdI (Business Add
In) implementations to a certain extent, but does not allow for deviation from the hard coded
SAP QCI calculation model. In addition to this, extension of the standard SAP model to include
weight and mass calculations in parallel is cumbersome and requires code modifications.
Using the CTG PMC capabilities, your SAP QCI legacy conversion group configuration can be
enhanced considerably without changing your validated calculation logic.
6.2
Parameter range check settings
Within the SAP QCI, you cannot define that certain measurement parameters have to lie within
a specified range of values.
An example would be the natural gas heating value. In the standard SAP Oil & Gas system, you
can enter any value between 0.00001 and 1.000.000.000 MJM (Mega joule per cubic meter),
and the system calculates volume and energy quantity values for any heating value. Typically
several parameters are required for the quantity conversion and data entry can be cumbersome
and, if not checked, lead to erroneous results which may have considerable financial impact on
your business. This is true for automated data input via SAP BAPI as well as manual user data
entry.
CTG 10B Reference Manual – CSP03 v00
69
To provide this important requirement, QuantityWare delivers customizing tables (maintainable
via transaction /QTYW/RANGES or directly from the GMC, which contain for all delivered
reading groups the relevant parameter data sets within the configuration template (client 045)
with initial values for which data range checks can be maintained.
It is not possible to deliver the datasets with preset range values, since these values highly
depend on customer specific business process details. If you select one specific reading group,
you can select all available parameters for which the following data can be maintained:
High level error limit: Any number with up to 6 decimal places
Low level error limit: Any number with up to 6 decimal places
High level warning limit: Any number with up to 6 decimal places
Low level warning limit: Any number with up to 6 decimal places
The unit of measure (UoM) for each parameter
For character format parameters, you can define an exact match or if a value needs to be
excluded.
The CTG range check function can be activated for your SAP QCI legacy conversion groups.
It is not required to maintain all data for all parameters. You can for example
just maintain lower limits (E and W), or just Warning limits.
Technically, the range checks are executed if function
/QTYW/CHECK_PARAM_RANGES is included within the conversion group.
This is true for all CTG conversion groups (Q0* to QI*). As soon as range data
is maintained, the checks are performed for each quantity conversion
calculation.
Example:
CTG 10B Reference Manual – CSP03 v00
70
CTG 10B Reference Manual – CSP03 v00
71
6.3
Conversion group documentation
Via customizing, you document the SAP QCI legacy conversion groups for NGL/LPG ONLY!
CTG 10B Reference Manual – CSP03 v00
72
The conversion model is the SAP QCI model (or customer specific), the weight standard is
typically the SAP QCI air buoyancy factor model (or customer specific). As CTPL standard the
SAP Template supports the GPA TP-25 – COPY of SAP example standard. This documentation
is mandatory if you wish to utilize all GMC tools for your SAP QCI NGL legacy conversion
groups.
6.4
Quantity value synchronization
For CTG usage, QuantityWare has released the MQCI function /QTYW/MQCI_SYNC_EXT_VALUES.
You may implement this function in your SAP QCI BAdI OIB_QCI_ROUND_QTY, to ensure that
external quantity values are always synchronized with internally calculated values:
6.5
Summary
Leveraging the flexibility of SAPs Oil & Gas solution technical design, you considerably enhance
existing SAP QCI functionality, allowing to accurately and transparently represent business- and
regulatory-driven calculation requirements in a single, controlled environment, on demand.
CTG 10B Reference Manual – CSP03 v00
73
7
CTG Customizing Transactions
7.1
Introduction
With CTG 10B, QuantityWare delivers a complete industry configuration template. This template
is delivered as a BC set (SAP ECC 6.00) or as a separate customizing transport (SAP ERP
4.72). QuantityWare strongly recommends installation of this template into exactly one client
(045) in one development system, from where the implementation project team selects the
relevant configuration (via SAP customizing transports) based on customer specific
requirements.
Within this chapter, we provide an overview of CTG customizing transaction access, as well as
some basic documentation on the configuration options provided via customizing options.
7.2
QuantityWare Customizing Transactions
QuantityWare delivers customizing data for CTG 10B that are maintainable via transactions. All
relevant customizing transactions for bulk quantity conversion configuration can be accessed
via the QuantityWare Gas Measurement Cockpit (transaction /n/QTYW/COCKPIT_GAS):
CTG 10B Reference Manual – CSP03 v00
74
Under menu path GOTO you can navigate to the QuantityWare IMG, as well as to the complete
SAP IMG. For fast access, the following transactions can be called directly from the menu:
Gas Conversion Groups - SAP QCI conversion group maintenance
NGL Conversion Groups - SAP QCI conversion group maintenance
Reading Groups - SAP QCI reading group maintenance
Range Groups - /n/QTYW/RANGES
Tolerance Groups - SAP QCI BAdI implementations
UoM Groups - SAP QCI UoM group definition
UoM Rounding - SAP QCI BAdI implementations
Physical Property Data - /n/QTYW/PPP_DATA
Additional Physical Property Data - /n/QTYW/PPP_SUMMATION
ISO 13443 Factors - /n//QTYW/ISO13443
QCI parameters - /n/QTYW/QCI
In order to provide a structured implementation guide (IMG) for all relevant customizing
transactions for bulk quantity conversions, these transactions are collected within the
QuantityWare customizing IMG structure (Transaction SIMGH – IMG Structure “QuantityWare
Solutions”) or you can access the CTG IMG directly via the Gas Measurement Cockpit, Menu:
Goto – QuantityWare IMG and expand the “Compliance & transparency - Gas (CTG)” node:
CTG 10B Reference Manual – CSP03 v00
75
With QuantityWare CTG 10B, all business user-relevant customizing template entries are
delivered in languages English (EN), French (FR), Spanish (ES) and Portuguese (PT) as part of
the CTG 10B BC set. QuantityWare recommends that you perform your configuration work
using the Gas Measurement Cockpit in logon language English (EN). As a last step, you check
and possibly enhance the configuration data in your required language. With CTG 10B, you
may also launch the GMC in all other logon languages. The Cockpit UI is currently only
available in English (EN).
In detail, the following configuration data is translated within the CTG 10B template:
All UoM definitions (dimensions, ISO/UNECE codes, UoM short and long texts)
All conversion group definitions (header texts)
All reading group definitions (header texts and individual parameter descriptions)
All range group definitions (header texts and individual parameter descriptions)
All UoM group definitions (header texts)
7.3
Summary
Via a comprehensive IMG structure, the complex and detailed customizing required for modern
quantity conversions can be accessed and governed in an efficient and transparent manner.
CTG 10B Reference Manual – CSP03 v00
76
8
Natural Gas Components – Physical Properties Data
8.1
Introduction
Common to all comprehensive natural gas conversions is the fact that such conversions require
data sets containing physical property data for all components of the natural gas. Based on
these data, natural gas properties such as compression factors, heating values, molecular
weight and densities can be calculated.
QuantityWare delivers 21 data sets as required content for natural gas, LNG and NGL/LPG
conversions. These data sets are based on six standards:
DIN EN ISO 6976:2005 (English version of ISO 6976:1995 incl. Corrigendum 1:1997,
Corrigendum 2:1997 and Corrigendum 3:1999)
ISO 6578:1991, First edition 1991-12-01
GPA 2145-03, Rev.02 (07/07)
GPA 2145-09
GOST 30319.1-96
GOST 22667-82
LNG contracts for example typically specify which data sets have to be applied for custody
transfer measurements and calculations. QuantityWare has selected these data sets based on
an analysis of publicly available contract data. If customers require data sets based on other
standards or other versions of the standards noted above, QuantityWare can deliver such sets
together with the relevant validation test reports as part of the maintenance agreement.
In this chapter, we describe the data sets delivered and how the correctness of the data can be
validated using QuantityWare validation tools.
CTG 10B Reference Manual – CSP03 v00
77
8.2
Physical properties - data set description
The following 22 data sets are contained in CTG 10B, which you can easily access directly from
the Gas Measurement Cockpit:
CTG 10B Reference Manual – CSP03 v00
78
The data sets are displayed:
Data set Q0 is based on GPA 2172-96. Data sets Q1 to Q7 are based on ISO 6976. Each set
contains the relevant physical properties for the 55 possible natural gas components defined in
ISO 6976. The molar heating values are maintained as given in ISO 6976.
Data set Q8 contains data for 13 LNG components defined in ISO 6578. The mass-based
heating values are maintained as given in ISO 6578.
Data set Q9 contains data for 16 NGL/LPG components defined in ISO 6578. The mass-based
heating values are maintained as given in ISO 6578.
CTG 10B Reference Manual – CSP03 v00
79
Sets QA to QH contain the data as defined in GPA 2145. The volume-based heating values are
maintained as given in GPA 2145. For data set QH (NGL/LPG) the mass-based heating values
are maintained.
Data set QI contains data for LPG heating value calculations at 20 °C combustion temperature
defined in ISO 6976.
Data sets QJ, QK and QL contain data defined in GOST 30319.1 and GOST 22667.
In detail, the following data is maintained by QuantityWare:
Molecular weight (molar mass)
Summation factor
Inferior heating value
Superior heating value
Relative density (only QB, QC, QE, QF; QG)
Absolute density (only QJ)
Critical temperature (Only Q9 & QH)
The definition of the summation factor is different in ISO standards and GPA standards.
QuantityWare supports both summation factor definitions. If you define your own data set, you
have to declare which definition you intend to use for the data you maintain. The sets Q1 to QH
are maintained using either definition. Transnational standard GOST 22667 already defines
heating values and relative densities corrected with the compression factor at the reference
conditions. This fact is declared in the additional physical property data set settings as well.
If you navigate from the GMC to “Additional Physical Property Data”
CTG 10B Reference Manual – CSP03 v00
80
You can also define these definitions as rounding settings for property calculations:
Via the GMC, you are also able to print detailed lists of all physical property data sets using the
GPA 2145 format:
CTG 10B Reference Manual – CSP03 v00
81
CTG 10B Reference Manual – CSP03 v00
82
8.3
Fundamental constants and properties of dry air
8.3.1 Fundamental constants
Natural gas quantity conversions need to utilize the proper value of the molar gas constant R.
The value of this constant changes due to progress made in scientific research. The Committee
on Data for Science and Technology of the International Council of Science (CODATA)
publishes data in a consistent way on a regular basis (see http://www.codata.org/ for details).
The accepted value of the molar gas constant R is 8.314 472 J mol-1 K-1(at the time of writing).
This value can also be found at http://physics.nist.gov/cuu/Constants/Table/allascii.txt and is
published in GPA 2145-03. ISO 6976 on the other hand, still references the older value of 8.314
510 J mol-1 K-1. The SAP QCI also utilizes that value based on ISO 6976.
Within CTG 10B, QuantityWare utilizes the value 8.314 510 J mol-1 K-1, to be
consistent with SAP QCI for the SAP QCI conversion groups for the gas
constant R. If you utilize the MQCI conversion groups, you can configure a
conversion group to use any required value for R
8.3.2 Properties of dry air
8.3.2.1 Molar mass
Natural gas quantity conversions utilize compression factors of dry air at various conditions and
the molar mass of dry air for conversion calculations.
Dry air:
ISO 6976 defines the proper value of these constants. For the molar mass of dry air, it defines
the value to be 0.0289626 kg/mol. GPA 2145-03, Rev.02 and GPA 2145-09 define a value of
0.0289625 kg/mol.
Within CTG 10B QuantityWare utilizes the value 0.0289626 kg/mol to be consistent with the
SAP QCI for the SAP QCI conversion groups. If you use the MQCI conversion groups, you can
configure a conversion group to use any desired value.
8.3.2.2 Compression factors
ISO 6976 defines a compression factor of 0.99958 at 15 °C and 101.325 kPa. GPA 2145-03
Rev.02 defines a summation factor of 0.00201 which transforms to a compression factor of
0.99959 (rounded value to five decimal places).
CTG 10B Reference Manual – CSP03 v00
83
Within CTG 10B QuantityWare utilizes the value 0.99958 to be consistent with
SAP QCI for SAP QCI conversion groups. This value can also be reproduced in
the same way as the other relevant values utilizing the virial equation defined in
AGA Report No.8, equation C3-12 (page 131). QuantityWare delivers ABAP
function /QTYW/CALC_ZAIR based on that equation to calculate compression
factors of dry air with an accuracy of 5 decimal places. If you utilize MQCI
conversion groups, you can define in customizing any desired value.
8.4
Tests for physical property data
As part of CTG 10B QuantityWare provides test and validation programs that can be used to
test the installation and also to validate the SAP QCI for natural gas conversions.
The test reports are accessible from the GMC:
CTG 10B Reference Manual – CSP03 v00
84
The validation reports check that each component value is identical with the hard coded values
within the report datasets.
You are also able to print a comprehensive list of the data set values:
CTG 10B Reference Manual – CSP03 v00
85
8.5
Summary
The ability to define physical property data is revolutionary advance within the SAP Oil & Gas
solution. With the accurate definition of such data, it is possible to apply SAP Oil & Gas
business process logic to allow the processing of new materials within an ERP system with
great accuracy and transparency.
CTG 10B Reference Manual – CSP03 v00
86
9
Natural Gas & LNG Measurement
9.1
Introduction
This chapter describes basic natural gas and LNG definitions and provides also high level
process summaries, independent of the CTG 10B specific software settings in your system. It is
intended as a detailed guide to understand natural gas measurement and quantity conversion
principles from an engineering/business point of view and provides rough guidance which
conversion groups to choose for which measurement and conversion requirements. Please
refer to the CTG 10B PAIG (Project Assessment & Implementation Guidelines) document in
order to utilize the proven methodology for CTG 10B deployment into your system landscape.
9.2
Basic definitions of natural gas quantities and measurements
Besides serving as a basic feedstock for the chemical industry, natural gas is predominantly
used for heat production as a fuel in large industry sites and millions of households worldwide.
In order to define a trading value for natural gas and to ensure natural gas interchangeability,
certain quantities that characterize natural gas must be defined and recorded in business
transactions for various processes e.g. inventory management, quality assurance, pricing and
excise duty payments. For a comprehensive list of such quantities we recommend ISO standard
ISO 6976 as a reference.
In order to aid the comprehension of the CTG 10B documentation, we cite the most important
definitions from standards ISO 13443, ISO 12213, ISO 6976 & ISO 6578 and GOST 30319 as a
reference, as well as GPA 2145 and GPA 2172.
9.2.1 Common definitions
9.2.1.1 Superior calorific value:
The amount of heat which would be released by the complete combustion in air of a specified
quantity of gas, in such a way that the pressure p1 at which the reaction takes place remains
constant, and all the products of combustion are returned to the same specified temperature t 1
as that of the reactants, all of these products being in the gaseous state except for water formed
by combustion, which is condensed to the liquid state at t1.
CTG 10B Reference Manual – CSP03 v00
87
A synonym for calorific value is the term heating value. Calorific values can be
specified on a molar or mass basis. Then the calorific value depends on the
combustion reference conditions t1 and p1. More commonly, calorific values are
determined based upon a volumetric basis ;in this instance, the calorific value
needs to be specified with the combustion reference conditions t 1 and p1 as well
as the volumetric reference conditions t2 and p2.
9.2.1.2 Inferior calorific value:
The amount of heat which would be released by the complete combustion in air of a specified
quantity of gas, in such a way that the pressure p1 at which the reaction takes place remains
constant, and all the products of combustion are returned to the same specified temperature t1
as that of the reactants, all of these products being in the gaseous state.
9.2.1.3 Density:
The density is the mass of a gas sample divided by its volume at specified conditions of
pressure and temperature.
9.2.1.4 Relative density:
The density of a gas divided by the density of dry air of standard composition (see Annex B ISO
6976:1995 for a definition of dry air) at the same specified conditions of pressure and
temperature.
9.2.1.5 Wobbe index:
The superior calorific value on a volumetric basis at specified reference conditions, divided by
the square root of the relative density at the same specified metering reference conditions.
The Wobbe index is an important quality designation for natural gas, which is
commonly used to determine trade prices and the interchangeability of natural
gas.
The SAP QCI does not calculate the Wobbe index for natural gas. CTG
contains functions to perform these calculations within the delivered global
templates. All MQCI CTG conversion groups calculate all possible gas property
values including the Wobbe index.
CTG 10B Reference Manual – CSP03 v00
88
9.2.1.6 Gas interchangeability:
An important business requirement when trading natural gas is that natural gas combustion is
kept at a defined quality levels that are e.g. required by burners. The Wobbe index (sometimes
also referred to as Wobbe number) can serve as one important quality number to ensure
interchangeability of natural gas batches with e.g. an apparent different composition.
9.2.1.7 Ideal gas and real gas:
An ideal gas is one that obeys the ideal gas law:
…(1)
p . Vm = R . T
where
p
is the absolute pressure
T
is the thermodynamic temperature
Vm
is the volume per mole of gas
R
is the molar gas constant, in coherent units.
No real gas obeys this law. For real gases, equation (1) must be rewritten as
…(2)
p . Vm = Z(T,p) . R . T
where Z(T,p) is a variable often close to unity and is known as the compression factor.
9.2.1.8 Compression factor:
The actual (real) volume of a given mass of a gas at specified pressure and temperature divided
by its volume, under the same conditions, as calculated by the ideal gas law.
9.2.1.9 Combustion reference conditions:
The specified temperature t1 and pressure p1. These are the conditions at which the fuel
(natural gas) is notionally burned.
9.2.1.10
Metering reference conditions:
The specified temperature t2 and pressure p2. These are the conditions at which the amount of
the fuel to be burned is notionally determined; there is no a priori reason for these to be the
same as the combustion reference conditions.
A range of reference conditions is in use globally. In order to ensure ease of
trade, exact conversions of natural gas quantities between different sets of
reference conditions is required, based on international standards. This range
CTG 10B Reference Manual – CSP03 v00
89
of different reference conditions is also one of the main reasons why natural
gas quantity conversions are complex, even in the low pressure regime.
9.2.1.11
Standard reference conditions of selected countries:
Country
t1
p1
t2
p2
Argentina
-
101.325 kPa
15 °C
101.325 kPa
Australia
15 °C
101.325 kPa
0 °C
101.325 kPa
Austria
25 °C
101.325 kPa
0 °C
101.325 kPa
Belgium
25 °C
101.325 kPa
0 °C
101.325 kPa
Brazil
-
101.325 kPa
0 °C
101.325 kPa
Canada
15 °C
101.325 kPa
15 °C
101.325 kPa
China
20 °C
101.325 kPa
20 °C
101.325 kPa
Czechoslovakia
25 °C
101.325 kPa
20 °C and 0 °C
101.325 kPa
Denmark
25 °C
101.325 kPa
0 °C
101.325 kPa
Egypt
-
101.325 kPa
15 °C
101.325 kPa
Finland
-
101.325 kPa
15 °C
101.325 kPa
France
0 °C
101.325 kPa
0 °C
101.325 kPa
Germany
25 °C
101.325 kPa
0 °C
101.325 kPa
Hong Kong
-
101.325 kPa
15 °C
101.325 kPa
Hungary
-
101.325 kPa
0 °C
101.325 kPa
India
-
101.325 kPa
0 °C
101.325 kPa
Indonesia
-
101.325 kPa
0 °C
101.325 kPa
Iran
-
101.325 kPa
15 °C
101.325 kPa
Ireland
15 °C
101.325 kPa
15 °C
101.325 kPa
Italy
25 °C
101.325 kPa
0 °C
101.325 kPa
Japan
0 °C
101.325 kPa
0 °C
101.325 kPa
Netherlands
25 °C
101.325 kPa
0 °C
101.325 kPa
New Zealand
-
101.325 kPa
15 °C
101.325 kPa
Norway
-
101.325 kPa
15 °C
101.325 kPa
CTG 10B Reference Manual – CSP03 v00
90
Pakistan
-
101.325 kPa
15 °C
101.325 kPa
Romania
25 °C
101.325 kPa
15 °C and 0 °C
101.325 kPa
Russia
25 °C
101.325 kPa
20 °C and 0 °C
101.325 kPa
Spain
0 °C
101.325 kPa
0 °C
101.325 kPa
Sweden
-
101.325 kPa
0 °C
101.325 kPa
United Kingdom
15 °C
101.325 kPa
15 °C
101.325 kPa
USA
15 °C
101.325 kPa
15 °C
101.325 kPa
Yugoslavia
0 °C
101.325 kPa
0 °C
101.325 kPa
Cited from: ISO 13443 and ISO 12213.
ISO 6976 specifies six sets of reference conditions for heating values on a volumetric basis
(Table 5 therein), which can be extracted from the above table, and one additional set (25/15) is
apparently in use in some countries. QuantityWare defines a global template for the SI system
based on six sets of combustion and metering reference conditions, plus an additional three
(SAP QCI) and four sets (MQCI) of U.S. customary conditions.
9.2.1.12
Liquefied natural gas (LNG):
Liquids composed predominantly of methane.
9.2.1.13
Orthobaric density:
The mass of the liquid occupying the unit volume at a given temperature, the liquid being in
equilibrium with its vapor.
9.2.1.14
Orifice meter:
Pipeline transmission of natural gas requires metering devices that calculate the total volume
(or mass) flow rate of natural gas for a given time period, based on e.g. pressure and
temperature conditions at specific metering points.
For natural gas flow rate measurements, the following definition (as defined in
AGA report no. 3) has to be considered.
An orifice meter is a fluid flow measuring device that produces a differential pressure to infer
flow rate. The meter consists of the following elements:
CTG 10B Reference Manual – CSP03 v00
91
A thin, concentric, square-edged orifice plate
An orifice plate holder consisting of a set of orifice flanges (or orifice fitting) equipped with
the appropriate differential pressure sensing taps
A meter tube consisting of the adjacent piping sections (with or without flow conditioners)
A detailed list of all orifice engineering and technical terms and their definitions
can be found in AGA report no. 3, part 1: “General equations and uncertainty
guidelines”.
9.3
High level description of the basic measurement principles
9.3.1 Natural gas – gaseous state
In the gaseous state, natural gas is transmitted through pipeline systems that easily span
thousands of miles. Storage for demand buffering and fluctuating seasonal demand is
organized through the use of large underground caverns or special high pressure storage pipe
systems.
After extraction, natural gas typically flows at low pressures to gas processing (gas plant)
facilities, where it is “cleaned” (removal of unwanted components e.g. corrosives such as
hydrogen sulfide, water etc. and extraction of high value components e.g. butane, propane etc.).
In order to transmit commercially relevant quantities over large distances, high pressure
pipelines are then fed with pipeline quality gas, where compressor stations along the line ensure
that the gas flows at high pressures to the destination locations (e.g. large utility companies or
industrial consumers). Finally, end consumer delivery is achieved by a wide-spread pipeline
network operating at low pressure conditions again.
From a measurement and quantity conversion point of view, we distinguish here between low
and high pressure regimes for natural gas. The definitions of these two regimes vary according
to the literary source. We have decided to utilize the ISO standard 13443:1996(E) temperature
and pressure range given therein in Annex B (informative) to define the low pressure range,
where the pressure range for reference condition conversions is given as
95 kPa < p < 105 kPa, which is approximately: 13.78 PSI < p < 15.23 PSI.
The temperature range is given as 270 K < T < 300 K which is approximately: 26 °F < T < 80 °F.
Within that range, the ideal gas law and the correction formulas for real gases can be applied as
given in ISO 13443.
High pressure transmission introduces additional calculation complexity.
CTG 10B Reference Manual – CSP03 v00
92
Business partners (e.g. sellers, buyers, transmission companies, utility
companies) trading natural gas, need to distinguish whether they operate in the
low pressure or high pressure regime.
9.3.1.1 Low pressure regime
If business partners operate in the low pressure regime or if high pressure data is already
converted into low pressure volumes at defined conditions, conversion groups defined for low
pressure calculations are sufficient to define supply chain processes within the SAP Oil & Gas
system.
Typically, as a minimum requirement, a heating value (and density value) at specified standard
reference conditions is supplied by a transmission company for a certain amount of natural gas
at metering conditions. With this information, volumes, masses and energy quantity values can
be calculated, also at standard reference conditions required by other business partners (e.g.
buyers) that differ from the transmission conditions but are within the ISO 13443 ranges.
9.3.1.2 High pressure regime
If business partners operate in the high pressure regime, the calculation of volume, mass and
energy quantity values, as well as the Wobbe index requires a “compression factor”. This factor
can be calculated using methods defined in ISO 12213.
The CTG 10B template contains conversion groups that can be utilized if the
business partners agree to calculate quantities based on the GERG88
method, which is described in ISO 12213-3
Alternatively, the partners may agree to base their trading agreements
(contracts) on AGA8 gross methods 1 or 2, which are defined in AGA Report
8 (“Compressibility Factors of Natural Gas and other related Hydrocarbon
Gases” AGA Transmission Measurement Committee Report No. 8, Second
Edition, November 1992, 2nd Printing July 1994, API MPMS Chapter 14.2,
Second Edition, Revised August 1994, Reaffirmed, February 2006)
If the complete molar composition of the natural gas is known, the AGA8
detailed characterization method described also in ISO 12213-2 is applicable.
Based on this molar composition, all parameters such as heating values,
densities and compression factors can be calculated. The CTG 10B template
contains predefined conversion groups based on this standard as well
CTG 10B Reference Manual – CSP03 v00
93
Russian transnational standard GOST 30319.2 provides four different
methods to calculate compression factors, two gross methods (NX19mod and
GERG91) as well as AGA8 and VNIC SMV for detailed calculations. The CTG
10B template contains predefined conversion groups based on this standard
as well
9.3.2 LNG
While natural gas in the gaseous state is transmitted through pipelines, LNG (Liquefied Natural
Gas) offers the possibility to supply global locations that cannot be reached via pipelines, e.g.
Japan, South Korea and Taiwan, via special LNG tankers. In addition, LNG composition, due to
the liquefaction process where components are removed, results in the delivery of a higher
heating value product to the market.
Simply put, LNG is natural gas with a specified composition (high methane content, low levels of
corrosive components and components that would solidify during liquefaction) that is cooled
down to cryogenic temperatures (typically at, or slightly below the melting point of methane approximately minus 161 °C). At such low temperatures the gas condenses into a liquid and
experiences a volume reduction to approx. 1/600 when compared to the same amount in
gaseous form. Using special tankers with insulated tanks, LNG can be shipped across oceans
to reach locations where pipelines are not feasible, due to geographical, political or
environmental obstacles. At present (2009) approximately 200 LNG tankers are available
globally. The LNG market is expected to show high growth rates within the next decades. The
rising demand for clean and reliable energy from LNG at an increasing number of locations
justifies large investments – in liquefaction, storage and regasification sites, as well as LNG
tankers. As an example of increasing interest and investment, tanker capacities are growing;
the latest plans include tankers with 250.000 cubic meter capacity, at initial investments of
approx. 200 Million US Dollars for one tanker.
From a measurement point of view, during custody transfer of the liquid (LNG), the LNG’s
density, molar composition and heating value are required; typically, molar composition is
determined from several samples taken during transfer. Using the transfer samples, gas
chromatography is applied to determine the composition (e.g. mol % of all components) of LNG,
which can then be utilized to calculate the LNG density and heating values, as well as the
density of the gaseous state at any desired reference condition. On a high level, the LNG
process can be divided into the following steps:
1) Production of the natural gas
CTG 10B Reference Manual – CSP03 v00
94
2) “Sweetening”, Removal of undesired components and Liquefaction (“Liquefaction
trains”) at LNG loading sites and the storage of LNG in large tanks for shipment with
LNG tankers
3) Liquefied product transfer to LNG tankers (shore – to ship ) – Custody transfer point
4) Shipping to receiving countries - LNG custody transfer into receiving storage tanks
5) Regasification of LNG into pipeline network (high pressure) and distribution to end
consumers (low & high pressure connectivity)
Both LNG and natural gas (gaseous) measurement and conversion are typically based on the
molar composition analysis of the natural gas’ individual components. The physical properties of
these components must be known before accurate calculations can be attempted.
9.4
Summary
The accurate parameter definition required for a realistic ERP-based business implementation
of the materials being handled in daily physical processes is only possible with a detailed
technical and process knowledge. Configurators must work closely in conjunction with
engineering/business representatives to achieve this as it is the basis for the calculation
framework.
CTG 10B Reference Manual – CSP03 v00
95
10 Measurement Cockpit - Security
With BCS CSP03, additional authority profiles, single roles and example composite roles for
PMC and GMC access and usage (including SAP QCI legacy RFC and “call system” test
reports) are defined, implemented and shipped.
13 technical authorization objects are the basis for all single roles:
CTG 10B Reference Manual – CSP03 v00
96
15 single roles are available:
These single roles encompass all Petroleum and Gas Measurement capabilities for which a
user may be granted authority.
No additional QuantityWare authority check is performed during actual quantity
conversion calculations in business transactions - all QuantityWare
implementations are ABAP based calculations which are already secured via
the standard SAP-suggested security concepts implemented in these
transactions.
CTG 10B Reference Manual – CSP03 v00
97
4 composite roles are delivered as examples:
All roles are documented and accessible via standard SAP role maintenance. Role
Y_QTYW_CR_ALL must be assigned to the user ID which is used to run the QuantityWare
implementation and installation test in client 045.
We recommend all existing customers to analyse and replace their current
QuantityWare authorisations with the new role-based authorisations.
CTG 10B Reference Manual – CSP03 v00
98
11 Protection of Intellectual Property
With QuantityWare BCS 10B, QuantityWare delivers a powerful and unique quantity conversion
solution to the oil & gas industries. Technically, the solution is delivered as a certified SAP AddOn to the Oil & Gas solution. In order to enhance customer security and protect QuantityWare
GmbH’s intellectual property (IP), four protection measures have been defined as an integral
part of the technical ABAP solution:
Every BCS customer requires a valid software license key in order to execute quantity
conversions. The license key is checked each time a quantity conversion is triggered
The ABAP source code that implements the license check logic, the QuantityWare MQCI
and all central ABAP implementations of CTPL / Compression Factor standards are
hidden using standard SAP methods
The ABAP source code that implements the license check logic, the QuantityWare MQCI
and all central ABAP implementations of CTPL / CTPG standards are technically
defined – again using standard SAP methods – to be SAP system programs and thus
can e.g. NOT be debugged
All code comments marked internally with */ and empty lines are removed from all BCS
ABAP sources
Measurement standards can be divided into four major classes:
Standards defining the conversion factors between units of measure “of the same kind”
Standards defining the corrections of the effect of temperature and pressure onto the
liquid or gas (CTPL / CTPG)
Standards defining the mass to weight conversions
Standards defining the quantity conversion calculation model
Since CTPL / CTPG standards are the most complex to implement and on the other hand, once
correctly implemented, do not require any code changes, all such implementations are hidden
and cannot be debugged in customer systems. The functional accuracy and correctness of such
implementations is validated via dedicated implementation test programs (based on
implementation tests defined in the related measurement standards) and list printing reports
(accessible via the PMC or GMC) and can be reproduced and tested by each customer without
having to investigate the ABAP source code. Software license installation is documented in the
CTG 10B Reference Manual – CSP03 v00
99
BCS 10B Technical Installation Guide. Here we document which ABAP sources are hidden and
set to be SAP system programs with BCS CSP03. BCS 10B is delivered in four software
packages:
/QTYW/QCI – contains the MQCI Interface function group, MQCI technical service
function groups, Web Service function groups and all MQCI model implementations
/QTYW/BCC – contains common (Gas & Petroleum) BCS tools and measurement
standard implementations
/QTYW/BCP – contains BCP tools and measurement standard implementations
/QTYW/BCG – contains BCG tools and measurement standard implementations
The following table contains the list of function groups and individual ABAP sources which are
hidden before delivery of BCS CSP03 and are set to be a SAP system program.
Number of
Objects
Package
Function Group
(Functions
Comments
&
Includes)
/QTYW/QCI
/QTYW/MQCI
26
QuantityWare MQCI implementation
/QTYW/BCC
/QTYW/API_MPMS_11_2_1
5
CPL Implementation
/QTYW/BCC
/QTYW/ISONG
20
ISO natural gas CTPG implementations
/QTYW/BCC
/QTYW/ISO_6578_LPG
11
LPG CTP implementations – ISO 6578
/QTYW/BCC
/QTYW/STANDARDS_COM
22
LPG CTP & CTG implementations
/QTYW/BCC
/QTYW/ASTM_TABLES_33_34
3
LPG ASTM Table 33 & 34 implementation
/QTYW/BCP
/QTYW/D1250_04
115
ASTM D1250-04 CTPL implementation
/QTYW/BCP
/QTYW/D1250_52
23
South America CTL implementation 1952
/QTYW/BCP
/QTYW/D1250_52_TABLES
09
ASTM D1250-52 CTL implementations
/QTYW/BCP
/QTYW/SAPLD1250_52_TABLES_2
3
/QTYW/BCP
/QTYW/D1250_80_F
39
ASTM D1250-52 CTL implementations
ASTM D1250-80 CTL implementations –
FORTRAN – NOT RELEASED to customers
ASTM D1250-80 CTL implementations – API
/QTYW/BCP
/QTYW/D1250_80_Q
53
/QTYW/BCP
/QTYW/D1555_04
09
ASTM D1555-04/08/09 CTL implementation
/QTYW/BCP
/QTYW/D4311_04
7
ASTM D4311-04 CTL implementation
/QTYW/BCP
/QTYW/D4311_09
5
ASTM D4311-09 CTL implementation
C emulation– RELEASED to customers
/QTYW/BCP
/QTYW/CNP_6_70
4
C.N.P. 6 – 70 Table 2 CTL implementation
/QTYW/BCP
/QTYW/D1550_BUTADIENE
10
ASTM D1555-09 CTL implementation
CTG 10B Reference Manual – CSP03 v00
100
/QTYW/BCP
/QTYW/D2962_07
3
ASTM D2962-07 CTL implementation
/QTYW/BCP
/QTYW/D633_97
5
ASTM D633-97 CTL implementation
/QTYW/BCP
/QTYW/DIN51650
27
DIN 51757 Y method CTL implementation
/QTYW/BCP
/QTYW/DIN51757
6
DIN 51757 X method CTL implementation
/QTYW/BCP
/QTYW/EN14214_FAME
4
BS EN 14214 CTL implementation
/QTYW/BCP
/QTYW/NBR5992_08
5
ABNT NBR 5992-08 CTL implementation
/QTYW/BCP
/QTYW/NBR5992_EXT
6
ABNT NBR 5992-80 CTL implementation
/QTYW/BCP
/QTYW/STANDARDS
11
Linear model CTL implementation
/QTYW/BCP
/QTYW/Z13M
11
Table 13 Z south America implementation
/QTYW/BCG
/QTYW/AGA83
32
AGA Report No. 3 & 8 CTPG implementation
/QTYW/BCG
/QTYW/CONNECTORS
12
SAP QCI connectors for natural gas
/QTYW/BCG
/QTYW/GOST_30319_1
12
GOST 30319 CTPG implementations
/QTYW/BCG
/QTYW/GOST_30319_2
7
GOST 30319 CTPG implementations
/QTYW/BCG
/QTYW/GOST_30319_2_VNIC
6
GOST 30319 CTPG implementations - VNIC
/QTYW/BCG
/QTYW/ISO_LNG
13
ISO 6578 LNG CTL implementation
/QTYW/BCG
/QTYW/SGERG_88
8
GERG 88 CTPG implementation
/QTYW/BCG
/QTYW/LLNG_CONVERSION
3
SAP QCI LNG connector
/QTYW/IMPLEMENTATION_TEST
/QTYW/INSTALL_LICENSE
/QTYW/COCKPITF01
/QTYW/COCKPITF01_GAS
SINGLE
SOURCE
SINGLE
SOURCE
SINGLE
SOURCE
SINGLE
SOURCE
BCS implementation test report (client 045)
BCS licence installation (via cockpits)
Program NOT set as system program
Program NOT set as system program
539
TOTAL
SOURCES
HIDDEN
If required, it is still possible to debug SAP QCI or MQCI calculation model
steps for any conversion group in customer systems, since the CTPL
implementation results (typically calculating a base density or CTPL factor) can
be accepted as being correct during debugging and can be validated
independently (using the validation procedures described above which are
available in the PMC and GMC)
CTG 10B Reference Manual – CSP03 v00
101
12 Abbreviations
In this section we provide a list of abbreviations used in the CTG 10B documentation
documents. For detailed explanations of the terms, refer to the individual CTG 10B
documentation documents:
ABNT Associação Brasileira de Normas Técnicas (Brazilian National Standards Organization)
AGA
American Gas Association
API
(1) American Petroleum Institute
API
(2) SAP commercial key for API gravity unit
ASTM ASTM International (originally, “American Society for Testing and Materials”)
BAdI
Business Add In (SAP term)
BCG
Bulk Calculations - Gas
BCP
Bulk Calculations - Petroleum
BCS
Bulk Calculations Solution
BCU
Base Conversion Unit
BTI
BaTch Input (SAP term)
CSP
Component Support Package
CTG
Compliance & Transparency – Gas
CTP
Compliance & Transparency – Petroleum
CTPL Correction factor for the effects of Temperature and Pressure on the Liquid
DIN
Deutsches Institut für Normung e.V.
GERG Groupe Européen de Recherches Gazières
GMC
Gas Measurement Cockpit
GOST Gossudarstwenny Standard – Russian standard organization
GPA
Gas Processors Association
GRC
Governance, Risk management & Control
HPM
Hydrocarbon Product Management (SAP term)
LNG
Liquefied Natural Gas
CTG 10B Reference Manual – CSP03 v00
102
LPG
Liquefied Petroleum Gas
MQCI Model based Quantity Conversion Interface
MPMS Manual of Petroleum Measurement Standards (API term)
NGL
Natural Gas Liquids
NIST
National Institute of Standards and Technology
PAIG
Project Assessment and Implementation Guidelines
PMC
Petroleum Measurement Cockpit
QCI
Quantity Conversion Interface (SAP term)
ROI
Return On Investment
SI
Système International d’unités
TD
Transportation and Distribution (SAP term)
TSW
Traders and Schedulers Workbench (SAP term)
UoM
Unit of Measure or Unit of Measurement
VCF
Volume Correction Factor
CTG 10B Reference Manual – CSP03 v00
103
13 Specific CTG documentation rules
The decimal point and thousand separators for numbers and quantity values for
CTG 10B documentation documents are defined as follows: The decimal point
is a dot ‘.’, the thousand separator is a comma ‘,’. Example: 123,456.987.
Owing to the definition of business-relevant scenarios in our systems, numbers
in screen prints may display differing formats.
For unit of measure symbols and spelling of unit names, NIST special
publication 811 (latest version) is relevant – see the document “CTG 10B
supported standards” for details
CTG 10B Reference Manual – CSP03 v00
104
14 Basic System Settings
In order to use the SAP QCI conversion groups delivered with the CTG 10B template, you have
to activate the SAP basic natural gas conversion routines in customizing. Go to:
Industry Solution Oil & Gas (Downstream)  HPM (Hydrocarbon Product
Management)  Petroleum Measurement Standards  Quantity Conversion
Interface (QCI) Configuration  Activate SAP conversion routines for natural
gas
Here, you can activate the SAP natural gas routines. Afterwards, run the validation and test
report. If no errors are reported, productive usage of the SAP QCI with CTG 10B for natural gas
is possible.
The QuantityWare MQCI conversion groups do not require this activation.
CTG 10B Reference Manual – CSP03 v00
105