Connettori Dati

Riferimento completo per tutti i connettori disponibili. Ogni connettore permette di importare dati da una sorgente specifica per la stampa etichette.

Tutti i connettori seguono lo stesso workflow: selezione del tipo sorgente, configurazione della connessione, selezione dei dati e mappatura dei campi. Per il workflow generale, consulta la guida Tabelle / Database.

File

Excel / ODS

Importa dati da file Microsoft Excel (.xlsx, .xlsm, .xls, .xlsb) e LibreOffice Calc (.ods).

• Profile name / Description — Nome e descrizione del profilo dati
• File path — Percorso al file Excel/ODS. Usa Browse per selezionare

Dopo OK, viene mostrata la lista dei fogli disponibili. Seleziona il foglio da usare come sorgente dati.

CSV / Testo

Importa dati da file CSV e testo delimitato con rilevamento automatico delle impostazioni.

• CSV file path — Percorso al file CSV/testo
• Delimiter — Carattere separatore (virgola, punto e virgola, tab, ecc.)
• Quote Char — Carattere di citazione per campi con delimitatori interni
• Encoding — Codifica del file (utf-8, latin-1, ecc.)
• The first row contains the header — Indica se la prima riga contiene i nomi dei campi
• Auto Detect — Rileva automaticamente delimitatore, citazione ed encoding

Microsoft Access

Connessione diretta a database Microsoft Access (.mdb, .accdb). Solo Windows.

• Access database path — Percorso al file .mdb o .accdb
• Database Password — Password del database (se protetto)
• Access driver — Driver Access installato. Other... mostra i driver disponibili
• RECOMMENDED: Use Read Uncommitted — Evita blocchi database durante la lettura
• Custom Query — Query SQL personalizzata (opzionale). Open Query Editor apre l'editor visuale

Apache Parquet

Legge file Apache Parquet, formato colonnare ad alte prestazioni per dataset di grandi dimensioni.

• File path — Percorso al file .parquet
• Read uncommitted — Ottimizzazione performance lettura

Feather / Arrow IPC

Legge file Feather e Arrow IPC, formato binario veloce per lo scambio dati tra applicazioni analitiche.

SPSS / SAS / Stata

Legge file statistici: SPSS (.sav), SAS (.sas7bdat) e Stata (.dta). Tutti i formati sono letti con librerie open-source (pyreadstat, licenza Apache-2.0).

Apache Avro

Legge file Apache Avro, formato binario con schema integrato usato in ecosistemi Hadoop e streaming.

HDF5

Legge file Hierarchical Data Format 5, usato per dati scientifici e ingegneristici di grandi dimensioni. Seleziona il dataset specifico all'interno del file.

GeoPackage / GeoJSON / Shapefile

Importa dati geospaziali. Supporta tre formati:

• WKT (text) — Geometria in formato testuale
• XY Coordinates — Colonne separate per latitudine/longitudine
• Encoded — Geometria codificata (GeoJSON, WKB)

File Connessione Dati Office (.odc)

Legge file ODC (Office Data Connection) creati da Excel o altri prodotti Office per riutilizzare connessioni dati predefinite.

JSON / XML

Importa dati strutturati da file JSON e XML locali. Supporta strutture nidificate con auto-flattening dei dati.

Database relazionali

Microsoft SQL Server

Connessione a Microsoft SQL Server con autenticazione Windows o SQL Server.

• Server — Nome o IP del server (es. localhost, server\instance)
• Database — Nome del database
• ODBC driver — Driver installato (es. ODBC Driver 17 for SQL Server). Other... mostra i driver disponibili
• Windows Authentication — Usa le credenziali Windows correnti (Trusted Connection)
• User / Password — Credenziali SQL Server (se non si usa Windows Auth)
• RECOMMENDED: Use Read Uncommitted — Previene blocchi database
• Custom Query — Query SQL personalizzata con editor integrato

MySQL

Connessione a MySQL e MariaDB.

• Host/Server — Indirizzo del server (default: localhost)
• Port — Porta (default: 3306)
• Database — Nome del database
• User / Password — Credenziali di accesso
• Use Read Uncommitted Isolation — Evita blocchi in lettura
• Custom Query — Query SQL personalizzata con editor integrato

PostgreSQL

Connessione a PostgreSQL con supporto SSL.

• Host / Port — Server e porta (default: 5432)
• Database — Nome del database
• User / Password — Credenziali
• Use SSL — Abilita connessione cifrata
• Custom Query — Query SQL personalizzata

