Business Warehouse Naming Standards

advertisement
BW Object Naming Standards
Overview
Purpose:
The purpose of defining strict naming standards for BW objects is to ensure the entire
project team is consistent in the approach to creating and identifying objects in the BW
system. The following BW objects are covered by this document.
Table of Contents:
InfoProvider ........................................................................................................................ 2
InfoSource ........................................................................................................................... 5
DataStore Object ................................................................................................................. 5
InfoObject ........................................................................................................................... 6
Query................................................................................................................................... 6
Query View ......................................................................................................................... 7
Report.................................................................................................................................. 8
Web Template ..................................................................................................................... 8
Restricted Key Figures ........................................................................................................ 9
Calculated Key Figures ....................................................................................................... 9
Variables ........................................................................................................................... 10
Structures .......................................................................................................................... 11
InfoPackages ..................................................................................................................... 11
Process Chain .................................................................................................................... 12
Application Component .................................................................................................... 12
Flat Files............................................................................................................................ 13
Custom Generic Extractors ............................................................................................... 13
Datasource......................................................................................................................... 13
Aggregates ........................................................................................................................ 14
Page 1 of 14
BW Object Naming Standards
InfoProvider
Definition:
Analysis-relevant view of a BW object for which queries in SAP BW can be created or
executed.
There are two types of InfoProviders. One type includes objects that contain physical
data. These are known as data targets, such as InfoCubes, ODS objects, and InfoObjects
(characteristics with attributes, texts, or hierarchies). The other type includes objects that
contain no physical data storage, but make the data available for viewing. This includes
objects such as InfoSets, RemoteCubes, VirtualCubes, and MultiProviders. An
InfoProvider contains two types of data: key figures and characteristics. InfoProvider
Definitions and naming conventions are as follows.
InfoCube
Definition:
An InfoCube is a set of relational tables that are arranged in a star schema with a
large fact table for recording transaction data at the center and several dimension
tables surrounding the fact table. The fact table contains the key figures of the
InfoCube, while the dimension tables contain the characteristics of the cube.
InfoSources (see below) supply data to InfoCubes.
MultiProvider
Definition:
Type of InfoProvider that combines data from several InfoProviders and makes it
available for reporting.
The MultiProvider itself contains no data; its data comes exclusively from the
InfoProviders on which it is based (collated using a union operation). A
MultiProvider can be assembled from different combinations of InfoProviders.
MultiProviders, like InfoProviders, are objects or views that are relevant for
reporting.
RemoteCube
Definition:
RemoteCube is not managed in the Business Information Warehouse, but rather
externally.
Only the structure of the RemoteCube is defined in BW. The data for reporting is
read from another system using a BAPI.
Page 2 of 14
BW Object Naming Standards
VirtualCube
Definition:
VirtualCubes are enhanced versions of RemoteCubes. VirtualCubes call selfdefined function modules (local or remote programs) that behave like a fact table.
Similar to RemoteCubes, the data for reporting is read from another system using
a BAPI.
InfoSets
Definition:
A semantic view of InfoCubes, ODS objects and InfoObjects (characteristics with
master data) that allows you to create reports on these objects, particularly on the
joins between these objects.
Unlike the classic InfoSet, this view of data is BW-specific. InfoSets are created
and changed in the InfoSet builder. InfoSets allow you to use the Query Designer
to define reports.
InfoProvider Naming:
The InfoProvider naming convention will follow as close as possible the SAP
standard naming convention in BW. In most cases, the technical name of the
Business Content InfoProvider can be used by dropping the leading 0 and
replacing it with a Z. Therefore for custom InfoProviders the format of the
technical name will be as follows:
Zmmffxnn
 mm = primary module (FI, HR or ST)
 ff = functional area (minus hyphens, i.e. CO-PA use CO)
 x = type of infoprovider,
o M = MultiProvider
o C = InfoCube
o R = RemoteCube
o V = VirtualCube
o I = InfoSet.
 nn = two-digit number
If no or minor changes are made to an InfoProvider, the Business Content name is
to be used, i.e. - 0CCA_C02.
A Custom InfoProvider has a limit of 9 characters for the technical name. If a
problem occurs with length of the technical name when trying to name a custom
InfoProvider by just changing the first character (0) to a Z, please use the
following process:
 eliminate the 0 after “x”.
