GeoprocessingResourceManager control

In this topic

• About the GeoprocessingResourceManager control
• Using the control  
• Members

About the GeoprocessingResourceManager control

Using the control

1. To add controls to the page, open or create a Web site in Visual Studio. Open a Web form in design mode, select the Toolbox panel, and expand the ArcGIS Web Controls tab. Drag and drop a GeoprocessingResourceManager control on the Web form. See the following screen shot that shows the added control in Visual Studio:
   
   

2. To add geoprocessing resources to use in your Web application, activate the control, open or navigate to the Properties window, and click the ellipsis button next to the ResourceItems property. The following GeoprocessingResourceItem Collection Editor dialog box appears. See the following screen shot:
   
   
   
3. On the preceding GeoprocessingResourceItem Collection Editor dialog box, click the Add button to add a data source as a geoprocessing resource to the GeoprocessingResourceManager control. A GeoprocessingResourceItem is added to the collection. The following properties can be modified for a geoprocessing resource item on the GeoprocessingResourceItem Collection Editor dialog box:
1. Name—Used to uniquely identify the resource in the Web application. Set the resource name to a descriptive value in your application.
2. Definition—Provides a set of dialog boxes to connect to a data source provider and configure a resource. Click the ellipsis button next to the Definition property. The following Geoprocessing Resource Definition Editor dialog box appears:
   
   
   
   The following describes the fields on the Geoprocessing Resource Definition Editor dialog box:
• Type—Select the data source type and define the appropriate properties. 
• Data Source—Can be a uniform resource locator (URL) to an ArcGIS Server service catalog or local machine name.  
• Identity—Defines the appropriate runtime credentials to connect to the data source and utilize the resource. 
• Resource—Defines the geoprocessing service to use when working with the resource.  

The format of each property string on the preceding Geoprocessing Resource Definition Editor dialog box is defined by the data source type. The following data source types are available:
• ArcGIS Server Local—Connecting to an ArcGIS Server Local data source requires the machine name (connection host) on which the Server Object Manager is running. When defined, the Resource property provides a list of available geoprocessing services. The Additional GIS Servers button enables configuring a "fail-over" or "round-robin" connection for the resource. For more information, see Using the Connection library. See the following screen shots:
  
  
 

The Identity field on the dialog box is unavailable and cannot be set on the Resource Definition Editor dialog box. At design-time, the identity of the user running Visual Studio is used to connect to an ArcGIS Server local data source. 

At runtime, that identity is established by the Web application. Only one identity can be used to define access to all ArcGIS Server local data sources in a single Web application. This identity can be explicitly defined when building the Web Application Developer Framework (ADF) application in Visual Studio, by right-clicking the Web project in the Solution Explorer and selecting the Add ArcGIS Identity option. Type the identity credentials that will be used to access ArcGIS Server local resources at runtime. This information will be added to the web.config file in a standard ASP.NET identity tag. If the "Encrypt identity in web.config" check box is selected, the identity tag is encrypted; otherwise, the user name and password are stored as clear text. See the following screen shots that show the Add ArcGIS Identity dialog box and the Solution Explorer in Visual Studio:

• ArcGIS Server Internet—ArcGIS Server Web Services require adding the partial URL to the ArcGIS Manager collection of services. This URL includes the Web server host name, ArcGIS instance, and "services" folder name. This general URL provides a list of ArcGIS Server Web Services to choose from.
  
  If authentication is enabled for an ArcGIS Server Web service, provide a user name and password to gain access to the Web service. ArcGIS Server Web services are designed to use basic authentication; therefore, user name and password are Base64 encoded and included in the Hypertext Transfer Protocol (HTTP) request to the Web server. Since this is inherently insecure, confirm that your Web site provides a secure channel for communication—namely, it has enabled Secure Sockets Layer (SSL) encryption accessible via Hypertext Transfer Protocol Secure (HTTPS). This sufficiently encrypts the transmission of identity credentials for basic authentication.    
  
  Once the data source and identity (if necessary) are added, the Resource property provides a list of available geoprocessing services. The identity determines which services are available. If no identity is specified, the remote Web server is responsible for assigning an identity, often an anonymous user account. See the following screen shots:
  
  

4. To utilize the resources in the GeoprocessingResourceManager, add a GeoprocessingTask control. As a Web task, the GeoprocessingTask control only works with one tool in one geoprocessing resource at a time. You can also utilize geoprocessing resources programmatically via geoprocessing functionalities. 

Members

See Also:

• ESRI.ArcGIS.ADF.Web.UI.WebControls.dll