The Remote Sampler Cloud Adaptor service (adaptor) can be set to read and write data to and from XML files to allow it to integrate indirectly with external data systems. All initial configuration should be entered in the settings.ini file described in detail here.
Data Import
The adaptor polls a preconfigured folder and reads all XML files present. The extracted data is sent securely over HTTPS to the Remote Sampler cloud API where the data is processed and displayed to users of the Remote Sampler web hub for assignment to device users. Following successful upload to the cloud system, the local source file is deleted.
Data Export
The adaptor polls the Remote Sampler cloud API securely over HTTPS and downloads completed work in the form of Javascript Object Notation files (JSON), which it parses and then writes to uniquely named XML files in a preconfigured export folder.
Log Files
The adaptor generates log files which can be used to assist in debugging the service. The log files are written to the location specified below.
<Installation Directory>\ApplicationLogs
Installation Requirements and Prerequisites
General hardware requirements are covered here. Specific requirements for the adaptor are listed below.
- Firewall configuration on machine set to allow outbound HTTPS traffic to the port 8081 on the domain of the cloud Remote Sampler system (usually of the form https://live.<customer>.remotesampler.com but this will be confirmed at the time of implementation).
- Creation of a Windows service user with a non-expiring password with permission to read/write files to the installation folder of the adaptor service.
IP Address versus Domain Name
Note that firewall configuration for communications with the Remote Sampler cloud API should use the domain name rather than specific IP addresses to ensure the provision of a highly-available system.