The following table lists the commonly used functional area abbreviations that
replace ff in the above definition.
ff Description
 CO – Financial / Controlling
Page 3 of 14
BW Object Naming Standards
 AA – Asset Accounting
 AP - Accounts Payable (contains sensitive vendor attributes)
 AR - Accounts Receivable
 GL – General Ledger Accounting
 TV – Travel Management
 TR - Treasury
 CP – Product Cost Controlling
 OM – Overhead Cost Controlling
 FM - Funds Management
 GM - Grants Management
 BC – Personnel Budget Planning
 PM – Plant Maintenance
 SL - Special Purpose Ledger
 PS – Project System
 IM – Inventory Management
 HM - Human Resource
 PY - Payroll
 BN - Benefits
 PT - Time Management
 OM - Organizational Management
 RC – Recruitment
 ER – E-Recruitment
 CM – Compensation Management
 PA - Personnel Administration
 CT – Cross-Application Time Sheet
 CP – Personal Cost Planning
 AS - Academic Structure
 SL - Student Management
 TC - Technical Content
If the cube is a copy of an existing SAP standard cube then the two-digit number
should be the same as the cube copied. If the cube has been fully customized then
the two-digit number must be sequentially assigned in the range 50 to 99.
Examples:
1. A copy has been made of the Costs and Allocations (Marginal Costs)
standard cube (technical name = 0CCA_C02) and a number of additional
InfoObjects have been created and a new cube is necessary. The technical
name of the new cube should therefore be ZFICAC02.
2. A material movements cube has been created from scratch to track
inventory transactions by movement type. The technical name of this cube
would be ZFIICC50.
3. Multi-Cube: Example: ZFISDM50.
Z – custom SD – functional area of the cubes that feed the Multi-Cube
M – Multi-Cube 50 – number of the cube
Page 4 of 14
BW Object Naming Standards
InfoSource
Definition:
An InfoSource is a set of logically associated information that can contain transaction
data (stored in InfoCubes) and master data (attributes, texts, and hierarchies stored in
separate tables). InfoSources describe all the information available for a business
transaction or type of business transaction (for example, cost center accounting).
InfoSource Naming
The format of the name will be as follows:
 Transaction Data: InfoSource = DataSource Technical Name
 Long Description = DataSource Description
 Master Data: Select InfoObject, the technical name and description will be
assigned from the InfoObject.
DataStore Object
Definition:
A DataStore object contains supporting information for the BW InfoCubes. It may be
used to contain information at a more detailed level than the summarized InfoCube
information; or it may contain information combined from multiple sources. This data is
accessible via queries and the Bex analyzer and browser, or via an infoset query.
DataStore Naming:
The DataStore object naming convention will follow as closely as possible to the SAP
standard naming convention in standard BW. The format of the name will be as follows:
Zmmff_Onna
 mm = primary module (FI, HR or ST)
 ff = functional area (minus hyphens, i.e. CO-PA use COPA)
 nn = two-digit number
 a = A, B, C, D, etc for multiple DataStore object’s that feed the same
InfoCube
A custom DataStore object has a limit of 8 characters for the technical name. If a
limitation occurs when naming the DataStore object please try the following:
 eliminate the 0 after O, ZFIPUO1A, ZFIPUO1B
