Объект
CashMaticResult используется для передачи результата выполнения асинхронного запроса обработчику результата (в текущей версии асинхронные запросы создаются методами создаются методами
GetDeviceProtocol() и
GetDeviceIdentification() объекта
CashMaticCash, в дальнейшем предполагается расширение применения этого механизма в
NDemia CashMatic).
Прикладной скрипт или компонент расширения не могут создать объект
CashMaticResult, но могут получить его через интерфейс обработчика результата запроса
CashMaticResultHandler (см.
Примеры опроса идентификации купюроприёмника).
Все свойства объекта
CashMaticResult доступны только на чтение, поскольку описывают результат уже завершившегося запроса, изменение свойств не имеет прикладного смысла.
Основным является свойство
Data, конкретный его тип зависит от вида выполненного запроса (тип результата должен описываться в спецификации запроса).
Обработчик результата запроса должен проверять код результата (свойство
Code), нулевой код соответствует нормальному завершению, другие значения указывают на ошибки, набор возможных значений определяется видом запроса.
Для упрощения формирования текстовых сообщений по результатам выполнения запроса используется свойство
Description (разъяснение результата запроса в человекочитаемом текстовом виде).
| Имя | Тип результата | Тип обращения | Назначение |
| Code | Число | Свойство, только чтение | Код завершения запроса (код результата). Набор возможных значений определяется видом запроса.
Нулевой код должен соответствовать положительному результату. |
| Data | Объект | Свойство, только чтение | Данные результата запроса. Тип и значение определяются видом запроса.
Обращение к свойству допустимо только после завершения запроса с положительным результатом. |
| Description | Строка | Свойство, только чтение | Текстовое разъяснение результата запроса (человекочитаемый текст). |
| Result | Строка | Свойство, только чтение | Результат запроса, необработанное внутреннее представление.
Свойство Result имеет только отладочное назначение, для прикладных целей должны использоваться свойства Code и Data.
|
| Subject | Строка | Свойство, только чтение | Кратко сформулированный предмет запроса (в человекочитаемом виде, для отладочных целей). |
Совместимость: объект CashMaticResult поддерживается в NDemia CashMatic, начиная с версии 2.6.0
