搜尋

功能區塊 HTTP_REQUEST

功能區塊 HTTP_REQUEST 建立一個原始資料的 HTTP 介面查詢。

重要： 必須將要發送的變數設定為 HTTP 介面的原始資料型別。

URI 會在右側的通訊區域中定義為一個變數。如果 URI 以 / 開頭，則第一個 / 會被移除。若要對最低層級目錄發出請求，只需將變數設定為 /。

某些網頁伺服器需要使用者代理標頭。否則，頁面將不會載入。這不是 Antcas Control 的錯誤，而是所要求的網頁瀏覽器的保護機制。請使用輸入標頭並填入以下內容：

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

輸入定義傳輸的方法為字串。這可以是例如 "GET"、"POST"、"PUT" 等。若未定義方法，則預設為 GET。

輸入定義標頭的內容類型為字串。若未定義輸入，則不會將該項目加入標頭中。

定義額外的標頭項目為字串。多個標頭以換行符分隔。內容長度標頭會自動定義，而內容類型標頭則使用輸入 Type 的值來定義。

輸入定義查詢為字串。查詢是問號後面的值，通常用於 GET 請求中。

http://server/uri?query

查詢的結構如下：

var1=wert1&var2=wert2&va...

為了確保值能正確傳輸，建議使用功能區塊 URL_ENCODE 或 QUERY_ENCODE 來編碼各個值，因為資料可能無法完整傳輸。

注意： 請注意 URL 的最大長度，如果需要傳輸大量資料。必要時請使用 POST 方法並將查詢作為內容發送。

輸入 Content 與輸入 Query 類似。然而，資料會在標頭傳輸後進行，且支援更大的資料量。根據應用程式，內容類型可能不具備查詢方法。

注意： 僅支援 UTF-8 符合的資料。在傳輸二進位資料時，建議使用功能區塊 BASE64_ENCODE 來編碼。

輸入定義請求的超時時間為時間格式 T#30s 以秒計。建議使用較高的超時時間。較小的值可能導致請求無法完全執行。由於保持活動連線機制，可能需要一段時間才能恢復正常處理請求。

若輸入為真，則輸出 Request 的值會設定為 NULL。

若輸入為真，則強制產生輸出 Request。此輸入優先於輸入 DIS。

輸出會以 JSON 格式回傳字串。如果被停用，則回傳值為 NULL。通常直接與介面的輸出變數連接。

輸出會以位元組回傳輸入 Content 的長度。

回傳最後產生的查詢識別碼。這對於使用功能區塊 HTTP_RESPONSE 驗證回應很有幫助。