Tutorial 2: Data Manipulation

Notes: In this tutorial, Domain indicates the domain that you are working in.

What you will build

In this tutorial, you will learn:

  • How to set expressions related to a domain entity.

Create your app

  1. Log in to the design application Designer with your user name and password.
  2. Click  on top menu to navigate to apps page.
  3. Click New App on right top of the page.
  4. Click Blank New App card listed under New App section.
  5. Fill in the fields inside New App dialog box:
    • Enter Employee Record inside New App Name field.
    • (Optional) Enter a description inside App Description.
  6. Click Start!.

Create your screen

  1. Click   to create a screen.
  2. On New Screen panel write Enter Employee Information in Screen Name field and click Save.

Drop a Domain Entity and Set Expressions

  1. On the left of the page, you can see Screen Design Toolbox. Click on Domain Entities. Drag and drop Employee to Screen Design Canvas at the center of the page.
  2. On the dialog box opened;
  • Set Action to Input.
  • Set Renderer to Field:Value Pair.
  • Check Name, LastName and EmployeeNumber.
  • Click Submit.
  1. Click LastName inside the canvas. Entity Properties panel opens on the right side of the page.
  2. On Entity Properties panel, in Entity Variables list, click on LastName_label.
  3. Under the menu bar on the top, you can see Expression Editor. Set expression
 LastName_label = “Last Name”
  1. Click    on Expression Editor to save the expression.
  2. Click EmployeeNumber inside the canvas. Entity Properties panel opens on the right side of the page.
  3. On Entity Properties panel, in Entity Variables list, click on EmployeeNumber_label.
  4. Under the menu bar on the top, you can see Expression Editor. Set expression
EmployeeNumber_label = “Employee Number”
  1. Click  on Expression Editor to save the expression.

Add Buttons

  1. Click on Widget Toolbox in Screen Design Toolbox on the left of the page. Drag and drop Button to the canvas.
  2. Click Button inside the canvas.
  3. On Entity Properties Panel, open Button Settings panel by clicking   and rename your Button to Save. Click Save.
  4. From Events sub panel, click Save_Click on Entity Properties Panel.
  5. To enable Save button to save the Employee record in the corresponding database table, check Employee option in Variables To Commit.
  6. Check This Event Closes Screen and This Event Closes App options in Actions.
  7. Click Bind Event.
  8. From Stylings sub panel, select button:Background Color and click Add.
  9. Pick green color from the color picker (or whichever color you would like).
  10. Click on Widget Toolbox in Screen Design Toolbox on the left of the page. Drag and drop Button to the canvas.
  11. Click Button inside the canvas.
  12. On Entity Properties Panel, open Button Settings panel by clicking    and rename your Button to Cancel. Click Save.
  1. From Events sub panel, click Cancel_Click on Entity Properties Panel.
  2. Check This Event Closes Screen and This Event Finished Workflow Step options in Actions.
  3. Click Bind Event.
  4. From Stylings sub panel, select button:Background Color and click Add.
  5. Pick red color from the color picker (or whichever color you would like).

Generate your application

  1. Click Menu > Publish on the top-right corner of the page.

Your application is ready to deploy!

Deploy your application

  1. Log in to the Management Console Management.
  2. Switch to your domain Domain via menu at the top right of the page
  3. On Apps, find Employee Record app and click QA Approve.
  4. Click Deploy.
  5. Then click Release (Activate).
  6. On Type Systems, click Refresh Type System Data.
  7. On the first line listed in Type Systems, click on Publish.

Your app is now in use. You can run it from Kuicka environment right away!

Run the application

  1. Log in to Shell.
  2. On top-left corner, click     .
  3. Click Select Domain. Select Domain.
  4. Click Default Menu.
  5. On Apps, click Employee Record.

Your app is running!

  1. Fill in Name, Last Name and Employee Number fields as you like.
  2. To save the new Employee record in database, click Save. Otherwise, click Cancel.

Congratulations! You created an app that uses a domain entity.