This article outlines how to add a splash screen or disclaimer to a VertiGIS Studio Web app using VertiGIS Studio Workflow. The objective is to display a customized pop-up when the user loads the app. Some examples of what this pop-up might contain are:

• Disclaimers: Outline terms of use to users before they interact with the app. "Accept" and "Decline" options can be included, with additional logic that handles the user's choice.
• Announcements: Highlight new features, share community updates, or communicate scheduled maintenance times.
• Instructions: Provide guidance and tips on using the app to enhance the user experience.
• Branding: Make a strong first impression by including images, icons, and logos specific to your organization.

NOTE: Do not add workflows with forms or alerts to the Application Initializing or Application Initialized events. This will block the app from loading properly and will cause Designer to become unresponsive. Some alternatives are to use the Map Initialized event in the Map component settings, configure Launch Link Workflows, or set an Optional Persistent Workflow in a Workflow component.

Tutorial: Display Terms of Use with "Accept" and "Decline" Buttons

This tutorial will cover how to display a pop-up outlining terms of use when an app is launched. If the user accepts the terms, they are granted access to the app. If the user declines the terms, a prompt comes up, denying them access.

Other types of splash screens and disclaimers can be created by following the same steps, replacing the elements in the Display Form activity with ones that suit the specific use case, and omitting/replacing the logic that handles the "Accept" and "Decline" options.

Design the disclaimer:

1. Open VertiGIS Studio Workflow Designer and create a new workflow for VertiGIS Studio Web.
2. Drag-and-drop a Display Form activity from the left panel onto the Start box to connect it.
3. Double-click the Display Form activity you just added to edit it.
4. In the right panel, change the Header element's Title value from "Form Title" to "Terms of Use".
5. Drag-and-drop a Text element from the left panel onto the form.
6. Click on the Text element you just added to open its properties.
7. Enter your terms of use under Description.
8. Click on the Button Bar at the bottom of the form to open its properties.
9. Change the Label properties on the buttons to "Accept" and "Decline".

10. Save the workflow.

Configure the Web app:

1. Open your app in VertiGIS Studio Web Designer.
2. In the right panel, click the Add Component button.
3. Click the Layout tab.
4. Drag-and-drop a Dialog component and nest it under your existing Map component.
5. Now, click the Other tab.
6. Drag-and-drop a Workflow component and nest it under the Dialog component you just added.

7. Click on the Workflow component you just added to open its settings.
8. Under Optional Persistent Workflow, click the Select Workflow button.
9. Choose the workflow you just saved in the previous section.
10. Now, go back and click the Dialog component to open its settings.
11. Toggle off the Allow Close option.
12. Now, go back and click the Map component to open its settings.
13. Expand the Events section.
14. Click the Select Command button under Map Initialized.
15. Choose the Show command.
16. In the Component dropdown under the Show command, select the Dialog component you added earlier (you may want to go back rename it if you have more than one "Dialog" component in your app).
17. Save the app.
18. Try reloading your app to check that a pop-up with the terms of use appears.

Set up the logic:

1. Switch back to the workflow you created in Workflow Designer.
2. Use the breadcrumbs in the upper left to go back to the Start section if you are not there already.
3. Drag-and-drop an If activity from the left panel onto the bottom connector of the Display Form activity.
4. Click on the If activity and set its Condition to:

=$form1.result=="submit"

5. Drag-and-drop an Alert activity from the left panel onto the False (red "x") connector of the If activity.
6. Click on the Alert activity and set its Text to "Please accept the terms of use to view the app."
7. Drag a connector from the Alert activity and connect it to the Display Form activity.

8. Save the workflow.
9. Load your Web app and test that the logic functions correctly.

This article was last updated using VertiGIS Studio Web version 5.29.2 and VertiGIS Studio Workflow version 5.39.1. Images and descriptions may not match in other versions.