This function is used in Python Scripting.


Takes a Python object such as a list or dictionary and converts into a JSON string.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.


system.util.jsonEncode(pyObj, [indentFactor])

  • Parameters

Any pyObj - The Python object to encode into JSON such as a Python list or dictionary.

Integer indentFactor - The number of spaces to add to each level of indentation for prettyprinting. [optional]

  • Returns

String - The encoded JSON string.

  • Scope

Gateway, Vision Client, Perspective Session

JSON to Python Mapping

The table below lists possible Python types, and how they map to JSON objects. 

Python TypeMapped JSON Type
Boolean (True/False)Boolean (true/false)
Number (Float, Integer)Numeric
Code Examples
Code Snippet
# The following example builds a Python dictionary and converts it to a JSON string.
# Build the Python dictionary.
employeeDict = {"employees":[{"firstName":"John", "lastName":"Doe"},{"firstName":"Anna", "lastName":"Smith"},{"firstName":"Peter", "lastName":"Jones"}]}
# Convert the dictionary and store the resulting JSON string in a variable. 
jsonString = system.util.jsonEncode(employeeDict)

system util jsonEncode, util.jsonEncode