Fast Track to Building Your First Autodesk MapGuide Site

Transcription

1 11/28/ :00 am - 11:30 am Room:Pelican 2 (Swan) Walt Disney World Swan and Dolphin Resort Orlando, Florida Fast Track to Building Your First Autodesk MapGuide Site Andrew Morsell - Spatial Integrators, Inc. GS12-2 This session will show you how easy it is to install and configure Autodesk MapGuide Server, and then build intelligent maps from a variety of data sources. With this class, you should gain a basic understanding of the components and architecture of the Autodesk MapGuide suite, as well as learn how to author some of your own data into MapGuide. About the Speaker: Andrew owns and operates Spatial Integrators, Inc., a private GIS and CAD consulting firm. He has 7+ years of management, programming and customization experience in the Autodesk reseller, training, and developer communities. During the last 6 years, he has been the primary developer and project manager in charge of creating more than 40 custom Autodesk MapGuide sites for various clients. Prior to working in the GIS and CAD consulting fields, Andrew worked in the civil, environmental, and geotechnical industry as a project engineer and was involved in all phases of fielddata collection and design. He earned a bachelor's in Geology and master's in Geologic Engineering and is a registered civil engineer.

2

3 Introduction Welcome to Fast Track to Building Your First Autodesk MapGuide Site! This 90 minute class will show you how easy it is to install and configure MapGuide Server, and then start to build intelligent maps from a variety of datasources. At the end of this class, you should have a basic understanding of the MapGuide suite components and architecture, as well as know how to author some of your own data into MapGuide. The majority of the material in this handout was derived from the Autodesk courseware for the Autodesk MapGuide Fundamentals course. For more in-depth instruction, it is recommended that you attend one of these 3 day courses. MapGuide Components Autodesk MapGuide Author is used to publish intelligent map files, known as Map Window Files (MWF). Autodesk MapGuide Server is used to deliver MWF files to Autodesk MapGuide Viewer and Autodesk MapGuide Author. Viewing software There are three viewing technologies with Autodesk MapGuide: o o o Autodesk MapGuide Viewer resides on the client (browser) desktop and accesses the MWF files. The Viewer can be downloaded for free and must be installed to view the maps. There are three types of the Autodesk MapGuide Viewer: Autodesk MapGuide Viewer Netscape Plug-in Autodesk MapGuide Viewer Microsoft ActiveX Control Autodesk MapGuide Viewer Java Edition Autodesk MapGuide LiteView (sold separately) is a server Provider (a Java servlet) that delivers raster images of the maps directly to the browser without requiring the download and installation of Autodesk MapGuide Viewer. This provider is a server-based software. To run LiteView you must install JRUN by Macromedia on the server. Autodesk OnSite (sold separately; available now for Windows CE) is a server provider (a Java servlet) that serves MWF files to a mobile, handheld, or tabletcomputing device. To run OnSite, you must install the OnSite client software on the handheld and JRUN and OnSite Enterprise on the server. 2

4 Publish MWX (XML) Autodesk MapGuide Architecture Clients Autodesk MapGuide Author Java Viewer ActiveX Viewer Plug-In Viewer Autodesk OnSite Client Any Browser Browser Autodesk MapGuide Symbol Manager Win IE Win Netscape Web Server Autodesk OnSite Servlet PNG Java Servlet Engine MapAgent Publish Autodesk MapGuide Server Autodesk MapGuide LiteView Application Servers Autodesk GIS Design Server DWG SDF Oracle Spatial Custom SHP } Autodesk MapGuide Providers Data Servers Autodesk GIS Design Server Oracle Spatial Data Autodesk ORACLE GIS Design DWG SDF MWF Server Cache SHP CAD/GIS Files DGN, MID/MIF Raster Images Utilities SDF Com Toolkit Dynamic Authoring Toolkit Raster Workshop SDF Loader Conversion 3

