kintone API

組建kintone畫面的URL

目錄

組建kintone畫面的URL

取得並組建kintone畫面的URL。 如果指定訪客空間內的應用程式,可組建訪客空間的URL。

此API是異步API。
如果要同步處理,請參閱以下頁面。

函數

電腦版/行動裝置版

kintone.buildPageUrl(page, params)

參數

參數名稱 類型 必須 說明
page 字串 必須 表示畫面的字串
指定以下值之一:
  • 應用程式畫面
    • APP_INDEX:清單(PC)
      params.appId必須指定。可指定params.viewId
    • APP_CREATE:新增(PC)
      params.appId必須指定。
    • APP_DETAIL:詳情(PC)
      必須指定params.appIdparams.recordId
    • APP_EDIT:編輯(PC)
      必須指定params.appIdparams.recordId
    • APP_PRINT:列印(PC)
      必須指定params.appIdparams.recordId
    • APP_REPORT:圖表(PC)
      必須指定params.appIdparams.reportId
    • APP_INDEX_MOBILE:清單(行動裝置)
      params.appId必須指定。可指定params.viewId
    • APP_CREATE_MOBILE:新建(行動裝置)
      params.appId必須指定。
    • APP_DETAIL_MOBILE:詳情(行動裝置)
      必須指定params.appIdparams.recordId
    • APP_EDIT_MOBILE:編輯(行動裝置)
      必須指定params.appIdparams.recordId
    • APP_REPORT_MOBILE:圖表(行動裝置)
      必須指定params.appIdparams.reportId
  • 空間畫面
    • PORTAL_TOP:頂部(PC)
    • PORTAL_TOP_MOBILE:頂部(行動裝置)
  • 空間畫面
    • SPACE_PORTAL:空間入口網站(PC)
      params.spaceId必須指定。
    • SPACE_THREAD:主題(PC)
      必須指定params.spaceIdparams.threadId
    • SPACE_PORTAL_MOBILE:空間入口網站(行動裝置)
      params.spaceId必須指定。
    • SPACE_THREAD_MOBILE:主題(行動裝置)
      必須指定params.spaceIdparams.threadId
  • 用戶畫面
    • PEOPLE_TOP:頂部(PC)
      params.userCode必須指定。
    • PEOPLE_TOP_MOBILE:頂部(行動裝置)
      params.userCode必須指定。
  • 訊息畫面
    • MESSAGE_TOP:頂部(PC)
      params.userCode必須指定。
    • MESSAGE_TOP_MOBILE:頂部(行動裝置)
      params.userCode必須指定。
  • 搜尋畫面
    • SEARCH_TOP:頂部(PC)
    • SEARCH_TOP_MOBILE:頂部(行動裝置)
  • 通知畫面
    • NOTIFICATION_TOP:頂部(PC)
  • 應用程式商城畫面
    • APP_MARKETPLACE_TOP:頂部(PC)
params 物件 必須 用於組建URL的參數
params.appId 字串 部分條件下必須 應用程式ID
應用程式的各畫面必須指定。
params.recordId 字串 部分條件下必須 記錄ID
在記錄詳情、記錄編輯和記錄列印的各畫面中,必須指定。
params.viewId 字串 可省略 清單的ID
params.reportId 字串 部分條件下必須 圖表的ID
圖表畫面上必須指定。
params.spaceId 字串 部分條件下必須 空間ID
空間的各畫面上必須指定。
params.threadId 字串 部分條件下必須 主題ID
主題畫面上必須指定。
params.userCode 字串 部分條件下必須 用戶代碼
用戶與訊息的各畫面上必須指定。

返回值

返回值是Promise物件。
解析Promise物件後,可獲取到以下值:

類型 說明
字串 畫面的URL

可使用的畫面

電腦版/行動裝置版

可使用的畫面同整體自訂的套用畫面。
kintone整體自訂的套用畫面

但以下畫面不可用。

  • 搜尋畫面
  • 應用程式商城
  • 插件設置畫面

注意事項

此API會在執行階段從伺服器獲取資料。獲取到的資料會被緩存,直到發生畫面轉換。
如果每個使用者每分鐘從伺服器獲取資料超過50次,則會拒絕傳回的Promise物件。