Nexeed
    • Introduction
    • User manual
      • Machine Maintenance
      • Tool Maintenance
      • Machine Task Templates
      • Tool Task Templates
      • Schedules
      • Configuration
        • General
        • ERP
        • Task templates
        • Result classifications
        • Bosch Cognitive Service
      • Working with tasks
        • Using the Kanban view for tasks
        • Corrective Task
        • Preventive Task
      • Using task templates
        • Machine task template
        • Tool task template
      • Using schedules
      • Filter and search functions
    • Operations manual
      • Overview
      • System Architecture and Interfaces
      • System Requirements
        • bci-app/nginx
        • maintenance-management/mm-service
        • mm/mm-connector-sparepart
      • Migration from Previous Versions
        • Resources mapping from MES to IAS
      • Setup and Configuration
        • Configuration of the helm chart
        • MM Connector Spare Part
        • ERP Connector & Orchestrator Packages
      • Start and Shutdown
      • Regular Operations
      • Failure Handling
      • Backup and Restore
        • Tenant restore
      • Logging and Monitoring
        • Module Health Endpoints and K8S Probes
      • Known Limitations
    • Developer documentation
      • How-Tos
        • Embedded views
        • Dialog views
    • API documentation
      • HTTP API
      • Async API
    • Glossary
Maintenance Management
  • Industrial Application System
  • Core Services
    • Block Management
    • Deviation Processor
    • ID Builder
    • Multitenant Access Control
    • Notification Service
    • Ticket Management
    • Web Portal
  • Shopfloor Management
    • Andon Live
    • Global Production Overview
    • KPI Reporting
    • Operational Routines
    • Shift Book
    • Shopfloor Management Administration
  • Product & Quality
    • Product Setup Management
    • Part Traceability
    • Process Quality
    • Setup Specs
  • Execution
    • Line Control
    • Material Management
    • Order Management
    • Packaging Control
    • Rework Control
  • Intralogistics
    • AGV Control Center
    • Stock Management
    • Transport Management
  • Machine & Equipment
    • Condition Monitoring
    • Device Portal
    • Maintenance Management
    • Tool Management
  • Enterprise & Shopfloor Integration
    • Archiving Bridge
    • Data Publisher
    • Direct Data Link
    • Engineering UI
    • ERP Connectivity
    • Gateway
    • Information Router
    • Master Data Management
    • Orchestrator

Nexeed Learning Portal

  • Maintenance Management
  • Operations manual
  • Failure Handling
preview 2.6

Failure Handling

Update Corrective Machine Task Workflow

Error Paths

1. Maintenance Management API Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetMmInfos → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve task data from Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

2. User Information Retrieval Failure

  • Trigger: The call to retrieve user information fails

  • Condition: varSuccess is false after GetUserInfoActivity

  • Path: GetUserInfoActivity → GetUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID for the assigned user, workflow terminates

  • Possible Cause: The assigned user does not exist in MACMA or ERPConn has wrong permissions to access Maintenance Management

3. Order Operation Update Failure

  • Trigger: The call to update order operation fails

  • Condition: varSuccess is false after UpdateOperationActivity

  • Path: UpdateOperationActivity → UpdateOperationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update operation details in SAP, workflow terminates

  • Possible Cause: Invalid operation ID or invalid API key

4. Operation Long Text Check Failure

  • Trigger: The call to check operation long text fails

  • Condition: varSuccess is false after CheckOperationLongTextActivity

  • Path: CheckOperationLongTextActivity → CheckOperationLongTextSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to check if long text exists for the operation, workflow terminates

  • Possible Cause: Invalid operation ID or invalid API key

5. Operation Long Text Creation Failure

  • Trigger: The call to create operation long text fails

  • Condition: varSuccess is false after CreateOperationLongTextActivity

  • Path: CreateOperationLongTextActivity → CreateOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create long text for the operation, workflow terminates

  • Possible Cause: Invalid operation ID or invalid API key

6. Operation Long Text Update Failure

  • Trigger: The call to update operation long text fails

  • Condition: varSuccess is false after UpdateOperationLongTextActivity

  • Path: UpdateOperationLongTextActivity → UpdateOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update long text for the operation, workflow terminates

  • Possible Cause: Invalid operation ID or invalid API key

Error Paths for missing employee id

1. Missing Employee ID for Assigned User

  • Trigger: A user is assigned to the task but doesn’t have an employee ID defined

  • Condition: varTaskResponseObj.AssignedUsername !== null && String.IsNullOrEmpty(varEmployeeId) is true

  • Path: CheckIfUserHasBeenAssignedActivity (true) → ErrorMissingEmployeeIdSetActivity

  • Impact: Basic task data is synchronized, but the user assignment cannot be properly reflected in SAP

  • Possible Cause: The assigned user in Maintenance Management does not have an EmployeeId defined in MACMA

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Missing Employee ID Error

{
  "Success": false,
  "Message": "The assigned user '{username}' does not have an EmployeeId defined in Macma. Please add it and repeat the assignment in MM. All other data has been synced."
}

Required Operations

The workflow depends on the following operations that might fail and need to be handled by checking the message log:

  • GetOrderLockState

  • UnlockOrder

  • LockOrder

  • UpdateOrderOperation

  • GetOrderOperationLongText

  • CreateOrderOperationLongText

  • UpdateOrderOperationLongText

Corrective Order Changed Workflow

Error Paths

1. Message Flow Retrieval Failure

  • Trigger: Invalid message ID or message flow data cannot be retrieved

  • Condition: When GetMessageFlowActivity fails to retrieve valid message flow data

  • Path: GetMessageFlowActivity → ParseEventDataActivity → Error detected during event parsing

  • Impact: Workflow fails without processing any order changes

  • Possible Cause: Invalid message possibly due to misconfiguration in Solace event bridge

