Получает количество элементов коллекции.
Синтаксис
Количество()Полное описание, параметры и ограничения
ФиксированныйСписокКомпонентXS.Количество (XSComponentFixedList.Count)
ФиксированныйСписокКомпонентXS (XSComponentFixedList)
Количество (Count)
Доступен, начиная с версии 8.1.
Синтаксис:
Количество()
Возвращаемое значение:
Тип: Число.
Описание:
Получает количество элементов коллекции.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать и удалить собственную копию appinfo
Рекурсивную копию информационного компонента добавляем в свою аннотацию, задаём другой source и удаляем только её. Оригинал остаётся прежним.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с documentation и appinfo включена в код, внешние файлы и сервисы не используются.
source=urn:guide:training — метка собственного ресурса, не http URL. Текст g:lesson — учебная информация приложения, не требование XML-валидации.
Работа ведётся только со своей моделью и DOM. Проверка набора проверяет схему, а не документ с данными товара.
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:product"" targetNamespace=""urn:guide:product""
| elementFormDefault=""qualified"" version=""1.0"" xml:lang=""ru"">
| <xs:annotation><xs:documentation>Учебный товар, не контракт внешнего API</xs:documentation><xs:appinfo source=""urn:guide:training""><g:lesson>Учебный код товара</g:lesson></xs:appinfo></xs:annotation>
| <xs:simpleType name=""Sku""><xs:restriction base=""xs:string"">
| <xs:length value=""4""/><xs:pattern value=""[A-Z][0-9]{3}""/>
| </xs:restriction></xs:simpleType>
| <xs:complexType name=""Product""><xs:sequence>
| <xs:element name=""name"" type=""xs:string""/>
| <xs:element name=""quantity"" type=""xs:nonNegativeInteger""/>
| <xs:element name=""note"" type=""xs:string"" minOccurs=""0""/>
| </xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
Аннотация = Схема.Аннотация;
Если Аннотация = Неопределено Тогда
ВызватьИсключение "Нет аннотации собственной схемы";
КонецЕсли;
Если Аннотация.ИнформацияДляПриложения.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный appinfo";
КонецЕсли;
Информация = Аннотация.ИнформацияДляПриложения.Получить(0);
Если ТипЗнч(Информация) <> Тип("ИнформацияДляПриложенияXS") Тогда
ВызватьИсключение "Ожидалось описание информации приложения";
КонецЕсли;
Копия = Информация.КлонироватьКомпоненту(Истина);
Если ТипЗнч(Копия) <> Тип("ИнформацияДляПриложенияXS") Тогда
ВызватьИсключение "Не получена копия appinfo";
КонецЕсли;
Копия.Источник = "urn:guide:training:copy";
Сообщить(Не Информация.Содержит(Копия));
Аннотация.Состав.Добавить(Копия);
Сообщить(Аннотация.ИнформацияДляПриложения.Количество() = 2);
Сообщить(Копия.Контейнер = Аннотация);
Схема.ОбновитьЭлементDOM();
Сообщить(Копия.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:training:copy");
Сообщить(Информация.Источник = "urn:guide:training");
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Собственная схема с копией appinfo не прошла проверку";
КонецЕсли;
Аннотация.Состав.Удалить(Копия);
Сообщить(Аннотация.ИнформацияДляПриложения.Количество() = 1);
Сообщить(Аннотация.Документация.Количество() = 1);
Сообщить(Информация.Источник = "urn:guide:training");Разбор по шагам
Копия проверена на точный тип до записи Источник.
Само клонирование не присоединяет компонент к аннотации. Содержит оригинала не подтверждает принадлежность копии.
Состав — изменяемая коллекция всей аннотации. Добавить в неё увеличивает список appinfo, но не documentation.
DOM обновляется через собственную схему после присоединения; новая метка проверяется по атрибуту source.
Удалить получает ровно созданную копию. После удаления она не используется; оригинальная метка и documentation сохранены.
Как проверить результат
Восемь сообщений Истина.
Количество appinfo меняется 1→2→1, количество documentation остаётся 1.
Ожидаемый результат
Полный жизненный цикл собственной копии не повреждает оригинальную аннотацию.
На что обратить внимание
Не используйте удалённую копию и не очищайте всю аннотацию чужой схемы.
Служебная информация не доказывает корректность XML-экземпляра товара.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать и изменить source у собственного appinfo
Служебная информация приложения живёт в аннотации XSD. Изменяем её метку источника и проверяем реальный атрибут DOM.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с documentation и appinfo включена в код, внешние файлы и сервисы не используются.
source=urn:guide:training — метка собственного ресурса, не http URL. Текст g:lesson — учебная информация приложения, не требование XML-валидации.
Работа ведётся только со своей моделью и DOM. Проверка набора проверяет схему, а не документ с данными товара.
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:product"" targetNamespace=""urn:guide:product""
| elementFormDefault=""qualified"" version=""1.0"" xml:lang=""ru"">
| <xs:annotation><xs:documentation>Учебный товар, не контракт внешнего API</xs:documentation><xs:appinfo source=""urn:guide:training""><g:lesson>Учебный код товара</g:lesson></xs:appinfo></xs:annotation>
| <xs:simpleType name=""Sku""><xs:restriction base=""xs:string"">
| <xs:length value=""4""/><xs:pattern value=""[A-Z][0-9]{3}""/>
| </xs:restriction></xs:simpleType>
| <xs:complexType name=""Product""><xs:sequence>
| <xs:element name=""name"" type=""xs:string""/>
| <xs:element name=""quantity"" type=""xs:nonNegativeInteger""/>
| <xs:element name=""note"" type=""xs:string"" minOccurs=""0""/>
| </xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
ЧтениеДерева = Новый ПостроительDOM;
ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
Аннотация = Схема.Аннотация;
Если Аннотация = Неопределено Тогда
ВызватьИсключение "Нет аннотации собственной схемы";
КонецЕсли;
Если Аннотация.ИнформацияДляПриложения.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный appinfo";
КонецЕсли;
Информация = Аннотация.ИнформацияДляПриложения.Получить(0);
Если ТипЗнч(Информация) <> Тип("ИнформацияДляПриложенияXS") Тогда
ВызватьИсключение "Ожидалось описание информации приложения";
КонецЕсли;
Сообщить(Информация.Источник = "urn:guide:training");
Сообщить(Информация.Контейнер = Аннотация);
Сообщить(Информация.КорневойКонтейнер <> Неопределено);
Сообщить(Информация.Схема.ПространствоИмен = "urn:guide:product");
Сообщить(Информация.Аннотация = Неопределено);
Сообщить("Тип компонента: " + Строка(Информация.ТипКомпоненты));
Сообщить("Компонентов XS внутри appinfo: " + Строка(Информация.Компоненты.Количество()));
Информация.Источник = "urn:guide:training:revised";
Информация.ОбновитьЭлементDOM();
Сообщить(Информация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:training:revised");
Сообщить(Аннотация.Документация.Количество() = 1);Разбор по шагам
Аннотация проверяется на отсутствие до чтения списка appinfo. Количество проверено до Получить(0).
Контейнер appinfo — Аннотация, Схема указывает на собственный urn:guide:product.
Свойство Аннотация самого appinfo отдельно от его владельца; в исходном фрагменте оно отсутствует.
Источник здесь простой URN. Присваивание метки не является загрузкой данных по этой метке.
ОбновитьЭлементDOM переносит новую метку в XML-атрибут source. Соседнее documentation остаётся одним компонентом.
Как проверить результат
Семь сравнений Истина и две диагностические строки.
source изменён на собственную метку revised; описание документации не удалено.
Ожидаемый результат
Служебная метка связана с DOM без выдачи appinfo за правило валидации.
На что обратить внимание
ИнформацияДляПриложения не заменяет объявления элементов и фасеты типов.
Число Компоненты XS не является количеством произвольных DOM-тегов g:lesson.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.