Login

To login navigate to the OneBlink Console


If you’re not yet registered, you can ask a colleague to add you in, or contact us and we’ll be happy to help. Once you login, you’ll be taken to the organisation dashboard. 


Home

This is the dashboard for your organisation. The display shows a list of your Forms, Information Pages, Apps, and some basic Analytics. From here clicking on any of the items in the lists will take you to that item.

These options are also available from the side menu, on the left hand side of your screen.


Create

My App 

Here you are able to see the application Icon, name, link to open the web app, and a manage section. 

From the app manage menu, you have access to the app details, content page, app customisation, app user pool and app level submission history.


For more on My Apps check out this article


Forms 


The form list page will show you all of the forms you currently have saved in your organisation, as well as offering you the ability to create new forms.

The form list includes a search bar which allows you to quickly filter your forms. It also includes the form description and some useful icons. These icons can be either red or grey. If the icon is red it then this means the feature is enabled.


The lock is used to represent whether or not the form requires authentication.


The arrow is used to represent whether or not the form has any submission events.


The form menu:


Copy: Create a copy of the form.

Delete: Delete the form.

Download: This will download the JSON definition of the form, which will allow you to share to form between organisations.

View Schema: This option allows you to view the JSON schema of that specific form.

Convert to Info Page: This will convert the form to an information page by removing all of the form element with an input, and placing the form into the Info Pages menu.



Creating & Upload Form


On the Forms list page, you’ll see a plus button at the bottom right of your screen

Hovering over this button will give you the option to add form (create a new form) or upload form (upload a forms JSON definition)


Summary


Form Name: The name of your form, this does not need to be unique however it should be informative and represent what will be contained inside the form.

Description: This will be a brief description of the form and what it contains.

Associated Apps: Select from a drop down the apps you want this form to appear in.

Allow Anonymous Submissions: Switch (On or Off), do you want anyone to be able to access this form, or do users need to login before gaining access to the form.



Where would you like your users to go after submitting this form:


My App: Take the user back to the app after the form has been submitted

Close Page: Sometimes for publicly facing forms you may want the page to close after submitting the form

Redirect URL: This option allows you to place a redirect URL that the user will be taken to after the form has been submitted.

This can be used to take users to a company website or even to another form.


Once you’ve filled out the above information, click the Save button to create your new form.


Builder


To start adding elements to your form, click on the Builder tab.

You can then press the ‘ADD NEW ELEMENT’ button to start adding form element.

Use the preview button to view an interactive rendering of your form as you build it.


For more information on the builder please visit Forms Builder


Submission Events


When a form is submitted, the form data is automatically saved to a OneBlink cloud data store.

In addition to this, you can also add other submission events which are performed after a form is successfully submitted.

To set these, select the Submission Events tab in the forms section of the console.


Draft Submission:


Submission Events can also be setup to run on a save draft. 

To implement this simply select the draft submission switch on the submission event.

This will ensure that this event ONLY occurs on a draft submission.


Submission Event Types:


  • Email + PDF: Enter an email address to have a PDF document emailed, containing all of your form submission data.

  • Spotto: Select this submission event type to automatically link to your Spotto account

  • Webhook: OneBlink will send a request to this URL on successful form submission. This is an advanced feature used for integration purposes.


Submission History


To view the history of forms that your users have previously submitted, select the “Submission History” tab at the top of the screen.

The submission history will display the most recent 50 submission of the form. Continue to scroll down the screen, and further items will be displayed as you scroll.

You can also select a date range to search on specific submissions.

You can click on the submission to view the form data that was submitted for that item.



Advanced 


API Hosting


You can access the API Hosting section by going to the side menu and selecting “API Hosting.”

This will display a list of your API endpoints hosted on the OneBlink platform, with the following options:


Endpoint: The unique URL that represents the API.

Environment Health: The environmental health column will show you the environments for that endpoint that have been deployed (for example, dev, test, and prod). The health is represented by a traffic light system, which measure percentage of errors over 24 hours.


Green: < 5% errors

Yellow: >= 5% errors

Red: >= 20% errors


You can click on the environment to view the logs for the associated endpoint.


You can then click on the API items to view details for that particular API endpoint.


Endpoint Instance Details:


The instance details show detailed settings for the API endpoint, and is designed for advanced users.


Name: This is the name of your endpoint

Date Created: The date the API was first created

Security Groups: The security group assigned to the instance (advanced feature)

Subnets: the subnets assigned to the instance
Environments & Routes: Select an environment from this drop down list to view more details about that specific deployment. Note, if the dropdown does not contain any options this is because the API is not deployed to any environments.

Last Deployment: The time and date of the most recent deployment of the API
Route Names: This will list all of the routes available for this particular environment


Web/CDN Hosting


You can access the Web Apps section by going to the side menu and selecting “Web Apps.”

This will display a list of your custom web apps hosted on the OneBlink platform.

Endpoint: This is the unique URL for your web app.


You can then click on the web app items to view details for that particular web app.


Web App Instance Details:

The Web App instance details show detailed settings for the API endpoint, and is designed for advanced users.


Name: This is the name of your endpoint

Date Created: The date the API was first created


Developer Keys 


OneBlink allows developers to create their own keys inside the OneBlink console.

Keys can be created for Forms, Web Apps, API's, and PDF


To create a new key click the plus button. You will then be asked to give the key a name and to select what privileges you would like the key to have.


SDK


The OneBlink SDK is an open source SDK designed to allow developers easy access to features.

Users have access to the OneBlink GitHub SDK and NPM documentation. 




Administration


Team Members 

You are able to invite your colleagues to your organisation, giving them access to the OneBlink console.

To do this, select “Team Members” from the side menu.

On the users page you will see a list of current Team Members in your organisation. 

Users are broken up into two categories, Team Members and app users. Team Members have access to the full console and everything in it. App users only have access to the Apps they are associated with.


For more information on user please visit Users


Analytics

The analytics system allows you to create and to view KPI style dashboards representing the usage of your app.

Form submissions and API requests will all be automatically tracked by OneBlink, and for more advanced users, you are able to add custom tracking code to your app to help you track projects specific information that you want to report on.

To view your dashboards, select “Analytics” from the side menu. You will be taken to the Dashboard list.


Getting Help

If you need help, we’re just a click away.


At the top right of any screen within the console you will see a question mark. Select this, and it will take you to this support help desk where you can create a ticket and we’ll be more than happy to help guide you.


What’s Next


The OneBlink suite of services is a brand new offering from OneBlink. As with all of our products, it is continually developed and new features will be released all the time.

Please keep an eye out for product release information as we announce via email, and again, welcome to the new OneBlink suite of services.