Skip to main content Skip to complementary content

Using the data load editor

This section describes how to use the data load editor to create or edit a data load script that can be used to load your data model into the app.

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.

A script can be typed manually, or generated automatically. Complex script statements must, at least partially, be entered manually.

Script editor overview

 

A

Toolbar with the most frequently used commands for the data load editor: navigation menu, global menu, Save, u (debug) and Load data °. The toolbar also displays the save and data load status of the app.

Saving the load script

Debug the data load script

Run the script to load data

B Under Data connections you can save shortcuts to the data sources (databases or remote files) you commonly use. This is also where you initiate selection of which data to load.

Connecting to data sources

Select data in the data load editor

C You can write and edit the script code in the text editor. Each script line is numbered and the script is color coded by syntax components. The text editor toolbar contains commands for Search and replace, Help mode, Undo, and Redo. The initial script already contains some pre-defined regional variable settings, for example SET ThousandSep=, that you generally do not need to edit.

Edit the data load script

Script syntax

D

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.

Organizing the script code
E Output displays all messages that are generated during script execution.  

Quick start

If you want to load a file or tables from a database, you need to complete the following steps in Data connections:

  1. Create new connection linking to the data source ( if the data connection does not already exist).
  2. ± Select data from the connection.

When you have completed the select dialog with Insert script, you can select Load data to load the data model into your app.

See: Connecting to data sources

Toolbars

The toolbars allow you to perform global actions on your data load script, such as undo/redo, debug, and search/replace. You can also click Load data ° to reload the data in your app.

Main toolbar

Navigation menu with the following options:

ü App overview

7 Data model viewer

ˆ Open hub

Open hub is not shown if the hub has been disabled by your administrator.

¨

Menu with the following options:

« Add data.

D Help

] About

Save Save changes.

Show or hide app information, where you can choose to edit app information or open app options and style your app.
Information noteOnce the app has been published, you cannot edit app information nor open app options.
u

Debug the script.

See: Debug the data load script

Load data °

Execute the script and reload data. The app is automatically saved before reloading.

See: Run the script to load data

h Toggle Data connections view.

Editor toolbar

See: Edit the data load script

F

Search and replace text in the script.

Comment/uncomment
À Indent
à Outdent
D

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.

Information noteIt is not possible to edit the script in help mode.
B

Undo the latest change in the current section (multiple step undo is possible). This is equivalent to pressing Ctrl+Z.

C Redo the latest Undo in the current section. This is equivalent to pressing Ctrl+Y.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!