Server Link

The Server Link is a mechanism that makes EasyMorph Desktop become "aware" of EasyMorph Server (if it's present in your organization). When configured, the Server Link establishes integration between Desktop and Server. This integration enables a few additional features and operations:

  • Publishing projects to Server, and opening projects from Server
  • Sharing datasets via Server and importing them on the fly in Desktop
  • Serving a connector repository from Server to Desktop users

Configuring Server Link

The Server Link can be configured from the Start screen of EasyMorph Desktop. It requires specifying the Server host and port, and at least 1 Server space. While multiple Server spaces can be configured in the Server Link, it connects to only one space at a time, which becomes the current space. Switching spaces can be done from the Start screen as well.

Sever Link configuration

There can be multiple Server connections configured in the Server Link. This allows quick switching between, for instance, production and development Servers.

Publishing projects to Server / Opening projects from Server

To publish the currently open project to Server press the "Publish to Server" button in the "Project" menu. When the dialog "Publish project to Server" opens, select a location in the public folder of the current space. Publishing a project is equivalent to uploading the project to Server using the Server's web interface.

Publish project

Opening a project from Server can be done from the Start screen. After the Server Link is configured, the "Open from Server" button appears next to the regular "Open project" button (can be seen in the uppermost screenshot on this page). When a project is opened from Server, a local copy is saved first and then is opened in EasyMorph. When editing the project, it's the local copy that becomes edited. Saving an edited project doesn't upload it automatically back to Server. To publish the edited project to Server, publish its local copy by pressing the "Publish to Server" button as described above.

Sending datasets to Server / Receiving datasets from Server

The result of any action can be sent (published) to Server as an EasyMorph dataset in two clicks. It makes it easy to share data between EasyMorph users. To send the result of an action to Server, right-click the action and choose "Send to Server".

Sending datasets to and receiving from Server

To receive a dataset from Server, press the "Add data" button and choose "Receive from Server". The "Import dataset" action will be created automatically and the selected dataset will be immediately fetched from Server.

Both the "Import dataset" and "Export dataset" actions support Server Link as a source/destination. It makes it possible to securely store datasets on EasyMorph Server (as an alternative to storing data in a database) and fetch them on the fly, when a project is opened. This technique is called "hot-linking datasets". It also makes it easy to share a project with another person. The project will be automatically populated with data as soon as the recepient opens it. To read more on hot-linking datasets see this Community forum article: "Server Link explained"

Server-hosted connector repository

In organizations that employ EasyMorph Server, it is possible to make Desktops use a connector repository provided by the Server via Server Link. A Server-hosted connector repository is a more secure option compared to a file-based repository. Accessing a Server-hosted repository can be restricted to the users of the Server space that provides the repository. Additionally, it copying connectors from such a repository can be disabled by Server administrator. At the same time, creating new and editing existing connectors is still possible via the Desktop's Connection Manager even for Server-hosted repositories.

To start using a Server-hosted connector repository:

  1. 1) In the Server space settings permit accessing to connector repository from Desktops (it's disabled by default)
  2. 2) In EasyMorph Desktop configure the Server Link as described above.
  3. 3) In EasyMorph Desktop open the Connector Manager and switch to using Server Link (see screenshot below)
Selecting Server-hosted repository

Note that if Server Link is switched to another space, the current repository is also switched to the repository of that space. The location of the current connector repository can always be seen in the application's status bar (see screenshot below).

Current repository indicator in the status bar

Hint: When a project with actions that use Server Link is executed on EasyMoprh Server it uses the connector repository of the Server space in which the project is executed.


Read next: File operations