用導(dǎo)航動(dòng)作完全指南：Go to app 的配置、RunJS 調(diào)用與源碼解析)
ToolJet 跨應(yīng)用導(dǎo)航動(dòng)作完全指南Go to app 的配置、RunJS 調(diào)用與源碼解析【免費(fèi)下載鏈接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 項(xiàng)目地址: https://gitcode.com/GitHub_Trending/to/ToolJet導(dǎo)讀Go to app跳轉(zhuǎn)到應(yīng)用是 ToolJet 內(nèi)置的一種導(dǎo)航類(lèi)動(dòng)作用于在事件觸發(fā)時(shí)打開(kāi)當(dāng)前工作區(qū)中任意已發(fā)布Released的 ToolJet 應(yīng)用是實(shí)現(xiàn)多應(yīng)用間相互跳轉(zhuǎn)、入口聚合與流程串聯(lián)的核心手段。本文將從動(dòng)作的觸發(fā)場(chǎng)景、配置面板各字段、通過(guò) RunJS 以代碼方式調(diào)用到其在 frontend 中的事件執(zhí)行源碼給出完整且可驗(yàn)證的實(shí)戰(zhàn)說(shuō)明。讀完本文你將掌握如何在事件處理器中正確配置跳轉(zhuǎn)目標(biāo)與查詢參數(shù)、如何獲取并校驗(yàn)應(yīng)用 slug以及跨應(yīng)用跳轉(zhuǎn)在編輯器與查看器兩種模式下的實(shí)際行為差異。何時(shí)使用 Go to app 動(dòng)作ToolJet 應(yīng)用由組件、查詢與事件處理器Event Handler組成。每個(gè)組件都可以綁定交互事件而每個(gè)事件又可以掛載一個(gè)或多個(gè)動(dòng)作。當(dāng)應(yīng)用體系拆分為多個(gè)應(yīng)用時(shí)例如一個(gè)儀表盤(pán)應(yīng)用 若干業(yè)務(wù)處理應(yīng)用Go to app 就是連接它們的橋梁從列表應(yīng)用跳轉(zhuǎn)到某個(gè)記錄的詳情應(yīng)用并通過(guò)查詢參數(shù)傳遞記錄 ID在一個(gè)總?cè)肟趹?yīng)用中放置多個(gè)導(dǎo)航按鈕分別進(jìn)入不同的已發(fā)布應(yīng)用在事件驅(qū)動(dòng)的自動(dòng)化流程中如 RunJS 查詢成功后按條件跳轉(zhuǎn)到指定應(yīng)用。正如動(dòng)作定義所示它歸屬于navigation導(dǎo)航分組與 Switch page切換頁(yè)面、Open webpage打開(kāi)網(wǎng)頁(yè) 同屬一類(lèi)用于改變用戶當(dāng)前所處的位置或上下文。使用前提目標(biāo)應(yīng)用必須已發(fā)布文檔明確說(shuō)明了一個(gè)約束Go to app 只能打開(kāi)已經(jīng)發(fā)布Released的應(yīng)用未發(fā)布的草稿應(yīng)用無(wú)法作為跳轉(zhuǎn)目標(biāo)。因此在實(shí)際使用前需要在應(yīng)用構(gòu)建器中編輯完成應(yīng)用并通過(guò)右上角的Release發(fā)布按鈕將其發(fā)布在另一個(gè)應(yīng)用中添加 Go to app 動(dòng)作選擇或填寫(xiě)該已發(fā)布應(yīng)用的標(biāo)識(shí)。發(fā)布狀態(tài)決定了該應(yīng)用是否擁有可訪問(wèn)的線上 slug——這是動(dòng)作執(zhí)行時(shí)構(gòu)造跳轉(zhuǎn) URL 的依據(jù)。如何獲取應(yīng)用的 slugGo to app 需要一個(gè)slug來(lái)唯一定位目標(biāo)應(yīng)用。根據(jù)官方動(dòng)作文檔slug 可以通過(guò)以下兩種途徑獲得從已發(fā)布應(yīng)用的瀏覽器 URL 中提取格式為https://your-tooljet-host/applications/slug即application/之后的路徑段從共享Share彈窗中查看在應(yīng)用構(gòu)建器右上角點(diǎn)擊Share按鈕彈出的共享彈窗中會(huì)給出該應(yīng)用的發(fā)布鏈接slug 即鏈接中的標(biāo)識(shí)部分。注意在較新的版本中圖形化配置面板保存的是應(yīng)用的穩(wěn)定關(guān)聯(lián) IDcorrelationId并據(jù)此反查 slug而通過(guò) RunJS 直接調(diào)用時(shí)則仍以 slug 為直接參數(shù)詳見(jiàn)下文。在事件處理器中配置 Go to app添加動(dòng)作并選擇目標(biāo)應(yīng)用在任意組件的事件處理器中新增一個(gè)動(dòng)作從動(dòng)作列表選擇Go to app后會(huì)渲染對(duì)應(yīng)的配置面板。該面板的實(shí)現(xiàn)位于 GotoApp.jsx包含兩個(gè)配置區(qū)域App目標(biāo)應(yīng)用選擇通過(guò)下拉框OptionCombobox列出當(dāng)前工作區(qū)中可選的應(yīng)用選中后寫(xiě)入事件配置。源碼注釋表明新版面板持久化的是correlationId而非舊的slug字段同時(shí)會(huì)把所選應(yīng)用的slug與currentVersionId鏡像到 store 的linkedApps映射中目的是無(wú)需刷新即可在點(diǎn)擊時(shí)構(gòu)造 URL并讓校驗(yàn)邏輯能夠區(qū)分目標(biāo)缺失與沒(méi)有已發(fā)布版本兩種錯(cuò)誤。若所選應(yīng)用在加載的鏈接映射中無(wú)法通過(guò)校驗(yàn)面板會(huì)顯示紅色錯(cuò)誤標(biāo)簽與Undefined app提示。Query params查詢參數(shù)以鍵 / 值成對(duì)的行來(lái)維護(hù)跳轉(zhuǎn)時(shí)攜帶的查詢參數(shù)每行是一個(gè) CodeHinter 代碼輸入框event-query-param-key與event-query-param-value因此鍵與值都可以使用動(dòng)態(tài)引用如{{components.table1.selectedRow.id}}。通過(guò)Add param按鈕可追加新的鍵值行行尾的刪除按鈕可移除不再需要的參數(shù)。對(duì)應(yīng)動(dòng)作在配置層事件模型中的定義位于 ActionTypes.js{ name: Go to app, id: go-to-app, options: [ { name: app, type: text, default: }, { name: queryParams, type: code, default: [] }, ], group: navigation, }即動(dòng)作需要app目標(biāo)應(yīng)用與queryParams查詢參數(shù)JSON 數(shù)組形式默認(rèn)空數(shù)組[]兩類(lèi)配置。下圖展示了該動(dòng)作在事件處理器中的配置界面Debounce 防抖字段在事件處理器中每個(gè)動(dòng)作都可以附帶一個(gè)Debounce防抖字段默認(rèn)情況下該字段為空表示動(dòng)作被觸發(fā)后立即執(zhí)行可以輸入一個(gè)**數(shù)值毫秒**來(lái)指定動(dòng)作延遲執(zhí)行的時(shí)間例如300表示事件觸發(fā)后 300 毫秒才執(zhí)行該動(dòng)作。該字段在 EventManager.jsx 中有相應(yīng)的處理邏輯當(dāng) debounce 參數(shù)被置為空字符串時(shí)會(huì)從事件配置中刪除該鍵從而恢復(fù)立即執(zhí)行的語(yǔ)義。防抖非常適合與查詢、按鈕快速連點(diǎn)等高頻事件配合避免在極短時(shí)間內(nèi)重復(fù)觸發(fā)跳轉(zhuǎn)。通過(guò) RunJS 以代碼方式觸發(fā)跳轉(zhuǎn)除了在事件處理器中圖形化配置Go to app 同樣可以從JavaScript 代碼中觸發(fā)在 RunJS 查詢、組件代碼等場(chǎng)景。ToolJet 為各動(dòng)作提供了一套全局actionsAPI具體語(yǔ)法可參考 Run actions from RunJS query其核心調(diào)用形式為actions.goToApp(slug, queryparams)參數(shù)說(shuō)明slug目標(biāo)已發(fā)布應(yīng)用的 slug可從發(fā)布后 URL 的application/之后獲取或從 Share 彈窗中查看queryparams二維數(shù)組形式例如[ [key1,value1], [key2,value2] ]。一個(gè)實(shí)際示例——從當(dāng)前應(yīng)用跳轉(zhuǎn)到 slug 為customer-detail的應(yīng)用并攜帶客戶 IDconst row components.table1.selectedRow; actions.goToApp(customer-detail, [[id, row.id], [source, dashboard]]);在執(zhí)行層RunJS 發(fā)起的調(diào)用會(huì)被識(shí)別為event.source app-action此時(shí)直接使用傳入的slug源碼注釋明確說(shuō)明這是為了向后兼容保留的直接傳 slug 方式。因此代碼方式跳轉(zhuǎn)時(shí) slug 是必填參數(shù)若為空會(huì)拋出No application slug provided錯(cuò)誤。動(dòng)作執(zhí)行原理與源碼級(jí)解析Go to app 的核心執(zhí)行邏輯位于事件運(yùn)行時(shí) eventsSlice.js一次跳轉(zhuǎn)的執(zhí)行過(guò)程可以拆解為以下幾步解析目標(biāo) slug來(lái)自 RunJSsource app-action時(shí)直接校驗(yàn)event.slug非空并通過(guò)getResolvedValue解析其中可能存在的動(dòng)態(tài)引用來(lái)自構(gòu)建器事件配置時(shí)要求event.correlationId非空然后從 store 的linkedAppsMapcorrelationId, { slug, currentVersionId }定義于 appSlice.js中反查該應(yīng)用對(duì)應(yīng)的 slug。若在編輯器模式下校驗(yàn)失敗應(yīng)用缺失或未發(fā)布會(huì)拋出帶具體原因的異常并進(jìn)入調(diào)試器錯(cuò)誤日志logError(go_to_app, ...)而在查看器viewer模式下則跳過(guò)校驗(yàn)直接嘗試重定向交由既有的 404/not found 兜底處理。組裝查詢參數(shù)將配置中的鍵值對(duì)數(shù)組reduce成一個(gè)對(duì)象鍵與值都經(jīng)過(guò)getResolvedValue解析因此可引用組件狀態(tài)、變量等動(dòng)態(tài)數(shù)據(jù)隨后通過(guò)serializeNestedObjectToQueryParams序列化支持嵌套對(duì)象的展開(kāi)最終拼接出查詢串。構(gòu)造跳轉(zhuǎn) URL 并執(zhí)行基礎(chǔ)路徑為/applications/slug若存在查詢參數(shù)則追加?...若 ToolJet 部署在子路徑subpath下還會(huì)自動(dòng)加上子路徑前綴。之后按運(yùn)行模式分流查看器模式view通過(guò)window.open(url, _self)在當(dāng)前標(biāo)簽頁(yè)完成跳轉(zhuǎn)編輯器模式editor會(huì)先彈出確認(rèn)框The app will be opened in a new tab as the action is triggered from the editor.確認(rèn)后基于當(dāng)前 Host URL 拼出完整地址并在新標(biāo)簽頁(yè)打開(kāi)——因?yàn)榫庉嬈鞅旧沓休d著正在編輯的應(yīng)用不能直接覆蓋當(dāng)前頁(yè)面。正是這條 URL 構(gòu)建邏輯決定了動(dòng)作只能打開(kāi)已發(fā)布應(yīng)用應(yīng)用只有發(fā)布后才擁有對(duì)外可訪問(wèn)的 slug 路徑供拼接與訪問(wèn)。此外事件執(zhí)行前的動(dòng)作校驗(yàn)isLinkedAppValid及相關(guān)工具邏輯位于 AppBuilder/_stores/utils.js 附近負(fù)責(zé)在頁(yè)面/事件觸發(fā)前驗(yàn)證 go-to-app 鏈接目標(biāo)是否有效從而把配置期即可發(fā)現(xiàn)錯(cuò)誤的能力前置到構(gòu)建階段。常見(jiàn)問(wèn)題與注意事項(xiàng)關(guān)注點(diǎn)說(shuō)明目標(biāo)應(yīng)用未發(fā)布跳轉(zhuǎn)會(huì)失敗。請(qǐng)先在目標(biāo)應(yīng)用中完成 Release再檢查其 slug 是否存在。運(yùn)行在編輯器模式下跳轉(zhuǎn)前會(huì)有確認(rèn)彈窗并在新標(biāo)簽頁(yè)打開(kāi)這是為了不打斷當(dāng)前應(yīng)用的編輯會(huì)話。運(yùn)行在已發(fā)布應(yīng)用的查看模式跳轉(zhuǎn)發(fā)生在當(dāng)前標(biāo)簽頁(yè)_self體驗(yàn)上如同頁(yè)面間的自然流轉(zhuǎn)。查詢參數(shù)動(dòng)態(tài)取值鍵與值均支持模板引用{{ ... }}可將選中行、變量等運(yùn)行時(shí)數(shù)據(jù)帶給目標(biāo)應(yīng)用。代碼方式必填 slug使用actions.goToApp(...)時(shí)必須傳 slug否則拋No application slug provided。防抖配合需要延遲執(zhí)行時(shí)填寫(xiě)毫秒值為空即立即執(zhí)行。從跨應(yīng)用跳轉(zhuǎn)這個(gè)單一動(dòng)作可以看到 ToolJet 事件機(jī)制的設(shè)計(jì)取向圖形化配置存儲(chǔ)關(guān)聯(lián) ID、可校驗(yàn)、防抖可控與代碼化調(diào)用actions全局 API雙軌并存統(tǒng)一收斂到同一套事件運(yùn)行時(shí)執(zhí)行既適合無(wú)代碼使用者也為開(kāi)發(fā)者保留了完整的可編程空間。延伸閱讀與源碼索引動(dòng)作官方文檔含多版本歸檔docs/docs/actions/go-to-app.md另見(jiàn) version-3.0.0-LTS 與 version-2.50.0-LTS 兩個(gè)版本的文檔在 RunJS 中觸發(fā)全部動(dòng)作的 API 指南docs/docs/how-to/run-action-from-runjs.md同類(lèi)導(dǎo)航動(dòng)作Switch page、Open webpage動(dòng)作配置面板源碼GotoApp.jsx動(dòng)作模型定義含 options 與分組ActionTypes.js事件執(zhí)行運(yùn)行時(shí)含 go-to-app 分支eventsSlice.js已鏈接應(yīng)用映射狀態(tài)appSlice.js事件配置面板與防抖處理EventManager.jsx【免費(fèi)下載鏈接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 項(xiàng)目地址: https://gitcode.com/GitHub_Trending/to/ToolJet創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 ToolJet 跨應(yīng)用導(dǎo)航動(dòng)作完全指南：Go to app 的配置、RunJS 調(diào)用與源碼解析
ToolJet 跨應(yīng)用導(dǎo)航動(dòng)作完全指南Go to app 的配置、RunJS 調(diào)用與源碼解析【免費(fèi)下載鏈接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 項(xiàng)目地址: https://gitcode.com/GitHub_Trending/to/ToolJet導(dǎo)讀Go to app跳轉(zhuǎn)到應(yīng)用是 ToolJet 內(nèi)置的一種導(dǎo)航類(lèi)動(dòng)作用于在事件觸發(fā)時(shí)打開(kāi)當(dāng)前工作區(qū)中任意已發(fā)布Released的 ToolJet 應(yīng)用是實(shí)現(xiàn)多應(yīng)用間相互跳轉(zhuǎn)、入口聚合與流程串聯(lián)的核心手段。本文將從動(dòng)作的觸發(fā)場(chǎng)景、配置面板各字段、通過(guò) RunJS 以代碼方式調(diào)用到其在 frontend 中的事件執(zhí)行源碼給出完整且可驗(yàn)證的實(shí)戰(zhàn)說(shuō)明。讀完本文你將掌握如何在事件處理器中正確配置跳轉(zhuǎn)目標(biāo)與查詢參數(shù)、如何獲取并校驗(yàn)應(yīng)用 slug以及跨應(yīng)用跳轉(zhuǎn)在編輯器與查看器兩種模式下的實(shí)際行為差異。何時(shí)使用 Go to app 動(dòng)作ToolJet 應(yīng)用由組件、查詢與事件處理器Event Handler組成。每個(gè)組件都可以綁定交互事件而每個(gè)事件又可以掛載一個(gè)或多個(gè)動(dòng)作。當(dāng)應(yīng)用體系拆分為多個(gè)應(yīng)用時(shí)例如一個(gè)儀表盤(pán)應(yīng)用 若干業(yè)務(wù)處理應(yīng)用Go to app 就是連接它們的橋梁從列表應(yīng)用跳轉(zhuǎn)到某個(gè)記錄的詳情應(yīng)用并通過(guò)查詢參數(shù)傳遞記錄 ID在一個(gè)總?cè)肟趹?yīng)用中放置多個(gè)導(dǎo)航按鈕分別進(jìn)入不同的已發(fā)布應(yīng)用在事件驅(qū)動(dòng)的自動(dòng)化流程中如 RunJS 查詢成功后按條件跳轉(zhuǎn)到指定應(yīng)用。正如動(dòng)作定義所示它歸屬于navigation導(dǎo)航分組與 Switch page切換頁(yè)面、Open webpage打開(kāi)網(wǎng)頁(yè) 同屬一類(lèi)用于改變用戶當(dāng)前所處的位置或上下文。使用前提目標(biāo)應(yīng)用必須已發(fā)布文檔明確說(shuō)明了一個(gè)約束Go to app 只能打開(kāi)已經(jīng)發(fā)布Released的應(yīng)用未發(fā)布的草稿應(yīng)用無(wú)法作為跳轉(zhuǎn)目標(biāo)。因此在實(shí)際使用前需要在應(yīng)用構(gòu)建器中編輯完成應(yīng)用并通過(guò)右上角的Release發(fā)布按鈕將其發(fā)布在另一個(gè)應(yīng)用中添加 Go to app 動(dòng)作選擇或填寫(xiě)該已發(fā)布應(yīng)用的標(biāo)識(shí)。發(fā)布狀態(tài)決定了該應(yīng)用是否擁有可訪問(wèn)的線上 slug——這是動(dòng)作執(zhí)行時(shí)構(gòu)造跳轉(zhuǎn) URL 的依據(jù)。如何獲取應(yīng)用的 slugGo to app 需要一個(gè)slug來(lái)唯一定位目標(biāo)應(yīng)用。根據(jù)官方動(dòng)作文檔slug 可以通過(guò)以下兩種途徑獲得從已發(fā)布應(yīng)用的瀏覽器 URL 中提取格式為https://your-tooljet-host/applications/slug即application/之后的路徑段從共享Share彈窗中查看在應(yīng)用構(gòu)建器右上角點(diǎn)擊Share按鈕彈出的共享彈窗中會(huì)給出該應(yīng)用的發(fā)布鏈接slug 即鏈接中的標(biāo)識(shí)部分。注意在較新的版本中圖形化配置面板保存的是應(yīng)用的穩(wěn)定關(guān)聯(lián) IDcorrelationId并據(jù)此反查 slug而通過(guò) RunJS 直接調(diào)用時(shí)則仍以 slug 為直接參數(shù)詳見(jiàn)下文。在事件處理器中配置 Go to app添加動(dòng)作并選擇目標(biāo)應(yīng)用在任意組件的事件處理器中新增一個(gè)動(dòng)作從動(dòng)作列表選擇Go to app后會(huì)渲染對(duì)應(yīng)的配置面板。該面板的實(shí)現(xiàn)位于 GotoApp.jsx包含兩個(gè)配置區(qū)域App目標(biāo)應(yīng)用選擇通過(guò)下拉框OptionCombobox列出當(dāng)前工作區(qū)中可選的應(yīng)用選中后寫(xiě)入事件配置。源碼注釋表明新版面板持久化的是correlationId而非舊的slug字段同時(shí)會(huì)把所選應(yīng)用的slug與currentVersionId鏡像到 store 的linkedApps映射中目的是無(wú)需刷新即可在點(diǎn)擊時(shí)構(gòu)造 URL并讓校驗(yàn)邏輯能夠區(qū)分目標(biāo)缺失與沒(méi)有已發(fā)布版本兩種錯(cuò)誤。若所選應(yīng)用在加載的鏈接映射中無(wú)法通過(guò)校驗(yàn)面板會(huì)顯示紅色錯(cuò)誤標(biāo)簽與Undefined app提示。Query params查詢參數(shù)以鍵 / 值成對(duì)的行來(lái)維護(hù)跳轉(zhuǎn)時(shí)攜帶的查詢參數(shù)每行是一個(gè) CodeHinter 代碼輸入框event-query-param-key與event-query-param-value因此鍵與值都可以使用動(dòng)態(tài)引用如{{components.table1.selectedRow.id}}。通過(guò)Add param按鈕可追加新的鍵值行行尾的刪除按鈕可移除不再需要的參數(shù)。對(duì)應(yīng)動(dòng)作在配置層事件模型中的定義位于 ActionTypes.js{ name: Go to app, id: go-to-app, options: [ { name: app, type: text, default: }, { name: queryParams, type: code, default: [] }, ], group: navigation, }即動(dòng)作需要app目標(biāo)應(yīng)用與queryParams查詢參數(shù)JSON 數(shù)組形式默認(rèn)空數(shù)組[]兩類(lèi)配置。下圖展示了該動(dòng)作在事件處理器中的配置界面Debounce 防抖字段在事件處理器中每個(gè)動(dòng)作都可以附帶一個(gè)Debounce防抖字段默認(rèn)情況下該字段為空表示動(dòng)作被觸發(fā)后立即執(zhí)行可以輸入一個(gè)**數(shù)值毫秒**來(lái)指定動(dòng)作延遲執(zhí)行的時(shí)間例如300表示事件觸發(fā)后 300 毫秒才執(zhí)行該動(dòng)作。該字段在 EventManager.jsx 中有相應(yīng)的處理邏輯當(dāng) debounce 參數(shù)被置為空字符串時(shí)會(huì)從事件配置中刪除該鍵從而恢復(fù)立即執(zhí)行的語(yǔ)義。防抖非常適合與查詢、按鈕快速連點(diǎn)等高頻事件配合避免在極短時(shí)間內(nèi)重復(fù)觸發(fā)跳轉(zhuǎn)。通過(guò) RunJS 以代碼方式觸發(fā)跳轉(zhuǎn)除了在事件處理器中圖形化配置Go to app 同樣可以從JavaScript 代碼中觸發(fā)在 RunJS 查詢、組件代碼等場(chǎng)景。ToolJet 為各動(dòng)作提供了一套全局actionsAPI具體語(yǔ)法可參考 Run actions from RunJS query其核心調(diào)用形式為actions.goToApp(slug, queryparams)參數(shù)說(shuō)明slug目標(biāo)已發(fā)布應(yīng)用的 slug可從發(fā)布后 URL 的application/之后獲取或從 Share 彈窗中查看queryparams二維數(shù)組形式例如[ [key1,value1], [key2,value2] ]。一個(gè)實(shí)際示例——從當(dāng)前應(yīng)用跳轉(zhuǎn)到 slug 為customer-detail的應(yīng)用并攜帶客戶 IDconst row components.table1.selectedRow; actions.goToApp(customer-detail, [[id, row.id], [source, dashboard]]);在執(zhí)行層RunJS 發(fā)起的調(diào)用會(huì)被識(shí)別為event.source app-action此時(shí)直接使用傳入的slug源碼注釋明確說(shuō)明這是為了向后兼容保留的直接傳 slug 方式。因此代碼方式跳轉(zhuǎn)時(shí) slug 是必填參數(shù)若為空會(huì)拋出No application slug provided錯(cuò)誤。動(dòng)作執(zhí)行原理與源碼級(jí)解析Go to app 的核心執(zhí)行邏輯位于事件運(yùn)行時(shí) eventsSlice.js一次跳轉(zhuǎn)的執(zhí)行過(guò)程可以拆解為以下幾步解析目標(biāo) slug來(lái)自 RunJSsource app-action時(shí)直接校驗(yàn)event.slug非空并通過(guò)getResolvedValue解析其中可能存在的動(dòng)態(tài)引用來(lái)自構(gòu)建器事件配置時(shí)要求event.correlationId非空然后從 store 的linkedAppsMapcorrelationId, { slug, currentVersionId }定義于 appSlice.js中反查該應(yīng)用對(duì)應(yīng)的 slug。若在編輯器模式下校驗(yàn)失敗應(yīng)用缺失或未發(fā)布會(huì)拋出帶具體原因的異常并進(jìn)入調(diào)試器錯(cuò)誤日志logError(go_to_app, ...)而在查看器viewer模式下則跳過(guò)校驗(yàn)直接嘗試重定向交由既有的 404/not found 兜底處理。組裝查詢參數(shù)將配置中的鍵值對(duì)數(shù)組reduce成一個(gè)對(duì)象鍵與值都經(jīng)過(guò)getResolvedValue解析因此可引用組件狀態(tài)、變量等動(dòng)態(tài)數(shù)據(jù)隨后通過(guò)serializeNestedObjectToQueryParams序列化支持嵌套對(duì)象的展開(kāi)最終拼接出查詢串。構(gòu)造跳轉(zhuǎn) URL 并執(zhí)行基礎(chǔ)路徑為/applications/slug若存在查詢參數(shù)則追加?...若 ToolJet 部署在子路徑subpath下還會(huì)自動(dòng)加上子路徑前綴。之后按運(yùn)行模式分流查看器模式view通過(guò)window.open(url, _self)在當(dāng)前標(biāo)簽頁(yè)完成跳轉(zhuǎn)編輯器模式editor會(huì)先彈出確認(rèn)框The app will be opened in a new tab as the action is triggered from the editor.確認(rèn)后基于當(dāng)前 Host URL 拼出完整地址并在新標(biāo)簽頁(yè)打開(kāi)——因?yàn)榫庉嬈鞅旧沓休d著正在編輯的應(yīng)用不能直接覆蓋當(dāng)前頁(yè)面。正是這條 URL 構(gòu)建邏輯決定了動(dòng)作只能打開(kāi)已發(fā)布應(yīng)用應(yīng)用只有發(fā)布后才擁有對(duì)外可訪問(wèn)的 slug 路徑供拼接與訪問(wèn)。此外事件執(zhí)行前的動(dòng)作校驗(yàn)isLinkedAppValid及相關(guān)工具邏輯位于 AppBuilder/_stores/utils.js 附近負(fù)責(zé)在頁(yè)面/事件觸發(fā)前驗(yàn)證 go-to-app 鏈接目標(biāo)是否有效從而把配置期即可發(fā)現(xiàn)錯(cuò)誤的能力前置到構(gòu)建階段。常見(jiàn)問(wèn)題與注意事項(xiàng)關(guān)注點(diǎn)說(shuō)明目標(biāo)應(yīng)用未發(fā)布跳轉(zhuǎn)會(huì)失敗。請(qǐng)先在目標(biāo)應(yīng)用中完成 Release再檢查其 slug 是否存在。運(yùn)行在編輯器模式下跳轉(zhuǎn)前會(huì)有確認(rèn)彈窗并在新標(biāo)簽頁(yè)打開(kāi)這是為了不打斷當(dāng)前應(yīng)用的編輯會(huì)話。運(yùn)行在已發(fā)布應(yīng)用的查看模式跳轉(zhuǎn)發(fā)生在當(dāng)前標(biāo)簽頁(yè)_self體驗(yàn)上如同頁(yè)面間的自然流轉(zhuǎn)。查詢參數(shù)動(dòng)態(tài)取值鍵與值均支持模板引用{{ ... }}可將選中行、變量等運(yùn)行時(shí)數(shù)據(jù)帶給目標(biāo)應(yīng)用。代碼方式必填 slug使用actions.goToApp(...)時(shí)必須傳 slug否則拋No application slug provided。防抖配合需要延遲執(zhí)行時(shí)填寫(xiě)毫秒值為空即立即執(zhí)行。從跨應(yīng)用跳轉(zhuǎn)這個(gè)單一動(dòng)作可以看到 ToolJet 事件機(jī)制的設(shè)計(jì)取向圖形化配置存儲(chǔ)關(guān)聯(lián) ID、可校驗(yàn)、防抖可控與代碼化調(diào)用actions全局 API雙軌并存統(tǒng)一收斂到同一套事件運(yùn)行時(shí)執(zhí)行既適合無(wú)代碼使用者也為開(kāi)發(fā)者保留了完整的可編程空間。延伸閱讀與源碼索引動(dòng)作官方文檔含多版本歸檔docs/docs/actions/go-to-app.md另見(jiàn) version-3.0.0-LTS 與 version-2.50.0-LTS 兩個(gè)版本的文檔在 RunJS 中觸發(fā)全部動(dòng)作的 API 指南docs/docs/how-to/run-action-from-runjs.md同類(lèi)導(dǎo)航動(dòng)作Switch page、Open webpage動(dòng)作配置面板源碼GotoApp.jsx動(dòng)作模型定義含 options 與分組ActionTypes.js事件執(zhí)行運(yùn)行時(shí)含 go-to-app 分支eventsSlice.js已鏈接應(yīng)用映射狀態(tài)appSlice.js事件配置面板與防抖處理EventManager.jsx【免費(fèi)下載鏈接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 項(xiàng)目地址: https://gitcode.com/GitHub_Trending/to/ToolJet創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考