Configuring Dynamic Themes in Civic Platform

A dynamic theme is the result of a query that runs against your agency’s Civic Platform application and applied to objects in the Accela GIS map viewer. As the information in your application changes, the results of these queries change correspondingly so that the maps accurately reflect the information in the application database. When configured with a product integration, user groups can see dynamic themes as part of the Layers widget on the map viewer.

You must create dynamic themes before you can assign them to user groups. When you define a dynamic theme, you can add or remove user parameters which allow users to add filter criteria to the query used in dynamic themes. Accela Silverlight GIS map viewer users can apply predefined user parameters to dynamic themes.
Note: The Accela GIS (JavaScript version) 8.0.2 does not yet support user parameters in dynamic themes.

A user parameter is based on a predefined or "reference user parameter". An agency can create reference user parameters as templates for user parameters to be added to dynamic theme queries. Before you can add a user parameter to a dynamic theme, you must first create the reference user parameter.

Topics

Creating a Dynamic Theme

To create a dynamic theme in Civic Platform

  1. Navigate to Civic Platform.

  2. Select Admin Tools > GIS > Dynamic Theme.

    Civic Platform displays the Dynamic Themes - Search page.

  3. Click the Add button.

    Civic Platform displays the Dynamic Themes - Add page.

  4. Complete these fields:


    Theme Name Enter a unique name for the dynamic theme. For example, enter “All Building Activities last 30 Days”.
    Theme Group Select the dynamic theme group to which you want to add the dynamic theme. Click the Select button to select an existing theme group or add a new theme group. Although not required, it is recommended to assign a theme group to help organize multiple dynamic themes as they appear on the list of map layers on the Layers widget.
    Query Enter an SQL query string in a language that is compliant with your agency’s database.

  5. Click the Save button.

    Civic Platform saves the dynamic theme.

Related topics:

Editing a Dynamic Theme

Civic Platform allows you to edit a dynamic theme. Possible values that you can edit include the theme group, the user parameters, the query, and the status of the query.

To edit a dynamic theme

  1. Navigate to Civic Platform.

  2. Select Admin Tools > GIS > Dynamic Theme.

    Civic Platform displays the Dynamic Themes - Search page.

  3. Enter your search criteria in any of the following fields:


    Theme Name Enter the name of the dynamic theme you want to search for.
    Theme Group Name From the drop-down list, choose the group that contains the dynamic theme you are searching for.

  4. Click the Submit button.

    Civic Platform displays a list of all themes that match your search criteria.

  5. Click the red dot that appears next to the name of the dynamic theme you want to edit.

    Civic Platform displays the Dynamic Theme - Edit page.

  6. Modify the fields as needed:


    Theme Group Click the Select button to select an existing theme group or add a new theme group.
    Query Update the SQL query as necessary.
    Status Click Enable or Disable to determine whether the dynamic theme is available for GIS use. When it is disabled, you cannot retrieve it from Civic Platform and apply it to your map service through the GIS Administration site.

  7. Click the User Parameters button to add reference user parameters to the dynamic theme.

    Note: Accela GIS (JavaScript version) 8.0.2 does not yet support user parameters in dynamic themes.

    You can also directly enter an SQL Query string in a language that is compliant with your agency’s database.

  8. Click the Save button.

If there is a need to delete a dynamic theme, instead of deleting a dynamic theme, set its status to Disabled it so it remains in Civic Platform in case you want to use it at a later date.

Related topics:

Creating Reference User Parameters

A reference user parameter acts as a template user parameter that can be used by any dynamic theme. Before you can add user parameters to a dynamic theme, you must first create the reference user parameters.

Topics

Creating a Reference User Parameter

To create a reference user parameter

  1. Navigate to Civic Platform.

  2. Select Admin Tools > GIS > Reference User Parameter.

    Civic Platform displays the Reference User Parameter List page.

  3. Click the New button.

    Civic Platform displays the Reference User Parameter - Add form.

  4. Complete these fields:


    Parameter Name Enter the parameter’s name.
    Table Enter the name of the table you want an SQL query to run against.
    Field Enter the field name in the table you want an SQL query to run against.

  5. Click Submit.

    Civic Platform adds the parameter to the list of existing parameters.

  6. Add, edit, or remove parameter values as needed.

    For more information, see Assigning Values to a User Parameter.

Assigning Values to a User Parameter

Assign possible filter values to each reference user parameter. For example, a Parcel Status parameter can have the values Pending, Disabled, and Enabled. When you add the Parcel Status parameter to a dynamic theme, GIS users can then select from these values to filter the dynamic theme results by parcel status.

To assign values to a user parameter

  1. Navigate to Civic Platform.

  2. Select Admin Tools > GIS > Reference User Parameter.

    Civic Platform displays the Reference User Parameter List page.

  3. Select a user parameter (you can search the user parameters).

  4. Click the Values tab:

  5. Click the New button.

  6. On the Reference User Parameter Value - Add portlet, enter the value you want to query against in the Parameter Value field.

  7. Click Submit.

  8. On the Display Order column, enter the order in which you want the parameter to display.

  9. Click Save.

  10. If you want to delete any existing values, mark the check box next to each desired value and click the Delete button.

Adding or Removing User Parameters for a Dynamic Theme

You can add pre-defined reference user parameters to the dynamic theme or remove parameters from it. These user parameters appear as options in the Accela GIS map viewer that allows users to use them as filter criteria for the dynamic theme results.

Note: Accela GIS (JavaScript version) 8.0.2 does not yet support user parameters in dynamic themes.

To add or remove user parameters for a dynamic theme

  1. Navigate to Civic Platform.

  2. Select Admin Tools > GIS > Dynamic Theme.

    Civic Platform displays the Dynamic Themes - Search page.

  3. On the Dynamic Themes - Search page, search for and select the dynamic theme that you want to edit.

    Civic Platform displays the Dynamic Theme - Edit page:

  4. Click the User Parameters button.

    Civic Platform displays the Reference User Parameter - List page.

  5. Click the Look Up button.

    Civic Platform displays all pre-defined user parameters that you have not added yet in the Dynamic Theme User Parameters - Add portlet.


    Note:

    If there is no user parameter, you can create desired reference user parameters through the Reference User Parameter feature. See Creating Reference User Parameters for more information.


  6. If the parameter list is long, search for the user parameter that you want to add to the dynamic theme.

    1. Click the Search button.

      Civic Platform displays the Reference User Parameters - Look Up portlet.

    2. Complete any of the following fields:


      Parameter Name Enter the parameter name.
      Table Enter the name of the database table that the parameter runs against.
      Field Enter the field of the database table that the parameter runs against.

    3. Click Submit.

      Civic Platform displays the parameters that match your search criteria.

  7. Mark the check box next to each parameter that you want to add.

  8. Click Submit.

    Civic Platform adds the parameter and refreshes the Dynamic Theme User Parameters list to reflect the addition.

  9. If you want to remove any user parameter from the dynamic theme, mark the check box next to each desired parameter and click the Delete button.

    Civic Platform removes the parameter and refreshes the Dynamic Theme User Parameters list to reflect the removal.