Application Life-Cycle Management Solution Documentation

(1)

Application Life-Cycle Management Solution Documentation

Solution Management

Application Life-Cycle Management SAP AG

(2)

Disclaimer

This presentation is a preliminary version and not subject to your license agreement or any other agreement with SAP This document contains only intended strategies or any other agreement with SAP. This document contains only intended 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. Please note that this document is subject to change and may be changed by SAP at any time without notice.

SAP assumes no responsibility for errors or omissions in this document.

(3)

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

SAP is aware of customer pain points. Pain points are addressed by best practices:

SAP Standards* for E2E Solution Operations.

on the experience from customer engagements over three decades.

Change Management

Transparency on Processes & Apps Require-

ments

Design Optimize

Application Management g

Solution Updates

Problem analysis

Integration Testing Innovation Management

& pp

Deploy

Build &

Operate Test

Monitoring Software

logistics

Integration Validation Incident

Management

* 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.

(4)

Solution Documentation

Motivation

Customer pain points

My Solution Documentation is:

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 process experts.

1

2 Outdated and not reliable Because of costs or organizational aspects my business

process documentation has not been updated or verified since it’s initial creation

to be reused or a help for non business process experts.

it s initial 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 _Th _’ _t _{t d} _d _{t ll d} _{i t} _f 5 Very costly to maintain There’s no automated and controlled maintenance of my

documentation. So I only do this effort sporadically, partially or before major software updates, only.

(5)

Solution Documentation

Definition

What is Solution Documentation?

Solution Documentation means having documented the following key elements:

core business processes

l t d t h i l bj t h t ti t d b k d j b i t f

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 Focus Solution Documentation life-cycle Focus

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 informationis needed then

Require- ments

Design Optimize Application

Management Implementation

-> create or locally adjust Template Management -> ceate global documentaion Upgrades

-> verify documentation

y

Re-Documentation Initial Documentation

only a subset of informationis needed, then.

Main tools:

Business Blueprint

Solution Configuration

Deploy

Build &

Operate Test

Configuration

-> extend documentation -> create or locally adjust documentation

Operations -> re-document

Solution Configuration

Solution Documentation Assistant

System Landscape Maintenance/Directory (SMSY/SLD)

(6)

Solution Documentation Life-Cycle

ALM phase and related documentation

Solution documentation can be continuously enriched along the ALM life-cycle

Design: Create global business process templates andg g p p specifications, e.g. for later p g implementation projects

Design/Build: Newly create or locally adjust business process structure during your

Require- ments

Design Optimize

Application Implementation Template Management -> create global documentation Upgrades

-> verify documentation

Solution Documentation life-cycle

implementation project

Build/Test: Extend business process documentation during solution

Deploy

Build &

Operate Test

Application Management

Configuration

-> extend documentation Implementation

-> create or locally adjust documentation

Operations -> re-document

configuration, e.g. with custom code

documentation, configuration information, test cases

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

(7)

Core and Critical Business Processes

Definition

What’s a core or critical business process?

Regularly there are not more thang y 1-5 core or critical business processes within a companyp 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 iti l b i t h i ll h ll i b i

Critical business processes are new or technically challenging business 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

d d t il It t h d t d bl t t ith i f ti l t f

and detail. It means to have an understandable structure with information relevant for 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 because the company

The material supply process needs to be considered a critical core process, because the company loses money, if material outages occur

(8)

Solution Documentation

Included documentation types

Solution Documentation contains 2 types of documentation

Technical Landscape Documentation

System, server, database and software component documentationy , , p

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

(9)

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 of third party system information via SLDp y p y y

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 used in many capabilities e g for root cause analysis

As for SAP applications third party application information can be re-used in many capabilities, e.g. for root cause 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 …

(10)

Application Lifecycle Management Process

Solution Documentation

Goal

Centrally document and relate business processes and technical information of SAP y p and non-SAP Solutions ensuring transparency, efficient maintenance and collaboration

D i S

Documentation

Solution Documentation

Create technical landscape documentation

Create business process documentation

Hand-over to operations Create solution

documentation

Documentation Scope Documentation

type

Verify technical landscape documentation Update solution

documentation

Verify business process documentation

Hand-over to operations

Capabilities

Technical Landscape Documentation Implementation Content

Project Administration and Business Blueprint Business Process Configuration

Solution Documentation Assistant So ut o ocu e tat o ss sta t Project Reporting

Solution Directory

(11)

Documentation Types

How to get a Minimum Documentation and fully exploit the Valueg y p

SAP Solution Manager – Key Capabilities & Pre-Requisites to Deploy

SAP Solution Manager Root Cause Analysis SAP Quality Center Run SAP SAP Solution Manager

Key Capabilities

SAP Solution Manager capabilities can be configured and implemented

Modification Justification Root Cause Analysis

for Custom Code

Test Workbench &

eCATT Upgrade

Accelerated Innovation Enablement ASAP

Run SAP for Industries SAP Quality Center

by HP

