Publish and add the ArcGIS LocateXT Server Tool to Portal for ArcGIS

Summary

The ArcGIS LocateXT Server tool allows scanning unstructured text to create output points linked to coordinates included in the text. With this tool, the functionality of the ArcGIS LocateXT extension in desktop is made available in Portal for ArcGIS.

This article describes how to publish the ArcGIS LocateXT Server Tool to ArcGIS Server, and to add it to Portal for ArcGIS and Portal for ArcGIS Map Viewer.

Procedure

Note:
The ArcGIS LocateXT Server Tool must be downloaded and licensed before performing this workflow.

Publish the ArcGIS LocateXT Server Tool to ArcGIS Server

1. In ArcMap, create the ArcGIS LocateXT Server Tool.
   1. In the Catalog pane, right-click My Toolboxes, and click New > Toolbox.
   2. Set the toolbox name as LocateXT_Tool.
   3. Right-click the new toolbox and click Add > Tool.
   4. In the Add Tool window, select the ArcGIS LocateXT Server Tool that matches the version of the ArcGIS Server. In this example, ArcGIS LocateXT Server Tool for 10.5 is selected.

5. ​​​​​Click OK.

2. Run the ArcGIS LocateXT Server Tool for 10.x.
   1. Double-click ArcGIS LocateXT Server Tool for 10.x to open it.
   2. For Input File, select a sample text file containing coordinate values.
   3. For Output Feature Class, select a location for the output points.
   4. Accept other defaults, and click OK to run the tool.
3. Share the ArcGIS LocateXT Server Tool geoprocessing result. For more information, refer to ArcGIS Server: A quick tour of publishing a geoprocessing service.
   1. Click the Geoprocessing tab and select Results to display the geoprocessing results.
   2. Right-click the ArcGIS LocateXT Server Tool result and click Share As > Geoprocessing Service.

Note:
Beginning from version 10.4, only administrators can publish a geoprocessing service. To allow publishers to publish geoprocessing services, refer to ArcGIS Server: Change geoprocessing service and service extension publishing privileges.

3. In the Share as Service dialog box, select Publish a Service.
4. In the Publish a Service dialog box, select the server connection, and input a valid service name. Click Next.
5. Select an existing folder to publish the service, or create a new folder to store the service. Click Continue.
6. In the Service Editor dialog box, click Geoprocessing in the left-hand pane.
7. Check the Uploads check box under Operations allowed.

8. Click ArcGIS LocateXT Server in the left-hand pane, and fill in the Name and Description parameters. In this example, the tool name is LocateXTServerTool.
9. Click Analyze and Publish to publish the tool to ArcGIS Server.

Add the ArcGIS LocateXT Server Tool to Portal for ArcGIS and Map Viewer

1. Add the ArcGIS LocateXT Server Tool to Portal for ArcGIS.
   1. Sign in to Portal for ArcGIS and navigate to My Content.
   2. In the My Content page, click Add Item > From a URL. The Add an item from the web window opens.
   3. In a new window, navigate to the ArcGIS REST Services Directory. For more information, refer to ArcGIS REST API: Using the Services Directory.
   4. Under Services, select LocateXTServerTool.

Note:
The ArcGIS LocateXT Server Tool name may differ from the example provided in this article, depending on the name set during the publishing process.

5. On the LocateXTServerTool (GPServer) page, copy the URL.

6. In Portal for ArcGIS, in the Add an item from the web window, select ArcGIS Server web service for Type, and paste the copied URL in the URL field.
7. If necessary, provide the required login credentials.
8. Provide a title and tags for the tool.

2. Add the ArcGIS LocateXT Server Tool to Portal for ArcGIS Map Viewer.
   1. In Map Viewer, click Analysis.
   2. In the Perform Analysis pane, click the Browse Raster Function Templates and Custom Web Tools button.
   3. In the Custom Analysis Tools window, search for the ArcGIS LocateXT Server Tool and click Select resources and view details.

4. On the item details page, click Select.
5. In the upper right corner of the Map Viewer Analysis pane, click the back icon . The ArcGIS LocateXT Server Tool is added to the list of analysis tools in the Perform Analysis pane. Expand the tool to view all the parameters required for the tool.