5 Autodesk MapGuide Author You use Autodesk MapGuide Author to create and edit Map Window Files (MWF). With it, you can create layer-based, interactive vector and raster maps for client viewing at any Web site using Autodesk MapGuide Server. With Autodesk MapGuide Author, you can create applications in which map data is physically distributed on one or more installations of Autodesk MapGuide Server throughout the Internet, an intranet or an extranet. Autodesk MapGuide Author provides tools for creating and editing MWF files and relies on data from other GIS applications, either in their native file format or converted to SDF format by the SDF Loader utility. To use Autodesk MapGuide Author to create maps, it must have access to an Autodesk MapGuide Server. You must also have been granted authoring privileges on Autodesk MapGuide Server in order to remotely browse data stored on the server. Autodesk MapGuide Server Autodesk MapGuide Server works with Autodesk MapGuide Author, Autodesk MapGuide Viewer, and a Web server to provide dynamic access to vector-based and raster maps from a Web site. Autodesk MapGuide Server operates and communicates with the Web server software via the Autodesk MapGuide Server MapAgent in the following way: Step Description 1 When a Web server receives a request for an MWF, it sends the file to the client browser along with information about the MIME type (for example, application/x-mwf). 2 If Autodesk MapGuide Viewer is present, the MIME type is recognized, and the client s viewer interprets the document. 3 A request for each layer is then made to the Autodesk MapGuide Server MapAgent via a CGI, ISAPI, or NSAPI gateway at the Web server. 4 As Autodesk MapGuide Server fulfills the request, the retrieved data is passed back to the client, via the Web server, using Hypertext Transfer Protocol (HTTP). 4

6 Client Application Server Application MapGuide Viewer Web Server MapGuide Server Data Source mapagent Repeat for each layer{ Ask for MWF Receive MWF Ask for Layer X in Current Window Return Data in Current Window Get Data Return Data Autodesk MapGuide Server request process About Autodesk MapGuide Utilities In addition to the Autodesk MapGuide components, the following utilities are included with Autodesk MapGuide Server and Autodesk MapGuide Author: Autodesk MapGuide Raster Workshop enables you to optimize raster formats and resolutions for faster display across a network. Raster Image Catalog (RIC) files used for placing multiple images on a single Autodesk MapGuide layer are created within Raster Workshop, which also provides the tools to make scanned blueprints, schematics, and other maps partially transparent for useful layering. Autodesk MapGuide SDF Loader enables you to convert many industry-standard spatial data formats into Autodesk MapGuide SDF format. Autodesk MapGuide SDF Component Toolkit is a collection of tools you can use to manipulate, create, and edit SDF data programmatically. Autodesk MapGuide Symbol Manager enables you to create symbol libraries or collections of enhanced windows metafiles (*.emf), windows metafiles (*.wmf), and bitmaps (*.bmp) files that can be used with Autodesk MapGuide Author. Autodesk MapGuide Dynamic Authoring Toolkit enables you to modify Autodesk MapGuide MWF files via the new Map Window XML (MWX) format. MWX is an XML version of the MWF format. You can convert MWF files to MWX, edit the MWX files, and convert them to back to MWF. This feature enables the modification of any map either live on the Web or as a batch process. About Autodesk MapGuide Data Providers Using the Autodesk data providers, Autodesk MapGuide has the ability to serve data from various distributed sources. Autodesk data providers provide the tools to connect directly to vector-based formats natively. Avoiding the process of translating the proprietary data formats can save a lot of 5

7 time used to develop translation routines to ensure that live data is available. Once the map is created and placed on the web, the data driving your maps is transparent. Autodesk MapGuide Server has built-in direct access to SDF and DWG data. The following data providers must be purchased separately: Autodesk MapGuide Provider for Oracle Spatial Autodesk GIS Design Server Extension for Autodesk MapGuide Autodesk MapGuide Provider for SHP These data providers must also be installed on the Autodesk MapGuide Server computer separately. Clients Web Server Application Servers } Autodesk MapGuideCustom Providers SHP Autodesk MapGuide Server Oracle Spatial MapAgent Design GIS Server Autodesk DWG SDF Data Servers Oracle Spatial Autodesk GIS Design Server Data Raster CAD/GIS Files Autodesk Images SHP DGN, MID/MIF ORACLE GIS Design DWG SDF MWF Server Cache Utilities Autodesk MapGuide Server data providers Autodesk MapGuide has always been built on the standard SQL query model, but with the data providers and OLE DB, retrieving spatial data is easier than ever. The SQL query model used with the provider for Oracle Spatial is based on OGC (Open GIS Consortium) specifications. MapGuide Server More in Depth Autodesk MapGuide Server is a scaleable, fault-tolerant, 32-bit, multi-threaded software application that serves authored map data in response to requests from Autodesk MapGuide Viewer or Autodesk MapGuide Author. Autodesk MapGuide Server consists of three components: Autodesk MapGuide Server Agent (MapAgent) 6

