Table of Contents
< All Topics
Print

Gnosis No-code App

The Gnosis Application Platform takes a Model-Driven Design approach to building Apps. In Gnosis, you model your Application Business Entities and Logic using the Gnosis No-code App, automatically allowing users to navigate and interact with the Application immediately without coding.

Gnosis No-code Views are automatically generated to allow users to create, read, update, search, and promote Items.

The No-code Views dynamically adapt to Application changes and are highly configurable, so as you change the App, the User Interface automatically adapts.

The Gnosis App can be configured with additional Application Logic and Views with Gnosis Low-code Scripting.

The Gnosis No-code App provides the following configurable features:

  • User Login
  • Self-registration User Accounts
  • External Authentication
  • User and Teams-based Access Control
  • Anonymous User
  • Explore and interact with Solutions
  • Create, Read, Update, Delete, and Promote Items
  • Render Custom Views
  • Perform Custom Actions

User Login

/Account

Users can log into the Gnosis Application using their email and password.

Alternatively, users can log in with their external social media accounts if configured.

Users can also register from the Login Page if external authentication and Self-Registration are configured.

Logo & Background

You can replace the default logo and background by uploading images in the Gnosis Files App:

/#dashbaord:files

Replace the logo by uploading an image to the /resources/logo.png file. The image can be in any format (the PNG format is required.)

/resources/logo.png

Replace the background by uploading an image to the /resources/background.png file. The image can be in any format (the PNG format is required.)

/resources/background.png

External Authentication

Configure external authentication to allow users to log in, connect, and self-register using their social media user account.

Enable Providers

Open the Gnosis Configuration App:

/#dashboard:config

Set the /OAuth/EnabledProviders configuration setting as a comma-delimited list of external authentication providers.

/OAuth/EnabledProviders = Google, LinkedIn, Facebook

Enable Google Authentication

Set the /OAuth/Google/ClientId configuration setting to the Google application Client ID.

/OAuth/Google/ClientId = xxxxxxxxx

Set the /OAuth/Google/ClientSecret configuration setting to the Google application Client Secret.

/OAuth/Google/ClientSecret = xxxxxxxxx

Configure Google App

Go to https://console.cloud.google.com/ to create a Google App.

Create a project and set up OAuth 2.0 credentials.

Configure the Authorized redirect URI to /signin-google.

Forgot Password

Click the Forgot Password link to open the Forgot Password page.

/Account/ForgotPassword

Enter your login email and click the Submit button.

You will receive an email with a link to reset your password.

Click the link and enter your new password. Enter the password a second time to confirm the password entered.

The reset password page is only valid for 24 hours. To generate a new reset key, select the Forgot Password link and begin again.

Forgot Password Email Template

The Forgot Password email content can be changed in the /templates/mail/ForgotPassword.gs file.

Open the Gnosis Files App:

/#dashbaord:files

Edit the ForgotPassword.gs Gnosis Script file:

/templates/mail/ForgotPassword.gs

Unlock User

After five failed attempts, the User will be locked out for five minutes. However, the Gnosis Administrator can unlock the User.

Open the Users tab in the Gnosis Identities App:

/#dashboard:identities:users

Click the unlock Action icon for the User who is locked out.

Reset Password

Users with the Administrator Role can reset passwords from the Gnosis Identities Users App.

Click the Reset Password toolbar button (or on the key Action icon.)

This will open the Reset Password dialog.

  • Auto-generate—Select to auto-generate a compliant password.
  • New Password—Unselect the auto-generate and enter a compliant password.
  • Skip email notification—Select to send the Password Reset by Administrator email.
  • Force change on next login—Select to force the User to change the password on the next login.

An email with their new password is sent to the User.

Reset Password Email Template

The Reset Password by Admin email content can be changed in the /templates/mail/PasswordResetAdmin.gs file.

Open the Gnosis Files App:

/#dashbaord:files

Edit the PasswordResetAdmin.gs Gnosis Script file:

/templates/mail/PasswordResetAdmin.gs

User Self-Registration

/Account/Register

To allow users to self-register with the Gnosis Application, set the AllowRegistration configuration setting to true in the Gnosis Configuration client.

Open the Gnosis Configuration App:

/#dashboard:config

Set the AllowRegistration configuration setting to true:

AllowRegistration = true

This allows users to Self-register for a new User Account using their email and password.

  • First Name—The User’s First Name.
  • Last Name—The User’s Last Name.
  • Email—The unique email address used to log in.
  • Password—The initial password to log in.
  • Confirm Password—Enter the password a second time to confirm the password entered.

The new User Account is pending email confirmation.

The User cannot log in until they confirm their email address.

After self-registration, a page for an email confirmation code is shown.

Enter the code sent in the email and click the Confirm button.

Alternatively, click the confirmation link in the email to complete the user registration process.

Confirm Email Template

The content of the Confirm Email can be changed in the /templates/mail/ConfirmEmail.gs file.

Open the Gnosis Files App:

/#dashbaord:files

Edit the ConfirmEmail.gs Gnosis Script file:

/templates/mail/ConfirmEmail.gs

Registration Confirmed URL

Set the RegistrationConfirmedUrl configuration setting to ???

UserCreated Event

It may be helpful when using self-registration to create a Solution EventHandler-type UserCreated View or a Solution UserCreated Workflow to assign the new User to a Team.

The EventHandler-type View, in this case, would call a background Task with the AddTeamMember Command.

CreateTask.Call({
	command = 'AddTeamMember',
	parameters = {
	  Team = @.Team,
	  Member = $Params?.User
  },
	user = $Params?.User == $User
	  ? GetUser('System Support')
	  : missing
})

External Self-Registration

Alternatively, users can register with their external social media accounts if configured.

After self-registering with the external provider, the user information from the external provider is presented.

