Addrly 使用者指南

3. 主要功能概覽

應用程式結構

圖 1：Addrly 主介面

應用程式包含五個主要部分，可從側邊欄存取：

• • 首頁： 建立並列印標籤
• • 地址管理器： 管理您的地址資料庫
• • 列印歷史： 檢視過去的列印活動
• • 設定： 配置應用程式偏好設定

導覽

使用左側的圖示側邊欄在不同部分之間導覽。點擊任何圖示即可切換到該部分。目前所在的部分將會被標示。

4. 首頁 - 建立標籤

概覽

首頁是您建立、編輯、預覽和列印地址標籤的地方。它採用分割窗格佈局，左側為地址輸入，右側為標籤預覽。

逐步教學：建立您的第一個標籤

4.1 輸入地址資訊

4.2 格式化您的標籤

格式化工具列提供以下選項：

• 粗體 (B)： 將選取的文字設為粗體
• 斜體 (I)： 將選取的文字設為斜體
• 底線 (U)： 為選取的文字加上底線
• 對齊： 靠左、置中或靠右對齊文字
• 字型系列： 從系統字型或內建字型中選擇
• 字型大小： 調整文字大小（8-72 點）
• 字元間距： 控制字元之間的間距
• 行高： 調整行之間的間距
• 文字轉換： 正常、大寫、小寫或首字母大寫
• 文字顏色： 使用色彩選擇器選擇文字顏色

4.3 選擇範本

Addrly 附帶多個預先配置的標籤範本：

• 小型標籤： 50mm × 25mm
• 中型標籤： 70mm × 30mm
• 大型標籤： 100mm × 50mm
• 自訂： 定義您自己的尺寸

從範本下拉選單中選擇一個範本，或選擇「自訂」以毫米為單位設定您自己的寬度和高度。

4.4 標籤尺寸設定

在標籤尺寸部分，您可以配置：

• 寬度 (mm)： 標籤寬度（毫米）
• 高度 (mm)： 標籤高度（毫米）
• 左邊界 (mm)： 從左邊緣的水平偏移
• 上邊界 (mm)： 從上邊緣的垂直偏移
• 列印份數： 要列印的份數
• 旋轉 90°： 將標籤旋轉 90 度列印
• 列印深度： 低、中或高（影響列印品質）

4.5 預覽

右側的預覽窗格顯示標籤列印時的即時預覽。當您更改地址或格式時，預覽會自動更新。

4.6 列印

4.7 儲存地址

建立標籤後，您可以儲存地址以供將來使用：

5. 地址管理器

概覽

地址管理器允許您儲存、搜尋、編輯和管理所有已儲存的地址。如果您經常為相同的收件人列印標籤，這特別有用。

檢視地址

地址管理器以清單顯示所有已儲存的地址。每個地址顯示收件人的姓名和基本資訊。點擊任何地址以在右側窗格中檢視其完整詳細資訊。

搜尋地址

使用頂部的搜尋方塊按姓名、公司、城市或任何其他欄位快速尋找地址。清單會隨著您輸入即時篩選。

新增地址

圖 2：新增地址

從文字解析地址

您可以透過貼上地址文字快速新增地址：

編輯地址

刪除地址

從 QuickBooks 匯入

如果您已連接 QuickBooks Online，您可以直接匯入客戶地址：

從地址管理器列印

您可以直接從地址管理器列印標籤：

6. QuickBooks 匯入

概覽

QuickBooks 匯入功能允許您從 QuickBooks Online 帳戶無縫匯入客戶地址。這消除了手動輸入資料的需要並確保準確性。

圖 3：QuickBooks 匯入介面

連接到 QuickBooks

匯入客戶

Duplicate Prevention

The import system uses QuickBooks customer IDs to prevent duplicate entries:

• Each QuickBooks customer has a unique ID
• When importing, the system checks if a customer with the same ID already exists
• If a duplicate is found, the existing address is returned instead of creating a new one
• This ensures you won't accidentally create multiple entries for the same customer

Refreshing Customer List

Click the "Refresh" button to reload the customer list from QuickBooks. This is useful if you've added new customers in QuickBooks since the last import.

Connection Status

If you're not connected to QuickBooks, the page will display a warning message with a button to navigate to the QuickBooks connection settings. Your connection status is automatically saved and will persist across application restarts.

7. Print History

Overview

The Print History page keeps a record of all your printing activities, including the address printed, printer used, and timestamp. This is useful for tracking and reprinting labels.