8 Autodesk MapGuide Server Service Autodesk MapGuide Server Admin Autodesk MapGuide Server Agent (MapAgent) Autodesk MapGuide Server Agent (MapAgent) receives requests for map data via a Web server, which are then queued as received, and distributed. The MapAgent broker can be accessed via a standard CGI (Common Gateway Interface) interface, or via a highperformance interface such as the Microsoft ISAPI or Netscape NSAPI specification. The MapAgent acts like a broker, an interface between the Web server application and the Autodesk MapGuide Server Service, and is provided in several versions, depending on the Web server platform you are using: Web Server Web Server API MapAgent Type Microsoft Internet Information Server ISAPI MapAgent_ISAPI.ISA Netscape Enterprise Server NSAPI MapAgent_NSAPI.DLL Any other CGI-compliant Web server CGI MapAgent.EXE Autodesk MapGuide Server Service Autodesk MapGuide Server Service receives and processes the requests for map data distributed by the Autodesk MapGuide Server Agent. Since it runs as a Windows 2000 service, Autodesk MapGuide Server can only be installed under the Microsoft Windows 2000 operating system. Autodesk MapGuide Server Agent Admin Autodesk MapGuide Server Admin is an application that gives you complete operational control over Autodesk MapGuide Server, enabling the following user functions: security, log file generation, data source directories and database access, integration with HTML server, and service start/stop. Web Server CGI/NSAPI/ISAPI Interface MapAgent Remote Procedure Call Service MapGuide Server MapGuide Service OLE DB SDP UDL FILES Map Server Administrator RDBMS SDF Files DWG Files Raster Files Map Data Autodesk MapGuide Server Architecture 7

9 About Autodesk MapGuide Author Features and Properties MapGuide Author is the tool used to create the maps that will eventually be viewed by the individual users in the MapGuide Viewer application. This is where all layers are defined including their datasource, colors, etc. The MapGuide MWF file then gets saved to a location on the web server that the users have access to through a standard web browser and the appropriate MapGuide Viewer application. The following is a list of the functionality found within Autodesk MapGuide Author that are not found in Autodesk MapGuide Viewer. You can: Configure an attachment to customize Reports, Zoom Gotos, and popup menus. Create static and dynamic map layers. Create multiple raster images per layer with raster catalog file (RIC). Set map layer visibility by scale. Change multiple attribute sets by scale. User defined symbol support and constant sized symbols for both points and API. Set automatic labeling of features with over-posting reconciliation. Perform remote authoring by opening a map at Configure multi-server/multi-database connectivity. Preview scale and legend symbology. Preview Web pages from the legend. Set security control for MWFs, layers, and coordinate data. Save permanent buffer layers. Use Print Preview. Tag the map with a tracking ID for future monitoring. Autodesk MapGuide Author 8

10 9

11 About our Project Environment Hands-On Exercises The project data management method employed in this class is designed to help you keep your files organized for any Web-based project. The folder structure is designed to enable you to work on several projects simultaneously. You create a main project folder off the root of your hard drive (the courseware assumes this is C:\Projects). Then, each project is contained in a subfolder off the main Projects folder. For the Autodesk MapGuide training data, the project data is stored under \Autodesk U MapGuide Data. Of course, this is only a suggested structure, you will no doubt have your own organization method that works best for you. For this class (and for doing on your own) we have installed the dataset to the C:\Projects\Autodesk U MapGuide Data\ folder. If you are using this data on your own, you will either need to have already installed MapGuide Server and Author, or have obtained an evaluation copy of the software from your Autodesk reseller. Setting up a Virtual Directory in Internet Information Services 1. Open up the Internet Information Services console. On Windows XP, it can be found from Control Panel Administrative Tools Internet Information Services. While at Control Panel, you may have to switch to Classic View on the left side of the window. 2. Expand the tree under Computer_Name (local computer), Web Sites, Default Web Site 3. Highlight Default Web Site in the tree, then select the Action New Virtual Directory menu item. 4. Click Next in the Wizard, then enter AUMapGuide in the Alias field and press Next again. 5. Browse to C:\Projects\Autodesk U MapGuide Data\Web and press the Next button. 6. Make sure the Read, Run scripts and Execute boxes are checked. Press Next and then Finish. 7. Test your new virtual directory by opening Internet Explorer and typing into the address bar. You should see the Welcome page open. Installing MapGuide Server 1. From the MapGuide evaluation CD you received from your Autodesk reseller, run the installation routine. 2. At the installation menu, select Autodesk MapGuide Server. 3. Click the Next button to start the installation Wizard. On the Register screen, check the Evaluation installation radio button and then the Next button. If you receive an error message 10

