Собрать сообщение из текста и ссылки, сохранив фиксированный состав

СообщениеNDEF ожидает ФиксированныйМассив записей. Показываем, почему изменение исходного обычного массива не добавляет запись в уже собранное сообщение.

Подготовка

1. Эти типы доступны в мобильном клиенте или мобильном приложении (клиент), начиная с 8.3.23. Непосредственно в обычном серверном модуле, тонком клиенте Windows или Конфигураторе их не запускайте.

2. Подготовьте отдельное учебное мобильное приложение/клиент на поддерживаемой платформе. В собственной управляемой форме создайте команду ВыполнитьПример и назначьте клиентский обработчик. Вставьте полный модуль одного урока.

3. Для создания объектов в памяти физическая NFC-метка не используется. Код не включает NFC, не запрашивает сканирование, не открывает URI и не записывает ничего на метку.

4. Все данные собственные учебные: Книга, guide-book, количество 3 и фиктивные домены example.invalid. Не кладите в NFC-примеры реальные токены, пароль, персональные сведения или ссылку на закрытую рабочую систему.

&НаКлиенте
Процедура ВыполнитьПример(Команда)
    Записи = Новый Массив;
    Записи.Добавить(Новый ТекстоваяЗаписьNDEF("Книга", "ru"));
    Записи.Добавить(Новый URIЗаписьNDEF("https://syntax-guide.example.invalid/book/guide-book"));
    Состав = Новый ФиксированныйМассив(Записи);
    Сообщение = Новый СообщениеNDEF(Состав);
    Сообщить(Сообщение.Записи.Количество() = 2);
    Сообщить(ТипЗнч(Сообщение.Записи[0]) = Тип("ТекстоваяЗаписьNDEF"));
    Сообщить(ТипЗнч(Сообщение.Записи[1]) = Тип("URIЗаписьNDEF"));
    Сообщить(Сообщение.Записи[0].Текст = "Книга");
    Сообщить("Полный размер сообщения в байтах: " + Строка(Сообщение.Размер));
    Записи.Добавить(Новый ТекстоваяЗаписьNDEF("Собственная третья запись", "ru"));
    Сообщить(Записи.Количество() = 3);
    Сообщить(Сообщение.Записи.Количество() = 2);
    НовоеСообщение = Новый СообщениеNDEF(Новый ФиксированныйМассив(Записи));
    Сообщить(НовоеСообщение.Записи.Количество() = 3);
КонецПроцедуры

Разбор по шагам

1. Создаём два собственных объекта записей и обычный массив. Перед конструктором сообщения явно преобразуем его в ФиксированныйМассив.

2. Первые два индекса существуют, потому что сообщение составлено самим уроком из двух записей. Для чужого считанного сообщения нужна отдельная проверка состава.

3. Размер относится к целому NDEF-сообщению в байтах, а не только строке Книга. Не выдумываем универсальную ёмкость любой физической метки.

4. Добавление третьей записи меняет только исходный обычный массив. Состав ранее созданного фиксированного сообщения остаётся из двух записей.

5. Для нового состава создаётся новое сообщение из нового фиксированного массива. Ни одно сообщение не отправляется на метку.

Как проверить результат

1. Семь контрольных Истина и фактический размер двухзаписного сообщения.

2. Старое сообщение содержит 2 записи, новое — 3. NFC-носитель не нужен и не изменён.

Ожидаемый результат

Показано правильное составление и пересоздание NDEF-сообщения из нескольких типизированных записей.

На что обратить внимание

1. Нельзя передавать обычный Массив вместо документированного ФиксированныйМассив.

2. Не сравнивайте размер сообщения с количеством его записей или символов текста.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.