II. Working with data and customizing the interface

Load and edit your data and display it in a practical way

Let’s get down to building! 🏗 We'll start with loading the data

Loading the data

Once the data source connection is established, go back to the Builder. First things first, let’s fetch your data from the data source. To load your Airtable data, follow the below steps:

Add a new Action - Load Table.
Select the data source and the table, then click Run Action to launch it.
If the request is successful, the Result section will be highlighted in green. In case of any errors, the section will be highlighted in red, and you will be able to troubleshoot right there.

Displaying the data

Now that the data is loaded, time to display it. Find a Table component and place it onto the canvas. The Table will already have the data inside, as the Action is automatically tied to the Component.

Let’s do some Table grooming to make it look neater. We will start with column reordering and make the following changes:

A Name column looks better on a first position in the list, so select the Name column in the left menu and put it above the Kickoff Date column.
The Due Date column can be hidden from the Table, as later we will add a Component to display the project’s due date separately. To hide any column from the interface, just click on the eye icon near the column title. To unhide the column, click on the eye icon again.

For the Category column, let’s change the field type to a Tag so that different categories are labeled differently in the Table. To do that, click on the Category column in the list and change its field type to Select/Tag

The data inside the Project Lead and Project Team columns is returned as an object, and we would like to see the names of corresponding project leads and project team members in the Table. To display these values, we need to do some data mapping that will search for and display Name values. We will do that with some coding.

Add an additional step under the Load Table step - Code. Insert the mapping code into the Setup field. Here's the sample of the code:

return {{ data }}.map(item => {
  return {
    ...item,
    lead: item['Project lead'].name,
    team: item['Project team'].map(user => user.name).join(', ')
  };
})

Please note that we have introduced new variables lead and team vs previous Project Lead and Project Team, which still exist. So, it’s important to change the column settings now to make sure the values are now taken from the Lead and Team variables, and not from the old ones.

To do that, open the Column's General Settings - Field - change it from the Project Team / Project Lead to Team and Lead correspondingly. See the GIF below for more details:

Editing data

In case you quickly need to make some changes to the project record, let’s add an Edit option to the Table. Go to the Appearance&Style menu and check the Edit option. You will notice an Edit label appear on each Table row.

To ensure that the changes made to the records are sent back to the data source and updated, let’s add an Action:

Add a new Action and rename it to updateProject - select the action step Update Row.
Specify how to identify the updated record and how to map the changes:{{ui.designProjectsTable.editedRow.data}}. This variable refers to all the record’s values in the Table.
Next, identify the record that will be updated, e.g. by a record ID by {{ ui.designProjectsTable.editedRow.prevData['Record Id'] }}

Once done, we can bind the Update action to the Trigger that should actually call for this Action. To do that, open the Main settings & structure tab, navigate the Triggers and select the update action in the list for On Edit trigger.

Now you can update the records and send the updated data back to your Airtable.

Filtering the data

Let’s add some filtering options to the Table. We will add an option to sort the data by name and by a kickoff date.

To add a name sorting option, let’s first find an Input component and put it above the Table. Rename the component so that you can identify them later. For our example, we are using the selectName title. Navigate the Appearance&Style tab to add a placeholder for the component - e.g. Project Name.

The next step is to add a trigger that would launch an Action. For that, follow the steps below:

Open the Main settings & Structure tab, scroll down to the Triggers tab and select an action for the On Change condition. As a result of the step, we expect to see the records that correspond to a certain filter, thus we don’t need to actually add a new action, we can add the filtering option on top of the existing loadDesignProjects action.
Select the loadDesignProjects action from the list, then choose this action in the Actions tab and add a filter by Name. It should look like this: Name like{{ ui.selectName.value }}. If you would like to apply strict filtering, select=instead of like operator.

To add sorting by kickoff date, we’ll use another Component - Date Picker. Drag it onto the canvas and change a placeholder on the Appearance&Style tab to "Enter Kickoff Date". In this case, the Datepicker component uses the same sorting logic, as the Select component does, that’s why the steps are the same: