Skip To Content

Consuming a schematic service

Once you've published your schematics service to a GIS server, it will be available to clients both locally and on the web. Because of the many capabilities the schematics service exposes, it can be used in a variety of web applications.

Tip:

You will get better performance and responsiveness if your diagrams are organized in schematic folders when they are exposed on the web in client applications.

Schematics service URLs

To connect to a schematics service, you need to know the URL. Schematics services published to ArcGIS Server have the following URL format: http://gisserver.domain.com:6080/arcgis/services/folder/service/MapServer/exts/SchematicsServer.

Published schematic layers and allowed operations

The schematics operations enabled when publishing determine how the schematics service can be consumed and what kind of manipulations the client can operate on the schematic diagrams. But, the following conditions are also decisive:

  • The type of geodatabase in which the published diagrams are stored—that is, enterprise or file geodatabases
  • The way the published data is accessible to the server—that is, data copied to the server or not when publishing
  • The type of the published schematic layers—that is, schematic layers related to unitary schematic diagrams or to a schematic diagram template

The table below sums up the manipulations the client can operate depending on the different situations:

Schematics operations enabled / Manipulations on the published schematic diagramsOnly the Query operation enabledQuery and Editing operations enabled

Displaying diagrams

Yes

Yes

Layout without saving results

Yes

Yes

Layout and saving results

No

Only when condition #1 explained below is respected

Updating diagrams

No

Only when condition #1 explained below is respected

Removing diagrams

No

Only when condition #1 explained below is respected

Locking diagrams

No

Only when condition #1 explained below is respected

Unlocking diagrams

No

Only when condition #1 explained below is respected

Generating new diagrams

No

Only when conditions #1 and #2 explained below are respected

Condition #1: The published schematic diagrams are stored in an enterprise geodatabase and the schematics data has been not copied to the server when publishing—that is, the Schematics service references the source schematic dataset.

Condition #2: The published schematic diagrams are under a schematic diagram template.

Schematics services and web applications

In web applications, schematics services must be consumed programmatically. ArcGIS Server offers a schematics REST API and a Silverlight platform for integrating schematic data with GIS into an enterprise application environment.

ArcGIS Server Schematics REST API

The ArcGIS Server schematics REST (Representational State Transfer) API provides an open web interface to schematics services hosted by ArcGIS Server. It allows working with the schematics data service in a client application. All resources and operations exposed by the REST API are accessible through a hierarchy of endpoints or Uniform Resource Locators (URLs) for each published schematics service.

ArcGIS Server schematics REST Reference Guide

ArcGIS Server Schematics API for Silverlight

ArcGIS Server offers the schematics Silverlight APIs for web application development.

The ArcGIS Server schematics API for Silverlight allows users to rapidly and easily develop with the underlying schematic objects and data that power the schematics extension. These resources will enable you to add substantial value to your SL client applications by allowing you to easily search and browse schematic diagrams, display them, perform schematic algorithms on them, and so on.

Note:

The ArcGIS Server schematics API for Silverlight is provided with some of the downloadable Silverlight sample web applications—for example, Schematics Configurable Web Application - ArcGIS API for Silverlight 2.4 or Schematics Diagrams Viewer - ArcGIS API for Silverlight 2.4.