based on customer specific priorities and roadmaps

Individual services and guided expert session for desired

configuration available

Check Custom Code

Maintainability Check

Test

Upgrade (Delta Configuration)

Business Process

Template Management

Change Request ASAP

Additional CQCs*

configuration available

The 4 Steps to fully exploit the value of

SAP Support SLA Custom Code

Configuration Content

Test Content

Monitoring g q

Management

Diagnostics

Technical SLA &

IT Reporting 4

3 ^{SAP CPS by}_{R d} _d

to fully exploit the value of SAP Solution Manager

To achieve IT transparency

“Single Source of Truth”

Custom Code Documen-

tation Business Process Documentation

Diagnostics System

Monitoring

System Quality

Service Desk

Deploy (Q-Gate Management, CTS+) 3

Run SAP Selected

CQCs*

1

2

Redwood

To get access to specific SAP Enterprise Support and SAP Solution

Manager capabilities

System Administration Custom Development

Management Cockpit Quality

Management

Solution Documentation

Assistant for Technology Technical

Landscape Documentation 1

Technical Configuration of Solution Manager

SAP Solution Manager enables you to establish a “Single Source of Truth” for the support by your operations teams and organization

* Continuous Quality Checks

(12)

Technical Documentation

Technical documentation as integral part of Solution Documentation

type

Hand-over to operations Create solution

documentation

P f d t f

Performed as part of technical configuration of SAP Solution Manager

Verify technical landscape documentation

Review sytem landscape Update solution

documentation

Review sytem landscape

Run automated data capture for new systems

Adjust system landscape

Create new or adjust logical components

(13)

Technical Landscape Documentation Customer Benefits

Transparency of landscape information

All technical landscape information is centrally available and can be analyzed

Integration of third party applications

Automated collection and display of third party system information

Reliable and Up-to-date information

Enriches business process with system data

Third party application information can be integrated in business process documentation

Reduced time and effort Basis for other capabilities

Landscape data is updated automatically based on specified frequency

Central maintenance and access reduces

Controlled, target-oriented access to

managed systems via RFC connection, e.g.

allowing directly linked solution configuration out of business blueprint

time and effort for solution operations

p

Technical business process monitoring

(14)

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 / Solution status /

name

Links to administrative

tasks

Logical Components

Products / product versions

System role

System / client

(15)

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

and SAP Solution Manager administration related activities

System

Administrator

Technical landscape documentation Technical landscape documentation, maintain systems, users and solutions

(16)

Business Process Documentation

Business Process Documentation as part of Solution Documentation

type

A l b i

Hand-over to operations Create Solution

Documentation

Analyze business processes with SoDocA

Align business process structure with implementation content

Performed as part of initial set-up of SAP Solution Manager

Document custom code

Review sytem landscape Verify business processes Update Solution

Documentation

Review sytem landscape

Verify business processes with SoDocA

Update business blueprint

Create new or adjust logical components

Verify business process structure with implementation content

(17)

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

d d di t d t h i l i f ti lik

Accelerates internal IT support

Standardized documentation in the SAP Support ecosystem

and dedicated technical information like transactions and programs

Central documentation of business processes including related system information

Basis for business process monitoring

Cost reduction for implementation, upgrades and maintenance

including related system information

Eases collaboration with SAP Allows fact-based decisions about innovation / business process operation

Faster response times

Faster time to solution

Prerequisite for certain AGS services, e.g.

innovation / business process operation

Easy and fast verification of documented business processes and dedicated custom developments

q , g

justification of custom development Transparency of projects throughout decentralized IT landscape

(18)

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 Transactions allowing the evaluation of the delivered scenarios Configuration support allowing for efficient Customizing of your scenarios

Test templates to accelerate integration testing Test templates to accelerate integration testing

Benefits

Reduced business blueprint time Acceleration of configuration Quick Start for testing

Implementation Content

(19)

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,

t d i t f

systems and interfaces.

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

(20)

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 related activities

Project Manager Project Manager

Business Process Expert

Team Lead p

Team Member

Plan, create and maintain projects Quality Manager

maintain projects Status Reporting

S t Ad i i t t System Administrator

(21)

Solution Documentation

Solution Directory enables Solution Documentation

Documentation Scope

After hand over to operations the business process and related system information is maintained in and available for re-use through solution directory

Hand-over to operations Documentation Scope

Create solution documentation

g y

Analyze business processes with SoDocA

Align business process

Performed as part of technical configuration of SAP Solution Manager

Copy business process structure and interfaces into solution directory

structure with implementation content

Reuse the business process information in various solution manager processes

R i t l d Verify business processes

Update solution documentation

Review system landscape

Create new or adjust

Verify business processes with SoDocA

Update business processes using check-in/check-out functionality in Solution

Reuse the business process information in various solution manager processes

Create new or adjust

logical components directory

Verify business process structure with implementation content

(22)

Business Process Life-Cycle

From Template to Solution

Business Process Life-Cycle supported by SAP Solution Manager:

