Gettingstarted Guide
Gettingstarted Guide
Getting Started
Autodesk Trademarks
The following are registered trademarks of Autodesk, Inc., in the USA and other countries: 3D Studio, 3D Studio MAX, 3D Studio VIZ, 3ds Max,
ActiveShapes, Actrix, ADI, AEC-X, ATC, AUGI, AutoCAD, AutoCAD LT, Autodesk, Autodesk Envision, Autodesk Inventor, Autodesk Map, Autodesk
MapGuide, Autodesk Streamline, Autodesk WalkThrough, Autodesk World, AutoLISP, AutoSketch, Backdraft, Biped, Bringing information down
to earth, Buzzsaw, CAD Overlay, Character Studio, Cinepak, Cinepak (logo), Civil 3D, Cleaner, Codec Central, Combustion, Design Your World,
Design Your World (logo), EditDV, Education by Design, Gmax, Heidi, HOOPS, Hyperwire, i-drop, IntroDV, Lustre, Mechanical Desktop,
ObjectARX, Physique, Powered with Autodesk Technology (logo), ProjectPoint, RadioRay, Reactor, Revit, VISION*, Visual, Visual Construction,
Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual Survey, Visual Toolbox, Visual Tugboat, Visual LISP, Volo, WHIP!, and WHIP!
(logo).
The following are trademarks of Autodesk, Inc., in the USA and other countries: AutoCAD Learning Assistance, AutoCAD Simulator, AutoCAD
SQL Extension, AutoCAD SQL Interface, AutoSnap, AutoTrack, Built with ObjectARX (logo), Burn, Buzzsaw.com, CAiCE, Cinestream, Cleaner
Central, ClearScale, Colour Warper, Content Explorer, Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids,
DesignProf, DesignServer, Design Web Format, DWF, DWFit, DWG Linking, DXF, Extending the Design Team, GDX Driver, Gmax (logo), Gmax
ready (logo), Heads-up Design, Incinerator, jobnet, ObjectDBX, Plasma, PolarSnap, Productstream, Real-time Roto, Render Queue, Topobase,
Toxik, Visual Bridge, and Visual Syllabus.
GOVERNMENT USE
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer
Software-Restricted Rights) and DFAR 227.7202 (Rights in Technical Data and Computer Software), as applicable.
Published By: Autodesk, Inc.
111 McInnis Parkway
San Rafael, CA 94903, USA
1 2 3 4 5 6 7 8 9 10
Contents
Chapter 1 Fundamentals . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
PDF Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
The Development Process . . . . . . . . . . . . . . . . . . . . . . . . . 4
Sites and Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Component Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Autodesk MapGuide Studio . . . . . . . . . . . . . . . . . . . . . . . . 12
MapGuide Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
MapGuide Web Extensions . . . . . . . . . . . . . . . . . . . . . . . . 16
MapGuide Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Load and Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Feature Sources and Drawing Sources . . . . . . . . . . . . . . . . . . . 22
Load Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Resource Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Feature Joins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Learning MapGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Chapter 3 Exercises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
About the Exercises . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Create a Folder Structure . . . . . . . . . . . . . . . . . . . . . . . . . 42
Load Shapefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
v
Load SDF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Load Geometry from a DWG File . . . . . . . . . . . . . . . . . . . . . 48
Load Styled Data from a DWG File . . . . . . . . . . . . . . . . . . . . 50
Load Raster Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Connect to an Access Database . . . . . . . . . . . . . . . . . . . . . . 54
Set the Style for a Polygon Layer . . . . . . . . . . . . . . . . . . . . . 56
Make Composite Lines . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Define Scale Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Create a New Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Add Layers to a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Create a New Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Theme from a Database Table . . . . . . . . . . . . . . . . . . . . . . . 68
Organize the Layers in a Map . . . . . . . . . . . . . . . . . . . . . . . 70
Edit Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Create a Symbol Library . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Use Symbols for Points . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Generate Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Add Tooltips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Set Up the Map Legend . . . . . . . . . . . . . . . . . . . . . . . . . . 82
View the Map in a Web Browser . . . . . . . . . . . . . . . . . . . . . 84
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
vi | Contents
Fundamentals
1
MapGuide is a software platform for distributing spatial data In this chapter
over the Internet or on an intranet. There are two versions of ■ PDF Tips
■ The Development Process
MapGuide: MapGuide Open Source, and Autodesk MapGuide
■ Sites and Servers
Enterprise. The concepts in this first chapter of the Getting
■ Installation
Started Guide will help you understand and use either version. ■ Component Overview
■ Autodesk MapGuide Studio
The second chapter summarizes the development process in
■ MapGuide Server
the form of a flow diagram. The final chapter provides ■ MapGuide Web Extensions
examples of authoring tasks, which will give you some initial ■ MapGuide Viewer
■ Load and Configure
hands-on experience, using the sample data included on the
■ Feature Sources and
Autodesk MapGuide Enterprise product CD. Drawing Sources
■ Load Procedures
■ Resource Repository
■ Feature Joins
■ Learning MapGuide
1
2 | Chapter 1 Fundamentals
PDF Tips
NOTE This book is in PDF format, which is optimized for viewing on a
high-resolution monitor (preferably set to 1280x1024), and for printing. To read
this guide online, follow these suggestions for the best viewing experience:
■ Close the bookmarks tab (you can easily open it when you need it).
■ Click the Fit Page icon (this gives you two full pages on most monitors).
■ Use the Dynamic Zoom tool to adjust the view so that you can see as much
of the double-page spread as possible without straining your eyes to read
the text.
■ Use the Hand tool to move the page left and right.
■ Use the Page Up and Page Down keys to go forward and back.
Hand tool
Dynamic Zoom tool
Fit Page icon
Bookmarks tab
PDF Tips | 3
The Development Process
The diagram on the facing page shows the process of developing a Web-based
application using MapGuide. In the diagram, the rectangles represent tasks,
the oval shapes represent entities that are created by the tasks or used by them,
and the arrows indicate the flow of data. You can break down the development
process into five phases (you may also have a Planning and Preparation phase,
not included in this diagram):
Place the map on the Internet or intranet using layouts for generating
4 web pages and for plotting.
Develop the web application, using the MapGuide APIs to add func-
5 tionality.
See also Chapter 2, “Flow Diagram” for a more detailed diagram of these
phases.
4 | Chapter 1 Fundamentals
Database Data files
Extend
2
Tasks
Build layers
Resources managed
by the site server
3
Make map
Application elements
(PHP/ASP/JSP) and
HTML
4
Place on internet
Web application
Test
■ The Rendering service creates the final map image for the AJAX viewer
from input provided by the Mapping service.
6 | Chapter 1 Fundamentals
Web server
Site
■ MapGuide Server
■ MapGuide Viewer
You can access detailed information about hardware and software requirements
for installation from the Installation HTML page of the CD browser that
appears when you insert the Autodesk MapGuide Enterprise product CD. Here
is a short summary:
■ MapGuide Server and MapGuide Web Extensions run on both Linux and
Windows.
■ MapGuide Web Extensions run on IIS and Apache (Windows) and Apache
(Windows and Linux).
■ The MapGuide Viewers work with Microsoft Internet Explorer and Firefox
browsers.
The diagram on the facing page shows where to install the different
components of the software.
8 | Chapter 1 Fundamentals
Download
AJAX Viewer
Download
Autodesk DWF Vewer Install Studio
Installation | 9
Component Overview
The diagram on the facing page provides a high-level overview of how the
four components work together after installation. Each component is described
in more detail in the next four topics of this chapter.
Autodesk MapGuide Studio and the MapGuide Viewer are client applications
of MapGuide Server. Requests coming from these clients, and from the other
client applications that you develop using the API, go to the Web Extensions
by means of HTTP protocol. The WebAgent component of the Web Extensions
processes the requests and forwards them on to MapGuide Server. When you
start Autodesk MapGuide Studio, you enter the name or the IP address of the
web server that is hosting the Web Extensions. For example,
http://144.111.19.94/mapguide2008
When it receives a request, MapGuide Server accesses the resources stored in
the resource repository, builds and renders the map in DWF format or as a
static image for the AJAX viewer, and returns it to the Web Extensions, which
in turn send it back to the client.
Autodesk MapGuide Studio has the MapGuide Viewer built into it. The Viewer
displays the rendered data onscreen and manages the layers and other
properties of the data returned from the server.
10 | Chapter 1 Fundamentals
Viewer
Viewer
Viewers Studio
Web Extensions
Services to build
and render map
Component Overview | 11
Autodesk MapGuide Studio
Autodesk MapGuide Studio is an authoring environment that handles all
aspects of collecting and preparing geospatial data for distribution on the
Internet (except custom coding). When you use Autodesk MapGuide Studio,
you will generally follow these steps:
1 Create resources from your source data, either by loading file-based data
or by connecting directly to external databases.
After you have a web layout, you can customize the appearance and functions
of the web application by adding your own programming code. The final step
is to publish the completed web application to the Internet or intranet for
viewing and interaction.
The Autodesk MapGuide Studio interface is divided into three parts:
■ The Editor
When you open Autodesk MapGuide Studio and connect to your site server
(via the WebAgent), the Site Explorer shows you the resources stored in the
resource repository, as shown in the upper image on the facing page.
Double-clicking any resource in the Site Explorer opens the appropriate editor
for that resource. If the resource is a layer or a map, the Viewer also opens and
displays a preview of the data.
12 | Chapter 1 Fundamentals
Site Explorer visible
Map Editor
Preview of map
Preview of layer
Layer Editor with theme
Two views of Autodesk MapGuide Studio
■ Manage your site. For example, you can add and remove servers, or take
them offline for maintenance.
■ Assign services to the servers. For example, one server can process mapping
requests while another handles rendering tasks.
■ Define users and groups and assign roles and access permissions to them.
The illustration on the facing page shows two views of the Site Administrator
program. The upper image shows the home page, which lists the servers in
the site. The lower image shows a typical list of users and the groups that they
belong to.
14 | Chapter 1 Fundamentals
List of servers in the site
Manage Servers selected
MapGuide Server | 15
MapGuide Web Extensions
The MapGuide Web Extensions are internal components which can be accessed
through the Web Extensions API. (There is also a forms-based interface which
you can access: http://servername/mapguide/mapagent/index.html). The Web
Extensions expose the services offered by the MapGuide Server to client
applications over the Internet or an intranet using HTTP protocol. The diagram
on the facing page shows the main sub-components of the MapGuide Web
Extensions.
The WebAgent processes requests coming from clients and passes them to the
MapGuide Server. Two of the clients are Autodesk MapGuide Studio and the
MapGuide Viewer. The WebAgent implements the MapGuide services HTTP
Protocol, which it uses when directing requests to the server. The WebAgent
processes incoming request parameters, establishes a connection to the
appropriate server, and calls the service API(s) required to process the request.
When the service API responds, any data returned from the API is streamed
back to the client.
The OpenGIS Agent implements a number of the OpenGIS web-mapping
protocols to expose the services offered by the MapGuide Server to
standards-based OpenGIS clients.
The MapGuide Web Extensions provide a platform for application
development, based on the services offered by the MapGuide Server. The Web
Extensions API supports three languages/environments: ASP, JSP, and PHP.
For more information, see the Developer’s Guide.
16 | Chapter 1 Fundamentals
WEB EXTENSIONS
Web Server
Server
■ The AJAX viewer (or “zero-client viewer”) does not need a download. It
works with Microsoft Internet Explorer, running on Windows, or with
Internet Explorer or Firefox on other operating systems, such as MacOS or
Linux.
You can customize the appearance of the MapGuide Viewer and select which
toolbar commands you want to use with a template called a web layout. Of
course, you can also add features and functions to the basic layout using your
own program code.
18 | Chapter 1 Fundamentals
Legend showing layers
Toolbar buttons
Task pane
MapGuide Viewer | 19
Load and Configure
Before you can build maps in MapGuide, you must make your source data
available. There are three ways to make source data available:
■ Load any file-based data, such as DWG, SHP, or SDF, onto the MapGuide
site. You can also load raster files.
■ Connect to SDF, SHP, and raster files not loaded into the MapGuide
resource repository.
Load data by converting all, or part of, the source file into a format that
MapGuide can use, and storing it as a resource. For example, you can load all
the layers in a DWG file and create a separate resource for each one.
Connect to SDF, SHP, or raster files without loading them into the MapGuide
resource repository. The files can be located on the same server as MapGuide
or on a different server.
Data stored in a database does not need to be loaded. You simply connect to
it by configuring a data source for it. In this case, the information necessary
to connect to the database is stored as the resource.
If the database is a simple file (Microsoft Access MDB or Microsoft Excel XLS),
Autodesk MapGuide Studio uploads it when you connect to the server. It is
stored on the server as source data for the resource.
MapGuide uses Autodesk and OSGeo FDO providers. An FDO provider is an
implementation of the FDO (Feature Data Objects) API that provides access
to data in a particular DataStore. (For more information about FDO, see the
Open Source Geospatial website at
https://mapguide.osgeo.org/gettingstarted.html.)
Connections to databases are stored as resources in the resource repository
and can be edited just like any other resource.
20 | Chapter 1 Fundamentals
Drag files to Site Explorer
DWG files
Raster files
Points database
Database tables
Loading files and configuring connections to databases
■ Feature sources are the best choice when you simply want to load the raw
geometry and then style or theme it in Autodesk MapGuide Studio.
■ Drawing sources are best when you want to retain any styles or themes
already applied to the source data.
For example, the diagram on the facing page shows four views of a DWG file
in Autodesk Map. The layer containing unstylized polygons (screenshot 1 at
top) is converted to a feature source, because it contains simple geometry. The
Display Manager styles and themes (3 and 4) already have some stylization,
and so they are converted to drawing sources. There is also a polygon layer
that has some stylization (2). In this case, you can choose to convert the layer
either to a feature source (and lose the stylization) or to a drawing source (and
keep it).
22 | Chapter 1 Fundamentals
Layers containing polygons:
feature source
Layers containing
1 colored and hatched
polygons:
drawing source or
feature source
2
Display Manager:
drawing source
Views of a DWG file in Autodesk Map, showing options for converting to feature sources or drawing
sources
24 | Chapter 1 Fundamentals
Drag files to the Site Explorer
SDF files
Raster files
Load procedures for SDF files (top) and raster files (bottom)
Load Procedures | 25
Resource Repository
The resource repository is an XML database that stores the resources created
by loading file-based data or by connecting to databases. There is one repository
per site and it resides on the site server. The diagram on the facing page shows
how the resources are stored in the repository.
Resources are designed to be reused and shared. Some resources reference
other resources. For example, maps and layers are stored as separate resources,
and the map references the layers that are included in the map. Layers reference
feature or drawing sources. When you update the original feature source, the
layer is automatically updated as well.
Other resources, such as print layouts, are self-sufficient and do not reference
any other resources or files. Some resources use associated resource data. For
example, an ArcSDE feature source uses a file which holds the database
credentials. Resource data can be stored as files, streams, or strings.
■ Files are used when the amount of data is large, such as DWF or SDF files.
■ Streams are used for faster access to smaller pieces of binary data, such as
symbols.
■ Strings are used for small pieces of text data, such as database access
credentials.
For information on backing up and restoring the resource repository, see the
document RepositoryAdmin.pdf, installed with MapGuide.
26 | Chapter 1 Fundamentals
Resources
Web layout
Print layout
Resource Data
Layer
Feature sources
Oracle credentials
ArcSDE credentials
file
ODBC credentials
config file
Feature join
Procedure
Resource Repository | 27
Feature Joins
After you have loaded your data or connected to it, you can establish
relationships between any two feature sources. These relationships are called
feature joins. A feature join is saved as a new resource in the repository. When
you join feature sources, you create a feature-join resource, which is similar
to a relational join in a database, except that you are “extending” a feature
resource to create a new one.
The example on the facing page shows how a feature source containing county
boundaries is joined to another feature source containing census population
data, using the following general steps:
■ Enter a name for the extender property (serves as the prefix for the joined
properties, for example, Population).
28 | Chapter 1 Fundamentals
Primary feature source Secondary feature source
Population
Counties - CountyID
- ID - CountyName
- Name - LandArea
- State - WaterArea
- Area - CountyPopulation
Counties
- ID
- Name
- State
- Area
- Population.CountyID
- Population.CountyName
- Population.LandArea
- Population.WaterArea
- Population.CountyPopulation
Joining two feature sources
Feature Joins | 29
Learning MapGuide
MapGuide provides learning materials to get you started using the software,
and complete documentation to serve as a reference.
The Autodesk MapGuide Enterprise Getting Started Guide introduces the most
important concepts in MapGuide. After reading through it, and perhaps doing
some of the suggested exercises using the sample files provided, you should
feel comfortable enough to start working with your own data.
The Autodesk MapGuide Studio User’s Guide is a Help file in CHM format with
a table of contents, an index, and keyword search. You can print out the Help
topics that interest you.
MapGuide Server Site Adminstrator Help is a set of HTML pages that you can
access from the Site Administrator program.
The MapGuide Developer’s Guide is a book in PDF format that covers all topics
related to developing Web-based applications using the APIs provided with
MapGuide. It includes many practical examples with sample code that you
can copy and use.
The MapGuide Web API Reference and Studio API Reference are HTML pages.
They contain detailed information about all the APIs and include many code
samples.
The MapGuide Sample Application is a web application, written in PHP, that
demonstrates many of the features and services provided by the MapGuide
Server APIs.
30 | Chapter 1 Fundamentals
The phrase you searched for is highlighted.
List of classes
MapGuide Studio API Reference (bottom) and Studio User’s Guide (top)
Learning MapGuide | 31
32 | Chapter 1 Fundamentals
Flow Diagram
2
The detailed flow diagram in this chapter summarizes the
3, “Examples.”
33
34 | Chapter 2 Flow Diagram
P H A S E 0: P L A N N I N G
Set up site
Install software
Configure services
| 35
P H A S E 1: L O A D A N D C O N F I G U R E
Load files
SHP files
SDF files
DWF files
DWG layers
DWG elements
Raster files
Connect to databases
ODBC
Oracle
ArcSDE
1 Style layers
Generate labels
P H A S E 3: M A K E A M A P
Organize layers
Generate a legend
| 37
P H A S E 4: P L A C E O N I N T E R N E T
View in browser 5
39
■ Create a Symbol Library
■ Use Symbols for Points
■ Generate Labels
■ Add Tooltips
■ Set Up the Map Legend
■ View the Map in a Web
Browser
40 | Chapter 3 Exercises
About the Exercises
The following exercises are laid out on facing pages. The steps are on the
left-hand page with matching illustrations on the right-hand page. The
illustrations provide a summary of the task while the text includes the detailed
steps for the exercise. The large red numbers relate the two pages.
It is recommended that you read the text carefully the first time you do these
exercises and use the illustrations to confirm that your results are correct.
Later, you may find it useful to print out this chapter and use the illustration
pages as a quick reference to common tasks.
42 | Chapter 3 Exercises
Creating the Recommended Folder Structure
1
Create a root folder
Create a subfolder
3
Repeat to create structure
44 | Chapter 3 Exercises
Loading Shapefiles
Drag files
to folder
Specify load
procedure
3
Load resources
Load Shapefiles | 45
Load SDF Files
In this exercise, you add more data source files to the site. Like SHP files, you
load SDF files by dragging them directly into a folder in the Site Explorer.
46 | Chapter 3 Exercises
Loading SDF files
Drag files
to folder
Specify load
procedure
3
Load Resources
48 | Chapter 3 Exercises
Loading Geometry From a DWG File
Drag file
to folder
3
Load Resources
50 | Chapter 3 Exercises
Loading Styled Data From a DWG File
Drag file
to folder
3
Load Resources
2 Select the four TIF files in the folder. Drag the files to
the Sheboygan Public folder in the Site Explorer.
52 | Chapter 3 Exercises
Loading Raster Files
Drag files
to folder
Specify load
procedure
3
Load Resources
54 | Chapter 3 Exercises
Connecting to a Microsoft Access Database
Select ODBC
provider
2
Specify connection
string and upload file
3
Save, then
test connection
3 Click OK.
56 | Chapter 3 Exercises
Setting a Style for Polygons
2
Set the style
3
Save the layer
58 | Chapter 3 Exercises
Making Composite Lines
2
Set the style
3
Save the layer
60 | Chapter 3 Exercises
Defining Scale Ranges
2
Define scale ranges
3
Test scale ranges
and save the layer
62 | Chapter 3 Exercises
Starting a New Map
2
Specify the
properties
of the map
3
Save the map
64 | Chapter 3 Exercises
Adding Layers to a Map
2
Drag layers
3
Preview and
then save
the map
66 | Chapter 3 Exercises
Reference Data in a New Layer
2
Select the data
resource and preview
3
Save the layer
5 For Style Ramp, click the Browse button and then, for
Foreground Color, select yellow and red for the start
and finish colors. Click OK.
68 | Chapter 3 Exercises
Theming from a Database Table
2
Select the property and
set up the theme
3
Test and then save
the layer
1 Click the Drawing Order tab, then use the arrow but-
3 tons to move the layers into the order shown in the
illustration, with the layer Images at the bottom and
treepoints at the top.
70 | Chapter 3 Exercises
Organizing the Layers in a Map
2
Drag layers to
layers list
3
Set draw order and
make layer groups
72 | Chapter 3 Exercises
Editing the Style of the Layers
Edit Hydrographic
Polygons
and save. Scale range = 0-30000
2
Scale range = 0-10000
Edit buildingsNEW
and save.
3
Edit treepoints and save.
Result in
Map Editor:
Styled layers
Edit Layers | 73
Create a Symbol Library
In this exercise, you create a new symbol library. You will use one of the
symbols from it in the next exercise.
2 Click New.
74 | Chapter 3 Exercises
Creating a Symbol Library
2
Select the files to
include
in the library
3
Save the symbol
library
76 | Chapter 3 Exercises
Using Symbols for Points
2
Select the symbol
3
Save the layer
78 | Chapter 3 Exercises
Generating Labels
2
Select the property to use
as a label
3
Test and then save
the layer
Generate Labels | 79
Add Tooltips
In this exercise, you select properties to display in Tooltips. Tooltips are pop-up
boxes that contain information about the features in the map.
3 Click New.
5 Click New.
7 Click OK.
The completed expression is displayed in the Settings
panel.
80 | Chapter 3 Exercises
Adding Tooltips
2
Select the properties
to display
3
Test and then
save the layer
Add Tooltips | 81
Set Up the Map Legend
In this exercise, you specify how you want the legend to appear. Some layers
are initially turned on while others are turned off. You will be able to view
the legend in the Web browser in the next exercise.
3 Click the Layers By Group tab and make sure that the
Parcels (Area) layer is still selected. Clear the check-
boxes for Layer Is Initially Displayed In The Map and
Layer (If Themed) Is Initially Expanded.
The layer will be turned off when the map is displayed
in the viewer and the color-key for the theme will not
be expanded.
82 | Chapter 3 Exercises
Setting Up the Legend for the Map
Double-click Sheboygan
City Map
2
Specify which layers
are visible
3
Preview and then
save the map
1 Click File ➤ Save and save the Web layout in the Web
3 Layout folder with the name City Map.
You need to save the Web layout before you can test
it in the browser.
84 | Chapter 3 Exercises
Viewing the Map in a Web Browser
2
Select the map
to use
3
Save the web layout
and then test
blocks In AutoCAD or Autodesk Map, compound objects that have been saved
for reuse in the drawing or in multiple drawings, for example, a North arrow.
In MapGuide, blocks are converted into symbols when they are loaded. See
also symbol.
CD Browser The program that appears when you insert the product CD, and
which provides access to installation instructions and other information.
Display Manager In Autodesk Map, the component that handles the styling
and theming of features in a DWG file.
Display Manager element A set of features that has been assigned a specific
style or theme in Display Manager and which can be selected individually for
loading into Autodesk MapGuide Studio.
Drawing service The service that allows low level access to DWF data stored
in a resource repository as part of a drawing source.
Glossary | 87
drawing source One of the two types of resources created by loading file-based
data. Drawing sources are stored in the repository in DWF format and retain
any styles or themes already applied to the source data. Compare with feature
source.
drive alias In Autodesk Map, the mechanism that points to the folder where
attached DWG files are stored.
DWF Design Web Format. An Autodesk file format for sharing 2D, 3D, and
spatially-enabled design data.
DWF Viewer The free viewer for the DWF file format. The DWF Viewer can
be used to preview layers and maps in Autodesk MapGuide Studio and to
display the completed map in MapGuide Viewer.
DWG The Autodesk file format for storing 2D, 3D, and spatially-enabled
design data.
FDO Feature Data Objects. An Autodesk software standard and general purpose
API for accessing features and geospatial data regardless of the underlying data
store. See also feature, feature class.
FDO provider An implementation of the FDO API that provides access to data
in a particular data store, such as an Oracle or ArcSDE database, or to a
file-based data store, such as SDF or SHP.
feature join A relationship that joins one feature source to another, similar
to a relational join in a database.
88 | Glossary
Feature service The service that allows low level access to SDF 3 data stored
in a resource repository as part of a feature source.
feature source One of the two types of resources created by loading file-based
data or by connecting to a spatial database. Feature sources are stored in the
repository in SDF 3 format or as database connections and contain raw
geometry only. Compare with drawing source.
layer A resource that references a feature source or a drawing source. The layer
contains styling and theming information, and a collection of scale ranges.
Load procedure A saved script for reloading file-based data. You can use load
procedures to automate the updating of resources on the server. They capture
the location of the source files, the conversion rules, and where to put the
resulting data on the server.
map A resource that references a collection of layers and displays them within
a consistent coordinate system and extents.
MapGuide A software platform for distributing spatial data over the Internet
or on an intranet. Exists in two versions: Open Source (supported by the
community) and Enterprise (supported by Autodesk). (www.osgeo.org)
Mapping service The service that creates the view of a map in response to
requests from the clients.
Glossary | 89
OpenGIS Agent The component of the MapGuide Web Extensions that
implements a number of the OpenGIS web-mapping protocols to expose the
services offered by the MapGuide Server to standards-based OpenGIS clients.
package A compressed file that can speed up the process of loading data onto
the server. Large source-data files can be zipped up in this file format and
saved to a network location or copied to a CD.
raster catalog A list of image files and their lower-left and upper-right
coordinates. MapGuide scans the catalog file to find the images that correspond
to the area being viewed, and then sends only the data for that area.
reference point For a symbol, the point that controls the position of a symbol
over a feature in a map. The default reference point is the center of the symbol.
Rendering service The service that creates the final map image for the HTML
viewer from input provided by the Mapping service.
SDF (SDF 3) Spatial Database Format. The current version of the SDF format.
It is the native format for MapGuide Enterprise and MapGuide Open Source
and is new in Autodesk Map 3D 2007. Each SDF 3 file can contain multiple
feature classes or types of data stored in tables with attributes and geometry.
90 | Glossary
SDF 2 The previous version of the SDF file format. It was the native file format
for Autodesk MapGuide (the last release was Autodesk MapGuide 6.5). Each
SDF 2 file generally contained one feature or type of data, for example points,
lines, polygons, or text.
services The software modules that reside on the MapGuide Server and which
implement its core functions. See also Site service, Resource service, Drawing
service, Feature service, Mapping service, Rendering service, and Tile service.
sheet In a DWF file, a plot layout containing a specific view of the original
data.
Site Explorer The tree view in Autodesk MapGuide Studio that shows you
the resources stored in the resource repository.
Site service The service that provides basic site-related functionality, such as
enumerating users and creating user sessions.
styling The process of assigning display characteristics (such as line color, line
pattern, fill color, fill pattern, and so on) to a feature (points, polylines,
polygons). See also theming.
symbol lbrary A collection of related symbols. Image files are converted into
symbols when they are brought into the symbol library. The symbol library
is stored in the resource repository.
task bar In MapGuide Viewer, a pane that contains tools and controls for
specific tasks, such as searching or buffering.
Glossary | 91
Tile service The service that supports smooth pans and zooms in the AJAX
viewer.
tooltips Pop-up boxes that contain information about the features in the map.
web surround The extra functionality that is automatically built for a web
layout, which resides outside of the map itself.
92 | Glossary
Index
A
Access database, connecting to
D
(exercise) 54 data conversion during load 22
add layers to a map (exercise) 64 databases 20, 28, 68
add tooltips (exercise) 80 configure connections 20
API Reference, description of 30 relationships 28
authoring maps 12 supported by providers 20
Autodesk Map 22 theming from (exercise) 68
styles and themes 22 upload file 20
automating update of source data 24 define scale ranges (exercise) 60
Developer’s Guide, description of 30
B development process 4–5, 33
flow diagram 33
backing up the resource repository 26 overview 5
building maps, steps for 12 phases of 4
summary diagram 4
Display Manager 22
C documentation, list of 30
CD browser 8 drawing sources, definition of 22
client applications 10, 16 DWF Viewer 10, 12
components 8, 10–12, 14, 16, 18 used by Studio and Viewer 10
diagram of 11 used for preview 12
overview of 10 DWF, as rendered map 10
Server 14 DWG file, styles and themes in 22
Studio 12 DWG geometry, loading (exercise) 48
Viewer 18 DWG styled data, loading (exercise) 50
Web Extensions 16
where to install 8 E
composite lines, making (exercise) 58
concepts 30 edit layers (exercise) 72
learning 30 exercises 39, 42, 44, 46, 48, 50, 52, 54,
configure connections to databases 20 56, 58, 60, 62, 64, 66, 68, 70, 72,
connect Access database (exercise) 54 74, 76, 78, 80, 82, 84
connecting to databases 20 add layers to a map 64
connections to databases 20 add tooltips 80
create a folder structure (exercise) 42 connect to an Access database 54
create a new layer (exercise) 66 create a folder structure 42
create a new map (exercise) 62 create a new layer 66
create symbol library (exercise) 74 create a new map 62
create a symbol library 74
Index | 93
define scale ranges 60 H
edit layers 72
generate labels 78 Help system, introduction to 30
load DWG geometry 48 HTML viewer 10, 18
load DWG styled data 50 compatibility 18
load raster files 52 static image for 10
load SDF files 46 HTTP protocol 16
load SHP files 44
make composite lines 58
organize layers 70
I
overview of 39 installation, where to find steps 8
set style for a layer 56 interface, Autodesk MapGuide Studio 12
set up the legend 82 Internet Explorer browser 18
theme from a database 68 IP address, log into Studio 10
use symbols for points 76
view in Web browser 84
L
F labels, generating (exercise) 78
layer style, setting (exercise) 56
FDO (Feature Data Objects) 20 layers 26, 64, 66, 70, 72
definition of 20 adding (exercise) 64
providers 20 as resources 26
FDO providers 20 create new (exercise) 66
feature join 28–29 editing (exercise) 72
definition of 28 organizing (exercise) 70
diagram of 29 learning MapGuide 30
feature sources 22, 28 legend, setting up (exercise) 82
definition of 22 Linux 8, 18
joining 28 components that run on 8
files 20, 22, 26 supported browser 18
conversion process 22 load 20, 22
database 20 conversion process 22
in resource repository 26 data from files 20
Firefox browser 18 load and configure, diagram 21
flow diagram 33 load DWG geometry (exercise) 48
folder structure, creating (exercise) 42 load DWG styled data (exercise) 50
formats, optimized for Web 22 load procedures 24–25
definition of 24
G screenshots of 25
load raster files (exercise) 52
generate labels (exercise) 78 load SDF files (exercise) 46
Getting Started Guide 1, 30 load SHP files (exercise) 44
overview of contents 1 log in 10, 14
suggested use 30 to Site Adminstrator 14
to Studio 10
94 | Index
M definition of 26
diagram of 27
MacOS 18 resources 6, 12, 20, 26, 28
making composite lines (exercise) 58 and site server 6
map authoring 39 database connection 20
tutorials for 39 relationships between 28
MapGuide 1, 8, 30 reuse and sharing of 26
components of 8 view of 12
introduction to 1 restoring the resource repository 26
learning 30
sample application 30
Mapping service, definition of 6
S
maps 10, 12, 62 sample application 30
authoring 12 scale ranges, defining (exercise) 60
creating (exercise) 62 screenshots 13, 15, 19, 25
rendered in DWF format 10 load procedures 25
Site Administrator 15
O Studio 13
Viewer 19
OpenGIS Agent 16 scripts for reloading data 24
organize layers (exercise) 70 SDF files, loading (exercise) 46
Server 10, 14, 16
and client requests 10, 16
P and Site Adminstrator 14
PDF tips 3 and Web Extensions 16
phases of development 4–5, 33 overview of 14
flow diagram 33 servers 14
summary diagram 4 managing 14
programming 12, 16 services 6, 14, 16
adding to Web layout 12 and Web Extensions 16
languages supported 16 assigning to servers 6, 14
providers, FDO 20 list of 6
providers, for database support 20 set layer style (exercise) 56
set up the legend (exercise) 82
sharing resources 26
R SHP files, loading (exercise) 44
site 6–7, 14
raster files, loading (exercise) 52 definition of 6
refreshing source data 24 diagram of 7
relationships, database 28 managing 14
Rendering service, definition of 6 Site Administrator 14–15, 30
requests from clients to server 10, 16 documentation for 30
resource repository 6, 12, 26–27 purpose of 14
and Site Explorer 12 screenshots of 15
and site server 6 Site Explorer, purpose of 12
backing up 26
Index | 95
site server 6, 10, 26 Viewer 10, 16, 18–19
and resource repository 26 as client application 10, 16
connecting to 10 compatibility 18
definition of 6 flavors of 18
source data 22, 24 overview of 18
conversion during load 22 screenshots of 19
refreshing 24
static image, HTML viewer 10
streams, in resource repository 26
W
strings, in resource repository 26 Web browser 8, 14, 18, 84
Studio 10, 12–13, 16 and Site Administrator 14
as client application 10, 16 and viewer compatibility 8
overview of 12 and Viewer component 18
parts of 12 Firefox 18
screenshots of 13 Internet Explorer 18
styles and themes, retain from DWG viewing in (exercise) 84
file 22 Web Extensions 8, 10, 16–17
symbol library 74, 76 and client requests 10, 16
creating (exercise) 74 diagram of 17
using (exercise) 76 languages supported by 8
overview of 16
T Web layout 12, 18
and programming 12
template for Web layout 18 for customizing Viewer 18
theme from a database (exercise) 68 steps to build 12
tooltips, adding (exercise) 80 WebAgent 10, 16
tutorial exercises 39 purpose of 10, 16
Windows, components that run on 8
U
X
use symbols for points (exercise) 76
User’s Guide, description of 30 XML database, for resource repository 26
users and groups 14
Z
V
zero-client viewer 18
view in Web browser (exercise) 84
96 | Index