Before you can create a view in the Geocortex Inline Designer, you must complete the following steps:
Request a subdomain (ArcGIS Enterprise portal users only)
After creating a view, to access it in Inline, you must:
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.
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.
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).
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.
You can add this button to the I Want To menu or the viewer toolbar. The configuration of the button is the same in both cases.
As part of this configuration, you must specify the URL of the Inline workflow:
https://apps.geocortex.com/inline/runtime/workflow.json
You can specify either the view's ID or URL. The URL is preferred.
The ID can only be used for items hosted in ArcGIS Online.
You may also have to enable Geocortex Workflow 5 in the viewer, if it is not already enabled.
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: Copy the URL or ID of the view
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
The ID is located in the URL after id=
.
There is no limit to the number of URLs or IDs you can specify. However, they must all reference the same map.
Syntax required for specifying one or more view URLs or IDs
Each URL or ID must be enclosed in double quotes.
Multiple URLs or IDs must be separated by commas.
The entire string must be enclosed in square brackets.
For example:
["https://mydomain.maps.arcgis.com/home/item.html?id=17731710d1f24a3995756afa2859a9c1", "https://mydomain.maps.arcgis.com/home/item.html?id=24457670c2f13b4578946ac51234f6b2" ]
Step 2: Add an I Want To Menu item
Edit the viewer in Geocortex Essentials Manager.
In the side panel, click I Want To Menu.
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:
{
"url": "https://apps.geocortex.com/inline/runtime/workflow.json",
"inlineItems": [ <"view URL(s) or ID(s)"> ]
}
For example:
{
"url": "https://apps.geocortex.com/inline/runtime/workflow.json",
"inlineItems": ["https://mydomain.maps.arcgis.com/home/item.html?id=17731710d1f24a3995756afa2859a9c1",
"https://mydomain.maps.arcgis.com/home/item.html?id=24457670c2f13b4578946ac51234f6b2" ]
}
Click OK.
Click Apply Changes.
Click Save Site.
Step 3: Enable Geocortex Workflow 5
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.
To configure a Geocortex Web viewer:
Step 1: Create new app
Step 2: Add the view to the layout
In the Components tab, select Geocortex Inline.
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.
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:
Deploy the Inline widget to Web AppBuilder for ArcGIS.
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)
Download the widget.
Locate the root of your Web AppBuilder (Developer Edition) installation.
By default, the root is called WebAppBuilderForArcGIS
.
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
In Web AppBuilder:
Create a new 2D app.
Use the Dashboard Theme.
Add the Geocortex Workflow widget that will run Inline:
Open the Widget panel.
Search for and select the Inline widget and click OK.
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.
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:
Deploy the Inline widget to Web AppBuilder in Portal for ArcGIS. This step is only required for on-premise Portal for ArcGIS installations.
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.
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:
Download the widget.
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:
Sign in to Portal for ArcGIS as an administrator.
In Content, click Add Item and select An application.
Configure the item:
Set the Type to Application Extension (AppBuilder).
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
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.
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.
Enter one or more tags, for example, Geocortex, Inline, and Widget.
Example configuration for a Geocortex Inline widget's item in Portal for ArcGIS
Click Add Item.
You can now run the Inline view in the Web AppBuilder in Portal for ArcGIS app.