12 regarding the need for a valid serial number, enter in the serial number field and then press Next again. 4. If you receive a Warning dialog regarding that no web server was detected, click the Next button. 5. On the Select Components dialog, be sure to click on ISAPI MapAgent and select Install. Click the Next button. 6. If you see a dialog title MapAgents Not Supported, click the Next button to continue. We will manually configure our server in the next step. 7. On the Select Installation Directory dialog, accept the default location and click the Next button. 8. On the Configure Autodesk MapGuide Server Settings dialog, enter whatever you would like for company name and address. In the Author area, enter a username and 8 character password for yourself. Write down or remember this information as you will need it to start authoring later. 9. Click the Next button through the next several dialogs until installation starts. 10. At the end of the installation, if prompted, go ahead and restart the computer. Configuring and Testing the MapAgent Since we are using Microsoft Internet Information Services, we will use the MapAgent specifically designed for it, the mapagent_isapi.isa file. Since the installation did not do this automatically, we will do this manually. 1. Open up Internet Information Services again. On Windows XP, it can be found from Control Panel Administrative Tools Internet Information Services. 2. Expand the tree under Computer_Name (local computer), Web Sites, Default Web Site 3. Highlight Default Web Site in the tree, then select the Action New Virtual Directory menu item. 4. Click Next in the Wizard, then enter MapGuide6 in the Alias field and press Next again. 5. Browse to C:\Program Files\Autodesk\MapGuideServer6.5\MapAgents and press the Next button. 6. Make sure the Read, Run scripts and Execute boxes are checked. Press Next and then Finish. 7. To test our MapAgent, open Internet Explorer and enter the following URL into the address bar: You should see the 11

13 following information in the browser: Administering MapGuide Server and Setting up our Datasources General Admin and Raster Image Search Path 1. Open up MapGuide Server Admin by going to the Start menu All Programs Autodesk MapGuide Release 6.5 Autodesk MapGuide Server Admin. 2. Select Properties from the Edit menu or click on the Properties toolbar button. 3. On the General tab, under Raster Image Search Path, add the following directory to the end of the list: C:\Projects\Autodesk U MapGuide Data\raster. Make sure there is a semicolon (;) separating this from the previous directory. 4. Click on the Data Sources tab. We are going to add 4 new data sources. Configuring our SDF Data Source 1. Click on the New button. On the New Data Source dialog, for the Data source name, enter AU_SDF and make sure that the default Data source type of Microsoft Data Link (UDL) for OLE DB is checked. 2. On the Data Link Properties dialog, we will step through the wizard. On the Provider tab, select Autodesk Spatial Data Provider for SDF and click the Next button. 3. On the Connection tab, enter C:\Projects\Autodesk U MapGuide Data\sdf for the search path. 4. We will leave all other settings set to their defaults, so click the OK button to finish. Configuring our Tabular Data Source 1. Click on the New button. On the New Data Source dialog, for the Data source name, enter AU_db and make sure that the default Data source type of Microsoft Data Link (UDL) for OLE DB is checked. 2. On the Data Link Properties dialog, we will step through the wizard. On the Provider tab, select Microsoft Jet 4.0 OLE DB Provider. This provider is for Microsoft Access 2000 and later MDB files. 3. On the Connection tab, browse to or type C:\Projects\Autodesk U MapGuide Data\RDMS\Bainbridge.mdb under item 1: Select or enter database name. 4. Leave all other settings as they are and press the Test Connection button. You should see a dialog open that says Test Connection Succeeded. If you don t, please double-check your path to the database file and try again. 5. Click OK to finish. 12

