126 lines
2.9 KiB
Markdown
126 lines
2.9 KiB
Markdown
# SAP Build Work Zone Troubleshooting Guide
|
|
|
|
Common issues and solutions for SAP Build Work Zone, advanced edition.
|
|
|
|
**Source**: [https://github.com/SAP-docs/sap-btp-build-work-zone-advanced](https://github.com/SAP-docs/sap-btp-build-work-zone-advanced)
|
|
|
|
## Table of Contents
|
|
|
|
- [API Errors](#api-errors)
|
|
- [HTTP 503 - Service Unavailable](#http-503---service-unavailable)
|
|
- [HTTP 429 - Too Many Requests](#http-429---too-many-requests)
|
|
- [OAuth Authentication Failure](#oauth-authentication-failure)
|
|
- [Card Issues](#card-issues)
|
|
- [Card Not Displaying](#card-not-displaying)
|
|
- [Card Deployment Failed](#card-deployment-failed)
|
|
- [Workspace Issues](#workspace-issues)
|
|
- [Cannot Create Workspace](#cannot-create-workspace)
|
|
- [Missing Content](#missing-content)
|
|
- [Performance Issues](#performance-issues)
|
|
- [Slow Page Load](#slow-page-load)
|
|
- [Integration Issues](#integration-issues)
|
|
- [Microsoft Teams Connection Failed](#microsoft-teams-connection-failed)
|
|
|
|
---
|
|
|
|
## API Errors
|
|
|
|
### HTTP 503 - Service Unavailable
|
|
|
|
**Cause**: Service maintenance or system overload
|
|
|
|
**Solution**: Wait and retry after a few minutes
|
|
|
|
### HTTP 429 - Too Many Requests
|
|
|
|
**Cause**: Rate limit exceeded
|
|
|
|
**Solution**:
|
|
1. Check `X-RateLimit-Remaining` header
|
|
2. Wait for `X-RateLimit-Reset` seconds
|
|
3. Implement exponential backoff
|
|
|
|
### OAuth Authentication Failure
|
|
|
|
**Cause**: Invalid or expired credentials
|
|
|
|
**Solution**:
|
|
1. Verify Workzone API Client credentials
|
|
2. Check OAuth token expiration
|
|
3. Regenerate client secret if needed
|
|
|
|
---
|
|
|
|
## Card Issues
|
|
|
|
### Card Not Displaying
|
|
|
|
**Causes**:
|
|
- SAPUI5 version incompatibility
|
|
- Invalid manifest.json
|
|
- Missing destinations
|
|
|
|
**Solutions**:
|
|
1. Verify SAPUI5 version (1.87.0+)
|
|
2. Validate card manifest
|
|
3. Check destination configuration
|
|
|
|
### Card Deployment Failed
|
|
|
|
**Causes**:
|
|
- Missing permissions
|
|
- Invalid package structure
|
|
|
|
**Solutions**:
|
|
1. Verify Workzone_Admin role
|
|
2. Check project structure
|
|
3. Review deployment logs
|
|
|
|
---
|
|
|
|
## Workspace Issues
|
|
|
|
### Cannot Create Workspace
|
|
|
|
**Cause**: Permission restrictions
|
|
|
|
**Solution**: Check workspace creation settings in Features
|
|
|
|
### Missing Content
|
|
|
|
**Cause**: Permission or visibility settings
|
|
|
|
**Solution**: Verify content permissions and user access
|
|
|
|
---
|
|
|
|
## Integration Issues
|
|
|
|
### Microsoft Teams Connection Failed
|
|
|
|
**Causes**:
|
|
- Invalid OAuth configuration
|
|
- Tenant mismatch
|
|
|
|
**Solutions**:
|
|
1. Verify Azure AD app registration
|
|
2. Check tenant configuration
|
|
3. Review consent permissions
|
|
|
|
---
|
|
|
|
## Performance Issues
|
|
|
|
### Slow Page Load
|
|
|
|
**Solutions**:
|
|
1. Reduce number of cards per page
|
|
2. Optimize card data queries
|
|
3. Enable CDN for static content
|
|
|
|
---
|
|
|
|
**Documentation Links**:
|
|
- Troubleshooting Guide: [https://help.sap.com/docs/build-work-zone-advanced-edition](https://help.sap.com/docs/build-work-zone-advanced-edition)
|
|
- SAP Samples: [https://github.com/SAP-samples/build-workzone-integration](https://github.com/SAP-samples/build-workzone-integration)
|