語法
OData.Feed(
serviceUri as text,
optional headers as nullable record,
optional options as any
) as any
關於
提供 OData 摘要資料表的 OData 服務,從 URI serviceUri 和標頭 headers 傳回資料。 布林值可以指定是否使用同時連線或選擇性的記錄參數 options,以控制下列選項:
-
Query:以程式設計方式將查詢參數新增至 URL,而不必擔心逸出。 -
Headers:將此值指定為記錄,會為 HTTP 要求提供額外的標頭。 -
ExcludedFromCacheKey:將此值指定為清單,會在計算快取資料時排除這些 HTTP 標頭金鑰。 -
ApiKeyName:若目標網站有 API 金鑰標記法,則此參數可以用來指定必須在 URL 中使用的金鑰參數名稱 (而非值)。 實際的金鑰值會在認證中提供。 -
Timeout:將此值指定為期間,會變更 HTTP 要求的逾時。 預設值為 600 秒。 -
EnableBatch:邏輯值(true/false),用於設定當超過 MaxUriLength 時,是否允許產生 OData $batch 要求(預設為 false)。 - `MaxUriLength:數字,指出允許傳送至 OData 服務 URI 的長度上限。 若超過此上限且 EnableBatch 為 true,則會對 OData $batch 端點發出要求;否則將會失敗 (預設為 2048)。
-
Concurrent:邏輯值 (true/false),當設為 true 時,對服務發出的請求會同時進行。 當設為 false 時,要求會以循序方式進行。 若未指定,則此值會由服務的 AsynchronousRequestsSupported 註釋決定。 若服務未指定是否支援 AsynchronousRequestsSupported,則要求會以循序方式發出。 -
ODataVersion:數字 (3 或 4),指定要用於此 OData 服務的 OData 通訊協定版本。 若未指定,則會要求所有支援的版本。 此服務版本會由服務所傳回的 OData-Version 標頭決定。 -
FunctionOverloads:邏輯 (true/false) 設為 true 時,函式匯入多載會在導覽器中列為個別項目;設為 false 時,函式匯入多載會在導覽器中列為一個 union 函式。 V3 的預設值:false。 V4 的預設值:true。 -
MoreColumns:邏輯值(true/false),當設為 true 時,會在每個包含開放類型和多形類型的實體資料流中新增「更多資料行」資料列。 這會包含未在基底類型中宣告的欄位。 若為 false,則此欄位不存在。 預設為 False。 -
IncludeAnnotations:要包含的命名空間限定字詞名稱或模式的逗號分隔清單,其使用 "*" 作為萬用字元。 預設不會包含任何註釋。 -
IncludeMetadataAnnotations:在中繼資料文件請求中,要包含的命名空間限定詞名稱或模式的逗號分隔清單,使用 "*" 作為通配符。 預設會包含與 IncludeAnnotations 相同的註釋。 -
OmitValues:允許 OData 服務避免在回應中寫出特定值。 若獲得服務的認可,則我們會從省略的欄位中推斷那些值。 選項包括:-
ODataOmitValues.Nulls:允許 OData 服務省略 null 值。
-
-
Implementation:指定要使用的 OData 連接器實作。 有效值為 "2.0" 或 null。
範例 1
連線到 TripPin OData 服務。
使用方式
OData.Feed("https://services.odata.org/V4/TripPinService")
輸出
table