14 Configuring our DWG Data Source 1. Click on the New button. On the New Data Source dialog, for the Data source name, enter AU_dwg and this time, make sure that the Data source type of Autodesk Data Link (ADL) for DWG is checked. 2. On the Connection tab, browse to or type C:\Projects\Autodesk U MapGuide Data\DWG in the DWG search path. 3. Leave all other settings as they are and Click OK to finish. Configuring our Shape File Data Source 1. Click on the New button. On the New Data Source dialog, for the Data source name, enter AU_shp and make sure that the default Data source type of Microsoft Data Link (UDL) for OLE DB is checked. 2. On the Data Link Properties dialog, we will step through the wizard. On the Provider tab, select Autodesk Spatial Data Provider for SHP. Then click Next. 3. On the Connection tab, browse to or type C:\Projects\Autodesk U MapGuide Data\shapes in the Search Path. 4. Click the Advanced button to view the coordinate system settings for this data source. Under Category, choose USA, Washington from the list. Under SRS, then choose NAD83 Washington State Plane Zone, North Zone, US Foot. 5. Leave all other settings as they are and Click OK to finish. Using MapGuide Author Basic Authoring Techniques Using a Template and Adjusting Map Properties 1. Open up MapGuide Author by going to the Start menu All Programs Autodesk MapGuide Release 6.5 Autodesk MapGuide Author. 2. From the File Open menu, or from the Open toolbar button, browse to C:\Projects\Autodesk U MapGuide Data\Web\Maps and open the map_template.mwf file. When opening, click OK when warned that the file is Read Only. 3. From the File Properties menu or from the Properties button on the toolbar, open the Map Window Properties dialog. 4. On the General tab, enter Autodesk U MapGuide Map under Name and change the Background Color to color Click on the Coordinate System tab, then the Change button. Under Category, choose USA, Washington from the list. Under SRS, then choose NAD83 Washington State Plane Zone, North Zone, US Foot. 6. Click the OK button to close out of the Properties dialog and you will see the US States reprojected to our State Plane coordinate system. 7. Select File Save As. Enter AU_map for the filename and make sure the file is being saved to the C:\Projects\Autodesk U MapGuide Data\Web\Maps directory. Say Yes when asked if you want to save the file without a password. 13

15 Authoring our Water Bodies SDF Layer The area on the left of the window is known as the Design Explorer. We will be working in this area almost exclusively when authoring our new map. We will also be using the right mouse button often in these exercises as most items in the Design Explorer are right-click, context sensitive. 1. In the Design Explorer, right-click on Map Layer, then select New Layer, and then Polygon as shown in the figure. 2. On the General tab, enter Water Bodies for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 10 and leave all other settings as they are. 3. On the Data Sources tab, make sure that the Map server URL: is set to Then, click on the Ellipsis (the button with 3 dots) next to Data source. You will be prompted for your username and password to access MapGuide data via the Map server URL you entered. Enter your username and password that you set up when we configured MapGuide Server Admin. You will then see a list of the datasources we created. Select AU_SDF and press the OK button. 4. Under Feature table, press the ellipsis and select bai_waterbody as the SDF file we will use for this layer and press the OK button. 5. On the Styles tab, click the Change button under Styles. Under the Fill settings, change the foreground color to color number 9, blue and leave Style set to Solid. Uncheck the edge button and then press the OK button. 6. Press the OK button to exit the Layer Properties dialog and to display the new layer on the screen. Setting our Default View Area You probably don t see any data yet, but it s there. We need to zoom into our project area first. 1. Zoom in on the Puget Sound area of Washington State as shown in the figure. You should now see our water bodies layer. 2. Zoom in on Bainbridge Island as shown in the adjacent figure. This is our project area. 3. Right-click on the US States layer and select Remove. We do not need this layer anymore. 4. From the File Properties menu or from the Properties button on the toolbar, open the Map Window Properties dialog. 5. On the General tab, select click on the Take Center and Size from Current Zoom button. This will set the area you are viewing as the default area for the map when users open it. You re map area should look like the below figure at this point. 14

