Apps

The Apps menu is used to manage, create and delete apps. Apps allow you to create consolidated views of forms that can be accessed by anyone or a restricted set of users. 

TABLE OF CONTENTS

• Create an App
• Builder
• Layout & content
• Settings
• Users
• Developer Tools
• Summary
• Styling forms without Apps
• Get Help

Create an App

Accounts are created with a single app, this allows you to get up and running quickly, allowing you to start creating forms immediately. 

You can add a new app by clicking the + 'Plus' button on the bottom right of the page. 

App name: The name of your app

App Subdomain: This is a customisable section of the domain that will identify the app. This must be unique and can be changed on the Developer Tools tab under the App URL section. 

App Type: There are two types of apps:

• Forms List: With a side menu and featuring a searchable list of forms this type of app is great for those that have a single list of forms they want to present to the user and expect forms to be accessed on a desktop.
• Tiles: Tiles apps remove the side menu and instead replace them with screen tiles. Tiles apps can also include containers of forms allowing for a next level of navigation and is great for apps expected to be used on mobile and tablets.

Builder

The Builder tab allows you to customise the content, menus and style of your app. 

App Name

The app name can be changed from any of the labs by hovering over and clicking on the app name at the top of the screen. 

Launch

Clicking the launch button will open the app in a new tab.

Layout & content

The layout & content section allows you to customise the content of the app.

Change App Type

This is where you can change between a forms list app and a tiles app form more on this check out the Create an App section above.

Menu Items

• Forms List (Forms List App Only): The forms list is a searchable list of forms, this is the default home page for any forms list apps and is not available in a tiles app. 
• Jobs: Jobs can be added to the app and assigned to a specific user, this requires the use of the OneBlink Jobs API and requires an existing backend system to generate the jobs. 
• Pending Submissions: Any submissions completed while offline will be stored in the pending queue, once the user is back online the submissions will be automatically sent from the pending queue. 
• Drafts: If a user is logged in they will be able to save a form as a draft allowing them to sync it to another device and/or complete the form later.
• Profile: The profile screen allows the user to login or sign up to the app.

Add a menu item

• Custom Link: In addition to the out-of-the-box menu items you can also create a menu item that can be used to link out to any URL.
• Scheduled Tasks: For more information on Scheduled tasks check out the Scheduled Tasks article.
• Container (Tiles App Only): A container can be added to allow for a second level of navigation allowing for categories of forms to be added.
• Form (Tiles App Only): Add a form directly to your app as a tile. 

Banner Image

Allows you to add a custom banner to your app, that is displayed in the app's topbar

Colour Theme

Allows you to customise the colour pallet to match your own business colour scheme

Buttons

Gives you control over the various buttons, and their colour and icons

Settings

Apps have many settings that can be configured to help improve the experience for yourself and your app users.

Standard Settings

Give your app a description to help others understand the purpose of your app.

Progressive Web App Settings

Apps created on the OneBlink LcS are Progressive Web Apps (PWA) meaning they can be downloaded onto the home screen of any device and function the same as any other app. For more information, check out this article.

• App Name — This is the name that will appear below the app icon on the device.
• Splash Screen Name — This is the text that will appear when the app is first loaded on the device.
• App Icon — The icon for the application, must be a PNG and at least 512 × 512 pixels in size

Notifications

If an issue occurs with a submission on this app, the notification email address will be notified of the issue. The email address is prepopulated with the Team Member who created the app, but any email address can be added as a Notification email address. The Notification email address is required and will need to have at least 1 email address to Save the app.

Email Sending

Email Sending addresses allow you to change the sending email address for any out-of-the-box emails that are sent using your app. For example, Email + PDF workflow events can be sent from your email (support@company.com) instead of the default OneBlink email address (forms-noreply@oneblink.io).

When configuring an email address, a verification email will be sent to the configured email address. You will need to access the email inbox, open the verification email and click the link. These links last 24 hours, if the link has expired you can resend the verification email. Once the link has been clicked, thereby verifying the email address, any new emails sent from the app will be sent using your new sending email address. 

Shared drafts

Often, users of an app will need to collaborate on drafts. To allow users to share drafts, turn on the share drafts between users switch. Turning on this configuration will ensure that all drafts saved on the app are shared with all other app users. Forms users will be warned when saving a draft, notifying them that it will be shared with all other app users.

Users

This is where users can be managed for each app. For more on Users, check out this article.

Developer Tools

The developer tools menu is intended to be used by developers to add another level of customisation and configuration to your apps.

Advanced Styling

Advanced Stling is where you can style and customise your apps using custom CSS. For more on styling, check out this article.

Integrate with a SAML SSO Provider

This is where you can set up various SAML integrations that OneBlink offers, you can find more information about these offerings at their respective knowledge base articles. 

• Auth0
• Active Directory

User Session Configuration

Control the length of your user's sessions and tokens.

App URL

Change the app's URL by updating this field, this will change the app's URL in the browser.

Developer Keys

More information about developer keys and how to use them can be found at the following Article

ReCAPTCHA

Enabling this allows you to use your own reCAPTCHA key sourced from your own Google account. More information can be found here.

Google Maps Key

When using the new Google Address element you are required to enable the Google Address key within the app, you can do so by enabling the maps key in this section.

Summary

The summary menu shows key pieces of information about your app.

Delete 

To delete an app, click the 3 vertical dots in the top right of the app card, to bring up the delete option. 

When deleting an app, ensure you remove any allocated forms from the builder page before trying to delete the app. To see if your app contains any forms, click on the manage button and then check the builder tab.

Note: There must be at least 1 app in your account.

Get Help

If you have any questions or would like assistance with setting up your Apps please contact us via this support portal or email support@oneblink.io. We are happy to assist in any way we can.