Gardenia
設計您的條碼標籤

Gardenia是一款免費線上條碼標籤設計軟體,以簡易的設計介面輕鬆製作標籤樣板並列印標籤文件PDF,支援多種條碼格式並可匯入Excel資料合併列印。

Gardenia

Gardenia 說明指南

1.如何使用文件套表列印功能

日常生活中我們有許多的證書文件、信封、票據、標籤貼紙…等等,都會設計成固定格式但須要替換不一樣的資料內容
此時我們就需要使用套表列印,以批次自動的方式節省大量手動替換各欄位資料的時間
以下將以學生成績單為例示範Gardenia的套印功能

首先整理好學生成績資料的Excel檔案,如下圖
學生成績資料的Excel檔案

接著在Gardenia網頁上設計出學生成績單樣板文件(下載範本檔)
使用Gardenia設計的學生成績單樣板文件,還未繫結任何資料欄位

在文件空白處點擊滑鼠左鍵打開浮動選單->資料->資料來源
選擇檔案上傳,上傳整理好的Excel檔後按下確定
在資料來源選單中上傳學生成績資料的Excel檔並預覽上傳資料

將滑鼠移動到班級右方鄰接的文字方塊上點擊滑鼠左鍵選取該文字方塊
在維持文字方塊選取的狀態下到畫面左上方的資料圖示按下滑鼠左鍵開啟選單
在文字方塊被選取的狀態下開啟資料來源選單,顯示出可繫結的資料欄位清單

按一下選單中的班級欄位按鈕,此時文字方塊左上角會出現一個Tag表示此文字方塊已繫結到班級的欄位資料
在文字方塊被選取的狀態下開啟資料來源選單並按下欲繫結的資料欄位後,文字方塊左上角顯示已繫結資料欄位Tag

以此類推,將其他欄位:姓名、座號、各科成績…以相同方式繫結完成
使用Gardenia設計的學生成績單樣板文件,已完成繫結全部資料欄位

這樣就可以到畫面左上方的列印圖示開啟選單->合併列印(PDF檔)->確定,開啟套印好的學生成績單了
開啟合併列印(PDF檔)功能選單

預覽結果
Gardenia已將學生成績資料套表列印至成績單樣板文件產出的PDF檔


1.2.如何錄製API文件樣板

開啟已經完成好的樣板文件,在畫面左上方的列印圖示按下滑鼠左鍵開啟選單->錄製Web API
於序號欄位輸入從網站取得的樣板文件序號後按下確定,開始錄製
開啟錄製Web API功能選單,輸入樣板文件序號

錄製成功即會開啟新網頁分頁,顯示已經轉換為能夠用於JavaScript API的JSON格式資料
錄製好可供API使用的JSON格式資料


2.如何呼叫JavaScript API套表列印文件

在網頁應用程式中編寫用戶端JavaScript程式,可以建立自訂化動態資料的套表列印功能
這裡可提供對JavaScript程式設計有所了解的開發人員快速使用

Step 1.將下方script標籤引用至網頁的html內

<script type="text/javascript" src="https://gardenia.api.drummer.tw/documentPrinter.js"></script>

Step 2.以documentPrinter元件呼叫列印API函式,傳入的參數是錄製好的樣板文件序號與JSON格式資料

documentPrinter.printAndOpen('a889f8f7-547b-4a0c-9e2f-ee839eab471e',
    {
                                            'faa5d447-9d26-4c3d-b420-60c783415609': [
            {
                                            '姓名': '伊藤千佳',
                                            '班級': '6年2班',
                                            '座號': '1',
                                            '國文': '90',
                                            '英文': '88',
                                            '數學': '93',
                                            '社會': '85',
                                            '自然': '95',
                                            '平均': '90.2'
            }
        ]
    });

完整的Html檔示範(此處開啟)


2.2.API函式
函式名稱 說明
printAndOpen 於新分頁開啟PDF檔案
printAndDownload 下載PDF檔案,可於最後一個參數指定檔案名稱
(ex:documentPrinter.printAndDownload('序號',{JSON},filename);)
printAsUrlAsync 回傳PDF檔案網址,可等待
(僅用戶端ObjectUrl)
printAsync 回傳Data物件,可等待
(物件結構:{content, mediaType})

2.3.多檔合併功能

有時會需要將多個文件集中合併到單個PDF檔中列印
或者應用程式有稍微複雜的條件判斷組合需求,只用單一個文件樣板無法滿足自訂套印
這時候只要在呼叫API函式時依序以:序號、JSON資料、序號、JSON資料…的方式向後增加傳入的參數
就可以達到多個文件合併套印至一個PDF檔案了

多檔合併示範(此處開啟)


2.4.文件樣板加密

若文件樣板裡面存在有不應於雲端儲存的機敏資訊、圖檔…等等
可以在錄製Web API時在序號欄位輸入的樣板文件序號前面加上一段自訂密碼
這樣子錄製的樣板內容就會經過密碼加密後才上傳
而在應用程式中呼叫套印API函式時則必須用相同的自訂密碼加在序號前面才能夠解密和執行

加密文件示範(此處開啟)

An unhandled error has occurred. Reload 🗙