2. Order Retrieval Failure

  • Trigger: GetOrderActivity operation fails

  • Condition: When varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve order information to process changes

  • Possible Cause: Invalid order ID or invalid API key

3. Task ID Retrieval Failure

  • Trigger: GetTaskIdByExternalIdActivity fails

  • Condition: When varSuccess is false after GetTaskIdByExternalIdActivity

  • Path: ForEachOperationLoopActivity → GetMMTaskIdActivity → IsGetMMTaskIdSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot locate corresponding task in Maintenance Management

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

4. Corrective Task Retrieval Failure

  • Trigger: GetCorrectiveTaskActivity fails

  • Condition: When varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve task details to apply updates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

5. External System Lock Failure

  • Trigger: SetLockByExternalSystemActivity fails

  • Condition: When varSuccess is false after SetLockByExternalSystemActivity

  • Path: SetLockByExternalSystemActivity → SetLockByExternalSystemIfActivity (false) → ErrorSetActivity

  • Impact: Cannot set external system lock, which is required for state changes

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

6. Task State Update Failure

  • Trigger: SetTaskStateActivity fails

  • Condition: When varSuccess is false after SetTaskStateActivity

  • Path: SetTaskStateActivity → SetTaskStateSuccessIfActivity → ErrorSetActivity

  • Impact: Cannot update task state to match order state changes

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Create Corrective Task Workflow

Error Paths

1. Maintenance Management API Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetMmInfos → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve task data from Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

2. Assigned User Info Retrieval Failure

  • Trigger: The call to retrieve assigned user information fails

  • Condition: varSuccess is false after GetAssignedUserInfoActivity

  • Path: GetAssignedUserInfoActivity → GetAssignedUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID for assigned user, workflow terminates

  • Possible Cause: The assigned user does not exist in MACMA or ERPConn has wrong permissions to access MACMA

3. Device Retrieval Failure

  • Trigger: The call to retrieve device information fails

  • Condition: varSuccess is false after GetDeviceActivity

  • Path: GetDeviceActivity → GetDeviceIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve device details for the task, workflow terminates

  • Possible Cause: The device with the specified SAP ID does not exist in MDM or ERPConn has wrong permissions to access MDM

4. Created By User Info Retrieval Failure

  • Trigger: The call to retrieve creator’s user information fails

  • Condition: varSuccess is false after GetCreatedByUserInfoActivity

  • Path: GetCreatedByUserInfoActivity → GetCreatedByUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID of task creator, workflow terminates

  • Possible Cause: The creator user does not exist in MACMA or ERPConn has wrong permissions to access MACMA

5. Create Notification Failure

  • Trigger: The call to create a notification in SAP fails

  • Condition: varSuccess is false after CreateNotificationActivity

  • Path: CreateNotificationActivity → CreateNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create notification in SAP, workflow terminates

  • Possible Cause: Invalid notification data or invalid API key

6. Create Order Failure

  • Trigger: The call to create an order in SAP fails

  • Condition: varSuccess is false after CreateOrderActivity

  • Path: CreateOrderActivity → CreateOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create order in SAP, workflow terminates

  • Possible Cause: Invalid order data or invalid API key

7. Update Order Failure

  • Trigger: The call to update an order in SAP fails

  • Condition: varSuccess is false after UpdateOrderActivity

  • Path: UpdateOrderActivity → UpdateOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update order in SAP, workflow terminates

  • Possible Cause: Invalid order data or invalid API key

8. Get Next Order Operation ID Failure

  • Trigger: The call to get next operation ID fails

  • Condition: varSuccess is false after GetNextOrderOperationIdActivity

  • Path: GetNextOrderOperationIdActivity → GetNextOrderOperationIdIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve next operation ID for related task, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

9. Create Order Operation Failure

  • Trigger: The call to create an order operation fails

  • Condition: varSuccess is false after CreateOrderOperationActivity

  • Path: CreateOrderOperationActivity → CreateOrderOperationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create operation in SAP order, workflow terminates

  • Possible Cause: Invalid operation data or invalid API key

10. Create Order Operation Long Text Failure

  • Trigger: The call to create long text for order operation fails

  • Condition: varSuccess is false after CreateOrderOperationActivity

  • Path: CreateOrderOperationLongTextActivity → CreateOrderOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to add detailed description to operation, workflow terminates

  • Possible Cause: Invalid operation ID or invalid API key

11. Update External IDs Failure

  • Trigger: The call to update external IDs in Maintenance Management fails

  • Condition: varSuccess is false after UpdateExternalIdsActivity

  • Path: UpdateExternalIdsActivity → UpdateExternalIdsIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task with SAP IDs, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

12. Missing Equipment ID Error

  • Trigger: The device doesn’t have a SAP ID defined

  • Condition: varDeviceResponse["identifiers"]["sapid"] != null is false

  • Path: CheckForExistingEquipmentIdIfActivity (false) → MissingEquipmentIdErrorActivity

  • Impact: Unable to create task in SAP without equipment ID, workflow terminates

  • Possible Cause: The device in MDM does not have a SAP ID defined

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Missing Equipment ID Error

{
  "Success": false,
  "Message": "The device does not have an identifier 'sapid' (case sensitive). Please add it in MDM."
}

Required Operations

The workflow depends on the following operations that might fail:

  • CreateNotification

  • CreateOrder

  • UpdateOrder

  • CreateOrderOperation

  • CreateOrderOperationLongText

  • GetOrderOperationLastId

  • GetOrderLockState

  • UnlockOrder

  • LockOrder