Oracle Database

Connessione a Oracle Database con due modalità di connessione.

• Connection type — Easy Connect (Host/Port/Service) o DSN
• Host/Server, Port, Service/SID name — Parametri di connessione Easy Connect
• ODBC driver — Oracle Instant Client driver
• RECOMMENDED: Read Uncommitted — Usa Oracle MVCC per performance
• Custom Query — Query SQL personalizzata con editor

IBM Db2

Connessione a IBM Db2 con supporto SSL/TLS.

• Host / Port — Server e porta (default: 50000)
• Database — Nome del database
• Username / Password — Credenziali
• Use SSL/TLS — Connessione cifrata

ClickHouse

Connessione a ClickHouse, database OLAP colonnare ad alte prestazioni.

• Host / HTTP Port — Server e porta HTTP (default: 8123)
• Database — Nome del database
• Username / Password — Credenziali (default user: default)
• Use SSL — HTTPS

Trino (SQL Gateway)

Connessione a Trino (ex Presto), gateway SQL distribuito per query federate.

• Host / Port — Coordinatore Trino (default: 8080)
• Catalog / Schema — Catalogo e schema dati
• Username / Password — Credenziali
• Use SSL — HTTPS

Big Data e Analytics

Snowflake Data Cloud

Connessione a Snowflake Data Cloud.

• Account — Identificativo account Snowflake (es. xy12345.eu-west-1)
• Warehouse — Warehouse di elaborazione
• Database / Schema — Database e schema target
• Username / Password — Credenziali
• Role — Ruolo Snowflake (opzionale)

Databricks SQL

Connessione a Databricks SQL Analytics via HTTP.

• Server hostname — Host del workspace Databricks
• HTTP path — Percorso SQL warehouse
• Access token — Token di autenticazione personale
• Catalog — Catalogo Unity (opzionale)

Google BigQuery

Connessione a Google BigQuery tramite service account.

• Credentials JSON file — File JSON delle credenziali service account Google
• Project ID — ID progetto Google Cloud

DuckDB (Analitico Embedded)

Database analitico embedded, senza server. Ideale per analisi locali veloci.

• Database file path — Percorso al file .duckdb (o lascia vuoto per in-memory)
• Read only — Apri in sola lettura

Apache Cassandra

Connessione a cluster Apache Cassandra NoSQL.

• Contact points — Nodi del cluster (separati da virgola)
• Port — Porta nativa (default: 9042)
• Keyspace — Keyspace target
• Username / Password — Credenziali (se autenticazione abilitata)

Cloud Storage

Amazon S3

Legge file da bucket Amazon S3.

• Access Key ID / Secret Access Key — Credenziali IAM AWS
• Region — Regione AWS (es. eu-west-1)
• Bucket name — Nome del bucket
• File path/prefix — Percorso al file nel bucket

Azure Blob Storage

Legge file da Azure Blob Storage.

• Connection string — Stringa di connessione completa (alternativa ad account + key)
• Account name / Account key — Credenziali storage account
• Container — Nome del container
• Blob path — Percorso al blob

SharePoint / OneDrive

Accede a file su SharePoint Online e OneDrive for Business via Azure AD.

• Tenant ID — ID tenant Azure AD
• Client ID / Client Secret — Credenziali app Azure registrata
• Site URL — URL del sito SharePoint
• File path — Percorso al file nella libreria documenti

NoSQL e Enterprise

MongoDB

Connessione a MongoDB con due modalità.

• Use connection string (URI) — Connessione via URI MongoDB completa
• Host / Port — Server e porta (default: 27017)
• Username / Password — Credenziali
• Auth Database — Database di autenticazione (default: admin)
• Use SSL/TLS — Connessione cifrata

Elasticsearch

Connessione a cluster Elasticsearch.

