跳到內容

OData

OData 在這裡被當成一種完整的協定,而不是需要自己動手加工的 HTTP:Restorm 認得它的 系統選項、它的操作,以及它的批次格式。

在樹狀結構中按右鍵 ▸ 新增 ▸ OData 請求

一個 OData 分頁,包含查詢選項編輯器 — $filter、$select、$top、$count、$orderby — 以及底部組合完成的 URL 預覽

欄位作用
URL服務端點,包含實體集
OData 版本v2v3v4v4.01
操作類型entity-setfunctionactionbatch
標頭 / 參數與 HTTP 請求相同

每個系統選項都有自己的欄位:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $formatjsonxmlatom)· $apply(彙總,v4.01)。

$filter 欄位還具備由匯入的中繼資料驅動的自動完成:屬性名稱與運算子都會列出來 供您選用。

對於 functionaction,Restorm 會提供一份具型別的操作參數清單 — 名稱、限定 的 CSDL 型別、是否可為 null、繫結標記 — 而動作另外還有專屬的 JSON 內文

batch 模式會帶著一份子請求清單,每個子請求各有自己的方法、URL、標頭、內文,以及 選填的原子性群組變更集)。有兩個選項:

  • 格式multipart(預設)或 json
  • 允許變更集中的 GET:預設停用;啟用它會觸發一則警告,因為 OData 並未規定這種 用法。

匯入一份 $metadata.edmx:Restorm 會為每個實體集建立一個資料夾及其 CRUD 請求,另外再加上 ActionsFunctions 資料夾。這些請求都會預先填好實體型別、 屬性、導覽屬性與查詢選項。請參閱 匯入 OData

Restorm 能託管一個 OData v4 模擬服務:您提供 CSDL 中繼資料文件(會照原樣供應)以及 各實體集的資料。系統選項會套用到所供應的資料上。請參閱 模擬 OData 服務