309 lines
7.7 KiB
Markdown
309 lines
7.7 KiB
Markdown
# Operations Guide - SAP BTP Intelligent Situation Automation
|
|
|
|
**Source**: [https://github.com/SAP-docs/sap-btp-intelligent-situation-automation/tree/main/docs](https://github.com/SAP-docs/sap-btp-intelligent-situation-automation/tree/main/docs)
|
|
**Last Verified**: 2025-11-22
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This guide covers operational aspects of Intelligent Situation Automation including automatic situation resolution, data export, and audit logging.
|
|
|
|
---
|
|
|
|
## Automatic Situation Resolution
|
|
|
|
### How It Works
|
|
|
|
Situations can be resolved automatically using:
|
|
1. **Standard SAP Actions** - Pre-built actions for specific situation templates
|
|
2. **Custom Actions** - User-defined actions created in Manage Situation Actions
|
|
|
|
### Manage Situation Actions Application
|
|
|
|
Use this application to:
|
|
- View available standard actions
|
|
- Create custom actions
|
|
- Configure action parameters
|
|
- Test action execution
|
|
|
|
---
|
|
|
|
## Standard SAP Actions
|
|
|
|
### Supported Situation Templates
|
|
|
|
| Situation Template | Template Code | Description |
|
|
|-------------------|---------------|-------------|
|
|
| Contract is Ready as Source of Supply | PROC_CONTRACTREADYTOUSE_V3 | Procurement contract automation |
|
|
| Physical Inventory Monitoring | MAN_PHYSICAL_INVENTORY_MONITOR | Inventory management automation |
|
|
|
|
### Required Communication Scenarios
|
|
|
|
#### SAP S/4HANA Cloud
|
|
|
|
| Situation Template | Required Scenario | Code |
|
|
|-------------------|-------------------|------|
|
|
| Contract Ready | Purchase Requisition Integration | SAP_COM_0102 |
|
|
| Physical Inventory | Physical Inventory Document Integration | SAP_COM_0107 |
|
|
|
|
#### SAP S/4HANA (On-Premise)
|
|
|
|
| Situation Template | Required API |
|
|
|-------------------|--------------|
|
|
| Contract Ready | Purchase Requisition Integration API |
|
|
| Physical Inventory | Physical Inventory Document Integration API |
|
|
|
|
### Configuring Standard Actions
|
|
|
|
1. Open **Manage Situation Automation** app
|
|
2. Select the situation type
|
|
3. Enable automation for the situation
|
|
4. Configure the standard action
|
|
5. Set conditions (optional)
|
|
6. Activate the automation
|
|
|
|
---
|
|
|
|
## Custom Actions
|
|
|
|
### Creating Custom Actions
|
|
|
|
1. Open **Manage Situation Actions** app
|
|
2. Click **Create**
|
|
3. Define action properties:
|
|
- Name and description
|
|
- Action type
|
|
- Target endpoint
|
|
- Parameters
|
|
4. Save and activate
|
|
|
|
### Action Configuration Options
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| Name | Unique action identifier |
|
|
| Description | Action purpose and behavior |
|
|
| HTTP Method | GET, POST, PUT, DELETE |
|
|
| Endpoint URL | Target API endpoint |
|
|
| Headers | Custom HTTP headers |
|
|
| Parameters | Input parameters from situation data |
|
|
|
|
---
|
|
|
|
## Manage Situation Automation Application
|
|
|
|
### Purpose
|
|
|
|
Configure which situations are automated and how they are resolved.
|
|
|
|
### Key Functions
|
|
|
|
| Function | Description |
|
|
|----------|-------------|
|
|
| View Situation Types | See available situation types from S/4HANA |
|
|
| Enable Automation | Turn on automation for a situation type |
|
|
| Configure Rules | Define conditions for action execution |
|
|
| Assign Actions | Link actions to situation types |
|
|
| Activate/Deactivate | Control automation status |
|
|
|
|
### Creating Automation Rules
|
|
|
|
1. Select a situation type
|
|
2. Define rule conditions based on situation data
|
|
3. Assign action to execute when conditions match
|
|
4. Set priority if multiple rules exist
|
|
5. Activate the rule
|
|
|
|
---
|
|
|
|
## Situation Dashboard
|
|
|
|
### Purpose
|
|
|
|
Monitor situation status and automation performance.
|
|
|
|
### Available Views
|
|
|
|
| View | Information |
|
|
|------|-------------|
|
|
| Overview | Total situations, resolution status |
|
|
| By Type | Situations grouped by type |
|
|
| By Status | Open, resolved, failed |
|
|
| Trends | Historical automation performance |
|
|
|
|
---
|
|
|
|
## Analyze Situations Application
|
|
|
|
### Purpose
|
|
|
|
Deep analysis of individual situations and resolution flows.
|
|
|
|
### Resolution Flow
|
|
|
|
The Resolution Flow shows the complete processing history:
|
|
- When situation was received
|
|
- Which rules were evaluated
|
|
- What action was applied
|
|
- Resolution outcome
|
|
|
|
### Status Indicators
|
|
|
|
| Status | Meaning |
|
|
|--------|---------|
|
|
| Resolved | Action successfully executed |
|
|
| No Action Applied | Rule conditions not matched |
|
|
| No Automation Configuration Found | No automation configured for type |
|
|
| Failed | Action execution failed |
|
|
|
|
---
|
|
|
|
## Data Export
|
|
|
|
### Purpose
|
|
|
|
Export all data stored by Intelligent Situation Automation.
|
|
|
|
### Export Endpoint
|
|
|
|
```
|
|
[https://<subdomain>.<region>.intelligent-situation-automation.cloud.sap/exportdata](https://<subdomain>.<region>.intelligent-situation-automation.cloud.sap/exportdata)
|
|
```
|
|
|
|
### URL Components
|
|
|
|
| Component | Description |
|
|
|-----------|-------------|
|
|
| subdomain | Your BTP subdomain |
|
|
| region | BTP region (e.g., eu10) |
|
|
|
|
### Example
|
|
|
|
```
|
|
[https://mycompany-dev.eu10.intelligent-situation-automation.cloud.sap/exportdata](https://mycompany-dev.eu10.intelligent-situation-automation.cloud.sap/exportdata)
|
|
```
|
|
|
|
### Export Content
|
|
|
|
The export includes:
|
|
- Situation records
|
|
- Automation configurations
|
|
- Resolution history
|
|
- System onboarding data
|
|
|
|
---
|
|
|
|
## Audit Logging
|
|
|
|
### Audit Log Service
|
|
|
|
Intelligent Situation Automation uses the SAP BTP Audit Log service to track changes.
|
|
|
|
### Logged Events
|
|
|
|
| Event Category | Examples |
|
|
|----------------|----------|
|
|
| Configuration Changes | Automation rule creation, modification |
|
|
| System Management | System onboarding, updates |
|
|
| User Actions | Action creation, activation |
|
|
|
|
### Viewing Audit Logs
|
|
|
|
Access logs through the **Audit Log Viewer** in Cloud Foundry environment:
|
|
|
|
1. Navigate to BTP Cockpit
|
|
2. Go to your subaccount
|
|
3. Open **Audit Log Viewer** service
|
|
4. Filter by application or time range
|
|
5. Review logged events
|
|
|
|
**Reference**: SAP Help documentation for Audit Log Viewer for Cloud Foundry Environment
|
|
|
|
---
|
|
|
|
## Delete Data Context Application
|
|
|
|
### Purpose
|
|
|
|
Manage data retention and cleanup of situation data.
|
|
|
|
### Available Functions
|
|
|
|
| Function | Description |
|
|
|----------|-------------|
|
|
| View Data | See stored situation data |
|
|
| Delete Specific | Remove individual records |
|
|
| Bulk Delete | Remove data by criteria |
|
|
|
|
### Data Retention Considerations
|
|
|
|
- Review data retention policies before deletion
|
|
- Deleted data cannot be recovered
|
|
- Audit logs may retain references
|
|
|
|
---
|
|
|
|
## Explore Related Situations Application
|
|
|
|
### Purpose
|
|
|
|
Discover relationships between situations.
|
|
|
|
### Relationship Types
|
|
|
|
| Relationship | Description |
|
|
|--------------|-------------|
|
|
| Same Object | Situations for same business object |
|
|
| Same Type | Situations of same template |
|
|
| Temporal | Situations in same time period |
|
|
|
|
### Use Cases
|
|
|
|
- Identify patterns across situations
|
|
- Find root causes
|
|
- Optimize automation rules
|
|
|
|
---
|
|
|
|
## Operational Best Practices
|
|
|
|
### Monitoring
|
|
|
|
- ✅ Regularly review Situation Dashboard
|
|
- ✅ Check for failed automations
|
|
- ✅ Monitor resolution rates
|
|
- ✅ Track automation performance trends
|
|
|
|
### Rules Management
|
|
|
|
- ✅ Start with simple rules
|
|
- ✅ Test rules before production activation
|
|
- ✅ Document rule logic
|
|
- ✅ Review and optimize regularly
|
|
|
|
### Data Management
|
|
|
|
- ✅ Export data periodically for backup
|
|
- ✅ Implement data retention policies
|
|
- ✅ Review audit logs for compliance
|
|
|
|
### Troubleshooting
|
|
|
|
- ✅ Use Analyze Situations for detailed investigation
|
|
- ✅ Check Resolution Flow for specific situations
|
|
- ✅ Verify rule conditions match actual data
|
|
|
|
---
|
|
|
|
## External Links
|
|
|
|
- **Audit Log Viewer**: [https://help.sap.com/docs/BTP/65de2977205c403bbc107264b8eccf4b/](https://help.sap.com/docs/BTP/65de2977205c403bbc107264b8eccf4b/)
|
|
- **Data Protection**: [https://help.sap.com/docs/btp/sap-business-technology-platform/data-protection-and-privacy](https://help.sap.com/docs/btp/sap-business-technology-platform/data-protection-and-privacy)
|
|
- **Business Rules**: [https://help.sap.com/docs/business-rules](https://help.sap.com/docs/business-rules)
|
|
|
|
---
|
|
|
|
**Document Version**: 1.0.0
|
|
**Last Updated**: 2025-11-22
|