Skip to main content

Data load editor

The data load script connects an app to a data source and loads data from the data source into the app. When you have loaded the data it is available to the app for analysis. When you want to create, edit and run a data load script you use the data load editor.

You can edit a script manually, or it can be generated by the data manager. If you need to use complex script statements, you need to edit them manually.

Example of the data load editor

Example of the data load editor.

A: Toolbar

The toolbar contains the navigation menu, the global menu and other useful commands.

Toolbar options
UI item Description

Global menu with navigation options, and actions that you can perform in your app.

For more information about tabbed browsing and the global menu, see Navigating using tabs.

More Show or hide app information, where you can choose to edit app information or open app options and style your app.
Prepare

Prepare your data. You can select Data manager, Data model viewer, or Data load editor.

The options are not available in a published app, unless you are the owner of the app. In that case, you can only open the Data model viewer.

Analyze

Analyze your data. You can select Sheet or Insights.

Narrate

Tell a story with your data. You can select Storytelling.

Debug

Debug the script.

For more information, see Debug the data load script.

Running Load data

Run the script to load data. The app is automatically saved before loading.

For more information, see Run the script to load data.

open right panel Open and close the Data connections panel.

B: Data connections

In Data connections you create and save shortcuts to the data sources (databases or remote files) you commonly use.

For more information, see Connecting to data sources.

C: Script editor

The script editor is where you edit the script code. Each script line is numbered and the script is color coded by syntax components.

The script editor toolbar contains the following commands:

Script editor options
UI item Description
Search

Search and replace text in the script.

Comment / Uncomment Comment/uncomment.
Indent Indent code.
Undent Outdent code.
Help

Activate syntax help mode. In help mode you can click on a syntax keyword (marked in blue) in the editor to access detailed syntax help.

Undo Undo the latest change (multiple step undo is possible).
Redo Redo the latest undo.

For more information, see Edit the data load script.

D: Sections

You can divide your script into sections to make it easier to read and maintain. The sections are executed from top to bottom.

If you have added data using Add data, you will have a data load script section named Auto-generated section that contains the script code required to load the data.

Sections options
UI item Description
Create new

Create a new script section.

Cancel Delete a section.

For more information, see Organizing the script code.

E: Output

Output displays the autosave status and all messages that are generated during data load.