# 系統函數

系統函數提供用來存取系統、裝置和 QlikView 文件屬性的函數。

使用各個函數的下拉式清單，查看各函數的簡短描述及語法。對於某些函數，按一下語法描述中的函數名稱，可取得有關該特定函數的進一步詳細資料。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### Author

此函數傳回包含目前文件的作者屬性的字串。可用於載入指令碼和圖表運算式。

Author( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ClientPlatform

此函數傳回用戶端瀏覽器的使用者代理程式字串。 可用於載入指令碼和圖表運算式。

範例：

`  Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36 `

ClientPlatform( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ComputerName

此函數傳回包含電腦名稱 (由作業系統所傳回) 的字串。 可用於載入指令碼和圖表運算式。

ComputerName( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentName

此函數會傳回一個字串，其中包含目前 QlikView 文件的名稱，不含路徑，但包含副檔名。 可用於載入指令碼和圖表運算式。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentName( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentPath

此函數會傳回一個字串，其中包含目前 QlikView 文件的完整路徑。 可用於載入指令碼和圖表運算式。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentPath( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### DocumentTitle

此函數會傳回一個字串，其中包含目前 QlikView 文件的標題。 可用於載入指令碼和圖表運算式。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)DocumentTitle( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetCollationLocale

此指令碼函數傳回所使用定序地區設定的文化名稱。如果尚未設定變數 CollationLocale，則會傳回實際使用者機器地區設定。

GetCollationLocale( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetActiveSheetID

傳回包含使用中工作表識別碼的字串。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)GetActiveSheetID( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetExtendedProperty

此函數會傳回指定物件識別碼之工作表物件中具名延伸屬性的值。若未指定 objectid，則會使用包含此運算式的工作表物件。延伸屬性是定義於延伸物件的定義檔案中。

[**GetExtendedProperty**](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/GetExtendedProperty.htm)(name[, objectid])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetObjectField

GetObjectField() 會傳回維度名稱。Index 為選用整數，代表應傳回的維度。

[**GetObjectField**](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/GetObjectField.htm)([index])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### GetRegistryString

此函數會傳回 Windows 登錄中索引鍵的值。 可用於載入指令碼和圖表運算式。

GetRegistryString(path, key)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### Input

此函數僅可用於指令碼中，會在指令碼執行期間開啟輸入方塊，提示使用者輸入值。參數 cue 和 caption 分別作為訊息和標題文字。此函數會傳回所輸入的值。

若取消、關閉或無法顯示對話方塊，輸入方塊函數會傳回 NULL。

範例：

` Load 
 Input('Enter value', 'Input box') as v, Recno () as r autogenerate 3;  `

Input(str cue [, str caption])

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### IsPartialReload

如果目前的重新載入為部分，會傳回 -1 (True)，否則會傳回 0 (False)。這僅適用於指令碼。

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)IsPartialReload( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### MsgBox

此函數僅可用於指令碼中，會在指令碼執行期間開啟訊息方塊。參數 msg 和 caption 分別作為訊息和標題文字。參數 mb\_buttons 會定義要顯示在訊息方塊中的按鈕，其定義如下：

0 或 'OK' 代表單一 OK 按鈕，  
1 或 'OKCANCEL' 代表兩個按鈕，OK 和 Cancel，  
2 或 'ABORTRETRYIGNORE' 代表三個按鈕，Abort、Retry 和 Ignore，  
3 或 'YESNOCANCEL' 代表三個按鈕，Yes、No 和 Cancel，  
4 或 'YESNO' 代表兩個按鈕，Yes 和 No，  
5 或 'RETRYCANCEL' 代表兩個按鈕，Retry 和 Cancel，

參數 mb\_icons 會定義要顯示在訊息方塊中的圖示，其定義如下：

0 或空字串代表沒有圖示，  
16 或 'ICONHAND' 代表含有 X 的圖示，用於嚴重錯誤，  
32 或 'ICONQUESTION' 代表含有問號的圖示，  
48 或 'ICONEXCLAMATION' 代表含有驚嘆號的圖示，用於次要錯誤、注意事項和警告  
64 或 'ICONASTERISK' 代表含有 i 的圖示，用於資訊訊息。

參數 mb\_defbutton 會定義訊息方塊顯示時具有焦點的按鈕，其定義如下：

若第一個按鈕應有焦點，則為 0 或 'DEFBUTTON1'，  
若第二個按鈕應有焦點，則為 256 或 'DEFBUTTON2'，  
若第三個按鈕應有焦點，則為 512 或 'DEFBUTTON3'，  
若第四個按鈕應有焦點，則為 768 或 'DEFBUTTON4'。

此函數會傳回一個整數，用以顯示使用者按下哪個按鈕，其定義如下：

1 代表 OK，  
2 代表 Cancel，  
3 代表 Abort，  
4 代表 Retry，  
5 代表 Ignore，  
6 代表 Yes，  
7 代表 No

參數 3、4 和 5 會從內部加入，所以如果使用了非以上所述的數值，可能會產生非預期的圖示和按鈕的組合。

若無法顯示對話方塊，訊息方塊函數會傳回 NULL。

範例：

` Load 
 MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r 
 autogenerate 1;  `

MsgBox(str msg [, str caption [, mb\_buttons [, mb\_icons[, mb\_defbutton]]]] )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### OSUser

此函數傳回包含目前使用者名稱 (由作業系統所傳回) 的字串。 可用於載入指令碼和圖表運算式。

OSUser( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### QlikViewVersion

此函數會傳回完整的 QlikView 版本和組建編號作為字串。

[QlikViewVersion - 指令碼與圖表函數](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/QlikViewVersion.htm)()

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### QVuser

傳回包含目前 QlikView 使用者名稱 (如同在區段存取中所輸入) 的字串。

QVuser( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### ReloadTime

此函數傳回完成最後一筆資料載入時的時間戳記。 可用於載入指令碼和圖表運算式。

ReloadTime( )

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/system-functions.htm)

#### StateName

此圖表函數會傳回物件所使用的狀態名稱。QlikView 開發人員可使用此函數，在物件的狀態變更時產生動態的文字和色彩。必須注意的是，此函數僅可用於物件，無法用於圖表運算式中，藉以確定運算式參照的狀態。

[**StateName**](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/SystemFunctions/StateName.htm)()

## 瞭解更多資訊

* [GetFolderPath - 指令碼函數](https://help.qlik.com/zh-TW/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/FileFunctions/GetFolderPath.htm)