Setup

Before you can create a view in the Geocortex Inline Designer, you must complete the following steps:

 

After creating a view, to access it in Inline, you must:

Request Subdomain

If you will be using Geocortex Inline with an ArcGIS Enterprise portal, and you do not have an ArcGIS Enterprise subdomain, see Registering a Subdomain for instructions on requesting and registering a subdomain.

Once the subdomain is registered, you will be able to access the Geocortex Inline Designer from https://yoursubdomain.apps.geocortex.com. The subdomain will use your on-premises ArcGIS Enterprise portal for sign-in.

If you are using ArcGIS Online, this step is not required.

Create Web Map

When you add a chart to an Inline view, you must specify the data source on which the chart will be based—that is, the URL of the web map layer containing the relevant data.

Ensure you have created one or more maps in your preferred GIS application.

Configure Web Map Viewer

Geocortex Inline views can be run from any of the supported types of web map viewers.

After creating your view, follow the steps below to configure your preferred web map viewer application.

If configuring a Geocortex Viewer for HTML5 or Geocortex Web viewer, you will need to know the URL of the view (see Specifying View URLs).

 

Specifying View URLs

When you configure a Geocortex Viewer for HTML5 or Geocortex Web web map viewer, you must specify the URL(s) of the Inline view(s) to be launched in the viewer.

You can copy the view URL or ID directly from the Designer—either from the URL displayed in the browser or in the Info panel's URL text box (shown below).

 

The URL will resemble the following:

https://mydomain.maps.argis.com/home/item.html?id=17731710d1f24a3995756afa2859a9c1

 

There is no limit to the number of URLs you can specify. However, they must all reference the same map.

 

Syntax required for specifying one or more view URLs

Configure a Geocortex Viewer for HTML5 Viewer

To run a view in a Geocortex Viewer for HTML5 viewer, you need to configure a button to launch the Geocortex Inline workflow with the relevant configuration parameters.

 

To configure a Geocortex Viewer for HTML5 viewer:

The following steps explain how to add a button to the I Want To menu.

 

Step 1: Add an I Want To Menu item

  1. Edit the viewer in Geocortex Essentials Manager.

  2. In the side panel, click I Want To Menu.

  3. Add a new item and configure as follows:

    • In the Text box, type the menu item's text.

    • In the Command box, type RunWorkflowByUrlAndInputs.

    • In the Command Parameter box, enter the following, specifying the URL of the Inline workflow and the URL(s) of the Inline view(s) to be displayed:

      Copy 
      {
       "url": "https://latitudegeo.maps.arcgis.com/home/item.html?id=62d19d3f4a194d88ba968d91f69d02f1",
      "inlineItems": [ <"view URL(s)"> ]
      }

       

      For example:

      {
       "url": "https://latitudegeo.maps.arcgis.com/home/item.html?id=62d19d3f4a194d88ba968d91f69d02f1",
       "inlineItems": ["https://mydomain.maps.arcgis.com/home/item.html?id=17731710d1f24a3995756afa2859a9c1","https://mydomain.maps.arcgis.com/home/item.html?id=24457670c2f13b4578946ac51234f6b2" ]
      }

      For details on finding and specifying view URLs, see Specifying View URLs.

  4. Click OK.

  5. Click Apply Changes.

  6. Click Save Site.

Step 2: Enable Geocortex Workflow 5

  1. In the Essentials Manager side panel, click Workflow 5.
  2. If it is not already selected, select the Enabled checkbox, click Apply Changes, and click Save Site.

Viewers created in Geocortex Viewer for HTML5 2.9 or later have Workflow 5 enabled by default.

Configure a Geocortex Web Viewer

To configure a Geocortex Web viewer to run an Inline view, complete the following steps in the Geocortex Web Designer.

  1. Create a new app and select the Geocortex Inline template.
  2. Add the view URL(s) to the web app's JSON configuration file.

To configure a Geocortex Web viewer:

Step 1: Create new app

  1. In the Geocortex Web Designer, create a new app and select the Geocortex Inline template.
  2. Save the app.

Step 2: Add the view to the layout

  1. In the Components tab, select Geocortex Inline.

  2. Under Inline Views, select + Add Inline Views.

    The Inline Views section contains sample views, to delete the sample views, click Edit Items and then click the Delete icon.

  3. In the dialog that appears, select the views that you wish to add and then click Select.

    Your view is added to the layout.

Configure a Web AppBuilder (Developer Edition) Viewer

To run Geocortex Inline views in Web AppBuilder (Developer Edition) apps, you must:

  1. Deploy the Inline widget to Web AppBuilder for ArcGIS.

  2. Create a new 2D app, add the Inline widget to the app, and then configure the widget to run the view.

