Common errors in 3DSwym macros and how to fix them

When working with 3DSwym macros, developers often face issues related to authentication, permissions, API calls, and script execution. Below are the most common errors and their fixes.

 1. Authentication Failed / Unauthorized Access

Problem: Macro cannot access API or returns 401/403 errors.
Fix:

  • Verify API token or session credentials
  • Ensure correct OAuth configuration
  • Check user permissions in 3DEXPERIENCE platform
  • Regenerate access tokens if expired

 2. Permission Denied Errors

Problem: Macro runs but cannot read or modify data.
Fix:

  • Confirm user role has access to the community or content
  • Update role-based permissions in admin settings
  • Ensure API scope includes required endpoints

 3. API Timeout Issues

Problem: Macro execution fails due to slow response.
Fix:

  • Reduce number of API calls in a single macro
  • Optimize queries and filters
  • Use pagination for large datasets
  • Retry requests with exponential backoff

 4. Invalid API Response / Empty Data

Problem: Macro returns no data or malformed response.
Fix:

  • Check endpoint URL correctness
  • Validate request parameters
  • Ensure data exists in the community
  • Test API call separately using Postman

 5. Script Execution Errors

Problem: Macro stops due to syntax or runtime errors.
Fix:

  • Review macro script for syntax mistakes
  • Ensure correct JSON structure
  • Add error handling (try/catch blocks)
  • Test step-by-step execution

 6. Rate Limit Exceeded

Problem: Too many API requests in a short time.
Fix:

  • Implement request throttling
  • Add delays between API calls
  • Batch multiple operations when possible