Правила формирования имени ресурса
страницаПравила формирования имени ресурса
При обращении к какому-либо ресурсу его идентификатор формируется по следующему принципу: ПрефиксИмени_ИмяОбъектаКонфигурации_СуффиксИмени. С помощью стандартного интерфейса OData можно получить доступ к следующим объектам (табл. 1.1).
Таблица 1.1. Имена ресурсов для объектов конфигурации
| Объект конфигурации | Префикс имени для указания в URL |
|---|---|
| Справочник | Catalog |
| Документ | Document |
| Журнал документов | DocumentJournal |
| Константа | Constant |
| План обмена | ExchangePlan |
| План счетов | ChartOfAccounts |
| План видов расчета | ChartOfCalculationTypes |
| План видов характеристик | ChartOfCharacteristicTypes |
| Регистр сведений | InformationRegister |
| Регистр накопления | AccumulationRegister |
| Регистр расчета | CalculationRegister |
| Регистр бухгалтерии | AccountingRegister |
| Бизнес-процесс | BusinessProcess |
| Задача | Task |
ИмяОбъектаКонфигурации – имя объекта конфигурации, как оно задано при разработке прикладного решения в конфигураторе.
СуффиксИмени – предназначен для уточнения имени ресурса и является необязательной частью имени. В качестве суффикса имени могут выступать следующие выражения:
- имя табличной части объекта;
- имя реквизита табличной части или набора записей;
- имя виртуальной таблицы регистра;
- RowType;
- RecordType.
Если объект обладает табличной частью, то для получения доступа ко всем записям этой табличной части необходимо добавить имя табличной части после имени самого объекта. Например, для получения всех строк табличной части Товары всех документов РасходТовара будет необходимо выполнить GET-запрос по следующему адресу: http://localhost/base/odata/standard.odata/Document_РасходТовара_Товары. Соответствующий пример будет рассмотрен в разделе «Получение данных из табличной части документа».
Если объект обладает табличной частью, то имеется возможность указать, что требуется получение не всех реквизитов табличной части, а некоторого списка этих реквизитов. Для этого необходимо указать в параметре $select список требуемых реквизитов в следующем виде: <Имя табличной части>/<Имя поля>. Аналогичная возможность предоставляется для наборов записей регистров, где в качестве имени табличной части выступает RecordSet: RecordSet/<Имя поля>.
В роли виртуальной таблицы регистра выступает функция, связанная с ресурсом, возвращающая набор сущностей регистра. Имя функции совпадает с английским вариантом имени используемой виртуальной таблицы языка запросов. Параметры функции соответствуют параметрам виртуальной таблицы. Так, для получения среза последних регистра сведений КурсыВалют следует выполнить GET-запрос по следующему адресу: http://localhost/demo/odata/standard.odata/InformationRegister_КурсыВалют/SliceLast(). Соответствующий пример будет рассмотрен в разделе «Получение данных регистра сведений».
Подробнее
Правила формирования имен ресурсов для получения данных через REST-интерфейс более подробно описаны в документации «1С:Предприятия» в разделе «Глава 17. Механизмы интернет-сервисов – HTTP-сервисы – Стандартный интерфейс ODATA – Правила формирования имени ресурса».