16 6. Save your map. Authoring our Island Shoreline SDF Layer 1. In the Design Explorer, right-click on Map Layer, then select New Layer, Polygon 2. On the General tab, enter Bainbridge Island for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 15 and leave all other settings as they are. 3. On the Data Sources tab, Click on the Ellipsis next to Data Source and select AU_SDF and press the OK button. 4. Under Feature table, press the ellipsis and select bai_shoreline as the SDF file we will use for this layer and press the OK button. 5. On the Styles tab, click the Change button under Styles. Under the Fill settings, change the foreground color to color number 60. Leave all other settings as they are and then press the OK button. 6. Press the OK button to exit the Layer Properties dialog and to display the new layer on the screen. Notice the new layer is drawn on top of the water bodies layer because it s draw priority is 15, whereas water bodies is Save your map. Authoring our Roads SDF Layer 1. In the Design Explorer, right-click on Map Layer, then select New Layer, and then Polyline. 2. On the General tab, enter Roads for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 60 and leave all other settings as they are. 3. On the Data Sources tab, Click on the Ellipsis next to Data Source and select AU_SDF and press the OK button. 4. Under Feature table, press the ellipsis and select bai_roads as the SDF file we will use for this layer and press the OK button. 5. On the Styles tab, click the Change button under Styles. Set the Color to color 5, red, and the thickness to 3 pixels. Click OK. 6. Back on the Styles tab, click the New button under Styles. Leave the settings as is (color 1, white and 1 pixel thick) and click the OK button. 7. Back on the Styles tab, click the Change button under Display ranges. Enter for t he From number and then press OK. This data is pretty generalized and we don t want it displayed when we zoom in on the map at a scale below 1: This is called thresholding. 8. Press the OK button to exit the Layer Properties dialog and to display the new layer on the screen. Notice the new layer is drawn on top of the Shoreline layer because it s draw priority is 60, whereas shoreline is 15. Also note that we created a line style of red with a white stripe by defining the two different line styles of different thicknesses. 9. Save your map. 15

17 Authoring our Parcels Shape File Layer 1. In the Design Explorer, right-click on Map Layer, then select New Layer, and then Polygon. 2. On the General tab, enter Parcels for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 50 and leave all other settings as they are. 3. On the Data Sources tab, Click on the Ellipsis next to Data Source and select AU_SHP and press the OK button. 4. Under Feature table, press the ellipsis and select parcels as the Shape file we will use for this layer. Press the OK button. 5. On the Styles tab, click the Change button under Styles. Set the Color to color 5, red, and the Fill Style to None. Click OK. 6. Back on the Styles tab, click the New button under Styles. Leave the settings as is (color 1, white and 1 pixel thick) and click the OK button. 7. Back on the Styles tab, click the Change button under Display ranges. Enter 3000 for t he To number and then press OK. This data is very detailed and we don t want it displayed until we zoom in on the map at a scale below 1: Press the OK button to exit the Layer Properties dialog. Zoom in on the map until you are below 1:30000 scale factor and you will see the parcels data turn on. 9. Save your map. Linking to and Using External Data 1. Double-click on the Parcels layer in the Design Explorer to open the Map Layer Properties dialog. 2. Click on the Data Sources tab. Click on the Ellipsis next to Key column. You will now see a list of the fields in the Shape file DBF. For ESRI SHP files, this is all of the attribute information that is available. Select SAPN as our key field. This is what we ll use to tie our objects to an external database in the next step. 3. Click on the Name, URL, Where tab on the Data Sources tab. Check the Link to Secondary Table check box then click the Select Secondary Table button. 4. Click the ellipsis next to Data source and select the AU_db data source. Click the ellipsis next to Table and select the FLATATS table. Select APN for the key column. This is what ties our database records to the polygon objects. Click OK. 16

