Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Use the GetListItem component

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 (
Image omitted: component-settings-icon.png
Component settings icon.\).
2.  Click the add index icon \(
Image omitted: add-image-icon.png
Add index icon.\).
3.  Update the data type of the index value.

    A Data out port is dynamically created with each index that you add.

4.  Repeat the steps to add more indexes.

5.  Click **OK**.
  1. To configure the input field, Configure port properties.

  2. Connect the data and control ports of the GetListItem component to the corresponding ports of the other components.

    Port typePort nameData typePurpose of connectionDefault valueMandatory?
    Data InInstanceObjectTakes a list item.No default valueYes
    Data OutName of the port is the same as the name of the index value that is created.ObjectReturns the list item.Not applicableNot applicable
  3. To test the component, right-click the component bar and then click Run From Here.

Parent Topic:Reflection