Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Manual - Version 8
Mappetizer is an extension for ArcGIS by ESRI. It gives you the opportunity to convert a data frame within ArcMap into the SVG format
or into the Microsoft Silverlight format. You can then use these files to publish them on the Web or on CD-ROM or DVD, or on your
local machine.
Homepage:
www.mappetizer.de
● System Requirements
● Install and Uninstall Mappetizer
● Load Mappetizer Extension in ArcMap
● Registration
❍ Other settings
● Layers
❍ Information about Features
❍ Design
❍ Rastermanagement
● Site Information
● Layout
❍ Use of templates
● Export
● Additional Settings
● Geoprocessing Tool and Batch Processing
Customizing Mappetizer
● Internationalisation
● Add new Puplication Language
● Add new Marker Font
● Additional Settings
Further Informations
● Technical Support
● Frequently Asked Questions
● Accessing Mappetizer on the Internet
● Accessing uismedia on the Internet
Purchase Mappetizer
What is SVG and XML
Scalable Vector Graphics (SVG) is a family of specifications of an XML-based file format for describing two-dimensional
vector graphics, both static and dynamic (i.e. interactive or animated). The SVG specification is an open standard and has
been developed by the World Wide Web Consortium (W3C). The SVG standard is a W3C Recommendation.
SVG images and their behaviours are defined in XML text files. This means that they can be searched, indexed, scripted and,
if required, compressed.
Browsers like Opera (version 9.0 or higher), Firefox (1.5 or higher), Safari (3.0 or higher) and Google Chrome support SVG natively. For
the Internet Explorer, users have to install a free browser plugin (Adobe SVGViewer) to view SVG documents (see FAQ - Which browsers
are supported by Mappetizer?).
What is Microsoft Silverlight
Microsoft Silverlight is a programmable web browser plugin that enables features such as animation,
vector graphics and audio-video playback which characterize rich Internet applications (RIAs).
It is compatible with multiple web browser products used on Microsoft Windows and Mac OS X
operating systems. Mobile devices, starting with Windows Mobile 6 and Symbian (Series 60)
phones, probably will be supported in 2010. A third-party free software implementation named Moonlight is under development to
bring compatible functionality to Linux.
Please note that Silverlight projects have to be loaded within a Web server.
What is Mappetizer
Mappetizer is an extension for ArcGIS by ESRI. It gives you the opportunity to convert maps within ArcMap into the SVG or
Microsoft Silverlight format. You can then use these files to view them on your local machine and to publish them on the Web or on CD-
ROM/DVD.
Mappetizer supports vector based object data and image data. In addition "Annotation Coverages" out of ArcInfo and text layers out of
CAD files are supported. Image data are displayed in GIF, PNG or JPEG format in the Web Browser. All vector based objects and all
text objects are converted into the SVG or the Microsoft Silverlight format and are infinitely zoomable without loosing cartographic quality.
Remark:
Not all functions of Mappetizer are available under ArcGIS 8.x.
Install and Uninstall Mappetizer
Before you can use Mappetizer, you must install the program on your computer. For this you must have administrative privileges. The
setup, which runs under Microsoft Windows, does the following things for you:
Start the installation program "Setup.exe". The installation dialog box appears. Follow the directions on the screen to setup the program.
During installation you must accept the licence requirements of Mappetizer. On this screen you can also print out the licence requirements.
The installation program now ask you for the installation path. After that all necessary files are copied into the folder you have choosen. At
the end of installation you can automatically start a sample project in ArcGIS to use Mappetizer. You can find further informations under
the Mappetizer group in the Start menu.
In addition to Mappetizer some other programs are installed, Licence requirements of Mappetizer are not valid for these programs:
● The program "gzip.exe" is installed under the installation path of Mappetizer. This program has his own "GNU GENERAL
PUBLIC LICENCE".
● The ImageMagick tool "convert.exe" is installed under the installation path of Mappetizer. Convert.exe is Copyright 1999-2008
ImageMagick Studio.
If you want to uninstall Mappetizer, you can do it with the program "Uninstall" under the Mappetizer group in the Start menu or you can
use "Add/Remove Programs" respectively "Programs and Features" in Control Panel.
Mappetizer uses by default the ImageMagick tool "convert.exe" to convert raster images. But you can also use external graphic programs.
The following programs are supported:
● ImageMagick http://www.imagemagick.org/
● NConvert (XnView) http://www.xnview.com/
Mappetizer is an extension for ArcMap. To use Mappetizer you have to activate the Mappetizer Extension under the menu entry
Tools-Extensions.
Mappetizer has also a Toolbar in ArcMap. To see the Toolbar please avivate the Toolbar under the menu entry View->Toolbars.
Dojo Toolkit
Mappetizer uses the open source modular JavaScript library Dojo Toolkit (http://www.dojotoolkit.org). Specific templates also take use of
the Dojo widgets system, which are prepackaged components of JavaScript code, HTML markup and CSS style declarations that can be used
to enrich websites with various interactive features that work across browsers. To get access, you have to link in your index.html file to
this JavaScript library (see "Export")
Personal Folder
Within the first export of an ArcMap project, Mappetizer for ArcGIS will create a folder which you can use in future for your personal settings:
● Windows Vista:
..:\Users\YOUR_NAME\AppData\Roaming\uismedia\Mappetizer4ArcGIS
● Windows XP:
..:\Documents and Settings\YOUR_NAME\application data\uismedia\Mappetizer4ArcGIS
If you use Firefox, Opera or Safari you have no need to install additional software to see your SVG maps in web browser.
If you use Microsoft Internet Explorer you need the Adobe SVGViewer to see your SVG maps.
If you use this plugin the first time with Microsft Internet Explorer 6 or higher you will be asked to allow the use of this AciveX
component. Please allow this to see your SVG map. This message then never comes again.
If you use a html file with SVG locally you see each time the following message
Abb. 1
The Mappetizer Wizard exists under the menu "File". Additionaly there is a toolbar named Mappetizer. You can activate this under the
menu "View-Toolbars"
Informations about using the Mappetizer Geoprocessing Tool (Professional Version) for the first time can be found under the chapter
"Using the Mappetizer Geoprocessing Tool".
Register Mappetizer
If you use Mappetizer and you have not registered Mappetizer yet, a dialog box appears to show you that you are working with an
evaluation copy (Fig. 1). This dialog appears every time you start Mappetizer until you have registered your version.
Fig. 1
If you click the "Start..." button, Mappetizer can be used in demo mode without any restrictions (see "Information about the Demo Version").
To register your software please close ArcMap and start the Mappetizer License Manager.
After starting the program (Start->Programs->Mappetizer for ArcGIS->Mappetizer LicenseManager) you will see an overview window,
which shows the status of Mappetizer (Fig. 2). The overview table lists installation status, license status and license count for each software part.
Fig. 2
Registering can be started by selecting the software and pressing the "Register now..." button. Alternatively you can double click the
software. A dialog box appears (Fig. 3). Enter your name, licence code, and the amount of licences in the text fields. Press "Apply" to
register you software. If licencing was successfull, press "OK" to finish registration.
Fig. 3
Making your Map ready for Export
Basically all visible layers of your map (Personal geodatabase, CAD dataset, Coverages, Shapefiles, Layers, ArcSDE Connection,
Raster image, Raster Catalog) are exported, as far as their symbol types are supported by Mappetizer. So, all vector based feature data
("Point", "PolyLine", "Polygon" and "MultiPoint"), rasters and texts are supported. Beyond this, joins to database and feature tables
are supported.
While all images are presented as GIF, JPEG's or PNG's in the browser, all vector based data and the text-layers are transformed in the
SVG and the Microsoft Silverlight format. WMS-Layer are supported as Web Map Services on the base of the OGC-standard specification.
Supported Symbol and Rendering Types of Feature Data
Mappetizer supports, corresponding to the different types of Feature Data Source (areas, lines and points), fill, pen, and marker symbols.
For full use of the possibilities of Mappetizer, this chapter will show you the supported symbol types and how to create them in ArcMap.
To change the symbol in ArcMap, right-click the layers's name in the table of contents and click Properties to display the Layer
Properties window. Click the Symbology tab and double-click on a symbol to display the Symbol Selector window. If you just want to
change one symbol, click on the symbol in the table of contents to display the Symbol Selector window.
Fill symbols
1. One-coloured symbols
Mappetizer supports one-coloured, opaque, nonopaque (shine through) and transparent symbols.
2. Hatching
To make a vector based hatching, click Properties in the Symbol Selector window. Choose Line Fill Symbol to create one or more
overlaying hatching symbols. Choose a Simple Fill Symbol to make a background color.
Tip: Vertical or horizontal hatching look more appealing than hatches with diagonal lines.
3. Gradient fills
Mappetizer supports linear and circular color ramp fills. Rectangular and buffered gradient fills are exported as circular ramp fills. To create
a gradient fill click Gradient Fill Symbol in the Fill Symbol Property Editor dialog. Click the Color Ramp Style dropdown arrow and
choose your fill, adjust the number of color Intervals and the color stretch Percentage from start to end. If you want to modify an existing
color ramp, rightclick Style and click Properties.
Tips for perfect gradient fills in SVG:
❍ For a steady gradient use a high Percentage, especially for circular color ramp fills a value of 100 is recommended.
❍ SVG really supports gradient fills in the opposite of ArcMap: Choose your Intervals as low as possible. Color ramps with one or two colors
just need two intervals to be displayed correctly in the map. Do not be irritated about the display in ArcMap (Fig. 1). If you want to display
the gradient correctly in ArcMap you have to choose at least 15 Intervals, but this high number would only increase the SVG-File size but
not the quality of the gradient.
❍ Especially for circular gradient fills use two colors which are closed together, like light- and dark-yellow (make experiments on the
Black/Bright and White/Bright options in the Edit Color Ramp dialog).
Fig. 1
4. Picture fills
To create picture fills, click the Type dropdown arrow in the Fill Symbol Property Editor dialog, and click Picture Fill Symbol. Navigate to
a .bmp file. Change Foreground or Background Color if necessary.
5. Outline
Mappetizer supports one-coloured, solid or dashed lines. To make a solid line choose Simple Line Symbol, for a dashed line
choose Cartographic Line Symbol.
Line symbols
1. One-coloured symbols
Mappetizer supports all one-coloured, solid or dashed lines. Click Properties in the Symbol Selector window. To make a solid line
choose Simple Line Symbol, for a dashed line choose Cartographic Line Symbol. Make the additional settings for your lines. Lines with
more than one layer will be supported too. Line Decorations with Arrow Marker Symbols are supported as well. The Line Property
Offset within the Cartographic Line Symbol Type is not supported.
2. Picture lines
To create picture lines, click the Type dropdown arrow in the Line Symbol Property Editor dialog, and click Picture Line Symbol. Navigate
to a .bmp file. Change Foreground or Background Color if necessary.
Marker symbols
1. One-coloured symbols
Mappetizer does point features draw as a circle, square, diamond or as a font based marker. To export point features as circles choose
type Simple Marker Symbol in the Properties window of the Symbol Selector.
All font based markers, which are based on the ESRI fonts will be supported. You find a list of the supported fonts in the font.ini file in
the folder ESRIFonts in your Mappetizer program folder.
Hint: Font based markers are included as SVG-Font in the SVG file, so the font will be correctly displayed even if it is not installed. The
native support of SVG in Firefox does not support internal fonts, so the font will not be displayed. We recommend the option
"Convert character marker symbol to picture marker symbol" (see "Layers/Design")
2. Picture markers
To create picture markers, click the Type dropdown arrow in the Marker Symbol Property Editor dialog, and click Picture Marker
Symbol. Navigate to a .bmp file. Change Foreground or Background Color if necessary.
Mappetizer supports the display of features as a Single Symbol, as Categories (Unique values, Unique values-many fields), as
Quantities (Graduated colors, Graduated symbols, Proportional symbols), as Charts, and as well as Multiple Attributes. Specific settings
within the different rendering types may not be supported.
Hint: if the Prevent chart overlap is not checked, several layers with charts can be positioned in relation to each other.
Because of the great amount of different symbol types in ArcMap, it is not so easy to know which symbol types are supported by
Mappetizer. To help you in this case, Mappetizer analyzes your map at the beginning of the export and gives you a message if there
are problems in exporting (Fig. 2). So you have the possibility to adjust your layers before the program is executing. For further information
on this subject, see "ArcObject-Specification of the Supported Elements".
Fig. 2
Raster Data
Suitable file formats for the web are GIF, JPEG and PNG. If you have added a raster in one of these formats into your data frame,
then Mappetizer will copy this file in the SVG export folder. All other formats will be converted within the software into one of these
web formats.
If you like the image to be drawn transparent above other layers you can just use the GIF and PNG format, because JPEG does not
support transparency.
If you have organized your data in a raster catalog, the data have to be stored in the fields "IMAGE", "XMIN", "XMAX", "YMIN",
"YMAX" in the specific attribute table.
Using ArcGIS functionalities to export rasters is very slow. So Mappetizer offers the possibility to use external graphic converters (see
section [GRAPHICCONVERT] in "Additional settings"). Within automatic conversion you just have influence on quality with the
compression rate. For this reason it may be also a good idea to do the conversion manually and substitute the specific raster with this
newly created one within ArcGIS or the export wizard. This also have to be done if you need transparency. Please note, for grid rasters and
all other formats than TIFF, JPEG, GIF, PNG, BMP always ArcGIS functionalities will be used for conversion (There is no internal
conversion in ArcGIS 8.x).
For further information regarding the use of raster data, see also "Optimize your Map for Export".
Additional Settings in ArcMap
Document Properties
1. Author
This information will be shown in the Mappetizer wizard "Site Informations" in the text field "Author".
2. Comments
This information will be shown in the Mappetizer wizard "Site Informations" in the text field "Comment on Map", if there are no settings
made in the Data Frame Properties/Descprition.
3. Hyperlink base
This is supported within Mappetizer.
Layer Properties
Fig. 2
Mappetizer supports WWW or Email links, but also links to all other kind of documents. To use this, choose Document or URL and type
in your Hyperlink field the desired hyperlinks, for example:
Hyperlink
http://www.mappetizer.de
http://www.uismedia.de/Quilts;My Quilts
info@uismedia.de
C:\project\example.pdf;Example
map.gif
../../project/index.asp?ID=<<station>>
js:myFunction('example.html')
js:myFunction(<<station>>)
Mappetizer automatically analyses the information of each cell, e.g. external link (http://www.mappetizer.de), E-Mail (info@uismedia.de) or
a relative link (../oak.gif). If you have a reference to a local file on your machine (C:\project\example.pdf) this file will be copied in
your Mappetizer project and will be linked. Starting point for relative path names is the Mappetizer project folder.
You can also add links to server-side scripts, e.g. to realize querys to a database on your server. The parameter will be joined via the
GET method to the URL. To create the link to your script give in your data in the form "path/filename?variable=<<fieldname>>".
Replace "path/filename" to your own file on your server and your own variable name instead of "variable". Replace "fieldname" by a field
in your attribute table (e.g. ../../project/index.asp?ID=<<station>>).
Mappetizer also supports own javascript code, e.g. js:myFunction('example.html'). You can add your code to the file "variablen.js" if you
like. Beyond this you have the possibility to add object related variables to your javascript function, like js:myFunction
(<<fieldname>>). Replace "fieldname" by a field in your attribute table.
To show Mappetizer that you want to use javascript code, add "js:" in front of the name of the function.
url:myfolder/ruths-steakhouse/profile.pdf
url:myfolder/ginas-cafe/profile.pdf;Profile
url:C:\project\instructions.pdf
url:C:\project\instructions.pdf;Instructions
Links to javascript code is notated like above with js:myFunction('example.html').
After export you have to copy your folder "myfolder" with all subfolders and documents in the Mappetizer export folder. References to
local files on your machine will be copied automatically.
If you want to use an alternative text for the display of your hyperlinks (within the option "Identifying features on the map" or within
the "Attribute Table") please note this text behind a semicolon. By clicking on a feature on the map the first example shows the link to
the folder (myfolder/ruths-steakhouse/profile.pdf), the second example uses the text behind the semicolon for display (Fig. 3)
Fig. 3
Mappetizer takes over your dynamically created labels. If you need more precise control over label placement, you may convert the
dynamic labels to annotations.
Furthermore all labels which are not connected to a layer are factored in.
Mappetizer takes over the font size, the font color and the font style, but not the font family, to keep the SVG files small. Choose the
"Text font" within the export wizard. Labels drawn on markers based on ESRI fonts are taken over.
● Callout text is not supported for dynamically created labels, please convert those labels to annotations.
● Rotated callout text is not supported.
● The text background of the callout seems to be slightly greater in SVG than in ArcMap. If you like to decrease the margin, choose
Advanced Text and choose Properties of the option Text Background. Change the Margins of the Balloon Callout.
Hint: The positioning of text is quite different from SVG to ArcGIS. For this reason there may be differences between ArcMap and
the exported SVG files, especially when you have multilined, rotated text. In this case you can adapt the SVG file.
Graphics
Mappetizer supports your graphics drawn on the map such as lines, ellipses, boxes, circles, polygons and points. For further information on
the supported symbols have a look at "ArcObject-Specification of the Supported Symbols".
Pictures
Mappetizer supports pictures which are placed on your map in ArcMap. As default Mappetizer resize the image to the same size you
have choosen in ArcMap. If the format of the original picture is other than PNG/GIF/JPG, then the image will be converted in one of
these formats. If you do not want resizing of the image, then you can prevent this by changing the settings in the settings.ini
file ([GRAPHICELEMENTS] - KeepPictureSize). The output format of the picture can be choosen too ([GRAPHICCONVERT]
- OutputFormat). Please have a look at "Additional Settings"
Choose of the Map Extent
Mappetizer takes over the actual extent of your map as the initial extent when you load the page in your browser. This property is particulary
of interest when you want to add an overview map to your Web project. So you can decide to start with a zoomed extent (Fig. 1) or with the
full spatial extent of all the layers (Fig. 2).
Hint: The length-height-ratio of the map always depends on the spatial extent of the layers used for the overview map.
Fig. 1
Fig. 2
Optimize your Map for Export
First the good news: Mappetizer does not restrict you in any way regarding of the amount of layers, image data, hyperlinks ... Due to the
small sizes of the files there are also (probably) set no limits to you. The bad news: each successfull website take care of the transfer of data
and loading time between the server and the client. That means at this moment:
● Try to keep the geometries of your layers as simple as possible (e.g. with using the dissolve option in ArcMap).
● Use a Definition Query (see "Layer Properties") if not all features of a layer have to be exported. A feature will also be exported - and
therefore needs loading time - if it is just unvisible or does not appear in the legend because the option <all other values> is off.
● Use "Generalize geometry" in the Layers settings of the Mappetizer export wizard (see "Layers/Design").
● Avoid complex graphic shapes (for example fjord coastlines), they load much slower in a Web browser.
● Use sparingly image data or reduce them in size.
● Reduce the amount of text in your map. Text dramatically increase loading time in Firefox (until Version 3.0). With other browsers we
didn't notice this phenomen.
● Reduce the amount of fields in the attribute tables (make them invisible in the Layer Properties).
● Use the possibilities of the Scale Ranges of layers (see "Layer Properties") and the option "Load layer dynamically": Make a simple layer
of your features for the initial state of loading and add one or more detailed layers for zoom in states; add these layers with the tool "Load
layer dynamically" (see "Layers/Design").
● Use the option of "Load layer dynamically" if the layer is not turned on while the page is loading (see "Layers/Design").
● Use the option of tiling your point, line and raster layers if the whole layer is not within the map extent while the page is loading (see
"Layers/Design").
● Hint: Maps with a Geographic Coordinate System (especially with a small extent) may not be displayed properly. Especially Firefox and
Opera browser have difficulties to display fonts, lines and polygon features with sizes less than 1 pixel.
Support of WMS-Layer and ArcIMS-Layer
Mappetizer supports layers which are defined as Web Map Services on the base of the OGC-standard specification. These
WMSMapLayers and WMSLayers can be included in your ArcMap project like every other layer (since ESRI ArcMap 9.1). The
required parameters (VERSION, LAYERS, SRS, FORMAT, TRANSPARENT, EXCEPTIONS) will be analyzed and can be changed in
the file variablen.js of your exported Mappetizer project.
If you have choosen your own projected coordinate system it may be possible that the WMS layer will not be exported, because the
projection is not supported outside of ArcMap. To avoid this, first load the WMS layer in your Data Frame and after this your other layers.
ArcIMSLayer can be included as WMSMapLayer and WMSLayer via the WMS Connector, which is a Java Web Application that provides
an Open GIS Consortium (OGC)-standard Web Map Service (WMS) interface to data served by ArcIMS Image and ArcMap Image
Services. For further informations please have a look on the ESRI Library of ArcIMS "Using WMS Connector".
Data Graphs
Mappetizer supports graphs which are created in ArcMap. Please read more in the ArcGIS Desktop Help about creating a graph. At the
moment Mappetizer supports bar graphs, line graphs and scatter plots (see "ArcObject-Specification of the Supported Data Graphs").
For further settings concerning your graphs please have a look at "Export Options and Components".
The Mappetizer Export Wizard
Make the data frame active which you want to export. Click the "Mappetizer-Export"* button or choose "Export as SVG and
Microsoft Silverlight" from the File menu. The Mappetizer export wizard (Fig. 1) will open. If your map does not contain any data or
visible layers, the button or the menu item will be grayed out.
Fig. 1
Press Forward to go to the next step of the wizard, press Cancel to leave the wizard without exporting, press Help to open this manual.
The button Export will start the export of your project.
With the Load button, you can choose a XML file, which contains the settings of a former export (see "Export" for this). If you like to
reexport your data, you do not have to fill out again the settings in the wizard. Hint: This option is not available in the Unregistered Version.
Export Options and Components
Export options
Toolbar components
Other components
Layer for overview map
Fig. 1
Export Options
● SVG/HTML Solution
● Microsoft Silverlight Solution
The SVG/HTML-Solution creates one or more SVG files, which are embeded in an additional HTML file. The SVG files communicate
via Java Scripting over this HTML file. The layout of the site is defined with stylesheets, so it is very easy for you to change the layout on
your own purposes.
At the moment the Microsoft Silverlight Solution does not support all features of the SVG/HTML-Solution. For example the option
Attribute data in database, Location search, statistical graphs within the option Share geometry, graphs which are created in ArcMap,
and WMS-Layers are not supported at the moment.
The simultaneous choice of the SVG/HTML-Solution and the Microsoft Silverlight Solution increases the time of export. For this
we recommend to make all settings and tests only by exporting the SVG/HTML-Solution. When those are done you can append the export
of the Microsoft Silverlight Solution.
Toolbar components
1. Measure tool
This allows the user to measure distances and areas on the map. The results are displayed in a text box. This option needs information about
the Display Units (see "Data Frame Properties"). This option is not available for the Map Unit "decimal degrees"
2. Coordinate read-out
This allows the user to read the coordinates, while moving the mouse over the map. The coordinates are displayed in a text box. This
option needs information about the Map Units (see "Data Frame Properties").
3. Help page
Creates a help page (Fig. 2), which can be loaded by click on the help icon.
Fig. 2
4. Print button
The print button allows you to print directly a page. The function is equivalent to the printing option of the browser.
5. Previous and next extent buttons
Allows you to go back to the previous or to your next extent.
Other components
1. Legend
Generates a legend, which allows the user to turn on or off the layers in the map. If you want to choose "Attribute table" or "Query
builder" later on (see "Information about Features") you should not deactivate this checkbox.
2. Scale bar
Adds a scale bar to your Web project. This option needs information about the Display Units (see "Data Frame Properties"). This option is
not available for the Map Unit "decimal degrees".
3. Scale display and scale specifying
This allows the user to see the map in a specific scale. This option needs information about the Map Units (see "Data Frame Properties").
This option will be converted in a %-zooming for the Map Unit "decimal degrees".
Hint: The results are only correct with a screen resolution of 96 dpi.
4. Spatial bookmarks
This adds a drop-down list which contains the spatial bookmarks of your ArcMap project. (see "Spatial bookmarks").
5. Graphs
Adds the graphs of your ArcMap project (Fig. 3). Supported are bar, line and scatter diagrams.
Fig. 3
To make further layout settings click on the button "..." to open the Graph Manager.
Choose the graphs you want to add to your Web project. If the graph is related to a layer in your map, you may choose the option
"Mouseover highlights feature in map" to visualize the corresponding feature in the map and vice versa (Fig. 4).
Fig. 4
6. Logo
To add a logo on your page (GIF, JPEG or PNG File), type in the path name of your logo file in the text box or choose it with the
dialog window.
7. Location search
This tool offers address geocoding capabilities. The user can type in an address (plus house number), after a successfull search the
application will zoom to this location and visualize the house number with a circle.
The field of application will be best within a city or town, there are no zipcode or city functionalities included. If a streetname exists more
than once a suburb- or zipcode can be included for a further differentiated search. The user then will be informed (Fig. 5).
The attribute data are stored in a XML file or in a MySQL database (within the use of the option "Attribute data in database" for this layer).
For extensive data we recommend the database solution.
Fig. 5
Required datas
Street datas
This functionality is available for line and point layers.
Line layers need the following address geocoding attributes (Fig. 6):
Point layers need the following address geocoding attributes (Fig. 7):
The button "..." behind the checkbox of the location search component allows to allocate the attributes to the informations needed by
the application (Fig. 6 and Fig. 7). Using the field names put in parentheses, the allocation will be set automatically.
Choose the option "Zoom to street", if you want the application to zoom to the whole street, or "Zoom to street segment", if you want
the application to zoom to the specific street segment after a successfull search. We recommend the last option if the spatial area is quite
large or there are long streets, so the circle representing the location will be quite small and almost unvisible when zooming to the whole
street (option only available for line layer).
Fig. 6
Fig. 7
File addressmatch.xml
To adjust uncomplete inputs from the user, the application has implemented several search routines:
The use of replace1 and replace2 elements allows the staggered search for a streetname. If the user types in for example "Auenstrasse" but
there exists just a "Auenweg" it can be find within the second search. Replacing "strasse" in the first step will find maybe both, assumed
both exists within the datas.
You find the addressmatch.xml file in the program folder of Mappetizer (Please do not move or rename this file). This file already
includes algorithms for German and American streetnames, but you can add more algorithms or add another language to this file. Please
be careful when change this file (spelling, uppercase and lowercase characters, don't forget the end-Tags). The file has the following structure:
For a new language add onother XML element <language id="xx">. You can name the attribute whatever you like, this name will appear in
the combobox Language (Fig. 6 and Fig. 7) and you can choose it from there.
❍ "all"
A replacement will be done in each case:
Example Search Expression Replace Expression Result
Vimystrasse Strasse Straße Vimystraße
❍ "allLast"
A replacement will only be made at the end of the string.
Example Search Expression Replace Expression Result
Vimystraße Straße Vimy
Alfred-Wegener-Weg
❍ "word"
A replacement will only be made within a word boundary.
Example Search Expression Replace Expression Result
East North Avenue East E E North Avenue
Eastern Ave East E Eastern Ave
❍ "wordFirst"
A replacement will only be made within the first word boundary.
Example Search Expression Replace Expression Result
East North Ave East E E North Ave
8. Web services
These services are only available if your data are in the coordinate system "WGS 1984 Web Mercator" or "WGS 1984 Web Mercator
(Auxiliary Sphere)"
OpenStreetMap
Adds the OpenStreetMap as a background layer to your Web application.
Wikipedia
Adds access to GeoNames and their Wikipedia entries. These entries can be turned of and on with the Wikipedia-Icon in the Toolbar.
The variables mv_Doc.WikiLang and mv_Map.WikiRows are to change language and number of rows.
Creates an overview map which shows the actual extent of the main map. Choose one or more layers from the list. The overview map can
be created either with extra layers or layers of the map. If you like to create your overview map with extra layers, add those layers to
your ArcMap project but turn them off; you will find these layers in the list.
Other settings
Mapscale range
Object selection
Attribute table
Map
Measure tool
Identifying features
Fig. 1
Mapscale range
Choose the minimum and maximum scale for your map. Beyond this, the user cannot zoom in or out. See also "Layer Properties", if you
want to set a range of scales on the different layers of your map.
Object selection
Attribute table
Specify the name of the language, on which your sorting will be done. There maybe different sorting conventions in different countries.
You find a list of language codes under http://www.loc.gov/standards/iso639-2/langhome.html.
Map
● 3D Chart display:
Add a 3D effect to your charts when using a chart renderer.
● Resize pictures on mouseover:
If you have inserted pictures on your map in ArcMap, you can decide, whether those pictures are getting enlarged on mouseover or not.
To increase the pictures choose the resize factor.
Measure tool
Choose the width of the measure line within the measuring tool.
Identifying features
If you have a field type raster (needs ArcGIS 9.1 and a personal geodatabase) the picture will be shown on top within the identify window
(Fig. 2). Choose, whether Mappetizer should recalculate the width and height of the picture related to the size of the identify table or
the picture should just be copied over. Please be aware that the loading time depends on the file size and not on the size of the picture in
the browser.
Mappetizer uses an external graphic converter to do all conversions (see "Install and uninstall Mappetizer" and [GRAPHICCONVERT]
in "Additional Settings").
If the pictures should just be copied over, please use one of the suitable file formats for the web (GIF, JPEG and PNG).
Fig. 2
Information about Features
This step allows you to add individual features to the layers of your map. To add the features, click on one of the layers in the listbox
and choose the features (Fig. 1).
Share geometry
Attribute table
Hyperlink
Identifying features on the map
Query builder
Object selection
Attribute data in database
Fig. 1
Share geometry
This tool gives you the possibility to visualize different value fields within the use of one SVG geometry. It will enhanced loading speed
and will "clean up" your legend. This tool is also applicable in combination with the option "Attribute data in database".
This function is available for point, line and polygon layers. The layer type "Multipoint" is not supported. The layers with the same
geometry and the same attribute table (consider your joins!) have to be arranged within one group layer. If there is one layer with
another geometry or another attribute table the checkbox will be grayed out. You can add more than one group layer, also those group
layers don't have to be of the same geometry or layer types.
As much as different value fields you want to visualize you have to add the same(!) layer to your group layer. If you want to display fields
from joined tables each layer have to have the same joins. Choose for each layer a different(!) value field and do the symbology. It can be
the same for all layers but also different from each other (Fig. 2). The following settings are possible:
Fig. 2
Choose a name for each layer which will be used as an input in the drop-down list in the legend. If you want to export more than one
group layer with this option the name of the group layer will be a separation name (Fig 3). Also the name of the group layer will be used as
the title for the attribute table, for the object information and for the query builder. In the legend, all other layers within your Data Frame
will be situated above those layers.
Fig. 3
Click on the group layer in the layer's list and choose the option "Share geometry". The visible layers of the group are summarized to one
layer (Fig. 4). The reference layer will be the first layer of the group. Map Tips and Scale Range will be taken over from this layer.
Also secundary symbol properties like the outline color or outline width (fill symbols), the color of the line/circle of Graduated symbols or
the line width/circle size of Graduated colors. If you add other "Information about Features" to this layer, the fields and (alias) names of
this layer will be used.
Fig. 4
Statistics
This tool also displays statistics, as descriptive statistics as well as a graphic (Fig 5). This option is only available for numeric data, displayed
as Graduated colors or as Graduated symbols. A graphic will only be displayed with the option Graduated colors.
Fig. 5
Please press "..." behind the checkbox to make the specific settings (Fig 6). You can click the checkbox "Descriptive statistics" to display
count, minimum, maximum, sum, mean, median and standard deviation. You can click the checkbox "Graphic" to display all values in a
row. By moving your mouse over the values the specific feature will be hilited in the map and the value will displayed above the graphic.
A reference field can be choosed to specify the feature.
Fig. 6
Attribute table
Allows you to add an attribute table for each layer. The table icon will be drawn right of the check box in the legend. If you click on this icon
a new browser window (Fig. 7) will open with the attributes of all fields you specified in ArcMap (see "Layer Properties").
Choose a field if you like an initial sorting of your table, which differs from the sorting in ArcGIS. See also "Others/Attribute table" for
further adaptation.
Fig. 7
Hyperlink
If you click on the map the underlaying hyperlink will be opened in a new browser window. You can only choose this option if you
have defined a Hyperlink Field in ArcMap, see "Layer Properties".
The option "Identifying features on the map" and "Hyperlink" cannot be choosen at the same time.
For more informationen about hyperlinking in Mappetizer please have a look on the "Layer Properties".
This is equivalent to the Identify tool in ArcMap. When you click on a feature in the map, the attributes of the feature will be displayed in
a new browser window or on the main page (see "Layout/Identifying features on the map"). Which attributes are shown, depends on
your visible fields in ArcMap, see "Layer Properties".
The results are displayed as a list (Fig. 8) or as a bar chart (Fig. 9).
Fig. 8
Fig. 9
Hint: Always those features will be shown, which are on top of the map; but these features must not belong to the same layer: For example,
if you have choosen this option for a line layer and at the same time for a polygon layer, you will see the attributes for the line layer if you
click on a line, you will see the attributes for the polygon layer if you click on a polygon. Two overlaying polygon layers will always show
the attributes for the layer on the top, until the user does not have turned off this layer. If you have a polygon layer on top which is only
used for visualization (e.g. adiminstration borders) make the fill symbol for this layer transparent. If you do not have checked
"Identifying features on the map" or "Hotlinks" and have not added Map Tips to your layer in ArcMap, the Identifying tool shows
the information of the theme below. Look in "Fill symbols/One-coloured symbols" how to make a transparent symbol in ArcMap.
Fig. 10
Add relate
The option "Add relate" is only available if you have defined a relate in ArcMap. Choose one of your defined relates for the specific layer
(see also "Layer Properties").
Query builder
This is equivalent to the query builder in ArcMap. The query builder icon will be drawn right of the check box in the legend. If you click
on this icon a new browser window with the query builder will open (Fig. 11). The Dojo-Dijit Template also offers the option to display
the query builder in a pane of the tab container (see "Layout").
The user can build the query expression by either clicking on fields, operators, and values, or by typing it in. By clicking the "Select"
button, the selected features will be displayed in a new window or in the query builder window (Fig. 12). Also the selected features
are highlighted in the map. Clicking the "Select and Zoom" button additionally zooms to the selected features.
Fig. 11
Fig. 12
Object selection
This allows the user to zoom to or highlight the features listed in a drop-down list on your page. Select the field you wish. Layout settings
can be set in the export wizard "Layout" and "Others/Object selection".
Hint: This option is only available for one layer.
This tool offers the possibility to store the attribute data in a MySQL database (instead of in XML files). Using the options "Attribute
table", "Identifying features on the map", "Query builder" and "Object selection" but also within the Location search application and the
option "Share geometry" the datas are fetched from the MySQL database server.
Please be aware, that there will be no change of symbology or MapTips when you change this specific data in your database. In this case a
new export is necessary.
The tool will offer functions to export your data in a MySQL database, as well as the PHP-Scripts to generate the dynamic websites (see
also "Structure of the database tables").
Choose the option "Attribute data in database" for those layers for which you want the attribute data stored in a database. The button "..."
offers you more settings for all those layers (Fig. 13):
Hint: In the Demo version this option is only available, if you have activate the functionality in the settings.ini file (see "Additional Settings").
Fig. 13
1. Database Connection
Choose the way to export your attribute data into a MySQL database:
SQL Script
A SQL script will be created with all necessary commands for creating tables and adding data. You can additionally add a drop table
command. This kind of export is required if you have no direct access to your database. You will find the SQL script in the export folder.
ArcGIS connection
You can choose an existing "OLE DB connection" as target for your attribute export. The "OLE DB connection" can be choosen out of
a selection list. After export you will find a log file in the exported folder.
Database connection
Here you can define your own database connection. You can choose the provider ODBC. You can test your connection when pressing
the "Test" button. After export you will find a log file in the exported folder.
2. Table Prefix
Type in a prefix for your tables which Mappetizer will create. Different prefixes allow you to keep different projects in one database.
3. Script Language
At the moment you can choose PHP in combination with a MySQL database server connection to create the dynamic web pages for your
Web mapping project.
This script is located in the folder which Mappetizer has created. The file contains a few variables which manage the database access. Type
in the variables $db_server, $db_user, $db_pwd, $db_name the name of the database server, the username, the password and the
database name.
● PHP:
www.php.net/manual/en/
● Adding an OLE DB Connection:
webhelp.esri.com/arcgisdesktop/9.1/index.cfm?ID=93&TopicName=Adding%20OLE%20DB%20connections&rand=759&pid=87
Design
Fig. 1
By default all layers are added to the legend. If you do not like a layer be added to the legend you can deactivate the checkbox for this
layer. This is useful for layers which are mainly for orientation with less additional object information. Also have a look on the option
"Hide/Show Legend" in "Layer Properties".
You can choose, which layers will be visible or unvisible when the page is loading in the browser. By default all layers are visible.
Please note: Making layers unvisible, does not shorten the (first) loading time of the page in the browser! But you can speed up loading
with using this option in combination with the option "Load layer dynamically". In this case the layer will actually be loaded when the
user clicks on the icon in the legend.
You can choose, whether the layer can be turned on or off. By default the layer can be turned off.
Generalize geometry
● Generalize method:
This option gives you the possibility to simplify your geometry, so the loading of your map in the browser will speed up. Your data in
ArcMap will not be changed.
The generalizing uses the Douglas-Poiker algorithm. Results are very dependent on the polygon and the polyline geometry. Shapes
created from adjacent polygons may no longer be coincident. They may overlap, or leave a sliver. The only check on the resulting geometry
is to be sure a polygon has not collapsed completely by removing too many vertices. If so, the shape will revert to the original. While the
shape endpoints are maintained, interior points may be eliminated. Other shapes in a network that may begin or end at an interior vertex
may now be dangling. A complex shape may cross itself after being generalized.
Type in the tolerance in the specific unit; Mappetizer will give you a report about the results of generalizing after export (comparing the
amount of vertices of the original and the simplified geometry, Fig. 2).
Informationen about features which may be changed as the shapes are simplified (area, perimeter) are taken from the original.
Fig. 2
● Smooth method:
This option exports the geometry as Bézier curves. Your data in ArcMap will not be changed. Some types of data will show more
adequate results (e.g. contour lines). But there might not be a speed up of loading time, this has to be probed.
Fig. 3
SVG and Microsoft Silverlight originally scales lines and text when you zoom in or out. You can turn off this behavior with the option "Do
not scale symbols", so your (font-)markers, lines and border lines are not scaled (Fig. 4).
Hint: The turn off of this scaling is managed by Java-Scripting, use this option sparingly, because zooming will be slowed down.
Labeltext and annotations are always scaled. If your point layer contains PictureMarkerSymbols or SimpleMarkerSymbols as diamonds
or squares this option is greyed out.
Fig. 4
Character marker symbols based on ESRI fonts will be embedded as SVG fonts in your SVG file. At the moment Firefox does not
support embedded SVG fonts. To overcome this disadvantage you can export your character marker symbols also as picture marker
symbols. Be aware while zooming in there is a loss of quality in display.
For character marker symbols which have no SVG font, converting to picture marker symbol will be done automatically.
Feature-pointer for attribute data
Choose the unique object identifier for your map features. We recommend using the Feature-ID of the layer (default setting).
The dynamic loading of layers gives the possibility to save a layer in a separate SVG file. This SVG file will be loaded in the browser the
first time when this specific layer gets visible. To load layers this way will decrease initial loading time. It will be done, when:
1. the layer is turned off at the beginning and it is turned on by the user.
2. the layer gets visible at a specific scale (later on, when the user will zoom in).
Beside this the tool can automatically tile point, line and raster layers. Please choose the number of columns and rows for tiling your
raster layer. Mappetizer creates for each tile a separate SVG file, which will be loaded in the browser only if it is visible. Tiling has the
same result in loading as dynamic loading, and will be done, when
1. the layer is turned off at the beginning and it is turned on by the user.
2. the layer gets visible at a specific scale (and therefore only one or a few tiles).
3. the tile is inside the current map extent.
To see the size of your tiles and get more information about your raster data, click on one of the two buttons:
Raster layers will be converted into PNG/JPEG oder GIF files (see "Raster Data and "Layers/Raster Management")
Raster Management
Fig. 1
If your map contains raster data (a single raster file or a raster layer organized in a raster catalog) which are not suitable for the World
Wide Web (e.g. TIFF files), they will be converted automatically into a suitable format. If you have raster layers which are already added
as GIF, PNG or JPEG, these raster files will be copied directly in the SVG export folder. All other raster formats will be
converted automatically into one of these formats or you choose a corresponding file via the dialog window. You can predefine the
output format and the compression rate inside the settings.ini file (see section [GRAPHICCONVERT] in "Additional Settings"). If you
use tiling for your raster data, each format will be converted, see "Load layer dynamically".
Fig. 1
Fill out the text fields you like, delete or overwrite the suggestions of the program:
1. Author
This information comes from ArcMap.
2. Company/Institution
If you have a registered version of Mappetizer you find here the name of your company/institution. Choose one of these two items, which
will be situated before your text input.
3. E-Mail
Add your E-mail addresses. It will automatically be transferred into a clickable link. More than one e-mail must be separated with a
semicolon or comma.
4. Date
The Date of today will be the choice of the program.
5. Projection
This information comes from ArcMap, if information exists for this matter.
6. Comment on map
This information comes from ArcMap. Carriage returns will be factored in.
Use of Templates
In this step you will choose the layout of your Web application.
Fig. 1
Please make your choice between the different templates. The location of the different elements are shown on the figure beside (Fig 1).
Dojo-Dijit as a template of the SVG/HTML solution uses Dojo Widgets (menus, tabs etc.) of Dojo Toolkits.
If you choosed the SVG/HTML-Solution, you can also choose one of your own templates (HTML files). This is useful when you have
changed your index file and want to export your data again. Mappetizer copies your HTML file and replaces the "Zoom to Object"
information (if you have choosed this option). There are no checks of further depending values between the SVG files and the HTML file.
So we recommend this option only in addition with a saved setting file, see "Export" for this. We recommend the procedure written
in "Changing the layout" for correct future exports.
Own templates have to be placed in your personal folder application data in the folder "uismedia\Mappetizer\Templates".
Mappetizer automatically creates this folder the first time of an export.
Further Possibilities to Customize the Layout
The drop-down list on the right side of the schematic map view allows you to make further settings for the elements in your Web application:
General settings
Map
Legend
Overview map
Toolbar
Identifying features on the map
Site information
Query builder
Object selection
Graphs
General settings
Text font
The display in the browser depends on the fonts which are installed on the system. So it is just useable to differentiate between a serif (e.
g. Times) and a non serif (e.g. Arial) font. Choose one of these font styles. This style will be used for all text in your Web application, such
as the legend, the help text, the title, and the site information (see also "Text"). You can add more fonts to the designmanagement.xml,
see "Add fonts".
Color scheme
Choose one of the given color schemes in the drop-down list for your Web project. With the help of the Color Manager (button "...") you
can change given color schemes, add new, or delete existing color schemes (Fig. 2).
Fig. 2
Choose a color scheme in the list, then change the color of a specific component by click on the colored buttons.
To add a new color scheme click "+", to delete the selected color scheme click "-".
If you add a new color scheme, the colors of the selected color scheme will be taken over. With double click on a color scheme in the list
you can change the name of it.
Press button "Apply" to save your changes without closing the dialog. "OK" will save your changes and close the dialog, "Cancel" will
close the dialog without saving your changes.
Selection color
This color will be seen, when a Map Tip is activated or to highlight the particular feature when the attributes will be seen. Further colors can
be added to the drop down list within the Color Manager (Fig. 3).
Fig. 3
Map
Map extent
Choose the width of your map in pixels. Mappetizer automatically calculates the height of your map, depending on the extent. For this,
all visible layers of the Data Frame are included.
If you like to give a fixed height, deactivate the checkbox "Calculate optimal map height" and choose your own height. This is recommended,
if the width of your map exceeds much the height of your map, or the other way round.
If you have choosen the Template Dojo-Dijit with the option "Adjust map extent to browser window size" only the width-height-ratio of
the map will be taken over. The actual width and height of the map depends on the browser size.
Map border
Choose the border width of your map (pixel).
Legend
Fig. 5
Overview map
Choose the design of the toolbar. While testing different toolbar styles you may have to clear your cache.
Kind of display
Choose, whether the attribute values of the feature are displayed in the main window, respectively in a tab panel (Dojo-Dijit Template) or in
a new window.
Kind of display
Choose, whether the site information will be situated on the main map or will be displayed in a new page when clicking on a button in
the toolbar. The Dojo-Dijit Template will display the site information in a pane of the tab container.
Fig. 10
Kind of display
Choose, whether the query builder will be visible in a pane of the tab container or will be opened in a new window when clicking on an
icon next to the legend's layername.
Object selection
Fig. 11
Graphs
Fig. 12
Extent of graph
Choose the width and the height of your graphs.
Export
This last step will finish the export (Fig.1).
Fig. 1
1. Publication
Choose the language in which you want to publish your Web project. See also "Internationalisation" if you want to export in a language
other than latin characters (ISO-8859-1 West European).
2. Save files in the folder
Choose the path where you want to store your export files. You can do it either by typing the path name in the text field or by opening
the dialog window with the "..." button. Mappetizer creates a new folder "mapview" by default.
If you have choose "Store relative path names" as a map property, Mappetizer store also this path as a relative path.
3. Save settings
Choose a file (.xml), where you want to store the settings for this export. You can do it either by typing the path name in the text field or
by opening the dialog window with the "..." button. You can load this file in Step 1 of the Mappetizer Export Wizard if you want to
reexport your data in future. In this case you do not have to type in all the settings again.
Hint: To load a saved setting file is not available for the Demo Version.
4. Dojo Toolkit Library
Mappetizer uses Dojo Toolkit (http://www.dojotoolkit.org), an open source modular JavaScript library. To get access, you have to link in
your index.html file to this JavaScript library.
Please choose, whether Mappetizer should copy the Dojo Toolkit files in your exported folder (1.5 - 4.0 MB), or only make a reference on
a folder (and you have to put the folder on this specific place on your Web server or local machine). Another choise is to reference a CDN
to pull Dojo from there.
It's done. Press Export to finish the export. The program starts to export your view. The status bar of ArcMap will inform you about the state
of export.
When Mappetizer has finished exporting, a message box will inform you once again about the location of the SVG files on your disc (Fig. 2).
If you like, you can view your results immediately in your browser by pressing the "Yes" button. Press "no", if you want to open your
pages manually. For this, double-click on the file "index.html" in the folder, which Mappetizer has created, or open this file with the "File
open dialog" in your browser.
Please note that the results of the Silverlight project have to be loaded within a Web server they can't be seen only by clicking on the
index_sl.html.
Fig. 2
Additional Settings
Beside the settings in the wizard you have more possibilities to influence the layout of your MapView.
Mappetizer provides different puplication languages (see "Export"). If you want to have the text of the output changed, please edit the
language.ini file like it is described in "Add new Puplication Language".
Add fonts
If you want to use additional fonts for your language, you can add them in the file designmanagement.xml.
Add a new node to the node <FontFamilies>:
If you use fonts with blanks in the name, please quote them with single quotes. You can use several alternativ fonts seperated by comma.
Be aware, that those fonts have to be installed on the system of the user. These fonts are then available in the export wizard, see "Text font".
You'll find the file designmanagement.xml in the program folder of Mappetizer. If you want to make user specific changes or do not have
write access on this folder you can also copy or move this file to your personal folder. If there is a file designmanagement.xml in your
personal folder the information of this file will be taken over. If not, the informations of the file in the program folder will be used.
Geoprocessing Tool and Batch Processing
This tool is not available in the Demo version.
ArcGIS has an extensive geoprocessing environment that enables the user to work with tools, scripts and models. This framework is
very extensible and encourages the combination of tools to perform multiple operations in single user interaction. Mappetizer integrates
into this framework by providing a custom geoprocessing tool that can be used from any script in addition to directly from the
ArcToolbox. The geoprocessing tool is invaluable when combining several exports to one batch process. This functionality is not
available under ArcGIS 8.x.
Open the ArcToolbox window. Right-click the root node and select the Add Toolbox menu entry (Fig. 1).
Fig. 1
Go to the install directory of Mappetizer (usually C:\Program Files\uismedia\Mappetizer) and choose the Mappetizer Toolbox (Fig. 2).
Fig. 2
Expand the section called Mappetizer and double-click the BatchProcessing tool to open the dialog (Fig. 3 and Fig. 4). Do the
following settings:
1. Input Project
Enter a valid ArcMap project which you want to export into SVG.
2. Input Project settings
Enter the project settings file which is saved when you have exported the ArcMap project above (see "Export").
3. After clicking the OK button, BatchProcessing will be exporting your ArcMap project based on the settings saved in the Project settings file.
Fig. 3
Fig. 4
Using the Mappetizer Geoprocessing Tool with the Command Line window
After adding the Mappetizer Geoprocessing Tool to the ArcToolbox, you can also use the Mappetizer Geoprocessing Tool within
the Command Line window.
Open the CommandLine window. Type Map in the upper window. You will find a command called Mappetizer_Batch and you should
be presented with a dialog similar to this:
Mappetizer_Batch
Usage: Mappetizer_Batch <input_project> <input_projectsettings>
With Return you start the command. With right-click the upper window offers you a menu, where you can save your entry for later use.
Batch Processing
Based on the geoprocessing tool it is also possible to add several tasks for batch processing.
For this you have to create a text file with the commands:
To run this file open the Command Line window, right-click the upper window and select "Load..." to load your created file. Type return
to start the execution.
If you have projects with simular content (e.g. data of different counties) and therefore with identical layers and fields, then it is possible to
use a generic project settings file, which will be used as a template. To define a project settings file as generic you must edit this file and add
a new element (see Fig. 5):
<Batch><Generic>1</Generic></Batch>
Fig. 5
Organize your ArcMap projects in different folders and start them with a generic project settings file:
Informations about customizing Silverlight exports can be found in folder SilverlightLib in the installation folder of Mappetizer for ArcGIS.
Changing the Layout (file index.html of the SVG/HTML Solution)
If you want to change the layout, you can fit the "index.html" on your purposes. If you want to change the size of your map, the color of
the HTML-files or to delete several functions of the Web mapping application (e.g. legend, mapscale, overview map) always do this with a
new export in ArcMap, otherwise there is no guarantee of correct function.
If you made extensive changes on your layout and you want to use this as a template for further exports you can save this file in your
personal folder in the subfolder Templates.
It is critical to use your own template because of the cooperation of the different SVG- and Javascript-Files. We strongly recommend
the following steps:
1. Choose a template of the "Available templates" list (exept Dojo-Dijit Template), which already fits your purposes very close. Make
your settings in the export wizard and export your view. Save your settings in a setting file (see "Export").
2. Make your changes in the "index.html" file. Change the corresponding style sheets to alter the position of the individual components. Put
this file in the folder mentioned above.
3. If you like to change the height of the legend, do this in the settings file which has been created by the export before.
4. Open again the export wizard, first (!) load the specific setting file, choose now your own template in the "Own templates" list (you can
only choose your own template out of the list if you first have loaded a setting file). Make the export again.
5. Do all further exports on the base of this new setting file, don't make any changes in the export wizard anymore.
Size of the Query Manager and Attribute Table Window
To change the size of the query manager or the size of the attribute table window, please open the file legend.svg in the folder embfiles. Go
to the line, where the functions showQuery (query manager) or showTable (attribute table) are defined:
function showQuery(themaId) {
parent.mv_openQuery(themaId, "width=600, height=350, top=50,
left=50, toolbar=no, menubar=no, location=no, hotkeys=no,
resizable=yes, scrollbars=yes, dependent=yes,status=no");
}
function showTable(layer,sortField) {
parent.mv_showTable(layer,sortField,"ASC", "width=700, height=500,
top=50, left=50, toolbar=no, menubar=no, location=no, hotkeys=no,
resizable=yes, scrollbars=yes, dependent=yes, status=no");
}
Change in the line "parent.mv_openQuery(themaId, ...." resp. "parent.mv_showTable(layer,..." the attributes width resp. height. The values
are pixels and define the size of the popup window.
If you have your SVG files saved as compressed files you first have to decompress and then to recompress your file. For this you find in
the program folder of Mappetizer the files SVG_zip.bat and SVG_unzip.bat. Right click on the program folder to open the command
window. Type in SVG_unzip resp. SVG_zip and the full path name of your SVG file:
SVG_unzip C:\dosprog\ESRI\AV_GIS30\ARCVIEW\Samples\MapViewSamples\mapview\files\legend
Press return to start the program.
Adding own Scripts
To add further functionalities you can write your own scripts and add them to your Web application. You can write down your scripts in the
file variablen.js or in a separate file. For this just link in the index.html to your script file with the line:
Please be aware, that your scripts might be delete or overwritten when you export your project again. So, save your ideas in a separate file
and copy them again in your Mappetizer project.
You are also able to use internal functions of Mappetizer. The following functions might be of use for you:
● Function mv_zoomToExtent(xMin,xMax,yMin,yMax,zoomBorder)
With this function you can zoom to a specific extent of your map. The coordinates are Mappetizer-specific X/Y coordinates. So you may
have to translate your real coordinates with the functions above. The parameter zoomBorder allows you to set an additional space (value
in pixel) around the specific extent. The scale, scale bar, the scale dependent visibility of the layers, and the positioning of the
overview rectangle will be set automatically within this function.
● Function mv_alert(myText)
Gives out text in a dialog window.
Funktion mv_userInit
You find the function mv_userInit() in the file variablen.js. This function is called on loading and you can use it for your own purposes.
For example if you want to zoom in to a certain extent while loading, pass your coordinates with the URL like:
http://myURL/mappetizer/index.html?4457851,4458272,5374027,5373689
(Input values: xLeft, xRight, yTop, yBottom)
if(window.location.search.length > 0) {
var theArray = window.location.search.substr(1,window.location.search.
length).split(",");
if (theArray.length == 4) {
mv_zoomToExtent(mv_Map.getMapviewX(theArray[0]),mv_Map.getMapviewX
(theArray[1]),mv_Map.getMapviewY(theArray[2]),mv_Map.getMapviewY(theArray[3]),20);
}
}
Adding own Tools to the Toolbar
To add more functionality to Mappetizer you can add your own tools and buttons to the toolbar.
Please do the following to add your tools:
Changes in index.html
Add a new entry in the div-Tag "MVtoolbar". The attribute src contains the path to your button icon. The attribute id contains the name of
the tool:
<div id="MVtoolbar">
<img src="toolbar/mybutton.png" id="MVtoolbar.mybutton" class="iconsH"
width="24" height="22" alt="myTool" title="myTool">
Changes in variablen.js
You find the function mv_userMVDocToolbar() in the file variablen.js. This function handles your new tool. You can add the tool which
is fired when pressing the button (in this example MVtoolbar.mybutton). You can also define whether the tool button is a radio button:
function mv_userMVDocToolbar(objButton) {
//This function is for your own toolbar buttons, do not delete it
switch(objButton.id) {
case "MVtoolbar.mybutton":
objButton.Function = "myFunction('hier',2)";
//objButton.State = 1; // if this button is a radio button
break;
}
}
function myFunction(par1,par2) {
mv_clearEvents(false); // This function clears other tools in the toolbar
mv_alert(par1 + " : " + par2);
}
Dojo-Dijit Template
Changes in index.html
Add a new entry in the div-Tag "MVtoolbar":
Changes in toolbar.css
Add a new line
Changes in variablen.js
You find the dojo.addOnLoad(function()) in the file variablen.js. Type in somewhere the following line:
dojo.connect(dojo.byId("MVtoolbar.mytool"),"onclick",myFunction);
function myFunction() {
mv_clearEvents(false);
mv_alert("hier");
}
Internationalisation
Mappetizer supports UNICODE when exporting SVG. As default SVG files are saved as ANSI files (ISO-8859-1). UNICODE chars will
be converted into escape sequences. Additionally Mappetizer can save SVG files in the UTF-16 format. To do this you must change the
entry [FILE] Codepage= to Codepage=UTF-16 in the settings.ini file, see "Additional Settings".
ANSI format is the default format for Mappetizer. This format is recommended for all languages which use mostly ASCII charcters. UTF-16
is recommended when you use a character set with many UNICODE chars (e.g. arabic).
If you use MV_DBTable, then UTF-16 is not available. But you do not have to do any changes because Mappetizer do this for
you automatically.
If you use a special font to display country characters, it is possible to use this font within Mappetizer (see "Add fonts").
Add new Publication Language
Mappetizer supports different publication languages (see "Export"). You can add more publication languages or change different texts in
your language. For this you must edit the language.ini file. All further exports will be affected by your changes.
The file have to be saved as unicode. Be aware that in certain circumstances special characters like double quotes can't be used. This may
lead that the page can't be load in the browser.
You'll find the file language.ini in the program folder of Mappetizer. If you want to make user specific changes or do not have write access
on this folder you can also copy or move this file to your personal folder. If there is a file language.ini in your personal folder the
information of this file will be taken over, if not, the informations of the file in the program folder will be used.
english_9=English
french_9=French
german_9=German
italian_9=Italian
dutch_9=Dutch
portuguese_9=Portuguese
etc.
Add new Marker Font
The list of the supported marker fonts can be expanded by your own fonts. For this you have to translate your font into a SVG-font. If
you choose this font in ArcMap, Mappetizer will use the corresponding SVG-font for displaying.
You can use the software ttf2svg to transform your font into a SVG-font.
Use one of the following code for translation:
We realized, that the option "-ascii" have to be used to get a correct result, but sometimes with this option the font will not be converted
fully. The only solution is: try both codes and have a look at the converted file in your browser, whether all glyphs are converted.
Be aware: the SVG file has to be visible in the browser, no error messages have to be seen in the status bar while your mouse is over the
SVG file!
After that, you have to edit this file after the following rule:
Put this file in the directory SVGFonts in your personal folder and the name to the list of the font.ini file in this folder. Note the following rule:
fontname (e.g. ESRI Geometric Symbols) # filename (e.g. esri_3.svg).
Additional Settings (File settings.ini)
Settings in this file will have an influence on the program itself (e.g. update service) or will be used as initial values in the Mappetizer
Export Wizard.
You'll find this file in the program folder of Mappetizer. If you want to make user specific settings or do not have write access on this
folder you can also copy or move this file to your personal folder. If there is a file settings.ini in your personal folder the information of this
file will be taken over, if not, the informations of the file in the program folder will be used.
The following attributes will be used as starting values each time when you open the export wizard. All settings (exept codepage) can
be changed in the wizard afterwards.
1. [EXPORT] - SVGSolution
Specify, whether the SVG/HTML Solution should be exported by default. Possible values are "true" (export SVG/HTML solution)
or "false" (don't export SVG/HTML solution).
2. [EXPORT] - SilverlightSolution
Specify, whether the Microsoft Silverlight Solution should be exported by default. Possible values are "true" (export Microsoft
Silverlight solution) or "false" (don't export Microsoft Silverlight solution).
3. [DOJO] - DojoReference
Specify, whether to copy the Dojo Toolkit library into the exported project (1), to reference a folder (0), to reference a CDN (2).
4. [DOJO] - DojoRootFolder
Set a reference to the Dojo Toolkit library folder.
5. [MAP] - Width
Set the width of your map (pixels).
6. [MAP] - Border
Type in the border width of your map (pixel). This value has no influences on the template "Resizeable" or when you have choosed the
option "Add additional buttons" within the zoom and pan management.
7. [MAP] - ChartDisplay3D
Adds a drop shadow ("true") to your chart renderer or not ("false").
8. [MEASURE] - Pensize
Type in the measuring pensize (pixels).
9. [ATTRIBUTETABLE] - SortLanguage
Specify the name of the language, on which your sorting will be done. There maybe different sorting conventions in different countries.
You find a list of language codes under http://www.loc.gov/standards/iso639-2/langhome.html.
❍ Installation path\nconvert.exe
❍ Installation path\convert.exe
1. [UPDATESERVICE] - CheckUpdate
Specify whether Mappetizer looks for updates. Checkup will be done each 10 days. If an update is available you will be informed only,
no installation will be done automatically. Possible values are "true" (look for updates) or "false" (don't look for updates).
2. [UPDATESERVICE] - UpdatePeriod
Specify the frequency in days Mappetizer looks for updates.
ArcObject-Specification of the Supported Elements
Supported Symbols
● SimpleFillSymbol
● LineFillSymbol
● GradientFillSymbol, Style: linear and circle
● PictureFillSymbol (.bmp files)
● SimpleLineSymbol
● CartographicLineSymbol
● PictureLineSymbol (.bmp files)
● SimpleRenderer
● UniqueValueRenderer
● ClassBreaksRenderer
● ProportionalSymbolRenderer
no support of ValueUnit = esriUnknownUnits And NormalizationType = esriNormalizeByLog.
● ChartRenderer
● Vertical Bar
● Horizontal Bar
● Vertical Line
● Horizontal Line
● Scatter Plot
Information about the Demo Version
The Demo version is a fully functional version of Mappetizer, with no restrictions in lifetime. So you can test all the functions
without restrictions. The following differences exist between the Demo version and the registered version:
● the note "DEMO" on the map (if you own Mappetizer and evaluate an additional tool, Mappetizer will handle this export in the Demo mode.)
● the note "Created with Mappetizer by uismedia" as Author- and Copyright-Informations
● the note "Created with Mappetizer by www.uismedia.de" (strings) or -99999 (numbers) or "1800-01-01" (dates) in the XML attribute
files (randomly instead of the correct object data). This will have effects on the correct display of object informations, attribute table, results
of the query manager, the location search application or the display of different attributes in use of the same geometry.
● Hyperlinks are randomly replaced by the URI of the homepage of Mappetizer (http://www.mappetizer.de).
● the option "Load" is disabled in the Demo Version
● the Mappetizer Geoprocessing Tool is disabled in the Demo Version
Your are not allowed to remove the note "DEMO" from the map and to remove the letters "Created with Mappetizer by uismedia" from
the Author- and Copyright-Informations.
Structure of the Database Tables
The visible layers will be counted beginning with zero in the same order they are stored in the Table of contents - TOC (th0,th1,th2,...thn).
For each layer several tables will be created:
Field Description
querymanager Query builder is in use
attributetable Attribute table is in use
switchoffinlegend Layer can be switched off
attributetablesortfield Sort field of the attribute table
symele SVG symboltype ('line','poly','circle')
symstyle Symbol category ('symbolcolor','symbolsize')
statmode Statistic is in use
Field Description
locsearchfleft Left From Address (The beginning of the address range for the left side
of the feature)
locsearchtleft Left To Address (The end of the address range for the left side of the
feature)
locsearchfright Right From Address (The beginning of the address range for the right
side of the feature)
locsearchtright Right To Address (The end of the address range for the right side of the
feature)
Field Description
title Name of the layer (with the specific filed)
symtype Symbol display ('unique','graduated')
defaultcolor Default color
statdescription Descriptive statistics is in use
statgraphic Graphic over the values is in use
For specific components (e.g. Query Builder, Object selection ..) this table will be written out with informations about the envelope of
each feature.
Field Description
recid Record number
xmin The left side coordinate of the feature
xmax The right side coordinate of the feature
ymin The bottom coordinate of the feature
ymax The top coordinate of the feature
If a relate exists for the layer (see "Information about Features/Identifying features on the map"), then the relate table will be exported using
the following scheme (three tables):
Before you call uismedia for technical support, you should be at your computer running your Mappetizer software. Be prepared to give
the following information:
Hours: 9:00 a.m. to 6:00 p.m. German time, Monday through Friday, except uismedia holidays
Accessing Mappetizer on the Internet
You can access announcements about new software and updates, get answers to the most frequently asked questions, and view other
technical reference materials via Mappetizer Internet-based services. These online services are available for you 24/7.
Please note that these self-help support features are not official channels to uismedia Technical Support. To contact Technical Support
see "Technical Support".
Purchase Mappetizer
You have different opportunities to purchase Mappetizer:
Internet
Purchase Mappetizer directly on the Internet.
E-Mail
You can reach our Sales Team under the following E-Mail order@mappetizer.de.
Phone
Our Sales Team is reachable from Monday to Friday from 9:00 a.m. to 6:00 p.m. under the phone number (++49) (0)8161 / 23 28 70.
Mail
Our address is:
uismedia Lang & Müller
Sales Department
Vimystraße 1B
D-85354 Freising
Germany