Skip to main content

1.2 Create the Tables with Data

We will create the core tables for our application. To create a table in App Engine Studio:

  1. Click the Add icon (⨁ Add) for Data on the App Home tab.
  1. Select Import a spreadsheet tile,
    Click on the Continue button.

  1. Drag and drop the file Telework Data.xlsx (in the telework_lab files folder we downloaded earlier),
    Click on the Continue button.

  1. Our spreadsheet has multiple sheets. We only need the first one "Telework Arrangement".
  1. Check ☑ Import spreadsheet data (in the telework_lab files folder we downloaded earlier),
    Click on Convert to table.

  1. Select Create new table (to hold the Arrangement data),
    Click on the Continue button.

  1. Click the Expand/Collapse icon (⌄) for the "Code" field to see advanced configuration options,
    Check the Display checkbox,
    Click on the Continue button.

info

The Display field is the one that appears if you reference this record from another table. A table can only have a single field marked as the Display field.

For example, in a drop-down or reference we want it to display the code "Remote Telework" and not the full Description.

Fields are also known as table columns.

  1. Set the table name

    Set the table label to Arrangement. (Hit ⇥ Tab) The table name will auto populate.
    Click on the Continue button.

  1. Set the permissions

    For the admin role, click the All checkbox
    For the user role, click the All checkbox and then remove the Delete permission.
    Click on the Continue button.

  1. A loading screen will appear while the table is being created. When it completes, click Done.
  1. We haven't converted all the sheets in the spreadsheets, so we'll see this message pop up.
info

This is intentional to show you that you do not have to import all of the sheets in a workbook.

  1. Click Yes, leave.
  1. Let's add the Telework Case table. Click the Add icon (⨁ Add) for Data on the App Home tab.
  1. Select Import a spreadsheet.
    Click Continue.

  1. On the Choose a spreadsheet to import from screen, click the Drag and drop or browse to upload spreadsheet link.
  1. Browse and select the telework_cases.xlsx file you downloaded.
  1. Select ☑ Import spreadsheet data.
  1. Click on the Continue button.
  1. Select Create from an extensible table, then click Continue.
  1. On the Which table do you want to use? screen,

    Click in the table field,
    Select the Task table,
    Click on the Continue button.

  1. On the let's get more info about your new table screen,


    Set the "Table label" to Telework Case. (Hit ⇥ Tab) The "Table name" will auto populate.
    Check the Auto number,
    Keep the Prefix as TEL
    Click the Continue button.

  1. Set the permissions.

    For the admin role, click the All checkbox
    For the user role, click the All checkbox and then remove the Delete permission.
    Click on the Continue button.

  1. Click Continue.
  1. A loading screen will appear: Sit tight while we create data mapping instance for table Arrangement.
    Click Continue on the next screen.
  1. Read the help pop-up and click Next until Done.

    1. Click Next
    2. Click Next
    3. Click Next
    4. Click Done
  1. Notice the fields have already been auto-mapped, but some are not correct. Clear out the Transfer reason value.
  1. Click on the Add Fields link button at the top.
  1. Hover over the row and edit the Reason field by clicking on the pencil icon.
    1. Click "String" under Field type
    2. Select Choice
    3. Click the Update field button.

      The choices will be added for you based on the spreadsheet data!
  1. Days per week is ok as an integer. Do not do anything to it.
  1. Edit the Arrangment field.
    1. Hover over the row and edit the Arrangement field by clicking on the pencil icon.
    2. Click "String" under Field type
    3. Select "Reference"
    4. Type "Arrangement" into the Reference table field and click on the "Arrangement" table.
    5. Click Update field.
  1. Now that you have configured the new fields click Add fields to add them to our new table.
  1. Clear the Description, Opened, and Transfer reason values, and click Continue in the bottom right corner.

  1. Your table is now ready. Click the Edit table button. Click through all the helper screens.
  1. Click the Next button on the Welcome to Table builder helper and other popups.
info

We can see all the fields that our table inherited from the Task table, making building applications faster.

Exercise Recap Congratulations, you've built the first tables in your solution.

In this exercise, we learned how to create a new application and map out the data elements important to enable our business process.

We learned to use the Table Builder to add and configure columns including Reference fields and Choice lists.

We were able to complete all these tasks using simple point-and-click administration and without requiring specialized application or database knowledge.

Next we'll take a look at the list & form views that have been generated for our table and adjust the layouts.