Geographic Map Services

Creating Geographic Map Services in SAS Management Console

About Geographic Map Services

The Esri map component uses a metadata object called a map service to determine how Esri data corresponds to a particular SAS OLAP cube. You must create a separate map service for each map document that you want to associate with a SAS OLAP cube.

Prerequisite: The Map Service Manager Plug-in for SAS Management Console

Is the Plug-in Installed on Your Desktop?

The Map Service Manager plug-in to SAS Management Console is present on only those clients where the Esri SAS Management Console plug-in is installed.

Is the Plug-in Visible to You?

The visibility of the Map Service Manager plug-in is determined by roles. In the initial configuration, the Map Service Manager is visible to only unrestricted users and members of the SAS Administrators group. For some sites, this level of visibility is sufficient.

Increase Visibility of the Plug-in

If you want to enable other users to define map services, you must increase the visibility of the plug-in. To make the plug-in widely available, follow these steps:

Note: This is one of several possible approaches.

Log on to SAS Management Console as someone who has user administration capabilities (for example, sasadm@saspw).
On the Plug-ins tab in SAS Management Console, select User Manager.
In the display area, deselect the Show Users and Show Groups check boxes. Right-click the Management Console: Content Management role and select Properties.
On the Capabilities tab, under Management Console 9.2General, select the Access Unregistered Plug-ins check box.

With this broad approach, all members of the Management Console: Content Management role can see the Map Service Manager (if that plug-in is installed on their desktop), along with any other unregistered plug-ins that they have installed. In the initial configuration, the SASUSERS group is a member of the Management Console: Content Management role, so all registered users are affected.

A more specific approach is to register the plug-in in SAS Management Console (under Tools

Plug-in Manager). This gives the Map Service Manager capability its own check box on all roles, which enables you to directly manage access to this particular plug-in. For example, you might choose to create a new role that provides only the Map Service Manager capability and selectively assign members to that role.

Create a Geographic Map Service: Basic Method

To create geographic map service using the basic method, follow these steps:

On the Plug-ins tab in SAS Management Console, right-click Map Service Manager and select ActionsNew Map Service.
In the New Map Service Wizard, enter a name and select a map server. Click Next.

Note: When you click Next, SAS Management Console attempts to connect to the ArcGIS server. If the connection fails, see Authentication to the Esri ArcGIS Server.
From the Configuration drop-down list, select the map document that you want to use. Click Next.
In the Layers selection box, select the layers that you want to associate with OLAP data. Click Next.
For each layer, select one or more fields that you want to associate with OLAP data. Click Next.
Click Finish.

Create a Geographic Map Service: Alternate Method

About the Alternate Method for Creating a Map Service

Use this method if you will use the Esri map component through only SAS Enterprise Guide and you do not have access to the ArcGIS server. In this method, you use a text editor to create a map service XML file and then use a wizard to import that file into the metadata.

Create a Map Service XML File

In a text editor, create a new XML file and use the following template to create a map service:

<?xml version="1.0" encoding="utf-8" ?>
<EsriExtensionOutput>
  <MapService name="Service-Name"
document="network-path-to-map-document">
    <Layer name="layer-1" alias=""
uniqueId="field-1,
field-2"/>
    <Layer name="layer-2" alias=""
uniqueId="field-1"/>
  </MapService>
</EsriExtensionOutput>

The <MapService> element defines your map service. You can specify the following attributes:

Name=

specifies the map service name.

Document=

specifies the Esri map document as a network location that all of your SAS Enterprise Guide users can access.

Each <Layer> element defines a layer with the map service. You can specify the following attributes:

Name=

specifies the layer name.

Alias=

specifies an alias for the layer. This attribute is optional.

UniqueId=

specifies one or more fields that you want to associate with your OLAP data.

When you have finished creating the map service, save the document as an XML file.

Import the Map Service XML File

To import map service metadata from an XML file, follow these steps:

On the Plug-ins tab in SAS Management Console, right-click the Map Service Manager and select Actions Import Map Service.
In the Import Map Service Wizard, specify a name and then click Browse to locate and select the XML file that you want to import.
Click Next. If there is a problem with the structure of your XML file, then an error message appears. If there is no problem, then the wizard reads the information from your file.
In the Layers field, select the layers that you want to use. By default, all of the layers are selected. Click Next.
Verify the information from your XML file, and then click Finish to create your new map service.