Viewing Print History

The print history is displayed in a list format, showing the most recent prints first. Each entry displays:

• Address information
• Printer name
• Date and time of printing

Searching Print History

Use the search box to find specific print records by address, printer name, or date.

Reprinting a Label

Deleting Print Records

You can delete individual print records or clear all history:

• Delete Single Record: Select a record and click the delete button, then confirm
• Delete All History: Click "Delete All History" button and confirm the action

8. Settings

Overview

The Settings page is divided into three tabs: General, Printer, and QuickBooks. Access Settings from the sidebar icon.

Figure 6: General Settings

7.1 General Settings

Language

Change the interface language from the dropdown. Supported languages include:

• English
• 简体中文 (Simplified Chinese)
• Español (Spanish)
• Français (French)
• Deutsch (German)
• Italiano (Italian)
• Português (Portuguese)
• Русский (Russian)
• 日本語 (Japanese)
• 한국어 (Korean)
• العربية (Arabic)

The language change takes effect immediately. Don't forget to click "Save" to persist your settings.

Default Sender Address

Configure your default return address that will be used when creating return address labels:

You can also click "Print" to immediately create a label with your sender address.

Figure 7: Printer Management

7.2 Printer Management

Adding a Printer

Testing a Printer

After adding a printer, you can test the connection:

Editing a Printer

Click the edit icon next to a printer to modify its settings. Make your changes and click "Save".

Deleting a Printer

Click the delete icon next to a printer to remove it from your configuration. This action cannot be undone.

Refreshing Printer List

Click the "Refresh" button to scan for newly connected printers on your system.

7.3 QuickBooks Integration (Optional)

Addrly can optionally integrate with QuickBooks Online to import customer addresses. This integration uses OAuth 2.0 with PKCE for secure authentication.

Connecting to QuickBooks

Importing Customers

After connecting to QuickBooks, you can import customer addresses:

OAuth Proxy Server (Advanced)

If you're using a server-based OAuth setup, you can configure a proxy server URL:

Disconnecting from QuickBooks

To disconnect your QuickBooks account:

9. Printing

Print Process

When you click the "Print" button, Addrly:

1. Renders the label design to a high-resolution bitmap
2. Converts the bitmap to the appropriate printer command format (TSPL, ZPL, etc.)
3. Sends the commands to the selected printer via USB, COM port, or network
4. Records the print job in your print history

Print Quality Settings

The "Print Depth" setting affects print quality:

• Low: Faster printing, lighter print
• Medium: Balanced speed and quality (recommended)
• High: Slower printing, darker and more durable print

Print Troubleshooting

Printer Not Responding

• Check that the printer is powered on and connected
• Verify the connection type matches your setup (USB, COM, or Network)
• Try refreshing the printer list in Settings
• Test the printer connection using the "Test" button in Settings

Print Quality Issues

• Adjust the "Print Depth" setting (try Medium or High)
• Check that the label size matches your physical label dimensions
• Verify the printer resolution setting matches your printer's actual resolution
• Clean the printer head if prints appear faded or streaky

Text Not Fitting on Label

• Reduce the font size
• Adjust letter spacing and line height
• Use a larger label template
• Remove unnecessary text or formatting

Label Alignment Issues

• Adjust the "Left Margin" and "Top Margin" settings
• Check that the label is properly loaded in the printer
• Calibrate your printer if it has a calibration function

10. Troubleshooting

Application Issues

Application Won't Start

• Check that your system meets the minimum requirements
• Try restarting your computer
• Reinstall the application if the problem persists
• Check for error messages in system logs

Address Parsing Not Working

• Ensure the address follows a standard format (Name, Street, City, State, Zip)
• Try manually editing the parsed fields if automatic parsing fails
• Check that all address components are on separate lines

Preview Not Updating

• Try clicking in the address editor to refresh the preview
• Check that you haven't exceeded the label size limits
• Restart the application if the preview remains frozen

Settings Not Saving

• Make sure you click the "Save" button after making changes
• Check that you have write permissions in the application data directory
• Try restarting the application and re-entering your settings

Data Issues

Addresses Disappearing

• Check the search filter - you may have a search query active
• Verify that addresses weren't accidentally deleted
• Check the application data directory for database files

Print History Not Showing

• Ensure you've actually printed at least one label
• Check that print history wasn't cleared
• Try refreshing the page or restarting the application