Malfunction Update Workflow

Error Paths

1. External ID Retrieval Failure

  • Trigger: External ID is not available after multiple attempts

  • Condition: After 4 attempts, varMalfunctionResponse?["result"]?["externalId"]?.Value<string?>() == null

  • Path: IsExternalIdAvailableWhileActivity → GetMalfunctionIfActivity (false) → ErrorSetActivity

  • Impact: Cannot update malfunction without external ID, workflow terminates

  • Possible Cause: The malfunction does not have an external ID set in Maintenance Management

2. Malfunction Retrieval Failure

  • Trigger: The call to retrieve malfunction information fails

  • Condition: varSuccess is false after GetMalfunctionActivity

  • Path: GetMalfunctionActivity → GetMalfunctionIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve malfunction data, workflow terminates

  • Possible Cause: Invalid malfunction ID or ERPConn has wrong permissions to access Maintenance Management

3. Notification Retrieval Failure

  • Trigger: The call to retrieve notification information fails

  • Condition: varSuccess is false after GetNotificationActivity

  • Path: GetNotificationActivity → GetNotificationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve notification data from ERP, workflow terminates

  • Possible Cause: Invalid notification ID or invalid API key

4. Update Notification Failure

  • Trigger: The call to update notification fails

  • Condition: varSuccess is false after UpdateNotificationActivity

  • Path: UpdateNotificationActivity → UpdateNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update notification in ERP, workflow terminates

  • Possible Cause: Invalid notification data or invalid API key

5. Create Notification Item Failure

  • Trigger: The call to create notification item fails

  • Condition: varSuccess is false after CreateNotificationItemActivity

  • Path: CreateNotificationItemActivity → CreateNotificationItemIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create notification item in ERP, workflow terminates

  • Possible Cause: Invalid notification item data or invalid API key

6. Update Notification Item Failure

  • Trigger: The call to update notification item fails

  • Condition: varSuccess is false after UpdateNotificationItemActivity

  • Path: UpdateNotificationItemActivity → UpdateNotificationItemIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update notification item in ERP, workflow terminates

  • Possible Cause: Invalid notification item data or invalid API key

7. Create Notification Item Cause Failure

  • Trigger: The call to create notification item cause fails

  • Condition: varSuccess is false after CreateNotificationItemCauseActivity

  • Path: CreateNotificationItemCauseActivity → CreateNotificationItemCauseIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create notification item cause in ERP, workflow terminates

  • Possible Cause: Invalid notification item cause data or invalid API key

8. Update Notification Item Cause Failure

  • Trigger: The call to update notification item cause fails

  • Condition: varSuccess is false after UpdateNotificationItemCauseActivity

  • Path: UpdateNotificationItemCauseActivity → UpdateNotificationItemCauseIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update notification item cause in ERP, workflow terminates

  • Possible Cause: Invalid notification item cause data or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • UpdateNotification

  • CreateNotificationItem

  • UpdateNotificationItem

  • CreateNotificationItemCause

  • UpdateNotificationItemCause

Notification Changed Workflow

Error Paths

1. Message Flow Retrieval Failure

  • Trigger: Invalid message ID or message flow data cannot be retrieved

  • Condition: When parsing event data fails after GetEventDataActivity

  • Path: GetEventDataActivity → ParseEventDataActivity → Event parsing fails

  • Impact: Workflow cannot process the notification change event

  • Possible Cause: Invalid message possibly due to misconfiguration in Solace event bridge

2. Notification Retrieval Failure

  • Trigger: The call to retrieve notification information fails

  • Condition: varSuccess is false after GetNotificationActivity

  • Path: GetNotificationActivity → GetNotificationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve notification details to process changes

  • Possible Cause: Invalid notification ID or invalid API key

3. Maintenance Task ID Retrieval Failure

  • Trigger: The call to get task ID by external ID fails

  • Condition: varSuccess is false after GetMaintenanceTaskIdActivity

  • Path: GetMaintenanceTaskIdActivity → GetMaintenanceTaskIdIfActivity (false) → ErrorSetActivity

  • Impact: Cannot find the corresponding maintenance task for the notification

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

4. Corrective Task Retrieval Failure

  • Trigger: The call to get corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve corrective task details to apply notification updates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

5. Preventive Task Retrieval Failure

  • Trigger: The call to get preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve preventive task details to apply notification updates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

6. Latest Notification Retrieval Failure

  • Trigger: The second call to retrieve notification information fails

  • Condition: varSuccess is false after GetLatestNotificationActivity

  • Path: GetLatestNotificationActivity → GetLatestNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve the most current notification state for comparison

  • Possible Cause: Invalid notification ID or invalid API key

7. Malfunction Update Failure

  • Trigger: The call to update malfunction information fails

  • Condition: varSuccess is false after PatchMalfunctionActivity

  • Path: PatchMalfunctionActivity → PatchMalfunctionIfActivity (false) → ErrorSetActivity

  • Impact: Cannot update malfunction details in Maintenance Management

  • Possible Cause: Invalid malfunction ID, malfunction data or ERPConn has wrong permissions to access Maintenance Management

8. Preventive Task Update Failure

  • Trigger: The call to update preventive task information fails

  • Condition: varSuccess is false after PatchPlannedMaintenanceActivity

  • Path: PatchPlannedMaintenanceActivity → PatchPreventiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Cannot update preventive task details in Maintenance Management

  • Possible Cause: Invalid planned maintenance ID, planned maintenance data or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetNotification

Order Confirmation Created Workflow

