CAPABILITIES

Used in

RESPONSE  

Servers

Image  Query  Feature  Extract  Geocode  ArcMap  

Parent elements

ENVIRONMENT 

Syntax

<CAPABILITIESAttribute Description Table
     (r)disabledtypes="string"
     (r)forbidden="string"
     returngeometry="all | none | xmlmode" [xmlmode]
     servertype="arcmapserver"
>

     No Child Elements
</CAPABILITIES >
(r): Attribute or child element is required.

Description

Used in a SERVICEINFO response to list any restrictions for an ArcIMS service.

Attribute Descriptions for CAPABILITIES

AttributeUsage
disabledtypesReports disabled image output types designated in the spatialServer.ForbiddenImageTypes property in esrimap_prop.

For more information on the location of esrimap_prop and its properties, see ArcIMS Help. This restriction applies only when the ArcIMS Servlet Connector is used. It does not apply when any other connector, the Web ADF for the Microsoft .NET Framework, or the Web ADF for the Java Platform is used.
forbiddenList of elements that cannot be used in a request to the service. Multiple elements are always delimited by a comma regardless of what is used in SEPARATORS.

The list of forbidden elements is limited to the request elements: GET_FEATURES, GET_EXTRACT, GET_GEOCODE, GET_IMAGE, GET_SERVICE_INFO, GET_LAYOUT, GET_METADATA, PUBLISH_METADATA, and GET_RASTER_INFO.

For more information on forbidden elements, see ArcIMS Help. This restriction applies only when the ArcIMS Servlet Connector is used. It does not apply when any other connector, the Web ADF for the Microsoft .NET Framework, or the Web ADF for the Java Platform is used.
returngeometryWhen set to "xmlmode", geometry is returned in a FEATURES response only when GET_FEATURES outputmode is "xml" or "newxml". When set to "all", geometry is returned for all GET_FEATURES requests, including binary output mode. When set to "none", geometry is not returned for any output mode.

This attribute is returned in all GET_SERVICE_INFO requests to ArcMap Image Services. It is also available for Image Services by routing the GET_SERVICE_INFO request to the Query 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=Query
&Form=True&Encode=True
servertypeWhen the service is an ArcMap Image Service, the value is "arcmapserver". For Image and Feature Services, the attribute is not included.
Back to top 

Examples for CAPABILITIES

Example 1: When using an Image or Feature Service.
<?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_GEOCODE,GET_EXTRACT" disabledtypes="png24" />
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="4326" />
        <FILTERCOORDSYS id="4326" />
        <ENVELOPE minx="-71.077172" miny="42.355504" maxx="-71.034431" maxy="42.387721" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Streets" id="streets">
        <FCLASS type="line">
        </FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 2: When using an ArcMap Image Service
<?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=";"/>
        <IMAGELIMIT pixelcount="2097152"/>
        <SCREEN dpi="96"/>
        <CAPABILITIES forbidden="" disabledtypes="bmp,tif" servertype="arcmapserver" returngeometry="xmlmode"/>
      </ENVIRONMENT>
      <LAYOUTINFO pageunits="inches">
        <ENVELOPE minx="0" miny="0" maxx="8.5" maxy="11" />
      </LAYOUTINFO>
      <PROPERTIES>
        <FEATURECOORDSYS string="GEOGCS[&quot;GCS_Assumed_Geographic_1&quot;,DATUM[&quot;D_North_American_1927&quot;,SPHEROID[&quot;Clarke_1866&quot;,6378206.4,294.9786982]],PRIMEM[&quot;Greenwich&quot;,0.0],UNIT[&quot;Degree&quot;,0.0174532925199433]]" id="104000"/>
        <FILTERCOORDSYS string="GEOGCS[&quot;GCS_Assumed_Geographic_1&quot;,DATUM[&quot;D_North_American_1927&quot;,SPHEROID[&quot;Clarke_1866&quot;,6378206.4,294.9786982]],PRIMEM[&quot;Greenwich&quot;,0.0],UNIT[&quot;Degree&quot;,0.0174532925199433]]" id="104000"/>
        <MAPUNITS units="decimal_degrees"/>
        <BACKGROUND color="255,255,255"/>
        <ENVELOPE minx="-205.513538400732" miny="-94.11077166389" maxx="206.07539375395" maxy="91.3014948978037" name="Initial_Extent" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" name="Ocean" id="4" visible="true">
        <FCLASS type="polygon"></FCLASS>
      </LAYERINFO>
      <LAYERINFO type="featureclass" name="Countries" id="3" visible="true">
        <FCLASS type="polygon"></FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Back to top