Topics and lessons

Creating an Excel import

When you have created your data items and have added properties to them,  you can import data using the Excel import functionality.

In this lesson:

  1. Allow users to import data item
  2. Create user flow
  3. Set up Excel
  4. Import data
  5. Additional info

1. Allow users to import data item

First make sure that the data item allows users to import data.

  1. Go to Design and then Data.
  2. Click on the data item for which you want to enable user import.
  3. Click on the pencil in the upper righthand corner:
data-item-user-import
  1. Check the box that allows users to import:
edit-data-item-user-import
  1. Click edit to save or cancel if there was nothing to change.

2. Create user flow

Create a user flow so users can import data.

  1. Go to Design and then User flows.
  2. Use the user flow wizard to create an Excel import user flow (also see Using the user flow wizard).
  3. Choose import and delete or only import:
user-flow-import-functionality
  1. Choose whether you want to allow duplicate items or not:
user-flow-duplicate-functionality
  1. Add your user flow to the menu (also see Adding user flows to the menu).
  2. Publish the design.

3. Set up Excel

When setting up the Excel sheet, make sure that the name of the sheet in the Excel file matches the name of the data item in Triggre. To be clear: the name of the Excel file is not important, the name of the sheet is what matters.

  1. Name the tabs in your Excel sheet after the data items in your design:
excel-sheet-product
data-item-user-import
  1. Put the property names in the first row of the sheet:
excel-sheet-property-names
  1. If you’re going to import using ‘do not allow duplicates’, you must tell Triggre which property identifies the item, so it knows which property it has to check.

    Add “[ID]” to that property name in the sheet (Product code[ID]). You can only define one column as an identifier:
excel-sheet-property-names-id
  1. If you’re going to import using ‘Allow duplicates’, there should be no [ID]-property in the sheet.
  2. You can import more than one data item using only one Excel file. Every sheet in the file refers to a data item:
excel-sheet-multiple-items

Tip: You cannot combine the import of the type ‘Allow duplicates’ and ‘Do not allow duplicates’ in one Excel file.

4. Import data

With the Excel sheet properly set up, you can start the import.

  1. Go to your application and select the Excel import user flow in the menu.
  2. Select the Excel file from your computer or cloud storage.
  3. Check the delete checkbox if you want to delete data. To add data leave the field unchecked.
  4. Press done.
  5. Triggre will upload the file and check the content. If everything is ok, it will process the data. If it finds one or more errors, it will tell you about it and it will not process any data.

5. Additional info

When deleting data using the Excel import:

  1. If one or more rows in the sheet have no match in the application, Triggre gives you an error message and it terminates the flow.
  2. If the sheet has no [ID]-property, Triggre gives you an error message and it terminates the flow.
  3. If no errors are found, Triggre will delete the matching items.
  4. Triggre will not update or create items.

When adding data using the Excel import, without allowing duplicates:

  1. Triggre will update matching items.
  2. Triggre will create items that don’t exist in the application yet.

When adding data using the Excel import, allowing duplicates:

  1. Triggre will create all items that are in the sheet, even if they already exist in the application.
  2. Triggre will not update or delete.