Publish Workspace

Function Description

Through Publish Workspace, the data resource services in the workspace can be published to a local or remote server, enabling resource sharing via the web. Before publishing the workspace, you need to ensure that you have an administrator account and that the iServer service has been started locally or remotely.

Function Entry

  • Online tab -> Publish iServer Service group -> Workspace -> Publish Workspace dialog box;

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 Service group -> Workspace button, and the Publish Workspace dialog box will pop up.
  3. Enter the iServer address of the publishing service. Click the drop-down button of the combo box and select New Connection. In the Login SuperMap iServer dialog box that appears, enter the server address, administrator account username and password. After successful login, the program will automatically save the connected address. For subsequent logins, you can select history to achieve quick login. The server address supports entering a customized server address after the iServer installation directory/webapps/iserver folder name, and is compatible with three iServer service address formats: localhost, http, and https. The format is as follows:
    Notes:

    The system will monitor whether the address is valid in real time. If the iServer service is not started or the administrator account or password is entered incorrectly, login will not be possible normally. In this case, the address will be highlighted in red. Please confirm that the link information is correct before logging 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. REST Service, OGC Service and Other Services are available.
    • REST Service: REST (Representational State Transfer) is a software architecture 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 Datasources and Datasets
      Data Service
      • Get and modify datasource information, such as datasource name, description, projection, unit, distance unit, etc.
      • Get and edit dataset information, such as creating, modifying, or deleting a dataset.
      • Operate on spatial data in the dataset, including getting, modifying, adding, and deleting spatial data in the dataset.
      • Operate on fields in the dataset, including getting, modifying, adding, deleting fields, and statistical calculations.
      • Query features in the dataset.
      Map Service
      • Get map and layer images and related information.
      • Create, modify, and delete layers.
      • Get the overview map image.
      • Query and measure on the map, such as distance measurement and area measurement, and get the results.
      • Highlight geometric features.
      • Clear cached map images on the server side.
      Spatial Analyst Service
      • Perform buffer analysis, overlay analysis, surface analysis (such as extracting contour lines and contour polygons), proximity analysis (such as generating Thiessen polygons), interpolation analysis, spatial relationship analysis, linear analysis, etc. on datasets.
      • Perform buffer analysis, overlay analysis, surface analysis (such as extracting contour lines and contour polygons), proximity analysis (such as generating Thiessen polygons) on geometry.
      3D Service
      • Get the layer list and related information in a 3D scene.
      • Get the description of a specific 3D layer in a 3D scene, including the layer name, type, path of the corresponding 3D data, and the cache layer number of the data used in the 3D data.
      • Get the 3D data and its configuration file.
      • Get the index file and cache file of 3D model cache data, as well as the version of a specific cache file in the 3D cache data.
      Warning:

      Only scenes with cached layers can be published as services. If a workspace contains scenes with loaded datasets, the data in all scenes will be invisible after publishing. It is recommended that all scenes in the workspace load cache data.

    • OGC Service: OGC (Open Geospatial Consortium) is the industry leader in standard setting in the field of geospatial and location services. OGC Service supports the coordinate reference system of the data itself, including custom coordinate reference systems, planar coordinate reference systems without projection, and also supports GCS_WGS_1984 (EPSG 4326) and PCS_WGS_1984_WORLD_MERCATOR (EPSG 3857). For more detailed information about OGC Service, please refer to: OGC Service.
    • Other Services: Includes ArcGIS REST Map Service, Baidu REST Map Service, Google REST Map Service, etc.
  5. Parameters:
    • Check Editable to allow other clients to edit the published data, such as creating a new dataset, modifying the dataset name, 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: Set the storage location of the workspace file on the server. Supports both absolute and relative path formats:

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

      • Relative Path: Relative to the current file management root directory configured in iServer. For example, if you enter "Desktop", the actual storage path is "[File management root directory]\Desktop".
      • Default Value: The current file management root directory 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 will pop up, showing the data in the cache directory. Check the data you need to upload to confirm.
Notes:

If the map contains tile data, a prompt will appear when 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 then republish the service.

Related Topics

Upload/Download Workspace

View Workspace Properties