Академический Документы
Профессиональный Документы
Культура Документы
ArcGIS Server
(Prototype)
Copyright © 2006 ESRI
The information contained in this document is the exclusive property of ESRI. This work is protected under United States copyright law
and other international copyright treaties and conventions. No part of this work may be reproduced or transmitted in any form or by any
means, electronic or mechanical, including photocopying and recording, or by any information storage or retrieval system, except as
expressly permitted in writing by ESRI. All requests should be sent to Attention: Contracts and Legal Services Manager, ESRI, 380 New
York Street, Redlands, CA 92373-8100, USA
@esri.com, 3D Analyst, ADF, AML, ARC/INFO, ArcAtlas, ArcCAD, ArcCatalog, ArcCOGO, ArcData, ArcDoc, ArcEdit, ArcEditor,
ArcEurope, ArcExplorer, ArcExpress, ArcFM, ArcGIS, ArcGlobe, ArcGrid, ArcIMS, ArcInfo Librarian, ArcInfo, ArcInfo-Professional
GIS, ArcInfo-The World's GIS, ArcLocation, ArcLogistics, ArcMap, ArcNetwork, ArcNews, ArcObjects, ArcOpen, ArcPad, ArcPlot,
ArcPress, ArcQuest, ArcReader, ArcScan, ArcScene, ArcSchool, ArcSDE, ArcSdl, ArcStorm, ArcSurvey, ArcTIN, ArcToolbox, ArcTools,
ArcUSA, ArcUser, ArcView, ArcVoyager, ArcWatch, ArcWeb, ArcWorld, Atlas GIS, AtlasWare, Avenue, BusinessMAP, Database
Integrator, DBI Kit, ESRI, ESRI-Team GIS, ESRI-The GIS Company, ESRI-The GIS People, FormEdit, Geographic Design System,
Geography Matters, Geography Network, GIS by ESRI, GIS Day, GIS for Everyone, GISData Server, InsiteMAP, JTX, MapBeans,
MapCaf, MapObjects, ModelBuilder, MOLE, NetEngine, PC ARC/ INFO, PC ARCPLOT, PC ARCSHELL, PC DATA CONVERSION,
PC STARTER KIT, PC TABLES, PC ARCEDIT, PC NETWORK, PC OVERLAY, PLTS, Rent-a-Tech, RouteMAP, SDE, SML, Spatial
Database Engine, StreetEditor, StreetMap, TABLES, the ARC/INFO logo, the ArcCAD logo, the ArcCAD WorkBench logo, the
ArcCOGO logo, the ArcData logo, the ArcData Online logo, the ArcEdit logo, the ArcExplorer logo, the ArcExpress logo, the ArcFM
logo, the ArcFM Viewer logo, the ArcGIS logo, the ArcGrid logo, the ArcIMS logo, the ArcInfo logo, the ArcLogistics Route logo, the
ArcNetwork logo, the ArcPad logo, the ArcPlot logo, the ArcPress for ArcView logo, the ArcPress logo, the ArcScan logo, the ArcScene
logo, the ArcSDE CAD Client logo, the ArcSDE logo, the ArcStorm logo, the ArcTIN logo, the ArcTools logo, the ArcView 3D Analyst
logo, the ArcView Business Analyst logo, the ArcView Data Publisher logo, the ArcView GIS logo, the ArcView Image Analysis logo, the
ArcView Internet Map Server logo, the ArcView logo, the ArcView Network Analyst logo, the ArcView Spatial Analyst logo, the
ArcView StreetMap 2000 logo, the ArcView StreetMap logo, the ArcView Tracking Analyst logo, the Atlas GIS logo, the Avenue logo,
the BusinessMAP logo, the Data Automation Kit logo, the ESRI ArcAtlas Data logo, the ESRI ArcEurope Data logo, the ESRI ArcScene
Data logo, the ESRI ArcUSA Data logo, the ESRI ArcWorld Data logo, the ESRI Digital Chart of the World Data logo, the ESRI globe
logo, the ESRI Press logo, the Geography Network logo, the MapCaf logo, the MapObjects Internet Map Server logo, the MapObjects
logo, the MOLE logo, the NetEngine logo, the PC ARC/INFO logo, the Production Line Tool Set logo, the RouteMAP IMS logo, the
RouteMAP logo, the SDE logo, The World's Leading Desktop GIS, Water Writes, www.esri.com, www.geographynetwork.com,
www.gisday.com, and Your Personal Geographic Information System are trademarks, registered trademarks, or service marks of ESRI in
the United States, the European Community, or certain other jurisdictions.
Other companies and products mentioned herein are trademarks or registered trademarks of their respective trademark owners.
C O N T E N T S
1 Introduction
Exercise 1: Install the course data 1-1
Record user information 1-1
Log in to Windows 1-1
Install the data 1-1
Record ArcGIS Server access information 1-2
Explore the ArcGIS Server help 1-3
(Optional) Create an ESRI Global Account 1-5
4 Geoprocessing services
Exercise 4: Publish and use a geoprocessing service 4-1
Create a toolbox 4-1
Set up the geoprocessing environment 4-5
Author a geoprocessing model 4-8
Test the model 4-18
6 Geodata services
Exercise 6: Publish and work with a geodata service 6-1
Publish a map document and enable the Geodata Access capability 6-1
Extract data from the service 6-5
Create a checkout/check-in replica 6-12
Make edits to a replica 6-16
Synchronize your edits 6-21
7 Customization options
Exercise 7: Customize ArcGIS Explorer 7-1
Create a default map for your server 7-1
Set ArcGIS Explorer's home server 7-5
Configure settings for your ArcGIS Explorer home server 7-7
Provide a custom task from your server 7-10
In this exercise, you will install the data that will be used throughout this course. The data
is stored on a CD and will be copied to your hard drive by an automated install program.
After installing the data, you will have the opportunity to create an ESRI Global Account,
which will allow you to access all pages on the ESRI Support Center, a valuable online
technical resource.
Record the workstation information provided by your instructor in the spaces below.
▪ Workstation user name: ____________________________________
▪ Workstation password: ____________________________________
▪ Workstation domain, if any: ________________________________
In the Log On to Windows dialog box, enter the workstation user name and password
provided by your instructor.
If your workstation is part of a domain, in the "Log on to" drop-down list, choose the
appropriate domain.
Click OK.
Note: If you have trouble logging in to Windows, ask your instructor for help.
Remove the training data CD from the back of your exercise book and place it in the
CD drive.
Click Next.
Remove the training data CD from your CD drive and return it to its sleeve in your
exercise book.
Record the administrative information provided by your instructor in the spaces below.
▪ GIS server host name: ________________________________
▪ ArcGIS Server instance name: __________________________
▪ Administrator user name: ______________________________
▪ Administrator password: ______________________________
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
ArcGIS Server > ArcGIS Server Help.
Question 2: ArcGIS Server's optional extensions allow you to add capabilities to your
system and create applications leveraging advanced features. What is one extension
available for ArcGIS Server? Hint: Consult the topic ArcGIS Server editions.
______________________________________________________________________
Question 3: As you use ArcGIS Server, you will follow a workflow of three steps to
make your geographic information available through the server: What are these three
steps? Hint: Consult the topic Working with an ArcGIS Server system.
______________________________________________________________________
______________________________________________________________________
Conclusion
You have now installed the data that you will work with in the upcoming exercises in this
course. If you have any problems accessing this data, please ask your instructor for
assistance.
If you don't already have an ESRI Global Account, open Internet Explorer.
On the left side of the Web page, click the Create Account link under the ESRI
Support Login section.
In the form that displays, provide a user name and password of your choice and fill out
the remaining required fields (shown in bold).
When you have filled in the required fields, click "create my ESRI Global Account."
If the user name you chose is already taken, you will be prompted to choose another one.
Your account will be created and activated upon confirmation of your e-mail address.
Question 2: ArcGIS Server's optional extensions allow you to add capabilities to your
system and create applications leveraging advanced features. What is one extension
available for ArcGIS Server? Hint: Consult the topic ArcGIS Server editions.
Question 3: As you use ArcGIS Server, you will follow a workflow of three steps to
make your geographic information available through the server: What are these three
steps? Hint: Consult the topic Working with an ArcGIS Server system.
1. Author the GIS resource using ArcGIS Desktop.
2. Publish the resource as a service using ArcGIS Server.
3. Use the service through a client application.
In this exercise, you will complete the entire process required to make GIS information
available on the Web. You will author content using familiar ArcGIS Desktop
applications, publish GIS services using both ArcCatalog™ and the ArcGIS Server
Manager, and create a Web mapping application that will consume your services.
In this exercise, you will:
▪ Author content for a GIS service
▪ Connect to a GIS server
▪ Publish GIS services
▪ Create a Web mapping application
▪ Utilize a variety of clients for consuming GIS services
▪ Explore the different types of GIS services that ArcGIS Server can provide
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
ArcMap to start ArcMap™.
When prompted, choose to start using ArcMap with a new empty map.
Use the Layer Properties dialog box to symbolize and label the layers as you like. Hint:
To access a given layer's properties, right-click the layer name in the table of contents
and choose Properties.
! Make sure to use hollow fill symbols for the state boundary or county
layers if they exist in your map.
When you are finished symbolizing the map layers, save your map document in the
\Student\ISRV\Exercise02 folder. Name the new map California.mxd.
Close ArcMap.
You have successfully completed the first step required to publish GIS content on the
Web. As you have seen, you can author content for ArcGIS Server using familiar ArcGIS
Desktop applications such as ArcMap. You will now use another familiar application,
ArcCatalog, to establish a connection to ArcGIS Server and to eventually publish your
map document as a map service.
connect with must be 1) an administrator on the local machine, and 2) a member of the
ArcGIS Server Administrators group (agsadmin).
Before creating a connection, you will first make sure that your account is in the ArcGIS
Server Administrators group.
Use your operating system tools to verify that your account belongs to the agsadmin
group. Follow the set of instructions below that corresponds to your version of ArcGIS
Server.
Right-click the My Computer icon on your computer's desktop and choose Manage
from the context menu to open the Computer Management window.
Note: If you do not have a My Computer icon on your desktop, click your Start menu >
Control Panel > Administrative Tools > Computer Management.
When you are finished, close the agsadmin Properties dialog box, the Computer
Management window, and the Administrative Tools window.
For Java
Click the Start button on your desktop and click All Programs > ArcGIS > ArcGIS
Server for Java > ArcGIS Server Manager to start the ArcGIS Server Manager
application.
When prompted with the login page, enter the user name and password for an
administrative user account and click Log In. Hint: You recorded your ArcGIS Server
administrator user name and password in the last exercise on page 1-3.
Note: Your user name should be entered in the form <domain name>\<user name> (if
you are logged in to your local machine, use the host name in place of a domain name).
In the View panel on the left side of the application, click Users.
Verify that your account (login) appears in the users list as a member of the agsadmin
group.
Note: If your account does not appear here, make sure to add it to the group. If you have
trouble adding your account, please ask your instructor for assistance.
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
ArcCatalog to start ArcCatalog.
ArcCatalog allows you to establish connections with a variety of GIS servers, including
WMS (Web Map Server) servers, ArcIMS servers, and ArcGIS servers. These
connections might be to a server running locally on your machine, on your local network
(intranet), or on the Internet.
In the first panel of the Add ArcGIS Server wizard, select the option to manage GIS
services (as opposed to simply using them).
Click Next.
On this panel, you will enter your server's URL. The URL is built using the host name
(your machine name) and ArcGIS Server instance name in the format http://<host
name>/<instance name>/services. For example, the URL for a GIS server running
locally on a machine called "Servo" using the default ArcGIS Server instance name
"ArcGIS" would be http://Servo/ArcGIS/Services.
Enter your server's URL. Hint: You recorded your host name and ArcGIS Server
instance name in the last exercise on page 1-3.
Click Finish to complete the wizard and create the connection to your GIS server.
Your new GIS server connection appears in the GIS Servers folder. The name of your
connection should be "<host name> (admin)" (where "<host name>" is the name of your
machine).
Right-click the connection and choose Server Properties from the context menu.
Use the tabs on the ArcGIS Server Properties dialog box to explore the default settings
for your GIS server.
Question 1: Where are the server log files written?
______________________________________________________________________
______________________________________________________________________
Question 4: What are the three types of directories used by ArcGIS Server?
______________________________________________________________________
______________________________________________________________________
Question 5: What are some types of GIS services that can be hosted by this server?
______________________________________________________________________
______________________________________________________________________
Close the ArcGIS Server Properties dialog box when you are finished.
Now that you have established an administrative connection to the ArcGIS server running
on your machine, you have the ability to control which GIS services are provided and
how they are made available to people who may wish to use them. In the next step, you
will publish the California.mxd map document you created earlier as a new map service.
In the Catalog tree, navigate to the \Student\ISRV\Exercise02 folder and locate the
California.mxd map document you created earlier.
On the first panel of the wizard, change the service name to CaliforniaService.
Click Next.
In the following panel, keep the default capabilities checked (mapping only) and click
Next.
In the Catalog tree, click the CaliforniaService listing under your server folder.
On the right, click the Preview tab to view the map service.
Use some of the navigation tools (Pan, Identify, Zoom In, Zoom Out) to interact with
the map.
When you are done exploring the map service, close ArcCatalog.
ArcCatalog is a familiar ArcGIS Desktop application that can be used to publish and
administer GIS services. ArcGIS Server provides another application for managing your
GIS server, working with services, and even creating Web mapping applications: the
ArcGIS Server Manager. In the next step, you will learn how to publish services using
this application.
Start ArcGIS Server Manager. Hint: Click the Start button on your desktop and click
All Programs > ArcGIS > ArcGIS Server > ArcGIS Server Manager.
Note: Depending on the version of ArcGIS Server you are using, you will either see
ArcGIS Server for the Microsoft .NET Framework or ArcGIS Server for Java (e.g., All
Programs > ArcGIS > ArcGIS Server for the Microsoft .NET Framework > ArcGIS
Server Manager).
When prompted with the login page, enter the user name and password for an
administrative user account and click Log In. Hint: You recorded your ArcGIS Server
administrator user name and password in the last exercise on page 1-3.
Note: Your user name should be entered in the form <domain name>\<user name> (if
you are logged in to your local machine, use the host name in place of a domain name).
In the first panel, click the Resource down arrow and navigate to the Tahoe.mxd map
document in the \Student\ISRV\Exercise02 folder.
Note: Only shared folders will appear in the Resource drop-down list. If you wish to
publish a resource that does not appear here, you will first need to use operating system
tools to designate the containing folder as shared. As part of the setup for this course,
your \Student\ISRV folder has been configured as a shared folder.
Name the new service Tahoe and publish it in the existing Maps folder.
On the Services tab of Manager, expand the listings for your map services to view their
properties and a thumbnail preview.
Note: Don't worry about things you see that you might not understand yet (such as
pooling and capabilities). You will learn about them later in the course.
Try starting and stopping your services: check the service(s) you wish to start or stop
and click the appropriate button at the top of the Services panel.
In Manager, click the Services tab to view the GIS services currently available on the
server.
When you create a Web application, only services that are currently running will be
available to you.
You want to use all your services in your Web application, so make sure that the status
for all of them is listed as Started. If a service is stopped, check the box next to the
service and click Start.
The Web Applications panel displays a list of applications you've created previously (if
any). In addition to creating new applications, Manager also allows you to delete or edit
existing applications.
At the top of the Web Applications panel, click Create Web Application.
Manager will now step you through a series of wizard panels to create the new
application.
In the first panel, specify the name and description for the new application as shown
below (for the host, keep the default value, which is the name of your machine):
▪ Name: California Web App
▪ Description: A simple Web mapping application created using Manager.
Click Next.
You will now be prompted for the map services you wish to include in your new
application. You can add as many map services as you like when building a Web
application, but should only add those that make sense in the same Web mapping
application. Each service in the output application will be shown as a separate group
layer in the table of contents.
In order to access the services you've created, you will need to establish a connection to
your GIS server.
Under the Available Services list box, click Add GIS Server.
In the dialog box that appears, choose to create an ArcGIS Server local connection.
You have now established two distinct connections to your local GIS server: one that
uses communication over the local area network, and one that uses HTTP over the
Internet. You may use either connection to choose map services for your Web mapping
application. The decision to use one type of connection or the other will be driven by
whether or not you need to use your Web server's built-in security features (Internet
connection), or the type of functionality you require for the application (e.g., editing
requires a local connection).
Choose the CaliforniaService map service from the local connection, then click Add to
add it to the Selected Services list box.
Click Next.
The next panel will prompt you for GIS the tasks that you wish to include in the new
application. Many of these tasks require a supporting GIS service. The Find Address task,
for example, requires a geocoding service. If you do not have the required supporting
service, you cannot include such a task.
Do not choose to add any tasks (you will work with these later in the course). Click
Next.
On the Set Page Properties panel, give a title and a theme for the application (you may
keep the defaults or provide your own).
Click Next.
Keep all the default settings on the Enable Map Elements panel (include all elements).
Click the Settings button for the North Arrow element, and select your favorite north
arrow symbol.
Click Next.
The last panel of the wizard shows a summary of your new Web mapping application.
Question 6: What is the URL of your new Web application?
______________________________________________________________________
______________________________________________________________________
On the summary panel, make sure that the option to view the Web application in a new
browser window is checked.
You will now explore the application a little to get a feel for the kind of functionality it
delivers and to see the effect of some of your configuration choices.
All Web mapping applications that you build with Manager will have the same basic
layout that you see in this application. The largest portion of the application is used for
the map display, the console area along the left contain tools (such as a layer list and
overview) for working with the map, and a toolbar near the upper left of the application
contains familiar tools for interacting with the map (such as Zoom In, Zoom Out,
Identify, and Pan).
Use the interactive navigation tools to zoom in and pan around a section of the map.
When you build a Web mapping application with Manager, a help system is also
provided to assist your users in working with the map. You can edit these help documents
to add/remove information, redesign their appearance, add your own logos, etc.
Next, you will explore the default help system provided in a Web mapping application.
Click the Help link in the upper right of the application to open the help page.
Use the help to answer the following questions about interacting with the map:
Question 8: When interacting with the map, what effect does spinning the mouse wheel
backward have?
______________________________________________________________________
Expand the listings in the Results panel and examine the information returned.
All the windows along the left side of the application can be expanded or collapsed as
needed to save space.
Experiment with the control on the Results panel for expanding or collapsing the
window.
Experiment with the control for docking or floating the Results window.
Point your mouse pointer over the north tip of the north arrow, then click and hold
down your mouse button.
The map continuously pans north as long as you hold the mouse button down.
Click the red rectangle in the Overview window and drag it to a new location.
Notice that the extent of the main map is updated as you move the rectangle.
When you are finished exploring your Web application, close the browser window and
the Manager window.
In this step, you've seen how easy it is to use Manager to build a Web mapping
application that uses your map services. In the next step, you will use ArcGIS® Explorer,
a powerful, freely downloadable, out-of-the-box client, to work with your map services.
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
Explorer to start ArcGIS Explorer.
Note: When ArcGIS Explorer starts, you may be prompted to set your Home Server.
The Home Server is the ArcGIS server that ArcGIS Explorer initially connects to when
the application starts.
If prompted, set the ArcGIS Explorer Home Server to the ESRI server.
When the application starts, the default map from the ESRI server displays in ArcGIS
Explorer's main window.
Note: If you start ArcGIS Explorer without an Internet connection, you will see a
wireframe lattice of the globe instead of the default map.
The navigator control (on the lower left of the window) allows you to zoom in and out, to
adjust the tilt, and to rotate the globe.
Take a few moments to experiment with the ArcGIS Explorer navigator control to
interact with the map.
In addition to the navigator control, ArcGIS Explorer also contains tasks for interacting
with the data in the map. Along with the tasks that are available out-of-the-box, ArcGIS
Explorer allows you to configure custom tasks to plug in to the application. Tasks can
also be developed for standard Web mapping applications built with Manager. You will
learn how to create a custom task for ArcGIS Explorer, as well as configure tasks for use
in a Web mapping application, in a later section.
If necessary, expand the Tasks window on the left side of the application window.
In the list of available tasks, click the Find Place task to activate it.
Note: You can also activate a task in ArcGIS Explorer by clicking the carat to the far
right of the task name and choosing Activate from the context menu.
When you activate a task, controls for providing the required inputs are shown in the
Task Center window (in the ArcGIS Explorer console). After activating the Find Place
task, you see fields for entering a place name and (optionally) a country to define your
search.
Type Timbuktu for the place name to find. Do not specify a country for the search.
In the Results window, right-click the matched record and choose Zoom.
ArcGIS Explorer rotates the globe and zooms in on Timbuktu (in Northern Africa).
ArcGIS Explorer is a powerful out-of-the-box client for consuming a variety of GIS
services. You will continue to work with ArcGIS Explorer as an ArcGIS Server client
throughout this course.
If you would like to view some more maps in ArcGIS Explorer, go on to the optional
next step. Otherwise, close ArcGIS Explorer without saving the map.
In the Open Map dialog box, choose ArcGIS Explorer Resource Center from the
drop-down list and click OK.
The ArcGIS Explorer Resource Center is a Web page hosted by ESRI that allows you to
use globes hosted by the ESRI ArcGIS Server.
Click one of the available globes or 3D basemaps from the page. When prompted to
open or save the file, choose Open.
The globe or map that you chose appears in the display area.
Take a few moments to navigate the new globe and/or explore other maps and globes.
When you are finished viewing the sample globes, close ArcGIS Explorer without
saving the map, and close your browser window.
Conclusion
In this exercise, you carried out all the steps required to make GIS data available on the
Web: you authored content using familiar ArcGIS Desktop applications, published GIS
services using ArcCatalog and ArcGIS Server Manager, and finally, you consumed GIS
services in an out-of-the-box client (ArcGIS Explorer) and a Web mapping clients (which
you built using Manager).
Answer: By default, server logs are written under the ArcGIS installation folder,
<ArcGIS Install Dir>\server\user\log (e.g., C:\Program
Files\ArcGIS\server\user\log\).
Answer: The default logging level is 3, which means that only administrative
messages, errors, and warnings get written to the log files.
Answer: Depending on your installation, there will be at least one, but there may be
several host machines managed by the server. The simplest installation will use a
single host machine (the GIS server itself).
Question 4: What are the three types of directories used by ArcGIS Server?
Answer: ArcGIS Server uses cache, jobs, and output directories. By default, these
directories are located under the ArcGISServer folder (e.g.,
C:\ArcGISServer\cache).
Question 5: What are some types of GIS services that can be hosted by this server?
Answer: Depending on your installation of ArcGIS Server, you may have the
following types of available services: geocode, geodata, geoprocessing, globe, and/or
map.
Answer: Answers will vary depending on your host name. The URL for Web
mapping applications built with Manager take the form http://<host
name>/<application name>/.
Answer: The keyboard shortcut for zooming in on the map is to hold both the
SHIFT key and the PLUS SIGN (+) key.
Question 8: When interacting with the map, what effect does spinning the mouse wheel
backward have?
Answer: Moving the mouse wheel backwards will zoom out from the map.
(Likewise, moving the wheel forward will zoom in.)
In this exercise, you will work through the entire process required to build a "parcel
search" Web mapping application. You will begin by authoring two GIS services
required for the application: a map service and a geocoding service. You will then create
a new Web mapping application using Manager and configure tasks in order to
incorporate additional GIS functionality into your application.
You will also be introduced to globe services. Content for globe services is authored
using ArcGlobe™ and may be consumed by ArcGlobe, ArcGIS Explorer, or certain
custom applications (built using the ArcGIS Engine Web Control). Additionally, you will
explore the ArcGIS tools available for building map and globe service caches to improve
service performance, and you will become familiar with the options that are available
when building such caches.
In this exercise, you will:
▪ Author and publish a map service
▪ Publish an address locator to create a geocoding service
▪ Add and configure the Find Address task in a Web mapping application
▪ Add and configure the Query Attributes task in a Web mapping application
▪ Author, publish, and consume a globe service
▪ Explore cache building tools and options for map and globe services
Click the Add Data button and navigate to the \Student\ISRV\Exercise03 folder.
Add Streets.shp.
Click the Add Data button again, and this time navigate to the Wilson ArcSDE
geodatabase.
Use ArcMap to symbolize the layers as you would like them to appear in the map
service.
When you are finished, save the map document in the \Student\ISRV\Exercise03
folder. Name the map ParcelMap.mxd.
Close ArcMap.
Start ArcCatalog.
Right-click the \Student\ISRV\Exercise03 folder and choose New > Address Locator.
In the Create New Address Locator dialog box, scroll down and select US Streets as
the style for the locator.
Click OK.
Depending on the style you choose for an address locator, you will be prompted for a
reference dataset and a set of required attributes for successfully locating an address. For
the US Streets style, you will need to point to a street dataset that contains (at a
minimum) attributes for street name and for house number ranges on the left and right
side of the street. ArcCatalog will try to determine these fields for you based on field
names in the dataset.
In the New US Streets Address Locator dialog box, type FindAddress as the name of
the new locator.
For Reference data, browse to the \Student\ISRV\Exercise03 folder and add the
Streets.shp shapefile.
The Fields information for the locator fills in for you automatically. Your dialog box
should look like the following graphic.
Right-click the ParcelMap.mxd document you authored earlier and choose Publish to
ArcGIS Server.
Click Next.
Click Next.
In the Catalog tree, navigate to the FindAddress locator you created earlier (in the
\Student\ISRV\Exercise03 folder).
In the Publish to ArcGIS Server wizard, leave the default name of FindAddress for the
new service.
Click Next.
In the summary panel, click Finish to create the new geocoding service.
You now have all the services necessary to deliver the functionality you were hoping for
in your Web mapping application. All you need to do now is use Manager to create the
application and configure the functionality you need.
Once both of the services are created and running, close ArcCatalog.
Click Create Web Application to begin creating a new Web mapping application.
In the first panel of the wizard, type Parcel Search as the name of the application.
For description, type A kiosk application that allows users to find parcels or
address locations.
Click Next.
In the following panel, expand the Internet connection to your server and select the
Maps/ParcelMap map service. Add this service as a layer in the application.
Click Next.
In the next panel, add the Find Address and Query Attributes tasks, as shown below.
Expand the Internet connection to your server and add the Locators/FindAddress
service as a supporting service.
Some tasks, such as Find Address and Geoprocessing, require a supporting GIS service in
order to function. You will work with the Geoprocessing task (and its supporting service)
in lesson four.
Select the Find Address task in the task list and click Configure.
Each task that you add to a Web mapping application has settings that you can configure
for controlling task behavior and appearance.
In the configuration dialog box for the Find Address task, keep all the default settings
and click OK.
You will now configure the Query Attributes task to perform the appropriate parcel
search (locate features using the parcel ID).
Click the Query Attributes task in the task list, then click Configure.
In the Query Settings portion of the dialog box, choose Parcels as the layer to query.
In the dialog box that appears (shown below), type Select Parcel ID: as the label text.
Choose MBL as the field to query (this field contains a unique ID for each parcel).
! If you do not see the MBL field appear in the list, close the dialog box
and verify that you chose the Parcels layer in the previous dialog box.
Click Get Sample Values to get the complete list of values for this field.
When you have completed configuring the query expression, click OK.
Click Next in the remaining panels of the Web mapping application wizard (accept all
default settings).
If your new application does not start, click the appropriate link in the Web
Applications panel to start it.
You will now test the new Web mapping application to make sure the tasks you've
configured will accurately locate parcels and addresses throughout the city.
If it is not already running, start the Parcel Search Web mapping application.
In the application's Tasks window, you should see the two tasks that you configured: Find
Address and Find Parcel by ID. To start, you will use the Query Task to locate a parcel
using its ID.
Right-click the record for the parcel feature that was found and choose Zoom to.
Try finding a few more parcels using the Find Parcel by ID task to make sure the task
works consistently.
Once you are confident that the query task works well, you will test the Find Address
task by searching for a few familiar addresses throughout the city.
Close the Find Parcel by ID task by clicking the "X" in the upper-right corner of the
dialog box.
In the Tasks window, click the Find Address task to launch it.
In the text box, type the address for the city office building, which is 620 Viola St, and
click Find.
If the address locator and resulting geocoding service were created correctly, you should
have a match for the address in the Results window.
In the Results panel, expand the listing for 620 Viola St.
If it is not already checked, check the check box next to the address.
Right-click the location that was matched, and choose Zoom to.
You should see a cyan (light blue) push pin at the location that was matched.
In the Find Address task, type Reid St @ Nash St and click Find.
With very little effort, and some standard ArcGIS Server Web mapping application tasks,
you have produced an application that makes information about your city more accessible
to its inhabitants. As interest in the application grows, perhaps you will update it to
include information about voter precincts and polling locations, local schools, public
transportation schedules, etc. Perhaps you will add additional functionality, such as the
ability to get driving directions.
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
ArcGlobe to start ArcGlobe.
Right-click the new layer in the table of contents and select Zoom To Layer.
In the ArcGlobe table of contents, drag the new layer to the top of the layer list (it is
currently being obscured by the Continents layer).
Note: When a globe service is published from a globe document, globe properties (such
as sun angle, background colors, and even layer order) do not carry over. When
consuming a globe service, the client works with individual layers from the globe and not
with the service as a whole. Changing the layer order, therefore, has no effect on the
output globe service; it simply allows you to get a better idea of what the image will look
like when consumed from the service.
Close ArcGlobe.
You will now use ArcCatalog to publish a globe service from the document you authored
above.
Start ArcCatalog.
In the Catalog tree, expand the GIS Servers folder and locate your GIS server.
You will begin by making a folder to organize your globe services.
A new folder (appropriately named New Folder) is added beneath the server folder in
ArcCatalog.
In the Catalog tree, right-click the Globes folder and choose Add New Service.
The quickest way to create a new service is to right-click the object to publish (map,
globe, locator, etc.) and choose Publish to ArcGIS Server. The Add New Service option,
however, allows you to initially define more preferences for the service rather than
simply taking default values for them. Although you will not change most of these
values, you will use the Add New Service wizard in order to see the preferences that are
available.
In the first panel of the Add GIS Service wizard, choose to publish a globe service.
Name the new service Pyramids.
Click Next.
Choose the default ArcGIS Server cache directory from the drop-down list.
Click Next.
In the next panel, keep the default settings for Web access and operations allowed.
Notice that, unlike map services, globe services have a single capability, Globe, which is
always enabled. Globe services also have three operations allowed options: Globe,
animation, and query.
Click Next.
Keep the default settings for Pooling and Timeouts and click Next.
In the next panel, keep the default settings for the isolation level and recycling.
Note: Settings such as pooling, timeout, recycling, and isolation level can have an
impact on functionality and performance. The ArcGIS Server documentation contains
detailed information regarding these settings.
Click Next.
The final panel of the wizard displays a summary of the settings you've provided for the
new globe service. You have a choice to start the service upon completing the wizard, or
starting the service manually later.
If you forgot to start the service upon completing the wizard, right-click it now and
choose Start.
Since they are fairly specialized services for interacting with 3D data, globe services have
a limited number of clients available for consuming them: ArcGlobe and ArcGIS
Explorer. In the next step, you will use ArcGIS Explorer to view the Pyramids globe
service.
Click the Start button on your desktop and navigate to All Programs > ArcGIS >
Explorer to start ArcGIS Explorer.
When the application starts, the default map from the ESRI server displays in ArcGIS
Explorer's main window.
Note: If you start ArcGIS Explorer without an Internet connection, you will see a
wireframe lattice of the globe instead of the default map.
At the top of the dialog box, click ArcGIS Server in the Create New Connection group.
Provide the URL for your GIS server. Remember that the form of the URL is
http://<host name>/<ArcGIS Server instance/Services.
Note: Refer to your notes in the first exercise for the host name and server instance for
your installation.
Click OK.
Once you have created a connection to your server, expand the listing for the server
and for the Globes folder to locate the Pyramids service.
Expand the listing for the Pyramids service and select the Giza layer.
In the Contents window, right-click the Giza layer and select Zoom to Layer.
ArcGIS Explorer rotates and zooms the globe to position the extent on the Giza layer.
This layer provides a higher-resolution view of the terrain displayed in the underlying
ESRI service. ArcGIS Explorer allows you to set transparency for layers in the map in
order to view the features drawn underneath.
Use the Explorer Navigation control to zoom in closer to the pyramids displayed in the
image.
If you like, tilt the surface to see the 3D effect of the globe.
Right-click the Giza service in the Contents window and select Transparency.
Slowly move the transparency slider up and then back down to see the effect in the
map display.
The ability to set transparency for layers in ArcGIS Explorer can be very useful when
displaying layers that may obscure the terrain beneath, such as land-use polygons or
DRGs (digital raster graphs).
When you are finished working with the map, save it in the default location with the
name Pyramids.nmf.
Start ArcCatalog.
In the Catalog tree, expand the listing for your GIS server.
On the Map Service Properties dialog box, click the Caching tab to view properties of
the service's cache.
Note: Caching properties are not available unless the service is running.
The Generate Map Server Cache tool gives you a lot of control over how the map cache
is created. As you become more familiar with the options that are available here, you may
wish to use them to customize your cache output. For now, you will mostly use default
settings for the cache.
Scroll through the Generate Map Server Cache options until you reach the Number of
Scales field.
Map server caches can be created at a variety of user-defined or predetermined scales. As
data is requested at different extents, a pre-rendered image from the nearest scale can be
pulled from the cache and resampled for display on the client. If you choose Standard as
the method for determining caching scales, ArcGIS will calculate which scales to use
(based on the number of scales requested). If you want more control over the caching
scales, you can select Custom and then enter the scales manually.
When you leave the scales text box (by clicking outside the text box or hitting your TAB
key), the scales calculated by ArcGIS for the cache will be displayed in the Scale text
area. The first scale level is determined by dividing the scale of the map service's full
extent by two. Each subsequent scale level is determined by simply dividing the previous
scale by two.
Scroll to the bottom of the Generate Map Server Cache dialog box.
There are two types of caches available for a map service: Fused (the default) and
Multilayer. In a fused cache, all layers in the service are displayed in the cached images.
A multilayer cache, on the other hand, allows you to create individually cached images
for selected layers in the service.
In general, fused caches result in better performance, since the map server no longer
needs to read data for the layers (it simply serves images from the cache to the client).
When the service is viewed on the client, however, individual layers cannot be toggled on
or off, and any changes to the underlying data will not be updated in the service (until the
cache is refreshed).
A multilayer cache has the advantage of allowing client applications to toggle layer
visibility. More importantly, it ensures that changes to a layer's data will be instantly
reflected in the client.
When creating a cache for your map service, it is therefore important to determine which
layers should be cached (static map content), and which ones should be drawn using calls
to the underlying database (dynamic content).
In the list of input layers, check all but one of the map service layers.
Note: The layers in your service will likely vary from those shown in the following
graphic.
Click Close.
Depending on the size of your map service, the number of layers, the processing speed of
your computer, and (most importantly) the number of scales, building a map server cache
may take a while. The simple cache for this map service should not have taken long to
complete.
Close ArcCatalog.
You will now view the map service to see if caching has any effect on the map display or
performance.
When Manager is used to create a Web mapping application for a cached service,
zooming with the mouse wheel will zoom to scale levels supported by the cache. You
will rebuild the application in order to provide the zoom level support for zooming with
the mouse wheel.
If necessary, log in to ArcGIS Server Manager and click the Applications panel.
Use the Create Web Application wizard to create a new Web mapping application
called Cache Test.
From the Internet connection to your GIS server, choose the CaliforniaService map
service.
Use the default settings for the rest of the options and click Finish.
When you are finished viewing the map, close your Web application, ArcGIS Server
Manager, and any other open applications or windows.
While caching is usually the most important factor for improving the performance of
ArcGIS Server client applications, there are many other considerations as well. Later in
the course, you will learn more techniques for optimizing your GIS services.
Conclusion
In this exercise, you gained more experience authoring and publishing map services for
ArcGIS Server. You also learned to publish an address locator to produce a geocoding
service. You created a specialized Web mapping application that provided GIS
functionality through tasks that you configured using Manager.
You became familiar with globe services and their ability to provide three-dimensional
visualization of geographic data. Content for globe services can only be authored using
ArcGlobe and may be consumed by ArcGlobe, ArcGIS Explorer, or certain custom
applications (built using the ArcGIS Engine Web Control).
Finally, you were also introduced to the ArcGIS tools available for building map service
caches. You learned about the options available when building a cache and how those
options can affect map display and performance.
Answer: The cache may be located in any folder that has been defined as a cache
folder for your GIS server. The default cache folder is under the ArcGISServer
folder on your machine (e.g., C:\ArcGISServer\ArcGISCache\). Each service may
have a subfolder here that contains the cache. By default, these folder are named
with the convention <folder name>_<service name> (e.g., Maps_Tahoe).
associated map service). Features resulting from running the model will be stored
(temporarily) on the server and will not be sent to the client.
In this step, you will create a new toolbox accessible to ArcGIS Server, add the toolbox
to a new map document, and set up the geoprocessing environment appropriately.
Note: When publishing a geoprocessing service, ArcGIS Server must have adequate
access and permissions on the data used by the service and the toolbox that contains the
geoprocessing models.
Before authoring a geoprocessing model or map for a new geoprocessing service, you
will first create a new toolbox to contain the models. The toolbox must be located in a
folder that is accessible to ArcGIS Server, so you will add it under a folder that is already
accessible to ArcGIS Server, your Student\ISRV folder.
Start ArcCatalog.
Right-click the folder and choose New > Toolbox from the context menu.
Close ArcCatalog.
From the geodatabase, add the Parcels and the Streets feature classes to the map.
In the Add Toolbox dialog box, navigate to the \Student\ISRV\Exercise04 folder and
open the Parcel Tools toolbox.
On the Geoprocessing tab of the Options dialog box, click Environments (as shown in
the following graphic).
In the Environment Settings dialog box, click General Settings to expand it.
Set the scratch workspace by typing the UNC path to your \Student\ISRV\Exercise04
folder (the first part of the path, your machine name, will differ from the example
below).
Note: If the machine on which you are authoring is also your GIS server, you may use
local pathnames (e.g., \Student\ISRV\Exercise04) rather than UNC pathnames.
Regardless, UNC pathnames will work for referring to local or remote folders (as long as
they are shared appropriately). Referencing resources on a remote machine from your
server machine always requires the use of UNC paths.
Click OK on the Environment Settings dialog box, then click OK on the Options
dialog box.
The Scratch Workspace setting is used to control where intermediate datasets get written
when a geoprocessing model is executed. The %SCRATCHWORKSPACE% variable
can be used in a model or script to refer to this location when processing models locally.
When a model in a geoprocessing service is executed, ArcGIS Server will use a folder
under the configured Jobs folder for scratch output.
Right-click the Parcel Tools toolbox and choose to create a new model.
A new (empty) ModelBuilder window opens. By default, the new model is simply named
Model. You will use the Model Properties dialog box to provide a more descriptive name
and label for the model.
On the General tab of the Model Properties dialog box, type ClipParcels for the model
name and Clip Parcels with Buffer as the label.
user to draw a line on the map, 2) buffers the line by a specified distance, 3) clips features
in the Parcels layer using the buffer, and then 4) displays the resulting parcels on the map.
Drag the Buffer tool from the toolbox onto your model.
You can incorporate any of the existing ArcToolbox tools into your model, as well as
custom scripts or models you've created. Now that you've added the Buffer tool to the
model, you will define input and output parameters that the tool requires.
Note: When a portion of a model is not colored (as shown in the example above), it is an
indication that the piece of the model is not ready to run. Once you have specified all
input and output requirements for the Buffer tool, you will see the color change to
indicate a "ready" state for the process.
Right-click the Buffer tool (square) in the ModelBuilder window and choose Make
Variable > From Parameter > Input Features.
A new object that represents the input features to buffer is added to the model. Rather
than using features from a dataset, however, your model will allow the user to draw a line
on the map to use as the buffer input.
Right-click the Input Features variable (oval) in the model and choose Properties.
On the Data Type tab of the Input Features Properties dialog box, choose Feature Set
from the Select data type drop-down list.
From the Import schema and symbology drop-down list, select the Streets layer.
By setting a layer in the map to use for schema and symbology, you are indicating that
the input shapes drawn by the user will be lines with the same attributes defined for the
Streets feature class. Although it won't be necessary for your model, the user can add
attribute values for the input features as well. These line features will be drawn on the
map using the symbology you've defined for the Streets layer.
Click OK on the Input Features Properties dialog box to save your changes.
The color of the Input Features shape changes to blue in the model. This indicates that
this particular piece of the model is sufficiently defined and ready for execution.
Right-click the Input Features oval in the model again and choose Model Parameter.
A small letter P appears to the upper right of the oval, indicating that the value for the
buffer input will be a parameter for the user to define (e.g., by drawing on the map). In
order to allow the user to define the distance to use, you will add another variable to the
model.
In the Create Variable dialog box, scroll through the list of variable types and select
Linear unit.
Click OK.
A new variable named Linear unit is added to the model. Notice, however, that the
variable is not connected to anything else in the model. Since the linear unit represents
the distance used to create the buffers, you will connect this variable as an input to the
Buffer tool in the model.
Note: Feel free to alter the size and position of shapes in the ModelBuilder window. The
layout of the model has no effect on how the model is ultimately executed (e.g., it is not
always run from right to left, top to bottom).
Use the Add Connection tool to draw a line between the Linear unit input variable and
the Buffer tool.
Regardless of the direction in which you drew the line, you should see a connection
appear that points from the Linear unit input to the Buffer tool.
Right-click the Linear unit variable and set it as a model parameter (as you did earlier
for the input features).
Double-click the Linear unit variable and, in the Linear unit dialog box, provide an
initial (default) value of 50 meters for the buffer distance.
Right-click the Output Feature object on the model and choose Rename.
Type Out Buffers as the new name for the output and click OK.
You now have a simple model that will allow the user to draw input line features on the
map and then buffer them a specified distance. You will now add to the model so that the
buffers are used to clip features in the Parcels layer.
In ArcToolbox, under the Analysis Tools toolbox, expand the Extract toolset.
Double-click the Clip tool in the model to open its input dialog box.
From the appropriate drop-down lists, choose the Parcels layer as the input features
and Out Buffers as the clip features.
Replace the folder portion of the Output Feature Class with the
%SCRATCHWORKSPACE% variable (as shown in the following graphic).
The entire model should now appear in color, indicating that it is ready to execute. Notice
that each type of component in a model (input, output, tool, etc.) has a distinct color.
Before testing the model, however, you will first set some properties to define how and
where output data from the model will be written.
Right-click the Out Buffers shape in the model. Make sure that Model Parameter is not
checked, and that Managed and Intermediate are.
The Managed and Intermediate options indicate that the output data will be temporary
(i.e., for use in another model step) and that ArcGIS will control the location of the
output data.
Right-click the output from the Clip tool (Parcels_Clip.shp). Make sure that Managed
and Intermediate are not checked, and that Model Parameter and Add To Display are.
In the ArcToolbox window, double-click your model (Clip Parcels with Buffer) to
open the input dialog box for the model.
The dialog box that opens contains controls for specifying all the inputs required to run
the model. Recall that your model contains three required inputs: a feature (or features) to
buffer, a buffer distance (linear unit), and an output dataset location.
Use the Input Features tool to digitize a line on the map with the mouse (as shown
in the following graphic).
Note: The feature type (line), symbology, and schema for the input features were defined
in the model by specifying the Streets layer as a template. In addition to digitizing the
feature, users may also edit attribute values for the feature by clicking the table icon in
the input dialog box.
If you like, in the Clip Parcels with Buffer dialog box, change the default buffer
distance value you provided when authoring the model (50 meters).
Right-click the Parcels_Clip layer in the table of contents and choose to Remove to
remove it from the map.
Drag the model (Clip Parcels with Buffer) from the ArcToolbox window to the table of
contents.
Note: Make sure the tool layer is at the top of the table of contents to ensure that features
in the output layer (Clipped Parcels) are not obscured.
In the table of contents, click the symbol for the Clipped Parcels layer to open the
Symbol Selector dialog box.
Choose a symbol for the layer that stands out from the one used for the Parcels layer
(e.g., bright red or yellow), and apply a distinct color to the parcel outline.
Turn off visibility for the Clipped Parcels layer. Hint: Uncheck the check box next to
the layer name.
Close ArcMap.
Click the Publish a GIS Resource link at the top of the application.
Type Parcels_GP as the new service name, and publish it in the (existing) Maps
folder.
Click Next.
On the following panel, make sure that Geoprocessing is enabled and checked in the
list of capabilities.
Click Next.
The final panel of the wizard confirms that a map and a geoprocessing service will be
created.
After verifying that the services have been created and are running, you are ready to
move to the next step: creating a Web mapping application to consume the services.
In the first panel of the wizard, type Riverside Parcels as the name of the application.
You may leave the description blank.
Click Next.
In the following panel, expand the Internet connection to your GIS server.
Click Next.
In the Available Task Items list, select Geoprocessing and click Add.
Before you can configure preferences for this task, you must identify the supporting
geoprocessing service that will provide the task functionality.
In the list of available services, expand the Internet connection to your server, and
select Maps/Parcels_GP.
Click Add.
You already added the service called Maps/Parcels_GP to the application—so why are
you doing it again? Remember that you have two services with this name. The first one
you selected for the application was the map service. The service you selected above is
the geoprocessing service based on the tool layer in the map.
Click the Geoprocessing task item in the Current Tasks list and click Configure.
In the dialog box that appears, you are able to specify which geoprocessing functionality
the task will provide, the name and tool tip that will appear for the task, and settings that
control how results will be handled.
In the Task Definition list, expand the listing for the Parcels_GP service and choose
the Clip Parcels with Buffer task.
Since a geoprocessing service is created by publishing an entire toolbox, you could
potentially have several models (tasks) listed under the service folder to choose from.
Keep the default values for the rest of the geoprocessing task settings.
An asynchronous geoprocessing task is one that runs on the server while the user of the
client application is free to continue working. The Web mapping application needs to
check the server periodically to determine whether processing is complete. The interval at
which the application checks for completion of asynchronous tasks may be configured
appropriately (ten seconds is the default setting).
There are also settings for where data is written as a result of running the task, and size
limits for data that may be uploaded to the server (e.g., input files for the task).
Click Next and keep the default settings on the rest of the wizard panels.
On the Summary panel, click Finish to complete the Web mapping application.
If the Web mapping application opens upon completion of the wizard, leave it open. You
will use the application in the next step to consume the geoprocessing service by
executing the Clip Parcels with Buffer task.
If it's not already running, start the Riverside Parcels Web mapping application that
you created in the previous step.
You see your task (with the name and help tip you configured) shown on the Tasks
window in the console.
Click the Clip Parcels with Buffer task to open the input dialog box.
The input controls for the task are built dynamically by the application based on task
information from the geoprocessing service. Your task requires a line feature (drawn by
the user on the map) and a buffer distance.
Use the Line tool to draw a line on the map. Click once to define each vertex for
the line, then double-click to end.
Specify a buffer distance, making sure it's reasonable for the current map extent, (e.g.,
50 meters).
When task processing completes, a new layer will be added to the map displaying the
results of the clip. The Results window will show a legend for the new layer, as well as
any messages that were generated during processing (including error messages if the task
was unsuccessful).
If you were able to successfully execute the task, you should see output similar to that
shown above. You will now find out where ArcGIS Server wrote the output dataset that
was produced.
In the Results window, if it is not expanded already, expand Clip Parcels with Buffer
Results.
Locate and expand Messages to view processing details for the task.
Locate the line that begins "Executing (Clip): Clip Parcels ..." (shown in the following
graphic).
Scroll across the Results window to read the output path for the clipped parcels dataset
(Parcels_Clip.shp).
The path should look something like:
c:\arcgisserver\arcgisjobs\Maps\Parcels_GP_GPServer\J114492488E8B42E7B23B862790CF7165\scratch\.
When a task is executed, ArcGIS Server creates a unique job folder for the tool to use
(the long alphanumeric folder name ensures it has a unique name). Inside this job folder
is a folder named "scratch." The scratch workspace environment is set to this folder,
ensuring that the output from your model (sent to %SCRATCHWORKSPACE%) is
written to the scratch folder for the executing task.
Start ArcCatalog.
When you are finished viewing datasets in the scratch folder, close ArcCatalog and
ArcGIS Server Manager.
If you would like to learn how to consume your geoprocessing service in ArcMap, go
on to the optional next step. Otherwise, skip to page 4-34.
Navigate to the Parcels_GP geoprocessing service that is running on your GIS server.
! Make sure you add the geoprocessing service, not the toolbox in the
Student folder that you authored earlier.
Click the Add Data button and add the Streets feature class in the Riverside.mdb
database as a layer to the map. Do not add any other layers or the associated map
service (Parcels_GP).
Double-click Clip Parcels with Buffer to open its input dialog box.
Draw a line on the map and specify a buffer distance (or leave the default value).
Click OK.
The results of running the model are displayed using the symbology defined in the tool
layer of the associated map service.
Note: You may receive a message regarding a difference in the output resolution and the
input feature class resolution. You can ignore this message, as it should have no impact
on the results of running the geoprocessing model.
When you are finished, close ArcMap. Do not save changes to the map document.
Conclusion
In this exercise, you stepped through the entire process required to make geoprocessing
functionality available on the Web. You began by creating a toolbox and authoring a
geoprocessing model. When authoring the model, you made sure to conform to the
requirements for publishing a geoprocessing service (using the Feature Set data type
instead of Feature Class, appropriate use of managed and intermediate variables, etc.).
You published a map document that contained your model as a tool layer, which created
two GIS services: a geoprocessing service and an associated map service. Finally, you
used the geoprocessing service to configure your own geoprocessing task in a Web
mapping application.
Geoprocessing services allow users to access functionality contained in geoprocessing
models over the Web. They provide a way to consolidate GIS data and functionality on a
GIS server for use by a variety of clients. Geoprocessing services can be created by
publishing an ArcToolbox containing the models you wish to provide, or by publishing a
map document containing a tool layer based on one of your models.
Once published, a geoprocessing service can be consumed by a Web mapping
application, ArcGIS Explorer, or ArcGIS Desktop. In ArcGIS Desktop, a geoprocessing
service will appear as a toolbox. All tools (geoprocessing models) contained within will
behave like any other tool in ArcToolbox. In ArcGIS Explorer and Web mapping
applications, functionality from geoprocessing services is exposed as tasks.
If the map service you are using meets certain requirements, you can create a Web
mapping application that contains the Editing task. The Editing task provides a suite of
tools for Web-based editing of features (geometry and attributes) in an ArcSDE
geodatabase. While shapefiles, personal geodatabase, and file geodatabase layers may
also be included in the map service, they will not be editable in the Web mapping
application.
You will author a map that contains layers from an ArcSDE geodatabase. After
publishing the document as a map service, you will create a Web mapping application
and configure the Editing task to allow users of the application to make edits to the data.
In this exercise, you will:
▪ Author a map document containing layers that may be edited in a Web mapping
application
▪ Publish a map service and configure it appropriately for editing
▪ Create a Web mapping application that uses a local connection to the service
▪ Add and configure the Editing task for the Web mapping application
▪ Explore the editing tools provided in a Web mapping application with the Editing
task
If you have ArcToolbox open from the previous exercise, close it now if desired.
Click the Add Data button and add the following feature classes from the Wilson
ArcSDE geodatabase:
▪ Parcels
▪ BusRoutes
Feature classes from an ArcSDE geodatabase can be edited using a Web mapping
application when the Editing task is configured. But what if you don't want all of these
layers to be available for editing? When you configure the Editing task in a later step, you
will see that individual layers can be restricted from editing if desired.
Click the Add Data button again and add the Streets.shp shapefile dataset from the
\Student\ISRV\Exercise05 folder.
The Streets layer will not be available for editing in the Web mapping application. The
layer will be used for display, and can also be used as a target for snapping while editing
features in the other layers.
Right-click the Streets layer and choose Properties to open the Layer Properties dialog
box.
Click the Labels tab and check the check box next to Label features in this layer.
Verify that the NAME field will be used for the labels.
On the Symbology tab, choose a red line symbol for the streets.
Use the Layer Properties dialog box for the BusRoutes layer to apply a thick blue line
symbol to the features. When you are finished, click OK.
When you are finished symbolizing layers in the map, zoom to a portion of the
downtown area where the bus routes meet (as shown below).
Close ArcMap.
satisfied when the editing application is created in Manager: a local connection to the
service must be used.
In this step, you will publish the map document you authored in the previous step, which
contains two layers from an ArcSDE geodatabase. You will make sure it is created as a
non-pooled map service.
Start ArcCatalog.
In the first panel of the Add GIS Service wizard, type Wilson as the name of the
service.
Verify that the service type is set to Map Service and the startup type is Automatic.
Click Next.
In the following panel, set the Map Document by navigating to the Wilson.mxd
document you authored in the previous step (in your \Student\ISRV\Exercise05
folder).
Keep the default values for the rest of the settings on this panel, and click Next.
In the next panel, keep the default settings for capabilities and Web access, and click
Next.
In the following panel, make sure to choose the Not pooled option.
In a non-pooled map service, each user session will have a dedicated instance with which
to work. This is an important factor to consider when creating a Web mapping
application that will contain the Editing task. You should also set the maximum number
of instances according to the maximum number of concurrent users you expect to be
using the service.
Keep the defaults for the other settings, and click Next.
In the final panel, choose the option to start the service right now.
step, you will create a Web mapping application that will consume the Wilson service.
You will use a local connection, then add and configure the Editing task appropriately.
Click Create Web Application at the top of the Web Applications panel to start the
wizard.
For the description, type Provides tools for editing the bus routes and parcels
datasets.
Click Next.
In the following panel, expand the local connection to your GIS server.
! Use of the Editing task requires a local connection to the map service
you wish to edit. If you select the Wilson service from the Internet
connection to your server, you will get an error later when trying to
configure the Editing task.
Select the Wilson map service and add it as a layer in the application.
Click Next.
In the next panel, select Editing from the list of available tasks and click Add to
include it in the application.
The Editing task must now be configured to define which versions and layers are to be
editable (as well as other preferences such as the types of edits to be allowed, snapping
behavior, and basic display options).
On the General tab of the Task Configuration dialog box, type Edit Routes or Parcels
as the Display name for the task.
Select all layers in the Editable layers list (there should be two: BusRoutes and
Parcels) and all versions in the Editable versions list (you should only have the default
version).
Notice that only the layers from your ArcSDE geodatabase appear in the list of available
layers to edit.
On the Settings tab, configure snapping to occur to the edges of street features.
Even though you could not choose the streets layer for editing, you can use it for creating
a snapping rule. This will be especially useful when editing bus routes that must be
coincident with the underlying street network.
Verify that users will be able to change snapping and selection settings.
Finally, click the Advanced tab on the Task Configuration dialog box.
This tab contains options for defining and resolving conflicts when edits are reconciled to
the geodatabase. You will keep the default settings for these options.
Click OK in the Task Configuration dialog box to apply your changes and close the
dialog box.
Keep the default setting for the connection account. Click Next.
Keep the default settings for the page properties. Click Next.
Finally, keep the default settings in the map elements panel. Click Next.
Click Finish on the Summary panel to complete the Web mapping application.
When planning a Web mapping application that will contain editing functionality, there
are design issues to consider at each step in the process. When authoring the map
document for the service, editable data must come from an ArcSDE geodatabase. When
publishing, the map service must be configured as non-pooled. Finally, when creating the
Web mapping application, a local connection to the service must be used. If each of these
criteria have been satisfied, the Editing task can be included in the application.
Now that you have successfully created a Web mapping application that includes the
Editing task, you will start the application and get a feel for how editing works in a Web
application.
If it isn't already running, start the Web Editor application you created in the previous
step.
You should see the Editing task you configured in the Tasks window (Edit Routes or
Parcels).
Click Start Editing to begin an edit session on the default version of the data.
After choosing the version, you are presented with a set of editing tools. At the top of the
task window, you can select the current layer for editing from a drop-down list. Only
layers that you set as editable when configuring the task will appear here. As you change
the edit layer selection, you may see the available tools for the task change according to
the feature type of the chosen layer (e.g., tools specific to points, lines, or polygons).
Use the Zoom in tool to zoom to where the three bus routes meet.
Notice that parts of the bus routes do not conform with the geometry of the street
network. You will edit a portion of a route to make it coincident with the streets.
Use the Select Feature tool in the task to select the route that comes from the east
(as shown in the following graphic).
Zoom in closer to a portion of the route that does not line up with the underlying
streets.
You will now move the new vertex so it lines up with the underlying street. Because you
set snapping for the edges of street features, you can be assured that the vertex will be
moved a location coincident with a street feature (as long as you click within the
specified snap tolerance).
First, click the new vertex and release your mouse button (do not attempt to click and
drag).
Move your mouse to the new location for the vertex, then click again to define this
location.
Make sure there is a street feature within the snapping distance of the new location for
the vertex. (The current snapping tolerance is indicated by the red circle that you see
around your mouse.)
After moving the vertex, you should see it snap to a street feature (as long as the location
you clicked was within the snapping tolerance).
Continue to use the Add Vertex and Move Vertex tools to clean up the route (it doesn't
need to be perfect!).
In addition to editing the geometry of existing features, you can also use the Editing task
to create new features and edit attribute information.
Use the Zoom out tool to zoom the map to an extent similar to that shown below.
Use the Create Feature tool to draw the new bus route shown below. Click once to
define each vertex, then double-click to complete the line.
The route will start where the other routes meet (the intersection of 4th and Nash) and
proceed to the corner of Academy and Carroll Streets.
Holding the S key on your keyboard while editing will show you if (and to which layer)
snapping will occur once you click the mouse.
Make sure the new route snaps to features in the Streets layer.
After creating the new route, use the Edit BusRoutes Attributes section of the task to
type a new RouteNumber of 605-A.
Notice that the task warns you when there are unsaved edits for the current edit session.
You will now save your edits before continuing. If you were to close the task with
unsaved edits, you would be prompted to save or discard them.
Click the Save Edits tool to save your work up to this point.
Notice that after saving, the warning about unsaved edits is no longer displayed.
Remember that once you save, you can no longer undo or redo previous edits.
You will make a final edit, this time to features in the Parcels layer.
Zoom in on the area around the end of the new bus route.
Use the Select Features tool to select a group of parcels at the end of the bus route.
Note: Unlike working with a selection in ArcMap, you do not need to hold the SHIFT
key in order to add or remove from the selection set. Clicking an unselected feature will
add it to the selection, while clicking a selected feature will remove it from the selection.
Once the parcels have been selected, click the Merge Features button to merge the
selected parcels into a single feature.
Click the "X" in the upper-right corner of the edit task to close the dialog box.
Conclusion
In this exercise, you completed the entire process required to create a Web mapping
application that contains editing functionality. First, you authored a map document
containing the datasets you wished the user to edit from an ArcSDE geodatabase. You
then published the map document as a non-pooled map service. Finally, you created a
Web mapping application using ArcGIS Server Manager and added the Editing task. You
learned to configure the Editing task to control things like editable versions, editable
layers, and snapping and selection preferences.
You also experimented with the editing tools provided by the Editing task, and made
some simple edits using your Web mapping application.
Geodata services allow you to provide access to data throughout your local area network
or across the Internet. These services give users the ability to make local copies of the
data (extract), execute queries against the geodatabase, or work with geodatabase
replicas. Geodata services can be created using any type of geodatabase (ArcSDE,
personal for Access, or file) and can be created by either publishing the geodatabase
directly or by publishing a map document that contains geodatabase data and enabling the
Geodata Access capability for the service.
In this exercise, you will publish a map that has already been authored for you. The map
contains geodatabase layers that show buildings, parcels, and streets for an area around
Oregon State University in Corvallis, Oregon. The geodata service will allow you to
make your own set of edits to the data—specifically, the new OSU library that will
(someday) be built in your honor!
In this exercise, you will:
▪ Publish a map service and enable the Geodata Access capability
▪ Use the Distributed Geodatabase toolbar in ArcMap to extract data from a geodata
service
▪ Create a checkout/check-in replica from a geodata service
▪ Synchronize edits from a replica
Start ArcCatalog.
For Publish to folder, choose Create a new folder. Name the new folder Geodata.
Click Next.
On the following panel, make sure to check the Geodata Access capability.
Enabling the Geodata Access capability will create a geodata service in the same folder
(and with the same name) as the map service (OSU).
Click Next.
The summary panel should confirm that two services named OSU will be created: a map
service and a geodata service.
When the Publish to ArcGIS Server wizard completes, verify that the two new services
appear in ArcCatalog in the Geodata folder.
Geodata services have three operations that can be allowed: extraction, query, and
replication. When you create a geodata service using the Publish to ArcGIS Server
option, you are not prompted for which operations to allow. By default, extraction and
query are allowed, and replication is not. Next, you will edit the service properties to
make sure that replication is an allowed operation.
On the Capabilities tab of the Service Properties dialog box, check Replication as an
operation to allow.
Right-click the listing for the OSU geodata service again and choose Start.
replica is much different than a local copy of the data, in that it allows edits to be
synchronized between geodatabases.
In this step, you will work with the Distributed Geodatabase tools in ArcMap to extract a
copy of the data in the OSU service, and to create a geodatabase replica to edit and
synchronize.
Navigate to your OSU map service (in the Geodata folder) and add it to the map.
The map is centered on Oregon State University in Corvallis. It shows the campus
boundary and buildings, as well as buildings, roads, and parcels in the surrounding area.
Right-click the ArcMap interface and choose to display the Distributed Geodatabase
toolbar.
The Distributed Geodatabase toolbar contains tools for extracting data and for working
with geodatabase replicas. Many of these tools are also available by right-clicking a
geodatabase (or geodata service) in the Catalog tree.
When the toolbar appears, you may notice that the only two tools that are currently
enabled are the Extract Data tool (far right) and the Create Replica tool (far left). All of
the tools in between require an existing geodatabase replica before they are enabled.
You will first experiment with extracting data from the service.
Select the New Polygon tool on the Draw toolbar (probably located at the bottom
of your ArcMap window).
Draw a polygon on the map that generally follows the university boundary.
When the polygon graphic is complete, make sure it is selected in the map display
(selected graphics have a faint blue box around them). If it is not already selected, use
the Select Elements tool to select the polygon.
The Extract Data tool will allow you to restrict the features you extract according to a
defined extent, the current map extent, or by features that intersect a selected graphic.
You will extract only those features that are inside your polygon graphic (the campus
boundary).
In the first panel of the Extract Data Wizard, choose to extract the data to the
OSU_Extract.mdb personal for Access geodatabase in your \Student\ISRV\Exercise06
folder (this is an empty geodatabase that was already created for you).
Click Next.
In the following panel, verify that the boundary of currently selected graphic option is
checked. If this option is not enabled, cancel the Extract Data wizard, make sure the
polygon graphic is selected on the map, then start the wizard again.
Keep the default values for the other options. Click Next.
Delete the polygon graphic of the university boundary (hit the delete key on your
keyboard while the graphic is selected).
Click the Add Data button and navigate to your \Student\ISRV\Exercise06 folder.
Choose to add all the feature classes from the OSU_Extract.mdb personal for Access
geodatabase.
The extracted datasets should only contain features that intersected the polygon graphic
you drew on the display.
When you are finished viewing the extracted datasets, remove them from the map.
Hint: Right-click each layer and choose Remove.
The Check-out option will create a replica of the geodatabase that can be edited and later
synchronized with the parent geodatabase. Changes may only be synchronized once. In
order to make and synchronize additional edits, you will need to create another checkout
replica.
Click Next.
Click Next.
In the following panel, make sure that the current display extent is selected as the
checkout extent.
Notice that you can choose which datasets to include in the replica. You can also restrict
the data returned for a replica using a specified extent or a selected graphic.
Click Next.
Click Finish in the final panel of the wizard to create the replica.
You will now add the datasets from the replicated geodatabase to a new data frame in the
map. You will make some edits that reflect your vision of what the campus should look
like. Later, you will synchronize your edits back to the original geodatabase so
renovation can begin.
A new data frame will be added to the map. By default, the data frame is named New
Data Frame.
! Make sure you add the layers from the replicated geodatabase
(OSU_CheckOut.mdb) and not the data you extracted in the last step
(from OSU_Extract.mdb).
ArcMap will assign default symbology to the layers as they are added to the map, so the
layers may not look as you might expect them to.
Use the ArcMap navigation tools to zoom the map extent to the western portion of the
campus, as shown below.
After giving it some thought, you have decided that the university should build a new
library in your honor (once you promise a generous donation of course)! The new
structure will replace all the existing buildings in the western portion of the campus. In
order to see what your library will look like, you will make the appropriate edits to the
buildings dataset in the replica. Later (when the university approves your design), your
edits will be synchronized into the ArcSDE geodatabase.
Use the Selection tab in the table of contents to set Building as the only selectable
layer.
Use the Edit tool on the Editor toolbar to select buildings where the library will go
(as shown below).
Make sure the task on the Editor toolbar is set to Create New Feature and that the
Target is set to the Building layer.
Now, use the Sketch tool to draw the new library in the shape of your initials.
When you have finished, choose Stop Editing from the Editor toolbar menu. Make
sure to save your edits!
Now you will check the original map service (in the other data frame) and see if your
edits appear.
Right-click the original data frame (named Layers) in the map and select Activate from
the context menu.
Use the navigation tools to zoom to the area of the map where your new library should
appear.
Turn the Building layer off and then back on in order to refresh the layer.
Notice that the changes do not yet appear in the original ArcSDE geodatabase. For your
edits show up, you will need to synchronize the edits from your replica.
The Synchronize Changes wizard gives you options for synchronizing changes with
another geodatabase. You will notice that there is only one option available for
synchronize direction (edits from GDB 1 go to GDB 2). This is because the replica you
created is of the checkout/check-in variety, which only allows changes to be sent to the
original geodatabase (and only once).
Keep all the current (default) settings for the wizard, and click Next.
In the final panel of the wizard, leave the default settings, and click Finish.
If conflicting edits exist in your replica and the one in the ArcSDE geodatabase, edits in
the ArcSDE geodatabase will take precedence.
Once synchronization is complete, activate the original data frame (Layers) once
again.
You have successfully incorporated the edits for your new library into the main
(ArcSDE) geodatabase. Now all you need to do is find something to wear to the
groundbreaking ceremony!
When finished viewing the map, close ArcMap. Click No if prompted to save the map.
Conclusion
In this exercise, you learned to publish a geodata service by enabling the Geodata Access
capability for a map service. You edited the geodata service properties to allow all three
operations of the service: extraction, query, and replication. By using the associated map
service in ArcMap, you were able to use tools on the Distributed Geodatabase toolbar.
These tools allowed you to extract local copies of datasets in the geodata service and to
create and synchronize geodatabase replicas. You used a checkout/check-in replica to
make some simple edits and to synchronize those edits with the original (parent)
geodatabase.
ArcGIS Explorer is a free, lightweight desktop application for viewing GIS services and
local data. When you first install ArcGIS Explorer, the application displays data from
servers hosted by ESRI. This is because ESRI's server is the default home server for
ArcGIS Explorer. You can configure ArcGIS Explorer so that your ArcGIS Server
system (or any other you have access to) is the home server instead.
In this exercise, you will set your ArcGIS Server machine as the home server for ArcGIS
Explorer. You will configure settings for the home server that control the default map
that is displayed, as well as the functionality you wish the user to have. You will also
learn how to deliver a custom task with your map.
In this exercise, you will:
▪ Set your server as an ArcGIS Explorer home server
▪ Configure settings for users of your home server, such as the default map and the
available functionality
▪ Download and use a custom ArcGIS Explorer task
▪ Deploy a custom task as part of a map
When the application starts, you see the familiar Satellite World map, which is the default
map from your current (ESRI) home server. You will make some simple changes to this
map, and then save it as your server's default map.
Use the task to search for your hometown (or favorite place).
When you find the correct match, right-click the record in the Results window and
choose Zoom.
In the Contents window, turn on the Boundaries and Places and Transportation layers
(as shown in the following graphic).
When the map of your hometown is complete, from the File menu, select Save As.
In the Save As dialog box, navigate to the \ArcGIS\Explorer\Maps folder in the root
directory of your Web server (as shown below).
publicly available on the Internet. By default, the ESRI server is set as ArcGIS Explorer's
home server.
In this step, you will change the home server for your installation of ArcGIS Explorer to
point to your local machine.
In ArcGIS Explorer, from the File menu, select Set Home Server.
In the dialog box that appears, choose the second option (Connect to the Home Server
located at).
Type in a URL that identifies your server. The URL should take the form
http://<machine>/<arcgis instance>.
Note: Remember that each install of ArcGIS Server is identified by an instance name.
The default instance name is arcgis. Refer to the notes on page 1-3 of your exercise
manual if your instance name differs from the default.
After providing the URL, click Test to make sure ArcGIS Explorer can connect to the
server.
If the test is successful, a check mark will appear before the URL text box (as shown
above) and the Test button will become disabled. If it is not successful, you will receive
an error message. Make sure the test works before proceeding.
When you have successfully tested the connection to your server, click OK to change
the home server.
You will not see an immediate change in the application after pointing to a new home
server. For your changes to take effect, you will need to close and then reopen ArcGIS
Explorer.
Once you have verified that your default map loads as expected, close ArcGIS
Explorer.
Use a text editor (such as Notepad) to open the E2Config.xml XML configuration file.
This is a simple XML-based configuration file that can be used to control settings for
your home server. For a description of all available configuration elements and their uses,
consult the Making your system an ArcGIS Explorer home server topic in the ArcGIS
Server Help.
On the fourth line, change the value of the AddData element from the default setting of
true to false.
Next, on the eighth line, change the value of the DisplayOptions element to false.
When you are finished, your configuration file should look like the one shown in the
following graphic.
Save your changes to the E2Config.xml file and close your text editor.
Click the File menu, and notice that the Add Content command is now disabled.
Because you configured your home server to disallow adding new content, this command
will always be disabled.
Click the Tools menu, and notice that the Options command is also disabled.
Setting the DisplayOptions value to false has caused this command to be disabled. Since
you left the value of the ManageTasks setting as true, that command is enabled.
downloaded from your server. Users who are able to navigate to this file can open it and
begin the process of downloading the task from the location specified.
The task .nmf file only contains a handful of configuration settings. Settings like
<Assembly> and <Class> identify the full name of the .NET assembly and the name of
the class that contains the task. The <DisplayName> element specifies the name to
appear for the task in the ArcGIS Explorer interface. The <DownloadLocation> setting is
particularly important, as it indicates the URL from where the task (.dll) may be obtained.
In the Select a Task dialog box, click Task Files (on the left).
ArcGIS Explorer will read the .nmf file for the task and use the DownloadLocation
element to locate the URL from which the task (.dll) may be downloaded. You will be
prompted to confirm or cancel the download.
Select the TrackShapesVB Custom Task task and click the right arrow to add this task
to the current map.
Click OK to close the Task Manager and add the task to the map.
Use one of the tools in the task window to draw a shape on the map (point, line, or
polygon). Hint: For a line or polygon, click once for each vertex and double-click to
complete the shape.
After executing, the task displays your feature on the map and adds a record to the
Results window.
Note: Task results can be saved with a map. If your users want to sketch features on the
map, they can save the map (.nmf file) and have these shapes (results) stored with the
map.
You will now clear the results of running the task, and save the map again as
DefaultMap.nmf.
In the Results window, right-click the results of running the Track Shapes task and
choose Remove. Do this for all results you have in the map.
! If you save your map as the default map without first removing these
results, all users of the home server will see your (saved) results upon
starting ArcGIS Explorer.
Navigate to the \ArcGIS\Explorer\Maps folder of your Web root directory and save the
map as DefaultMap.nmf. If prompted to overwrite an existing file, choose Yes.
Conclusion
In this exercise, you learned how to configure your ArcGIS Server system as a home
server for ArcGIS Explorer. Setting up a home server for your organization or for the
public allows you to control the map that users initially see (layers, extent, etc.), the
appearance of the application, and even the functionality that will be available to them.
You also learned that custom ArcGIS Explorer tasks can be delivered from your server.
Custom tasks may be created by developers using the ArcGIS Explorer SDK and
compiled to a .NET assembly in the form of a .dll file. Task information in a task .nmf
file or in an ArcGIS Explorer map can direct the client application to a URL from which
the task may be downloaded.
In this exercise, you will learn how to read ArcGIS Server log files in order to
troubleshoot problems with the system. You will become familiar with the information
contained in the logs and you will explore some ways in which you can filter log records
to find the specific information you require.
You will also learn how to troubleshoot and resolve data access issues, which is a
common problem that may arise when publishing a GIS service.
In this exercise, you will:
▪ Locate the ArcGIS Server log files
▪ Sort and filter log records
▪ Find an error for a particular map service
▪ Add the required database permissions for the ArcGIS Server SOC account
On the first panel of the Publish GIS Resource wizard, in the Resource drop-down list,
navigate to the \ISRV\Exercise08 folder and select SanDiego.mxd map document.
Leave the default name (SanDiego) for the new map service.
Choose to publish the service into the existing folder called Maps.
Click Next.
In the following panel, leave the default settings for capabilities, and click Next.
On the Services tab, locate the listing for the SanDiego service (in the Maps folder).
Your preview image probably looks like the one shown above. If you were to preview the
service in ArcCatalog or create a Web mapping application with this service, you would
still not be able to see a map image. The service has a status of Started, so why doesn't
the image appear? You will begin to troubleshoot the problem by examining the ArcGIS
Server log files.
The log information displayed by Manager is read from log files in the C:\Program
Files\ArcGIS\server\user\log folder. These files are available in both .xml and .dat
formats.
Click Apply to show only the records related to the SanDiego service.
Log information is categorized according to levels. Log records with a Normal level are
simply messages that describe standard server activity. Records characterized as Warning
or Error level messages, however, indicate that something unexpected happened while
the server was trying to do its work. When troubleshooting problems, Warning and Error
log records are of the most interest.
You likely see a few Normal log messages that were generated when the SanDiego
service was initially created. Server was probably able to start the service, read cache
information for the service (if any), and identify the cache folder that the service will use.
Question 1: How many Warning messages did you find in the log file for the SanDiego
map service?
______________________________________________________________________
Based on the log information, it appears that ArcGIS Server is having difficulty reading
the layers in the SanDiego.mxd map due to "insufficient permissions." Next, you will use
ArcCatalog to check data access permissions for the ArcGIS Server account that is trying
to read the data.
Start ArcCatalog.
In the Catalog tree, expand Database Servers, then connect to your SQLExpress
database by double-clicking it.
In the dialog box that appears, verify that the ArcGISSOC account appears as one of
the database server users.
Right-click the SanDiego geodatabase (under the database server) and choose
Administration > Permissions.
Choose the Read Only option button to give the ArcGIS Server SOC account
permission to read the data.
Next, expand the listing for your GIS server and the Maps folder beneath it.
Once the service has stopped, right-click it again and choose Start.
Each time a GIS service is started, ArcGIS Server re-reads the GIS object (map
document, address locator, geodatabase, etc.) on which the service is based. If you make
changes to an object that is the basis for a GIS service, you may need to restart the
service before the changes appear.
Once the map service has started again, highlight it in the Catalog tree, then click the
Preview tab on the right.
The ArcGIS Server SOC account can now access the data, and the map service draws as
expected. If you were to check the Server log files, you would find Normal level log
records describing server activity when starting the service, but no more warnings
regarding data permissions.
Close ArcCatalog.
Conclusion
ArcGIS Server records information about routine events that occur in the server, as well
as any problems that may be encountered, to log files. Events such as the starting and
stopping of GIS services, configuring additional host (SOC) machines, or adding server
folders are examples of common events logged by the server. Log files may be used to
troubleshoot problems associated with a particular service or host machine.
In this exercise, you used server log information to identify a common problem that
arises when publishing GIS services: lack of adequate data access permissions for the
ArcGIS Server SOC account. You granted the minimum permissions required for the
account, and were able to successfully publish the service.
Answer: You should have three warnings in the Server log file—one for each layer
in the SanDiego.mxd map document.
Answer: The warnings have been generated because ArcGIS Server cannot access
the data used for each layer in the map ("Insufficient permissions").
This is a license agreement, and not an agreement for sale, between you (Licensee) and ESRI. This ESRI data
license agreement (Agreement) gives Licensee certain limited rights to use the electronic version of the
training course materials, training database, software, and related materials (hereinafter collectively referred
to as the "Training Course"). All rights not specifically granted in this Agreement are reserved to ESRI and its
licensor(s).
Reservation of Ownership and Grant of License: ESRI and its licensor(s) retain exclusive rights, title,
and ownership to the copy of the Training Course licensed under this Agreement and hereby grant to Licensee
a personal, nonexclusive, nontransferable license to use the Training Course as a single package for
Licensee's own personal use only pursuant to the terms and conditions of this Agreement. Licensee agrees to
use reasonable efforts to protect the Training Course from unauthorized use, reproduction, distribution, or
publication.
Proprietary Rights and Copyright: Licensee acknowledges that the Training Course is proprietary and
confidential property of ESRI and its licensor(s) and is protected by United States copyright laws and
applicable international copyright treaties and/or conventions.
Permitted Uses:
▪ Licensee may run the setup and install one (1) copy of the Training Course onto a permanent
electronic storage device and reproduce one (1) copy of the Training Course and/or any online
documentation in hard-copy format for Licensee's own personal use only.
▪ Licensee may use one (1) copy of the Training Course on a single processing unit.
▪ Licensee may make only one (1) copy of the original Training Course for archival purposes during
the term of this Agreement, unless the right to make additional copies is granted to Licensee in
writing by ESRI.
▪ Licensee may use the Training Course provided by ESRI for the stated purpose of Licensee's own
personal GIS training and education.
Term: The license granted by this Agreement shall commence upon Licensee's receipt of the Training Course
and shall continue until such time that (1) Licensee elects to discontinue use of the Training Course and
terminates this Agreement or (2) ESRI terminates for Licensee's material breach of this Agreement. The
Agreement shall automatically terminate without notice if Licensee fails to comply with any provision of this
Agreement. Upon termination of this Agreement in either instance, Licensee shall return to ESRI or destroy
all copies of the Training Course, and any whole or partial copies, in any form and deliver evidence of such
destruction to ESRI, which evidence shall be in a form acceptable to ESRI in its sole discretion. The parties
hereby agree that all provisions that operate to protect the rights of ESRI and its licensor(s) shall remain in
force should breach occur.
Limited Warranty and Disclaimer: ESRI warrants that the media upon which the Training Course is
provided will be free from defects in materials and workmanship under normal use and service for a period of
ninety (90) days from the date of receipt.
EXCEPT FOR THE LIMITED WARRANTY SET FORTH ABOVE, THE TRAINING COURSE
CONTAINED THEREIN IS PROVIDED "AS-IS," WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. ESRI
DOES NOT WARRANT THAT THE TRAINING COURSE WILL MEET LICENSEE'S NEEDS OR
EXPECTATIONS; THAT THE USE OF THE TRAINING COURSE WILL BE UNINTERRUPTED; OR
THAT ALL NONCONFORMITIES, DEFECTS, OR ERRORS CAN OR WILL BE CORRECTED. THE
TRAINING DATABASE HAS BEEN OBTAINED FROM SOURCES BELIEVED TO BE RELIABLE,
BUT ITS ACCURACY AND COMPLETENESS, AND THE OPINIONS BASED THEREON, ARE NOT
GUARANTEED. THE TRAINING DATABASE MAY CONTAIN SOME NONCONFORMITIES,
DEFECTS, ERRORS, AND/OR OMISSIONS. ESRI AND ITS LICENSOR(S) DO NOT WARRANT THAT
THE TRAINING DATABASE WILL MEET LICENSEE'S NEEDS OR EXPECTATIONS, THAT THE
USE OF THE TRAINING DATABASE WILL BE UNINTERRUPTED, OR THAT ALL
NONCONFORMITIES CAN OR WILL BE CORRECTED. ESRI AND ITS LICENSOR(S) ARE NOT
INVITING RELIANCE ON THIS TRAINING DATABASE, AND LICENSEE SHOULD ALWAYS
VERIFY ACTUAL DATA, WHETHER MAP, SPATIAL, RASTER, TABULAR INFORMATION, AND
SO FORTH. THE DATA CONTAINED IN THIS PACKAGE IS SUBJECT TO CHANGE WITHOUT
NOTICE.
Exclusive Remedy and Limitation of Liability: During the warranty period, Licensee's exclusive
remedy and ESRI's entire liability shall be the return of the license fee paid for the Training Course upon the
Licensee's deinstallation of all copies of the Training Course and providing a Certification of Destruction in a
form acceptable to ESRI.
No Implied Waivers: No failure or delay by ESRI or its licensor(s) in enforcing any right or remedy under
this Agreement shall be construed as a waiver of any future or other exercise of such right or remedy by ESRI
or its licensor(s).
Order for Precedence: This Agreement shall take precedence over the terms and conditions of any
purchase order or other document, except as required by law or regulation.
Export Regulation: Licensee acknowledges that the Training Course and all underlying information or
technology may not be exported or re-exported into any country to which the U.S. has embargoed goods, or to
anyone on the U.S. Treasury Department's list of Specially Designated Nationals, or to the U.S. Commerce
Department's Table of Deny Orders. Licensee shall not export the Training Course or any underlying
information or technology to any facility in violation of these or other applicable laws and regulations.
Licensee represents and warrants that it is not a national or resident of, or located in or under the control of,
any country subject to such U.S. export controls.
Severability: If any provision(s) of this Agreement shall be held to be invalid, illegal, or unenforceable by a
court or other tribunal of competent jurisdiction, the validity, legality, and enforceability of the remaining
provisions shall not in any way be affected or impaired thereby.
Governing Law: This Agreement, entered into in the County of San Bernardino, shall be construed and
enforced in accordance with and be governed by the laws of the United States of America and the State of
California without reference to conflict of laws principles.
Entire Agreement: The parties agree that this Agreement constitutes the sole and entire agreement of the
parties as to the matter set forth herein and supersedes any previous agreements, understandings, and
arrangements between the parties relating hereto.