• Elasticsearch URL — URL del cluster (es. https://localhost:9200)
• Username / Password — Credenziali (se autenticazione abilitata)
• Verify SSL — Verifica certificato SSL
• API Key — Alternativa alle credenziali

Redis

Connessione a Redis in-memory data store.

• Host / Port — Server e porta (default: 6379)
• Password — Password (se configurata)
• Database — Indice database (default: 0)
• Key pattern — Pattern glob per filtrare le chiavi (es. product:*)
• Use SSL/TLS — Connessione cifrata

Neo4j Graph DB

Connessione a Neo4j per estrarre dati dal database a grafo via query Cypher.

• URI — URI di connessione (es. bolt://localhost:7687)
• Username / Password — Credenziali
• Database — Nome database (default: neo4j)

Apache Kafka

Consuma messaggi da topic Apache Kafka.

• Bootstrap servers — Server Kafka (es. localhost:9092)
• Group ID — Consumer group
• Topic — Nome del topic
• Max messages / Timeout — Limiti di lettura
• SASL Authentication — Autenticazione SASL (opzionale)
• SSL/TLS — Connessione cifrata con certificati

Web Services e API

API REST Generica

Connessione a qualsiasi API REST con supporto per diversi metodi di autenticazione.

• API Base URL — URL base dell'API
• Method — Metodo di autenticazione: none, basic, bearer, apikey, oauth2
• Username / Password — Per autenticazione Basic
• Token / API Key — Per autenticazione Bearer o API Key
• Header name / Value Prefix — Personalizzazione header (es. Authorization: Bearer ...)
• Endpoint — Endpoint specifici separati da virgola

Servizio OData

Connessione a servizi OData (Open Data Protocol), standard per API RESTful usato in SAP, Microsoft Dynamics e altri.

• Service Base URL — URL del servizio OData
• Method — Autenticazione: none, basic, bearer, apikey
• Custom Query — Filtro OData personalizzato

Web Service SOAP (WSDL)

Connessione a web service SOAP tramite descrittore WSDL.

• WSDL URL — URL del file WSDL
• Username / Password — Credenziali WS-Security (opzionali)

Google Sheets

Importa dati da fogli Google Sheets tramite service account.

• Credentials JSON file — File JSON delle credenziali service account Google
• Spreadsheet ID — ID del foglio Google (dalla URL)
• Sheet name — Nome del foglio specifico (opzionale)

Cloud Analytics

Google Analytics GA4

Estrae dati da Google Analytics 4.

• Credentials JSON file — Service account Google
• Property ID — ID proprietà GA4
• Start date / End date — Intervallo temporale
• Metrics — Metriche da estrarre (es. sessions, activeUsers)
• Dimensions — Dimensioni (es. country, pagePath)

Salesforce CRM

Connessione a Salesforce CRM per estrarre dati via SOQL.

• Username — Email utente Salesforce
• Password — Password
• Security Token — Token di sicurezza Salesforce
• Domain — Dominio (default: login, per sandbox: test)

Time Series

InfluxDB

Connessione a InfluxDB per dati di serie temporali.

• URL — URL del server InfluxDB (es. http://localhost:8086)
• Token — Token di autenticazione
• Organization — Nome organizzazione
• Bucket — Nome del bucket dati
• Verify SSL — Verifica certificato

Email e Database locale

Microsoft Outlook

Legge dati dalla casella di posta Outlook locale (contatti, email, calendario). Richiede Microsoft Outlook installato. Solo Windows.

Database Permanente (Locale)

Database SQLite integrato nell'applicazione per dataset persistenti senza sorgenti esterne.

• Database selection — Seleziona un database esistente o creane uno nuovo
• Import data — Importa dati da file Excel/CSV nel database permanente

Connettori generici

ODBC Generico

Connessione universale tramite driver ODBC a qualsiasi database compatibile. Ideale per sorgenti non coperte da connettori specifici.

• Connection mode — DSN (Data Source Name preconfigurato) o Driver + Parameters (connessione diretta)
• DSN — Nome DSN configurato nel sistema
• ODBC driver — Driver installato. Other... lista i driver disponibili
• Server / Database — Parametri di connessione
• Windows Authentication — Usa credenziali Windows
• RECOMMENDED: Use Read Uncommitted — Evita blocchi database
• Custom Query — Query SQL personalizzata

OLE DB Generico

Connessione tramite provider OLE DB. Solo Windows.

• Connection mode — Provider String (stringa di connessione) o Data Link File (.udl)
• OLE DB Provider — Provider installato (es. Microsoft.ACE.OLEDB.12.0)
• UDL file path — File Universal Data Link preconfigurato
• Credentials — Username/Password opzionali (sovrascrivono la stringa)
• Enable Database Performance Optimization — Read Uncommitted
• Custom Query — Query SQL personalizzata

JDBC Generico

Connessione tramite driver JDBC (Java). Richiede JRE installato.

• JRE path — Percorso all'installazione Java
• JAR file — File .jar del driver JDBC
• JDBC URL — URL di connessione JDBC (es. jdbc:mysql://host:3306/db)
• Driver class — Classe Java del driver
• Username / Password — Credenziali
• Custom Query — Query SQL personalizzata