diff --git a/content/en/docs/workstation/wks-build-app.md b/content/en/docs/workstation/wks-build-app.md index fecfe247904..8a6ba81e4fb 100644 --- a/content/en/docs/workstation/wks-build-app.md +++ b/content/en/docs/workstation/wks-build-app.md @@ -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. diff --git a/content/en/docs/workstation/wks-installation.md b/content/en/docs/workstation/wks-installation.md index 1b4d2ca9d9f..030a0033228 100644 --- a/content/en/docs/workstation/wks-installation.md +++ b/content/en/docs/workstation/wks-installation.md @@ -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 diff --git a/content/en/docs/workstation/wks-message-syntax.md b/content/en/docs/workstation/wks-message-syntax.md index 7429ec8a341..39e0b2d7094 100644 --- a/content/en/docs/workstation/wks-message-syntax.md +++ b/content/en/docs/workstation/wks-message-syntax.md @@ -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 --- @@ -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 @@ -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: