Odata Data Sharing

mdl 1;
CREATE CONSTANT ProductClient.ProductDataApiLocation
  ( Type: String, DefaultValue: 'http://localhost:8080/odata/productdataapi/v1/' );

CREATE CONSUMED ODATA SERVICE ProductClient.ProductDataApiClient (
  ODataVersion: OData4,
  MetadataUrl: 'https://api.example.com/$metadata',
  ServiceUrl: ProductClient.ProductDataApiLocation  -- ✅ Constant reference
);

mdl 1;
CREATE CONSUMED ODATA SERVICE ProductClient.ProductDataApiClient (
  ODataVersion: OData4,
  MetadataUrl: 'https://api.example.com/$metadata',
  ServiceUrl: 'https://api.example.com/odata'  -- ❌ Direct URL not allowed
);

┌─────────────────────────────────────────────┐
│  PRODUCER APP                               │
│                                             │
│  persistent entities  ──▶  view entities    │
│  (Shop.Customer,          (Api.CustomerVE)  │
│   Shop.Address)                             │
│                          ▼                  │
│                    odata service             │
│                   (Api.CustomerApi)          │
└──────────────────────┬──────────────────────┘
                       │ HTTP/OData4
┌──────────────────────▼──────────────────────┐
│  CONSUMER APP                               │
│                                             │
│                    odata client             │
│                  (Client.CustomerApiClient)  │
│                          ▼                  │
│                  external entities           │
│                 (Client.CustomersEE)         │
│                          ▼                  │
│                  pages & microflows          │
└─────────────────────────────────────────────┘

-- v1: Original API (keep running for existing consumers)
create published odata service ProductApi.ProductDataApi (
  path: 'odata/productdataapi/v1/',
  version: '1.0.0',
  ...
);

-- v2: New version with additional fields
create published odata service ProductApi.ProductDataApi_v2 (
  path: 'odata/productdataapi/v2/',
  version: '2.0.0',
  ODataVersion: OData4,
  ServiceName: 'ProductDataApi',
  Summary: 'Product API v2 - includes weight and tags',
  ...
)
authentication basic
{
  publish entity ProductApi.ProductWithPriceAndTagsVE as 'Product' (
    ReadMode: ReadFromDatabase,
    InsertMode: microflow ProductApi.InsertProductV2,
    UpdateMode: microflow ProductApi.UpdateProductV2,
    DeleteMode: microflow ProductApi.DeleteProductV2
  )
  expose (...);
};

-- Format 1: HTTP(S) URL
create consumed odata service ProductClient.ProductDataApiClient folder 'Integration/ProductAPI' (
  ODataVersion: OData4,
  MetadataUrl: 'https://api.example.com/odata/v4/$metadata'
);

-- Format 2: Absolute file:// URI
create consumed odata service ProductClient.ProductDataApiClient folder 'Integration/ProductAPI' (
  ODataVersion: OData4,
  MetadataUrl: 'file:///Users/team/contracts/productdataapi.xml'
);

-- Format 3a: Relative path with ./
create consumed odata service ProductClient.ProductDataApiClient folder 'Integration/ProductAPI' (
  ODataVersion: OData4,
  MetadataUrl: './metadata/productdataapi.xml'
);

-- Format 3b: Relative path without ./
create consumed odata service ProductClient.ProductDataApiClient folder 'Integration/ProductAPI' (
  ODataVersion: OData4,
  MetadataUrl: 'metadata/productdataapi.xml'
);

create published odata service ProductApi.ProductDataApi (
  path: 'odata/productdataapi/v1/',
  version: '1.0.0',
  ODataVersion: OData4,
  folder: 'Integration/APIs'
)
authentication basic
{ ... };

-- List all published and consumed services
list published odata services;
list consumed odata services;

-- Inspect a specific service
describe published odata service ShopViews.ShopViewsApi;
describe consumed odata service ShopViewsClient.ShopViewsApiClient;

-- See external entities and view entities
list entities in ShopViewsClient;
list external entities;
list external actions;

-- Browse available assets from cached $metadata contract
list contract entities from ShopViewsClient.ShopViewsApiClient;
list contract actions from ShopViewsClient.ShopViewsApiClient;
describe contract entity ShopViewsClient.ShopViewsApiClient.Product;
describe contract entity ShopViewsClient.ShopViewsApiClient.Product format mdl;

-- Check security setup
list access on odata service ShopViews.ShopViewsApi;
list module roles in ShopViews;