參考手冊

持續巨集函數

持續巨集函數可經由協助您定義單一異動內哪些巨集區塊是持續的， 來支援 Net.Data 中的異動處理。 使用這些函數，可定義異動的開頭與結尾，哪些 HTML 區塊在整個異動中是持續的、 異動內的變數範圍，以及是否要確定或回捲異動內的變更。

• DTW_ACCEPT

• DTW_COMMIT

• DTW_ROLLBACK

• DTW_RTVHANDLE

• DTW_STATIC

• DTW_TERMINATE

DTW_ACCEPT

目的

定義用來呼叫持續巨集的異動 handle。

格式

@DTW_ACCEPT(handle, timeout)

@DTW_ACCEPT(handle)

參數

表 209. DTW_ACCEPT 參數

回覆碼

表 210. DTW_ACCEPT 回覆碼

用法注意事項

1. Net.Data 需要異動 handle 包括在 URL 中， 如此 URL 方可呼叫巨集，為來自 Web 瀏覽器的回應。 當一個要求來到 Web 伺服器時， 伺服器會使用異動 handle，將要求遞送到正在處理異動的 CGI 處理。

   須在巨集中的每一 HTML 區塊的開頭呼叫異動 handle， 直到最後一個含有 DTW_TERMINATE() 的呼叫的邏輯區塊為止。 在任何文字輸出到瀏覽器之前，若找不到 DTW_ACCEPT() 或 DTW_TERMINATE() 的呼叫， 將發生 Net.Data 錯誤。

2. 您可以指定此頁的逾時值，來置換 @DTW_STATIC() 函數上所指定的逾時值。 Web 伺服器會等待指定的時間量 (秒)，讓使用者回應此要求。

3. 當巨集不在持續狀態時，若呼叫這個函數，將發生 Net.Data 錯誤。

4. 含有異動 handle 的 URL 可撰寫為套表按鈕上的動作，或撰寫為瀏覽器頁面上的超本文鏈結。

範例

範例 1：

%DEFINE handle = ""
@DTW_RTVHANLDE(handle)
 
%HTML(REPORT){
@DTW_ACCEPT(handle)
 ...
%}

DTW_COMMIT

目的

使自從上一個確定界限後，在確定控制下對資源所做的任何擱置變更成為永久變更， 並建立新的確定界限。

格式

@DTW_COMMIT()

參數

無。

回覆碼

表 211. DTW_COMMIT 回覆碼

範例

範例 1：指定確定

@DTW_COMMIT()
%HTML(report){
%}
 

DTW_ROLLBACK

目的

重新建立上一個確定界限作為現行確定界限。 自從退出上一個確定界限後，在 Net.Data 執行的處理的確定控制下， 對資源所做的所有變更。

格式

@DTW_ROLLBACK()

參數

無。

回覆碼

表 212. DTW_ROLLBACK 回覆碼

範例

範例 1：指定回捲

@DTW_ROLLBACK() 
%HTML(report){
%}

DTW_RTVHANDLE

目的

產生並傳回一個異動 handle，它對於跨越個別呼叫的這個巨集而言是唯一的， 且會依據緒資訊、時間戳記及現行使用者的組合來計算。

格式

@DTW_RTVHANDLE(handle)

參數

表 213. DTW_RTVHANDLE 參數

回覆碼

表 214. DTW_RTVHANDLE 回覆碼

用法注意事項

異動 handle 可用來確定指定為持續異動一部份的 URL 對 HTTP 伺服器是唯一的， 且可穩穩地識別為有效的要求。

範例

範例 1：定義用來取回異動 handle 的 handle變數

%DEFINE handle = ""
@DTW_RTVHANLDE(handle)

DTW_STATIC

目的

指出整個巨集是持續的。

格式

@DTW_STATIC(timeout)

@DTW_STATIC()

參數

表 215. DTW_STATIC 參數

回覆碼

表 216. DTW_STATIC 回覆碼

用法注意事項

1. DTW_STATIC 應該是巨集中第一個陳述式。 在這個函數呼叫後於巨集中定義的所有變數，在多個巨集呼叫之間均是持續的， 除非另有指定，以及直到呼叫 DTW_TERMINATE() 或終止處理為止。

2. 可在函數呼叫上設定逾時值 (秒)，來指出 Net.Data 執行的處理等待瀏覽器回應的時間量。 如果逾時值到期，則處理將終止，且會回捲自從上一個確定界限後， 於確定控制下對資源所做的全部變更。

3. 如果在後續 @DTW_ACCEPT() 呼叫上指定了逾時值，Net.Data 將以後續呼叫中的值置換這個值。如果未在這個呼叫或後續 @DTW_ACCEPT() 呼叫上指定逾時值， 將使用 Web 伺服器的預設逾時值。

範例

範例 1：指定逾時值 60 秒的 DTW_STATIC() 的呼叫

@DTW_STATIC("60")

DTW_TERMINATE

目的

終止持續異動。自從上一個確定界限後，於確定控制下對資源所做的變更均成為永久變更。

格式

@DTW_TERMINATE()

參數

無

回覆碼

表 217. DTW_TERMINATE 回覆碼

用法注意事項

1. 在任何文字輸出到瀏覽器之前，於持續異動的上一個邏輯 HTML 區塊的開頭呼叫 DTW_TERMINATE 函數。 如果有任何文字出現在區塊內的函數之前，將發生 Net.Data 錯誤。 請注意，可能有多個上一個邏輯 HTML 區塊，得視應用程式的撰寫方式而定。

2. 當巨集不在持續狀態時，若呼叫這個函數，將發生 Net.Data 錯誤。

範例

範例：終止持續異動

%HTML(QUIT){
@DTW_TERMINATE()
 ...
%}