Use the GetProperties component

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • Get the values of multiple properties from a JSON object by using the GetProperties component in RPA Desktop Design Studio.

    Before you begin

    Role required: none

    About this task

    To configure the properties of the GetProperties component, see Properties of the JSON utilities.

    Procedure

    1. In the Toolbox pane, navigate to General and drag the Variable component to the Design surface.
    2. Double-click the variable and enter a code as a variable. 
      {
  "name": "Abel Tutor",
  "age": 30,
  "email": "abletutor@example.com",
}
    3. In the Toolbox pane, navigate to Utilities > JSON.
    4. Drag the GetProperties component to the Design surface.
    5. Click the component settings icon (Component settings icon.).
    6. Click the Add property icon (Add keys icon.).
    7. Enter a property name.
    8. Optional: Repeat the steps to add multiple property names.
      A Data In port is added with each property that you add.
    9. Click OK.
    10. To configure the input fields, see Configure port properties.
    11. Optional: Connect the data and control ports of the GetProperties component to the corresponding ports of the other components as described in the following table.
      Port type Port name Data type Description
      Data In JsonObject Object The JSON object from which to extract property values.

      JSON object to be passed from the previous component.

      Serialize the JSON and pass it from the previous component to get properties.

      Example of JSON object:
      {
  "name": "Abel Tutor",
  "age": 30,
  "email": "abletutor@example.com",
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip": "10001"
  },
  "phoneNumbers": [
    {
      "type": "home",
      "number": "555-1234"
    },
    {
      "type": "work",
      "number": "555-5678"
    }
  ],
  "isActive": true
}
      Data Out Name of the port is the same as the name of the properties that you added. Object Returns the values of the properties.

      If no property value is found, the port return an error.
    12. Optional: To test the component, right-click the component bar and click Run From Here.