zhongwei/gh-secondsky-sap-skills-skills-sap-btp-intelligent-situation-automation
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
gh-secondsky-sap-skills-ski…/SKILL.md
Zhongwei Li 22849ee66e Initial commit
2025-11-30 08:55:07 +08:00

12 KiB
Raw Permalink Blame History

name, description, license, metadata
name description license metadata
sap-btp-intelligent-situation-automation This skill provides comprehensive guidance for SAP BTP Intelligent Situation Automation setup, configuration, and operations. It should be used when implementing situation-based automation between SAP S/4HANA systems and SAP Business Technology Platform. The skill covers subscription setup, Event Mesh integration, destination configuration, system onboarding, user management with role collections, automatic situation resolution, and troubleshooting. Keywords: SAP BTP, Intelligent Situation Automation, ISA, situation handling, SAP S/4HANA, SAP S/4HANA Cloud, Event Mesh, Business Event Handling, situation automation, situation dashboard, analyze situations, SAP_COM_0345, SAP_COM_0376, SAP_COM_0092, SituationAutomationKeyUser, SituationAutomationAdminUser, Cloud Connector, cf-eu10, CA-SIT-ATM, business situations, situation types, situation actions GPL-3.0
version last_verified status deprecation_date end_of_service
1.1.0 2025-11-27 DEPRECATED 2025-09-24 2026-03-24 (estimated)

SAP BTP Intelligent Situation Automation

⚠️ DEPRECATION NOTICE

Service Status: DEPRECATED as of September 24, 2025

SAP BTP Intelligent Situation Automation service has been deprecated and will reach end-of-service 6 months from the deprecation announcement (approximately March 2026) or when the last contract commitment is fulfilled.

Immediate Action Required:

  • Unsubscribe from the Intelligent Situation Automation service
  • Export any required data before end-of-service date
  • Contact component CA-SIT-ATM for questions or concerns

Overview (For Reference)

SAP Intelligent Situation Automation was a BTP service that enabled automatic handling of business situations from SAP S/4HANA and SAP S/4HANA Cloud systems. It leveraged SAP Event Mesh for real-time event communication and allowed organizations to define automated actions for resolving situations.

Documentation Source: https://github.com/SAP-docs/btp-intelligent-situation-automation

Last Verified: 2025-11-27

When to Use This Skill

When to Use This Skill

⚠️ SERVICE DEPRECATED - Use only for:

  • Unsubscribing from Intelligent Situation Automation service
  • Exporting data before end-of-service deadline
  • Understanding legacy configurations for documentation purposes
  • Migration planning to alternative solutions

Do NOT use this skill for:

  • New subscriptions to the service (not available)
  • Setting up new automation rules (service deprecated)
  • Production deployments (service will be discontinued)

Migration Information

SAP is working towards a GenAI-based capability in the Situation Handling Extended framework. Updates will be provided when available for consumption. For more information, see the SAP community announcement about the deprecation.

Quick Decision Tree

What Task?

Data Export & Unsubscription (DEPRECATED SERVICE)
├─ Export data → references/operations.md#data-export
└─ Unsubscribe → DEPRECATION NOTICE section

Legacy Documentation (For Reference Only)
├─ Understanding existing setup → references/setup-guide.md
├─ API configurations → references/onboarding.md
├─ Role assignments → references/security-roles.md
├─ Automation rules → references/operations.md
└─ Error troubleshooting → references/troubleshooting.md

Migration Planning
├─ Review Situation Handling Extended framework
├─ Contact SAP for migration options
└─ Support component: CA-SIT-ATM

Supported Systems

System Version Notes
SAP S/4HANA Cloud Current Full support
SAP S/4HANA 2021 FPS0+ On-premise, requires Cloud Connector

Region & Infrastructure

Setting Value
Region Europe (Frankfurt)
Technical ID cf-eu10
Provider AWS
Environment SAP BTP Cloud Foundry

Core Components

Required Services

Service Purpose
Intelligent Situation Automation Main application (standard plan)
SAP Event Mesh Event communication between S/4HANA and BTP
Cloud Connector On-premise S/4HANA connectivity (optional)

Communication Scenarios (SAP S/4HANA Cloud)

Scenario Code Purpose
Business Situation Integration SAP_COM_0345 Situation API access
Business Situation Master Data Integration SAP_COM_0376 Situation type data
Enterprise Event Enablement SAP_COM_0092 Event channel setup
Purchase Requisition Integration SAP_COM_0102 Contract ready action
Physical Inventory Document Integration SAP_COM_0107 Inventory monitoring action

APIs (SAP S/4HANA On-Premise)

API Purpose
Business Situation - Read Read situation data
Business Situation Type - Read Read situation type data
Purchase Requisition Integration API Contract ready action
Physical Inventory Document Integration API Inventory monitoring action

Role Templates

Role Type Access
SituationAutomationKeyUser Key User Full application access
SituationAutomationAdminUser Admin System onboarding only
RuleRepositorySuperUser Rules Business rule authoring

Key User Tiles

Key users with SituationAutomationKeyUser role can access:

  1. Manage Situation Actions - Create custom actions
  2. Manage Situation Automation - Configure automation rules
  3. Situation Dashboard - View situation overview
  4. Analyze Situations - Analyze resolution flows
  5. Delete Data Context - Manage data retention
  6. Explore Related Situations - View situation relationships

Event Mesh Configuration

Topic Space

