Skip to content
Merged
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
2 changes: 1 addition & 1 deletion content/en/docs/workstation/wks-build-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ To change a user's role, or remove them from the workspace, click the three dot
Now that you are ready to start using Mendix Workstation Client, you can implement your own custom logic for interacting with devices. The following nanoflows and Java actions are essential for establishing connections, sending or receiving messages, and managing device interactions:

* **GetStation** - Retrieves the computer information connected to the Client.
* **SendMessage** - Sends data or commands to the connected device. For more information about the supported message syntax, see [Message Syntax for File, Smart Card, and Bluetooth Devices](/mendix-workstation/message-syntax/).
* **SendMessage** - Sends data or commands to the connected device. For more information about the supported message syntax, see [Message Syntax for File, Smart Card, and Bluetooth Devices](/mendix-workstation/device-syntax/).
* **SubscribeToMessages** - Subscribe a nanoflow to be called when the device is sending a message.
* **SubscribeToErrors** - Subscribe a nanoflow to be called on device connection errors.
* **Unsubscribe** - End the subscription to device messages or errors.
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/workstation/wks-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ After configuring the server and client pair, test their connectivity by perform
8. In the same way, send a message from the **Test Server** to the **Test Client** device.

{{% alert color="info" %}}
Different device types have different requirements for the message syntax. For more information, see [Message Syntax for File, Smart Card, and Bluetooth Devices](/mendix-workstation/message-syntax/).
Different device types have different requirements for the message syntax. For more information, see [Message Syntax for File, Smart Card, and Bluetooth Devices](/mendix-workstation/device-syntax/).
{{% /alert %}}

## Quitting the Workstation Client
Expand Down
32 changes: 26 additions & 6 deletions content/en/docs/workstation/wks-message-syntax.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Message Syntax for File, Smart Card, and Bluetooth Devices"
linktitle: "Message Syntax"
url: /mendix-workstation/message-syntax/
linktitle: "Device Syntax"
url: /mendix-workstation/device-syntax/
description: "Provides information about the message syntax required for different device types."
weight: 40
---
Expand Down Expand Up @@ -31,10 +31,10 @@ This device type requires the following message and response:

### Message

* `0# Directory` - Watch for changes in `Directory`. If `Directory` is a file path, then watch for changes in the file. `Directory` is relative to the folder configured in Workspace management. Environment variables (for example, `%public%`) are supported.
* `1# Directory` - Stop watching for changes in `Directory`.  
* `2# File path` - Read file at `File path`.
* `3# File path # Data # flag` - Write to file at `File path`. The `flag` can be `w` for overwrite, `a` for append If left blank, the value defaults to `w`.
* `0#Directory` - Watch for changes in `Directory`. If `Directory` is a file path, then watch for changes in the file. `Directory` is relative to the folder configured in Workspace management. Environment variables (for example, `%public%`) are supported.
* `1#Directory` - Stop watching for changes in `Directory`.  
* `2#File path` - Read file at `File path`.
* `3#File path#Data#flag` - Write to file at `File path`. The `flag` can be `w` for overwrite, `a` for append If left blank, the value defaults to `w`.

### Response

Expand All @@ -44,6 +44,26 @@ This device type requires the following message and response:
* `E#Error` - `Error` message from operating system
* `S#{0,1,2,3}#directory` - The command `{0,1,2,3}` on `directory` was successful.

### Example Test

The section below shows a sample test that you can run to verify the configuration.

1. Create a new Workspace in the Workstation Management.
2. Create a new Station.
3. Add a `File Device` with the following configuration to this Station:
* **Device Name** - *Write files to test folder*
* **Allowed Folder** - For example, on a Windows computer you can use a path like `C:\MyTestFolder`
* **Allow writing files** - **Yes**
* Use the default values for everything else
4. Register the Station to your computer (assuming the Workstation Client is installed there).
5. In your Workspace, navigate to **Test Your Station** and click on the configured file device.
6. Enter `3#test.txt#Hello from Mendix` in the **Send Message** field, and then press **Send Message**.

The test should show a response like `S#3#C:\MyTestFolder\test.txt` to indicate that the text file *test.txt* was succesfully written to *MyTestFolder*.

7. Go to *C:\MyTestFolder* and verify that it contains the text file.
8. Open the test file and verify that it contains the text *Hello from Mendix*.

## Smart Cards

This device type requires the following message and response:
Expand Down