Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 34 additions & 6 deletions content/en/docs/workstation/wks-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ A *station* represents a workstation on the shop floor. It can connect to one or

{{< figure src="/attachments/workstation/wks-install1.png" class="no-border" >}}

3. Enter a name for your new workspace, and then click **Create Workspace**.
3. Enter a name for your new workspace, specify the environment type (**Test**, **Acceptance** or **Production**), and then click **Create Workspace**.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

{{< figure src="/attachments/workstation/wks-install2.png" class="no-border" >}}

Expand Down Expand Up @@ -196,7 +196,7 @@ Auto-refresh settings are available in Workstation Management at **Settings > Cl

By default, the Workstation Client operates in auto-refresh mode. That is, any changes made to the configuration in Workstation Management are immediately reflected in the Client.

To change this behavior, set the **Auto-Refresh Mode** toggle to **Off**. You can then force the configuration to refresh by clicking **Refresh on Computer** in Workstation Management, or by clicking **Refresh** in the Workstation Client.
To change this behavior, set the **Auto-Refresh Mode** toggle to **Off**. You can then force the configuration to refresh by clicking **Sync Clients** in Station Overview, or by clicking **Refresh** in the Workstation Client.

The **Check Interval** setting is only available when the auto-refresh mode is enabled. It specifies how often a Workstation Client that is disconnected due to a web socket failure should automatically refresh its configuration by polling Workstation Management. By default, this happens every 60 minutes.

Expand Down Expand Up @@ -281,6 +281,18 @@ For production environments, it is recommended to disable *Developer Mode* to pr

#### Device Settings

##### Configuration in Management UI
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

To add a printer device, perform the following steps:

1. Navigate to the **Devices** section on the **Station Detail** page.
2. Click **Add Device** and select the device type.
3. Enter a meaningful name for the device, for example, *Shopfloor Printer*.
4. Optional: Select or create a class to help you manage your devices, for example, *Building A Printers*.
5. Specify the information required to connect to the device.

The required information depends on the type of the device. For some devices, like printers, you must only specify the device name. For others, like Serial Port devices, you can use a variety of identifiers such as serial numbers, manufacturer names, and others.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

##### Card Readers

Card reader devices cannot be configured as separate devices in the **Devices** overview of a **Station** page. Instead, they are automatically detected by the Workstation Client and added to the device list of the Client.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
Expand All @@ -289,9 +301,19 @@ Auto detecting card readers is enabled by default. This setting can be configure

Refer to [Message Syntax - Card Readers](/mendix-workstation/device-syntax/#card-readers) for a more in-depth explaination how to communicate with card readers.

### Serial Port Devices
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

Serial Port devices allow you to connect to a device with a serial port.

##### Bluetooth Devices

Add Bluetooth LE (BLE) devices that use the ATT protocol by entering the exact device name as displayed in your OS' device manager

Refer to [Message Syntax - Bluetooth](/mendix-workstation/device-syntax/#bluetooth) for a more in-depth explaination how to communicate with bluetooth devices.

##### File Device

This section explains the configuration of a file device. Refer to [Message Syntax - File Device](/mendix-workstation/device-syntax/#file-device) for a more in-depth explaination how to communicate with file devices.
File devices allow you to read and write from a file. Refer to [Message Syntax - File Device](/mendix-workstation/device-syntax/#file-device) for a more in-depth explaination how to communicate with file devices.

###### Allowed Folder Configuration

Expand All @@ -316,8 +338,14 @@ Windows and Unix-style paths can be used independently of the operating system t

The administrator can choose to allow either one or a combination of the following permissions: subscribe to change events, read files, and write files.

##### Bluetooth Devices
##### TCP/IP Client

Simply add Bluetooth LE (BLE) devices that use the ATT protocol by entering the exact device name as displayed in your OS' device manager
TCP/IP clients allow you to connect to remote devices over the network.

Refer to [Message Syntax - Bluetooth](/mendix-workstation/device-syntax/#bluetooth) for a more in-depth explaination how to communicate with bluetooth devices.
##### TCP/IP Server

TCP/IP clients allow you to host connections over the network.

##### Printers

You can integrate your Workstations with printer devices.
12 changes: 12 additions & 0 deletions content/en/docs/workstation/wks-message-syntax.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,3 +86,15 @@ Send instruction in hexadecimal as a string, for example, *FFCA000000* to read t
* `1#` - Card disconnected
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
* `2# Response` - Response from device as raw hexadecimal.
* `3# Error` - Error message from device.

## Printers

This device type requires the following message and response:

### Message

A print command, for example, `P#TESTHELLO#RAW#aGVsbG8=`.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

### Response

The output of the print command, for example, `hello` in a *TESTHELLO.prn* file.
27 changes: 27 additions & 0 deletions content/en/docs/workstation/wks-monitoring.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
title: "Monitoring Mendix Workstation"
linktitle: "Monitoring"
url: /mendix-workstation/monitoring/
description: "Describes how to access and use the Usage Report page of Mendix Workstation."
weight: 35
---

## Introduction

Mendix Workstation provides detailed usage reports that show how stations are being used across your different workspaces and company. This helps you understand and optimize your Workstation deployment.

Workstation Clients automatically report their daily active usage to the server, tracking which stations were used and on which days. This data powers the usage reports, giving you valuable insights without extra effort.
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.

## Accessing the Usage Reports

You can access the Usage Reports by performing the following steps:

Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
1. To view the reports for all workspaces that you own or administer, go to Workstation Management, and click **My Usage Report**.

{{< figure src="/attachments/workstation/wks-usage1.png" class="no-border" >}}

2. To view the reports for a specific workspace, open the workspace in Workstation Management, and then click **Usage**.

{{< figure src="/attachments/workstation/wks-usage2.png" class="no-border" >}}

The Usage Reports display information about the usage trends for each station both daily and over time.
6 changes: 6 additions & 0 deletions content/en/docs/workstation/wks-troubleshooting.md
Comment thread
katarzyna-koltun-mx marked this conversation as resolved.
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ Contact Mendix Support to transfer workspace ownership.

## Workstation Client

### Logs

By default, the Client retains logs of up to 10 MB for the past seven days locally on your computer. Access logs by clicking the **Logs** button on the Client UI, then optionally selecting the level of logs you want to see. Opening the Client's console through the browser developer tools (**Ctrl + Shift + I**) can also provide additional information about encountered errors in the UI of the Client.

Log files are also available by day in the Client's app data folder. On Windows, press **Win + R** and enter:
Expand All @@ -42,6 +44,10 @@ On Linux, the *Mendix Workstation/logs* folder is located at either `$XDG_CONFIG
* Start the Workstation Client. Click the three-dot icon in the top tight, then click **Logs**. Debug level logs are only available in *Developer Mode*
* Start the Workstation Client from PowerShell: `start "C:\Program Files\Mendix Workstation\Mendix Workstation.exe" -ArgumentList "--log-level=debug" -wait`.

### Diagnostics

When [Developer Mode](/mendix-workstation/installation/#developer-mode) is enabled, the Client also shows a **Diagnostics** page. This page displays information about the available devices, credentials, station configuration, system info, and log levels, which you can use to help you troubleshoot any issues.

### Registration Token Could Not Be Parsed

The Client shows an error like the following: *Registration token could not be parsed. Please enter another token!*
Expand Down
Binary file modified static/attachments/workstation/wks-install2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/attachments/workstation/wks-usage1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/attachments/workstation/wks-usage2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading