Publish Workspace

Feature Description

Through Publish Workspace, publish the data resource services in the workspace to the local or remote server to achieve resource sharing in the form of a web network. Before publishing the workspace, ensure that you have an administrator account and have started the iServer service locally or remotely.

Function Entrance

  • Online tab -> Publish iServer Services group -> Workspace -> Publish Workspace dialog;

Operation Steps

  1. Start the iServer service: By default, run startup.bat/startup.sh in the bin directory of SuperMap iServer.
  2. Click the Online tab -> Publish iServer Services group -> Workspace button, and the Publish Workspace dialog box pops up.
  3. Enter the iServer address for publishing the service. Click the drop-down button of the combo box and select New Connection. In the popped-up Login SuperMap iServer dialog, enter the server address, administrator account username, and password. After successful login, the program will automatically save the connected addresses. For subsequent logins, you can select from the history to achieve quick login. The server address supports entering the server address after the custom iServer installation directory/webapps/iserver folder name, and is compatible with three iServer service address formats: localhost, http, and https. The formats are as follows:
    Note:

    If the iServer service is not started or the administrator account or password is entered incorrectly, you will not be able to log in normally. Please confirm that the link information is correct and log in again.

    • localhost:8090
    • localhost:8090/iserver
    • localhost:8090/userdefine
    • http://localhost:8090
    • http://localhost:8090/iserver
    • http://localhost:8090/userdefine
    • https://localhost:8443
    • https://localhost:8443/iserver
    • https://localhost:8443/userdefine
  4. Select the server type you need. Provides REST Service, OGC Service, and other services.
    • REST Service: REST (REpresentational State Transfer) is a software architectural style. REST Service includes data service, map service, spatial analyst service, 3D service, 3D network service, and transportation analyst service. You can check the corresponding service checkboxes as needed.
      REST Service Type Supported Operations on Data Sources and Datasets
      Data Service
      • Obtain and modify datasource information, such as datasource name, description, projection, unit, distance unit, etc.
      • Obtain and edit dataset information, such as creating, modifying, or deleting datasets.
      • Operate on spatial data in datasets, including obtaining, modifying, adding, and deleting spatial data in datasets.
      • Operate on fields in datasets, including obtaining, modifying, adding, deleting fields, and statistical calculations.
      • Query features in the dataset.
      Map Service
      • Obtain maps and layer images along with related information.
      • Perform operations on layers such as creating, modifying, and deleting.
      • Obtain overview images.
      • Query and measure maps, such as distance measurement and area measurement, and obtain results.
      • Highlight geometric features.
      • Clear cached map images on the server.
      Spatial Analyst Service
      • Perform services on datasets such as buffer analysis, overlay analysis, surface analysis (e.g., extracting contours, isosurfaces), proximity analysis (e.g., generating Thiessen polygons), interpolation analysis, spatial relationships analysis, and linear analysis.
      • Perform buffer analysis, overlay analysis, surface analysis (e.g., extracting contours, isosurfaces), and proximity analysis (e.g., generating Thiessen polygons) on geometries.
      3D Service
      • Obtain the layer list and related information in 3D scenes.
      • Obtain the representation of a specific 3D layer in a 3D scene, including the 3D layer's name, type, corresponding 3D data path, and the cache layer number of the used data in the 3D data.
      • Obtain 3D data and data configuration files.
      • Obtain index files, cache files of 3D model cache data, and the version of a specific cache file in the 3D cache data.
      Warning:

      Only scenes loaded with cache are supported for publishing as services. If there are scenes loaded with datasets in the workspace, the data in all scenes will become invisible after publishing. It is recommended that all scenes in the workspace load cache data.

    • OGC Service: OGC (Open Geospatial Consortium) is a leading industry organization for developing standards in the geospatial and location services field. OGC Service supports the coordinate reference systems of the data itself, including custom coordinate reference systems and planar non-projected coordinate reference systems, while also supporting GCS_WGS_1984 (EPSG 4326) and PCS_WGS_1984_WORLD_MERCATOR (EPSG 3857). For more detailed information on OGC Service, please refer to: OGC Services.
    • Other Services: Include ArcGIS REST Map Service, Baidu REST Map Service, and Google REST Map Service, etc.
  5. Parameters:
    • Check Editable to allow other clients to edit the published data, such as creating new datasets, modifying dataset names, etc.
  6. Upload Workspace: Controls whether to upload the workspace file to the iServer server.
    • Selected - Upload the workspace file to the specified path on the server. The service operation does not depend on local files.
    • Not Selected - Do not upload the workspace file. The service reads the workspace file directly from the local path during operation.

    • Storage Path: Sets the storage location of the workspace file on the server. Supports two formats: absolute path and relative path:

      • Absolute Path: The complete server path, e.g., D:\...\Desktop.

      • Relative Path: Relative to the root directory of the file management currently configured in iServer. For example, entering "Desktop" means the actual storage path is "[file management root directory]\Desktop".
      • Default Value: The root directory of the file management currently configured in iServer.
      • If a non-existent path is specified, the system will automatically create the corresponding folder.
  7. Click the Publish button, and the Confirm Selection dialog box pops up, displaying the data in the cache directory. Check to confirm the data that needs to be uploaded.
Note:

If the map contains tile data, a prompt will appear during publishing: "there is a tile layer in the map that will degrade the service's browsing performance when published, should it continue to be published?", click Yes to continue publishing the map service, click No to cancel. After canceling, you can remove the tile data and republish the service.

Related Topics

Upload/Download Workspace

View Workspace Properties