Списки значений для ODataDB

ODataDB поддерживает следующие возможности:

ODataDB создает требуемые объекты OData автоматически.

Встроенный клиент JavaScript и SaveToDB 8+ поддерживают эти возможности из коробки.

Предположим, база данных содержит следующие таблицы:

Database Diagram of Sample 02 - Advanced Features

EntityType для s02.cashbook будет иметь следующее определение:

<EntityType Name="cashbook">
    <Key>
        <PropertyRef Name="id"/>
    </Key>
    <Property Name="id" Type="Edm.Int32" Nullable="false">
        <Annotation Term="Core.Permission" EnumMember="Core.Permission/Read"/>
    </Property>
    <Property Name="date" Type="Edm.Date" Nullable="false"/>
    <Property Name="account_id" Type="Edm.Int32" Nullable="false"/>
    <Property Name="item_id" Type="Edm.Int32"/>
    <Property Name="company_id" Type="Edm.Int32"/>
    <Property Name="debit" Type="Edm.Decimal"/>
    <Property Name="credit" Type="Edm.Decimal"/>
    <NavigationProperty Name="account" Type="s02.accounts" Partner="cashbooks">
        <ReferentialConstraint Property="account_id" ReferencedProperty="id"/>
    </NavigationProperty>
    <NavigationProperty Name="company" Type="s02.companies" Partner="cashbooks">
        <ReferentialConstraint Property="company_id" ReferencedProperty="id"/>
    </NavigationProperty>
    <NavigationProperty Name="item" Type="s02.items" Partner="cashbooks">
        <ReferentialConstraint Property="item_id" ReferencedProperty="id"/>
    </NavigationProperty>
</EntityType>

Клиентские приложения могут использовать NavigationProperties для создания списков значений.

Предположим, таблица xls.handlers содержит следующие настройки:

TABLE_SCHEMA	TABLE_NAME	COLUMN_NAME	EVENT_NAME	HANDLER_SCHEMA	HANDLER_NAME	HANDLER_TYPE	HANDLER_CODE
s02	cashbook	account_id	ValidationList	s02	accounts	TABLE	id, +name
s02	cashbook	item_id	ValidationList	s02	items	TABLE	id, +name
s02	cashbook	company_id	ValidationList	s02	companies	TABLE	id, +name

Определение колонок account_id, item_id и company_id типа s02.cashbook изменится следующим образом:

<EntityType Name="cashbook">
    ...
    <Property Name="account_id" Type="Edm.Int32" Nullable="false">
        <Annotation Term="ODataDB.ValueList" Path="default.default/accounts_select_id_name_order_by_name1"/>
    </Property>
    <Property Name="item_id" Type="Edm.Int32">
        <Annotation Term="ODataDB.ValueList" Path="default.default/items_select_id_name_order_by_name1"/>
    </Property>
    <Property Name="company_id" Type="Edm.Int32">
        <Annotation Term="ODataDB.ValueList" Path="default.default/companies_select_id_name_order_by_name1"/>
    </Property>
    ...
</EntityType>

Аннотации ODataDB.ValueList содержат пути к объявленным FunctionImport в EntityContainer с именем default схемы default:

<FunctionImport Name="s02_accounts_select_id_name_order_by_name1" Function="s02.accounts_select_id_name_order_by_name1" EntitySet="s02_accounts"/>
<FunctionImport Name="s02_items_select_id_name_order_by_name1" Function="s02.items_select_id_name_order_by_name1" EntitySet="s02_items"/>
<FunctionImport Name="s02_companies_select_id_name_order_by_name1" Function="s02.companies_select_id_name_order_by_name1" EntitySet="s02_companies"/>

Ниже приведено объявление функций в схеме s02:

<Function Name="accounts_select_id_name_order_by_name1">
    <ReturnType Type="Collection(s02.accounts)"/>
</Function>
<Function Name="items_select_id_name_order_by_name1">
    <ReturnType Type="Collection(s02.items)"/>
</Function>
<Function Name="companies_select_id_name_order_by_name1">
    <ReturnType Type="Collection(s02.companies)"/>
</Function>

Ниже приведен пример настройки для процедуры s02.usp_cashbook, которая выводит данные из таблицы s02.cashbook и имеет три параметра: account_id, item_id, company_id:

TABLE_SCHEMA	TABLE_NAME	COLUMN_NAME	EVENT_NAME	HANDLER_SCHEMA	HANDLER_NAME	HANDLER_TYPE	HANDLER_CODE
s02	usp_cashbook	account_id	ParameterValues	s02	accounts	TABLE	id, +name
s02	usp_cashbook	item_id	ParameterValues	s02	items	TABLE	id, +name
s02	usp_cashbook	company_id	ParameterValues	s02	companies	TABLE	id, +name

Ниже приведено объявление функций:

<EntityType Name="usp_cashbook_result" BaseType="s02.cashbook" OpenType="true"/>
<Function Name="usp_cashbook">
    <Parameter Name="account_id" Type="Edm.Int32">
        <Annotation Term="ODataDB.ValueList" Path="default.default/accounts_select_id_name_order_by_name"/>
    </Parameter>
    <Parameter Name="item_id" Type="Edm.Int32">
        <Annotation Term="ODataDB.ValueList" Path="default.default/items_select_id_name_order_by_name"/>
    </Parameter>
    <Parameter Name="company_id" Type="Edm.Int32">
        <Annotation Term="ODataDB.ValueList" Path="default.default/companies_select_id_name_order_by_name"/>
    </Parameter>
    <ReturnType Type="Collection(s02.usp_cashbook_result)"/>
</Function>

В примере также используется аннотация ODataDB.ValueList для указания функций получения списков значений.

Вы можете открыть полную модель онлайн:

https://odatadb.savetodb.com/v4/mssql-023/default/en-us/$metadata