Error Paths

1. Order Confirmation Retrieval Failure

  • Trigger: The call to retrieve order confirmation information fails

  • Condition: varSuccess is false after GetOrderConfirmationActivity

  • Path: GetOrderConfirmationActivity → GetOrderConfirmationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve confirmation details from SAP, workflow terminates

  • Possible Cause: Invalid order confirmation ID or invalid API key

2. No Time Confirmed Error

  • Trigger: Order confirmation with zero confirmed time

  • Condition: (varOrderConfirmationResponseObject?.ConfirmedEffort?.TotalSeconds ?? 0) ⇐ 0

  • Path: DeserializeOrderConfirmationResponseActivity → IsTimeConfirmedIfActivity (false) → NoTimeConfirmedErrorSetActivity

  • Impact: Work time confirmation cannot be created with zero hours, workflow terminates with specific error

  • Possible Cause: The order confirmation does not have any time booked

3. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve order details from SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

4. Confirmed User Retrieval Failure

  • Trigger: The call to retrieve user information for the confirming user fails

  • Condition: varSuccess is false after GetConfirmedUserActivity

  • Path: GetConfirmedUserActivity → GetConfirmedUserIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve user details for confirmation, workflow terminates

  • Possible Cause: The confirming user does not exist in MACMA or ERPConn has wrong permissions to access MACMA

5. Task ID Retrieval Failure

  • Trigger: The call to retrieve task ID by external ID fails

  • Condition: varSuccess is false after GetMaintenanceTaskIdActivity

  • Path: GetMaintenanceTaskIdActivity → GetMaintenanceTaskIdSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to locate corresponding task in Maintenance Management, workflow terminates

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

6. Corrective Task Retrieval Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve corrective task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

7. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve preventive task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

8. Work Time Confirmation Creation Failure

  • Trigger: The call to create work time confirmation fails

  • Condition: varSuccess is false after CreateWorkTimeConfirmationActivity

  • Path: CreateWorkTimeConfirmationActivity → CreateWorkTimeConfirmationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create confirmed effort in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID, invalid confirmation data or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

No Time Confirmed Error

