With the integration of the Imago Portal and ArcGIS, it is possible to visualize images of:
- Hand samples;
- Chips and more.
on a map.
There are two ways in which images stored on the Imago Portal may be viewed on a map in ArcGIS:
- Hyperlinks in the ArcGIS Pro desktop to Imago images stored in an acQuire database.
- View Imago images in the ArcGIS Online (web) Dashboard.
View Images in ArcGIS Pro
The following step describe how to view Imago images in ArcGIS Pro:
- Create a URL Link to an Imago Image in acQuire GIM Suite.
- Add a Hyperlink to a Field in ArcGIS Pro.
- Add the URL link from step 1 and launch the link in ArcGIS Pro.
View Images in ArcGIS Online
Read the Imago and ArcGIS Integration Quick Overview Ersi's blog post created by MBallard. This article describes how to access Imago images from an ArcGIS Dashboard so that outcrops and collars may be selected on a map to view in Imago.
Imago users with ArcGIS Online subscriptions often wish to have a seamless integration between the two SaaS offerings. This document is a step by step guide for creating a seamless integration between Imago and ArcGIS Online.
- Create an Imago table on ArcGIS Online.
- Configure a python notebook to populate the table with Imago data.
- Joining feature layers with the Imago table on ArcGIS Online.
To complete the steps in this installation guide, you will need the following:
- An active ArcGIS Online Credentials
- Imago User Credentials.
- ArcGIS Pro version 2.0 or higher.
This following are the two files required for completing this installation Guide.
- Imago Integration python Notebook, ipynb
- Imago table project package, Imago.ppkx.
Available here: Imago AGOL 02232021.zip
Imago users with ArcGIS Online subscriptions seeking a seamless integration between the two systems.
Publish Imago Table to ArcGIS Online.
The section covers the steps to publish and configure an Imago feature table on ArcGIS Online.
- Download the Imago project package file (Imago.ppkx) to a folder on your machine.
- Open the package in ArcGIS Pro.
- Open the map view and click share> web Layer > Publish Web Layer as seen in figure 1 below.
Figure 1: Publish Imago Table as Web layer.
- On the share as web layer provide a name for the Web Layer e.g.: Imago Table as seen in figure 2 below.
- Provide summary and tags for the service.
- For layer type, make sure that Feature is selected
- For the Location, pick a folder from the dropdown or create a new folder and name it Imago.
- Set the sharing options in the “Share with” section as needed or leave blank.
- Click the publish button and wait for the share as web layer tool to run successfully.
- Once the Feature Layer is created, open it in a browser and copy the item GUID from the browser locator window as seen in figure 3 before. This GUID will be used in section 3.2 of this document.
- Click on the settings tab.
- Scroll down and make sure that enable editing is checked as seen in figure 4 below.
- Click Save.
Figure 2: Create an Imago folder on ArcGIS Online.
Figure 3: Copy Imago table Id.
Figure 4 : Enable Editing on Imago table.
Publish and Configure Imago Integration Script.
This section covers the steps required for publishing and configuring the Imago notebook on ArcGIS Online. Once published and run. The notebook will truncate the Imago table before connecting to Imago and creating a record per collection under each target dataset listed in the script configuration section.
Publish Imago Notebook to ArcGIS Online.
- Login to ArcGIS Online with an account that has privileges to create content.
- From “My Content” tab of the content page, click “Add Item” and click “From your computer”.
- Click the browse button and choose the notebook file on your computer.
- Type a Title of your choice e.g.: “Imago Integration Notebook.”
- Type tags that describe the notebook e.g.: “Imago” or “Imago Integration”
- Click “Add Item.”
Configure Imago Notebook.
- Open the Imago Notebook on ArcGIS Online
- Browse to the section titled “Provide Imago & ArcGIS Online Credentials” as seen in figure 5 below.
- Modify the IMAGO_USER and IMAGO_PASSWORD variables below to reflect a valid Imago user credentials.
- Modify the ARCGIS_ONLINE_USERNAME and ARCGIS_ONLINE_PASSWORD variables to reflect a valid ArcGIS Online username in your Organization.
Figure 5: Provide Imago and ArcGIS Online Credentials.
- Scroll down to the section titled “Provide the Id of Imago table item on ArcGIS Online” as seen in figure 6 below.
- Copy and paste the Imago table item id that was saved in section above.
Figure 6 : Provide Imago table item id
- Scroll down to the section titled “Configure Imago Target workspaces & datasets” as seen in figure 7 below.
- Modify the name attribute to match the name of your target Image workspace.
- Modify the datasets json array under the target workspace to include a list of target dataset names. Only collections from the listed datasets will have records created in the Imago table under ArcGIS Online once the script is run. Make sure to add a comma after each dataset name.
Figure 7: List Target Imago workspaces and datasets
- Save the notebook by clicking the save button on the top right side of the page.
Run the Imago Notebook
- Open the Imago Notebook on ArcGIS Online.
- Expand the cell menu and pick Run All as seen in figure 8 below.
Figure 8: List Target Imago workspaces and datasets
- Open the Imago table item on ArcGIS Online.
- Click on data tab. Click table and make sure that the table has been populated with the imago collections data as seen in figure 9 below.
Figure 9: Populated Imago table after running the script.
Join Feature Layers with Imago Table on ArcGIS Online.
Create an Imago View.
Figure 8: Click Analysis and Expand “Summarize Data”.
- Open the Feature layer you want to join with Imago table in ArcGIS Online map viewer.
- Click on Analysis and Expand “Summarize Data” as seen in figure 8 above.
- Click Join Features.
- For step 2 labelled “choose layer to join to target layer”, expand the drop down and click on “choose analysis layer”.
- Navigate to the Imago table and click “select resources and view details” then click select on the following screen.
- For step 3 labelled “select the type(s) of join”, click on choose the fields to match as seen in figure 9 below.
- Expand the dropdowns and pick the join field in the source layer that matches the “name” field in Imago table.
- For step 4 labelled “Choose join operation”, make sure that “Join one to one” is selected.
- Make sure to check “Keep all target features” option. This ensures that the output view will include all the features regardless of whether they have matching records in the Imago table.
- For step 5 labelled “Result layer name”, provide a name for the view.
- Expand the dropdown to pick a folder to create the view in.
- Make sure to check the “Create results as hosted feature layer view” option.
- Click Run Analysis.
Figure 9: Join Features.