The FGP Authoring Tool is a Web application that provides you with a friendly environment where you can easily enable a plugin, access the Web map service(s) as input to the plugin, configure the plugin seamlessly, and test and validate the configuration file.
The Authoring Tool’s interface (Figure 4) can be broken up into three areas:
(1) Navigation pane (left side) allows the user to move between the different elements of the web application.
(2) Configuration panel (middle): parameters for configuring web services.
(3) Summary pane (right side): This section allows the user to validate and preview the configured maps. The summary provides a way to indicate where errors occurred in the configuration setup.
Using the Authoring Tool to Configure a Plugin– A Use Case
The workflow starts with Adding A New Layer (or called Testing), followed by Enable A plugin, and completed by Validation and Integration (Figure 5).
Adding a new layer
Step 1. From the Navigation pane, select the Map tab.
Step 2. Select the “Layers” tab from the options and click on the Add button to be able to add layers to the viewer (Figure 6).
Step 3. Select the type of map service that will be loaded. There are several options to choose from. Identify the best option that matches the type of map service that relates to what is published.
Step 4. Provide a name that will be displayed for the layer. If it is not present the viewer will attempt to scrape this information from the map service (Figure 7).
Step 5. Provide the URL of the map service. This is the service endpoint of the layer. It should match the type provided in the layer type.
Extra Steps: Some layer types require extra inputs to be completed before they will load.
Esri Dynamic
Step 5a. Click on the Add button under Layer Entries. This will open another section where the “Index” of the layer can be entered. The "Index” of the layer references the ID of the map service. Take for example this layer (Location of mill facilities), the ID of this layer is 0 which corresponds to the Index (Figure 8).
Step 5b. Optionally, a descriptive name for the layer under the Name field can be entered. However, doing so will override the name coming from the service.
OGC WMS
Step 5a. Click on the Add button under Layer Entries (Figure 9). This will open another section where the “ID” of the later entry in the WMS can be inputted (Figure 10). This is the value between the "< Name >…< /Name >" tag of the layer. Optionally, a descriptive name for the layer under the Name field can be entered. However, doing so will override the name coming from the service.
Step 5b.OGC WMS also includes options to include “Feature info MIME type” and “Legend MIME type” (Figure 9). The “Feature info MIME type” indicates the format that should be requested from the WMS map service. The “Legend MIME type” indicates the format of the Legend that should be requested from the WMS map service.
Step 6. Navigate to the “Validate” and “Preview” button on the Summary pane. Pressing on the Validate button will ensure that all parameters are checked and meet requirements for reviewing.
Tip
As many layers can be added as required.
Note
if any issues are identified, the section with the error will be automatically highlighted in the Summary Pane.
Enable Plugins
Now that the layers are loaded and verified to be working properly.
Navigate to the Plugins tab. This is found at the bottom of the Navigation (left) pane (Figure 11).
The Plugins tab presents all the available plugins for time series data as well as other optional plugins. Each plugin has specific parameters which are required to be configured to successfully work with the data (see next section for the details).
Validation and Integration
Final step: validate and preview to make sure everything works as it should (Figure 12).
After completing the workflow and validation is successful, a .json configuration file can be generated and saved (Figure 13). This configuration file can be later uploaded back to the FGP Authoring tool if changes are required.
Author and Support
The Author and maintainer for FGP plugins and the Authoring tool is Johann Levesque, FGP, NRCan. To report an issue, please create an issue from the GitHub repository. Add the plugin label and any other applicable information. GitHub Repository.