Sap Build Process Automation

SAP Build Process Automation

Related Skills

• sap-s4hana-extensibility — S/4HANA event sources and API integration
• sap-security-authorization — BTP authorization for process automation
• sap-rap-comprehensive — RAP business events as process triggers
• sap-event-mesh — Event-driven triggers from S/4HANA business events
• sap-signavio — Model processes in Signavio, automate in SBPA
• sap-integration-suite-advanced — Complex API connectors for Actions

Quick Start

Create a workflow in 5 steps:

1. SAP Build Lobby → Create → Business Process Project
2. Add a Process → Choose trigger: Form, API, or Event
3. Add steps: Approval → Decision → Action → (repeat)
4. Configure conditions (If/Else gateways)
5. Release → Deploy → Test in Monitor tab

Architecture:

SAP Build Process Automation (BTP)
├── Process Builder    — Visual workflow modeling
├── Decision Editor    — Business rules / decision tables
├── Automation Editor  — RPA bot designer
├── Form Builder       — Trigger, approval, task forms
├── Visibility         — Process monitoring dashboards
└── Actions            — API connectors (OData, REST)

Core Concepts

Trigger Types

| Trigger | Start Method | Use Case | |---------|-------------|----------| | Form | User fills a request form | Leave request, purchase approval | | API | REST API call (OAuth2) | System integration, external apps | | Event | Event Mesh subscription | S/4HANA business events, SuccessFactors events |

Step Types

| Step | Description | |------|-------------| | Approval | Routes to approver(s) with approve/reject form | | Decision | Evaluates business rules (decision table or text rule) | | Automation | Runs RPA bot (attended or unattended) | | Action | Calls external API (OData/REST) | | Sub-Process | Reusable embedded process | | Mail | Sends notification email | | Condition | If/Else routing based on data |

Decision Tables

Decision tables are if/then rule engines:

IF OrderAmount > 10000 AND Region = "EMEA"
THEN ApprovalLevel = "Director", Priority = "High"

IF OrderAmount > 5000 AND Region = "EMEA"
THEN ApprovalLevel = "Manager", Priority = "Medium"

IF OrderAmount  10000 → [Approval: Director]
        IF amount > 5000  → [Approval: Manager]
        ELSE              → [Auto-Approve]
    → [Action: Create PO in S/4HANA via OData]
    → [Mail: Notify Requester]

Pattern 2: API Trigger Setup

1. Add API trigger to process
2. Note the generated API endpoint and definition ID
3. Configure OAuth2 credentials in BTP service key
4. Call endpoint:

POST /workflow/rest/v1/workflow-instances
Headers: Authorization: Bearer 
Body: {
  "definitionId": "{{process_definition_id}}",
  "context": {
    "orderId": "PO-12345",
    "amount": 15000,
    "requester": "john.doe@company.com"
  }
}

Pattern 3: Event Trigger from S/4HANA

1. Configure SAP Event Mesh on BTP
2. In S/4HANA: Enable business events (e.g., sap.s4.beh.purchaseorder.v1.PurchaseOrder.Created.v1)
3. In SBPA: Add Event Trigger → select event from catalog
4. Map event payload to process context variables
5. Process starts automatically when event fires

Pattern 4: Action (API Connector)

1. Create Action Project in SAP Build
2. Import API specification (OData metadata or OpenAPI)
3. Configure destination:

{
  "Name": "S4HANA_API",
  "Type": "HTTP",
  "URL": "https://my-s4.ondemand.com",
  "Authentication": "OAuth2ClientCredentials",
  "ProxyType": "Internet",
  "sap.processautomation.enabled": true,
  "sap.applicationdevelopment.actions.enabled": true
}

1. Use Action step in process to call the API

Pattern 5: RPA Automation

Automation: Extract Invoice Data
1. Open Browser → Navigate to vendor portal
2. Read Table → Extract invoice line items
3. Loop → For each line item:
   a. Map fields to S/4HANA format
   b. Call Action: Post invoice via API
4. Log results → Send summary email

Desktop Agent requirements: Windows only, installed locally, connects to BTP tenant.

Error Catalog

| Error | Cause | Fix | |-------|-------|-----| | 403 Forbidden on deploy | Missing role collection ProcessAutomationAdmin | Assign role collection in BTP cockpit | | "Process stuck in running" | Approval task not assigned or recipient offline | Check Monitor → open instance → reassign task | | Action timeout | API destination unreachable or slow | Check destination config; increase timeout | | Automation "Agent Offline" | Desktop Agent not running or disconnected | Start Desktop Agent; check network connectivity | | Event trigger not firing | Event Mesh subscription misconfigured | Verify topic subscription and event format | | Decision returns empty | No matching rule found | Add a default/catch-all rule at bottom of decision table | | Form data not passing | Variable binding missing between steps | Check input/output mapping in process flow | | "503 Action Internal Error" | Destination missing required properties | Add sap.processautomation.enabled = true to destination | | Deploy fails "version exists" | Same version already deployed | Increment version number before release | | Memory exceeded in automation | Processing large dataset in single loop | Use batch processing (chunks of 100-500 records) |

Performance Tips

• Use sub-processes for reusable logic (DRY principle)
• Define custom variables as constants for magic values
• Batch processing in automations: process records in chunks, not one-by-one
• Use destination variables for multi-environment support (dev/test/prod)
• Deploy decisions independently when business rules change frequently
• Keep forms simple: 50000 → [Approval: CFO] (deadline: 3 days)

IF amount > 10000 → [Approval: Director] (deadline: 2 days) IF amount > 1000 → [Approval: Manager] (deadline: 1 day) ELSE → [Auto-Approve] → [Condition: Approved?] YES → [Action: Post to S/4HANA FI] → [Mail: Confirmation to requester] NO → [Mail: Rejection with reason] → [End]

Escalation: If no response within deadline → → [Action: Notify substitute approver] → [Approval: Substitute] (deadline: 1 day) → [Condition: Still no response?] → [Auto-Reject]

### Pattern 7: Parallel Processing with Aggregation

[API Trigger: Multi-Department Review] → [Parallel Gateway] ├── [Approval: Legal Review] ├── [Approval: Finance Review] └── [Approval: Compliance Review] → [Merge Gateway: All must approve] → [Decision: Final Assessment] → [Action: Update status in S/4HANA]

### Pattern 8: Exception Handling

```json
{
  "errorHandling": {
    "type": "boundary-event",
    "attachedTo": "Action: Create PO",
    "errorType": "timeout",
    "handler": [
      { "step": "Log error to monitoring" },
      { "step": "Retry with exponential backoff", "maxRetries": 3 },
      { "step": "If still failing: route to manual queue" }
    ]
  }
}

Source Documentation

• SAP Build Process Automation Documentation
• SAP Build Store
• SAP Tutorials: Build Process Automation
• GitHub: SAP-samples SBPA

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: efeumutaslan
• Source: efeumutaslan/SAP-SKILLS
• License: MIT

Install and usage instructions live in the source repository linked above.