18 5. Back at the Name, URL, Where tab, make sure the Name Source is set to Secondary Table instead of Feature table. 6. Click the ellipsis next to Name column and select TDATA1 as our Name field. Click OK to exit the Layer Properties dialog. Float your mouse over any parcel and you will see the owner s name from the database pop-up. 7. OPTIONAL: for a more complicated concatenated query, try entering this into the Name field: 'Kitsap Parcel ID: '+APN+'\nOwner: '+tdata1+'\naddress: '+(st_no&+' '&+pre_dir&+' '&+st_name&+' '&+st_desig&+' '&+post_dir) Note: The \n is for new line and the & converts numbers to strings (for MS Access only) allowing the concatenation of mixed data types. 8. Save your map. Authoring our Parcels Thematically 1. In the Design Explorer, right-click on Map Layer, then select New Layer, and then Polygon. 2. On the General tab, enter Parcels by Value for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 50 and leave all other settings as they are. 3. On the Data Sources tab, Click on the Ellipsis next to Data Source and select AU_SHP and press the OK button. Under Feature table, press the ellipsis and select parcels as the Shape file we will use for this layer and press the OK button. 4. Click on the Ellipsis next to Key column. Select SAPN as our key field. This is what we ll use to tie our objects to an external database for the theme. 5. On the Styles tab, click the Change button under Display ranges. Enter 3000 for the To number and then press OK. This data is very detailed and we don t want it displayed until we zoom in on the map at a scale below 1: Back on the Styles tab, check the Theme check box then click on the Theme Settings button. Set the Data source to AU_db, the Table to LAND_THEME, the Key column to APN and the Theme column to LAND_VALUE as shown to the right. Click the OK button. 7. Click the Theme Defaults button and we ll leave the default color ramping as it is. Press the OK button. MapGuide will now scan the database for land values and group them into 5 thematic displays. 8. Press the OK button to exit the Layer Properties dialog and you will now see your thematic map. If you don t see it, double check that you are using the SAPN as your layer key value and APN as the database theme key column. 9. Save your map. 17

19 Authoring our Raster Image Layer 1. In the Design Explorer, press the Unzoom button to zoom to the extents of the map. Also, turn off the Parcels by Value layer we just created by unchecking it. 2. In the Design Explorer, right-click on Map Layer, then select New Layer, and then Raster 3. On the General tab, enter Satellite Image for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 20 and leave all other settings as they are. 4. On the Data Sources tab, press the ellipsis next to Raster image file or catalog and select Bainbridge.ecw from the list. 5. Press OK to exit the Layer Properties dialog and see the image on the map. Zoom in to see the image refreshed and the detail in the image. 6. Save your map. Authoring our DWG Layer 1. In the Design Explorer, right-click on Map Layer, then select New Layer, Autodesk DWG. 2. On the General tab, enter Sewer Information for the Layer name. The legend label will automatically be filled in with the same information. Set the Draw Priority to 80 and leave all other settings as they are. 3. On the Data Sources tab, Click on the Ellipsis next to Data Source and select AU_DWG and press the OK button. Select Sewer under Autodesk DWG to specify the DWG in that directory. 4. For the Name table, select the OD_sewer_lines table and press OK. This is an Autodesk Map object data table contained in the drawing. For the Name column, select the Material field. 5. Under Layer filter, press the ellipsis and select all of the all layers that begin with SS (sanitary sewer) and press the OK button. 6. Press the OK button to exit the Layer Properties dialog and to display the new layer on the screen. Zoom in to view the information as it exists in the drawing. It may look better if you turn off the Satellite Image layer. Notice that when you float your mouse over a sewer line, the Material is displayed from the object data table. 7. Save your map. Loading our Map in a Browser This whole time, we have been accessing our MWF file via the Windows file system and have had it open directly in MapGuide Author. We will now open it in a browser window as the end user will view it. 1. Open Internet Explorer. 2. In the Address field, enter 3. Notice that any layers you have turned On or Off in the MWF file in Author when you saved, are how the end user sees the maps. Therefore, try to avoid using Author extensively for browsing the map, as you may inadvertently save it with undesirable layer states. 18