Make any changes and click the Sign-Up button to complete the new User Account confirmation process.

When users register with their external user account, a notification email is sent to them, similar to when they register with their email address and password.

The email will contain a temporary password for the new user account.

External Registration Notification Template

The email content can be changed in the /templates/mail/ExternalRegistrationNotification.gs file.

Open the Gnosis Files App:

/#dashbaord:files

Edit the ExternalRegistrationNotification.gs Gnosis Script file:

/templates/mail/ExternalRegistrationNotification.gs

Launch Pad

/#
/#dashboard

/#dashboard/LaunchPad

The Gnosis Launch Pad is the default landing page for users when they log in to the Gnosis No-code App.

Gnosis Solutions are arranged as Tiles in a grid layout.

Clicking on a Solution Tile opens the automatically generated Items-type Solution Explore View. This can be replaced with a custom Items-type Solution Home View.

Default Solution

The default landing page for Users and Teams can be configured in Gnosis Identities App:

/#dashboard:admin:users

Set the Default Solution for the User or Team, and the Solution Explore View will replace the Launch Pad and become the landing page.

If the Solution has a Home View, this will become the landing page.

If the Solution has a Start View, this will be used as the landing page. However, the No-code App will not be loaded, and the auto-format Views will not be used.

If there is only one Solution with one Items-type Solution View, regardless of its name, it will become the landing page without the need to set the Default Solution.

Launch a New Solution

The New Solution button is only available to users with either the Administrator or Developer Role.

Click the New Solution button on the Launch Pad to create a new Solution, which opens the New Solution dialog.

  • Name—The Solution name. The name is required and must be an alphanumeric string with no spaces or special symbols allowed.
  • Label—A label for the Solution.
  • Description—A description of the Solution that can contain HTML markup.
  • Utility—Select to hide the Solution from the Launch Pad, which organizes Solution items to be utilized by other Solutions.

Explore Solution

Gnosis automatically creates a No-code auto-format Explore View for each Solution and is the default when opening the Solution from the Gnosis No-code App Launch Pad.

The Explore View lists the Item Types in the Solution as Tiles in a grid layout.

Clicking on an Item Type Title opens the No-code auto-format Items View for the Item Type, which is accessible by URL:

/#/{SolutionName}/Explore/[{ItemType}[.{ViewName}]]

For example, to explore the Demo Solution by URL:

/#/Demo/Explore

To explore the Entity Item Type in the Demo Solution by URL:

/#/Demo/Explore/Entity

To explore a specific Items-type View for the Entity Item Type in the Demo Solution by URL:

/#/Demo/Explore/Entity.Items

Solution Home View

/#/{SolutionName}

You can replace the default Explore View with a Solution Items-type Home View.

The View format can be straight HTML, JSON, Gnosis Script (gs), or the most common gshtml Gnosis Markup Scripts format.

Solution Items-type Views

Solution Items-type Views are shown as buttons in the Gnosis No-code App Header.

They act like tabs, allowing the User to navigate between Solution Views.

Items

Gnosis automatically creates a No-code auto-format Items View for each Item Type and is the default when opening the Item Type from the Explore View.

You can replace the Items View as the default with anything you want.

Create an Items-type View for the Item Type, name it anything you want, and configure the View Order Setting to a lower value than the Items View Order setting value.

You can open an Items-type View directly by URL without the Explore View:

/#/{SolutionName}/{ItemTypeName}.{ItemsViewName}

For example, to open the Entity Items View for the Demo Solution:

/#/Demo/Entity.Items

Items Count

The Items Count toolbar text field is the total Items for the Item Type.

New Item

The New {ItemTypeLabel} toolbar button opens the New Item dialog. The Gnosis No-code App will use the autogenerated New View for the Item Type. The View is highly configurable but can also be entirely replaced. There can be many New Views for different Identities.

Edit Item

The Edit toolbar button opens the Update Item dialog. The Gnosis No-code App will use the autogenerated Update View for the Item Type. The View is highly configurable but can also be entirely replaced. There can be many Update Views for different Identities.

Inline Edit

Click the Inline Edit toolbar button to enable inline row editing.

The Copy column appears with the Cut and Copy action icon buttons.

Select the row, and the inline row editor will appear.

Double-clicking on the row also edits the row rather than opening the Item View.

Click the Update button to save the changes.

Click the Cancel button to close the inline editor.

Delete Item

Select, or multi-select if configured, the Items you want to delete and click the toolbar Delete button permanently.

Actions

Promote the Item to the next possible Lifecycle States from the Action toolbar menu.

Depending on how the No-code Items View is configured, Lifecycle States may appear in the Action menu and/or the Action icons column.

Reports

Import Items

Export Items

Views Menu

Items-type Views for the Item Type are available in the Views toolbar menu.

Select any View from the Views menu as your default View for the Item Type.

You can Save the changes to the Items Grid as a new View.

You can share your saved views as public, allowing other users to see and use them.

Configure Items View in IDE

Configuration Settings

App Web Page Title

Set the PageTitle configuration setting to set the web page title for the Gnosis Instance.

Auto View Generator

Set the AutoViewGenerator configuration setting to set the default Auto View Generator for the Gnosis No-code App to use.

Grid Filters

Set the AlwaysShowFilters configuration setting to true. If true, the filter row in the Item Grids for the Gnosis No-code App is shown by default. Each Item Grid View can be configured individually to show/hide/exclude the filter row.

Multiselect Grid

Set the MultiselectGrid configuration setting to true to configure the Gnosis No-code App Items Grid to allow multi-select rows. This can be configured separately for each Item Type’s Items View.

Paging Grid

Set the PagingGrid configuration setting to true to configure the Gnosis No-code App Items Grid to use paging; otherwise, the grid will load dynamically as you scroll the grid.