La Barra Obiettivi è un sistema di visualizzazione che mostra il progresso verso uno o più obiettivi commerciali all’interno della vista catalogo. Gli obiettivi possono essere generati automaticamente dal sistema oppure definiti esplicitamente tramite configurazione.
Parametri Principali
BARRA_OBIETTIVI (0/1, default: non attivo)
Attiva o disattiva la visualizzazione della barra obiettivi. Quando impostato a “0”, la barra viene esplicitamente disabilitata indipendentemente dagli altri parametri.
BARRA_OBIETTIVI_AUTOMATICI (0/1, default: 1)
Abilita la generazione automatica degli obiettivi basati su parametri aziendali come minimo imponibile, spese di spedizione gratuite e sconti progressivi.
BARRA_OBIETTIVI_RICARICA_SEMPRE (0/1, default: 0)
Forza il ricalcolo degli obiettivi ad ogni caricamento, utile per obiettivi variabili o basati su canvas dinamici.
Parametri Visivi
BARRA_OBIETTIVI_COLORE_MIN (uint)
Colore iniziale della barra quando il progresso è minimo (default: 0xBBBBCC).
BARRA_OBIETTIVI_COLORE_MAX (uint)
Colore finale della barra quando il progresso è massimo (default: 0x8888FF). Il colore viene interpolato linearmente in base alla percentuale di completamento.
Parametri di Calcolo
BARRA_OBIETTIVI_PATTERN_ORDINE (pattern, default: “[tots]”)
Pattern per calcolare il valore corrente basato sui dati del documento ordine. Il valore di default “[tots]” rappresenta il totale scontato della merce.
BARRA_OBIETTIVI_PATTERN_RIGHE (pattern)
Pattern alternativo per calcolare il valore corrente sommando i valori delle singole righe d’ordine.
Parametri per Obiettivi Espliciti
BARRA_OBIETTIVI_ELENCO (pattern)
Definisce esplicitamente l’elenco degli obiettivi. Il parametro viene prima valutato come pattern sull’ordine, poi interpretato nel formato: valore1;testo1;testoRaggiunto1;icona1|valore2;testo2;testoRaggiunto2;icona2
Modalità Automatica
Quando BARRA_OBIETTIVI_AUTOMATICI è attivo (valore predefinito), il sistema genera automaticamente obiettivi basandosi su:
1. Minimo Imponibile Ordine
Se configurato nell’anagrafica cliente, viene creato un obiettivo per raggiungere l’importo minimo d’ordine.
Esempio pratico:
- Cliente con minimo imponibile: €500
- Ordine corrente: €350
- Visualizzazione: “Aggiungi ancora €150 per raggiungere il minimo d’ordine”
2. Spese di Spedizione Gratuite
Se configurato un gestore spese spedizione con soglia gratuita, viene creato un obiettivo corrispondente.
Esempio pratico:
- Soglia spedizione gratuita: €100
- Ordine corrente: €75
- Visualizzazione: “Aggiungi €25 per la spedizione gratuita”
3. Sconti Progressivi
Il sistema integra automaticamente gli obiettivi definiti nel GestoreScontoRiga, che possono rappresentare sconti a scalare in base all’importo.
Esempio pratico:
- Sconto 5% oltre €200
- Sconto 10% oltre €500
- Sconto 15% oltre €1000
- Ordine corrente: €450
- Visualizzazione: “Aggiungi €50 per ottenere il 10% di sconto”
Modalità Esplicita
Gli obiettivi possono essere definiti manualmente tramite il parametro BARRA_OBIETTIVI_ELENCO.
Formato Base
valore1;testoObiettivo1;testoRaggiunto1;icona1|valore2;testoObiettivo2;testoRaggiunto2;icona2
Esempio 1: Obiettivi Commerciali Fissi
300;Raggiungi €300 per il primo sconto;Sconto base attivo!;categoriesconti.png|
600;Raggiungi €600 per lo sconto intermedio;Sconto intermedio attivo!;categoriesconti.png|
1000;Raggiungi €1000 per lo sconto massimo;Sconto massimo attivo!;categoriesconti.png
Comportamento:
- Con ordine di €250: mostra “Raggiungi €300 per il primo sconto”, barra al 83%
- Con ordine di €450: mostra “Raggiungi €600 per lo sconto intermedio”, barra al 75%
- Con ordine di €1200: mostra “Sconto massimo attivo!”, barra al 100%
Esempio 2: Obiettivi con pattern ricavati da cliente
Il parametro supporta pattern che vengono valutati dinamicamente sull’ordine corrente, se ad esempio avessimo nel campo libero 3 del cliente un valore obiettivo per avere degli omaggi alla consegna potremmo avere:
[cam3];Bonus omaggio: ancora [barra_mancante];Bonus omaggio raggiunto!;categoriecarrello.png
Placeholder disponibili:
[barra_mancante]: importo mancante al raggiungimento dell’obiettivo[barra_percentuale]: percentuale di completamento dell’obiettivo corrente- Pattern ordine: tutti i pattern supportati dal GestoreDescrizioni per l’ordine
Esempio 3: Obiettivi Stagionali
500;Promozione primavera: [barra_mancante] a €500;Promozione primavera sbloccata!;categoriesnew.png|
1500;Bonus estate: al [barra_percentuale]%;Bonus estate conquistato!;categoriesconti.png
Calcolo del Valore Corrente
Il sistema supporta due modalità per calcolare il progresso verso gli obiettivi:
Pattern sull’Ordine (default)
Usa BARRA_OBIETTIVI_PATTERN_ORDINE per calcolare il valore basandosi sui totali del documento:
BARRA_OBIETTIVI_PATTERN_ORDINE = [tots]
Calcola il totale scontato della merce (comportamento predefinito).
BARRA_OBIETTIVI_PATTERN_ORDINE = [tota]
Calcola il totale lordo prima degli sconti.
BARRA_OBIETTIVI_PATTERN_ORDINE = [tots]+[spese]
Somma totale scontato e spese accessorie.
Pattern sulle Righe
Usa BARRA_OBIETTIVI_PATTERN_RIGHE per sommare un valore calcolato per ogni riga:
BARRA_OBIETTIVI_PATTERN_RIGHE = [qta]*[prezzo]
Somma i totali di riga al lordo.
BARRA_OBIETTIVI_PATTERN_RIGHE = [tots]
Somma i totali scontati di ogni riga.
Esempi Completi di Configurazione
Configurazione 1: Solo Automatici
BARRA_OBIETTIVI = 1
BARRA_OBIETTIVI_AUTOMATICI = 1
BARRA_OBIETTIVI_PATTERN_ORDINE = [tots]
Genera automaticamente obiettivi da minimo imponibile, spese spedizione e sconti configurati.
Configurazione 2: Spedizione gestita manualmente e obiettivo VIP
BARRA_OBIETTIVI = 1
BARRA_OBIETTIVI_AUTOMATICI = 0
BARRA_OBIETTIVI_ELENCO = 200;Mancano [barra_mancante] alla spedizione gratuita;Spedizione gratuita raggiunta!;tentatavendita.png|2000;Obiettivo VIP: [barra_mancante];Cliente VIP!;categoriespeciali.png
Specifica manualmente le spese di spedizione (disattivando quindi gli obiettivi automatici) e un secondo obiettivo “vip” con icona stella.
Configurazione 4: Pattern Personalizzato su Righe
BARRA_OBIETTIVI = 1
BARRA_OBIETTIVI_AUTOMATICI = 0
BARRA_OBIETTIVI_PATTERN_RIGHE = [qtyo]
BARRA_OBIETTIVI_ELENCO = 10;Ordina 10 pezzi;10 pezzi ordinati!;categoriespeciali.png|
25;Ordina 25 pezzi;25 pezzi ordinati!;categoriespeciali.png|
50;Ordina 50 pezzi;50 pezzi ordinati!;categoriespeciali.png
Obiettivi basati sul numero di pezzi degli articoli ordinati invece che sull’importo.
Note Tecniche
Cache e Ricaricamento
Con BARRA_OBIETTIVI_RICARICA_SEMPRE = 0 (default), gli obiettivi vengono calcolati una sola volta. Impostando il parametro a 1, vengono ricalcolati ad ogni visualizzazione, necessario per obiettivi che cambiano dinamicamente.