20 Using MapGuide Author Advanced Authoring Techniques Creating a Zoom Goto Definition Zoom Gotos are query definitions allowing the user to search for a piece of text in a Feature or ODBC table. When searching an ODBC table, corresponding latitude and longitude values need to be included in that table so that MapGuide knows where to zoom to. When searching a Feature table (e.g. SDF or SHP file), MapGuide will zoom to the extents of that objects geometry (FEATURE_GEOM). You can also define whether wildcards (%) will be used at the beginning or end of the value the user enters. 1. In the Design Explorer, right-click on Zoom Gotos and select New Zoom Goto. 2. Under Category, enter Parcel by SAPN as the name. Be sure that the Map server URL is set to: 3. Under Data source, click the ellipsis, and select AU_shp as the data source to be used for the zoom goto. 4. The SQL select statement shows the default statement designed to assist you in filling in the missing elements. Edit the SQL statement so that it reads as follows: select SAPN, FEATURE_GEOM from Parcels where SAPN like '%s%%' order by SAPN 5. Click OK to exit the Zoom Goto definition dialog. Then, click the Zoom Goto button on the toolbar to test it out. The zoom goto dialog will open. 6. Enter as the Location. Note that the zoom to width DOES NOT work when a zoom goto is defined based on the FEAT_GEOM of an object. It only works for point zoom gotos. Press the OK button to initiate the search. 7. MapGuide Server will now search the zoom goto data source for the criteria entered. This can take awhile the first time it is executed. In this case, since the record is unique, it will automatically zoom to the extents of that parcel. 8. Save your map. Linking to an External Report Reports allow us to send information directly from the map to an external report engine. The external report engine can be whatever you use in your organization, common ones include Web-based such as Microsoft Active Server Pages, Macromedia ColdFusion or desktop-based such as Crystal Reports. Reports are accessed by selecting items on a layer and pressing the report button. There are two types of reports: Digitize and send coordinates This passes the x and y location of a point clicked on a map. Send keys of selected map features This passes the FEATURE_ID of the selected objects for report searching. 1. From the Design Explorer, right-click on the Reports button and select New Report. 2. Under the Report name, enter Parcel Report. Under URL, enter the following: This Microsoft Active Server Pages file has been predefined for use with this class. 19

21 3. Under Type, select Send Keys of Selected Map Features. 4. Under For map layers, click the Add button then select the Parcels. In addition, the Parcels by Value thematic layer could be used since we have defined both layers as using the APN field as the key. 5. Leave the Parameter set to the default of OBJ_KEYS. An example result would be MapGuide opening a new browser window to: 6. Click the OK button to close the Report definition window. 7. To test the result, select several parcels in your map and notice that the Reports button becomes available in the toolbar. Press that button and then choose Parcel Report from the list. Click the OK button and the report will be generated. Using URL Parameters in Internet Explorer URL Parameters are applied to the end of the URL in the browser when opening an MWF file. The first parameter is denoted with a? And subsequent ones separated with &. 1. Enter the following in the Address field of Internet Explorer: 2. Notice that both the statusbar and the toolbars are not displayed when the map opens. 3. More information about URL parameters can be found in the MapGuide Viewer Help menu under Advanced Topics. Embedding the Map into an HTML Page The first step to creating a custom MapGuide web site, and exposing the map as an object that can be manipulated via the extensive API, is to embed the MWF file into a web page. 1. Open Microsoft Notepad and save the file as c:\projects\au MapGuide Data\Web\default.htm 2. Type the following information into Notepad: <html> <head> <title>autodesk U MapGuide Site</title> </head> <body> <div align="center"><font face="arial" size="+1" color="blue">welcome to</font><br> <img src="images/au.jpg" border="0" alt=""></div> <object ID="MGAMap" WIDTH=100% HEIGHT=100% CLASSID="CLSID: B744-11D0-986B A21D" CODEBASE="mgaxctrl.cab"> <param name="url" value="maps/au_map.mwf"> <param name="toolbar" value="off"> 20

22 <param name="lat" value=""> <param name="lon" value=""> <param name="mapwidth" value=""> <param name="units" value=""> <param name="selobjs" value=""> </object> </body> </html> 3. Open Internet Explorer and enter the following into the Address field: 4. The map should appear. Notice that the Toolbar is turned off by using the same Toolbar parameter as part of the object definition as when we did it at the URL. 5. Optional, determine a center latitude and longitude and map width by viewing the map, and try putting those values in the corresponding parameters to see how the map loads. THANK YOU VERY MUCH FOR ATTENDING! The data files for this course will be available via the Autodesk U web site following the conference. If you have any questions, please feel free to contact me. Contact Information: Andrew Morsell, P.E. Spatial Integrators, Inc. amorsell@spatialgis.com