Common Custom data source

How to use

1. Verify that the Web ADF for the .NET Framework is installed and functioning properly. For information on installing and configuring the Web ADF, consult the installation guide.
2. In Windows Explorer, navigate to <ArcGIS install location>\DeveloperKit10.0\Samples\ServerNET. This folder contains the Common_CustomDataSource with CSharp and VBNet folders.
3. Open the folder of the language you're going to use—CSharp or VBNet—and copy the Common_CustomDataSource_<language> folder to c:\inetpub\wwwroot. The <language> variable can be either CSharp or VBNet.
4. In Windows Explorer, navigate to c:\inetput\wwwroot\Common_CustomDataSource_<language>. There are multiple application directories in this folder. All projects are available in the Common_CustomDataSource_<language><vs_version>.sln solution. The <vs_version> references the Visual Studio version of the solution, either 2008 or 2010.
5. Start Microsoft Visual Studio and open the appropriate solution.
6. Build the tiled map data source project by following the steps in the Working with the TiledMapDataSource_<language> class library project section below.
7. Build the REXML map data source project by following the steps in the Working with the REXMLDataSource_<language> class library project section below.
8. Open the Web project to use the custom data sources. See the Working with the CustomDataSourceWebApp_<language> Web project section below for instructions on using the Web project with the custom data sources.
9. Save the project.
10. Click the Debug drop-down menu and click Start Debugging.

1. In the Solution Explorer window, right-click the TiledMapDataSource_<language> folder and select Build. The TiledMapDataSource_<language>.dll is created in the TiledMapDataSource_<language>\bin\Debug or the TiledMapDataSource_<language>\bin\Release folder.
2. Add the assembly to GAC. This can be done at Visual studio 2008 command prompt. command is : gacutil -i <PATH_TO_THE_DLL>
3. In Windows Explorer, navigate to the c:\inetput\wwwroot\Common_CustomDataSource_<language>\TiledMapDataSource_<language>\ADFConfigFile folder, and copy the ESRI.ArcGIS.ADF.Web.DataSources.TiledMap_<language>.config file to the <ArcGIS Install>\DotNet directory. When creating a Web ADF application in Visual Studio, the Web ADF reads this config file to determine the type of resources the data source provides. The resource manager controls that work with this resource type include the custom data source in the list of valid data source options. In this sample, the custom data source is a MapResource, so it will be available in the list of data sources for a MapResourceManager.

1. In the Solution Explorer window, right-click the REXMLDataSource_<language> folder and select Build. The REXMLDataSource_<language>.dll is created in the REXMLDataSource_<language>\bin\Debug or the REXMLDataSource_<language>\bin\Release folder.
2. Add the assembly to GAC. This can be done at Visual studio 2008 command prompt. command is : gacutil -i <PATH_TO_THE_DLL>
3. In Windows Explorer, navigate to the c:\inetput\wwwroot\Common_CustomDataSource_<language>\REXMLDataSource_<language>\ADFConfigFile folder, and copy the ESRI.ArcGIS.ADF.Web.DataSources.REXML_<language>.config file to the <ArcGIS Install>\DotNet directory. This custom data source is a MapResource, so it will be available in the list of data sources for a MapResourceManager.

1. Add the TiledMapDataSource_<language> and REXMLDataSource_<language> projects as references to the Web project.
2. In the Solution Explorer window, expand the CustomDataSourceWebApp_<language> Web project, and open the Default_TileMapData.aspx page in Design view.
3. Activate the MapResourceManager control and open the MapResourceItem collection editor. Three resource items have been added: ADF GraphicsLayer, Other DataSource, and Custom TiledMap DataSource.
4. Open the Custom TiledMap DataSource resource item definition, and confirm that the data source type is set to TiledMap <language> and that the data source definition points to: C:/Inetpub/wwwroot/Common_CustomDataSource_<language>/CustomDataSource_<language>/TiledMapDataSource_<language>/DataSourceDefinitions/WorldCache.xml. The WorldCache.xml file contains layer information for the cache data included with this sample, such as the public virtual directory, spatial reference, full extent, and scale levels.
5. Open the Other DataSource resource definition, set it to a valid map service (ArcGIS Server, ArcIMS and so forth), and change the background color of the resource to be transparent. For additional information, see the MapResourceManager control help.
6. The ADF GraphicsLayer resource is used to draw graphic points—defined in a comma delimited text file—on top of the other map resources. This is not related to the custom tiled data source and merely provides an example of how to upload client data and display it in a Web ADF map.
7. In the Solution Explorer window, under the CustomDataSourceWebApp_<language> Web project, open the Default_REXMLData.aspx page in Design view.
8. Activate the MapResourceManager control and open the MapResourceItem collection editor. Two resource items have been added: REXML Resource and Other Map Resource.
9. Open the REXML Resource item definition, and confirm that the data source type is set to REXML Data <language> and that the data source definition points to C:/Inetpub/wwwroot/Common_CustomDataSource_<language>/CustomDataSource_<language>/REXMLDataSource_<language>/DataSourceDefinitions/rexml_point_wgs84.xml. The rexml_point_wgs84.xml file contains feature geometry and renderer information in XML format. The feature geometry consists of three points in the WGS84 coordinate system. The points are located in the Western U.S.
10. Open the Other Map Resource resource definition and set it to a valid map service (ArcGIS Server, ArcIMS and so forth) that contains map data in WGS84 in the Western U.S. For additional information, see the MapResourceManager control help.

1. Browse to the Tiled Map Web page (for example, http://localhost/Common_CustomDataSource_CSharp/CustomDataSourceWebApp_CSharp/Default_TileMapData.aspx). A map containing cached map tiles is displayed. If another resource has been added on top of the cached resource, set its background to transparent (see the At design time section for instructions).
2. Use the navigation tools to pan and zoom the map.
3. To upload custom data points to the Web application, click the Browse button and navigate to a text file provided in C:\Inetpub\wwwroot\Common_CustomDataSource_<language>\CustomDataSourceWebApp_<language>\userdata\coords_wgs84.txt.
4. Select the file and click OK.
5. Select the color and symbol type to use when rendering the points.
6. Click the Upload button. Four points are rendered on the map near the Western U.S.
7. Browse to the REXML Web page (for example, http://localhost/Common_CustomDataSource_CSharp/CustomDataSourceWebApp_CSharp/Default_REXMLData.aspx). The custom REXML data source is displayed in the map as three points, rendered as green stars in the Western U.S.