SERVICEINFO

Used in

Servers

Image Query Feature Extract Geocode ArcMap

Parent elements

Syntax

<SERVICEINFO >
     No Attributes

     When parent element is RESPONSE for an ArcMap Image Service and the dataframe attribute is not used in GET_SERVICE_INFO:
     (r)(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:
     (r)(m)<LAYERINFO... />
     <ENVIRONMENT... />
     <PROPERTIES... />

</SERVICEINFO >

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

Description

Provides details about each layer in an ArcIMS service such as the name, service type, and service properties.

Restrictions

When using an ArcIMS HTML Viewer, ArcIMS Java Viewer, ArcExplorer-Java Edition, or any other client 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 same directory as the ArcIMS Servlet Connector. For more information on the location of Esrimap_prop and its properties, see ArcIMS Help.

Thes restrictions apply only when the ArcIMS Servlet Connector is used. They do not apply when any other connector, the Web ADF for the Microsoft .NET Framework, or the Web ADF for the Java Platform is used.
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.

<?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="" disabledtypes="" />
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="4326"/>
        <FILTERCOORDSYS id="4326"/>
        <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.

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

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

<?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="" disabledtypes="" servertype="arcmapserver" returngeometry="xmlmode"/>
      </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]]" id="104000"/>
        <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]]" id="104000"/>
        <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.

<?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="" disabledtypes="" servertype="arcmapserver" returngeometry="xmlmode"/>
      </ENVIRONMENT>
      <LAYOUTINFO pageunits="inches">
        <ENVELOPE minx="0" miny="0" maxx="8.5" maxy="11" />
      </LAYOUTINFO>
      <DATAFRAMEINFO name="Layers">
        <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]]" id="104000"/>
          <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]]" id="104000"/>
          <MAPUNITS units="decimal_degrees"/>
          <BACKGROUND color="255,255,255"/>
          <ENVELOPE minx="-127.714285386824" miny="-6.58527935381" maxx="-63.9877554315853" maxy="81.1449102179015" name="Initial_Extent" />
        </PROPERTIES>
        <LAYERINFO type="featureclass" name="states" id="2" visible="true">
          <FCLASS type="polygon"></FCLASS>
        </LAYERINFO>
        <LAYERINFO type="featureclass" name="rivers" id="1" visible="true">
          <FCLASS type="line"></FCLASS>
        </LAYERINFO>
        <LAYERINFO type="featureclass" name="cities" id="0" visible="true">
          <FCLASS type="point"></FCLASS>
        </LAYERINFO>
      </DATAFRAMEINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>