Handling JSON Data in OmniScript File Uploads

 While testing File Upload functionality in Salesforce OmniScript, an important limitation was observed during debugging and data handling.

Key Observation

When testing an OmniScript with File Upload, the JSON data is not directly visible in Debug mode. This can be challenging when you need to extract specific attributes from the uploaded file data for use in subsequent OmniScript steps.

Additionally:

• %Data% and %Context% do not work directly when placed in a Text Block after the OmniScript is activated.
• Unlike during preview or debug, activated OmniScripts do not automatically expose the full JSON payload for display.

---

Solution: Use Data Mapper (Transform Action)

To make the required attributes available for downstream processing or display:

• Use a Data Mapper – Transform Action
• Explicitly map the required attributes from the file upload JSON into output nodes
• These mapped outputs can then be referenced reliably in:
  • Subsequent OmniScript elements
  • Integration Procedures
  • Text Blocks or UI components

This approach ensures the needed data is surfaced in a controlled and supported way, instead of relying on raw %Data% or %Context%.

Helpful Reference

Salesforce documentation that explains this behavior and recommended approach in detail:
🔗 Salesforce Help Article
https://help.salesforce.com/s/articleView?id=000391069&type=1