GET_SERVICE

GET_SERVICE_INFO

Used in: REQUEST
Servers: Image   Query   Feature   Extract   Geocode   ArcMap
Parent elements: REQUEST

<GET_SERVICE_INFO

     When parent element is REQUEST for an ArcMap Image Service:
     dataframe ="#ALL# | frame by name"
     dpi ="1 - NNN"
     envelope ="true | false" [true]
     fields ="true | false" [true]
     toc ="true | false" [false]
     toctype ="jpg | png8 | png24 | gif | bmp" [jpg]

     When parent element is REQUEST for an Image or Feature Service:
     dpi ="1 - NNN"
     envelope ="true | false" [true]
     extensions ="true | false" [true]
     fields ="true | false" [true]
     renderer ="true | false" [true]
>

     No Child Elements
</GET_SERVICE_INFO >

Description:

Requests information about each layer in an ArcIMS service. With Image and Feature Services, the request has options for returning information on the fields, envelope, extensions, and renderers. With ArcMap Image Services, the request has options for returning information on fields, envelope, dataframes, and the table of contents.

Restrictions:

Not valid with Metadata Server.

Notes:

See SERVICEINFO for response.
A GET_SERVICE_INFO request sent to the Image or Feature Server returns limited information about Geocode extensions in an ArcIMS service. In order to retrieve all the information about a Geocode extension, the GET_SERVICE_INFO request must be routed to the Geocode Server. This routing information is contained in the URL sent to the ArcIMS site such as in the following example (all one line):

http://myComputer.domain.com/servlet/com.esri.esrimap.Esrimap?ClientVersion=9.0
      &ServiceName=myservice
      &CustomService=Geocode
      &Form=True&Encode=True
For more details on using GET_SERVICE_INFO and SERVICEINFO including additional examples, see Using GET_SERVICE_INFO and SERVICEINFO with Image and Feature Services and Using GET_SERVICE_INFO and SERVICEINFO with ArcMap Image Services.

Attribute Descriptions for GET_SERVICE_INFO:

When parent element is REQUEST for an ArcMap Image Service:

Attribute	Usage	Back to Top
dataframe	Retrieves dataframe information for an ArcMap Image Service using layouts. Use the value "#ALL#" to retrieve information for all frames. Information for a single dataframe can be retrieved by specifying the frame's name. Multiple data frame names can be used and should be separated by a semicolon.
dpi	Dots per inch (dpi). Used for calculating the correct scale thresholds for layers in the service. The dpi must be calculated by the client. Otherwise, a value of "96" is assumed.
envelope	Toggle to get information on the envelope for layers in a service.
fields	Toggle to get information on available fields for each featureclass layer in the service.
toc	Toggle to get information on the table of contents (TOC) used to generate an ArcMap Image Service legend for the ArcIMS Java Viewers and ArcMap. Not used with ArcIMS HTML Viewers. Instead a legend is retrieved using LEGEND in a GET_IMAGE request.
toctype	Determines image format for an ArcMap Image Service TOC image.

When parent element is REQUEST for an Image or Feature Service:

Attribute	Usage	Back to Top
dpi	Dots per inch (dpi). Used for calculating the correct scale thresholds for scale dependent elements such as SCALEDEPENDENTRENDERER, LAYER, and OBJECT. The dpi value used in request overrides the value used in a service.
envelope	Toggle to get information on the envelope for featureclass layers in a service. Featureclass layers include shapefile and ArcSDE layers.
extensions	Toggle to get information on any service extensions in featureclass layers.
fields	Toggle to get information on available fields for each featureclass layer in a service.
renderer	Toggle to get renderer information for featureclass layers in a service.

Examples for GET_SERVICE_INFO:

Example 1: When using Image or Feature Services.	Back to Top
<?xml version="1.0" encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_SERVICE_INFO fields="false" envelope="false" renderer="false" extensions="true" /> </REQUEST> </ARCXML>

Example 2: When using ArcMap Image Services.	Back to Top
<?xml version="1.0" encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_SERVICE_INFO fields="false" envelope="false" dataframe="#ALL#" toc="true" toctype="jpg" /> </REQUEST> </ARCXML>