Mailing Labels Custom Widget

343
0
05-28-2025 07:41 AM

Mailing Labels Custom Widget

Mailing Label Widget Overview

This widget is designed to enhance mailing label management within the ArcGIS Experience Builder ecosystem. It offers seamless integration with map layers, advanced selection and drawing tools, and supports multiple label output formats including CSV and PDF.

Note: Requires install of jsPDF on client folder, running npm install jspdf

Note: Input service needs to be a Feature Layer (editing capabilities not required)

Developer Edition Configuration 

End User Interaction 


What Can This Widget Do?

Original capabilities (from core logic):

  • Select and configure map layers to use as data sources for labels.

  • Map fields to specific mailing fields (name, address, city, state, zip).

  • Draw shapes (point, polyline, polygon, rectangle, circle) to select areas for labels.

  • Generate labels in CSV and PDF formats with customizable label templates (Avery 5160–5164).

  • Font size options for printed labels.

  • Automatically disables Esri’s popups and highlights while active to focus on drawing and selection.

  • Clear selection areas and restore map behavior when the widget is closed.

Enhanced capabilities in this version:

  • Dynamic field mapping options that populate from selected layers.

  • Buffering options (distance and unit) for drawn geometries to expand selection areas.

  • Clear selection graphics and highlight management with fallback visualizations for feature selection.

  • Responsive label previews and customizable font size and label formats.

  • Error handling and messaging for failed queries or drawing operations.

  • Map view and layer management to handle disconnected or delayed map loading gracefully.

  • Interactive user messages (success, warning, error) displayed for actions like selection, generation, or errors.


Configuration Options

  • Map Widget Selection: Choose the map widget to connect to.

  • Layer and Field Mapping: Select a feature layer and assign fields to mailing label fields.

  • Geometry Selection: Enable selection by click, draw, or both; configure a buffer for drawn areas.

  • Label Format and Font: Choose from multiple Avery formats and set the font size.

  • Output Options: Generate mailing labels as CSV or open a print-ready PDF.

Changelog:

06/12/2025: Resolved bug that allowed for selection of up to 2,000 records but downloaded only 500. Limit now is 2,000 for both selection and CSV/PDF download. 

05/28/2025: Automatic PDF Downloads with Smart Naming

Improvements and Enhancements for User Group

These are potential areas of improvement and ideas that could be explored in future updates, and are open to feedback and suggestions from the Esri Community:

  • Display buffer area vs originally drawn area from selection tools.

Attachments
Version history
Last update:
‎06-12-2025 07:15 AM
Updated by:
Contributors