---
title: "Example: Data Connector Provides Options in a Select List Control"
slug: "example-data-connector-provides-options-in-a-select-list-control"
updated: 2026-06-03T17:58:02Z
published: 2026-06-03T17:58:02Z
canonical: "documentation.decisions.com/example-data-connector-provides-options-in-a-select-list-control"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Example: Data Connector Provides Options in a Select List Control

Follow an example that uses a Data Connector to get a list of worldwide universities that become the options in a Select List control within a Screen.

## Overview

> **Intended audience:** Process designers, Web designers, graphic designers, software developers, coding engineers
> 
> **Tags:** Data Connector; Select List control; higher education; Screen design

This example demonstrates how a [Select List](/v1/docs/select-list-control) control in a [Screen](/v1/docs/screens) can display the names of major universities around the world as its options in a drop-down menu. The options in this Select List control come from a [Data Connector](/v1/docs/data-connectors) that calls a third-party Application Program Interface (API) when the Screen containing the Select List control opens. Click in the Select List control's drop-down menu to select an option or start typing into the control to filter those university names that match the text entered into the control.

Note that after creating this Data Connector, it may be used for any ProcessMaker Platform asset that can use a Data Connector. It is not limited to being used with a Select List control.

## Create the Data Connector

**Permissions**

Your user account or group membership must have the following permissions to create a new Data Connector unless your user account has the **Make this user a Super Admin** setting selected:

- Data Connectors: Create Data Connectors
- Data Connectors: View Data Connectors

See the [Data Connectors](/v1/docs/permission-descriptions-for-users-and-groups#data-connectors) permissions or ask your Administrator for assistance.

Follow these steps to create the Data Connector as [described in this example](/v1/docs/example-data-connector-provides-options-in-a-select-list-control#overview):

1. [Log on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform.
2. Click the **Designer** option from the top menu. The **Processes** page displays.
3. Click the **Data Connectors** icon![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/932df028-75ac-4347-a0d0-e390fc96a9a1.png)from the left sidebar. The **Data Connectors** tab displays all Data Connectors in the **Data Connectors** page.
4. Verify the Data Connector Category exists in which to assign this Data Connector. If this Category does not exist, see [Create a New Data Connector Category](/v1/docs/data-connector-categories#create-a-new-data-connector-category).
5. Click the **+Data Connector** button. The **Create Data Connector** screen displays.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/98802605-20f2-4aaa-b707-cec2485da3f0.png)
6. In the **Name** setting, enter the name of the Data Connector. This example uses the name `Get List of Major Universities in the World`.
7. In the **Description** setting, enter a description of this Data Connector. This example uses the description:

`This ProcessMaker Platform Data Connector gets a list of major universities around the world in JSON structure.`
8. From the **Authentication Type** drop-down menu, select the **No Auth** option. This example uses this option because the host does not require authentication from its publicly accessible API. Note that the video of this example uses **Basic Auth**, which is not necessary for this example since the data source is publicly accessible.
9. From the **Category** drop-down menu, select the Data Connector Category to assign this Data Connector. This example uses the following settings.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/fb68c12a-db66-4ae1-9f69-df2692a83f6d.png)
10. Click **Save**. The Data Connector is created and the **Resources** tab displays.
11. Click the **+Resources** button. The **Create Resource** screen displays.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/843143e1-21ba-4ce2-b370-996f3e08fa68.png)
12. In the **Name** setting, optionally edit the purpose for this [Resource](/v1/docs/data-connectors#what-is-a-resource). The value the **Name** setting displays from the ProcessMaker Platform asset when configuring the data source from that asset. In this example, this setting value displays from the Select List control to select this Resource to get the list of universities. Therefore, provide a concise but relevant purpose for this Resource so other Process designers understand its function. This example uses `list universities` for this setting.
13. In the **Description** setting, enter a description of this Resource. This example uses the following description: `This Resource gets a JSON list of worldwide universities.`
14. From the **Method** drop-down menu, select the **GET** option. The GET method reads data.
15. In the **URL** setting, enter the following URL for this example: `http://universities.hipolabs.com/search?`. This URL is truncated from the host's [documented example](https://github.com/Hipo/university-domains-list-api) how to search its public API. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/10ab393b-472d-4314-893c-f5137b03330a.png)
16. Click **Add**. The new Resource displays in the **Configuration** tab. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/e2ea96ed-6515-496e-8b01-25bc6728a337.png)
17. Click the **Send** button. If configured correctly, the **Response Body** tab displays the Resource response. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/59d96638-6dab-4de9-8fac-e1cbd11d301a.png)
18. Notice which element in each JSON object within the API endpoint response contains the name of the university. Look at the first JSON object that is the list of universities:

```plaintext
{ 
    "domains": [ 
        "marywood.edu" 
    ], 
    "country": "United States", 
    "web_pages": [ 
        "http://www.marywood.edu" 
    ],
    "name": "Marywood University", 
    "state-province": null, 
    "alpha_two_code": "PA" 
},
```

The `name` element contains the name of each university in this JSON object. Make note of the element's name that contains relevant data from a data source, as the ProcessMaker Platform asset requires this element name when configuring which data that asset requires from the Data Connector's Resource response. In this example, the Screen containing the Select List control is the ProcessMaker Platform asset.
19. Click **Save** to save the Resource. The Data Connector is configured for this example.

