GET_SERVICE

Used in

REQUEST

Servers

Image Query Feature Extract Geocode ArcMap

Parent elements

REQUEST

Syntax

<GET_SERVICE_INFO

Attribute Description Table

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

     When parent element is Request for an Image or Feature Service:
     acetateinfo="true | false" [false]
     dpi="1 - NNN"
     envelope="true | false" [true]
     extensions="true | false" [true]
     fields="true | false" [true]
     relativescale="true | false" [false]
     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?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
dataframe	Retrieves dataframe information for an ArcMap Image Service using layouts. Use the value "#ALL#" to retrieve information for all frames. Use "#DEFAULT#" to retrive the active data frame. 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.
relativescale	When set to "true", the scale values in LAYER are returned as relative scales in the SERVICEINFO response. Note that the scale values returned in LAYERINFO are not rounded when the map is in decimal degrees.
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
acetateinfo	Toggle to include all symbol information and geometry from an acetate layer. Valid with Image Services only.
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.
relativescale	When set to "true", the scale values in LAYER and SCALEDEPENDENTRENDERER are returned as relative scales in the SERVICEINFO response. Notes in the SERVICEINFO response: The scale values returned in LAYERINFO are not rounded when the map is in decimal degrees. The scale values returned for SCALEDEPENDENTRENDERER are not rounded for all map units. Known limit: when the map configuration file contains scale in map units per pixel and the map units are not decimal degress, then relative scale values are incorrectly returned in LAYERINFO. In this case, relativescale should be set to "false". When set to "false", scale values are returned in map units per pixel.
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.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_SERVICE_INFO fields="false" envelope="false" renderer="false" extensions="true" acetateinfo="false" />
  </REQUEST>
</ARCXML>

Example 2: When using ArcMap Image Services.

<?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>