---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# List connector methods

# List connector methods {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
The List connector methods perform various actions on list items as part of an
automation workflow. You must first expose the methods before using.

## Add {#list-connector-methods__section_e4d_y5q_4tb}

Adds a single list item.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_wpx_2wj_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Item | Name of the list item. | Data in | Object | None | Yes |
[Table 1. Add method parameters]

{#list-connector-methods__table_wpx_2wj_4tb}

## AddList {#list-connector-methods__section_gvd_hvq_4tb}

Adds a list of items.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_jsz_mvq_4tb__entry__7}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? | Notes |
|-|-|-|-|-|-|-|
| List | List of items. | Data in | Object | None | Yes | You can pass the list items from a variable or an appropriate component. |
[Table 2. AddList method parameters]

{#list-connector-methods__table_jsz_mvq_4tb}

## Contains {#list-connector-methods__section_mrr_5yq_4tb}

Returns the Boolean value based on whether a list item exists.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_j5t_czq_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Item | Name of the list item that the method searches. | Data in | Object | None | Yes |
| Return | Returns True if list item found, else, returns False. | Data out | Boolean | Not applicable | Not applicable |
[Table 3. Contains method parameters]

{#list-connector-methods__table_j5t_czq_4tb}

## Count {#list-connector-methods__section_mf2_mzq_4tb}

Returns the total count of list items added.  
{#list-connector-methods__table_os3_rzq_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Return | Returns the total count of list items added. | Data out | Integer | Not applicable | Not applicable |
[Table 4. Count method parameters]

{#list-connector-methods__table_os3_rzq_4tb}

## FindByProperty {#list-connector-methods__section_sl5_wzq_4tb}

Finds a list item based on the specified key and value. You must create at least one key
value pair list item before executing this method.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_mnd_y1r_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Prop | The key in the key value pair. | Data in | String | None | Yes |
| Value | The value in the key value pair. | Data in | String | None | Yes |
| Found | Returns True if list item found, else, returns False. | Data out | Boolean | Not applicable | Not applicable |
| Item | if the Found parameter is True, the method returns the list item. | Data out | Object | Not applicable | Not applicable |
[Table 5. FindByProperty method parameters]

{#list-connector-methods__table_mnd_y1r_4tb}

## FindText {#list-connector-methods__section_abs_vdr_4tb}

Finds text or regex in the list items based on the specified filter and returns the total
occurrences of the text and the text itself.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_tjd_l2r_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| SearchText | Text that the method searches in the list items. | Data in | String | None | Yes |
| FindBy | Option to indicate whether the method searches a text or regex. | Data in | String | None | Yes |
| MatchType | Option to indicate whether the type of match will be: * An exact match * Match case * Containing the specified characters. {#list-connector-methods__ul_ddc_4gr_4tb} | Data In | String | None | Yes |
| Count | Returns the total occurrences of the match. | Data out | Integer | Not applicable | Not applicable |
| Outlist | Returns the list of matches. | Data out | List | Not applicable | Not applicable |
[Table 6. FindByProperty method parameters]

{#list-connector-methods__table_tjd_l2r_4tb}

## GetItem {#list-connector-methods__section_umn_44r_4tb}

Returns a list item based on its index value.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_l1y_t4r_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Index | Index value of the list item. | Data in | Integer | None | Yes |
| Return | Returns the list item. | Data out | Object | Not applicable | Not applicable |
[Table 7. GetItem method parameters]

{#list-connector-methods__table_l1y_t4r_4tb}

## GetItems {#list-connector-methods__section_nks_3pr_4tb}

Returns the list items based on their index values. You must configure the index values
first.  
To configure, do the following steps.

1. Click the method settings icon (![Method settings icon.]()).
2. Click the add index icon (![Add index icon.]()).
3. Enter the index value.
4. Update the data type of the index value.
5. Repeat the steps to add more index values.
6. Click OK.

   A data out port is created with each index value.
   The data out port returns the list item corresponding to the index value.
{#list-connector-methods__ol_u52_xpr_4tb}

## GetList {#list-connector-methods__section_n4g_rrr_4tb}

Returns all list items and lists created.  
{#list-connector-methods__table_hc4_xrr_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Return | Returns the list items and lists. | Data out | Array | None | Not applicable |
[Table 8. GetList method parameters]

{#list-connector-methods__table_hc4_xrr_4tb}

## Remove {#list-connector-methods__section_bzj_psr_4tb}

Removes the specified list item.

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_hxd_vsr_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Item | List item the method removes. | Data in | Object | None | Yes |
[Table 9. GetList method parameters]

{#list-connector-methods__table_hxd_vsr_4tb}

## RemoveAll {#list-connector-methods__section_mbr_btr_4tb}

Removes all list items added.

## Reverse {#list-connector-methods__section_wcc_htr_4tb}

Reverses the order of the index values of the list items.

## SetItems {#list-connector-methods__section_cwd_25r_4tb}

Updates the values of the list items. To use the method, you must first configure the
method.  
To configure, do the following steps.

1. Click the method settings icon (![Method settings icon.]()).
2. Click the add index icon (![Add index icon.]()).
3. Enter the index value.
4. Update the data type of the index value.
5. Repeat the steps to add more index values.
6. Click OK.

   A data in port is created with each index
   value.
{#list-connector-methods__ol_e2j_q5r_4tb}

To provide inputs to the parameters, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").  
{#list-connector-methods__table_u3j_55r_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Item | Accepts the value of the list items. | Data in | Object | None | Yes |
[Table 10. SetItems method parameters]

{#list-connector-methods__table_u3j_55r_4tb}

## Sort {#list-connector-methods__section_tlv_4wr_4tb}

Sorts the list items.

## ToArray {#list-connector-methods__section_pvj_kjs_4tb}

Returns the list items in the form of an array. You must add more than one list item before
executing this method.  
{#list-connector-methods__table_ncv_5js_4tb__entry__6}

| Parameter | Description | Data port type | Data type | Default value | Mandatory? |
|-|-|-|-|-|-|
| Return | Returns the list items in the form of an array list. | Data out | Array list | Not applicable | Not applicable |
[Table 11. ToArray method parameters]

{#list-connector-methods__table_ncv_5js_4tb}