建立自訂變數

本指南將逐步說明如何建立自訂變數範本。時間 這個變數會擷取值陣列,並將其做為 以半形逗號分隔的字串。

  1. 如要開始建立第一個變數範本,請點選左側的「範本」 然後按一下「變數範本」下方的「新增」按鈕 專區。

  2. 在「Info」分頁中,定義變數的「Name」和「Description」

    名稱是導入程式碼時向使用者顯示的內容 變數,

    「說明」顧名思義,就是簡短的「說明」(200 個半形字元或 。

  3. 按一下「重新整理」即可預覽範本。

    欄位輸入的右側會顯示「Template Preview」視窗。 每次變更編輯器時,「重新整理」按鈕都會 顯示。按一下 [重新整理] ,看看您對表格外觀 變數。

  4. 按一下「欄位」,在變數範本中新增欄位。

    範本編輯器的「欄位」分頁可讓您建立及編輯 變數範本欄位可用來輸入自訂資料,例如帳戶 編號。你可以新增標準表單元素,例如文字欄位、下拉式選單 選單、圓形按鈕和核取方塊

  5. 按一下「新增欄位」,然後選取「簡易表格」。替換預設名稱 (例如 "simpleTable1") 取代為 "list"。在「Template Preview」中,按一下「Refresh」

    文字輸入重複這個步驟,並將其命名為「array」和兩個核取方塊。 稱為「use_array」和 "sort",以及名為 "分隔符號"文字輸入內容。 如要設定 "分隔符號,則請使用預設值「,」。方法是按一下齒輪圖示 將「預設值」切換為開啟,然後填入新的預設值 輸入欄位

  6. 按一下「Code」分頁標籤,然後在編輯器中輸入採用沙箱機制的 JavaScript:

    var input = data.array;
    
    if (!data.use_array) {
      input = [];
      for (var i = 0; i < data.list.length; i++) {
        input.push(data.list[i].values);
      }
    }
    
    if (data.sort) {
      input.sort();
    }
    
    return input.join(data.delimiter || ',');
    

    這個變數的程式碼相當簡單明瞭,但有幾個功能 值得一提的是

    • data 欄位。

      系統正從全域 data 存取部分欄位。 data 會包含您在上一步設定的值。 因此,我們可以存取「data.use_array」、「data.sort」、 data.listdata.delimiter

    • 如果 data.delimiterdelimiter,則將設為 "," 的預設值 沒有提供。建議您考慮為欄位設定預設值, 十分合理如此一來,使用者就能更輕鬆地使用變數 範本,因為他們不必填寫每個欄位 變數。

  7. 按一下「Save」(儲存) 即可儲存進度。這會載入所有偵測到的權限 複製到「範本編輯器」中

    部分 Template API 具備相關聯的權限,而這些權限會決定哪些內容 能夠或不能執行的作業使用範本 API 時,如 sendPixel 這樣一來,代碼管理工具會在權限頁面顯示相關權限 分頁。

  8. 在「範本預覽」分頁中,新增一些「值」的值。輸入,按一下 執行程式碼,然後查看控制台,查看變數的輸出內容。

    如有任何錯誤,將會顯示在「Console」視窗中。

  9. 按一下「儲存」,然後關閉範本編輯器

    變數範本現在應已可供使用。