# 編輯載入指令碼 您在資料載入編輯器或 指令碼 的文字編輯器中撰寫指令碼。您可以在這裡對選取資料時產生的 LOAD 或 SELECT 陳述式進行手動變更，並輸入新的指令碼。 必須使用 Qlik 指令碼語法撰寫的指令碼，會以顏色標示，以便與不同元素輕鬆區別。每個指令碼行都有編號。 編輯器中提供許多函數，可協助您開發載入指令碼，這些函數在本節中予以說明。 ## 代碼協助 ### 存取命令與函數的語法說明 有數種方法可存取 Qlik 語法關鍵字的語法說明。 #### 將游標懸停在關鍵字上 您可以將游標移至指令碼中的指令碼函式與關鍵字上方，以深入了解格式化語法，並存取說明資源。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 #### 存取說明入口網站 您可以使用下列方式，來存取說明入口網站中的詳細說明： * 按一下工具列中的 the 說明 icon，以進入語法說明模式。在語法說明模式下，您可以按一下語法關鍵字 (以藍色和底線標記)，以存取語法說明。 * 請將游標置於關鍵字內部或結尾，然後按下 Ctrl+H 鍵。 * 如果您已啟用 啟用新的程式碼編輯器體驗，請將游標暫留在關鍵字上方，並按一下說明連結 (若有的話)。請參閱 [將游標懸停在關鍵字上](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm#Hovering)。 資訊備註您不能在語法說明模式下編輯指令碼。 #### 使用自動完成的函數 如果您開始輸入 Qlik 指令碼關鍵字，您會取得自動完成的相符關鍵字清單，以從中進行選取。該清單的範圍會隨著您的繼續輸入而不斷縮小，且您可從包含建議語法和參數的範本中選取。工具提示會顯示函數的語法，包括參數和其他陳述式，以及陳述式或函數的說明入口網站描述的連結。 提示備註 您也可以使用鍵盤快速鍵 Ctrl+Space 來顯示關鍵字清單，使用 Ctrl+Shift+Space 來顯示工具提示。 ## 程式碼導覽 ### 存取命令與函數的語法說明 有數種方法可存取 Qlik 語法關鍵字的語法說明。 #### 將游標懸停在關鍵字上 您可以將游標移至指令碼中的指令碼函式與關鍵字上方，以深入了解格式化語法，並存取說明資源。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 #### 存取說明入口網站 您可以使用下列方式，來存取說明入口網站中的詳細說明： * 按一下工具列中的 the 說明 icon，以進入語法說明模式。在語法說明模式下，您可以按一下語法關鍵字 (以藍色和底線標記)，以存取語法說明。 * 請將游標置於關鍵字內部或結尾，然後按下 Ctrl+H 鍵。 * 如果您已啟用 啟用新的程式碼編輯器體驗，請將游標暫留在關鍵字上方，並按一下說明連結 (若有的話)。請參閱 [將游標懸停在關鍵字上](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm#Hovering)。 資訊備註您不能在語法說明模式下編輯指令碼。 ### 定義與參考連結 您可以使用右鍵功能表或鍵盤快速鍵，在相關的指令碼元素 (例如特定資料表或變數) 之間導覽。 下列選項可用： * 前往定義 (Ctrl + F12)：前往定義指令碼建構的位置。 * 移至參考 (Ctrl + F12)：移至參考指令碼建構的位置。若有多個參考，您可以選擇要移至哪一個參考。 * 查看選項 (Alt + F12)：在您目前檢查的程式碼下方，以快顯視窗檢視定義與參考。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 ### 程式碼摺疊 您可以展開與摺疊指令碼程式碼區塊，以提高編輯時的彈性與可讀性。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 若要摺疊程式碼區塊，請將滑鼠暫留在支援摺疊的區塊旁的邊界，然後按一下 the 向下箭頭 icon。您可以按一下已收合區塊上的 the 向下箭頭 icon 來展開程式碼。 命令選擇區也提供程式碼摺疊的進階選項。請參閱 [命令選擇區](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm#CommandPalette)。 ### 迷你地圖 迷你地圖提供目前指令碼區段的視覺化呈現。它位於編輯器旁，可讓您一覽整個區段。迷你地圖具備互動功能—您可以使用它捲動瀏覽區段以尋找特定程式碼。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 ## 程式碼編輯 ### 插入準備好的測試指令碼 您可以插入準備好的測試指令碼，該指令碼將載入一組內嵌資料欄位。您可以使用此函數，快速建立一個資料集以進行測試。 請執行下列動作： * 按下 Ctrl + 00。 測試指令碼程式碼即會插入至指令碼。 ### 縮排程式碼 您可以縮排程式碼以提高可讀性。 請執行下列動作： 1. 請選取一行或數行，以變更縮排。 2. 按一下 the 縮排 icon 以縮排文字 (增加縮排)，或者按一下 the 取消縮排 icon 以凸排文字 (減少縮排)。 提示備註 您也可以使用鍵盤快速鍵： Tab (縮排) Shift+Tab (凸排) ### 搜尋並取代文字 您可以在指令碼區段中搜尋並取代文字。 #### 搜尋文字 請執行下列動作： 1. 按一下工具列中的 the 搜尋 icon。 系統會顯示搜尋下拉式對話方塊。 2. 在搜尋方塊中，輸入您要尋找的文字。 搜尋結果會在指令碼的目前區段中醒目提示。此外，在區段標籤旁邊指明找到的文字執行個體數目。 3. 您可以透過按一下 the 上一步 icon 與 the 下一頁 icon，以瀏覽結果。 4. 在工具列中按一下 the 搜尋 icon，以關閉搜尋對話方塊。 提示備註此外，您可以選取搜尋區段中的所有內容，以在所有指令碼區段中進行搜尋。在每一個區段標籤旁邊指明找到的文字執行個體數目。您可以選擇大小寫須相符以執行區分大小寫的搜尋。 #### 取代文字 請執行下列動作： 1. 按一下工具列中的 the 搜尋 icon。 系統會顯示搜尋下拉式對話方塊。 2. 在搜尋方塊中輸入您要尋找的文字。 3. 在取代方塊中輸入取代文字，然後按一下取代。 4. 按一下 the 下一頁 icon 以尋找搜尋文字的下一個執行個體，並執行下列其中一個動作： * 按一下取代以取代文字。 * 按一下 the 下一頁 icon 以尋找下一個。 5. 在工具列中按一下 the 搜尋 icon，以關閉搜尋對話方塊。 提示備註您也可以按一下取代區段中的所有內容，以取代目前指令碼區段中搜尋文字的所有執行個體。取代函數區分大小寫，並且取代文字將使用取代欄位中提供的大小寫。會顯示一則訊息，提供已取代的執行個體數的相關資訊。 #### 替代方法 您也可以使用其他方法來搜尋與取代文字。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 下列其他方式可供使用： * 變更所有相符項：可從右鍵功能表以及透過鍵盤快速鍵 Ctrl + F2 使用。這會尋找並取代目前指令碼區段中的所有相符文字。 * 命令選擇區：您可以使用內嵌的命令選擇區執行尋找與取代動作。請參閱 [命令選擇區](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm#CommandPalette)。 ### 指令碼中的註解 您可以在指令碼程式碼中插入註解，也可以使用註解標記來停用部分指令碼程式碼。資料行中 // (兩個正斜線) 右側之後的所有文字都將視為註解，而且不會在執行指令碼時排除。 工具列包含用來加上註解或取消註解程式碼的快速鍵。該函數的作用類似於開關。即，如果所選取的程式碼有註解，將為它加上註解，反之亦然。 #### 加上註解 請執行下列動作： 1. 選取一個或多個未加上註解的程式碼行，或者將游標置於某行的開頭。 2. 按一下 the 註解 / 取消註解 icon 或按下 Ctrl + K。 資訊備註如果您已開啟 啟用新程式碼編輯器體驗，您也可以使用 Ctrl + /。 現在，已為所選取的程式碼加上註解。 #### 取消註解 請執行下列動作： 1. 選取一個或多個已加上註解的程式碼行，或者將游標置於某個已加上註解行的開頭。 2. 按一下 the 註解 / 取消註解 icon 或按下 Ctrl + K。 資訊備註如果您已開啟 啟用新程式碼編輯器體驗，您也可以使用 Ctrl + /。 選取的代碼現在將會透過剩餘的指令碼執行。 提示備註 有更多方法可在指令碼程式碼中插入註解： * 使用 Rem 陳述式。 * 將一段程式碼含括在 /\* 與 \*/ 中。 ``` Rem This is a comment ; /* This is a comment that spans two lines */ // This is a comment as well ``` 如需關於 Rem 的詳細資訊，請參閱 [Rem](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Rem.htm)。 ### 選取所有程式碼 您可以選取目前指令碼區段中的所有程式碼。 請執行下列動作： * 按下 Ctrl + A。 即會選取目前區段中的所有指令碼。 ### 多游標選取 透過多游標選取，您可以一次選取多個不同指令碼行中的程式碼。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 執行下列其中一個動作： * 按下 Ctrl + Alt + 向上/向下鍵即可一次垂直選取多個平行行。 * 按下 Alt + Shift，然後朝任一方向拖曳游標，即可同時選取相鄰的程式碼。 ### 命令選擇區 命令選擇區已內嵌至指令碼編輯器中，讓您能更輕鬆地對指令碼程式碼執行進階操作。命令選擇區也支援數個可用來增強編輯器外觀與風格的選項。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 命令選擇區的使用範例包括： * 尋找及取代 * 進階程式碼摺疊 * 程式碼縮排 * 進階文字處理 * 自訂編輯器介面，例如字型大小、自動換行等 如需特定工作流程的範例，請參閱 [範例工作流程：命令選擇區](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm#Examples)。 執行下列其中一個動作： * 在編輯器中按一下滑鼠右鍵，並選取 命令選擇區...。 * 使用鍵盤快速鍵 Ctrl + Shift + P。 針對某些動作，您可能需要選取要執行操作的文字。對於其他項目，則不需要。 開啟命令選擇區後，您可以搜尋可用的命令，並檢視這些命令的鍵盤快速鍵。 #### 範例工作流程：命令選擇區 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm) #### 使用命令選擇區尋找與取代文字 請執行下列動作： 1. 開啟指令碼區段。 2. 選取您要尋找與取代的文字。 3. 在編輯器中的任一處按一下滑鼠右鍵，然後選取 命令選擇區...。 4. 選取 取代。 5. 輸入要尋找的文字。 6. 輸入文字以取代找到的文字。 7. 選取以取代所有執行個體或一次取代一個執行個體。 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/edit-data-load-script.htm) #### 收合（折疊）程式碼 請執行下列動作： 1. 開啟包含支援摺疊的表格、迴圈、副常式或其他內容的指令碼區段。 2. 在編輯器中的任一處按一下滑鼠右鍵，然後選取 命令選擇區...。 命令面板隨即開啟。 3. 選取 全部摺疊。 4. 若要展開所有摺疊的程式碼，請再次開啟命令選擇區，並選取 全部展開。 #### 開啟自動換行 請執行下列動作： 1. 開啟指令碼區段。 2. 在編輯器中的任一處按一下滑鼠右鍵，然後選取 命令選擇區...。 3. 選取 檢視: 切換自動換行，或在鍵盤上按下 Alt+Z。 已為指令碼區段啟用自動換行。 ## 程式碼重構 在開啟 啟用新的程式碼編輯器體驗 的情況下，您可以重構已辨識的 Qlik 指令碼建構。例如，您可以重新命名指令碼中資料表的所有執行個體。 資訊備註 您需要開啟 啟用新的程式碼編輯器體驗。請參閱 [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm)。 請執行下列動作： 1. 將游標置於您要重新命名的指令碼建構上，或將該建構完整反白。 2. 按一下滑鼠右鍵並選取 重新命名符號，或使用鍵盤快速鍵 F2。 此建構會在整個指令碼中重新命名。 ## 限制 啟用 啟用新程式碼編輯器體驗 時，部分介面元素 (例如右鍵選項、命令選擇區和暫留說明) 尚未翻譯成瑞典文和荷蘭文。 相關學習內容： * [資料載入編輯器簡介](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS) [使用新一代指令碼編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/next-gen-editor.htm) [資料載入編輯器 和 指令碼 中的鍵盤快速鍵](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/DLE-keyboard-shortcut.htm) [使用 資料載入編輯器](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/use-data-load-editor.htm) [在目錄中導覽指令碼](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/navigating-scripts.htm) ## 瞭解更多資訊 * [資料載入編輯器簡介](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)