How to extend VertiGIS Studio Web with Workflow: Query a Layer and Display Results using viewer commands

Overview

This example demonstrates how to query a layer and display the results using VertiGIS Studio Web commands within a VertiGIS Studio Workflow, such as results.display, results.display-details, results.display-new-details, or results.display-summary. These commands are executed in the context of VertiGIS Studio Web through the Workflow to present the query results effectively.
 

Key Considerations

• The Results components require VertiGIS Features as input. If your query output is not already in this format, ensure you include a step to transform it using results.from-graphics. Without this, the results cannot be properly displayed.
• The specific behaviour and appearance of these commands depend on the app configuration and display templates.

Example Web app & Workflow

You can explore a working example of this process in this example Web app.

You can then explore access the example workflow directly here from the VertiGIS Studio Workflow SaaS environment: Workflow Example.

Additionally, the workflow is attached for direct use (at page bottom) and reference via the Import function.

Steps

1. Query the Layer:
   • Use a Query Layer activity to query a layer and fetch data as features. These features will serve as the basis for your results display.
2. Prepare Results for Display:
   • To feed the results into one of the results.display-* components, the output from the query must be in a compatible format.
   • Utilize the results.from-graphics activity within your Workflow to convert the query results into VertiGIS features.
   • The resulting features can now serve as input for one of the results.display-* commands.
3. Choose a Display Option:
   • Depending on your use case, you can use any of the following commands to display the results:
     • results.display: Presents features to the user within any components that can display features, such as a feature list, feature table, or feature details component
     • results.display-details: Presents feature details to the user within the feature-details component. 
     • results.display-new-details: Presents new feature details to the user within the feature-details component. 
     • results.display-summary: Presents a feature summary to the user within the feature-summary component. 
4. Display Results:
   • Pass the processed features to the chosen display command, which will render the results as configured in the VertiGIS Studio Web app.
      

Additional Resources

• Activity Reference for VertiGIS Studio Workflow: For details on all available activities in VertiGIS Studio Workflow, refer to the Activity Reference Documentation.
• Commands for VertiGIS Studio Web: For information on all commands that can be used in Workflow, refer to the VertiGIS Studio Web Developer Documentation.