The InfoProvider list (above) shows the commonly used functional area abbreviations
that replace ff in the above definition. The DataStore object should be named according to
the cube it directly supports, if any. If it is fully customized and does not relate to a cube,
it should follow the same scheme for InfoProviders and be assigned a sequential number
in the range 50-99.
Examples:
Page 5 of 14
BW Object Naming Standards
1. A DataStore object has been made to support the Costs and Allocations (Marginal
Costs) standard cube (technical name = 0CCA_C02). The technical name of the
DataStore object should therefore be ZFICAO02.
2. If multiple DataStore objects were created to support ZFICAC02. They would be
called ZFICAO2A and ZFICAO2B. (because of 8 character limitation on
technical name.
3. If multiple DataStore objects were created to support ZSD_C02. They would be
called ZFISDO2A and ZFISDO2B.
InfoObject
Definition:
An InfoObject is a generic term for characteristics and key figures in the Business
Information Warehouse. InfoObjects are used in InfoCubes and in the three structures
that are relevant for data requests—extract, transfer, and communication structures.
InfoObject Naming
Custom InfoObjects should always start with a Z. When a standard SAP InfoObject is
copied the 0 should be dropped from the name and be replaced by Z. A fully customized
InfoObject should also begin with a Z followed by a logical name to describe the
InfoObject. The abbreviations used by SAP for various terms in the standard InfoObjects
should be used where possible. Recognize that replacing a standard business content
InfoObject with a custom Z InfoObject may cause problems because of their use in:
 Authorization Relevance,
 Removing Attributes, or Adding Attributes to an InfoObject affects all
Infoproviders that use the InfoObject.
Only create new Z InfoObjects when a business content InfoObject doesn’t apply or the
InfoObject is being customized for specific use in a InfoProvider.
Examples:
1. A copy of the 0MATERIAL infoobject would be given the technical name
ZMATERIAL.
2. A custom infoobject has to be created to report on the sales quotas. The technical
name would therefore be ZSLS_QUOTA.
Query
Definition:
A query is a data evaluation based on the selection of characteristics and key figures.
Queries can be configured according to the way users want to view and navigate through
data. Users define queries to analyze the data from an InfoProvider.
Page 6 of 14
BW Object Naming Standards
Query Naming:
As queries are created specific to an InfoProvider (InfoCube, DataStore, Master Data,
etc..) it is advisable to identify the respective InfoProvider in the technical name for easy
identification. The naming convention for Super User queries is as follows:
Zcube_Qnnnn
 cube = InfoProvider Name
 Q = constant for queries
 nnnn = four-digit sequential number
The naming convention for Power User queries is as follows:
Ycube_Qnnnn_DDD_III
 cube = InfoProvider Name
 Q = constant for queries
 nnnn = four-digit sequential number
 DDD = Department abbreviation
 III = username of query developer
Customized queries should use sequential numbers in the range 5000 to 9999. If the
InfoProvider and query are copies of standard SAP content the sequential number should
be maintained for the query.
Examples:
1. A custom super user query for infocube ZSD_C04 has the technical name
ZZSD_C04_Q5000. (Standard InfoCube, Custom Query)
2. A custom power user query written by JSMITH for infocube ZIC_C50 would
have the technical name YZIC_C50_Q5000_BSC_JSMITH. (Custom InfoCube,
Custom Query)
3. A copy of query by a power user of 0CCA_C02_Q0004 for infocube
ZCCA_C02 would have the technical name
YZCCA_C02_Q0004_BSC_JSMITH. (Copied InfoCube and Query)
4. A custom super user query for infocube ZCCA_C02 would have the technical
name ZZCCA_C02_Q5000. (Copied InfoCube, Custom Query)
Query View
Definition:
A query view is a “picture” of a query that saves any formatting done in the Bex
Analyzer. An example of this is to hide key figures from the initial display of the report.
Query View Naming
As query views are created specific to an InfoProvider and query, it is advisable to
identify the respective cube and query in the technical name for easy identification. The
standard naming convention is to use the technical name of the query but replace the Q
with a V to designate a View and add _nn, (nn = two-digit sequential number).
Page 7 of 14
BW Object Naming Standards
Examples:
A query view based on query ZZIC_C51_Q5001 would have the technical name
ZZIC_C51_V5001_01
Report
Definition:
A report is a data presentation based on a query or multiple queries. Reports can be
configured according to the way users want to view and navigate through data. Reports
can be dynamic or pixel formatted. Reports are typically viewed through the portal,
although some may be available through BEx Analyzer.
Report Naming:
As reports are not created specific to a single InfoProvider, it is not feasible to include all
InfoProviders in the technical name. It is suggested that the InfoProvider of the primary
or initial query in the report be used in the technical name. The name can be up to 30
characters long.
Zcube_Rnnnn
 cube = InfoProvider Name
 R = constant for reports
 nnnn = four-digit sequential number
The naming convention for Power User queries is as follows:
Ycube _Rnnnn_DDD_III
 cube = InfoProvider Name
 R = constant for reports
 nnnn = four-digit sequential number
 DDD = Department abbreviation
 III = username of report developer
Customized reports should use sequential numbers in the range 5000 to 9999.
Examples:
1. A custom super user report for Grants has the technical name
Z0GM_C02_R5000.
2. A custom power user report for Payroll has the technical name
YZHR_C01_R5000_BSC_JSMITH.
Web Template
Definition:
A Web template is the HTML page that you use to determine the structure of the Web
application.
Page 8 of 14
BW Object Naming Standards
Web Template Naming
As web templates are created specific to an InfoCube and query it is advisable to identify
the respective cube and query in the technical name for easy identification. The standard
naming convention is to use the technical name of the query but replace Q with a T to
designate a template and add _nn, (nn = two-digit sequential number).
Examples:
A web template based on query YZIC_C51_Q5001 would have the technical
name YZIC_C51_T5001_01
Restricted Key Figures
Definition:
A restricted key figure is a key figure that is restricted to certain characteristic values. It
is defined in the query definition and limits the selected data to the values or range of
values selected. It is available for any query created for the InfoProvider of the original
query.
Restricted Key Figure Naming
Restricted key figures are specific to an InfoProvider and therefore will include the
InfoProvider technical name. The format will be as follows:
RKcube_nnnn
 cube =InfoProvider technical name
 nnn = sequential number
Custom restricted key figures will have a sequential number starting at 5000.
Examples:
1. Custom restricted key figure for InfoProvider 0FIFM_C01 would have the
technical name RK0FIFM_C01_5000.
2. Restricted key figures for custom InfoProvider ZIC_C50 would have the
technical name RKZIC_C50_5000.
Calculated Key Figures
Definition:
A calculated key figure is a key figure that is a calculation of one or more other key
figures. Standard, custom, restricted key figures and other calculated key figures can be
used for the calculation. Like Restricted Key Figures, it is also available for any query
created for the InfoProvider of the original query.
Page 9 of 14
BW Object Naming Standards
Calculation Naming
Calculated key figures are specific to an InfoProvider and therefore will include the
InfoProvider technical name. The format will be as follows:
CKcube_nnnn
 cube = InfoProvider technical name
 nnnn = sequential number
Custom calculated key figures will have a sequential number starting at 5000.
Examples:
1. Custom calculated key figure for InfoProvider 0FIFM_C01 would have the
technical name CK0FIFM_C01_5000.
2. A calculated key figure for custom InfoProvider ZIC_C50 would have the
technical name CKZIC_C50_5000.
Variables
Definition:
Variables are selection criteria of a query that are set in the query definition and are not
filled with values until the query is executed (processed) and inserted into a workbook.
They function as a store for characteristic values, hierarchies, hierarchy nodes, texts and
formula elements and can be processed in different ways.
Variable Naming
Following SAP’s naming standard, the format for a variable will be:
Y_nnnnn
 Y:
o S = Selection option variable (range withinclude/exclude/insert)
o I = Interval variable, i.e. the user enters a range of entries
o M = Multiple single values
o P = Parameter variable (single value)
o V = Precalculated value set variable
o T = Text variable
o F = Formula variable
o H = Hierarchy variable
o N = Hierarchy node variable
 nnnnn: Meaningful name based on the InfoObject for which the variable is used
T, F, H and N variables describe the variable type. Whereas S, I and P variables are both
of the type characteristic and the acronym stands for the type of selection criteria. The
abbreviations used by SAP for various terms in the standard variables should be used
where possible. Variables are InfoProvider independent and should therefore not contain
the names of any InfoProviders.
Examples:
1. A custom variable that is used in a query to select on a range of customers would
have the technical name I_CUSTR.
Page 10 of 14
BW Object Naming Standards
2. A custom variable that is used to automatically replace the text of a time
characteristic based on the entry made would have the technical name
T_FYEAR.
Structures
Definition:
Structures are freely definable reports that consist of combinations of characteristics and
basic key figures (for example, as calculated or restricted key figures) of the
InfoProvider. A structure can be a plan / actual comparison or a contribution margin
schema, for example. Structures can be used in several different queries. To do this, it is
necessary to save the structure that may be used again. These structures are then called
reusable structures.
Structure Naming
Following SAP’s naming standard the format for a structure will be:
Scube_nnnn
 cube = infocube technical name
 nnnn = sequential number
Custom structures will have a sequential number starting at 5000.
Example:
A structure that is used in the Sales and Distribution InfoProvider 0SD_O01would
have the technical name S0SD_O01_5000.
InfoPackages
Definition:
InfoPackages are the method that BW uses for loading data from a source system into a
BW PSA. They are associated with an InfoSource and a source system in BW 3.5 and are
associated with a DataSource in BW 7.0. They are used to load either transactional or
master data. They can be combined into Process Chains.
InfoPackage Naming
InfoPackages are entirely custom, and are specific to the source system, InfoSource
(BW3.5) DataSource (BW 7.0) as well as the data that is being loaded:
The format is:
InfoSource (3.5)/DataSource (7.0)_tttt_X
 tttt – Type of data (TRANS – transaction, TEXT-Text, ATTR-Attribute, 01Heirarchy (02, 03 for multiple hierarchies)
 X for Type of Update
o I = delta Initialization.
o F = full Update.
Page 11 of 14
BW Object Naming Standards
o D = delta
Example:
InfoSource i.e. 0MATERIAL would have an InfoPackage of
0MATERIAL_ATTR_I for the initialization and an InfoPackage of
0MATERIAL_ATTR_D for the delta loading of data.
Process Chain
Definition:
Sequence of processes that are scheduled in the background to wait for a particular event.
Process chains are used to control the process of loading data into BW and triggering
various other events, such as dropping and rebuilding indexes when loading some
DataStore objects, triggering the hierarchy/attribute change run and sending alerts. Some
of these processes may trigger an additional event, which in turn can start other
processes.
Process Chain Naming
Process Chains are entirely custom and can be specific to a single process or several
processes. The naming format should allow the viewer to know what process is being
performed by the Process Chain. The format is:
Z_ddddddddddddd
dddddddddddddddddddddd = description of process
Examples:
1. Z_LD FICO MD D – Delta load of masterdata for FI
2. Z_LD PYRL TRANS Full – Full load of payroll data.
Application Component
Definition:
An Application Component is an area that organizes InfoSources together in a logical
way for navigation.
Application Component Naming
Application components should be named Z*. There is a textual description that should
explicitly provide information on the function.
Examples:
1. ZPOCAREA
2. ZTESTAREA
3. ZSANDBOX
Page 12 of 14
BW Object Naming Standards
Flat Files
Definition:
Used to copy files from external sources into BW.
Flat File Naming
Flat Files are entirely custom and are specific to the system, source system and the data
that is being loaded:
InfoObjectName.csv
Example:
1. Transaction.csv
2. Account.csv
Custom Generic Extractors
Definition:
Used to provide transaction and masterdata from R/3 for delivery to BW.
Custom Generic Extractor Naming
Following SAP’s naming standard, the format for a new transaction
datasource will be:
Z_xx_(ffff + description if transactional),(InfoObject if masterdata)
 xx for type of extractor
o Tr = transactional data.
o M = masterdata attributes.
o Tx = masterdata Text
 ffff = functional area or
 InfoObect
Examples:
1. Z_M_ZPLANT
2. Z_TR_PY_ACTION
3. Z_TX_ZPLAN
Datasource
Definition:
Used to provide transaction and master data from R/3 for delivery to BW.
Page 13 of 14
BW Object Naming Standards
DataSource Naming
The format for a custom datasource should follow the naming convention of the custom
generic extractor, or if the datasource is created from a business content extractor the
format will be:
Zdatasource_xxxx
• xxxx = TRAN, TEXT, HIER, ATTR
•
Examples:
1. Z_M_ZPLANT
2. Z_TR_PY_ACTION
3. Z0EMPLOYEE_HIER
Aggregates
Definition:
Used to pre-summarize data to improve data reporting performance.
Aggregate Naming:
BW will determine the technical name.
Page 14 of 14
Download