## Configure the Select List Control

> ## Permissions Required
> 
> Your user account or group membership must have the following permissions to configure a Select List control unless your user account has the **Make this user a Super Admin** setting selected:
> 
> - Screens: Edit Screens
> - Screens: View Screens
> 
> See the [Screens](/v1/docs/permission-descriptions-for-users-and-groups#screens) permissions or ask your Administrator for assistance.

Follow these steps to configure the Select List control as [described in this example](/v1/docs/example-data-connector-provides-options-in-a-select-list-control#overview):

1. [Create a Screen for this example](/v1/docs/create-a-new-screen#create-a-new-processmaker-screen). This example uses the Form type and the name `Data Connector Example Using a Select List Control` for the Screen.
2. [Add the Select List control to a Screen page](/v1/docs/select-list-control#add-the-control-to-a-processmaker-screen).
3. Most settings for the Select List control are outside the scope of this example. The default settings can be used for required settings, and optional settings do not need to be configured.
4. Expand the **Data Source** panel. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/75e106d6-aa3d-43a9-aa52-aee00b1f7347.png)
5. From the **Data Source** drop-down menu, select the **Data Connector** option. Settings in the **Data Source** panel display to configure which Data Connector and Resource this control uses as its data source.
6. In the **Options Variable** setting, keep the default `response` value. This setting represents the name of the JSON object that contains the response from the Data Connector's Resource. In this example, `response` will contain the JSON array of universities.
7. From the **Type of Value Returned** drop-down menu, select the **Single Value** option because this example requires only one element value from the JSON response.
8. In the **Value** setting, enter the JSON element name that contains the value to use as the Select List option in each JSON object of the Resource response. In this example, enter `name` because the `name` JSON element contains the name of each university in each JSON object.
9. In the **Content** setting enter `name` for the same reason as above.
10. From the **Data Connector** drop-down menu, select the Data Connector the Select List control uses to access the data source. For this example, select **Get List of Major Universities in the World**.
11. From the **End Point** drop-down menu, select which Resource in the selected Data Connector to access the data source. For this example, select **list universities**.
12. [Add a Submit Button control to the Screen page](/v1/docs/submit-button-control#add-the-control-to-a-processmaker-screen) so that the Screen can be submitted.
13. In the Submit Button control, enter a value for the [**Variable Name setting**](/v1/docs/submit-button-control#variable-name). This example uses `submit` for the **Variable Name** setting value.
14. [Save your Screen](/v1/docs/validate-and-publish-a-screen#publish-your-screen). The Select List control is configured for this example.

## Create the Process Model

**Permissions**

Your user account or group membership must have the following permissions to create a new Process unless your user account has the **Make this user a Super Admin** setting selected:

- Processes: Create Processes
- Processes: View Processes

See the [Processes](/v1/docs/permission-descriptions-for-users-and-groups#processes) permissions or ask your Administrator for assistance.

Follow these steps to create the Process model as [described in this example](/v1/docs/example-data-connector-provides-options-in-a-select-list-control#overview):

1. [Create a new Process](/v1/docs/build-your-own-process). This example uses the Process name `List Universities Example`.
2. Add the following BPMN elements to the Process model in that order, and then connect them with [Sequence Flow elements](/v1/docs/sequence-flow-element):
  - [Start Event](/v1/docs/start-event#add-a-start-event-element)
  - [Form Task](/v1/docs/form-task#add-a-form-task-element)
  - [End Event](/v1/docs/end-event#add-an-end-event-element)

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/1e06a202-b369-4bbd-bdb8-5af51972e4cb.png)
3. From the Form Task element, [select the Screen](/v1/docs/form-task#select-the-processmaker-screen-for-the-task) for this example. This example uses the Screen named `Data Connector Example Using a Select List Control`.
4. [Save your Process model](/v1/docs/publish-your-process-model#save-your-process-model). None of the other Process model settings are in the scope of this example. The Process is configured for this example.

## Start a Request for the Example Process

The example is ready to demonstrate. To demonstrate this example, start a Request of this Process.

Follow these steps to start a Request of this Process as [described in this example](/v1/docs/example-data-connector-provides-options-in-a-select-list-control#overview):

1. [Start a Request of this Process](/v1/docs/start-a-case#start-a-request). Remember that the Process name is `List Universities Example`.
2. Open the Form Task from your [To Do Tasks](/v1/docs/tasks#view-your-assigned-tasks). The Process model is configured by default that the Request starter is the Task assignee. After opening the Form Task, the Screen with the Select List control in the example displays.
3. Click the Select List control. The list of universities displays in the same order as they are listed in the host's JSON array. When the Screen opens for the Form Task, the Select List control uses the Data Connector to call the host's Application Program Interface (API) and get the complete JSON array, but only display the `name` element value for each JSON object in that array.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/24f4fa84-3337-44be-8dcd-cfb10fa3478f.png)
4. Type in the Select List control to filter the list of universities that display for selection in the control. For example, start to type `Harvard` to select Harvard University. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/9eff622b-5cf9-48d8-ace6-ebe89a389b90.png)