To configure a Web AppBuilder (Developer Edition) viewer:

This deployment procedure assumes that you have already installed Web AppBuilder (Developer Edition). You can download Web AppBuilder (Developer Edition) here for free. Follow the instructions to install it.

Step 1: Deploy the Inline widget to Web AppBuilder for ArcGIS (Developer Edition)

  1. Download the widget.

  2. Locate the root of your Web AppBuilder (Developer Edition) installation.

    By default, the root is called WebAppBuilderForArcGIS.

  3. Extract the files to the root. This places the widgets in the correct locations within your Web AppBuilder (Developer Edition) installation.

    • The Inline widget is a 2D widget.

    • 2D widgets are stored in the Web AppBuilder's \[root]\client\stemapp\widgets folder.

Step 2: Create 2D app, add the Inline widget, configure the widget

  1. In Web AppBuilder:

    • Create a new 2D app.

    • Use the Dashboard Theme.

      Inline supports Web AppBuilder's Dashboard theme only.

  2. Add the Geocortex Workflow widget that will run Inline:

    • Open the Widget panel.

    • Search for and select the Inline widget and click OK.

  3. On the Configure Inline screen, configure the Inline widget:

    • Click Add View.

    • Locate and select the views you want to add to the widget. You can add views from different data sources.

    • Click OK.

      Inline appears in your app.

  4. Save the app.

You can now run the Inline view in the Web AppBuilder for ArcGIS (Developer Edition) app.

Configure a Web AppBuilder in Portal for ArcGIS Viewer

To run Geocortex Inline views in Web AppBuilder in Portal for ArcGIS apps, you must:

  1. Deploy the Inline widget to Web AppBuilder in Portal for ArcGIS. This step is only required for on-premise Portal for ArcGIS installations.

  2. Register the Inline widget with Web AppBuilder in Portal for ArcGIS. To register a widget, you create an application item that points to the widget's manifest.json file.

  3. Create a new 2D app, add the Inline widget to the app, and then configure the widget to run the view.

After you have registered the widget, share it with other Inline users in your organization. This allows them to configure their Web AppBuilder apps to run views. If the widgets are not shared, the other users will not see the widgets in Web AppBuilder.

To configure a Web AppBuilder (Developer Edition) viewer:

Step 1: Deploy the Inline widget to Web AppBuilder in Portal for ArcGIS:

  1. Download the widget.

  2. Extract the widget folder and save it to an appropriate location. It does not matter where you save the folder. You will point the Application Extension (AppBuilder) to this location (step 3b, below).

Step 2: Register the Inline widget with Web AppBuilder in Portal for ArcGIS:

  1. Sign in to Portal for ArcGIS as an administrator.

  2. In Content, click Add Item and select An application.

  3. Configure the item:

    1. Set the Type to Application Extension (AppBuilder).

    2. In the Manifest URL box, paste the URL to the manifest.json file for the widget you want to register.

      You can either use the local copy of the manifest.json file, or, if your portal has Internet access, the public copy of the manifest.json file.

      • 2D In-Panel Widget:

        • Local: [https]://[host.domain.com]/[virtual_path]/widgets/Inline/manifest.json

        • Public: https://www.apps.geocortex.com/inline/wab/portal-widget/manifest.json

    3. Click anywhere outside the Manifest URL box.

      Portal for ArcGIS will get the default title from the manifest.json file and enter it into the Title box.

    4. Enter a meaningful title in the Title box, for example: Geocortex InlineWidget In-Panel 2D

      By default, the widgets all use the same title. Portal for ArcGIS does not allow multiple items to have the same title.

    5. Enter one or more tags, for example, Geocortex, Inline, and Widget.

      Example configuration for a Geocortex Inline widget's item in Portal for ArcGIS

    6. Click Add Item.

    Step 3: Create 2D app, add the Inline widget, configure the widget

    1. In Web AppBuilder:

      • Create a new 2D app.

      • Use the Dashboard Theme.

        Inline supports Web AppBuilder's Dashboard theme only.

    2. Add the Geocortex Workflow widget that will run Inline:

      • Open the Widget panel.

      • Search for and select the Inline widget and click OK.

    3. On the Configure Inline screen, configure the Inline widget:

      • Click Add View.

      • Locate and select the views you want to add to the widget. You can add views from different data sources.

      • Click OK.

        Inline appears in your app.

    4. Save the app.

    You can now run the Inline view in the Web AppBuilder in Portal for ArcGIS app.