Introduction

this Section’s purpose is to take you through the process of building a simple App in Wizzdi Cloud.

the example is available on wizzdi cloud public marketplace

Register

Before Using Wizzdi Cloud You must register.

Login Screen
Login Screen

Email/Password Registration

Register Screen
Register Screen
  1. press the Sign Up highlighted text
  2. input the details above
  3. Press the Sign Up button

Single Sign On Register/Login

press the Google Icon or the GitHub Icon , to SSO with Google/GitHub.

Create App

My Apps Screen
My Apps Screen

press the New App button on the bottom right of the screen.

Create New App Dialog
Create New App Dialog

insert your App’s name.

App Overview

Empty App Overview
Empty App Overview

Domain Model

in this part we will create a simple Person Entity with the fields: id,address,birthDate.

the Domain Model Editor is a powerful tool that allows creating connection between entities ,setting indexes , creating inheritance relshionship and much more.

for a more extensive view of the Domain Model Editor check its documentation.

Empty Domain Model Editor
Empty Domain Model Editor

Create The ‘Person’ Entity

  1. on the right side menu select the New… button and select New Entity
  2. a new rectangle will show on the editor , enter the Entity name – ‘Person’ and press OK

Add The ‘id’ Field

Domain Model Editor After Creating Person Entity
Domain Model Editor After Creating Person Entity
  1. select the ‘Person’ Entity
  2. press the Add Field button
  3. insert name ‘id’
  4. press Enter in the keyboard or the green checkmark

Add The ‘Address’ Field

  1. select the ‘Person’ Entity
  2. press the Add Field button
  3. insert name ‘address’
  4. press Enter in the keyboard or the green checkmark

Add The ‘birthDate’ Field

  1. select the ‘Person’ Entity
  2. press the Add Field button
  3. insert name ‘birthDate’
  4. press Enter in the keyboard or the green checkmark
  5. select the ‘birthDate’ field
  6. on the right side drawer select the type (currently ‘String’)
  7. in the drop down select ‘OffsteDateTime’
Domain Model Editor After Creating Person Entity With fields
Domain Model Editor After Creating Person Entity With fields

Exposed APIs

In this section we can see the automatically CRUD (create, read, update and Delete) APIs.

more options available here such as adding a new custom endpoint , defining if the project is a contract-first of domain-first and much more.

check the Exposed API Documentation for an extensive view of it.

Exposed API Screen
Exposed API Screen

Git

In Wizzdi Cloud Users allways own the code they generate from the platform . to deploy the app we must first commit it to a GIT repository.

Git Screen Before Setup Remotes
Git Screen Before Setup Remotes

Setup Remote

lets setup the remote git repository that the platform should push code to.

you should select one of the two options bellow

Automatic Connection With Github

 

we will do this by connecting with github in one click

  1. press the SETUP REMOTES button
  2. on the right side drawer press the pencil button
  3. press the Connect With GitHub button
  4. in GitHub screen press the Install & Authorize button
  5. press the OK button

Setup Remote (Manual)

lets setup the remote git repository that the platform should push code to.

we will do this by providing the GIT credentials to connect to the target git repository.

  1. press the SETUP REMOTES button
  2. on the right side drawer press the pencil button
  3. press the Manual Connection button
  4. insert the Name  which will be the name of the remote in wizzdi cloud
  5. insert the Username which will be used to connect to the git repository
  6. insert the Password which will be used to connect to the git repository
  7. insert the URL of the git repository
  8. press the OK button

NOTE: some GIT providers such as bitbucket and GitHub do not allow using normal username/password credentials

and App Passwords / developer tokens should be used per the provider documentation.

Commit

now that we have setup the remote git repository for the application , lets commit the code .

wizzdi cloud will generate compile and commit it to the git repository setup above.

Git Screen After Setup Remotes
Git Screen After Setup Remotes
  1. press the Commit button
  2. insert a commit message , for example : “Init”
  3. press the Commit button

you should now see the progress for generate compile and commit.

Successful Commit
Successful Commit

 

Review The Code

now the code should be available , this example code can be found here.

 

Deploy

lets deploy our application into Wizzdi Cloud secure scalable Cloud.

App Overview After Commit
App Overview After Commit

in the overview screen press the install button , press the OK button in the next dialog.

a progress screen for the app deployment will be opened.

when it is successfully done we will see this screen:

Successful Deployment
Successful Deployment

Run

now that the app is deployed we can check the app’s Overview section there we will see the server’s URL as well as the swagger URL which allows us to try APIS

Overview Section When App is Deployed
Overview Section When App is Deployed

we can now press the copy button next to App Url or next to the Swagger Url to get the api root or the swagger UI.

The Swagger Interface
The Swagger Interface
Was This Helpful?
Updated on April 17, 2024

Looking For Somthing Else?

Contact Our support 24/7

Sign Up for Waitlist