Summary of Contents for Autodesk 15606-011408-9320 - MAPGUIDE R6.3 CPU MODEL-UPG 4/5 MIN 2 CPUS INITL
Page 1
U S E R ’ S G U I D E 15505-010000-5020 July 2000...
Page 2
MATERIALS DESCRIBED HEREIN. Autodesk, Inc. reserves the right to revise and improve its products as it sees fit. This publication describes the state of this product at the time of its publication, and may not reflect the product at all times in the future.
Autodesk MapGuide Author Key Features 11 Autodesk MapGuide Server Key Features 12 What’s New in Release 5? 12 What’s New in Autodesk MapGuide Author 5? 13 What’s New in Autodesk MapGuide Server 5? 14 What’s New in Autodesk MapGuide Viewer 5? 15...
Page 4
Testing Your Web Server 67 Setting Up the MapAgent 67 Installing a Report Engine 71 Configuring Autodesk MapGuide Server under a Different Account 71 Autodesk MapGuide Server Admin Overview 71 Starting and Stopping the Server 72 Setting Autodesk MapGuide Server Properties 73...
Page 5
Customizing the Access Log 86 Customizing the Map Layer Access Log 86 Adding Geocoding Data 87 Chapter 5 Working with Data in Autodesk MapGuide 89 Basic Steps for Working with Data 90 Working with Spatial Data 90 Map Features 91...
Page 6
About Coordinate Precision 113 Choosing a Coordinate System 113 Creating a Design Spreadsheet 114 General Guidelines 115 Information You Need from Your Autodesk MapGuide Server Administrator 116 Chapter 7 Getting Familiar with Autodesk MapGuide Author 117 Installing Autodesk MapGuide Author 118...
Page 7
Chapter 8 Creating and Publishing a Map 137 Creating a New Map 138 Changing the File to Use for New Maps 138 Specifying a Coordinate System 138 Specifying a Password to Protect a Map 139 Creating and Modifying Zoom Goto Location Categories 140 Data Source Format for Zoom Goto Location Categories 140 The US Street Address Location Category 141 Customizing the Popup Menu 142...
Release 5? This chapter also includes an overview of how the System requirements What’s the fastest way Autodesk MapGuide products work together, what through this book? Where to get more to do first, and where to go for more information.
Overview Autodesk MapGuide is a suite of products that allows you to create, publish, and display maps, drawings, designs, schematics, facilities management plans, and associated attribute data over the Internet, an intranet, or an ® extranet. Autodesk MapGuide Author users access the data when they ®...
Autodesk MapGuide Author Key Features Accurate display of authored maps Map and resource security control Style display by scale Thematic map settings and symbology Complete layer setup and definition, including support for layer groups Multiple Document Interface (MDI) support Global property settings, including projection information and map...
Extension) What’s New in Release 5? Autodesk MapGuide Release 5 includes the new features described in the fol- lowing sections. In addition to the changes listed here, Release 5 includes enhancements to the Autodesk MapGuide Viewer API. For details, refer to the Autodesk MapGuide Viewer API Help.
North arrow, the map’s URL, and the current date and time. Also, you can specify the scale of the map you want to print, or you can have Autodesk MapGuide automatically scale the map to fit the printed page.
SDP (spatial data provider) architecture. If you purchase a Data Exten- sion for your specific data type, such as Oracle8i Spatial or VISION*, you do not need to convert data to SDF format before using it with Autodesk MapGuide. For information about these and additional forthcoming data extensions, contact your nearest authorized Autodesk reseller.
Layers can now be part of layer groups, which appear in the Viewer legend. Help Available from the Toolbar Autodesk MapGuide Viewer now includes a Help button on the toolbar for quick access to the Autodesk MapGuide Viewer Help or to a customized help URL. Enhanced Printing You can now use the entire page for printing a map, and you can control which elements print on the map.
MDAC 2.1 Service Pack 2 or later (MDAC version 2.5 included with Autodesk MapGuide Server installation) Pentium-based PC 128 MB of memory (192 MB if using multiple releases of Autodesk MapGuide Server on the same computer) 22 MB of free disk space (25 MB plus data files space recommended);...
(TCP/IP provided on the Windows NT/2000 installation CD) IP address assigned to the server computer Autodesk MapGuide Viewer Requirements The three versions of Autodesk MapGuide Viewer (Plug-In, ActiveX Control, and Java edition) each require different configurations. Autodesk MapGuide Plug-In Viewer Requirements Microsoft Windows 95, Windows 98, Windows NT 4.0, or Windows 2000...
Depending on your role, you will need to perform different tasks from other people working on the project with you. The scope of implementing Autodesk MapGuide can vary widely. In some cases, one or two people can create and post a map. In others, several contributors work together to create...
Page 19
The data engineer ® might use AutoCAD Map to create spatial data, or use Autodesk MapGuide SDF Loader to convert spatial data from other sources. Data engineers need to work with the map authors to determine what spatial data is needed for the maps, and then either create or acquire that data.
Page 20
Create HTML pages with embedded JavaÔ, JavaScript, JScript, or VBScript code that accesses the objects of the Autodesk MapGuide Viewer API. For example, you might create an HTML form containing a button that turns a layer on and off, or a drop-down list that selects map features.
“Choosing a Viewer/Browser Environment” on page 59), and in the Autodesk MapGuide Developer’s Guide. You can download the Autodesk MapGuide Developer’s Guide free of charge, or you can order the printed copy from the product documentation page at: http://www.autodesk.com/mapguidedocs Conventions Used in This Manual The following table describes conventions used in this manual.
You can access the help by choosing Help Contents, by clicking the Help button on the toolbar, or by clicking the Help button in any Autodesk MapGuide Author or Autodesk MapGuide Server Admin dialog box. Autodesk MapGuide Viewer API Help This help system contains references to the objects, properties, methods, and events of the Autodesk MapGuide Viewer API.
Page 23
Autodesk MapGuide Raster Workshop Help This help system is provided with Autodesk MapGuide Raster Workshop. It provides overall information as well as detailed descriptions of how to use the Raster Workshop to convert images to TIFF and tiled TIFF format, create raster image catalogs, and more.
Autodesk MapGuide ReadMe File The ReadMe file for all of the Autodesk MapGuide products includes a list of installed files and directories for each of the Autodesk MapGuide products. Third-Party Documentation Many excellent third-party books are available. Your tastes may vary, but here are some that we found useful: Cold Fusion Web Application Construction Kit, by Ben Forta et al.
The Autodesk online discussion groups, located at http://www.autodesk.com/discussion, are open forums for Autodesk customers, partners, or anyone with an interest in Autodesk’s products. You can post information or questions, answer other members’ questions, or just browse messages to gather information and learn tips and tricks from other users.
Understanding Autodesk MapGuide In This Chapter This chapter includes an overview of the Autodesk What is Autodesk MapGuide? MapGuide product suite, as well as information How Autodesk MapGuide about planning a strategy for using the Autodesk components work together MapGuide products.
Understanding Layers A key feature of Autodesk MapGuide is the use of layers. Layers are like sepa- rate transparent sheets on which different spatial data is drawn. By sepa- rating data into different layers, you can work with your data more effi- ciently.
Web page authors can then embed the file in their web pages or create links to it. To view the map, users can install Autodesk MapGuide Viewer free of charge. When the user opens a web page that contains an MWF file or clicks a link to an MWF file, the web browser auto- matically loads Autodesk MapGuide Viewer to display the map.
How Autodesk MapGuide Components Work Together The following diagram provides an overview of how the Autodesk MapGuide products work together. Applications A n y B r o w s e r A u t o d e s k O n S i t e...
This section describes the programs and data resources used to create a map. Autodesk MapGuide Author Autodesk MapGuide author allows you to create maps by setting up map window files (MWFs). You can then embed one or more MWF files (or create a link to them) in a web page.
TIFF files improve performance) from standard image formats, create raster image catalog (RIC) files, and manipulate the images that are referenced by the RIC. You can then use the TIFF and RIC files with Autodesk MapGuide, or use the TIFF files with other Autodesk products that support raster images.
(http://www.autodesk.com/mapguide). Note If you want to distribute maps without requiring that users install one of the Viewers, you can do so using the Autodesk MapGuide LiteView Extension. For more information, see the next section and the Autodesk Mapguide LiteView documentation.
59. Autodesk MapGuide LiteView Extension Autodesk MapGuide LiteView Extension serves maps in a raster format, with limited interactivity, so that users are not required to install an Autodesk MapGuide Viewer. For more information, see the Autodesk Mapguide LiteView documentation.
This section describes the products and technologies used to create an Autodesk MapGuide application. An Autodesk MapGuide application can be as simple as an HTML page that displays an embedded map window file (MWF), or it can be as complex as a CGI application, coded in C++, that modifies data files on the server and refreshes the browsers of everyone viewing the map.
A web browser and an HTML page that hosts Autodesk MapGuide Viewer An MWF that is read by Autodesk MapGuide Viewer and displayed as a Web browser scripts that access the APIs for the browser and Autodesk...
Page 37
HTML page) by using the tag in an HTML page and creating a link <A HREF> to the MWF. For more information, refer to the Autodesk MapGuide Viewer API Help. Web Browser Scripts Autodesk MapGuide supports the following HTML scripting languages: JavaScript.
Stand-alone Applications You can write a stand-alone C++, Visual Basic, or Java application that hosts Autodesk MapGuide Viewer without a web browser. For details about supported platforms, see “Choosing a Viewer/Browser Environment” on page 59.
Page 39
Using this tool, workers in the field could add polylines repre- senting lot lines to the SDF files so that the changes would be visible to anyone else viewing the map. For more information, refer to the Autodesk MapGuide Developer’s Guide.
Autodesk MapGuide project and server layout, setting up an Autodesk MapGuide Server and a web server, gathering your data, and creating your HTML pages.
Phase Two when you plan and design your complete Autodesk MapGuide application. In either case, the data and map layer you create in this phase should be very basic and for testing purposes only.
Autodesk MapGuide SDF Loader, and then convert one file to SDF file format. 6 In Autodesk MapGuide Author, create a new layer based on the SDF you created in the previous step or based on the data you are accessing through a data extension.
Depending on which functionality you want to add to the web page, which Autodesk MapGuide functions do you need to use in order to provide this functionality? Do you need to create other applications and scripts, such as CGI...
Page 44
7 Add the MWF to the application skeleton, then test all layers, reports, Zoom Goto categories, and so on. 8 Build the placeholder functions and test them. Chapter 2 Understanding Autodesk MapGuide...
Designing Your System In This Chapter This chapter covers topics that you need to take Planning your directory structure into consideration before you set up your Autodesk Security Architecture and MapGuide Server, author your map, or develop performance your Autodesk MapGuide Viewer application. Read...
You will need to create a directory structure for any of the file types you use with Autodesk MapGuide. In some cases you will also have to create virtual directories that map to physical directories. Your main security strategy is to locate files above and below your web root directory and to create virtual directories when necessary.
Page 47
Use the following guidelines for setting up your directory structure. Group your files into projects, with project directories. For instance, if you post two projects on your Autodesk MapGuide Server, create /project1 and /project2 under your web root: /web root/project1/ /web root/project2/ You must place HTML files under the web root.
Use your web server to set security for virtual directories. Plan your direc- tory structure so that files requiring security are above the web root. Use Autodesk MapGuide to set up user IDs and passwords, access keys, and passkeys to protect resources (such as SDFs and databases), maps, and map layers.
Autodesk MapGuide-enabled web site. In addition to the Windows NT/Windows 2000 and web server security methods just discussed, you can also use a variety of methods in Autodesk MapGuide Server to set up security.
Page 50
Note Be sure to run Autodesk MapGuide Server and Autodesk MapGuide Server Admin under the same account (the System account or a user account). Other- wise, the resources you see in Autodesk MapGuide Server Admin might not be the same resources that are available to Autodesk MapGuide Server. See “Config- uring Autodesk MapGuide Server under a Different Account”...
API getVertices() and getLayerSetup() methods. You control the security of this data from the Map Layer Properties dialog box in Autodesk MapGuide Author. If you allow API access, you can also specify that the application must send a specific passkey first, which the application developer passes in with the unLock method.
Autodesk MapGuide Server. Because RPC calls can be made across a network, the MapAgent does not need to reside on the same computer as Autodesk MapGuide Server. This is useful for enhancing security, because it allows you to publish maps from your public server while keeping your data, Autodesk MapGuide Server, and the commu- nication between them secure on your private internal LAN.
Different versions of Windows use either UDP ports or TCP ports for RPC by default. When you use the MapAgent on a different computer from the Autodesk MapGuide Server, be sure that the computers are using compatible operating systems. Otherwise, if the Autodesk MapGuide MapAgent computer attempts to communicate with the Autodesk MapGuide Server computer using a different protocol, there will be a 30—45 second delay.
Page 54
Each server then sends its processed data back to the Viewer. The Viewer always draws layer 1 first, and then draws all of the rest of the layers simultaneously once it has received all of the data. Autodesk Autodesk Autodesk Autodesk...
Page 55
The distributed data model requires less maintenance than the mirrored systems model. However, this approach is not fault tolerant—if one Autodesk MapGuide Server goes down, map viewers cannot access the data on that server. The mirrored systems model is safer than the distributed data model because it does have fault tolerance, which provides a backup server so that the data is still available.
Page 56
In the next diagram, a web server has a MapAgent that points to several Autodesk MapGuide Servers, each of which has exactly the same data as the others. In this case, requests made to this server will be distributed among the...
The following table describes whether each type of data needs to be available to the Autodesk MapGuide Server(s) or the web server. Note that the MapAgent does not need access to data files, as it simply relays whatever data is sent to it from the Autodesk MapGuide Server.
Page 58
Generalize data as much as possible. This involves reducing the resolution of the data so that there is less data to process. You can generalize SDFs using Autodesk MapGuide SDF Loader or Autodesk MapGuide SDF Com- ponent Toolkit; you can sub-sample raster images using Autodesk MapGuide Raster Workshop.
Trim feature names if they are not used. You can use the /NULLNAME switch in Autodesk MapGuide SDF Loader to do this. Also, use the /LINK switch to specify the URL column(s) only if you plan to use the URLs.
Page 60
The following table is designed to help you consider each of these factors. Components for Choosing a Viewer/Browser Environment Operating Browser Viewer Language System Windows Internet Explorer ActiveX Control HTML, VBScript, Jscript, Java Internet Explorer Java edition HTML, JScript, Java Netscape Plug-In HTML, JavaScript,...
Page 61
Components for Choosing a Viewer/Browser Environment (continued) Operating Browser Viewer Language System Solaris Netscape Java edition HTML, JavaScript, Navigator Java Any browser that LiteView Extension ColdFusion (CF), supports PNG file Active Server format Pages (ASP), Java Server Pages (JSP) or Perl none Java edition Java...
Page 62
(a servlet). It converts an MWF file into a PNG image and returns it as an HTTP response to a request. It extends the capabilities of Autodesk MapGuide to quickly display maps as raster images in Netscape Navigator, Internet Explorer, or any other browser that supports the PNG image format.
Assembling and Administering Your Server In This Chapter This chapter includes information about setting up Setting up your server Autodesk MapGuide and administering your server. Before you begin, Server Admin overview please read Chapter 3, “Designing Your System,” to Setting general server...
Before installing Autodesk MapGuide Server, be sure to do the following: Log On with Administrative Rights Before you install Autodesk MapGuide Server, log on to Windows as an administrator or as a user who has administrative privileges. Verify Your System Requirements If you are running Microsoft Windows NT, make sure that you have installed Service Pack 4 or later.
Page 65
Remove Autodesk MapGuide Server 4.1 for VISION* If you have Autodesk MapGuide Server 4.1 for VISION* installed on your computer, follow these steps before installing Autodesk MapGuide Server Release 5. 1 Use Autodesk MapGuide Server Admin to stop the Autodesk MapGuide Server Service.
An entry in a DNS server. Make sure that the administrator of the DNS server in your network enters the computer on which you are installing Autodesk MapGuide Server into the domain. A user account set up on the computer.
Setting Up a Remote MapAgent The Autodesk MapGuide MapAgent uses DCOM to forward client requests for map data to the Autodesk MapGuide Server. DCOM is built upon the RPC (remote procedure calls) transport. Because DCOM calls can be made across a network, the MapAgent does not need to reside on the same computer as Autodesk MapGuide Server.
Page 68
DNS host name of the Autodesk MapGuide Server instead of the IP address. While you are editing the value for this key, you can also set up Autodesk MapGuide to take advantage of load balancing.
Page 69
When you use a remote MapAgent, you need to configure your firewall to permit DCOM penetration from the outside to the inside. First, you must limit the DCOM port range on the Autodesk MapGuide Server computer. By default, a DCOM server uses port 135 for handshaking and uses any port in the range of 1,024 through 65,535 to service the DCOM call.
Page 70
The following diagram provides a basic overview of how the MapAgent and Autodesk MapGuide Server communicate over the firewall. RPC communication via firewall For information about the configuration of your particular firewall, please consult the firewall’s documentation or your network administrator.
The Autodesk MapGuide Server service runs under the default System account. However, if you have data sources on another computer that you want to serve from Autodesk MapGuide Server, you need to run them under a user account that has access to that computer. Follow these steps after installing Autodesk MapGuide Server.
“Administering Your Autodesk MapGuide Server.” Starting and Stopping the Server You can start and stop the server using Autodesk MapGuide Server Admin. Online Help Index Starting the server brings it online so that is ready to accept and process...
You use the six tabs in this dialog box to specify all of the properties for the Autodesk MapGuide Server. This chapter includes basic information about each tab. You can find complete, step-by-step procedures in the online help.
DB data provider such as Microsoft Access, SQL Server, Oracle, or any ODBC data source (using the Microsoft OLE DB Provider for ODBC Drivers). In addi- tion, Autodesk MapGuide Server can access spatial data from OLE DB Spatial Providers (SDPs), such as Autodesk MapGuide SDF, Autodesk VISION*, and Oracle8i Spatial, by using data extensions.
Microsoft Jet 3.51 OLE DB Provider Microsoft OLE DB Provider for ODBC MDAC 2.5 is included on the Autodesk MapGuide Server CD in the following location: \MDAC2.5\MDAC_TYP.EXE) Tip If a native OLE DB provider is not available for your data source (for example, if you are using Lotus Notes), you can use the Microsoft OLE DB Provider for ODBC Drivers.
Access Keys Versus User IDs and Passwords Access keys are passwords that the author of a map embeds in the definition of the map layer. Each time the map layer requests map data, Autodesk MapGuide Server verifies the embedded access key against the list of valid access keys for the resource before fulfilling the request.
To implement any or all of these techniques for controlling access to the map data resources at your site, you use Autodesk MapGuide Server Admin. Creating and Modifying Users and Groups In order to control access to resources, you set up users and groups using the Online Help Index Users/Groups tab of the Properties dialog box.
Autodesk MapGuide Server contains a predefined group called Authors. When creating a map layer in Autodesk MapGuide Author, members of the Authors group can query Autodesk MapGuide Server for a list of the available data sources. Such queries elicit a prompt for a user name and password, which are validated against the Authors group list.
Zoom Goto definition, the access key is automatically sent to the server along with the request for the data. Autodesk MapGuide Server then verifies that the access key is on the list of access keys assigned to that resource before providing the data.
Click for details about the options in this dialog box. Restricting Access to Resources You can restrict access to your resources (data sources) by adding the resources to the Resources tab in the Properties dialog box. To display the Properties dialog box, choose Edit Properties.
Warning When you run Autodesk MapGuide Server Admin, you are always logged in under a user account. If Autodesk MapGuide Server is running under the System account, it will not be able to access the User DSNs you can access in Autodesk MapGuide Server Admin.
Tracking Server Requests When Autodesk MapGuide Server is running, its status is displayed on the Autodesk Server Admin title bar, and the number of requests currently being processed is shown in parentheses. You can view additional usage informa- tion by displaying one of the log files or running a usage report.
Access Log The access log file records all requests to Autodesk MapGuide Server and gives you an idea of the activity at your site. An access log record is created for each request as the request is completed. For information about customizing the access log file for map layer data requests, see “Customizing the Access Log”...
Renaming Log Files You can rename the access log, error log, and trace log using the Logging tab Online Help Index of the Properties dialog box. For step-by-step instructions, choose Help log files renaming Contents, click the Index tab, and look up “log files, renaming.” Rotating the Log Files For the access log, error log, and trace log, you can automatically create a new file for each log every day at midnight, allowing you to have a different log...
Customizing the Access Log When a user sends a request to build map layer data in Autodesk MapGuide Online Help Index Author or the Viewer, the program sends a map layer data (MLData) request. access log customizing Autodesk MapGuide Server site administrators can customize the informa- tion that is recorded in the access log file for MLData request types by modi- fying values in the Windows registry.
Adding Geocoding Data Before you can enable zooming to a US street address or ZIP code, Autodesk MapGuide Server must have access to a geocoding database. When the user enters an address or ZIP code, Autodesk MapGuide finds that address and its corresponding coordinates in the database, and then zooms to that location on the map.
This chapter discusses the basic steps for working Basic steps for working with data with data and includes information about the dif- Working with spatial data ferent kinds of data you can use with Autodesk Working with attribute data MapGuide. Working with raster images...
This chapter is designed to give you an understanding of the different types of data you can use with Autodesk MapGuide, and how you create or procure the data. For information about using the data in map layers, see Chapter 9, “Working with Map Layers.”...
Map Features Map features are the geographic features that appear on a map. In Autodesk MapGuide, map features are points, such as fire hydrants and cities, polylines, such as rivers and roads, and polygons, such as lakes and land parcels. Each map feature has a name, an optional URL link, and geometric data specified by one or more coordinate pairs.
Typically, you use an application like AutoCAD Map to create your data, then export it to an Autodesk MapGuide SDF. If the application you are using does not support the SDF file format, you can use Autodesk MapGuide SDF Loader, Autodesk MapGuide SDF Component Toolkit, or AutoCAD Map to convert the data to SDF.
To link the attribute data to the spatial data, you simply specify the OLE DB database table you want to use when setting up the layer. Autodesk MapGuide Author matches the records in the table to the spatial features in the SDF from which the layer was created by means of a key.
The second table would also contain the same key values as the first table; Autodesk MapGuide uses these keys to assign the theme values in the second table to the corresponding cities in the first table.
You need to take the following points into consideration when setting up your attribute database: Before Autodesk MapGuide can use your databases, you must set them up and configure them as OLE DB data sources. See “Setting Up Your Data Sources”...
SQL statement that retrieves coordinates from the database based on a parcel ID that is passed in. The Zoom Goto dialog box in Autodesk MapGuide Viewer would let users enter the ID of the parcel they want to zoom to, and the SQL statement would retrieve the coordinate values, enabling the Viewer to zoom to that feature.
Autodesk MapGuide supports various raster image file formats. The following section contains a complete list of supported file formats. Raster Image File Formats...
When you access a layer that references a RIC file, Autodesk MapGuide Server scans through the RIC file to determine the images or portions of images that correspond to the area being viewed, and then sends only the data for that area.
Page 99
If only the file name of the raster image is specified, the search will start in the directory where the RIC is located before using the Raster Image Search Path (specified in Autodesk MapGuide Server Admin) to locate the file.
Georeference File Formats A georeference file indicates how to place a raster image on a map. Autodesk MapGuide Author supports four georeference file formats: ESRI world files, MapInfo tab files, GeoTIFF files, and header files.
Page 101
Format ( Example ( continued continued <negative y dimension of a -2.0 pixel> <x value of the upper-left 233001.5 pixel> <y value of the upper-left 901999.5 pixel> For example, a typical ESRI world file might look like this: 0.000000 0.000000 -2.0 233001.5 901999.5...
Page 102
MapInfo uses a tab file (.TAB) to georeference a raster image. It contains control points to map pixel coordinates in a raster image to world or map coordinates. To work in Autodesk MapGuide Author, you need to specify the control points so that linear scaling is possible.
Page 103
Example GIS-GEOSPOT Header File Image Information DELTA_X_ORIGIN 0.0 M DELTA_Y_ORIGIN 0.0 M MAPUNITS METERS ULXMAP 543134.90 M ULYMAP 5283921.00 M XDIM 10.0 M YDIM 10.0 M NCOLS 1269 NROWS 1862 NBANDS Frame Corner Support NW_X_PIXEL NW_Y_PIXEL NE_X_PIXEL 1251 NE_Y_PIXEL SW_X_PIXEL SW_Y_PIXEL 1862 SE_X_PIXEL...
Note Symbols imported from WMF/EMF files or the Clipboard support only lines, arcs, polygons, ellipses, rectangles, and text strings. Bitmaps, bezier curves, paths, and poly-text in WMF/EMF files are not supported in Autodesk MapGuide. Chapter 5 Working with Data in Autodesk MapGuide...
When Autodesk MapGuide connects to spatial data using SDPs, perfor- mance is maximized. To specify the spatial data source for a map layer in Autodesk MapGuide Author, you first specify the SDP to use to serve the data from the file, and then you specify the file.
Page 106
VISION* Objects and the SDF Component Toolkit. This kind of utility is beyond the scope of this documentation and should be implemented by a system administrator who is familiar with VISION* and Autodesk MapGuide. Parsing Map Feature Keys If you will be developing reports, it is important to know how to parse the keys for the map feature so that you can get information about the original VISION* features.
Page 107
Autodesk MapGuide hatch style or a series of polylines. To improve performance, you can choose colors, line styles, and hatch styles in your VISION* themes that map directly to those in Autodesk MapGuide, and use common TrueType fonts instead of the VISION* vector fonts.
Page 108
Scale-Dependent Symbology Displayed as Fixed Some scale-dependent VISION* symbology (for example, line thickness) is displayed in Autodesk MapGuide at a fixed scale. In this case, the scale will be correct when the symbology is initially displayed in Autodesk MapGuide, but as the user zooms, the lines will not get thicker.
Planning layers your maps, including details about designing your Designing the map map and information you will need from your Information you need from your Autodesk server administrator. MapGuide Server administrator This chapter may be especially helpful to: Map authors...
Do you want to use a different name in the Viewer legend (and in the View tab of the Autodesk MapGuide Author Map Explorer)? You can enter a sep- arate name for the layer in the Legend Label box on the General tab of the Map Layer Properties dialog box.
Page 111
In this case, you might name the layers “Roads - General” and “Roads - Detailed” so that you know which one you’re working with in Autodesk MapGuide Author (and through the Viewer API), but you could have them both dis- play the name “Roads”...
layers should fall within which of these three display ranges and set display ranges for them accordingly. For more information, see “Creating a Design Spreadsheet” on page 114. Designing the Map After you have planned the data and layers for your map, you need to address design issues, such as which coordinate system to use, what coordinate preci- sion you want, and how to set up and use a design spreadsheet—as well as following general design guidelines.
Autodesk MapGuide SDF Loader Help (SDFLOAD.HLP) located in the SDF Loader directory. To see a complete list of the coordinate systems in Autodesk MapGuide, as well as their corresponding codes that you use with the /COORDSYS param- eter in the SDF Loader, refer to the file cscodes.txt that is installed with the SDF...
Ask surveyors, cartographers, consultants, and other mapping profession- als for suggestions. Creating a Design Spreadsheet One very effective technique for keeping track of all your data for a map is to create a spreadsheet of all of the layers you create, the legend layer name, which data sources they reference, the scale range, display styles, such as color or line style, and notes.
General Guidelines Following is a list of guidelines you should consider when designing your map. The map should be made up of elements of nearly equal size with no fea- tures dominating the map. Text size should be neither too small to read nor so large that the text dominates or obscures features.
You will use this information when setting up a layer. The URL of the Autodesk MapGuide Server MapAgent. If your organiza- tion has more than one Autodesk MapGuide Server, you may have more than one map agent to choose from. You specify the map agent you want to use when you set up a layer.
Autodesk MapGuide Author In This Chapter This chapter includes the essential information you Installing Autodesk MapGuide Author need to get started with Autodesk MapGuide Starting Autodesk MapGuide Author Author, including instructions for installing and Introduction to the program window starting the program, navigating maps and layers,...
2000, you must have Power User/Administrator rights to install Autodesk MapGuide Author. This is required for the installation process only; you can log on as any user to run Autodesk MapGuide Author after you have installed it. 1 Insert the CD in the CD-ROM drive.
During the 30-day evaluation period, the Authorization Reminder dialog box will appear every time you start Autodesk MapGuide Author. From this dialog box, you can access the dialog box in which you enter your authorization code.
About Map Window Files (MWFs) Autodesk MapGuide stores each individual map as a map window file (MWF). In Autodesk MapGuide, the terms “MWF” and “map” are used inter- changeably. You create MWFs using Autodesk MapGuide Author. Each MWF contains the specifications of the map window. These specifications include...
As a map author, you can modify the popup menu to show or hide functionality in Autodesk MapGuide Viewer. You can customize all but the first item on the popup menu by adding or deleting commands, or by modifying the actions assigned to specific commands.
Page 122
Bookmark menu (so that you can quickly access this same view of the map again), select a bookmark, or delete existing bookmarks. Chapter 7 Getting Familiar with Autodesk MapGuide Author...
Help Accesses the Help commands, which you can use to set preferences for the map window, access the Autodesk MapGuide Help contents, and view ver- sion and copyright information for Autodesk MapGuide Author. In Autodesk MapGuide Viewer, the Help commands bring up help specific to using the Viewer.
Page 124
Windows metafiles will not be able to use the files from the Clipboard. If you use the Copy button when the Design tab of the Autodesk MapGuide Author Map Explorer has focus, the currently selected layers or layer groups are copied to the Clipboard.
See the next section, “Setting Preferences,” for more information. Setting Preferences You can customize Autodesk MapGuide Author by specifying preferences for Online Help Index toolbar button size, map units, status bar display, and more. When you...
Click for details about the options in this dialog box. Opening a Map Autodesk MapGuide Author can open maps in the following ways: Online Help Index opening maps Open a map located on a local or network drive using the File Open command.
Page 127
Autodesk MapGuide Author downloads additional layer data from the server when the zoom and pan commands display new areas or layers of the map. You can click Stop or press Esc to interrupt a data download. Moves the map to display areas that are outside the cur- rent view.
(such as museums, parks, airports, etc.) and then type the name zooming to a location of the specific location you want to see. Autodesk MapGuide Author looks up the location and zooms to it. The categories of locations that are available depend on the way the map was authored.
Index tab, and look up “bookmarks.” Using the Map Explorer The Map Explorer, which appears on the left side of the Autodesk MapGuide Author window, contains the Design tab and the View tab. Both tabs display the layers and layer groups in the map. As you design and create maps, you work in the Design tab.
If the data for a layer cannot be retrieved, the layer is displayed as shown in the following illustration: This icon indicates that there was an error retrieving the data for the layer. Chapter 7 Getting Familiar with Autodesk MapGuide Author...
As you are creating a map or after you have finished creating a map, you can use the View tab to see how the map’s legend will appear in Autodesk MapGuide Viewer. This can help you verify that you have created your layers as you planned.
MapTips displays the feature’s layer and followed by the feature’s name. Additionally, Autodesk MapGuide Author displays the feature name in a yellow MapTip popup that appears when you move the pointer over the feature. If the feature is unnamed, the layer and feature name area of the status bar remains blank, and no MapTip appears.
If the feature under the pointer is linked to a web document, the pointer changes from an arrow to a hand, and Autodesk MapGuide Author displays the URL of the linked web document on the status bar. You can then double- click the feature under the pointer to load and display the linked web document.
“Specifying General Properties for Layers” on page 153. Note When you select a map feature, Autodesk MapGuide Author selects the feature by its key. Therefore, if you select a map feature that contains multiple points, each of which has the same key, each of those points will be selected. Sim- ilarly, if there are multiple features in the map with the same key, selecting one of those features will select all features that share that same key.
For example, you could locate all customers within one mile of a number of store locations. As part of this query, you might also want to see the area that defines the spatial query. Autodesk MapGuide Author can create buffer zones around one or more selected features. You can then select features that fall within these buffers.
Page 136
You use the File Page Setup command to specify how to print your map. For step-by-step instructions, choose Help Contents, click the Index tab, and look up “page setup” and “printing maps.” Chapter 7 Getting Familiar with Autodesk MapGuide Author...
Creating and Publishing a Map In This Chapter This chapter explains how to create, save, and Creating a new map Specifying a publish a map, including details about setting Coordinate System Specifying a password passwords, specifying a coordinate system, and to protect a map working with Zoom Goto location categories.
New command in Newmap.mwf Autodesk MapGuide Author. The file used to create new maps is called Newmap.mwf. If you prefer to start with a different map for all new maps that you create, you can do so by saving your own map as Newmap.mwf, over- writing the default new map.
Specifying a Password to Protect a Map You can secure your maps by assigning passwords to them. Using passwords Online Help Index prevents other Autodesk MapGuide Author users from opening a proprietary passwords setting for maps Internet-published map and accessing the information stored in its MWF file.
Each Zoom Goto location category includes the information required by Autodesk MapGuide Server to look up locations in an SQL database. When Autodesk MapGuide Server finds one or more matching locations, it returns the associated coordinates to Autodesk MapGuide Author or Autodesk MapGuide Viewer, which zooms to the specified location.
The US Street Address Location Category Online Help Index zoom goto location Autodesk MapGuide Author comes with a predefined location category categories US Street Address called “US Street Address.” When you activate this category, you access a geocoding database that contains U.S.
Autodesk MapGuide Author will appear when users view your maps using Autodesk MapGuide Viewer. If you have your own online help system that you want to use for your Autodesk MapGuide Viewer, you can specify it in the popup menu.
“Specifying Data Source Properties for Layers” on page 153. To add the report to your map, use Autodesk MapGuide Author to specify the report properties, which include a name for the report, the URL location of the report, the map layers that may access the report, and any optional parameters to be sent with the report request.
When users access a map that has a tracking ID, every action tracking ID they perform (such as panning or zooming) can be logged by Autodesk MapGuide Server. Using Autodesk MapGuide Server Admin, you can then run a report to monitor usage based on the tracking ID. This can be useful, for example, if you want to charge customers for using your maps.
The web developer should make a note on the web page that Autodesk MapGuide Viewer is required for viewing the map and should add a link to the Autodesk MapGuide web site where the user can download the Viewer free of charge.
Working with Map Layers In This Chapter Each map authored with Autodesk MapGuide About map layers Working with map Author contains one or more map layers. This layers in the Map Explorer chapter explains how to work with layers, includ-...
When you access a dynamic map layer using Autodesk MapGuide Author or Autodesk MapGuide Viewer, Autodesk MapGuide Server sends the map data for the layer on demand. As you zoom in and out on the map, the Server sends the data for the visible area only, not for the entire map.
In Autodesk MapGuide Author, there are two main types of layers: vector and raster. Vector layers contain spatial data that is made up of points and lines, such as cities, countries, and roads. Each vector layer can contain only one type of vector data, either text, points, polylines, or polygons.
When you right-click a layer in the Design tab of the Map Explorer, the map layer popup menu appears, as shown in the following illustration. You use the commands in the map layer popup menu to create, modify, or manipu- late the layers in a map.
For more information, see “Creating Buffers around Map Features” on page 135. Creating a Raster Layer When you add a raster map layer to a map, Autodesk MapGuide Author Online Help Index assumes that the raster images are in the same coordinate system as that used...
VISION* theme. Therefore, you do not specify the styles for the layer, as you do with other types of layers in Autodesk MapGuide Author, nor are the styles stored with the layer defi- nition in the Map Window File (MWF).
URL of the Autodesk MapGuide Server MapAgent that will serve this data, and additional data source properties. If you are creating a raster layer, the Data Sources tab looks different than it does when you are creating a vector layer.
Page 154
If you choose SDP (Spatial Data Provider) Data Source, the dialog box dis- plays two secondary tabs as shown here: Secondary tabs for SDP Data Sources: SDP Data Source and Name, URL, Where If you choose OLE DB Data Source, the dialog box displays two different secondary tabs, as shown here: Secondary tabs for OLE...
3 Specify data source properties as described in the online help. Online Help Index You can click the Help button in each secondary tab to get details about layers the options on the tab. data source properties Setting Style Properties for Layers You can specify properties that control how data appears on a map.
Styles tab for vector layers Setting Style Properties for Raster Layers The style properties that you can set for raster layers are different from those Online Help Index you can set for other types of layers. For step-by-step instructions, choose raster layers styles Help...
Display Ranges box. When the current zoom level of Autodesk MapGuide Author or Autodesk MapGuide Viewer is within the visible display range of a particular layer, the program redraws that layer as specified in the associated style set.
If you want to draw the same data multiple times in different ways to create the effect of complex line styles, you can specify multiple styles for a single style set. For details, see “Creating Complex Line Styles with Polylines” on page 161.
Page 159
Contents, click the Index tab, and look up “size units, for text and point layers.” Setting Display Styles for Point Layers You can use symbols to represent point layer features. Autodesk MapGuide Online Help Index Author comes with predefined symbols that are grouped by type in a number...
Page 160
Adding New Symbols for Use in Point Layers If you have symbol files that you want to use on point layers, you can add Online Help Index them so that they are available in Autodesk MapGuide Author. You use the symbols adding Symbol Manager dialog box to add symbols.
Page 161
On polyline map layers that do not use themes, you can create complex line styles by defining multiple display styles for the same display range. Autodesk MapGuide Author draws each display style on top of the one that precedes it in the Style list, creating a more complex display than a single style can produce.
Page 162
The following illustration shows a style set with three styles. The first is a wide red line, the second is a narrower yellow line, and the third is a very thin dashed red line. This will draw the polylines on the layer three times in three different ways to create the visual effect of a highway with a center line.
Creating Themes You can create themes that allow users to quickly see and understand data on Online Help Index your map. For example, a typical theme for a point layer could display retail themes creating store locations with a different symbol for each type of store. A polygon layer theme could display each land use classification with a different color or shading.
If the keys match, the Autodesk MapGuide Server loads the layer’s data. If keys do not match, access to the resource data is denied. If the resource does not use an access key, the access key embedded in the layer is ignored.
“Adding a Saved Layer to the Current Map” on page 166. You can also add MLFs to a map using the Autodesk MapGuide Viewer API. For more information, see the Autodesk MapGuide Viewer API Help. To save a layer to a file...
OK. Rebuilding a Layer or Layer Group If you have made changes to one or more layers, you can have Autodesk Online Help Index MapGuide Server rebuild the layers so that you can see the changes in rebuilding layers Autodesk MapGuide Author.
Deleting a Layer or Layer Group You can delete layers and layer groups that you do not want in your map. Note that deleting a layer group deletes all of the layers in the group. To delete a layer or layer group 1 In the Design tab of the Map Explorer, select one or more layers or layer groups to delete.
An alphanumeric string used by Autodesk MapGuide Server to determine whether a map layer has permission to gain access to a resource. In the Autodesk MapGuide Server Admin, you can assign one or more access keys to a resource. Then, when a map author sets up a layer to use that resource, the author must type one of the valid access keys in the Map Layer Properties dialog box.
Page 170
The maximum and minimum scale at which Autodesk MapGuide will display a layer. In Autodesk MapGuide Author, you can specify that a layer will display only at certain ranges, or specify multiple display ranges for a layer and specify different attribute styles for each of the display ranges, so that the layer will be drawn differently depending on the current scale at which the map is displayed.
Page 171
A layer that gets data from Autodesk MapGuide Server as the user zooms in and out on the map, turns the layer on and off, and so forth. Unlike static lay- ers, which store all of the data for the entire layer in the MWF, dynamic layers download only the data needed for the current view, so the dynamic option is better for layers with large data sets or data that needs to be kept more secure.
Page 172
See map layer. layer group A collection of related map layers. You create layer groups in Autodesk MapGuide Author. legend A key to or an explanation of the symbols in a map, and their meaning or val- ues.
Page 173
Netscape Internet servers, either Netscape FastTrack Server or Netscape Enterprise Server. If you are using one of these Netscape Internet Server as your web server, you can use either the NSAPI or CGI version of the Autodesk MapGuide Server Agent.
Page 174
(or cells), unlike SDF files, which store spatial data as vectors (lines). The ability to overlay vector data on raster data is a key feature of Autodesk MapGuide. For example, you can display a raster image file containing a photograph of a particular area, and then overlay a layer of streets and ZIP code boundaries to help identify landmarks in the photograph.
Page 175
Viewer; and a web server, which works with a web browser to provide access to the Inter- net via the World Wide Web and display the maps sent by Autodesk MapGuide Server. Shift-click A method of selecting multiple, contiguous items in a list by clicking the first item you want to select, and then holding down the Shift key and clicking the last item you want to select.
Page 176
The unit of measurement used in all areas where a distance is specified or dis- played. You can specify that a map use US units or metric units using the Preferences dialog box in Autodesk MapGuide Author or Autodesk MapGuide Viewer. Universal Naming Convention (UNC) The standard method of specifying the full path name of a file.
20 based on values 163 installing 71 combining for polyline layers 161 ActiveX Control version of the Autodesk for layer visibility 157 MapGuide Viewer for map layers 155–162 about 33, 61 for point symbols 159...
Page 178
15 popup menu 121 online help 23 preferences 125 versions of 33 program window 120 Autodesk MapGuide Viewer API, security and 164 serial number 119 Autodesk Onsite 14 starting 119 status bar 132 toolbar 123 Band Interleaf (BIL) files 104...
Page 179
112 DCOM 67 and map authors 19 definitions of terms 169 converting to latitude/longitude 31 demos on the Autodesk MapGuide web site 24 coordinates deploying Autodesk MapGuide, overall strategy zooming to 128 creating Design tab of Map Explorer 130, 149...
Page 180
Autodesk Developer Network (ADN) 25 labels for 163 Autodesk MapGuide documentation 22 measuring distances between 133 Autodesk MapGuide web site 24 new in Autodesk MapGuide Release 5 12 online discussion groups 25 on a map 91 third-party documentation 24 selecting 134...
Page 181
59 point symbols 159 skills for the application developer 20 polygon styles 162 writing applications with 34, 38 polyline styles 161 Java edition of the Autodesk MapGuide Viewer popup menu 150 about 33, 62 priority 148 supporting 59 properties 153...
Page 182
110 MapTips 105, 133 planning 110 and URL links 105 point symbols 159 MDAC 64 polygon styles 162 version required for Autodesk MapGuide polyline styles 161 Server 16 popup menu 150 measuring distances 133 priority 148 memory properties 153...
Page 183
20 your Autodesk MapGuide implementation new Autodesk MapGuide users (getting started) 42, 45–62 your directory structure 46 new features in Autodesk MapGuide Release 5 12 Plug-In version of the Autodesk MapGuide notations, adding to maps 15 Viewer NSAPI...
Page 184
100, 151 Access Keys tab 80 format of 99 Resources tab 81 path to file 99 Users/Groups tab 78 roles in Autodesk MapGuide development 18–21 protocols, standardizing on 53 rotating publishing maps 145 text 110 rotating log files 85...
Page 185
42 creating 32 updating via the map 39 tiled 98 working with 90 tips and tricks on the Autodesk MapGuide web spatial data, acquiring and creating 19 site 24 SQL database toolbar 123 where to store 47...
Page 186
World, ESRI georeferencing files 100 web browser APIs and client-side scripting 38 choosing 59 xy coordinates 112 how it works with Autodesk MapGuide 33 installing and testing 41 scripts 37 web master, responsibilities 20 ZIP codes, zooming to 128 web root zoom 126 and your directory structure 46–48...
Page 187
Instructions 1. Please fill in the form completely. Fill in the release number and serial number for your Autodesk product (Autodesk MapGuide Author, Autodesk MapGuide Server, etc.). Be sure to provide ALL the information about your system, as these specifics are important. For peripherals, specify actual make and model. If the peripheral is emulating another make or model, please note what that is.
Page 188
(on disk), script files, plots, etc. Materials Enclosed Disk Script Letter Print/Plot/Image Autodesk, the Autodesk logo, AutoCAD, and AutoVision are registered trademarks of Autodesk, Inc. All other brand names, product names or trademarks belong to their respective holders.
Page 189
WISHLIST AUTODESK Address Information Please send to: Autodesk, Inc. 111 McInnis Parkway San Rafael, CA 94903 Attn: Wish List You can also submit wishlist items through the Autodesk Web page at www.autodesk.com/wishlist Name Company Date Address Phone number City Extension...
Page 190
We appreciate your interest in our products, and will consider your suggestions in our future product development. Autodesk, the Autodesk logo, and AutoCAD are registered trademarks of Autodesk, Inc. All other brand names, product names or trademarks belong to their respective holders.
Need help?
Do you have a question about the 15606-011408-9320 - MAPGUIDE R6.3 CPU MODEL-UPG 4/5 MIN 2 CPUS INITL and is the answer not in the manual?
Questions and answers