GeneXus for SAP Systems First Build and Run

Official Content
This documentation is valid for:

Consider the Customer Transaction object defined in GeneXus for SAP Systems First Objects:


Now, you need to test that Customer Transaction object generating a prototyping.

To do so, GeneXus will build the application, create the Database, and do all the necessary things to get the programs ready to be run and tested. This test cycle that you undertake before the application is ready is called prototyping.

GeneXus allows prototyping an application locally (that is to say, the programs and the Database will be hosted on our network servers) and in a cloud that is available to GeneXus users. Also, you can prototype in any of the programming languages supported.

To set the necessary information to connect with the Database and the web server, you must select the Preferences tab or press F5. This function key is used very frequently because it generates all the objects required, as well as compiles and runs the Main Object

In this case, press the Rebuild All option in the Build Menu. Because it is the first time that is pressed, this window asking for the server and Database details is displayed:


Note: In this guide, the new environment was created, setting Microsoft SQLServer as the Database to prototype the application. A way of building applications that use SAP HANA Database is through the Cloud platform available from SAP, called SAP Business Technology Platform. To know all the details about how to create the DB in SAP BPT and how to obtain the connection data to be used in GeneXus see: How to use SAP HANA Database on SAP Business Technology Platform.

Press Finish after setting the connection information.

The Output window informs you that the Launchpad execution has started and will end with a report called Impact Analysis.

If you examine the report, you can see that a new table called Customer will be created:


Also, that this table structure will have the following attributes: 


As you can see, GeneXus will also create an index by CustomerId automatically.


If you agree to have this table with this definition created in the Database, click on the Create button.

So, GeneXus starts to create the necessary programs to create the Customer table in the Database, with this structure. 

Next, GeneXus executes those programs.


And the Customer table is created in the Database. Next, GeneXus generates other programs (that is to say, all the necessary lines of code in the selected programming language, so that the application does what is meant to do, which in this case is to enter customer details). Also, You are informed if the result was successful, or if there were any errors or warnings.

GeneXus open your default browser and here you can see the application running: 

Launchpad Fiori Horizon v18u4

It is the Fiori Horizon Launchpad, containing all the objects' Fiori List Reports. As a Fiori pattern has not yet been applied, the Fiori Horizon Launch is empty and is not useful at this time.

To run the Transaction, go to the option View > Other Tools Window > Launchpad and click on the Customer name:


A page opens in the browser that allows you to add, modify and delete customers. 

Fiori Horizon SAP Pattern - V18 - Adding Customer.

Enter the first customer's details.

This customer will be identified with number 1:
His name is John.
His last name is Smith.
He lives on Fifth Avenue.
His phone number is 1111
And his email address is

Fiori Horizon SAP - Customer adding John

Click on Confirm and a message informing that the data has been successfully added is displayed. Meanwhile, the form is cleared and ready for entering another customer:

Fiori Horizon for SAP - Customer data included successfully

Now, add the second customer, identified with number 2:

Her name is Susan.
Her last name is Brown.
Her address is Seventh Avenue.
Her phone number is 2222
And her email address is

Click on Confirm. Once again, a message informing that the data has been successfully added is displayed.

To look for John’s details, enter his customer number (one) and press the Tab key. 

John's full details are displayed and some information can be changed from here, such as his phone number.

Also, you could even delete customer John from the customer records using the Delete button.

You can also use the upper section buttons to browse customers by going to the next or the previous one, the first or the last one.

You can also look for a specific customer using the Select button.

 This dialog was automatically created by GeneXus, and it corresponds to this object:


Note that if the screen size is changed, the controls are adjusted to the available space. 

Fiori Horizon - First objects and run - responsive application

This means that GeneXus generates responsive web applications, or sensitive applications, which offer optimum viewing, good navigation, and excellent use of screen space.

This is achieved with design features that allow viewing all the information on the screen, using the functions provided by GeneXus to this end. They show different layouts depending on the screen size of the device.

Now that you’ve seen everything that was automatically generated by GeneXus using the Customer Transaction that you've created, go back to the development environment.

Error in the first table creation when you use SAP HANA Database

If you are using SAP HANA Database to generate your application, the first time that you try to create the database this error may appear in the output window


You're informed that the driver to connect to the database hasn't been found within the folder containing all the necessary files to run this application:


To solve them you must follow the steps below: 

1. Download the required files from SAP's website
2. Copy the downloaded files to the folder where everything related to HANA is stored.
2. Go to Tools > Explore Target Environment Directory to open Windows Explorer.
3. Copy the ngdbc.jar file to the lib folder. 


4. Rebuild All again.