SERVICEINFO

SERVICEINFO

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

<SERVICEINFO >
     No Attributes

     When parent element is RESPONSE for an ArcMap Image Service and the dataframe attribute is not used in GET_SERVICE_INFO:
     (m) <LAYERINFO... />
     <ENVIRONMENT... />
     <LAYOUTINFO... />
     <PROPERTIES... />

     When parent element is RESPONSE for an ArcMap Image Service and the dataframe attribute is used in GET_SERVICE_INFO:
     (m) <DATAFRAMEINFO... />
     <ENVIRONMENT... />
     <LAYOUTINFO... />

     When parent element is RESPONSE for an Image or Feature Service:
     (m) <LAYERINFO... />
     <ENVIRONMENT... />
     <PROPERTIES... />

</SERVICEINFO >

Bold: Attribute or child element is required.
(m): Child element can be used multiple times.

Description:

Provides details about each layer in an ArcIMS service. If the layer data source is an image such as TIFF, only minimum and maximum extent is returned in the response. If the layer is a vector data source, additional information is returned such as the type of feature, feature geometry, rendering and symbolization, and extension parameters.

Restrictions:

When using an ArcIMS HTML Viewer, ArcIMS Java Viewer, ArcExplorer 4, or any other browser using the ArcIMS Servlet Connector, several elements in a SERVICEINFO response are restricted.
- In RASTERMARKERSYMBOL, RASTERFILLSYMBOL, and RASTERSHIELDSYMBOL, the attribute image is not returned.
- OUTPUT is not included in the SERVICEINFO response, even if it is included in the map configuration file.
These restrictions can be lifted by setting the property spatialServer.AllowResponsePath to true in esrimap_prop. This property file is found in the servlet engine directory. For more information on the location of Esrimap_prop and its properties, see the ArcIMS Help.

These restrictions apply only when the ArcIMS Servlet Connector is used. They do not apply to the ActiveX, ColdFusion, or Java Connectors.
Not valid with Metadata Server.

Notes:

See GET_SERVICE_INFO for request.
SERVICEINFO element contains a LAYERINFO child element for each layer defined in the ArcIMS service.
All layer fields are described in FCLASS child element including the layer’s envelope and all available fields.
If any extensions were defined for a LAYER in a map configuration file, then information about all these extensions is also returned in EXTENSION elements.
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.

Examples for SERVICEINFO:

Example 1: When all GET_SERVICE_INFO attributes are set to true. The Countries layer includes extensions. An acetate layer is also included.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="image" name="Background" visible="true" id="0">
        <ENVELOPE minx="-180" miny="-89.9747543334961" maxx="179.9423828125" maxy="90" />
      </LAYERINFO>
      <LAYERINFO type="featureclass" visible="true" name="Countries" id="1">
        <FCLASS type="polygon">
          <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="83.5960388183594" />
          <FIELD name="AREA" type="8" size="12" precision="3" />
          <FIELD name="NAME" type="12" size="40" precision="0" />
          <FIELD name="ABBREVNAME" type="12" size="12" precision="0" />
          <FIELD name="FIPS_CODE" type="12" size="2" precision="0" />
          <FIELD name="WB_CNTRY" type="12" size="3" precision="0" />
          <FIELD name="#SHAPE#" type="-98" size="0" precision="0" />
          <FIELD name="#ID#" type="-99" size="16" precision="0" />
        </FCLASS>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL filltransparency="0.0" boundarywidth="2" />
        </SIMPLERENDERER>
        <EXTENSION type="extract">
          <EXTRACTPARAMS clip="true">
            <OUTPUTFILE file="world">
              <OUTPUTFIELD name="NAME" alias="Country"/>
            </OUTPUTFILE>
          </EXTRACTPARAMS>
        </EXTENSION>
        <EXTENSION type="Geocode" >
          <GCSTYLE name="SingleField" />
        </EXTENSION>
        <EXTENSION type="StoredQuery">
          <STOREDQUERIES>
            <STOREDQUERY name="Country">
              <QUERY subfields="#SHAPE# AREA NAME ABBREVNAME FIPS_CODE WB_CNTRY" where="( NAME = [%var%] )" >
              </QUERY>
              <SQVAR name="[%var%]" position="0">
                <FIELD name="NAME" type="12" precision="0" size="40" />
              </SQVAR>
            </STOREDQUERY>
          </STOREDQUERIES>
        </EXTENSION>
      </LAYERINFO>
      <LAYERINFO type="acetate" name="northarrow" visible="true" id="northarrow"/>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 2: When layer rendering is included and RASTERFILLSYMBOL is restricted.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <CAPABILITIES forbidden="GET_EXTRACT"/>
        <SCREEN dpi="120"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-141.003005981445" miny="29.9125167103556" maxx="-52.6202812194824" maxy="83.1083221435546" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Provinces" id="Provinces">
        <FCLASS type="polygon"> </FCLASS>
        <SIMPLERENDERER>
          <RASTERFILLSYMBOL url="http://mymachine.domain.com/website/color.gif" transparency="0.5" overlap="true" />
        </SIMPLERENDERER>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 3: When request is routed to the Geocode Server.

Back to Top

Example 4: When request is sent to an ArcMap Image Service and DATAFRAMEINFO is not included

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US"/>
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular"/>
        <SEPARATORS cs=" " ts=";"/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576"/>
        <CAPABILITIES forbidden=""/>
      </ENVIRONMENT>
      <LAYOUTINFO pageunits="inches">
        <ENVELOPE minx="0" miny="0" maxx="8.5" maxy="11" />
      </LAYOUTINFO>
      <PROPERTIES>
        <FEATURECOORDSYS string="GEOGCS["GCS_Assumed_Geographic_1",DATUM["D_North_American_1927",SPHEROID["Clarke_1866",6378206.4,294.9786982]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]"/>
        <FILTERCOORDSYS string="GEOGCS["GCS_Assumed_Geographic_1",DATUM["D_North_American_1927",SPHEROID["Clarke_1866",6378206.4,294.9786982]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]"/>
        <MAPUNITS units="decimal_degrees"/>
        <BACKGROUND color="255,255,255"/>
        <ENVELOPE minx="-178.637433658708" miny="-149.932588181915" maxx="180.202305702247" maxy="148.932531819555" name="Initial_Extent" />
      </PROPERTIES>
      <LAYERINFO type="image" name="Background" id="1" visible="true">
        <ENVELOPE minx="-180.10415" miny="-89.8896767396583" maxx="179.900453479317" maxy="90.112625" />
      </LAYERINFO>
      <LAYERINFO type="featureclass" name="Countries" id="0" visible="true">
        <FCLASS type="polygon">
          <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="83.5960388183594" />
          <FIELD name="#ID#" type="-99" size="4" precision="0" />
          <FIELD name="#SHAPE#" type="-98" size="0" precision="0" />
          <FIELD name="AREA" type="8" size="12" precision="11" />
          <FIELD name="NAME" type="12" size="40" precision="0" />
          <FIELD name="ABBREVNAME" type="12" size="12" precision="0" />
          <FIELD name="FIPS_CODE" type="12" size="2" precision="0" />
          <FIELD name="WB_CNTRY" type="12" size="3" precision="0" />
        </FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 5: When request includes the attribute dataframe for ArcMap layouts.

Back to Top