Initial commit

2025-11-30 08:55:07 +08:00
commit 22849ee66e
10 changed files with 2018 additions and 0 deletions
--- a/references/operations.md
+++ b/references/operations.md
@@ -0,0 +1,308 @@
+# 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