Use the GetListItem component

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read
  • Return items from a list by using the GetListItem component in RPA Desktop Design Studio.

    Before you begin

    Role required: none

    About this task

    You can configure the properties for the GetListItem component. For more information about these properties, see Properties of the Reflection components.

    Procedure

    1. In the Toolbox pane, navigate to Utilities > Reflection.
    2. Drag the GetListItem component to the Design surface.
    3. To set the field that accepts an item from the list, do the following steps.
      1. Click the component settings icon (Component settings icon.).
      2. Click the add index icon (Add index icon.).
      3. Optional: Update the data type of the index value.
        A Data out port is dynamically created with each index that you add.
      4. Optional: Repeat the steps to add more indexes.
      5. Click OK.
    4. To configure the input field, Configure port properties.
    5. Optional: Connect the data and control ports of the GetListItem component to the corresponding ports of the other components.
      Port type Port name Data type Purpose of connection Default value Mandatory?
      Data In Instance Object Takes a list item. No default value Yes
      Data Out Name of the port is the same as the name of the index value that is created. Object Returns the list item. Not applicable Not applicable
    6. Optional: To test the component, right-click the component bar and then click Run From Here.