Design Import tutorial
This tutorial guides you in accessing Design Import in Volt MX Go through the use of Volt Iris to view the .nsf
file. This feature in Volt MX Go Iris is a way to extract the domino.nsf
file where you can design the .nsf
structure in Volt MX GO Iris synchronously to the Domino Designer server.
Note
This tutorial is for Mobile app and Responsive Desktop
Before you start
- You have completed the Volt MX Go installation.
- You have created your Foundry admin account.
- You have created Domino REST API.
- Your user account must be added to the LocalKeepAdmins group in the Domino Keep Configuration (KeepConfig.nsf) Access Control List to access administrative APIs used by Design Import.
-
You have a configured
.nsf
file,schema
,scopes
and application in Domino Rest API.-
When you configure the
schema
, open Configured Database Form and set the Formula for Delete Access to@True
in defaultMode
in allForms
.See Changes in Configuration Forms of Domino Rest API. -
When you configure the
schema
, open Database Form (configured) and set indql mode
, you must include all the fields of theForm
. Both thedefault
anddql modes
fields must match for the form and fields to be seen as configured in the design import. -
When you configure the
schema
, open the Database Form (configured) and include the$Files
field to capture the uploading and downloading of files in the Design Import. -
When you configure the
schema
, open Database Views and set the Status to active. -
When you configure the
scopes
, you need a Maximum Access Level set to Designer or Manager. See Scope in Domino Rest API. -
When you configure your Domino REST API application, it's mandatory to add
$SETUP
to return proper values.
-
Launch Volt MX Go Iris
-
Open Volt MX Go Iris. When the Sign-in dialog opens, close it.
Note
If you have already configured the login settings while performing the other tutorials, enter your email and password for Foundry on the Sign in to your account page and click Sign In. You don't need to execute the steps below for configuring the login settings and logging in.
-
Configure the login settings.
-
Go to Preferences.
For Windows, select Edit → Preferences.
For Mac, depending on your macOS, select Volt Iris → Preferences or Settings.
-
On the Volt MX Go Iris Preferences dialog, click Volt MX Go Foundry.
-
On the Volt MX Go Foundry tab, enter your Foundry URL in the Foundry URL text box, and then click Validate.
You should see the “Validation Successful” message at the top of the dialog.
-
Click Done.
-
-
Log in to Volt MX Go Iris.
- Click Login on the upper right corner of the Volt MX Go Iris screen.
- Enter your email and password for Foundry on the Sign in to your account page.
- Click Sign In. Your username appears next to the profile icon.
Create a new project
- On the top menu, select Project → New Project.
-
On the What do you want to start with now? dialog, select Web App or Native App and click Next.
-
On the Which device size do you want to start building for first? dialog, select Desktop for Web App or Mobile for Native App and click Next.
-
Enter your Project Name and click Create.
You can now see your project name in the upper-left corner of the Iris canvass.
Import a Domino Application using the new Foundry app
-
On the top menu, select Project → Import → Domino Application. The VoltMX Design Import Wizard opens.
-
On Getting Started, click Next.
-
On Associate Foundry App, click Create New.
Note
Once you click Create New, the new Foundry app is associated with Volt MX Go Iris. The default name is the same as your Project Name.
-
On Identity Service:
-
Enter the required details in the Create New Identity Service and click Next.
Fields Description Domino REST API URL This refers to the Domino REST API URL you are working with. You must enter your respective Domino REST API URL. Scope This is the name of your configured scope described in your App of Domino REST API app management. $DATA scope show all the scopes in your App in Domino REST API. Client ID This is the App ID of your Application in Domino Rest API app management. Once you configured and added your App, you may see your App ID
and yourApp Secret
.Client Secret This is the App Secret in Domino Rest API app management. Once you configured and added your App, you may see your App ID
and yourApp Secret
.Service Name: Any name that identifies the Volt MX Go Foundry Identity Services. -
Select your service name, that you added from the earlier page and click Next. Once your Foundry Application has been published, your service name should be named as MXGO(service name). Example: MXGOkeepRecipe201
-
Login with your Domino credentials within this wizard modal dialog and click Allow.
Note
This document assumes you are using the Domino IdP which uses your Domino directory credentials. If you aren't, enter the credentials for the IdP you've configured for Domino REST API.
-
Select your Foundry Identity Service name associated to Domino REST API and click Next.
-
-
On Scope and Forms:
-
Select the scope that you’ve configured in Domino Rest API. These scopes are associated with the
.nsf
file from Domino and Notes. -
Select or deselect the configured
forms
,fields
, andviews
and click Next. The lists you see here are the configured and unconfigured forms you set in the Domino Rest API. You can only select the configured forms.
-
-
On Summary, review the final
forms
andviews
fields you want to import, and then click Build Iris Application..Note
It may take a while to complete the publishing of the imported Iris app.
-
On Result, see the final
forms
andviews
, and then click Done.Tip
- The check mark icon beside each of the
forms
,fields
, andviews
means that it was successfully created. - The warning icon beside each of the
forms
,fields
, andviews
means that the supported datatype doesn't match with the Iris app datatype. - Turn on the Show only error toggle to see all the fields with the warning icon.
- The check mark icon beside each of the
Once you click Done, each of the selected forms, views, and agents are imported into Iris through the use of Forms in Volt MX Go Iris. The App Events [desktop] appears.
Note
- You can view the final result of the
.nsf
file that you configured in Domino REST API. - You can click the link click here to view logs on a separate window to see the summarized
forms
,views
, and app forms on one page.
Import a Domino Application from the existing Foundry app
- On the top menu, select Project → Import → Domino Application. The VoltMX Design Import Wizard opens.
-
On Getting Started, click Next.
-
On Associate Foundry App:
-
Click Use Existing.
-
Select the Foundry App generated from the wizard, click Associate and close the form.
-
Click Next.
Info
If you have an existing Domino Application Project on your canvass and you want to import and associate it with another Foundry app, use the Unlink App. This unlinks the Foundry App and returns to selecting Create New or Use Existing
-
-
On Identity Service, click Select Existing on the Identity Service step. This connects the Domino Rest API service.
-
On Scope and Forms:
-
Select the scope that you’ve configured in Domino Rest API. These scopes are associated with the
.nsf
file from Domino and Notes. -
Select or deselect the configured
forms
,fields
, andviews
and click Next. The lists you see here are the configured and unconfigured forms you set in the Domino Rest API. You can only select the configured forms.
-
-
On Summary, review the final
forms
andviews
fields you want to import, and then click Build Iris Application..Note
It may take a while to complete the publishing of the imported Iris app.
-
On Result, see the final
forms
andviews
, and then click Done.
Once you click Done, each of the selected forms, views, and agents have imported into the Iris through the use of Forms in Volt MX Go Iris. The App Events [desktop] appears.
CRUD operation upon importing the .nsf
file
Published the web app and native app in Iris
-
Before you can do the CRUD operation in your imported Domino application, you must first build and publish the web and native app in Iris.
-
If your app is a Web App, see Building a Web App.
-
If your app is a Native App:
- Configure your mobile app browser.
- After configuring your mobile app browser, see Building a Native App to view the mobile app.
-
-
Log in to your account in Domino REST API using the newly published imported Domino application. Your configuration in Domino REST API decides what operations you can include in the design import form. All the
views
andforms
of your.nsf
file have been imported, so you can design your.nsf
file with CRUD operation. -
The Native App (mobile) and the Web App (Responsive Desktop) have the same capability of doing the CRUD operation.
Create entry
-
In the Dashboard, go to the Forms section and click your preferred document. (example: Customer).
-
Fill in the fields.
-
Click Select Files to upload a file. The File Upload appears only if the schema included the
$Files
field in the configuration of Domino REST API.-
Select the file you want to upload. You can select more than one file to upload.
Notes
To see the details of uploading size limit, see HCL Notes and DOMINO file limits
-
Click Open. If the file is pre-existing, a dialog prompt appears with the option to overwrite it.
-
-
Click Add. This adds the data to the
.nsf
file.
Viewing data
-
In the Dashboard, go to the Views section and click your preferred document.(example: Customer).
-
This will open the Customer's document page. Go to your preferred Customer and click View.
-
This will open the Customer's detail. Select the Download All Attachments link. Files will be downloaded.
Note
- You can download the attachments in your document (e.g Customer's detail). You can download the attachment if the
$File
is configured in your DRAPI Database Views. - You can also see here the Delete and Edit button.
- You can download the attachments in your document (e.g Customer's detail). You can download the attachment if the
Update data
-
On the Dashboard, go to the Views section, click your preferred document (example: Customer).
-
In the Dashboard/Customer page, search the customer and click View.
Note
If the detail view DOESN'T show, check the Database Views in DRAPI under schema, to confirm that the Database View is active and the columns in the view are added during the import.
-
Click Edit.
Note
You may also see the delete button here, which allows you to erase or remove the data you've selected.
-
Edit the fields that you want to modify.
-
Click Select Files to add a new file. The uploaded file will show below the Select Files button.
-
Select the file you want to upload. You can select more than one file to upload.
Notes
To see the details of uploading size limit, see HCL Notes and DOMINO file limits
-
Click Open. If the file is pre-existing, a dialog prompt will appear with the option to overwrite it.
-
-
Click Save.
Delete entry
Note
- Before you delete any of the data, you must set Formula for Delete Access to
@True
in Defaultmode
during your schema configuration.
-
On the Dashboard, go to the Views section, click your preferred document (example: Customer).
-
In the Dashboard/Customer page, search customer and click the Delete button.
There is a confirmation message box to confirm the deletion of data, click OK.
Another pop-up message box appears.
Note
Since changes to the form are reflected in the Domino Server, they're also visible in the Notes Client.