GO является универсальным типом, который содержит в себе различные полезные методы. С помощью него можно выводить всплывающие сообщения, воспроизводить звуки, разбирать штрихкоды и др.
Методы
| Метод | Описание |
| void Copy (data) |
Копирует текст в буфер обмена* data — строка для копирования |
| string CreateUid () | Генерирует уникальный строковый GUID |
| string DecryptForDevice (value) |
Расшифровывает строку, зашифрованную на этом устройстве value — строка для дешифрования |
| string EncryptForDevice (value) |
Зашифровывает строку. Расшифровать можно только на этом устройстве value — строка для шифрования |
| string DecryptForUser (value) |
Расшифровывает строку, зашифрованную под текущим пользователем value — строка для дешифрования |
| string EncryptForUser (value) |
Зашифровать строку с возможностью расшифровки только под текущим пользователем value — строка для шифрования |
| BarcodeData GetBarcodeData (barcode) |
Возвращает объект для расширенной работы со штрихкодом barcode — строка, содержащая штрихкод |
| BarcodeData GetBarcodeData (barcode, type) |
Возвращает объект для расширенной работы со штрихкодом barcode — строка, содержащая штрихкод type — тип штрихкода из списка |
| void HideWaitMessage () | Закрыть сообщение об ожидании |
| string NormalizePhoneNumber (phoneNumber) |
Преобразовывает номер телефона в вариант с +7 вместо 8, вырезает лишние символы phoneNumber — номер для нормализации |
| void OpenUrl (url) | Открыть URL в браузере |
| void Play (audio) |
Воспроизводит звуковой файл audio — путь к файлу |
| void Play (audio, vibrate) |
Воспроизводит звуковой файл audio — путь к файлу vibrate — настройка вибрации |
| void PlayError () | Воспроизводит звук ошибки. |
| bool SendEmail (email, subject, text) |
Отправляет письмо на указанную почту * email — адрес получателя subject — заголовок письма text — текст письма |
| bool SendEmail (email, subject, text, errors) |
Отправляет письмо на указанную почту * email — адрес получателя subject — заголовок письма text — текст письма errors — прикрепить к письму логи с устройства |
| void SendErrorsLog () | Отправка логов на сервер качества* |
| void Share (data) |
Поделиться содержимым* data — путь к файлу или текст |
| void ShowBaloon (text, delay, down) |
Вызывает всплывающее сообщение с указанным текстом text — текст сообщения delay — время отображения в мс down — выводить в нижней части окна * |
| void ShowErrorBaloon (text, delay, down) |
Вызывает всплывающее сообщение об ошибке с указанным текстом. text — текст сообщения delay — время отображения в мс down — выводить в нижней части окна * |
| void ShowWaitMessage (text) |
Показывает сообщение об ожидании поверх интерфейса text — отображаемое сообщение. Поддерживает верстку |
| void ShowWaitMessage (text, canCancel) |
Показывает сообщение об ожидании поверх интерфейса с настройкой возможности скрыть его по нажатию text — отображаемое сообщение. Поддерживает верстку canCancel — можно ли скрыть сообщение нажатием |
| void Sleep (ms) |
Делает паузу в процессах на указанное кол-во мс ms — длительность паузы в миллисекундах |
| void Speak (text) |
Произносит указанный текст* text — фраза для воспроизведения |
| void SpeakRubles (value) |
Произносит указанную сумму с рублями и копейками* value — число для воспроизведения |
| void WriteError (text) |
Заносит в лог сообщение с типом ошибка text — текст сообщения |
| void WriteInformation (text) |
Заносит в лог сообщение с типом информация text — текст сообщения |
| void WriteWarning (text) |
Заносит в лог сообщение с типом предупреждение text — текст сообщения |
| void WriteLog (text, logType) |
Заносит в лог сообщение с указанным типом text — текст сообщения logType — тип записи в лог (info, warn, error, debug) |
* работает только на Android-устройствах
Примеры использования
Задача 1: Добавить возможность по сканированию определить, содержит ли штрихкод GTIN.
Решение:
Разберем пример подробнее:
-
В действии с именем метки «on scan» с помощью объекта типа BarcodeData проверяем, содержит ли отсканированный штрихкод в своем составе GTIN.
-
В действии с именем метки «gs1» выводим всплывающее сообщение в нижней части экрана с информацией о GTIN’e
-
В действии с именем метки «non gs1» выводим всплывающее сообщение об ошибке в нижней части экрана
Задача 2: В полях строк документа есть поле «Barcode», содержащее в себе штрихкод. Необходимо проверить, что в документе нет строк, в которых штрихкод не содержит GTIN.
Решение:
Разберем пример подробнее:
- В структуру полей документа добавляем вычислимое поле с именем «BarcodeData».
- В шаблоне данного поля прописываем метод получения объекта типа BarcodeData.
- В действии с именем метки «show» выводим поп-ап, с уведомлением о том, что началась проверка строк документа. Так как строк может быть много проверка может занять некоторое время.
- Далее в цикле в действии с именем метки «check line» проверяем, содержит ли штрихкод в своем составе GTIN. Если содержит, переходим к следующему элементу.
- В действии с именем метки «error»
- Скрываем поп-ап
- Записываем ошибку в лог
- Выводим сообщение для пользователя ТСД.
- Воспроизводим звук ошибки
- Производим возврат документа
- Действие с именем «hide» выполняется если проверка документа выполнена без ошибок.
Список типов кодировок
| AustraliaPost | EAN8 | PosiCode |
| Aztec | GRIDMATRIX | Postals |
| BooklandEAN | GS1_128 | Postnet |
| BPO | GS1_DATABAR | QR |
| CanadaPost | GS1_DATABAR_Expanded | RSS |
| ChinaPost | GS1_DATABAR_Limited | RSS14 |
| Codabar | GS1_DATABAR_OMNIDIRECTIONAL | RSSExpanded |
| Codablock | GS1_Databar14 | RSSLimited |
| Code11 | GS1_DATAMATRIX | Straight2of5 |
| Code128 | GS1_QR | Straight2of5_IATA |
| Code128Emultion | HANXIN | Straight2of5_Industrial |
| Code16k | HK25 | Telepen |
| Code32 | IDTag | TLC39 |
| Code32_PARAF | Interleaved2of5 | TriopticCode39 |
| Code39 | ISBT128 | UKPostal |
| Code49 | JapanPost | UNKNOWN_TYPE |
| Code93 | KoreanPost | UPCA |
| Composite_CCAB | Matrix2of5 | UPCA_2Supps |
| Composite_CCC | MaxiCode | UPCA_5Supps |
| Composite_TLC39 | MESA | UPCE0 |
| CompositeCode | MicroPDF | UPCE0_2Supps |
| CouponCode | MicroQR | UPCE0_5Supps |
| DataMatrix | MSI | UPCE1 |
| Discrete2of5 | Mx25 | UPCE1_2Supps |
| DOTCODE | NEC2OF5 | UPCE1_5Supps |
| DutchPost | NetherlandKIX | UPUFICS |
| EAN128 | OCR | US_Postal1 |
| EAN13 | PDF417 | US_Postnet |
| EAN13_2Supps | Planet | USPlanet |
| EAN13_5Supps | Plessey | USPSS4CB |