saas/isa/cons

Outbound Event Topics

sap/s4/beh/businesssituation/v1/BusinessSituation/*
sap/s4/beh/businesssituationtype/v1/BusinessSituationType/*

Topic Rules (Service Instance)

{
  "topicRules": {
    "publishFilter": [],
    "subscribeFilter": ["saas/isa/cons/*"]
  }
}

Destination Configuration

Key Constraints

  1. Single System Per Subaccount: One subaccount connects to one S/4HANA system only
  2. Base URL Only: Destination URL must contain only the base system URL (no paths)
  3. Same System Destinations: All destinations in a subaccount must point to the same system

Changing Connected System

To connect to a different S/4HANA system:

  • Option A: Create a separate subaccount
  • Option B: Unsubscribe and resubscribe with new destination

Onboarding Workflow

Prerequisites

  1. Administrator role assigned
  2. Event Mesh enabled in subaccount
  3. Destination configured to S/4HANA system
  4. Communication arrangements created (Cloud) or APIs exposed (On-premise)

Steps

  1. Expose Situation Handling APIs (in S/4HANA)
  2. Configure Destinations (in BTP Cockpit)
  3. Set Up Event Mesh Communication (Event channel + topic bindings)
  4. Onboard System (using Onboard System app)

Onboard System App Process

  1. Launch Onboard System application
  2. Click Add
  3. Select destination from list
  4. Click Check Connection to verify
  5. Enter system name and description
  6. Click Create
  7. Wait for status: Pending → Successful

Troubleshooting: If onboarding fails, hover over info icon for details. Use Retry after fixing issues.

Automatic Situation Resolution

Supported Situation Templates

Template Code Required Scenario
Contract is Ready as Source of Supply PROC_CONTRACTREADYTOUSE_V3 SAP_COM_0102
Physical Inventory Monitoring MAN_PHYSICAL_INVENTORY_MONITOR SAP_COM_0107

Custom Actions

Use the Manage Situation Actions application to create custom actions beyond standard SAP actions.

Data Export

Export all stored data using the endpoint:

[https://<subdomain>.<region>.intelligent-situation-automation.cloud.sap/exportdata](https://<subdomain>.<region>.intelligent-situation-automation.cloud.sap/exportdata)

Audit Logging

Intelligent Situation Automation uses the Audit Log service to track:

  • Changes to automation configurations
  • System onboarding events

View logs via the Audit Log Viewer in Cloud Foundry.

Unsubscription Instructions

Prerequisites

  • Administrator role for the subaccount
  • Data export completed (if needed)

Steps to Unsubscribe

  1. Open your global account in the SAP BTP cockpit
  2. Navigate to your subaccount
  3. In the navigation area, choose Services > Instances and Subscriptions
  4. Find Intelligent Situation Automation in the subscription list
  5. Select the three dots at the end of the subscription row
  6. From the menu, select Delete
  7. Confirm deletion - all application data will be removed

Support

For any questions or concerns about the deprecation:

  • Component: CA-SIT-ATM
  • Create an incident via SAP for Me

Common Issues (Legacy)

Issue Cause Solution
Server error on app access Missing role assignment Assign required role collections
No Action Applied Rule conditions don't match Revise rule and reactivate
No Automation Configuration Found No automation exists for situation type Create automation in Manage Situation Automation

Reference Files

Detailed Guides Available

  1. references/setup-guide.md - Prerequisites, subscription, Event Mesh, network requirements
  2. references/onboarding.md - API exposure, destinations, event communication, system onboarding
  3. references/security-roles.md - Role templates, collections, user assignment
  4. references/operations.md - Automatic resolution, data export, logging
  5. references/troubleshooting.md - Error handling, support component
  6. references/external-links.md - All SAP documentation links with document IDs

Best Practices

Setup

  • ✅ Enable Event Mesh before subscribing to ISA
  • ✅ Create Event Mesh instance in same subaccount as ISA subscription
  • ✅ Use Europe (Frankfurt) region with cf-eu10

Destinations

  • ✅ Use only base URL (no additional paths)
  • ✅ One S/4HANA system per subaccount
  • ❌ Don't mix destinations to different S/4HANA systems

Communication

  • ✅ Set topic space to saas/isa/cons
  • ✅ Bind both BusinessSituation and BusinessSituationType topics
  • ✅ Use SAP_COM_0092 for cloud event channels

User Management

  • ✅ Assign SituationAutomationAdminUser for onboarding tasks
  • ✅ Assign SituationAutomationKeyUser for daily operations
  • ✅ Add RuleRepositorySuperUser for rule authoring

External Resources

SAP Documentation

Source Repository

Support

  • Component: CA-SIT-ATM
  • SAP for Me: Incident creation

Updates and Maintenance

⚠️ SERVICE DEPRECATED: No further updates expected as the service is deprecated.

Documentation Source:

Final Verification: 2025-11-27

Maintenance Status: ARCHIVE ONLY - Skill maintained for historical reference and unsubscription guidance.

Skill Version: 1.1.0 Status: DEPRECATED Last Updated: 2025-11-27 License: GPL-3.0 Maintainer: SAP Skills Team | https://github.com/secondsky/sap-skills

Version History:

  • v1.1.0 (2025-11-27): Added deprecation notice and unsubscription instructions
  • v1.0.0 (2025-11-22): Initial release for active service
Reference in New Issue View Git Blame Copy Permalink