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 | 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=3.1
      &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	1 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	2 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	3 Toggle to get information on the envelope for layers in a service.
fields	4 Toggle to get information on available fields for each featureclass layer in the service.
toc	5 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	6 Determines image format for an ArcMap Image Service legend.

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

Attribute	Usage	Back to Top
dpi	1 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	2 Toggle to get information on the envelope for featureclass layers in a service. Featureclass layers include shapefile and ArcSDE layers.
extensions	3 Toggle to get information on any service extensions in featureclass layers.
fields	4 Toggle to get information on available fields for each featureclass layer in a service.
renderer	5 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>