Using Admin UI
This tutorial shows how to use the Admin UI to configure and use a database for Domino REST API. Download the database
Demo.nsf from Resources and follow along. Anything you can do with the Admin UI you can also do using Postman, curl, SwaggerUI, or similar tools. See how to do each of the tasks in this tutorial using Postman and Curl and using SwaggerUI.
The screenshots may vary. The screenshots are based on latest Domino REST API snapshots. Make sure you're up-to-date.
Prepare database access
Demo.nsf from Resources and save it in the Notes data directory.
Go to the Domino REST API Admin UI.
http://restapi.myhost.com:8880/admin/ui, replacing the host with your Domino REST API's host.
On the login page, enter the administrator username and password, and then click LOG IN.
A successful login would lead to this landing page:
List available schemas
Click Database Management - Rest API in the landing page. This opens the Schema Management page.
Add a schema
In the Schema Management page, click Add Schema.
In the Add New Schema dialog, click Create Schema.
In the Create Schema dialog:
Demo.nsffrom the Database drop-down list.
- Select an Icon.
- Enter a Schema Name and a Schema Description.
- Click Save Schema.
This creates a schema that defines what views, folders, document, and agents you can access through the Domino REST API.
If the Only show schemas configured with scopes toggle is turned on, you can't see the created schema because it doesn't have a scope yet.
Create a scope
To set up a scope:
Go back to the landing page by clicking Overview.
Click Database Management - Activation. This opens the Scope Management page.
Click Add Scope. This opens a pane as shown below:
Under Available Schema, click
Demo.nsf. This shows a list of schemas that uses
Demo.nsfas a database.
Select the schema you created earlier, and then fill out the form in Add New Scope.
Click Add. This creates a scope.
You can use this to access a schema via the Domino REST API. One NSF can be made available under more than one scope, such as with different security settings.
Manage created schema
Go back to the Schema Management page, and click the schema you created earlier. This takes you to the page shown below:
This page allows you to set various configurations to your schema.
Manage database forms
- Click Database Forms from the menu bar. This lists all the forms available for the schema.
Select the form that you want to configure, and then click the corresponding Active option under Status.
Clicking the Inactive option corresponding to a form unconfigures the form. In the Reset Form dialog, click Yes to unconfigure the form.
To make changes to the configured form:
- On the Database Forms tab, click the pencil icon corresponding to the configured form that you want to edit to load the form Access Mode page showing the
Under Show fields from, hover over a field item and click the + icon to add the field in the form. Repeat this for all the fields you want to add.
Set the Read or Write access formula for each of the fields in the form.
- Click Save.
Manage database views
- Click Database Views from the menu bar. This lists all the views for the selected database.
Select the view that you want to activate, and then click the corresponding Active option under Status.
Clicking the Inactive option corresponding to a view deactivates the view. On the Reset Views Columns dialog, click Yes to confirm deactivation of the view.
Manage database agents
Click Database Agents from the menu bar. This lists all the agents for the selected database.
Select the agent you want to activate, and then click the corresponding Active option under Status.
Clicking the Inactive option corresponding to an agent deactivates the agent.
To log out, click the profile icon and then select Sign Out.
Refer to the SwaggerUI tutorial for a UI-driven tutorial for creating a document and more.