Architecture

Briefly described, the Maconomy web client is a lightweight HTML5 user interface supplement to the existing Workspace Client. The backend is Maconomy, specifically the new RESTful web services exposed from Maconomy since version 2.2. In this section, we will give a cursory overview of the technical architecture.

The figure below shows the high-level architecture of a Maconomy system with the web client. This setup resembles the traditional Maconomy architecture with a few exceptions. In the following section, we will describe the core components involved and the purpose of each of those.

Architectural overview.

Maconomy 2.x server and database

The Maconomy web client is available from Maconomy 2.2. It does not impose any specific requirements on the database, but it does require a Maconomy 2.2 server and corresponding RESTful API. See the following section for more details on the required web services.

Web server (IIS/Apache)

One or more web servers are required to serve both the static and dynamic content of the Maconomy web client. Static content such as HTML, JavaScript, CSS files, and so on are placed directly on the web server. Dynamic content such as specifications, files, and data are retrieved from the Maconomy server, but the web server in this case acts as proxy. Using the web server as proxy prevents cross-origin (CORS) issues on the client side. The web server is also required for encryption and compression of client-web server communication.

Web Clients

The web clients can be located both on the internal network or on the open Internet depending on the web server configuration and exposure. Furthermore, customers can run the web client on different devices such as laptops with the main browsers (Chrome, Firefox, Edge, and Safari), as well as on iOS and Android tablets.

RESTful Web Service API

As mentioned previously, the web client uses the RESTful Web Service API which was introduced in Maconomy 2.2. This is not the same thing as the existing MScript web services. Please see the RESTful Web Services documentation for more information. For now, we will just briefly list the web service endpoints that the web client uses and what they are used for:

Containers Endpoint

The containers endpoint delivers both metadata and data for the containers exposed by the Maconomy 2x server. Metadata include specifications of the names, actions, fields, and foreign keys exposed by different containers. Data include the actual filter-, card-, and table-data stored in the underlying database as well as information on which actions are enabled.

Filedrop Endpoint

The filedrop endpoint is used to upload files such as receipt attachments on expense sheets.

Configurations Endpoint

The configurations endpoint was introduced in Maconomy 2.2.2 and is used by the web client version 1.2 and onwards. This endpoint is used to retrieve JSON specifications from the Maconomy server, specifically the application specification (application.json) which configures the web client. These specifications are the foundation of the web client extensibility model.

Auth Endpoint

The auth endpoint was introduced in Maconomy 2.2.4 and 2.3GA, and is used by the web client version 2 and onwards. This endpoint is used to obtain login tokens for 3rd party integrations such as Business Objects.

Environment Endpoint

The environment endpoint was introduced in Maconomy 2.2.5 and 2.3GA and is used by the web client version 2 and onwards. This endpoint is used to retrieve the end-user's environment variable, e.g., employee name and number, company info etc.