Embed Size (px)
Citation preview
Application Life-Cycle Management
Solution Documentation with
Solution Documentation Assistant
Solution Management
Application Life-Cycle Management
SAP AG
Solution Documentation Assistant
Overview
Solution Documentation Assistant verifies and rates customers‟ business process
documentation.
Data basis is the usage frequency of technical objects related to the business process
structure. The usage frequency gives transparency about potentially obsolete and clarity about
mission-critical objects and is an excellent starting point for initial documentation as well.
Scope Analysis of template, implementation and maintenance
projects
Analyzes usage of technical objects like transactions,
reports, BADIs and custom developments
SQL statement analysis enables live system analysis
from a business perspective
Uses the existing SAP Solution Manager infrastructure
like system connections and technical statistical data
Benefits
Accelerates initial Solution Documentation
Enhanced solution and usage transparency
Enables simple and fast system consolidation
Facilitates business improvements
Standardization through comparison of business
processes at different locations
Basis for optimized test planning
Cost-efficient through automated verification of Solution
Documentation
Solution Documentation
Usage of Solution Documentation Assistant (SoDocA)
Solution Documentation means having documented the following key elements:
core business processes
related technical objects, such as transactions, programs, custom code, background jobs, interfaces
related (non-SAP) system and software components
Recommended project language is English
The correct usage of implementation projects automatically leads to sufficient solution documentation in the
operations and optimization phase.
If you start with the documentation in the
operations phase, you should make the
documentation of your core business
processes available in SAP Solution Manager.
In relation to a complete implementation project
only a subset of information is needed, then.
Main tools:
Business Blueprint
Solution Configuration
Solution Documentation Assistant
System Landscape Maintenance/Directory (SMSY/SLD)
Require-ments
Design
Deploy
Build & Test
Optimize
Operate
Application
Management
Configuration
-> extend documentation
Implementation
-> create or locally adjust
documentation
Template Management
-> ceate global documentaion
Operations
-> re-document
Upgrades
-> verify documentation
Solution Documentation life-cycle Focus
Re-Documentation
Where is SoDocA used in Solution Documentation?
Focus
Initial Documentation
How to implement Solution Documentation
Use Cases - Decision tree
Decision Tree: How to come to a central and reliable business process structure
with related documents in SAP Solution Manager
* = SoDocA = Solution Documentation Assistant
** = XLS/XML Upload, ARIS, RBE Plus
*** = in Projects or Solutions
Discover
Reuse
Transfer
Documentation
available
somewhere
Tool based
process structure
compatible to
SolMan**
yes
no
no
Sign-off by
business
process expert
Continuous
verification
with SoDocA*
Adjust
process
structure
Verify results
with business
process expert
Check
completeness
of process
structure and
adjust to 3 levels
Upload/link
documents
Manual transfer
of process
Structure
Upload/link
documents
Automated
transfer of
process
structure
Verify process
structure
and prepare
transfer to
SolMan
Create process
structure
with predefined
business content
and SoDocA*
Upload/link
documents
Continuous
verification
with SoDocA*
Continuous
verification
with SoDocA*
Note: The correct usage of implementation projects
automatically leads to Solution Documentation
Verify
Process
structure
available
in SolMan ***
Sign-off by
business
process expert
Continuous
verification
with SoDocA
Adjust
process
structure
Verify results
with business
process expert
Verify process
structure
with SoDocA*
Upload/link
documents
yes
no
Sign-off by
business
process expert
Sign-off by
business
process expert
How to implement Solution Documentation
Use cases in detail
Discover - no documentation available at all
Use BPR as template and verify structures through Solution Documentation Assistant
Manually adjust business process structure and related objects in business blueprint
Reuse - current documentation available
Manually transfer business process structure and related objects in business blueprint
Maintain business process structure and related objects in XLS, Lotus Notes and transfer it via
XML upload (as this procedure requires expertise this is currently an consultant solution, only)
Transfer - current and compatible tool based documentation available
Automatically transfer business process structure and related objects in business blueprint
ARIS: adjust to required 3 level hierarchy and transfer
XML upload: select content, structure it, and transfer via XML (see above)
Verify – documentation available in SAP Solution Manager
Project: copy project, verify it, update original or create new project
Solution: copy solution, verify it, create new maintenance project and update solution
How do I get my Business Process Documentation
into SAP Solution Manager?
Customer situation
No business process documentation available
Activities
Transfer data from the BPR into an implementation project
Generate an analysis project in SoDocA
Define rules
Run the analyses and verify results
Use analysis results to update or create a new implementation
project
Verify your core and critical businesses using Solution Documentation Assistant.
Implementation Content (BPR) can be verified with (SoDocA) to extend an initial business
process documentation.
Main Use Case 1 – Discover
Verify implementation content or initial solution documentation
SAP Solution
Get familiar with the business process structure using
implementation content (BPR)
Document core business processes and verify using SoDocA
Extend the documentation with critical processes and verify
using SoDocA
Extend the documentation with selected scenarios using BPR
Automatically and regularly verify to keep the documentation
reliable and up-to-date
Customer Example: Global Oil Company
Question: How to discover documentation?
© SAP 2008 / Page 7
We want to perfom an
upgrade for our ERP
system. We don´t have any
documented processes for
our current system.
How to start?
Customer Example: Global Oil Company
Question: How to start?
© SAP 2008 / Page 8
We want to perfom a
upgrade for our ERP
system. We don´t have any
documented processes for
our current system.
How to start?
Answer: Analyze your system usage to identify and redocument
your core business processes.
All available BPR
scenarios were
loaded into an
implementation
project.
Finalize /
redocument
core processes
Verify
documenta-
tion of core
processes by
using SoDocA
Implementa-
tion project
was analyzed
by using
SoDocA
Results:
• 60% of standard scenarios have not been used
during the last 3 month
• 8 standard transactions and 5 customer transactions
have been used more than 1.000.000 times
• Most used transactions are/can be assigned to 4
scenarios
• More than 60.000 customer objects are in place
• 48.000 customer objects have not been used during
the last 4 month
Required effort
for analysis:
2 Days
Key advantages:
- Getting a starting point
- Enable priorization of
business processes by
system usage
- Be able to verify progess
of documentation
Customer situation
Solution documentation in SAP Solution Manager
available
Activities
Import a SAP Solution Manager solution in an analysis
project
Define rules
Run the analyses and verify results
In case of first analysis, align with process expert. Adjust
rules, until it‟s ensured they are defined adequately
Use analysis results to update solution or create a new
implementation project
Based on self-defined rules, solutions can be automatically and regularly verified keeping the solution documentation up-to date
Main Use Case 2 – Verify
Verify solution documentation
SAP Solution
Reuse SAP Solution Manager solution as starting point
for solution documentation analysis
Verify the solution documentation and analyze
performance of, e.g. country specific, process variants
Based on rules automatically and regularly verify to keep
the documentation reliable and up-to-date
How to implement Solution Documentation
Use cases in detail
Discover - no documentation available at all
Use BPR as template and verify structures through Solution Documentation Assistant
Manually adjust business process structure and related objects in business blueprint
Reuse - current documentation available
Manually transfer business process structure and related objects in business blueprint
Maintain business process structure and related objects in XLS, Lotus Notes and transfer it via
XML upload (as this procedure requires expertise this is currently an consultant solution, only)
Transfer - current and compatible tool based documentation available
Automatically transfer business process structure and related objects in business blueprint
ARIS: adjust to required 3 level hierarchy and transfer
XML upload: select content, structure it, and transfer via XML (see above)
Verify – documentation available in SAP Solution Manager
Project: copy project, verify it, update original or create new project
Solution: copy solution, verify it, create new maintenance project and update solution
How do I get my Business Process Documentation
into SAP Solution Manager?
Business Process Structure: Potential Sources
Verify – SAP Solution Manager Projects
Business process structures of other SAP Solution Manager projects can be used as template
or draft to serve as the basis for adjusted or renewed business process documentation
Structure elements can be
copied from all types of projects
including implementation,
template, upgrade and
maintenance projects
Business process structure
elements can be imported at
business scenario, process,
process step level
Structure element can be
copied or inserted as shortcuts
referring to the original projects
Functionality
Ensures consistent structures
and wording across current
projects
Promotes re-use of existing
documentation in later projects,
e.g. in case of upgrades
Example: Business scenario imported from project ZCHI025370 into project ICSALES
Select previously documented
process structure with project
selection help
Benefits
F4 help to access other projects
Choose „Project‟ as documentation source
Copy options including cross-
project shortcut
Business Process Structure: Potential Sources
Verify - SAP Solution Manager Solutions
Business process structures of other SAP Solution Manager solutions can serve as the basis
for adjusted or renewed business process documentation
F4 help to access BPR
BPR as documentation source
Select previously documented
process structure with
solution selection help
Various copy option including
cross-solution shortcut
F4 help to access other solutions
Choose „Solution‟ as documentation source
Example: Business scenario imported from solution ICSales_01 into project ICSALES
Business process structure
elements can be imported at
business scenario, process,
process step level
Structure element can be
copied or inserted as shortcuts
referring to the original solution
Functionality
Ensures consistent structures
and wording across current
projects and solutions
Promotes re-use of existing
documentation in later projects,
e.g. in case of upgrades
Benefits
Analysis Results – Usage Report
Verification of used objects incl. custom code
The display of usage frequency of technical objects gives you transparency about potentially
obsolete and clarity about mission-critical objects
Customer situation
Solution documentation to be updated before an
upgrade
Housekeeping needed to ensure performance
and more cost efficient maintenance
Activities
Import a SAP Solution Manager dummy
project in an analysis project
Run the analyses
Check usage frequency and identify potentially
obsolete objects
Verify results with business process objects
Use analysis results to update technical object
in your solution documentation
SAP Solution
Identify obsolete objects, incl. custom code
Verify the technical objects solution
documentation
Linked to rule database allows further check step
enhancements
Update the Business Process Structure
Automated rating of business process structure – scope flag
Process
Verification of business process structure is based on usage frequency
and self-defined rules
Creates new Solution Manager Project (blueprint structure) based on
automated and regular analysis
Updates scope flags in existing structure. Insert missing technical objects
Flags active nodes „in scope‟ and inactive nodes „out of scope‟
Main task of Solution Documentation Assistant is to analyze and rate business process
structures documented in SAP Solution Manager.
SAP Solution Manager
Business
process
structure
Template & impl. project
Solution Documentation Assistant (SoDocA)
Data Sources and Data Flow
EWA
SQL statement analysis
BADIs
SAP
CRM
SAP
SCM
OtherOther
Maintenance projectSolution
Solution Documentation
Assistant
SAP Solution
Landscape
Statistical records based
on transaction ST03
in managed systems
New template or
implementation project
with updated structure
SAP
ERP
= SoDocA data sources
New maintenance project
with updated structure
Customer Example: German Energy Company
Question: How to check for completeness?
© SAP 2008 / Page 16
Our implementation partner
just finalized the new
implementation. He wants us
to approve the documentation.
How to check for
completeness?
Customer Example: German Energy Company
Question: How to check for completeness?
© SAP 2008 / Page 17
Answer: Analyze the implementation projects that has been used
for documentation.
Implementation
project was analyzed
by using SoDocA
Finalize
documentation
Recheck
completeness
by using
SoDocA
Create list of
objects to
document
Results:
• Some processes have no object assignment
• Documentation of customer objects not complete
Required effort
for analysis:
2 hours
Key advantages:
- Fastest completeness
check ever
- Results contains very
helpfull information for
management (e.g.
usage of customer
objects vs. standard
objects)
Our implementation partner
just finalized the new
implementation. He wants us
to approve the documentation.
How to check for
completness?
Main Use Case 3 – Verify
Question: How to check business process variants?
© SAP 2008 / Page 18
I have two
business process variants.
How can I check how
often they are used?
Analyze Business Process Variants
Process Variants in Business Process Structure
SQL statement analysis of SoDocA can be used to identify and analyze business process
variants helping customers gain key insight on their as-is business processes
Question: How many standard orders and promotion orders have been created in the last 3 months?
“Order to Cash” with variants
Analyze Business Process Variants
SQL Check Analysis – Process
SQL check step details for identifying standard order usage
VBAK Table and AUART column
for order type identification
SQL check step attached to SoDocA analysis project
SQL VBAK – AUART attached to
Create Sales order process step
Process
Identify tables, columns and values related to the
process step requiring usage analysis
Example:
Create sales order process step
Transaction : VA01
Table: VBAK table
Column: AUART column
Value : OR ( standard type)
Value: AA ( promotion type)
Create SQL check step – “Table Entry Count”
based on identified Table, Column entry
Example:
Table: VBAK table
Column: AUART column
Column: ERDAT column for period information
Create SoDocA analysis project and attach SQL
check step to the appropriate process step
Run analysis and check result to gain insight on
the usage statistics
Analyze Business Process Variants
SQL Statement Analysis - Result
SQL statement analysis of SoDocA can be used to identify and analyze business process
variants helping customers gain key insight on their as-is business processes
Question: How many standard orders and promotion orders have been created in the last 3 months?
“Order to Cash” with variants
Standard order - Active
Promotion order - Inactive
Standard order - 680
Promotion order - 0
SoDocA SQL analysis results: only standard orders are generated in last three months
SAP Solution Manager
Template(Definition of global processes,
examples for local processes)
Additional Use Cases - Governance for Global Projects
Management and Solution Documentation Assistant
Solution (Execution of processes)
Project (Implementation of global and local
processes)
Global Rollout Cut Over
Compare and Adjust(Verification that all global processes
are implemented locally)
Solution Documentation
Assistant (Verification that all global processes
are executed locally)
SAP Solution Manager delivers End-to-End governance of global processes
Single source of the truth(Process description and execution)
Additional Use Cases – Testing
Mitigate Risk of Changes with Test Management, SoDocA and BPCA
Business Process
Expert
Create an implementation project, link systems
Create the business process hierarchy using
business blueprint
Associate supporting technical objects, e.g.
transactions, programs
Test Coordinator
Tester
Test Coordinator
Based on this prioritization, create dynamic
technical bills of material (TBOMs) for critical
business process steps
Add test cases to business process structure
Review the change event
Perform change impact analysis using
Business Process Change Analyzer (BPCA)
Create regression test plan
Execute regression test for the change event
Monitor project status in SAP Solution Manager
Use SoDocA to check the test progress, if
test objects really have been touched
Using Solution Documentation Assistant
analyze the managed systems, verify process
structure and prioritize business process steps
Business Blueprint creation
Analyze and verify
business process structure
Test Preparation
Test Scope Identification
Project Status
DetailsStepsWho
Test Execution
24
RBE Plus for Solution Documentation Assistent
Who should use RBE Plus Content for SAP SoDocA
You can use RBE Plus Content for SoDocA, if you
need support for creating your initial blueprint and analysis structure
want additional analysis content based on master data, document data and
customizing data
need additional SAP transactions assigned to the BPR
need additional predefined processes
need support in assigning your customer specific transactions and not assigned SAP
transactions to your process structure
want to have very experienced analysis experts in your project
you do not have any experience in analyzing SAP systems regarding its usage,
situation or potentials
RBE Plus is a service offered by IBIS Prof. Thome AG. It helps you to establish an initial
documentation in SAP Solution Manager and offers content (rules) for SoDocA to verify your
managed systems.
25
RBE Plus and SoDocA – Integration
Interaction between RBE Plus and SoDocA
Initial Blueprint
Transfer
Re-Evaluation
Import of additional (customer specific) analysis content
Scoping
Populating SAP Solution Manager
Fast initial blueprinting
Additional service offerings
(e.g training, assignment of transactions)
© SAP AG 2009. All rights reserved. / Page 26
Summary
Solution Documentation / Business Processes
Definition
Solution Documentation means having documented the following key elements („minimum documentation‟):
core business processes
related technical objects, such as transactions, programs, custom code, background jobs, interfaces
related (non-SAP) system and software components
recommended project language is English
The correct usage of implementation projects automatically leads to sufficient solution documentation in the
operations and optimization phase.
If you start with the documentation in the
operations phase, you should make the
documentation of your core business
processes available in SAP Solution Manager.
In relation to a complete implementation project
only a subset of information is needed, then.
Main tools:
Business Blueprint
Solution Configuration
Solution Documentation Assistant
Require-ments
Design
Deploy
Build & Test
Optimize
Operate
Application
Management
Configuration
-> extend documentation
Implementation
-> create or locally adjust
documentation
Template Management
-> ceate global documentaion
Operations
-> re-document
Upgrades
-> verify documentation
Solution Documentation life-cycle Focus
Re-Documentation
What is Business Process Documentation?
Focus
Initial Documentation
Solution Documentation
Summary
4 Not centrally accessible
2 Outdated and not reliable
Hard to understand for
non-experts 1
3 Not related to
supporting software
My Business Process
Documentation was:
5 Very costly to maintain
-> Basis for all SAP Solution Manager capabilities along the application lifecycle
Check-in/Check-out functionality
ensures controlled maintenance
Solution Documentation Assistant enables
efficient and automated verification
Relates business process with system
and interface information
Central accessibility allows efficient
in- and external collaboration
Clearly structured 3-level bus. process
hierarchy with detailed process information
Now it is:
© SAP 2008 / Page 30
Application Life-Cycle Management
Reuse of Solution Documentation in nearly all ALM processes and capabilities
© SAP 2009 / Page 30
Require-ments
Design
Deploy
Build & Test
Optimize
Operate
Application
Life-Cycle
Management
Solution Documentation
Business Blueprint, Configuration
Solution Documentation Assistant
System Landscape Maintenance/Directory (SMSY/SLD)
Test Management
Business Process Change
Analyzer
Test Planning, Execution &
Reporting
Innovation Management
Implementation Project
Management
Implementation Content
Technical Operations
System Administration
System Monitoring
Business Process Operations
Business Process & Interface Monitoring
Job Scheduling Management
Incident & Problem Management
Incident Management
Root Cause Analysis
Upgrade Management
Upgrade Roadmap
Upgrade Dependency Analyzer
Maintenance Management
Maintenance Optimizer
Installation Tools
Change Management
Change Request Management
Quality Gate Management
Extended Change and Transport
Management
All ALM processes base on the technical landscape and business process
information provided through the solution documentation.
Information Sources
Overview: Solution Documentation and Application Life-Cycle Managementhttp://service.sap.com/alm >> Processes >> Solution Documentation
Technical Papers: SAP Solution Manager Media Library
http://service.sap.com/alm >> SAP Solution Manager and Tools >> Media Library
Learning maps: Documentation of Core Business Processes and
Solution Documentation Assistant http://service.sap.com/rkt-solman >> SAP Solution Manager 7.0 - Enhancement Package 1 (EHP1) >>
Requirements and Design Phases with SAP Solution Manager
Onsite training: Implementation Projects with SAP Solution Manager http://service.sap.com/education >> Training Catalog >> Course Search >> SMI310
Consulting Services: Quick start for projects in SAP Solution Manager
E-mail: [email protected]
Additional Information
© SAP 2009 / Page 32
Thank you!
