使用kintone的"JavaScript/CSS自定義"功能，可以自定義kintone的功能、應用行為和介面。
此外，還可以使用kintone REST API與外部系統集成數據。
本文將對kintone中JavaScript的自定義和外部系統集成時的注意事項進行說明。

關於如何使用JavaScript自定義kintone和應用，請參考kintone用戶説明。

• 使用JavaScript和CSS自定義整個kintone
• 使用 JavaScript 和 CSS 自定義應用

以UTF-8格式保存（不帶 BOM）。

請勿修改已有的全域對象，因為kintone可能無法正常工作。
此外，不要使用全域變數，而是在直接函數的作用域或塊作用域內定義變數。

如果必須使用跨作用域共用的變數，請使用以下方法防止全域污染：

• 使用 JavaScript 打包器工具，例如 webpack。
  如何使用帶有kintone自定義功能的webpack，以它 為目標！ 請參考 JavaScript 自定義中級 （1） -webpack-。
• 使用命名空間物件。

不要使用全域變數

1
2
3
4
5
6
7

// 將變數定義為即時函數中的局部變數
(() => {
  // 壞例子
  globalVariable = 1; // 將變數定義為全域變數
  // 很好的例子
  const localVariable = 1; // 將變數定義為即時函數中的局部變數
})();

let 和 const 如果使用，則可以使用塊作用域定義變數，如下所示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// 在塊作用域中將變數定義為局部變數
{
  // 壞例子
  // 兩者都將變數定義為全域變數
  globalVariable1 = 1;
  var globalVariable2 = 1;
  // 很好的例子
  // 兩者都將變數定義為塊作用域中的局部變數
  const localVariable1 = 1;
  let localVariable2 = 1;
}

不要添加、修改或引用現有的全域物件

1
2
3
4
5
6
7
8

(() => {
  // 壞例子
  cybozu.foo = 'bar'; // 向現有全域物件添加或重寫新屬性
  const foo = cybozu.foo; // 引用現有全域物件
  // 很好的例子
  myNameSpace = {}; // 使用空間物件
  myNameSpace.foo = 'bar';
})();

分配給每個元素的id和 class 屬性的值如有更改，恕不另行通知。
DOM 結構也可能會發生變化。

自訂時，請勿進行引用或修改以下內容的自定義：

• 每個元素的id或 class 屬性的值
• 通過kintone JavaScript API以外的方法獲取的產品DOM結構

使用DOM元素時，請使用kintone JavaScript API，如有更改，恕不另行通知。

JavaScript API獲取的元素中添加的元素可能會受到kintone CSS的影響。
因此，添加元素的顯示可能會因kintone的更新而發生變化。

關於可以檢索元素的API，請參見kintone JavaScript API中的 獲取元素。

使用kintone.api.url() 或 kintone.api.urlForGet() ，獲取kintone的URL。
這樣它就可以在將來的版本中工作。

粘貼到空格或線程內文中的以下部分無法使用JavaScript API進行自定義。

• 應用程式的記錄清單
• 圖表

建議您使用多個Web瀏覽器進行操作。
根據 Web 瀏覽器的類型和版本，您可能看不到預期的行為。

如果載入的JavaScript程式存在問題，kintone可能無法正常工作。
確保自訂的kintone功能正常工作。

有問題的程式可能會降低性能或阻止您使用服務。

自動發送大量請求的程式或同時並行執行大量請求的程式都可能導致回應不良等服務降級。
對於導致伺服器負載過高或資源消耗過大的請求，可能會強制實施訪問限制。

為了能夠判斷從哪個服務或工具發送請求，請設置相應的使用者代理（"User-Agent"標頭）。

有關使用者代理的指南，請參閱 RFC 9110，User-Agent。
10.1.5. User-Agent | RFC 9110

根據所創建程式的實現情況，kintone更新后，自定義設置可能無法正常工作。
根據需要編輯 JavaScript 和 CSS 檔案，然後重新上傳。

如需降低kintone更新的影響，請使用kintone JavaScript API。
API 規範披露和規範變更政策

為避免因自定義而出現安全問題， 安全編碼準則 進行編碼。