Envinsa
®
Version 4.1
MAP MANAGEMENT GUIDE
Information in this document is subject to change without notice and does not represent a commitment on the part of the vendor or its representatives. No part of this document
may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, without the written permission of MapInfo Corporation,
One Global View, Troy, New York 12180-8399.
© 2007 MapInfo Corporation. All rights reserved. MapInfo, the MapInfo logo and Envinsa are trademarks of MapInfo Corporation and/or its affiliates.
MapInfo Corporate Headquarters:
Phone: 518 285 6000
Fax: 518 285 6070
Sales: 800 327 8627
Government Sales: 800 619 2333
Technical Support: 518 285 7283
www.mapinfo.com
MapInfo UK and EMEA Headquarters:
Phone: 44 1753 848200
Fax: 44 1753 621140
Technical Support: 44 1753 848229
www.mapinfo.co.uk
MapInfo Asia Pacific Headquarters:
Phone: 61 2 9437 6255
Fax: 61 2 9439 1773
Technical Support: 61 7 3844 7744
www.mapinfo.com.au
Contact information for all MapInfo offices is located at: www.mapinfo.com/contactus.
Adobe Acrobat® is a registered trademark of Adobe Systems Incorporated in the United States.
Products named herein may be trademarks of their respective manufacturers and are hereby recognized. Trademarked names are used editorially, to the benefit of the trademark
owner, with no intent to infringe on the trademark.
February 2007
Table of Contents
Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
About the Map Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
What is the Map Manager? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Map Manager Within the Envinsa Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Enterprises and Domains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Secure Access to Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Remote Access and Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Adding Envinsa Content Layer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Getting Started with the Map Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Setting User Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Allow Named Maps to be Accessed Remotely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Running the Map Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Knowing the Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Common Tasks Performed with the Map Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
How do I Modify the Display of my Basemap?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
How do I Create a Custom Style? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
How do I Customize my Route Styles? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Chapter 2: File Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Named Resource Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Named Resource File Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Working with the Directory Structure and Multiple Enterprises. . . . . . . . . . . . . . . . . .18
Multiple Country Support for MapDisplay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
3D Map Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Updating Windows Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
User Roles and the File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Chapter 3: Creating and Editing Map Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 22
Creating a Map Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Manipulating Layers with Map Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Zoom In Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Zoom Out Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Table of Contents
Pan Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Ruler Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Info Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Selection Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Other Map Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Layer Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Layer/Theme Visibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Layer Selectability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Autolabeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Reordering Layers and Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Ordering Objects in a Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Adding Layers: Add Layer Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Editing Layers: Edit Layer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Removing Layers and Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Theme Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Save Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Display Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Label Button. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Display Options via Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Zoom Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Style Override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Labelling Options via Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Label Text Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Label Visibility Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Label Position Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapter 4: Managing Named Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Managing Named Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Named Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Named Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Named Renditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Named Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Chapter 5: Creating and Managing Named Connections . . . . . . . . . . . . . . . . . . . 49
What are Named Connections? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Security Benefits of Named Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Creating a Named Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using a Named Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Chapter 6: Using Brush, Font, and Symbol Styles . . . . . . . . . . . . . . . . . . . . . . . . 53
Pen and Brush Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Introduction
Welcome to the Map Management Guide for the MapInfo® Envinsa™ Location
Platform. This is written for administrators or developers who want to customize
content and style of maps produced in Envinsa.
In this section:
Š
Š
Š
About the Map Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Getting Started with the Map Manager . . . . . . . . . . . . . . . . . . . . . . .8
Common Tasks Performed with the Map Manager . . . . . . . . . . . .13
1
About the Map Manager
About the Map Manager
This section gives background and context to the role the Map Manager plays in the Envinsa
Location Platform. The Map Manager is aimed primarily to help an administrator or developer who
needs to work with the Presentation, WMS, and Routes Services to add styles, colors, and other
visual attributes to maps.
What is the Map Manager?
The Map Manager is a graphical user interface that allows you to manage various aspects of your
map styles. The Map Manager is run as an application, either locally or remotely. You can use the
Map Manager to:
•
•
•
Manage and configure map layers (Map Definitions).
Manage named resources, including maps, layers, and renditions (Named Resources).
Setup connections to your data (Connections Manager).
The Map Definitions section allows you to build your map’s look and feel. From this section of the
Map Manager you can:
•
•
•
•
•
Load and save map layers in two formats: .mdf (Map Definitions) or .gst (Geosets).
Add map layers from a file or named resource and edit their property settings.
Pan and zoom, change display and label settings.
Rearrange the order of layers that will appear in the map.
Create thematic layers, and save all settings for loading into your application whenever
necessary.
The Named Resources section is the location for managing resources that have been given a
unique name or alias. Here you can create named maps and named layers, and access your
customized named renditions (styles). These named resources are most often used in Envinsa.
Named maps and styles allow you to define map display, map overlays, and thematic renditions in
the Presentation Service.
The Connection Manager allows you to access data from remote sources for map rendering and
analysis. Here you can use named connections and connection pooling as an efficient way to
retrieve remote data.
Map Manager Within the Envinsa Framework
By creating and managing your named resources using the Map Manager, you enable the Envinsa
services to access these resources. All of the web services have access to the same Map Manager
Domains. This means that if one service makes updates to the data, all the other services will see
this change.
Domains are created within Enterprises that are set up by your Envinsa Administrator. Enterprises
provide a way of assigning users access only to certain information. This keeps information secure,
and accessible only by those who have been explicitly assigned to it. Any number of Domains can
be set up within Enterprises to further group types of information together. For example, Domains
may be created for each department in an organization, or for each team working on a different
project. How these Enterprises and Domains are set up will be unique for your organization. For
more information on Enterprises and Domains, refer to Enterprises and Domains.
6
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 1: Introduction
Enterprises and Domains
The Map Manager uses the concepts of Enterprises and Domains. When a user account is created
in the Enterprise Manager, it is assigned to a specific Enterprise. This allows the user to access
Domains within that specific Enterprise, and may be used to limit the access to the information within
the Enterprise to which they belong.
Domains are created within Enterprises to further organize information into groupings. For example
each Enterprise may require several sub-groups such as Sales, Marketing, and Accounting
departments. Each of these departments could be represented by different Domains. Different user
accounts have different access to Domains depending on their account privileges. See User Roles
and the File Structure on page 20 for more information on user roles in the Map Manager.
The user must have a username and password in order to use Map Manager. The list of authorized
users is maintained by the Enterprise Manager. The Map Manager has a login dialog box to
authenticate the user. User authentication allows the Administrator to support multiple Enterprises
concurrently. Each Enterprise can have its own private named resources. These resources are
filtered according to the user access.
Refer to the Administration Guide for information on creating user accounts and managing
Enterprises and Domains.
Secure Access to Resources
An important feature in the Map Manager is the ability to grant or deny access to certain resources
within an Enterprises or Domain. Used in conjunction with the user account roles, created using the
Enterprise Manager, you can control who has access to these Enterprises and Domains, and the
individual resources within those Domains. See User Roles and the File Structure on page 20 for
more information.
See Setting User Authentication on page 8 for instructions on how to initialize user authentication
in the Enterprise Manager.
Layer Control
Layer Control gives you the power to control the display of your maps. Its options enable you to
display, remove, add, edit, select, zoom layer, and label your layers. You can also change the order
of map layers and themes.
For more information on the layer control capabilities of Map Manager, see Layer Control on
page 31.
Remote Access and Management
The Map Manager can be run locally or remotely as an Java applet. This allows you to access and
administer named resources (named maps and styles) from a remote machine. See Running the
Map Manager on page 10 for steps to run the Map Manager locally or remotely.
There are limitations to the Map Manager when running remotely:
•
•
Supported browsers include Internet Explorer 5.x or later, and Netscape 4.x or later.
The Connections Manager is not available when working remotely.
7
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Getting Started with the Map Manager
Adding Envinsa Content Layer
The Map Manager allows you to add an Envinsa Content Layer (also known as CM Layer) to the
map. This procedure is managed by the Add Layer Wizard. See Creating a Map Definition on
page 23.
Getting Started with the Map Manager
This section describes how to setup, run, and familiarize yourself with the Map Manager. An
important feature of the Map Manager is user authentication. This section will show you how to turn
on the user authentication using the Enterprise Manager.
The Map Manager can be run locally or remotely. This section will show you how to run the Map
Manager in both forms.
Finally, this section will show you the Map Manager interface, and allow you to familiarize yourself
with the tool so you can effectively use the Map Manager capabilities.
Setting User Authentication
Before using the Map Manager, we recommend you initialize User Authentication in the Enterprise
Manager, which allows users to access resources based on their Enterprise, Domain, and access
privileges.
Note: If User Authentication is not initialized for the Map Manager, all users can access and modify
the resources defined in the PUBLIC Enterprise.
To initialize User Authentication for the Map Manager:
1. Start the Enterprise Manager.
2. Log into the Enterprise Manager as the administrator.
3. Select the Map Manager component (under the Indentifier column).
4. From the View menu choose User>Access Control
5. From the Message Namespace menu select BASIC.
6. Make sure that Security is selected.
7. Select Authentication in the Request section.
8. Save your changes by pressing the Set button at the bottom.
9. Exit the Enterprise Manager.
See the Administration Guide for more details on using the Enterprise Manager and User Accounts.
8
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 1: Introduction
Allow Named Maps to be Accessed Remotely
Included with the Map Manager is a script utility that must be run by the administrator to allow
remote users of the Map Manager to load named maps containing local layers. If the utility is not run,
the remote users cannot load the named maps that contain these local layers. This utility converts
the named map definition by adding a remote Map Manager reference to TAB layers only.
Note: We recommend that you backup the named resource directories that you are modifying
using the utility.
To run the utility: Navigate to your Map Manager directory (<PlatformDomain>\MapManager\) and
run the convertNamedMap.bat (Windows) or convertNamedMap.sh (UNIX) file.
Usage:
convertNamedMap [named_res] [new_named_res] [-all] -dir directory mapmanager URL [-trace]
Parameter
Description
-all
Convert all Named Maps in the specified directory
-dir
Directory where Named Maps are located
-mapmanager <URL>
Map Manager URL
-trace
Show trace
The Map Manager URL is in the form:
http://<Hostname>:<Portnumber>/MapManager
The following are examples conversions of named maps using the utility:
•
Convert all Named Maps in the
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC directory.
convertNamedMap -all -dir
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC -mapmanager
http://pollux:8080/MapManager -trace
•
Convert the world Named Map in the
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC directory using the
same name for the converted map.
convertNamedMap world -dir
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC -mapmanager
http://pollux:8080/MapManager
•
Convert the world Named Map and rename to world1 in the
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC directory. Note the
original world Named Map is unchanged.
9
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Getting Started with the Map Manager
convertNamedMap world world1 -dir
D:\envinsa40\domain\NamedResource\namedResources\PUBLIC -mapmanager
http://pollux:8080/MapManager
Running the Map Manager
The Map Manager is fully configured and ready to run when installed with Envinsa. The Map
Manager can be run two ways: Locally or remotely.
To start the Map Manager application locally:
1. Ensure the web server where the Map Manager has been installed is running.
Note: To use Map Manager, you must have the servlet running. Map Manager will not run in a
standalone mode.
2. Go to the Map Manager directory (<PlatformDomain>\MapManager\) and start the Map Manager
from the EnvinsaMapManager.sh file on UNIX or the EnvinsaMapManager.bat file on Windows.
3. Log into the Map Manager using the administrator account created in the Enterprise Manager
(this is usually the same login as Enterprise Manager).
To start the Map Manager applet remotely:
1. Ensure the web server where the Map Manager has been installed is running.
2. Launch a web browser.
3. Enter the web address for the remote Map Manager. Do not use localhost for the hostname
when loading the Map Manager remotely.
http://<Hostname>:<Portnumber>/MapManager
•
Log into the Map Manager using the administrator account created in the Enterprise Manager
(this is usually the same login as Enterprise Manager).
10
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 1: Introduction
Knowing the Interface
The Map Manager has a rich user interface, allowing you to perform many actions through buttons
and menus. You can also browse resources and edit resources in the various panels. This section
provides an overview of the Map Manager’s panels, toolbars, and menus.
The Map Manager is divided into three main sections: Map Definition, Named Resources, and
Connection Manager.
Map Definitions
The Map Definitions panel is the location where you build your map’s look and feel. Here you can
load existing basemaps, layers, or styles and customize these map definitions for use in the
Presentation, WMS, or Route services.
11
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Getting Started with the Map Manager
Named Resources
In the Named Resources pane, the tree-like structure on the left hand side of the console allows you
to browse through your named resources and manage these at an Enterprise level. Here you can
manage, create, or modify named maps, layers, and styles. Named maps are the most often used
resources in Envinsa. These are generally used to define the map display in the Presentation
Service. Named styles are important to stylize your maps, often used for map overlays or thematic
mapping.
12
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 1: Introduction
Connections Manager
The Connection Manager allows you to create Named connections to databases required for
creating or stylizing your maps. These named connections are pre-started and pooled with Envinsa
to make them available for immediate use by a client application.
Common Tasks Performed with the Map Manager
How do I Modify the Display of my Basemap?
There are various edits that can be performed on a map style and map definition. If you are using a
basemap and you would like to add a layer, change a style for an existing layer, or change a zoom
level for a given layer, the following sections of this guide will provide you with the steps to perform
these tasks:
•
•
•
For adding a new layer, see Creating a Map Definition on page 23.
For changing a style, see Style Override on page 37.
For changing the zoom level, see Display Options via Layer Control on page 36.
How do I Create a Custom Style?
An important part of customizing your maps is to use custom styles or icons. The Map Manager
allows you to create a custom style that can be used to show a company logo for their store on a
map, or change the start and end pin icons to create a custom style for routing. The following
sections of this guide will provide you with the steps to perform these tasks:
•
•
To create a custom style, see Saving New Named Styles on page 39.
To assign a custom style, see Overriding with a Custom Style on page 38
13
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Common Tasks Performed with the Map Manager
How do I Customize my Route Styles?
An important use of the Map Manager is to customize the display of routes on your maps. There are
generally three tasks users perform to customize the route: Change the line style for a route, change
the start and end pins for a route, and display an ordered set of numbers for the stop points or way
points for a route.
Line Style
To change the line style for your routes:
1. You need to customize the routeLineStyle Named Rendition (or custom style if you are already
using one) in the PUBLIC or your Enterprise named resource directory for your Named Map or
basemap.
2. In the Named Resource panel select the routeLineStyle (or custom style) and click the Create A
New Style... button.
3. Click on the current style in the Resources: section of the panel.
4. The current display settings for that style will appear. Select the Pen tab, and modify the line
style you want for your new route. You can modify the stroke, color, thickness and opacity.
5. Once you have the style set, click Save.
6. You are asked if you want to replace the existing style. Click Yes.
7. The new style will be saved once you click OK in the Style Saved dialog box.
Start and End Pins
To change the start and end pins for your routes:
1. You need to customize the routeEndPointStyle and routeStartPointStyle Named Renditions (or
custom style if you are already using one) in the PUBLIC or your Enterprise named resource
directory for your Named Map or basemap.
Note: You can only change one style at a time.
2. Copy your new pin images (transparent gifs) into the PUBLIC or your Enterprise symbols
directory.
3. In the Named Resource panel select the routeEndPointStyle or routeStartPointStyle (or custom
styles) and click the Create A New Style... button.
4. Click on the current style in the Resources: section of the panel.
5. The current display settings for that style will appear. Select the Symbol tab, and locate your new
image using the Image URL... button. You can modify the image appearance using the tools
provided.
6. Once you have the style set, click Save.
7. You are asked if you want to replace the existing style. Click Yes.
8. The new style will be saved once you click OK in the Style Saved dialog box.
14
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 1: Introduction
Ordered Numbers for Way Points
By default the Route Service is configured to use the ViaPoint1, ViaPoint2, and so on (ViaPointN)
styles for stop or way points when creating a route map, and you have specified to show via points.
In the Route Service you can specify the value of the prefix for the via point map style. For example,
if you create new styles MyStyle1, MyStyle2, and so on, you can specify the value MyStyle prefix in
the route map request, and the route service will use the correct numbered style associated with the
way point.
To create an ordered set of numbers which correspond to stops along your routes:
1. Customize the existing ViaPoint styles, these are located in the PUBLIC named resource
directory.
2. Copy your new numbered images (transparent gifs) into the PUBLIC or your Enterprise symbols
directory.
Note: You will have to perform the following steps for each ViaPoint style.
3. In the Named Resource panel select the ViaPoint1 style and click the Create A New Style...
button.
4. Click on the current style in the Resources: section of the panel.
5. The current display settings for that style will appear. Select the Symbol tab, and locate your new
image using the Image URL... button. You can modify the image appearance using the tools
provided.
6. Once you have the style set, click Save.
7. You are asked if you want to replace the existing style. Click Yes.
8. The new style will be saved once you click OK in the Style Saved dialog box.
15
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
File Management
The MapInfo® Envinsa™ Location Platform provides a named resource
repository, where all base maps, layers, styles, symbols, and grid files are
located and can be organized by users, Domains, organizations, or countries.
This repository allows these files to be shared by multiple owners, services
(Presentation and WMS), and remote or local Map Managers. This section
describes the repository and file system created by the Envinsa Location
Platform installation, and shows you how to manage both your files and user
accounts.
In this section:
Š
Š
Š
Named Resource Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Named Resource File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . .17
User Roles and the File Structure. . . . . . . . . . . . . . . . . . . . . . . . . .20
2
Chapter 2: File Management
Named Resource Repository
The Presentation, WMS, and Route services use named resources to reference base maps, layers,
styles, and grid files. The named resources are in their own resource component, and local and
remote Map Managers are provided for resource management.
The advantages of the separate named resource component are:
•
•
•
•
The named resources can be deployed individually, and can be shared by multiple Presentation,
WMS, and Route services.
Named resources can be managed both locally or remotely.
An Enterprise can have a single repository of named resources for multiple countries and
multiple services.
The users don't have to change the Domain when upgrading the services.
Named resources are simply map components (layers, basemaps, features, styles, etc.) that can be
accessed by name. The following diagram shows the relationship between the named resource
component and other components:
Named Resource File Structure
The named resource component is based on the Java Naming and Directory Interface (JNDI),
allowing applications based on Java technology to store and retrieve named objects easily. See
http://java.sun.com for more information on JNDI.
Maps are stored as Named Maps. The production data for these maps (for example, MapDisplay)
will be carried by the MapDisplay data component, and installed into the file structure. The Envinsa
installer copies a series of named maps (high, low, and medium) to the proper directory under the
namedResource JNDI tree. The namedResource directory is located in
<PlatformDomain>\NamedResource\namedResources\.
17
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Working with the Directory Structure and Multiple Enterprises
There are numerous subdirectories in the namedResource directory structure that contain Named
Layers. Some layers are dedicated to special usages, for example, the landsat layers and grid layers
are generally used for 3D mapping, and reference the 3D data components (for example,
MapDisplay3D).
Styles carried in the named resource component are MapInfo styles (miStyle directory) and Envinsa
predefined styles. Users can defined custom styles that will be stored under the user's Enterprise
directory.
Working with the Directory Structure and Multiple Enterprises
When working with the namedResource directory structure there are some important information
that you should remember:
1. The namedResources directory is the JNDI root. Make sure that dependent data (for example,
TAB files, images, etc.) are not stored in that directory.
2. All Enterprise named resources will be under the same JNDI root. The namedResources
directory should contain all Enterprise level subdirectories.
3. A service user will always work with resources in their Enterprise. The user without an Enterprise
will have access to resources in the PUBLIC folder.
4. Get Capabilities requests from services will return the resource name with an Enterprise prefix.
For example, when the abc style is queried by a user in the MyEnterprise Enterprise, the
resource will be returned as MyEnterprise/styles/abc.
5. Get capabilities requests from services will hide the PUBLIC prefix. For example, instead of
returning Public\POIStyle, the service will return only POIStyle as the resource when queried by
a user that is not assigned an Enterprise.
6. Get capabilities requests will return MapDisplay named maps along with their country divisions.
However, in order to maintain backward compatibility for Envinsa 3.5 users, the default country
can be hidden in both requests and responses. For example, if US is the default country, a get
capabilities request will return MapDisplay/US/high and MapDisplay/high as the resource when
queried by a service user. Both resources refer to the same named map.
7. When a request is made by an Enterprise user, for example MyEnterprise.joe, and the
Enterprise directory MyEnterprise does not exist, the request defaults to the PUBLIC folder.
8. All resources are cached by the services, based on Enterprise-level changes. When resources
are changed using the Map Manager, it will change the time-stamp of the Enterprise folder.
Envinsa services use this time-stamp to determine if a resource should be reloaded.
9. When working with the Map Manager, depending on the Enterprise of the user, this user can
work with the Enterprise directories they are assigned. These Enterprise folders will act as their
root directories. The user may not access or change named resources in Enterprise directories
they are not assigned.
10. Administrators have access to all Enterprises.
18
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 2: File Management
Multiple Country Support for MapDisplay
To support multiple countries seamlessly for map definitions with the same name, a directory
convention is introduced that the user must follow. If working with multiple countries, the default
PUBLIC directory has to have country code subdirectories. For example, the named resource
PUBLIC/MapDisplay/US/high is US-specific but PUBLIC/MapDisplay/CA/high is specific to
Canada.
An Enterprise directory does not have this limitation and the organization of the directory is up to the
administrator. For example, the following directory structure shows how the country codes are used
in the PUBLIC directory and how country codes can be used to support multiple counties in an
Enterprise:
\namedResources
\PUBLIC
\MapDisplay
\US
\CA
\<Enterprise Name>
\US
The PUBLIC directory is populated with country divisions by the installer. Named Maps from the
MapDisplay data components are copied to the named resource MapDisplay/<country division> sub
directory. When multiple country MapDisplay data is installed, the installer copies all the named
maps for each country accordingly. For example, if the installer installs a MapDisplay US and a
MapDisplay AU data component, then all the United States Named Maps are copied to
PUBLIC\MapDisplay\US\, and all the Australian named maps are copied to
PUBLIC\MapDisplay\AU\.
If MapDisplay data is installed for joint countries, for example US_CA (United States and Canada),
the country division directory name will be same as the component name, MapDisplay/US_CA/.
3D Map Data
When working with the Presentation Service 3D capabilities, there is some important information
that you should remember:
1. The Grid directory is dedicated to grid Named Layers.
2. The Grid directory under an Enterprise can be used for elevation acquisitions.
3. The grid data files, GRD and TAB, should only be referenced too, and not stored in the JNDI
directory structure.
4. A Presentation Service GetCapabilityEx request lists all the grid layers in two separate sections
as AvailableNamedLayers and AvailableGridLayers.
5. A grid Named Layer is rendered as a raster layer when referenced as a 2D Named Layer.
6. For a 3D map request, the Presentation Service will select the best fit grid Named Layer
according to the request map bounds.
7. Enterprise grid layers will be only visible to the Enterprise users.
19
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
User Roles and the File Structure
8. User defined grid Named Layers must be saved under the PUBLIC/Grid or an <Enterprise
Name>/Grid directory otherwise they cannot be used by the Presentation Service for 3D
acquisitions.
9. The 3D data should have the same country division as the MapDisplay; the bounds of the grid
will not be used for the country pickup.
Updating Windows Fonts
If a map returned from an Envinsa Service is showing the wrong symbols, for example numbers, %
or # signs, etc., instead of the expected icons for schools, bridges, or other landmarks, this usually
means that you are missing required Windows fonts.
To fix this issue, run the copyFonts.bat file located in the <PlatformDomain>\Presentation\fonts
directory. This file will copy all of the necessary fonts to your Windows fonts directory.
User Roles and the File Structure
Not all information is required to be accessed by everyone within the same organization. The Map
Manager supports different privilege roles to access data within an organization or Enterprise.
Security features of the Map Manager are tied closely to the concepts of Enterprises and user roles,
as defined by the Enterprise Manager.
The namedResources directory represents the named resources repository that is located in the
Domain of Envinsa. The named resources are organized in this directory structure that allows users
to access default resources (used by all) or limit access to resources using Enterprise divisions.
The default named resources directory PUBLIC contains the named resources that are accessible
by all users.
namedResources
PUBLIC
MapDisplay
US
CA
Enterprise_Name_1
...
Enterprise_Name_2
Each Enterprise directory (Enterprise_Name_1 or Enterprise_Name_2 in the above example)
contains the named resources specific for that Enterprise. When a user logs into the Map Manager,
he or she will see the resources under PUBLIC directory and the Enterprise(s) that they belong to.
Access to named resources are controlled by the user role and the Enterprise assigned in the
Enterprise Manager when the user account is created. The following table summarizes access to
resources based on the user role and assigned Enterprises:
20
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 2: File Management
User and Enterprise Access to Resources
User Role
Enterprise
Enterprise
Data Admin
Enterprise User
Regular User/
Data Admin
System
Administrator
Default_Resources
R
R
R
R/W
User’s Enterprise
R
R/W
NA
R/W
Named Enterprise (such
as Enterprise_1)
NA
NA
NA
R/W
where:
•
•
•
R – read-only access
W – user can modify or add existing resources
NA – no access
For a typical Envinsa installation and user role configuration:
•
•
•
•
Regular or Enterprise Users have read-only access to the resources in PUBLIC directory, plus
the resources for any Enterprises that they belong. Users who do not belong to an Enterprise
(demo users), are limited to read-only access to the PUBLIC directory only.
Enterprise Users with Data Administrator privileges can add new resources or modify existing
resources under their Enterprise(s).
Users with System Administrative privileges have read/write access to the entire
namedResources tree.
Only the System Administrator can modify the contents of the PUBLIC directory.
For more details on the definitions or assignment of user roles and Enterprises (User, Data Admin,
Administrator), see the Administration Guide.
21
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Creating and Editing Map
Definitions
This section describes how to use the Map Manager utility to create and edit
map definitions to support the look and feel of the Presentation, WMS, and
Route services. This includes how to manage and configure map layers.
In this section:
Š
Š
Š
Š
Š
Š
Š
Creating a Map Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Manipulating Layers with Map Tools . . . . . . . . . . . . . . . . . . . . . . .26
Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Adding Layers: Add Layer Wizard . . . . . . . . . . . . . . . . . . . . . . . . .33
Editing Layers: Edit Layer Wizard . . . . . . . . . . . . . . . . . . . . . . . . .34
Display Options via Layer Control . . . . . . . . . . . . . . . . . . . . . . . . .36
Labelling Options via Layer Control. . . . . . . . . . . . . . . . . . . . . . . .40
3
Chapter 3: Creating and Editing Map Definitions
Creating a Map Definition
You can create Map Definitions, either by adding new layers or by saving existing Map Definitions or
geosets with new settings and new names. The Map Manager assists you with this task by providing
an Add Layer wizard to walk you through the process. You will build your Map Definition one layer at
a time.
Note: In the Add Layer Wizard, "remote" means you are potentially browsing a remote machine,
although the data could be local as well.
The procedures below describe how to add new layers from file-based data sources, named layers,
and data bound layers, using the wizard. To create a new Map Definition from an existing one or a
geoset, use the Save As button.
Adding MapInfo TAB Files and Other File-Based Map Data
To create a new Map Definition using file-based data:
1. From the Map Definitions panel, click the New button. Any existing layers in the map are
removed leaving a blank map. Click the Layer Control button.
2. From the Layer Control dialog box, click Add. The Add Layer Wizard appears.
3. To add a MapInfo .tab file, choose MapInfo TAB from the list provided in the Select a Data
Source panel. Click Next.
4. At the Specify MapInfo Table Information dialog box, click the Add button to navigate to the file
location, and then select one or more files. Click Open to return to the Add Layer Wizard, then
click Next to continue.
5. In the Specify Other Layer Settings dialog box, give the layer a name, if desired.
6. Click Finish. You are returned to Layer Control. It displays your .tab file in the Layer/Theme list.
Click OK to view the layer in the map.
23
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Creating a Map Definition
7. Customize the layers by setting display, label properties and layer properties, re-ordering the
way in which layers display, removing or adding additional layers, and setting whether layers are
visible, or contain labels.
Click OK to leave the Layer Control dialog box when you are satisfied with the settings. Your newly
created map displays. Return to the Layer Control panel, if necessary, to change display settings or
rerun the Add Layer Wizard to add more layers. When you have finished creating your map you'll
need to save it as a Map Definition.
Adding a Named Layer
A named layer is a layer that you have previously saved with a unique name. You can retrieve
named layers via the Add Layer Wizard like any other layer.
To add a named layer:
1. From the Map Definitions panel, click New. Any existing layers in the map are removed leaving a
blank map. Click the Layer Control button.
2. From the Layer Control dialog box, click Add. The Add Layer Wizard appears.
3. Choose Named Layer from the list of data sources provided in the Select a Data Source panel.
Click Next.
4. Click the Choose Named Layer button to display the Named Resources dialog box. In the left
pane, click on the context that contains your named layer. Highlight a named layer in the
Resources panel and click Load.
5. At the Select a Named Layer panel, click Finish. You are returned to the Layer Control dialog box
showing the layer you added. Click OK to view the layer in the map.
6. Continue to add other layers to build your map. Customize the layers by setting display and label
properties, re-ordering the way in which layers display, removing or adding additional layers, and
setting whether layers are visible, or contain labels.
7. Click OK to leave the Layer Control dialog box when you are satisfied with the settings. Your
newly created map displays. Return to the Layer Control dialog box, if necessary, to change
display settings or rerun the Add Layer Wizard to add more layers.
8. When you have finished creating your map you'll need to save it as a Map Definition.
Creating an Analysis Layer
You can use the Add Layer Wizard to create a pie or bar chart as an Analysis Layer. To create an
Analysis Layer:
1. From the Map Definitions panel, click the Open button. Open the file to which you want to add an
Analysis Layer. Click the Layer Control button.
2. From the Layer Control dialog box, click Add. The Add Layer Wizard appears.
3. Choose Analysis Layer from the list of available data sources. Click Next.
4. At the Specify Layer and Columns to Analyze panel, select the layer, the columns to analyze,
and the type of analysis. The bars in a side-by-side chart display vertically, while the bars in a
stacked bar chart display horizontally. Click Next.
24
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
5. At the Specify Pie Chart Properties panel, select the wedge colors, chart size, orientation, and
position. Click Next.
If you selected one of the bar chart types in step 4, select the bar colors, chart size, and
orientation. Click Next.
6. At the Specify Other Layer Settings dialog box, provide a name for the new layer. Click Finish.
Saving a Map Definition
You can save the Map Definition to a file or as a named map.
25
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Manipulating Layers with Map Tools
1. To save your map, from the Map Definitions Panel click the Save button. The Save Map
Definition dialog box includes File, Recent, and Named options. Go to the appropriate tab for the
type of Map Definition you are saving.
Note: Envinsa does not support saving map definitions to a database table.
2. If you are saving to a file, click the File tab and provide the filename and location where you want
the file stored. Click Save. It is stored in .mdf format.
3. If you are saving the map as a named map, from the Named tab, click on the context where the
map definition will be stored. Provide a name for the map definition in the Name box. Click Save.
The information is now saved as a Map Definition in XML format in the specified context. If you
do not have a context to hold your named map, you must set it up. Go to the Named Resources
panel in the Map Manager.
Manipulating Layers with Map Tools
Once you have your map layers open in the Map Manager, you may want to customize their display
for your own needs. Use the buttons on the Map toolbar to control how your map displays. The
following tools are discussed in this section: Zoom In, Zoom Out, Pan, Ruler, Info, Selection tools,
Preferences, Map Options, Create Theme, and Layer Control.
Zoom In Tool
Use the Zoom In tool to get a closer area view of a map or a layer.
To use the Zoom In tool, click the Zoom In cursor in the center of the area you want to zoom in on.
This magnifies the area by a linear factor of two. This point will be at the center of the map in the
zoomed-in view. Repeat this procedure until you have the appropriate level of enlargement.
To zoom in on a rectangular area draw a marquee in the map or layout by diagonally dragging the
Zoom In mouse cursor. The area within the marquee is enlarged.
Zoom Out Tool
Use the Zoom Out tool to get a wider area view of a map or a layer.
To use the Zoom Out tool, click the Zoom Out cursor on the center of the area you want to zoom out
on. This enlarges the area by a linear factor of two. This point will be at the center of the map in the
zoomed-out view.
26
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
Pan Tool
Use the Pan tool to reposition a map within its window.
To move or adjust the map display, click an area of the map and while holding down the mouse
button, drag the map in the appropriate direction. When you release the mouse button, the map is
redrawn in its new location.
Ruler Tool
Use the Ruler tool to measure distance between points and total distance among multiple points.
To use the Ruler tool, click on the starting point on the map. Double-click on the ending point. The
Ruler window shows the distance between the two points.
To show the distance of intermediate points along a route, click on a starting point and continue to
click on additional points. The Ruler window will show the last segment distance and the total
distance. To end the operation, double-click on the last point you wish to measure or press the Esc
key.
Info Tool
The Info tool provides a view of the attributes that are associated with map objects that exist at a
given point.
To use the Info tool, click on a map feature. The Info tool window displays.
If the objects for only one layer are selected, the Info tool window displays the attributes associated
with the map object at that point. Every attribute column for that record is viewable. You may need to
enlarge the window to see the complete list.
If the map contains multiple layers, the Info tool window displays the list of layers. Highlight a layer
and double-click to view the layer level attribute information. Click the List button to return to the list
of layers.
Selection Tools
You may select individual or multiple features in a map layer in order to perform additional
operations on them. The Map Manager provides five selection tools. The Selection tool allows you to
select individual features. The other four tools provide different confining areas (rectangle, radius,
polygon, boundary) within which features are selected.
27
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Manipulating Layers with Map Tools
A behavior common to the five selection tools is the ability to add selected features by using the Shift
key. For example, click with the Select tool to select a feature, shift-click to select another feature
that you want included with the first selection.
All features are selected from the topmost selectable layer in the map. Layers are not selectable by
default. You must check the Selectable box in Layer Control to indicate the layer you wish to select
from.
Once your features are selected, you can save them to a Selection theme.
Select Tool
To use the Select tool choose the tool and click on the feature you want to select. Shift-click to select
additional features.
Select Within Rectangle Tool
To use the Select Within Rectangle tool, choose the tool and click and drag the mouse to form a
rectangle around the objects you wish to select. Shift-click and drag the mouse again to select
features in another rectangle that you wish included with the first selection.
Select Within Radius
To use the Select Within Radius tool, choose the tool and click and drag to form a circle around the
objects you wish to select. Shift-click to create an additional circle that will add the selected features
to the first selection.
Select Within Polygon Tool
To use the Select Within Polygon tool, choose the tool and click on the map to start creating the
polygon that will enclose the features you wish to select. Continue to click at additional points to form
the polygon. Complete the polygon by clicking close to the starting point or by double-clicking. Be
sure that the polygon has at least three nodes.
Select Within Boundary Tool
28
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
To use the Select Within Boundary tool, choose the tool and click on a boundary object to select all
features within that boundary. Shift-click in another boundary to add those selected features to the
collection.
Other Map Tools
This section describes other tools available to you such as preferences and map options.
Preferences
Click the Preferences button to set the default map directory, MIME type (image/gif is the default),
and whether maps are to be rendered remotely (default) or locally.
Local rendering is mainly used for testing purposes such as to confirm that local rendering works for
your application. It should not be used if the client does not have all the required resources available
for your application or applet. For example, some maps might not display properly if the client does
not have required fonts installed.
Map Options
To change settings for distance units and projection use the Map Options button.
Choose the distance unit from the drop-down list of the Map Options dialog box.
To change the coordinate system, click the Display CoordSys drop-down list to display the Choose
Coordinate System dialog box.
29
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Manipulating Layers with Map Tools
Coordinate system data is stored in a projection file called micsys.txt. This file lists hundreds of
supported coordinate systems and the parameters that define them.
The file micsys.txt is contained in micsys.jar. When the Map Manager runs as an application,
micsys.jar is loaded from the lib/common directory. When the Map Manager is run as an applet,
micsys.jar is loaded from the servlet container’s webapps/mapxtreme47/client directory.
View Entire Layer Button
Use the View Entire Layer button to view the extents of the selected layer. Choose the layer in the
View Entire Layer dialog box, and click OK. The map redraws at a recalculated zoom level so that
the extents of the selected layer are visible on the map, allowing you to see the entire layer.
Note: You may not be able to use the View Entire Layer dialog box to view the extents of a query
layer. Specifically, if your layer is defined as a query, and the layer does not have a
QueryBuilder, then you will see an error message if you attempt to perform View Entire Layer
on that query layer.
Add Theme Tool
The Add Theme Wizard is a guided tool to allow you to add a Feature theme or Label theme to your
map.
For Feature themes, you can create either a Ranged theme that groups features according to a
range of values, or an Individual Value theme that shades features based on a value.
The theme can be based on any supported column and layer in the current map. Currently there is
support for creating a theme based on numeric, string and date column data, and on point, line, and
region layers.
30
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
Part of the operation will be to create a default theme legend that is associated with the new theme.
The legend can be customized to change the title, fonts, insets, descriptive text, and colors.
For Label themes, the supported three types are: Ranged, Individual Value, and Selection. For
example, to differentiate between major and minor cities in the same layer, use a Ranged Label
theme to group the cities based on their corresponding data, such as population.
Layer Control
To access the Layer Control dialog box, click the Layer Control button on the Map Manager Toolbar.
31
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Layer Control
The Layer Control dialog box shows all the layers that make up the current map and the status of the
layer attributes. These attributes are: Visible, Selectable, and Autolabel. The icons above each
check box column represent the attributes. It is easy to change the attributes for one or more layers
using the check boxes.
You also have options available to change the display, label, and theme settings, and to reorder,
add, edit, or remove layers. These settings will be maintained when you save the Map Definition.
You can also save layers as named layers via the Layer Control’s Save button.
The following sections discuss the features that comprise the Layer Control dialog box.
Layer/Theme Visibility
The Visible attribute in Layer Control controls whether a layer or theme is visible on the map. For
example, to make a layer invisible, clear the layer’s Visible check box. The layer will no longer
display in the map (however, it will still be included in the Map Definition when you save it). This
feature is especially useful when you want to focus on only one or two layers of a multi-layered map.
Layer Selectability
You are able to select map objects for further manipulation and analysis. The Selectable check
boxes allow you to control whether a layer’s map objects can be selected. By default, layers that are
added to the map are not selectable.
This feature is useful when you wish to select objects from a lower layer. Turn off the selectable
status of all the layers that are above the layer you wish to select from.
32
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
Autolabeling
Any layer that has a check in the Autolabel checkbox will display labels, provided the zoom level
settings for the label are appropriate. Clear the check box for any layer that you do not wish to
display labels. By default, layers that are added to the map are not autolabeled.
Reordering Layers and Themes
Map layers and themes display in the order that they are listed in the Layer Control dialog box, with
the bottom layer drawn first and the top layer drawn last. It is important to order your layers correctly
so that map features are not hidden by others.
For example, you have a layer of customer points and a layer of census tracts. If the layers are
incorrectly ordered in the map, your application might draw the customer points first and then display
the census tract layer second. Your customer points would be obscured by the census tract layer.
To change the order in which layers are displayed, use the Up and Down buttons. Select the layer(s)
you want to reorder and click either the Up or Down button to move the layer(s) to a position above
or below its current position. To reorder a theme, you must reorder the base layer it is associated
with. If there are multiple themes for the base layer, you can reorder a theme within the list of
themes.
Ordering Objects in a Layer
You are not allowed to control the front-to-back ordering of objects within a single map layer. If you
need to control this kind of ordering (for example, you need to make sure that your lines display on
top of your regions), put the different object types in separate layers. Put your line objects in one
layer, and put your region objects in another layer. Then use the Layer Control dialog box to order
the layers.
Adding Layers: Add Layer Wizard
Layer Control provides an Add Layer Wizard to make adding layers easy. You can add layers from a
number of sources, including:
•
•
•
Files.
Previously saved named layers.
Data bound layers (two sources).
33
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Editing Layers: Edit Layer Wizard
•
Envinsa Content Layer.
The data source information comes from a properties file from which the Wizard initializes. The list of
data sources can be modified through the settings in the addlayerwizard.properties file. This file also
contains default values for certain controls in the wizard. It also saves the values that you have
entered for a specific data source and offers the option of using those values the next time you run
Add Layer Wizard.
The following workflow describes how to add an Envinsa Content Layer to a named resource.
1. Click “Layer Control” command on the Map Manager toolbar
2. From the Add Layers Wizard dialog box, select Envinsa Content Layer as a data source.
3. Select the context.
4. Type the Layer Name.
Editing Layers: Edit Layer Wizard
The Edit Layer Wizard displays when you click the Edit button from Layer Control. Use the wizard to
view and/or edit a layer’s properties, such as coordinate system and geometry settings, and layer
name. Use the wizard when you wish to view what type of layer it is, as that is not displayed in Layer
Control. With the Edit Layer wizard you can make minor changes, such as the name of the layer as
it will display in Layer Control. All types of layers except Annotation layers, can be edited.
34
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
The Edit Layer Wizard looks and behaves like the Add Layer Wizard, except that the fields in the
Edit Layer Wizard are already populated with information. You can change any property for the layer
except the type of layer it is.
When you finish going through the wizard, the selected layer will be rebuilt with the new properties
and will replace the layer you had selected originally.
Note: The Edit Layer Wizard sometimes discards a layer’s themes and custom labeling
expressions. This can happen if you use the wizard to re-define the layer completely, so that
the resulting table does not have the same columns as the original.
If you are concerned about the possible loss of themes, examine the Layer Control dialog box when
you are finished with the Edit Layer Wizard. If the themes were maintained, you will see them listed
(you may need to click the layers’ expand/contract icon to display them). If they are not there and
you want to keep them, click Layer Control’s Cancel button to cancel the changes you made in the
Edit Layer Wizard.
Removing Layers and Themes
To remove layers, select the layer you want to remove and click the Remove button. The selected
layers are removed from the Layer list. Click OK or Apply in the Layer Control dialog box to redisplay
the map. These layers are not saved in the Map Definition.
Note: Remove does not delete any files. It only prevents the layer from being displayed in this
particular map.
Theme Button
If you have already created a feature theme or label theme, you can control the zoom range through
Layer Control’s Theme button. Additionally, distance units can be changed here. (Use the Add
Theme tool on the Map Definition interface to create a theme.)
35
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Display Options via Layer Control
Save Button
To save a layer as a named layer, use Layer Control’s Save button. You will be brought to the Save
Named Layer dialog box where you can specify a name for the layer, as well as its stored location.
Display Button
The Display button brings up the Display Options dialog box where you can customize the display
for each layer in a map, including setting the zoom range and overriding the style.
Label Button
The Label Options dialog box is accessible from Layer Control’s Label button, where you can create
a wide variety of label styles for your map layers.
Display Options via Layer Control
The Display Options dialog box enables you to customize the display for each layer in a map,
including setting the zoom range and overriding the style. In Layer Control, select a layer and click
on the Display button to bring up the Display Options dialog box.
Zoom Range
Set the zoom level at which a layer displays in this dialog box. You can also set the units for the
layer. Zoom layering controls the display of a map layer so that it displays only when the map’s zoom
level falls within a preset distance.
For example, your map contains a layer of streets and a layer of postal code boundaries. When you
zoom out past 30 or so kilometers, the appearance of the streets degrades. This is because the
zoom (window width) is too wide to show detailed street maps.
Use Zoom layering to display the street layer only when the zoom is set to a distance that allows you
to see the street detail properly, for instance, less than 8 km.
Different layers in the same map can be displayed at different zoom levels. For example, your map
contains a layer of streets, a layer of county boundaries, and a layer of state boundaries. You want
the streets layer to be visible only when the zoom level is less than eight miles. You want the county
boundary layer to display when the zoom level falls between 20 miles and 200 miles. You want the
states boundary layer to be visible only when the zoom level is greater than 100 miles.
36
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
Style Override
One of the display options available to you is the ability to override the display of a layer with a
different style, such as a new color for regions, new symbol for points or a new line type for line
segments or region borders. These style overrides are set in the Display Options dialog box.
You can override the display with predefined styles. Or you can customize these named renditions in
a variety of ways to give your map features the exact look you want. When you save your map as a
Map Definition the style changes will be saved.
Setting a Style Override
To change the style of a map feature, highlight the layer in Layer Control and click the Display
button. At the Display Options dialog box, click the Select Style button to display the Select a Style
dialog box. Click on the mistyles context in the left pane to display the folders of available styles,
then choose the appropriate folder: either brushes, fonts, or pens.
Use the brush styles to change the pattern, fill, or foreground color of map features. Choose Brush_
002 to choose a solid fill or Brushes_003-034 for patterns. To set a transparent fill, choose Brush_
001. The brush numbers display as tool tips when your cursor hovers over a style swatch.
Use the font styles to override the style for symbols, including symbol type, color, size, and unit.
Units can be either paper units, such as millimeters, or geographic units, such as miles, that allow
your symbols to resize themselves at different zoom levels.
Use the pen styles to change the line style, color, and thickness of roads or other linear features.
Pen styles also are used to change the border of polygon features.
37
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Display Options via Layer Control
Overriding with a Predefined Named Rendition
To override the layer’s display style with a predefined style, choose the style from the swatch panel.
The style retains its predefined name in the Name box. Click Load to return to the Display Options
dialog box. Click OK twice to view the effect of the style override on your map.
For example, to change all stars to triangles, choose the triangle symbol from the Map Symbols font
set. Click Load, then OK twice to view the map. The symbol now displays as a triangle at the original
point size. Note that the only change here is to the symbol. The symbol still displays with the same
point size because you did not override the point size (doing so would be considered a custom style
change).
Overriding with a Custom Style
To override the layer’s display style with a custom style, begin by choosing a predefined style and
make changes to it. Any changes to color, size and unit, and line thickness change the predefined
style to a custom style.
For example, to change postal code boundaries to blue hatched features with thick borders, from the
Brush swatches, choose the hatch pattern of your choice. (If you loaded this pattern at this point, it
would still be considered a predefined named rendition). Click on the Fill color box and choose blue
from the color picker. The name of the style in the Name box has now changed from brush_001 to
"Custom Style." In the Line Thickness box, specify a new thickness that will be applied to the border
of the boundaries. Click Load, then OK twice to view the style change.
Style Overrides for Layers with Multiple Feature Types
You can also set style overrides if you have more than one feature type in the same layer. For
example, to change the color of your postal code boundaries and the color of the symbol used to
display post offices that are contained in the same layer, start by setting the style override for the
boundaries. Choose a brush pattern and color.
To change the color of the symbol style click the Symbol tab to access the Symbol color picker.
Choose a new color. Note that the symbol style in the Selected Style window shows a square
symbol with the new color. This is a default symbol style to indicate the color change. The symbol
type will not change in this example. When you are through making changes for both feature types,
click Load and OK twice to view the changes in your map.
Overriding with a Gradient Fill or Stroke
You can set a style to use a gradient fill or stroke. You have the choice of using a linear or radial
gradient. A linear gradient a transition through a series of colors along a straight line. A radial
gradient a transition through a series of colors along a circular path.
To use gradient fills or strokes, in the Select a Style dialog box, select Radial Gradient or Linear
Gradient for the fill or stroke property you want to override. You can then click the ellipsis button to
display the Specify Radial Gradient or Specify Linear Gradient dialog box.
38
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
You can now specify the aspects of the gradient to meet your needs. Once you are satisfied with the
gradient, click OK.
Saving New Named Styles
The Map Manager comes with a large assortment of standard named styles, such as brush_002 and
pen_118. You also can create your own custom named styles. For example, you could create a
named style called "BigBlueStar" representing a 24-point, blue star symbol.
To save a new named style resource:
1. Run the Map Manager client.
2. Go to the Named Resources tab.
3. Click the Create a New Style button. The Select a Style dialog box appears.
4. Select one of the existing named styles, such as brush_002, as a starting point for your custom
style.
5. Apply whatever custom style properties (color, etc.) you want.
6. In the Contexts tree at the left, click on the folder where you want to save your new named style.
7. In the Name textbox, type the name you want to use for your style. Short but descriptive names
are best, such as "bluestar".
8. Click the Save button. Your new named style is saved on the server.
Note: The Select a Style dialog box only provides a Save button when you launch it from the
Named Resources tab. If the Select a Style dialog box is launched from another location,
such as the Layer Control dialog box, then the selected style can only be applied to the map,
it cannot be saved to a named style resource. (This restriction exists for the sake of security.
If the Select a Style dialog box always allowed users to save named styles, then any
application or applet could allow users to create or overwrite named styles on the server.)
39
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Labelling Options via Layer Control
Labelling Options via Layer Control
The Map Manager offers a wide variety of label properties to give your maps a distinctive and
sophisticated look. To change the label properties for a layer, select the layer and click the Label
button to display the Label Options dialog box.
The Label Options dialog box has three panels to enable different label features:
•
•
•
Text (column name or expression, multiline display, font attributes)
Visibility (zoom settings, duplicate/overlapping labels)
Position (offset from anchor point, horizontal and vertical alignment)
Label Text Tab
To set the column for labelling, from the Text tab select the column from the Label With: drop-down
list. This list defaults to the first column of the table.
Additionally, you can create an Expression using column data or static text, or a combination of both.
To combine both you would create an expression for the label.
For example, you want to create a label that begins with the static text "Pop:", followed by the actual
population values from a column called POP_2000. From the Label with drop-down list, choose
Expression. The Expression dialog box displays.
Type "Pop:" in the Expression window. Be sure the text is in quotes. Choose the column POP_2000
from the Column list. It will be entered automatically in the Expression window. Note that + " " + is
inserted between the static text and the column entry. Click OK to leave the Expression dialog box.
Click OK to leave Layer Control to view the results of the label expression.
40
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
If you create an expression for your labels and wish to display it on multiple lines, in the Expression
window add the characters "\n" at the point in the expression where you want the line to break.
For example:
Pop_2000 + " " + \n + Pop_Grw_Rate
will display a label with two lines of text describing the population and growth rate for each feature.
Label Style
To change the style of the label, click the Styles box to display the Font options dialog box. Choose
from an assortment of style enhancements including: font name, size, units, color, backgrounds
(halo or box), outline, bold, underline, and italic.
Click on the Text Color box to reveal the color picker. You can either pick the color from the
swatches, or specify the exact color values you want in the RGB (Red, Green, Blue) or HSB (Hue,
Saturation, Brightness) tabs. Note that when you pick a color swatch, the RGB and HSB values are
updated in their respective tabs.
Label Visibility Tab
You can configure labels to display only within a specific zoom range, the same way that you display
map layers within a certain zoom range. To specify a zoom range for labels, check the Display within
Zoom Range box. Then, set the maximum zoom and minimum zoom at which the labels will display.
41
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Labelling Options via Layer Control
To keep from creating a cluttered map when labeling all layers, set the label zoom at different values
so that as you zoom in or out, the appropriate labels display. For example, set the zoom for the world
layer at 0 miles minimum and 2000 maximum. Set the capital city layer to display labels between
200 and 500 miles. Set the city layer to display labels only when zoomed in below 50 miles.
Check or clear the boxes to control whether you have duplicate or overlapping labels. Choose Allow
Duplicate Text if you need to label a map object in more than one location with the same label. If you
do not allow duplicate or overlapping labels, only objects that do not violate this setting will be
labeled. Keep in mind that a map with a lot of overlapping or duplicate labels will be hard to read.
Labeling for multiple layers is carried out according to a priority and whether duplicate or overlapping
text settings are set. Those layers drawn last will take precedence over lower layers drawn first. To
override the priority, check the Override Label Priority box and give the layer a new priority number.
The higher the number, the higher the priority. A label’s default priority is calculated by (number of
layers - layer position) * 10. The illustration above shows a priority of 30 for the world layer since it is
one of four layers, listed second (layer position = 1) (position 0 is the topmost layer).
Intragroup priority is used if the priority between labels is tied.
To set labels to display on more than one line, set the Multiline Text mode to On. Existing line breaks
in the label text are respected. Off (default) means that all text will display on one line. Compute
means the text that needs to be displayed on multiple lines will be determined on the fly. The
Compute operation is the slowest of the three operations because of the large runtime overhead.
Label Position Tab
To control the label position, in the Position tab set the distance that a label will be offset from the
label point of the map object. Enter the screen coordinates in pixels in the X and Y boxes that you
want used for the new label position.
42
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 3: Creating and Editing Map Definitions
You may also set the horizontal and vertical alignment for the label. Labels can be aligned
horizontally to the left, center, or right of the map centroid and/or vertically from the baseline, top,
bottom, or center of the centroid. Alignment refers to the edge of the bounding box of the label that is
nearest the label point. Left alignment means the left edge of the bounding box is nearest the label
point, which means the label displays to the right.
You can also set the label to rotate with the line. In the Label Options dialog box, the mini-panel will
update to show placement of the new settings relative to an anchor point.
In addition to straight-line labels, you can set labels for polylines or polygons to follow the curved
path of the object. Labels will be drawn along the polyline or along the polygon boundary when you
select this option. Keep in mind that curved labels are computed on the fly, taking into consideration
all the label settings, such as horizontal alignment, creative effects, and visibility settings. The
following image shows the curved path label option applied to street names:
Some settings do not apply to curved labels. Multiline text mode is not yet supported for splined
labels. Geometry calculation mode is ignored since placement for splined labels is always
dynamically computed.
43
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Labelling Options via Layer Control
Geometry calculation mode allows you to control the label placement when you change the map
view. For example, if you zoom in very closely it’s likely that the label point, which was set to the
approximate centroid of the object, will now be out of view. To remedy that, set the calculation mode
to Compute so that the labels redraw on the fly in the new locations. The locations are calculated
based on the clipping of the view rectangle. The default behavior (Static) is that no recalculation of
the label point occurs.
44
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Managing Named
Resources
This section describes how to use the Map Manager utility to manage various
aspects of the Presentation, WMS, and Route services, such as manage named
resources, including maps, layers, and renditions.
In this section:
Š
Š
Š
Š
Š
Managing Named Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Named Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Named Layers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Named Renditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
Named Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
4
Managing Named Resources
Managing Named Resources
Named resources allow a name to be attached to a resource. This offers many advantages:
•
•
•
Allows a resource to be known by its name and not by its properties.
Allows a resource to be located in one spot but be referenced from many locations, which makes
administration of resources easier.
To change the look or behavior of applications or data, the resource only need be changed, not
each application or data file.
The Map Manager provides a Named Resources panel for managing named maps, named layers,
and named renditions. The Named Resources panel, as well as named maps, layers, and renditions
are discussed below.
The Named Resources panel on the Map Manager is the location for managing all supported named
resources. The illustration below shows the panel with contexts for three named resources. The
mistyles context is automatically available after installation and contains a variety of predefined
styles for fill, lines, and symbols. The contexts for named layers and named maps are user-created.
If you wish to save any layers or maps as named resources, you must first create their contexts
here.
46
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 4: Managing Named Resources
The Context pane provides buttons for creating and deleting contexts. The Resources pane shows
the named resources for the highlighted context. To view the properties of a named resource, click
on the Info button. To delete a resource, click on the Delete button.
Note: The resources in the mistyles context are read-only and cannot be deleted.
Named Maps
Named maps are maps referred to by an alias, such as "myeurope" or "salesterr," that represent a
unique collection of map layers. The information that defines a named map is stored as XML map
definitions. Named maps are created in the Map Manager, as explained below:
Creating a Named Map
To create a named map using the Map Manager:
1. From the Map Definitions panel of the Map Manager, open an existing map definition or geoset
to display a map. You can also build a map by clicking on the Layer Control button and adding
layers.
2. Make any adjustments to the display of the map, such as zoom, labeling, addition of thematic
layers, etc., using the tools provided in the Map Manager.
3. Click the Save button to save the map as a named map. The Save Map Definition dialog box
displays. Click on the Named tab if it is not already displayed.
4. On the left, click on the subfolder under the root context for storing your named map. If you do
not have a context for storing the named map, you must first create one in the Named Resources
panel of the Map Manager before you can save a named map.
5. In the Name text field, type a name for the map. Click Save.
Named Layers
Named layers are map layers that you give a unique name so that you can recall the layer by name
in the future. To save a map layer as a named layer, click the Save button in Layer Control and
provide a name for it in the Save Named Layer dialog box.
47
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Named Renditions
To retrieve a named layer, from Layer Control, click the Add button to display the Add Layer Wizard.
Choose the named layer from the list of data sources provided and follow the wizard’s prompts. See
Creating a Map Definition on page 23 for detailed instructions.
Named Renditions
A wide variety of fill, line, and symbol styles are provided that you can select to override an existing
rendition for a layer. These styles are accessed by clicking on the Display button in Layer Control.
The pen, brush, and symbol styles that are used to draw lines and borders, fill regions, and
represent point locations are XML files that reside, by default, in the namedResources/mistyles
directory.
These styles correspond to standard styles used by MapInfo.
You can customize the predefined styles by changing the color, line thickness and symbol size,
depending on the elements of the style. To save these custom styles, you must save the Map
Definition, which will write out the XML for the custom styles. You cannot save them as new named
renditions in a named resources repository to be re-used in another Map Definition.
Named Connections
The Map Manager allows you to create and use named database connections in the Connection
Manager tab. Named connections are simply connections to remote databases that are referred to
by an alias instead of by cumbersome JDBC details such as the driver, URL, username, and
password. These named databases can be leveraged using the Presentation Service and Map
Manger for creating custom maps.
For more detail on how to create a Named connection and add a Named connection to a layer, see
Chapter 5: Creating and Managing Named Connections.
48
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Creating and Managing
Named Connections
This section describes how to use the Map Manager utility to create and
manage named connections, allowing you to use your JDBC sources as layers
in the Presentation Service.
In this section:
Š
Š
Š
What are Named Connections? . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Creating a Named Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Using a Named Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
5
What are Named Connections?
What are Named Connections?
The Map Manager allows you to create and use named database connections in the Connection
Manager tab. Named connections are simply connections to remote databases that are referred to
by an alias instead of by cumbersome JDBC details such as the driver, URL, username, and
password. These named databases can be leveraged using the Presentation Service and Map
Manger for creating custom maps.
Security Benefits of Named Connections
Beside the efficiency of connection pooling, a significant security benefit exists as well. For three-tier
deployments, JDBC connection information stored in the miconnections.properties file remains on
the server and its contents are not published to the client. Clients access the JDBC connections by
alias; sensitive information that describes the connection, such as user name and password, is not
transmitted over the network.
Creating a Named Connection
Named database connections are managed by the Connections Manager panel of the Map Manager
and are stored in the miconnections.properties file. A client accessing the JDBC connections by
alias ensures sensitive information that describes the connection, such as user name and password,
is not transmitted over the network.
To create a named database connection, perform the following steps:
Note: Each time you add a named connection to a database you must follow these steps in order
for the Presentation Service and the Map Manager to use the new connections.
1. Create a Named Connection
Create your named connection using the Map Manager locally. This option is not available when
using the Map Manager applet:
1. Start the Map Manager.
2. In the Connections Manager tab, create a new database connection by clicking the New button.
3. In the General tab, add your connection information. The following example creates the
"MyConnection" named connection using an Oracle Spatial data source:
Connection Name = MyConnection
JDBC Driver Class = oracle.jdbc.driver.OracleDriver
Data Source URL = jdbc:oracle:thin:@<IP_
ADDRESS>:<PORT>:MyName
User Name = MyUserName
Password = MyPassword
4. In the Pool tab, add the number of Pre-start and Maximum connections, and set the Idle Timeout
Period (Seconds). Click OK.
5. Click Save Connections.
50
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 5: Creating and Managing Named Connections
6. Close the Map Manager.
2. Add the Named Connection
Add your new named connection to the addlayerwizard_en.properties file (English), or the language
specific file that your system is using (e.g., addlayerwizard_de.properties for German). This allows
the Map Managers Add Layer Wizard to access Named Connections, and specifically to the named
database connection you just created. For example, if you had previously defined a named
connection called "MyConnection" that defines a connection to an Oracle Spatial data source, you
would perform the following:
1. Open the <ENVINSA_HOME>\PlatformDomain\MapManager\addlayerwizard_en.properties file
in a text editor.
2. Enter the named connection entries after the Named Connection comment section in the file.
This allows you to manage all of your named connections in one place.
NamedConnection1=MyConnection
NamedConnection1_DataSource=DataSource2
"MyConnection" identifies the name of the connection you defined in the Map Manager.
"DataSource2" identifies the type of data source that corresponds to the named connection.
These types are defined in the addlayerwizard_en.properties file (e.g.,
DataSource1=MapInfo TAB file, DataSource2=Oracle Spatial, DataSource3=SQL with
Spatialware). You can add as many of these named resources as you like, provided that they
coincide with a named connection in your miconnections.properties file.
3. After adding your named connection, save the file.
3. Copy the Properties Files to the Web Containers
In order for the Map Manager applet and the Presentation Service to utilize the named connection,
you must copy the addlayerwizard_en.properties and miconnections.properties files to the
appropriate locations for your Web containers:
If your Presentation Service and Map Manager are deployed in Tomcat:
1. Copy the miconnections.properties file from <Envinsa_Home>/PlatformDomain/MapManager to
the <Tomcat_Home>/webapps/Presentation/WEB-INF/classes directory.
2. Copy the miconnections.properties file from <Envinsa_Home>/PlatformDomain/MapManager to
the <Tomcat_Home>/webapps/MapManager/WEB-INF/classes directory.
3. Copy the addlayerwizard_en.properties file from <Envinsa_Home>/PlatformDomain/
MapManager and add/replace this file in the mjmappletsup.jar file located in the <Tomcat_
Home>/webapps/MapManager/client directory.
If your Presentation Service and Map Manager are deployed in WebSphere:
1. Copy the miconnections.properties file from <Envinsa_Home>/PlatformDomain/MapManager to
the <Websphere_Home>/profiles/<APP_Server_For_Presentation>/installedApps/<Cell_for_
APP_Server>/Presentation.ear/Presentation.war/WEB-INF/classes directory.
2. Copy the miconnections.properties file from <Envinsa_Home>/PlatformDomain/MapManager to
the <Websphere_Home>/profiles/<APP_Server_For_MapManager>/installedApps/<Cell_for_
APP_Server>/MapManager.ear/MapManager.war/WEB-INF/classes directory.
51
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Using a Named Connection
3. Copy the addlayerwizard_en.properties file from <Envinsa_Home>/PlatformDomain/
MapManager and add/replace this file in the mjmappletsup.jar file located in the <Websphere_
Home>/profiles/<APP_Server_For_MapManager>/installedApps/<Cell_for_APP_Server>/
MapManager.ear/MapManager.war/client directory.
Restart both the Map Manager and the Presentation Service Web containers. Your named
connection can now be accessed.
Using a Named Connection
To add a layer using your newly created named connection, use the add layer wizard in the Map
Manager (either locally or remotely):
1. Start the Map Manager.
2. In the Map Definitions tab, click the Layer Control button.
3. Click the Add button.
4. You now have the option to use a named connection. Select Use Named Database Connection
from the list and click Next.
5. Select your named connection from the list and click Next.
6. Provide the required table information, query settings, and how the data is going to be accessed.
When finished, your named connection should be added.
52
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Using Brush, Font, and
Symbol Styles
This section describes the brush, font, and symbol styles available for use with
the Presentation Service.
In this section:
Š
Š
Pen and Brush Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
6
Pen and Brush Styles
Pen and Brush Styles
An Envinsa installation includes a library of standard styles (line styles, fill styles, etc.) which are
defined by files that are located under the namedResources directory hierarchy.
Pen and Brush styles are referenced by a number or symbol reference. If you want to use one of
these standard styles, you must translate the pen or brush number into a style code. The following
table of examples shows which style reference corresponds to which pen or brush style.
Description
Pen or Brush Number
Symbol Reference
plain, solid fill
brush "02
mistyles/brushes/brush_002
"brick" fill pattern
brush "59"
mistyles/brushes/brush_059
plain, solid line
pen "02"
mistyles/pens/pen_002
railroad line pattern
pen "118"
mistyles/pens/pen_118
The following charts show the pen and brush number next to each style; Pen styles range from #01
to #118, and brush styles range from #01 through #71.
Pen Styles
54
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 6: Using Brush, Font, and Symbol Styles
Brush Styles
Symbols
Similar to pen and brush styles, symbols are also referenced by a number. However, there are
multiple types of symbols each referencing similar numbers. If you want to use one of these symbols
in a request, you must translate both the symbol number and the type of symbol into a style code
that the Presentation Service understands. The following table of examples shows which style
reference corresponds to which symbol.
Description
Symbol Number
Symbol Reference
north arrow
Map Arrows "34"
mistyles/fonts/Map Arrows/34
camp
Map Miscellaneous "34"
mistyles/fonts/Map Miscellaneous/34
55
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Symbols
The following charts show the symbol number, symbol type, and the corresponding Symbol
reference:
Map Arrows font sample ID: "mistyles/fonts/Map Arrows/33"
Map Cartographic font sample ID: "mistyles/fonts/Map Cartographic/33"
Map Miscellaneous font sample ID: "mistyles/fonts/Map Miscellaneous/33"
Map Oil&Gas font sample ID: "mistyles/fonts/Map Oil&Gas/33"
56
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.
Chapter 6: Using Brush, Font, and Symbol Styles
Map Real Estate font sample ID: "mistyles/fonts/Map Real Estate/33"
Map Symbols sample ID: "mistyles/fonts/Map Symbols/33"
MapInfo Symbols sample ID: "mistyles/fonts/MapInfo Symbols/33"
Map Transportation font sample ID: "mistyles/fonts/Map Transportation/33"
57
Map Management Guide
© 2007 MapInfo Corporation. All rights reserved.
Symbols
Map Weather font sample ID: "mistyles/fonts/Map Weather/33"
58
Envinsa 4.1
© 2007 MapInfo Corporation. All rights reserved.