{
  "Success": false,
  "Message": "To book working hours, a time value must be entered."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

  • GetOrderConfirmation

Order Confirmation Deleted Workflow

Error Paths

1. Order Confirmation Retrieval Failure

  • Trigger: The call to retrieve order confirmation information fails

  • Condition: varSuccess is false after GetOrderConfirmationActivity

  • Path: GetOrderConfirmationActivity → GetOrderConfirmationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve confirmation details from SAP, workflow terminates

  • Possible Cause: Invalid order confirmation ID or invalid API key

2. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve order details from SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

3. Task ID Retrieval Failure

  • Trigger: The call to retrieve task ID by external ID fails

  • Condition: varSuccess is false after GetMaintenanceTaskIdActivity

  • Path: GetMaintenanceTaskIdActivity → GetMaintenanceTaskIdSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to locate corresponding task in Maintenance Management, workflow terminates

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

4. Corrective Task Retrieval Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve corrective task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

5. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve preventive task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

6. Work Time Confirmation Deletion Failure

  • Trigger: The call to delete work time confirmation fails

  • Condition: varSuccess is false after DeleteWorkTimeConfirmationActivity

  • Path: DeleteWorkTimeConfirmationActivity → DeleteWorkTimeConfirmationActivitySuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to delete confirmed effort in Maintenance Management, workflow terminates

  • Possible Cause: Invalid order confirmation ID or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

  • GetOrderConfirmation

Order Created Workflow

Error Paths

1. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve order details from SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

2. Missing Equipment Error

  • Trigger: The order doesn’t have an equipment selected

  • Condition: String.IsNullOrEmpty(varOrderResponseObject.Equipment) is true

  • Path: DeserializeOrderResponse → EquipmentSelectedIfActivity (true) → MissingEquipmentErrorSetActivity

  • Impact: Task creation fails as equipment is required, workflow terminates with specific error

  • Possible Cause: No equipment has been selected for the order in SAP

3. Notification Retrieval Failure

  • Trigger: The call to retrieve notification information fails

  • Condition: varSuccess is false after GetNotificationActivity

  • Path: GetNotificationActivity → IsGetNotificationSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve notification details from SAP, workflow terminates

  • Possible Cause: Invalid notification ID or invalid API key

4. Device Retrieval Failure

  • Trigger: The call to retrieve device information from MDM fails

  • Condition: varSuccess is false after GetMdmDeviceActivity

  • Path: GetMdmDeviceActivity → GetMdmDeviceIfActivity (false) → ErrorSetActivity

  • Impact: Unable to find device with matching SAP ID in MDM, workflow terminates

  • Possible Cause: The device with the specified SAP ID does not exist in MDM or ERPConn has wrong permissions to access MDM

5. Assigned User Retrieval Failure

  • Trigger: The call to retrieve assigned user information fails

  • Condition: varSuccess is false after GetAssignedUserActivity

  • Path: GetAssignedUserActivity → GetAssignedUserIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve assigned user details, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

6. Solver Group Retrieval Failure

  • Trigger: The call to retrieve solver group information fails

  • Condition: varSuccess is false after GetSolverGroupInfoActivity

  • Path: GetSolverGroupInfoActivity → GetSolverGroupInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve solver group details from MACMA, workflow terminates

  • Possible Cause: The solver group does not exist in MACMA or ERPConn has wrong permissions to access MACMA

7. Created By User Retrieval Failure

  • Trigger: The call to retrieve creator’s user information fails

  • Condition: varSuccess is false after GetCreatedByUserActivity

  • Path: GetCreatedByUserActivity → GetUserInfosIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve user details of task creator, workflow terminates

  • Possible Cause: The creator user does not exist in MACMA or ERPConn has wrong permissions to access MACMA

8. Corrective Task Creation Failure

  • Trigger: The call to create a corrective task fails

  • Condition: varSuccess is false after CreateCorrectiveTaskActivity

  • Path: CreateCorrectiveTaskActivity → CreateCorrectiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create corrective task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

9. Preventive Task Creation Failure

  • Trigger: The call to create a preventive task fails

  • Condition: varSuccess is false after CreatePreventiveTaskActivity

  • Path: CreatePreventiveTaskActivity → CreatePreventiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create preventive task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

10. External IDs Update Failure

  • Trigger: The call to update external IDs fails

  • Condition: varSuccess is false after UpdateCorrectiveExternalIdsActivity or UpdatePreventiveExternalIdActivity

  • Path: UpdateCorrectiveExternalIdsActivity/UpdatePreventiveExternalIdActivity → UpdateExternalIdsIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task with SAP IDs, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

11. External System Lock Failure

  • Trigger: The call to set external system lock fails

  • Condition: varSuccess is false after SetLockByExternalSystemActivity

  • Path: SetLockByExternalSystemActivity → SetLockByExternalSystemIfActivity (false) → ErrorSetActivity

  • Impact: Unable to set lock for external system updates, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

12. Task State Update Failure

  • Trigger: The call to set task state fails

  • Condition: varSuccess is false after SetTaskStateActivity

  • Path: SetTaskStateActivity → PutTaskStateSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task state to match order state, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Missing Equipment Error

{
  "Success": false,
  "Message": "No equipment has been selected for this order. Without a valid equipment no order operation for this order can be synced to MM. All workflows for this order will fail."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

  • GetNotification

Order Operation Changed Workflow

Error Paths

1. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve order details from SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

2. Assigned User Retrieval Failure

  • Trigger: The call to retrieve assigned user information fails

  • Condition: varSuccess is false after GetAssignedUserActivity

  • Path: GetAssignedUserActivity → GetAssignedUserIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve user details for assigned employee, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

3. Solver Group Retrieval Failure

  • Trigger: The call to retrieve solver group information fails

  • Condition: varSuccess is false after GetGroupActivity

  • Path: GetGroupActivity → GetGroupsIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve solver group details from MACMA, workflow terminates

  • Possible Cause: The solver group does not exist in MACMA or ERPConn has wrong permissions to access MACMA

4. Task ID Retrieval Failure

  • Trigger: The call to retrieve task ID by external ID fails

  • Condition: varSuccess is false after GetMMTaskIdActivity

  • Path: GetMMTaskIdActivity → IsGetMMTaskIdSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to locate corresponding task in Maintenance Management, workflow terminates#

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

5. Corrective Task Retrieval Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve corrective task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

6. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve preventive task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

7. Latest Order Retrieval Failure

  • Trigger: The second call to retrieve order information fails

  • Condition: varSuccess is false after GetLatestOrderActivity

  • Path: GetLatestOrderActivity → GetLatestOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve latest order details for verification, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

8. Corrective Task Update Failure

  • Trigger: The call to patch corrective task fails

  • Condition: varSuccess is false after PatchCorrectiveTaskActivity

  • Path: PatchCorrectiveTaskActivity → PatchCorrectiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update corrective task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

9. Preventive Task Update Failure

  • Trigger: The call to patch preventive task fails

  • Condition: varSuccess is false after PatchPreventiveTaskActivity

  • Path: PatchPreventiveTaskActivity → PatchPreventiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update preventive task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

Order Operation Created Workflow

Error Paths

1. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve order details from SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

2. Corrective Task Retrieval Failure

  • Trigger: The call to retrieve corrective task information fails

  • Condition: varSuccess is false after GetCorrectiveTaskActivity

  • Path: GetCorrectiveTaskActivity → GetCorrectiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve corrective task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

3. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve preventive task details, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

4. Notification Retrieval Failure

  • Trigger: The call to retrieve notification information fails

  • Condition: varSuccess is false after GetNotificationActivity

  • Path: GetNotificationActivity → GetNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve notification details from SAP, workflow terminates

  • Possible Cause: Invalid notification ID or invalid API key

5. Order Operation Retrieval Failure

  • Trigger: The call to retrieve order operation information fails

  • Condition: varSuccess is false after GetOrderOperationActivity

  • Path: GetOrderOperationActivity → GetOperationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve operation details from SAP, workflow terminates

  • Possible Cause: Invalid order operation ID or invalid API key

6. Device Retrieval Failure

  • Trigger: The call to retrieve device information fails

  • Condition: varSuccess is false after GetDeviceBySapEquipmentIdActivity

  • Path: GetDeviceBySapEquipmentIdActivity → GetDeviceBySapEquipmentIdIfActivity (false) → ErrorSetActivity

  • Impact: Unable to find device with matching SAP ID in MDM, workflow terminates

  • Possible Cause: The device with the specified SAP ID does not exist in MDM or ERPConn has wrong permissions to access MDM

7. User Retrieval Failure

  • Trigger: The call to retrieve assigned user information fails

  • Condition: varSuccess is false after GetAssignedUserActivity

  • Path: GetAssignedUserActivity → GetAssignedUserIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve user details for assigned employee, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

8. Group Retrieval Failure

  • Trigger: The call to retrieve solver group information fails

  • Condition: varSuccess is false after GetGroupActivity

  • Path: GetGroupActivity → GetGroupsSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve solver group details, workflow terminates

  • Possible Cause: The solver group does not exist in MACMA or ERPConn has wrong permissions to access MACMA

9. Corrective Task Creation Failure

  • Trigger: The call to create corrective task fails

  • Condition: varSuccess is false after CreateCorrectiveTaskActivity

  • Path: CreateCorrectiveTaskActivity → CreateCorrectiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create corrective task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

10. Preventive Task Creation Failure

  • Trigger: The call to create preventive task fails

  • Condition: varSuccess is false after CreatePreventiveTaskActivity

  • Path: CreatePreventiveTaskActivity → CreatePreventiveTaskIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create preventive task in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task data or ERPConn has wrong permissions to access Maintenance Management

11. External IDs Update Failure

  • Trigger: The call to update external IDs fails

  • Condition: varSuccess is false after UpdateExternalIdsActivity

  • Path: UpdateExternalIdsActivity → UpdateExternalIdsIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task with SAP IDs, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

12. External System Lock Failure

  • Trigger: The call to set external system lock fails

  • Condition: varSuccess is false after SetLockByExternalSystemActivity

  • Path: SetLockByExternalSystemActivity → SetLockByExternalSystemIfActivity (false) → ErrorSetActivity

  • Impact: Unable to set lock for external system updates, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

13. Task State Update Failure

  • Trigger: The call to update task state fails

  • Condition: varSuccess is false after SetTaskStateActivity

  • Path: SetTaskStateActivity → PutTaskStateSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task state to match order state, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

  • GetNotification

  • GetOrderOperation

Update Planned Maintenance Workflow

Error Paths

1. External ID Retrieval Failure

  • Trigger: After multiple attempts (4), the external ID for the planned maintenance is still not available

  • Condition: varPlannedMaintenance?["result"]?["externalId"]?.Value<string?>() == null && varWhileExternalIdCounter > 4

  • Path: IsExternalIdAvailableWhileActivity → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve external ID required for synchronization with ERP, workflow terminates

  • Possible Cause: The external ID was never set in the planned maintenance or ERPConn has wrong permissions to access Maintenance Management

2. Planned Maintenance Retrieval Failure

  • Trigger: The call to retrieve planned maintenance information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve planned maintenance details from Maintenance Management, workflow terminates

  • Possible Cause: Invalid planned maintenance ID or ERPConn has wrong permissions to access Maintenance Management

3. Update Notification Failure

  • Trigger: The call to update notification fails

  • Condition: varSuccess is false after UpdateNotificationActivity

  • Path: UpdateNotificationActivity → UpdateNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update notification in ERP with changes from planned maintenance, workflow terminates

  • Possible Cause: Invalid notification ID, invalid notification data or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • UpdateNotification

Update Preventive Machine Task Workflow

Error Paths

1. External ID Availability Failure

  • Trigger: After multiple attempts (4), the external ID for the preventive task is still not available

  • Condition: varTaskResponse?["result"]?["externalId"]?.Value<string?>() == null && varWhileExternalIdCounter > 4

  • Path: IsExternalIdAvailableWhileActivity → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve external ID required for synchronization with ERP, workflow terminates

  • Possible Cause: The external ID was never set in the task or ERPConn has wrong permissions to access Maintenance Management

2. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetMmInfos → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve preventive task details from Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

3. User Information Retrieval Failure

  • Trigger: The call to retrieve user information fails

  • Condition: varSuccess is false after GetUserInfoActivity

  • Path: GetUserInfoActivity → GetUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID for the assigned user, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

4. Operation Update Failure

  • Trigger: The call to update order operation fails

  • Condition: varSuccess is false after UpdateOperationActivity

  • Path: UpdateOperationActivity → UpdateOperationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update operation details in SAP, workflow terminates

  • Possible Cause: Invalid operation data, invalid order operation ID or invalid API key

5. Operation Long Text Check Failure

  • Trigger: The call to check operation long text fails

  • Condition: varSuccess is false after CheckOperationLongTextActivity

  • Path: CheckOperationLongTextActivity → CheckOperationLongTextSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to check if long text exists for the operation, workflow terminates

  • Possible Cause: Invalid operation data, invalid order operation ID or invalid API key

6. Operation Long Text Creation Failure

  • Trigger: The call to create operation long text fails

  • Condition: varSuccess is false after CreateOperationLongTextActivity

  • Path: CreateOperationLongTextActivity → CreateOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create long text for the operation, workflow terminates

  • Possible Cause: Invalid operation data, invalid order operation ID or invalid API key

7. Operation Long Text Update Failure

  • Trigger: The call to update operation long text fails

  • Condition: varSuccess is false after UpdateOperationLongTextActivity

  • Path: UpdateOperationLongTextActivity → UpdateOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update long text for the operation, workflow terminates

  • Possible Cause: Invalid operation data, invalid order operation ID or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail: - GetOrderLockState - UnlockOrder - LockOrder - UpdateOrder - UpdateOrderOperation - GetOrderOperationLongText - CreateOrderOperationLongText - UpdateOrderOperationLongText

Preventive Order Changed Workflow

Error Paths

1. Message Flow Processing Failure

  • Trigger: Invalid message ID or message flow data cannot be retrieved

  • Condition: When ParseEventDataActivity fails to parse event data correctly or event is invalid

  • Path: GetMessageFlowActivity → ParseEventDataActivity → IsValidEventIfActivity (false) → AbortActivity

  • Impact: Workflow cannot process the order change event, terminates with "Nothing to do" message

  • Possible Cause: The event data is malformed or does not contain necessary information

2. Order Retrieval Failure

  • Trigger: The call to retrieve order information fails

  • Condition: varSuccess is false after GetOrderActivity

  • Path: GetOrderActivity → GetOrderSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve order details from SAP to process changes, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

3. Task ID Retrieval Failure

  • Trigger: The call to retrieve task ID by external ID fails

  • Condition: varSuccess is false after GetMMTaskIdActivity

  • Path: ForEachOperationLoopActivity → GetMMTaskIdActivity → IsGetMMTaskIdSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot locate corresponding preventive task in Maintenance Management, workflow terminates

  • Possible Cause: The external ID does not match any task in Maintenance Management or ERPConn has wrong permissions to access Maintenance Management

4. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetPreventiveTaskActivity → GetPreventiveTaskSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot retrieve preventive task details to apply updates, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

5. Planned Maintenance Update Failure

  • Trigger: The call to patch planned maintenance fails

  • Condition: varSuccess is false after PatchPlannedMaintenanceActivity

  • Path: PatchPlannedMaintenanceActivity → PatchPlannedMaintenanceIfActivity (false) → ErrorSetActivity

  • Impact: Cannot update planned maintenance data in Maintenance Management, workflow terminates

  • Possible Cause: Invalid planned maintenance data or ERPConn has wrong permissions to access Maintenance Management

6. External System Lock Failure

  • Trigger: The call to set external system lock fails

  • Condition: varSuccess is false after SetLockByExternalSystemActivity

  • Path: SetLockByExternalSystemActivity → SetLockByExternalSystemIfActivity (false) → ErrorSetActivity

  • Impact: Cannot set lock for external system updates, which is required for state changes, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

7. Task State Update Failure

  • Trigger: The call to update task state fails

  • Condition: varSuccess is false after SetTaskStateActivity

  • Path: SetTaskStateActivity → PutTaskStateSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Cannot update task state to match order state changes, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • GetOrder

Create Preventive Task Workflow

Error Paths

1. Preventive Task Retrieval Failure

  • Trigger: The call to retrieve preventive task information fails

  • Condition: varSuccess is false after GetPreventiveTaskActivity

  • Path: GetMmInfos → IsMmCallSuccessIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve task data from Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

2. Assigned User Information Retrieval Failure

  • Trigger: The call to retrieve assigned user information fails

  • Condition: varSuccess is false after GetAssignedUserInfoActivity

  • Path: GetAssignedUserInfoActivity → GetAssignedUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID for assigned user, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

3. Device Retrieval Failure

  • Trigger: The call to retrieve device information fails

  • Condition: varSuccess is false after GetDeviceActivity

  • Path: GetDeviceActivity → GetDeviceIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve device details for the task, workflow terminates

  • Possible Cause: The device with the specified SAP ID does not exist in MDM or ERPConn has wrong permissions to access MDM

4. Missing Equipment ID Error

  • Trigger: The device doesn’t have a SAP ID defined

  • Condition: varDeviceResponse["identifiers"]["sapid"] != null is false

  • Path: CheckForExistingEquipmentIdIfActivity (false) → MissingEquipmentIdErrorActivity

  • Impact: Unable to create task in SAP without equipment ID, workflow terminates

  • Possible Cause: The device does not have an identifier 'sapid' defined in MDM

5. Created By User Information Retrieval Failure

  • Trigger: The call to retrieve creator’s user information fails

  • Condition: varSuccess is false after GetCreatedByUserInfoActivity

  • Path: GetCreatedByUserInfoActivity → GetCreatedByUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID of task creator, workflow terminates

  • Possible Cause: The creator user does not exist in MACMA or ERPConn has wrong permissions to access MACMA

6. Create Notification Failure

  • Trigger: The call to create a notification in SAP fails

  • Condition: varSuccess is false after CreateNotificationActivity

  • Path: CreateNotificationActivity → CreateNotificationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create notification in SAP, workflow terminates

  • Possible Cause: Invalid notification data or invalid API key

7. Create Order Failure

  • Trigger: The call to create an order in SAP fails

  • Condition: varSuccess is false after CreateOrderActivity

  • Path: CreateOrderActivity → CreateOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create order in SAP, workflow terminates

  • Possible Cause: Invalid order data or invalid API key

8. Update Order Failure

  • Trigger: The call to update an order in SAP fails

  • Condition: varSuccess is false after UpdateOrderActivity

  • Path: UpdateOrderActivity → UpdateOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update order in SAP, workflow terminates

  • Possible Cause: Invalid order data or invalid API key

9. Get Next Order Operation ID Failure

  • Trigger: The call to get next operation ID fails

  • Condition: varSuccess is false after GetNextOrderOperationIdActivity

  • Path: GetNextOrderOperationIdActivity → GetNextOrderOperationIdIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve next operation ID for related task, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

10. Create Order Operation Failure

  • Trigger: The call to create an order operation fails

  • Condition: varSuccess is false after CreateOrderOperationActivity

  • Path: CreateOrderOperationActivity → CreateOrderOperationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to create operation in SAP order, workflow terminates

  • Possible Cause: Invalid operation data, invalid order ID or invalid API key

11. Create Order Operation Long Text Failure

  • Trigger: The call to create long text for order operation fails

  • Condition: varSuccess is false after CreateOrderOperationLongTextActivity

  • Path: CreateOrderOperationLongTextActivity → CreateOrderOperationLongTextIfActivity (false) → ErrorSetActivity

  • Impact: Unable to add detailed description to operation, workflow terminates

  • Possible Cause: Invalid long text data, invalid order operation ID or invalid API key

12. Update External IDs Failure

  • Trigger: The call to update external IDs in Maintenance Management fails

  • Condition: varSuccess is false after UpdateExternalIdsActivity

  • Path: UpdateExternalIdsActivity → UpdateExternalIdsIfActivity (false) → ErrorSetActivity

  • Impact: Unable to update task with SAP IDs, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Missing Equipment ID Error

{
  "Success": false,
  "Message": "The device does not have an identifier 'sapid' (case sensitive). Please add it in MDM."
}

Required Operations

The workflow depends on the following operations that might fail:

  • CreateNotification

  • CreateOrder

  • UpdateOrder

  • CreateOrderOperation

  • CreateOrderOperationLongText

  • GetOrderOperationLastId

Resolve Task Workflow

Error Paths

1. Task External ID Retrieval Failure

  • Trigger: Unable to retrieve task external ID after multiple attempts

  • Condition: varTaskExternalId == null || !varSuccess after 4 retry attempts

  • Path: IsExternalIdAvailableWhileActivity → GetTaskOverviewIfActivity (false) → ErrorSetActivity

  • Impact: Unable to find external ID reference for SAP, workflow terminates

  • Possible Cause: The external ID was never set in the task or ERPConn has wrong permissions to access Maintenance Management

2. User Information Retrieval Failure

  • Trigger: The call to retrieve user information fails

  • Condition: varSuccess is false after GetUserInfoActivity

  • Path: GetUserInfoActivity → GetUserInfoIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve employee ID for assigned user, workflow terminates

  • Possible Cause: The assigned user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

3. Create Order Confirmation Failure

  • Trigger: The call to create order confirmation in SAP fails

  • Condition: varSuccess is false after CreateOrderConfirmationActivity

  • Path: CreateOrderConfirmationActivity → CreateOrderConfirmationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to confirm completion of order in SAP, workflow terminates

  • Possible Cause: Invalid order confirmation data or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • CreateOrderConfirmation

  • GetTaskOverview

  • GetUserInfo

Set Task In Progress Workflow

Error Paths

1. Task External ID Retrieval Failure

  • Trigger: Unable to retrieve task external ID after multiple attempts

  • Condition: varTaskExternalId == null || !varSuccess after 4 retry attempts

  • Path: IsExternalIdAvailableWhileActivity → GetTaskOverviewIfActivity (false) → ErrorSetActivity

  • Impact: Unable to find external ID reference needed for SAP operations, workflow terminates

  • Possible Cause: The external ID was never set in the task or ERPConn has wrong permissions to access Maintenance Management

2. Release Order Failure

  • Trigger: The call to release the order in SAP fails

  • Condition: varSuccess is false after ReleaseOrderActivity

  • Path: ReleaseOrderActivity → ReleaseOrderIfActivity (false) → ErrorSetActivity

  • Impact: Unable to release the order in SAP, workflow terminates

  • Possible Cause: Invalid order ID or invalid API key

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • UnlockOrder

  • ReleaseOrder

  • LockOrder

Work Time Confirmation Workflow

Error Paths

1. Confirmed Effort Retrieval Failure

  • Trigger: The call to retrieve confirmed effort information fails

  • Condition: varSuccess is false after GetConfirmedEffortActivity

  • Path: GetConfirmedEffortActivity → GetConfirmedEffortIfActivity (false) → ErrorSetActivity

  • Impact: Unable to retrieve confirmed effort data from Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

2. Task External ID Retrieval Failure

  • Trigger: Unable to retrieve task external ID after multiple attempts

  • Condition: varTaskExternalId == null || !varSuccess after 4 retry attempts

  • Path: IsExternalIdAvailableWhileActivity → GetTaskOverviewIfActivity (false) → ErrorSetActivity

  • Impact: Unable to find external ID reference needed for SAP operations, workflow terminates

  • Possible Cause: The external ID was never set in the task or ERPConn has wrong permissions to access Maintenance Management

3. User Information Retrieval Failure

  • Trigger: The call to retrieve user information fails

  • Condition: varSuccess is false after GetUserInfoActivity

  • Path: GetUserInfoActivity → CreateOrderConfirmationActivity (still executes but likely fails)

  • Impact: Unable to retrieve employee ID for the user confirming time, leading to subsequent failure

  • Possible Cause: The user does not have an EmployeeId defined in MACMA or ERPConn has wrong permissions to access MACMA

4. Order Confirmation Creation Failure

  • Trigger: The call to create order confirmation in SAP fails

  • Condition: varSuccess is false after CreateOrderConfirmationActivity

  • Path: CreateOrderConfirmationActivity → CreateOrderConfirmationIfActivity (false) → ErrorSetActivity

  • Impact: Unable to confirm working time in SAP, workflow terminates

  • Possible Cause: Invalid order confirmation data or invalid API key

5. External IDs Update Failure

  • Trigger: The call to update external IDs in Maintenance Management fails

  • Condition: varSuccess is false after UpdateExternalIdsActivity

  • Path: UpdateExternalIdsActivity → UpdateExternalIdsIfActivity (false) → ErrorSetActivity

  • Impact: Order confirmation created in SAP but reference ID not stored in Maintenance Management, workflow terminates

  • Possible Cause: Invalid task ID or ERPConn has wrong permissions to access Maintenance Management

General Error

{
  "Success": false,
  "Message": "Error inside the workflow. Please check the orchestrator log for more details."
}

Required Operations

The workflow depends on the following operations that might fail:

  • UnlockOrder

  • CreateOrderConfirmation

  • LockOrder

Contents

© Robert Bosch Manufacturing Solutions GmbH 2023-2025, all rights reserved

Changelog Corporate information Legal notice Data protection notice Third party licenses