Application Life-Cycle Management
Solution Documentation
Solution Management
Application Life-Cycle Management
SAP AG
Disclaimer
This presentation is a preliminary version and not subject to your license agreement
or any other agreement with SAP
SAP. This document contains only intended strategies
strategies,
developments, and functionalities of the SAP product and services and is not intended
to be binding upon SAP to any particular course of business, product strategy, and/or
development Please note that this document is subject to change and may be
development.
changed by SAP at any time without notice.
SAP assumes no responsibility for errors or omissions in this document.
© SAP 2008 / Page 2
SAP Solution Manager
From awareness to action
SAP has compiled best practices for E2E Solution Operations based
on the experience from customer engagements over three decades
decades.
SAP is aware of customer pain points.
Change
Management
g
Transparency on
Processes & Apps
pp
Requirements
Solution
Updates
Optimize
Innovation
Management
Design
Application
Management
Problem
analysis
Monitoring
Integration
Testing
Build &
Test
Operate
Incident
Management
Pain points are addressed by best practices:
SAP Standards* for E2E Solution Operations.
Deploy
Integration
Validation
Software
logistics
* SAP Standards for Solution Operations http://service.sap.com/supportstandards
Implementation methodology for
E2E Solution Operations: Run SAP.
SAP Solution Manager provides all
capabilities for E2E Solution Operations.
Solution Documentation
Motivation
Customer pain points
My Solution Documentation is:
1
Hard to understand for
non-experts
„
Initially my business processes have been modeled very
detailed. Now, after go-live, the documentation is too complex
to be reused or a help for non-business
non business process experts.
2
Outdated and not reliable
„
Because of costs or organizational aspects my business
process documentation has not been updated or verified since
it’s
it
s initial creation
creation.
3
Not related to
supporting software
„
There’s no sufficient transparency which SAP and non-SAP
software supports my business processes.
4
Not centrally accessible
„
There’s no centralized access to my business process and
system landscape information.
5
Very costly to maintain
„
There’s
Th
’ no automated
t
t d and
d controlled
t ll d maintenance
i t
off my
documentation. So I only do this effort sporadically, partially or
before major software updates, only.
Solution Documentation
Definition
What is Solution Documentation?
„ Solution Documentation means having documented the following key elements:
„
core business processes
„
related
l t d ttechnical
h i l objects,
bj t such
h as ttransactions,
ti
programs, custom
t
code,
d b
background
k
d jjobs,
b iinterfaces
t f
„
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
Focus
Focus
Solution Documentation life-cycle
y
operations phase,
phase you should make the
Initial Documentation
Re-Documentation
documentation of your core business
RequireUpgrades
Template Management
ments
processes available in SAP Solution Manager.
-> verify documentation
-> ceate global documentaion
Optimize
Design
In relation to a complete implementation project
Application
Implementation
Management
only a subset of information is needed,
needed then
then.
-> create or locally adjust
documentation
„ Main tools:
Build &
Test
Operate
Operations
-> re-document
„
Business Blueprint
„
Solution Configuration
„
Solution Documentation Assistant
„
System Landscape Maintenance/Directory (SMSY/SLD)
Deploy
Configuration
-> extend documentation
Solution Documentation Life-Cycle
ALM phase and related documentation
Solution documentation can be continuously enriched
along the ALM life-cycle
„ Design:
g Create g
global business p
process templates
p
and specifications,
p
e.g.
g for later
implementation projects
„ Design/Build: Newly create or locally adjust
business process structure during your
implementation project
„ Build/Test: Extend business process
documentation during solution
configuration, e.g. with custom code
documentation, configuration information,
test cases
Solution Documentation life-cycle
Requirements
Upgrades
-> verify documentation
Optimize
Application
Management
Design
Build &
Test
Operate
Operations
-> re-document
Template Management
-> create global documentation
Deploy
Implementation
-> create or locally adjust
documentation
Configuration
-> extend documentation
„ Operate: Re-document or adjust your
business process documentation during
operations, e.g. with system information
„ Optimize: Verify your business process documentation before upgrades, e.g. delete
obsolete information, e.g. not used custom code
Core and Critical Business Processes
Definition
What’s a core or critical business process?
„ Regularly
g
y there are not more than 1-5 core or critical business p
processes within a company
p y
„ Core business processes are the most important processes, leading to a severe impact on
the company’s business if they are disrupted
„ C
Critical
iti l business
b i
processes are new or technically
t h i ll challenging
h ll
i b
business
i
processes, e.g.
with custom developments or non-SAP components needing high awareness or monitoring
„ Documentation in SAP Solution Manager doesn’t mean to model every process step variant
and
dd
detail.
t il It means tto have
h
an understandable
d t d bl structure
t t
with
ith information
i f
ti relevant
l
t ffor reuse
of other teams and other application life-cycle capabilities
„ Example manufacturing industries: Material supply of the production
„
If this process is disrupted and material outages arise, the production of finished parts will be
impossible. So the company has to change production plans, causing higher total production cost
„
In addition, customer orders will not be delivered in time, so that customer satisfaction decreases
„
The material supply process needs to be considered a critical core process
process, because the company
loses money, if material outages occur
Solution Documentation
Included documentation types
Solution Documentation contains 2 types of documentation
Technical Landscape Documentation
„ System,
y
, server,, database and software component
p
documentation
„ Maintenance done by:
„
system administrators
„
technical SAP Solution Manager experts
„ Focus of EGI Basic Configuration of SAP Solution Manager and therefore not part of the EGI Solution
Documentation
Business Process Documentation
„ Documentation of Core Business Processes, related interfaces and custom code
„ Maintenance done by:
„
solution architects, e.g. for custom development and interface specifications;
„
business process experts, e.g. to document (core) process flow
„
project members, e.g. to document test cases and project specific customizing
„
functional SAP Solution Manager experts, e.g. for simple transfer if good process documentation is available
„ Focus of the EGI Solution Documentation
E2E Documentation of Core Business Processes
Integration of non-SAP in Solution Documentation
Integration of non-SAP components in Solution Documentation
Technical Landscape Documentation
„ Automated collection and display
p y of third p
party
y system
y
information via SLD
„
Any third party applications could use generic API to auto-register into the SAP Solution Manager system landscape directory
(for details see attachment or captivate delivered with this service)
„ Re-use of technical landscape documentation
„
As for SAP applications third party application information can be re
re-used
used in many capabilities,
capabilities e
e.g.
g for root cause analysis
analysis,
business process documentation, testing …
Business Process Documentation
„ Documentation of Core Business Processes includes non-SAP processes
„
Non-SAP process steps and related, linked information in the business process structure
„
Display of non-SAP software components and related process steps in the business blueprint graphics incl. links to
documents, issues, test cases …
© SAP 2008 / Page 9
Application Lifecycle Management Process
Solution Documentation
Goal
Centrallyy document and relate business p
processes and technical information of SAP
and non-SAP Solutions ensuring transparency, efficient maintenance and collaboration
Solution Documentation
Documentation
type
D
Documentation
i Scope
S
Create solution
documentation
Create technical landscape
documentation
Create business process
documentation
Hand-over to
operations
Update solution
documentation
Verify technical landscape
documentation
Verify business process
documentation
Hand-over to
operations
Capabilities
Technical Landscape Documentation
Implementation Content
Project Administration and Business Blueprint
Business Process Configuration
Solution
So
ut o Documentation
ocu e tat o Assistant
ss sta t
Project Reporting
Solution Directory
Documentation Types
How to g
get a Minimum Documentation and fully
y exploit
p
the Value
SAP Solution Manager – Key Capabilities & Pre-Requisites to Deploy
SAP Solution Manager
Key Capabilities
„
SAP Solution Manager capabilities
can be configured and implemented
based on customer specific priorities
and roadmaps
„
Individual services and guided
expert session for desired
configuration available
SAP Quality Center
by HP
Root Cause Analysis
for Custom Code
Test Workbench &
eCATT
Modification
Justification
Check
Custom Code
Maintainability
Check
Upgrade
(Delta Configuration)
Additional
CQCs*
Test
Content
Business
Process
Monitoring
ASAP
Run SAP
for Industries
Accelerated
Innovation Enablement
Template
Management
g Request
q
Change
Management
SAP
Support SLA
The 4 Steps
to fully exploit the value of
SAP Solution Manager
„
To achieve IT transparency
“Single Source of Truth”
„
To get access to specific SAP
Enterprise Support and SAP Solution
Manager capabilities
Technical SLA &
IT Reporting
Configuration
4
SAP CPS by
Content
Custom Code
Diagnostics
3
R d
Redwood
d
DocumenSelected
Business
Deploy (Q-Gate
tation
System
CQCs*
Process
Management, CTS+)
Monitoring Service
Documentation
Desk
2
Run SAP
Quality
System
1
for Technology
Management
Administration
Technical
Solution
Technical
Landscape
Custom Development
Configuration of
Documentation
Documentation
Management Cockpit
Solution Manager
Assistant
SAP Solution Manager enables you to establish a “Single Source of Truth” for the
support by your operations teams and organization
© SAP 2009 / Page 11
* Continuous Quality Checks
Technical Documentation
Technical documentation as integral part of Solution Documentation
Documentation Scope
Documentation
type
Create technical landscape
documentation
Create solution
documentation
„
Update solution
documentation
Create business process
documentation
Hand-over to
operations
Verify business process
documentation
Hand-over to
operations
P f
Performed
d as partt off
technical configuration
of SAP Solution Manager
Verify technical landscape
documentation
„
Review sytem landscape
„
Run automated data
capture for new systems
„
Adjust system landscape
„
Create new or adjust
logical components
Technical Landscape Documentation
Customer Benefits
Transparency of landscape information
„ All technical landscape information is centrally
available and can be analyzed
„ Reliable and Up-to-date information
„ Enriches business process with system data
Reduced time and effort
„ Landscape data is updated automatically
based on specified frequency
„ Central maintenance and access reduces
Integration of third party applications
„ Automated collection and display of third
party system information
„ Third party application information can be
integrated in business process documentation
Basis for other capabilities
„ Controlled, target-oriented access to
managed systems via RFC connection, e.g.
allowing directly linked solution configuration
p
out of business blueprint
time and effort for solution operations
„ Technical business process monitoring
© SAP 2008 / Page 13
Technical Landscape Documentation
Example
Technical landscape documentation as central, reliable data source for all kind of
system landscape and system related documentation
Solution
overview
Solution status /
name
Links to
administrative
tasks
Logical
Components
Products / product
versions
System
role
System /
client
Technical Landscape Documentation
SAP Solution Manager – Work Center “SAP Solution Manager Administration”
Work Center: Role-specific entry point for technical landscape documentation
and SAP Solution Manager administration related activities
System
Administrator
Technical landscape documentation,
documentation
maintain systems, users and solutions
Business Process Documentation
Business Process Documentation as part of Solution Documentation
Documentation Scope
Documentation
type
Create technical landscape
documentation
Create Solution
Documentation
„
Update Solution
Documentation
Performed as part of initial
set-up of SAP Solution
Manager
Create business process
documentation
„
A l
Analyze
b
business
i
processes
with SoDocA
„
Align business process
structure with implementation
content
„
Document custom code
Verify technical landscape
documentation
„
Review sytem landscape
„
Adjust system landscape
„
Run automated data
capture for new systems
„
Create new or adjust
logical components
Verify business process
documentation
„
Verify business processes
with SoDocA
„
Update business blueprint
„
Document custom code
„
Verify business process
structure with implementation
content
Hand-over to
operations
Hand-over to
operations
Business Process Documentation
(Business Blueprint)
Customer Benefits
Simplifies alignment of Business and IT
„
„
Implementation content with more than 2,500
predefined processes, documentation, test cases
and
dd
dedicated
di t d ttechnical
h i l iinformation
f
ti lik
like
transactions and programs
Central documentation of business processes
including related system information
Eases collaboration with SAP
„ Faster response times
„ Faster time to solution
„ Prerequisite
q
for certain AGS services,, e.g.
g
justification of custom development
Accelerates internal IT support
„ Standardized documentation in the SAP
Support ecosystem
„ Basis for business process monitoring
„ Cost reduction for implementation, upgrades
and maintenance
Allows fact-based decisions about
innovation / business process operation
„ Easy and fast verification of documented
business processes and dedicated custom
developments
„ Transparency of projects throughout
decentralized IT landscape
© SAP 2008 / Page 17
Implementation Content
Accelerator to come to an initial Business Blueprint
Goal
Provide customers with predefined business scenarios and business processes
aligned with SAP Solution Maps to enable projects to perform scoping, configuration,
and testing according to industry best practices
Scope
Documentation describing the scenario use in your business
Transactions allowing the evaluation of the delivered scenarios
Configuration support allowing for efficient Customizing of your
scenarios
Test templates to accelerate integration testing
Benefits
Reduced business blueprint time
Acceleration of configuration
Quick Start for testing
Implementation Content
Business Blueprint for Solution Documentation
Recommended maintenance
Business Blueprint offers central, focused, up-to-date, and easy-to-understand core
process documentation. The primary focus is to document the process steps, code,
systems
t
and
d interfaces.
i t f
System information
Documents, Links
Transactions
Custom development
Organizational units
Master data
3 level hierarchy
„
„
„
Business scenario
B i
Business
processes
Business steps
Interfaces
= Key elements of Solution Documentation
Business Process Documentation
SAP Solution Manager – Work Center “Implementation / Upgrade”
Work Center: Role-specific entry point for business process documentation and
project related activities
Project Manager
Business Process
Expert
p
Team Lead
Team Member
Plan, create and
maintain projects
Quality Manager
Status Reporting
S t
System
Ad
Administrator
i i t t
Solution Documentation
Solution Directory enables Solution Documentation
After hand over to operations the business process and related system information is
maintained in and available for re-use
through
g solution directory
y
Documentation
Scope
Create technical landscape
documentation
Create solution
documentation
„
Performed as part of
technical configuration of
SAP Solution Manager
„
Analyze business processes
with SoDocA
„
„
Align business process
structure with implementation
content
Copy business process
structure and interfaces into
solution directory
„
Reuse the business process
information in various solution
manager processes
„
Update solution
documentation
Verify technical landscape
documentation
Document custom code
Verify business process
documentation
„
R i
Review
system
t
llandscape
d
„
„
Run automated data
capture for new systems
Verify business processes
with SoDocA
„
Update business processes
using check-in/check-out
functionality in Solution
directory
„
Verify business process
structure with implementation
content
„
Adjust system landscape
„
Create new or adjust
logical components
Hand-over to
operations
Create business process
documentation
Hand-over to
operations
„
Reuse the business process
information in various solution
manager processes
Business Process Life-Cycle
From Template to Solution
Business Process Life-Cycle supported by SAP Solution Manager:
From p
process templates,
p
, modeling,
g, roll-out until reuse in SAP Solution Manager
g
capabilities and upgrade or maintenance projects
*
* = Business Process Repository (Implementation content)
Solutions
Scope and Benefits
A solution contains up-to date documentation of all core business processes and the
supporting
pp
gp
productive system
y
landscape
p information
Scope
„
Take-over
Take
over project information into operations
operations. Map
scenarios, processes, process steps and interfaces to
system landscape
„
Controlled maintenance of business p
processes and
dedicated information via check-out/check-in functionality
„
Assign documentation and system objects, e. g.
transactions and IMG activities, to updated process
structure elements
Benefits
„
Up-to-date,
Up
to date, central solution documentation
„
Reliable solution documentation through controlled
maintenance
„
Basis for many other SAP Solution Manager capabilities
like business process and interface monitoring, upgrade
projects, knowledge transfer, issue management
Solutions
Solution Components
Ideally a solution derives it’s content from a project. It allows central access and
contains up-to-date information about productive core business processes and
related ssystems
stems
Documentation
Transactions
Configuration
Test cases
Change requests
Solution List
Organizational units
Master data
3 level hierarchy
„ Business scenario
„ Business
processes
„ Business steps
Interfaces
System Information
Source Project
= Differences in comparison to projects
Technical Landscape Documentation
SAP Solution Manager – Work Center “System Landscape Management”
Work Center: Role-specific entry point for display of technical documentation
and related activities
Technical
O
Operation
ti
System
Administrator
Business Process
Expert
Application
Consultant
Display or maintain technical landscape
documentation of systems and solutions
Solution Documentation Verification
Solution Documentation Assistant
Solution Documentation Assistant is SAP‘s approach to automatically analyze customers’
systems,
y
p
providing
g a system
y
usage
g report
p and customer core business p
process models in SAP
Solution Manager. Keeps Solution Documentation cost-efficiently up to date.
Scope
„
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
B
Benefits
fit
„
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
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
Documentation
available
somewhere
no
Discover
Create process
structure
with predefined
business content
and SoDocA*
Verify results
with business
process expert
Adjust
process
structure
Manual transfer
of process
Structure
Upload/link
documents
Sign-off by
business
process expert
Continuous
verification
with SoDocA*
Upload/link
documents
Sign-off by
business
process expert
Continuous
verification
with SoDocA*
Upload/link
documents
Sign-off by
business
process expert
Continuous
verification
with SoDocA*
yes
Tool based
process structure
compatible to
SolMan**
no
Reuse
Check
completeness
of process
structure and
adjust to 3 levels
yes
Process
structure
available
in SolMan ***
Transfer
Verify process
structure
and prepare
transfer to
SolMan
Automated
transfer of
process
structure
Verify
Verify process
structure
with SoDocA*
Verify results
with business
process expert
no
Adjust
process
structure
Note: The correct usage of implementation projects
automatically leads to Solution Documentation
Upload/link
documents
*
Sign-off by
business
process expert
Continuous
verification
with SoDocA
= SoDocA = Solution Documentation Assistant
** = XLS/XML Upload, ARIS, RBE Plus
*** = in Projects or Solutions
How to implement Solution Documentation
Use cases in detail
How do I get my Business Process Documentation
into SAP Solution Manager?
„ 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
R
- current documentation
d
i available
il bl
„
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,
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 and use it as template for verification
„
Solution: copy project and use it as template for verification
Solution Directory
Customer Benefits
Transparency of business processes
„ All business process and related system
information is centrally available and can be
analyzed
„ Increased awareness of business process and
system information reduces risk during
problems
Controlled changes of documentation
„ Check-in checkout functionality allows controlled
changes of the current business process
documentation keeping it up-to-date and reliable
© SAP 2008 / Page 29
Reuse of valuable project information
„ Business process documentation of projects is
reused, combined with technical documentation
and has not to be maintained twice
„ Combined business, landscape and technical
view enables internal business and IT alignment
Basis for other capabilities
„ Enriches solution manager capabilities
business process and interface monitoring,
upgrade projects, knowledge transfer, issue
management
Documentation of Core Business Processes –
“How it works”
Three demos presenting the basic process of core business process documentation
and
a
d verification
e ca o a
are
ea
available
a ab e
„
Demo 1: Create a project and Document core business process
„ Create project and assign logical components
„ Import business scenario from business process
repository and check business process steps
„ Document of custom code and custom programs
„ Create interface scenario, interface and interface steps
„
Demo 2: Create a solution and upload the processes into the solution
„ Create a solution
„ Import business scenario into the solution
„
Demo 3: Verify process structure
„ Use solution documentation assistant
© SAP 2009 / Page 30
Solution Documentation
Summary
My Business Process
Documentation was:
Now it is:
1
Hard to understand for
non-experts
Clearly structured 3-level bus. process
hierarchy with detailed process information
2
Outdated and not reliable
Check-in/Check-out functionality
ensures controlled maintenance
3
Not related
N
l d to
supporting software
Relates business process with system
and interface information
4
N t centrally
Not
t ll accessible
ibl
Central
C
t l accessibility
ibilit allows
ll
efficient
ffi i t
in- and external collaboration
5
Very costly to maintain
Solution Documentation Assistant enables
efficient and automated verification
->
> Basis for all SAP Solution Manager capabilities along the application lifecycle
Application Life-Cycle Management
Reuse of Solution Documentation in nearly all ALM processes and capabilities
All ALM processes base on the technical landscape and business process
information p
provided through
g the solution documentation.
Upgrade Management
„
„
Solution Documentation
Upgrade Roadmap
U
Upgrade
d D
Dependency
d
A
Analyzer
l
Requirements
„
Business Blueprint, Configuration
„
Solution Documentation Assistant
„
System Landscape Maintenance/Directory (SMSY/SLD)
Change Management
„
„
„
Change Request Management
Quality Gate Management
Optimize
p
Application
Life-Cycle
Management
Extended Change and Transport
Management
Technical Operations
„
„
Design
g
B ild &
Build
Test
Operate
System Administration
System Monitoring
Deploy
Business Process Operations
„
„
Business Process & Interface
Monitoring
Job Scheduling Management
Incident & Problem Management
„
„
©S
2008 /
2009
32
Incident Management
Root Cause Analysis
Maintenance Management
„
„
Maintenance Optimizer
Installation Tools
Innovation Management
„
Implementation Project
Management
„
Implementation Content
Test Management
„
Business Process Change
Analyzer
„
Test Planning, Execution &
Reporting
SAP® Solution Manger
© SAP 2009 / Page 33
SAP® Solution Manager
© SAP 2009 / Page 34
Additional Information
Î
Information Sources
EGI Solution Documentation: Expert Guided Implementation Service
http://service.sap.com/alm >> Services
Overview: Solution Documentation and Application Life-Cycle Management
http://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: solutionmanager.consulting@sap.com