Protocol Configuration

The protocol configuration is used to define specific ways of communication to the backend. This is typically a leave alone part of the configuration. 

<start>
  ...
  <protocols>
    <protocol id="classic" barcodeSeparator=";" compression="GZip" decimalSeparator="." expirationDateSeparator="," ignoreCertificateErrors="false" ntlmV2Only="true" timeout="300"/>
  </protocols>
  ...
</start>
  • <protocol> - Contains information about the communication between client and backend. 
    • id = "" - Id to reference from the endpoint configuration.
    • allowSelfSignedCertificates = "false" - Allow the app to communicate with a server with a self signed certificate. Settings this value to true is not advised.
      DEPRECATED (from v. 1.11) - This attribute has been replaced by ignoreCertificateErrors

    • barcodeSeparator = ";" - Order lines can have multiple identifiers, which are listed in the ItemBarcode property on the order line. To get the individual identifiers this character is used to separate them. E.g. 114466;114455;7610400074520.

    • compression = "None|GZip" - Defines the compression type for communication. Especially useful on slow connections.
    • decimalSeparator = "." - Character used as the decimal separator when sending decimal values to the backend.  Note: This must match the language of the backend service. You should only change this setting if the service is running in non-English language.

    • expirationDateSeparator = "," - Character added between the serial number or lot number and the expiration date, when sending registrations to the backend.

    • ignoreCertificateErrors = "false" - Enabling this feature will make the application ignore any certificate error. Avoid using this functionality as it could potentially allow insecure communication.
    • ntlmV2Only = "true|false" - Forces the app to use NTML2, as some servers are setup to refuse LM and NTML.
    • timeout = "" - Defines the default timeout for requests to the backend in seconds. Default is 300.