Import a Domino application

Important

The information in this document is based on HCL Volt MX Go version 2.0.4, HCL Domino REST API version 1.0.14, and HCL Domino version 14.0.

About this task

Guides you through importing a Domino application to Volt MX Go Iris via Design Import using an existing Volt MX Go Foundry app and its identity service.

Before you begin

• You have met all the Design Import process prerequisites.
• You have launched Volt MX Go Iris and have created a new project.

Procedure

1. In the top menu, select Project → Import → Domino Application. The VoltMX Design Import Wizard opens.

2. On Getting Started step, click Next.

   

3. On Associate Foundry App step, click Use Existing. The Volt MX Go Applications dialog opens.

   

4. Click Associate corresponding to the Volt MX Go Foundry app you want to use.

   In the example image, only one application is available. The number of applications you will see in the Volt MX Go Applications dialog will depend on the number of applications in the Volt MX Go Foundry.

   

5. After the name of the selected Volt MX Go Foundry app is displayed, click Next.

   

6. On Identity Service:

   1. Select Use Existing.

      

   2. Under Select Existing Identity Service, select an identity service from the drop-down list and then click Next.

      

   3. In the HCL Domino Login dialog, log in with your Domino credentials.

      

      In case a Permission Requested dialog appears, click Allow.

   4. Choose the identity service related to your app on Volt MX Go Foundry in Foundry App Identity Service and click Next.

      Tip

      You should always select the Identity Service name that contains used for DRAPI.

      

7. On Scope and Forms:

   Note

   • Selectable forms, views, and agents are only those set to the active status when configuring the schema in the Domino REST API. Those in inactive status can still be seen but won't be selectable. Unsupported agents are also shown but won't be selectable.
   • Actions are often active within the Domino database and can only be modified using Domino Designer. Imported actions might not function as expected. If this happens, you modify or update the actions to function as expected. For more information, see Modify or update imported actions using VoltFormula.
   • If a dialog opens indicating that your Domino REST API schema has misconfigured settings, kindly see Troubleshooting for more information on addressing the issue.
   • If you see a warning icon appear beside any form, form field, view, or agent, click the Reports folder icon and click a report to open a detailed report explaining the cause of the warning.
   • You can click the Refresh icon to update the scope in case there are changes in the Domino REST API schema without exiting the wizard.

   1. Select the scope you want to use from the drop-down list.

      The available scopes are based on the scopes defined when creating the identity service.

      

   2. Click the Forms tab and select the forms, fields, and actions you want to include in the import.

      

   3. Click the Views tab and select the views and actions you want to include in the import.

      

   4. Click the Agents tab and select the agents you want to include in the import.

      

   5. Click Next.

8. On Summary, review the selected forms, fields, views, and agents you want to import. Once you confirm your selection, click Build Iris Application.

   

   Note

   • It may take a while to complete the publishing of the imported Domino app.

   • If a dialog indicating that existing Iris forms are detected appears, click Yes to overwrite the detected forms and build the application. The existing Iris forms were automatically generated when you created the new project in Volt MX Go Iris.

     

9. On Result, see the final forms, views, actions,agents, and then click Done.

   Tip

   • A checkmark icon indicates a successful import.
   • A warning icon indicates a successful import, but the imported component might not work as expected due to, for example, its data type not being currently supported.
   • An error icon indicates a failed import.
   • Click the Show only with errors toggle in a specific tab to the on position to see all elements with the error icon in that specific tab.
   • When the scope you selected has active agents, the Agents tab is shown. Otherwise, the AppForms tab is shown.
   • You can click view report to see a results report of imported forms, views, and agents in a new window.

   

Once you click Done, you can see the imported forms and views in a storyboard view in Volt MX Go Iris.

To see the imported forms in a directory, click the DESIGN tab to show the Project tab. You then expand the Responsive Web / Desktop and the Form directory to show the imported forms, views, and actions.