August 2023 Release Roundup

Welcome to the second installment of the TableFlow release roundup. August was a busy month for us - let's jump in!

Allowed Domains

The TableFlow importer can be embedded into your application using either our React or JavaScript SDKs. To increase data security in a production environment, it's important to define where this importer can be hosted. With the Allowed Domains feature, you can ensure that an importer only functions on your website to safeguard against unintended data uploads.

Column Descriptions

You can now add column descriptions in your importer to give your users a clear idea of the data types, formats, or any other specific requirements you have before they start the import process. When setting up a new importer template or editing an existing one, you'll now see an optional 'Description' field for each column.

Custom Styles

Whether it’s a small change or a complete overhaul, you can now customize your TableFlow importer to match your application style using Custom Styles. You can  personalize your importer modal's appearance to match your brand or your application's theme.

The React and JavaScript SDKs have a new parameter, customStyles. This can be set to an object of key-value pairs with the CSS property names and values. The full list of available options can be found in the dev docs for either React or JavaScript.

customStyles={{
  "color-primary": "blueviolet",
  "color-border": "midnightblue",
  "color-text": "white",
  "color-background-modal": "black"
}}

‍

Header Row Selection

When importing CSV or Excel files, your users may sometimes have extra data at the top of their file before the actual data you want imported begins. With Header Row Selection, users choose the header row of their CSV or Excel file during the first step of the import process. This ensures more flexibility when dealing with diverse datasets. This feature is especially helpful if your user’s files have varying structures or include meta-information in the initial rows.

If you have standardized files without extra header data or just prefer the previous behavior, you can skip the header row selection step and have the importer always choose the first row as the header by using the skipHeaderRowSelection parameter in our SDKs.

SDK-Defined Templates

Developers can now specify templates directly in the frontend using SDK-Defined Templates. This is useful when users in your platform have different schema requirements. For example, a CRM might allow their users to configure additional required fields for each new customer. When users are importing new customers using TableFlow the required columns would vary based on this platform configuration. With SDK-Defined templates, developers can easily apply these requirements directly within TableFlow.

When embedding the the TableFlow importer, set the new template property to define the columns you want your users importing.

<TableFlowImporter
  template={{
    columns: [
      {
        name: "First Name",
        key: "first_name",
        required: true,
        description: "The first name of the user"
      },
      {
        name: "Last Name"
      },
      {
        name: "Email",
        required: true,
        description: "The email of the user"
      }
    ]
  }}
  ...
/>

What's Next?

We're always looking for ways for TableFlow to make your CSV and Excel imports as seamless as possible. If you have any feedback, suggestions, or if you'd like to contribute to the project, reach out through our GitHub repository.