From process templates, modeling, roll-out until reuse in SAP Solution Manager p p , g, g capabilities and upgrade or maintenance projects

*

* = Business Process Repository (Implementation content)

(23)

Solutions

Scope and Benefits

A solution contains up-to date documentation of all core business processes and the supporting productive system landscape informationpp g p y p

Scope

Take-over project information into operations Map

Take over project information into operations. Map scenarios, processes, process steps and interfaces to system landscape

Controlled maintenance of business processes and p 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, central solution documentation

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

(24)

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 s stems

related systems

Change requests Transactions

Documentation Configuration Test cases

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

(25)

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 ti

System

Administrator Operation

Business Process Expert

Application Consultant

Display or maintain technical landscape documentation of systems and solutions documentation of systems and solutions

(26)

Solution Documentation Verification

Solution Documentation Assistant is SAP‘s approach to automatically analyze customers’

systems, providing a system usage report and customer core business process models in SAP y p g y g p p 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

from a business perspective

Uses the existing SAP Solution Manager infrastructure like system connections and technical statistical data

B fit 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

(27)

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

Discover

Documentation available somewhere

no Sign-off by

business process expert

Continuous verification with SoDocA*

Adjust process structure Verify results

with business process expert Create process

structure with predefined business content

Upload/link documents

Reuse

Tool based process structure

yes

no Check

completeness

of process Manual transfer Upload/link of process

and SoDocA*

Continuous verification Sign-off by

business

Reuse

compatible to SolMan**

of process structure and adjust to 3 levels

documents of process

Structure

Automated Verify process

verification with SoDocA*

Process yes

no

Transfer Upload/link

documents Automated

transfer of process structure structure

and prepare transfer to

SolMan

Continuous verification with SoDocA*

structure available in SolMan ***

no Sign-off by

Verify Sign-off by

Continuous verification with SoDocA Adjust

process structure Verify results

with business process expert Verify process

structure with SoDocA*

Upload/link documents

* = SoDocA = Solution Documentation Assistant

** = XLS/XML Upload, ARIS, RBE Plus

*** = in Projects or Solutions

Note: The correct usage of implementation projects automatically leads to Solution Documentation

(28)

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

into SAP Solution Manager?

Use BPR as template and verify structures through Solution Documentation Assistant

Manually adjust business process structure and related objects in business blueprint

R d i il bl

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) 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

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

(29)

Solution Directory

Customer Benefits

Transparency of business processes

All business process and related system information is centrally available and can be analyzed

Reuse of valuable project information

Business process documentation of projects is reused, combined with technical documentation analyzed

Increased awareness of business process and system information reduces risk during

problems

and has not to be maintained twice

Combined business, landscape and technical view enables internal business and IT alignment problems

Controlled changes of documentation Basis for other capabilities

Check-in checkout functionality allows controlled changes of the current business process

documentation keeping it up-to-date and reliable

Enriches solution manager capabilities business process and interface monitoring, upgrade projects, knowledge transfer, issue management

management

(30)

Documentation of Core Business Processes –

“How it works”

Three demos presenting the basic process of core business process documentation and verification are available

Demo 1: Create a project and Document core business process

Create project and assign logical components a d e ca o a e a a ab e

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

(31)

Solution Documentation

Summary

My Business Process Documentation was:

Now it is:

Hard to understand for non-experts

1 Clearly structured 3-level bus. process

hierarchy with detailed process information 2 Outdated and not reliable

N l d

Check-in/Check-out functionality ensures controlled maintenance

N t t ll ibl

3 Not related to

supporting software Relates business process with system and interface information

C t l ibilit ll ffi i t 4 Not centrally accessible

5 Very costly to maintain Solution Documentation Assistant enables Central accessibility allows efficient

in- and external collaboration 5 Very costly to maintain

> Basis for all SAP Solution Manager capabilities along the application lifecycle

efficient and automated verification

-> Basis for all SAP Solution Manager capabilities along the application lifecycle

(32)

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 provided through the solution documentation.

Solution Documentation

Business Blueprint, Configuration Upgrade Management

Upgrade Roadmap

U d D d A l

p g

Require- ments

Design Optimize

System Landscape Maintenance/Directory (SMSY/SLD)

Innovation Management Implementation Project

Upgrade Dependency Analyzer

Change Management

Change Request Management g

B ild &

p

Application Life-Cycle Management

Implementation Project Management

Implementation Content

Quality Gate Management

Extended Change and Transport Management

Deploy

Build &

Operate Test Test Management

Business Process Change Analyzer

Test Planning, Execution &

Reporting Technical Operations

System Administration

System Monitoring

Business Process Operations

Reporting

Business Process & Interface Monitoring

Job Scheduling Management Incident & Problem Management

Maintenance Management

Maintenance Optimizer

Installation Tools

Incident Management

Root Cause Analysis

(33)

SAP

^®

Solution Manger

(34)

SAP

^®

Solution Manager

(35)

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 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]