Versione estesa – formato di importazione

Il capitolo seguente è valido solo per la versione estesa di WinPrice, e tratta del formato dei file di importazione di un listino.

Optional

Gli optional in WinPrice sono definiti da una serie di caratteristiche, tra cui:


Unità di misura può valere:


Tipo identifica quale delle caratteristiche della tipologia è presa come riferimento per calcolare il costo dell’optional: può essere ad esempio il costo della tipologia, oppure i metri quadri del vetro, o il costo della verniciatura del legno. Ognuno di questi tipi è associato a una particolare unità di misura: gli optional calcolati sul costo della tipologia sono in percentuale, quelli calcolati sui metri lineari dell’alluminio sono ovviamente al metro lineare. Ciò significa, in altri termini, che il campo valore è nel primo caso una percentuale che verrà moltiplicata per il costo della tipologia, e nel secondo caso un prezzo al metro lineare, che verrà moltiplicato per i metri di alluminio presenti nella tipologia.

Un Optional può anche essere “libero”: in questo caso, i valori della tipologia a cui l’optional è associato sono ignorati, e saranno viceversa specificati nel momento in cui l’optional sarà inserito. Ad esempio, è possibile inserire un optional libero al metro lineare, fornendo il costo al metro (come per ogni altro optional al metro lineare) e la lunghezza dell’optional, che verrà quindi utilizzata per effettuare il calcolo; questo tipo di situazione potrebbe ad esempio verificarsi per calcolare il prezzo di un tubolare aggiuntivo.


Calcolato può assumere uno dei seguenti valori:


Data una tipologia, definiamo:

Costo1: il costo della tipologia

Costo2: il costo della tipologia + somma dei costi di tutti gli optional di tipo 1 associati alla tipologia


Se un optional è calcolato in percentuale:


Allo stesso modo, possiamo definire:

Mq1: I metri quadri totali della tipologia

Mq2: I metri quadri della tipologia + somma dei mq di tutti gli optional di tipo 1 associati alla tipologia.


Se un optional è calcolato al mq:


Ovviamente, possiamo ripetere lo stesso procedimento per una qualsiasi delle altre unità di misura possibili.


Infine, gli optional di tipo 2 aggiungono il loro costo e sottraggono quello del vetro.

Formato file listino per importazione in WinPrice


La procedura più semplice per generare un file di importazione per WinPrice può essere riassunta nei seguenti passi:

  1. Creare un file excel

  2. Creare al suo interno 4 fogli diversi, come descritto in seguito, e riempirli, riga per riga, con i dati per le tipologie e gli optional. Attenzione:

    1. Non inserire righe di commento

    2. Non inserire righe vuote

    3. Inserire i valori in ogni caso: inserire ‘0’ se richiesto, oppure il valore della misura anche se uguale a quello della riga precedente. Una casella vuota non equivale a quanto descritto sopra.

  3. Esportare il file in formato “csv”. Per default, excel crea un file di tante righe con in campi separati da “;”. Questo formato andrà bene: se dovesse essere definito un formato diverso per l’esportazione, cambiare per adeguarlo a quanto sopra definito.



1. Foglio delle Tipologie


A

B

C

D

E

F

G

Nome della serie

Soluzione

Nome tipologia

L

H

Prezzo senza vetro

Prezzo totale


H

I

J

K

Prezzo colore alluminio

Prezzo colore legno

Prezzo colore pvc o altro

Prezzo colore accessori



L

M

N

O

P

Q

R

S

T

Prezzo alluminio al kg

Prezzo legno al kg

Prezzo pvc o altro al kg

Prezzo alluminio al ml

Prezzo legno al ml

Prezzo pvc o altro al ml

mq

Costo vetro

Mq vetro


U

V

W

X

Y

Z

Peso alluminio

Peso legno

Peso pvc o altro

Ml alluminio

Ml legno

Ml pvc o altro


AA

AB

AC

AD

AE

AF

Uw_u

Uw_d

Descrizione vetro

Ridimens. immagine

Descrizione tipologia

Gruppo


È importante che le varie misure per la stessa coppia serie/tipologia siano in ordine (prima la misura in larghezza più piccola con le varie altezze in ordine crescente, poi la seconda larghezza con lo stesso ordine per le altezze, e così via).

I valori alle lettere A, B, C, D, E, G, R sono necessari; inoltre è preferibile che S sia presente: gli altri possono essere anche zero. In tal caso, ogni optional calcolato su tale misura risulterà a sua volta a prezzo zero.

Importante: Fino alla versione 1.2.x, le ultime colonne erano nell’ordine seguente:


AA

AB

AC

AD

AE

AF

Ridimens. immagine

Uw_u

Uw_d

Descrizione tipologia

Gruppo

Descrizione vetro


2. Foglio dell’elenco Optional


A

B

C

D

E

F

G

H

I

Optional

Tipo

Valore

Calcolato

Quantità

Scontato

Default

Nascosto

Non esportare


Tipo può avere uno dei seguenti valori, indicante il modo in cui l’optional verrà calcolato:

Valore da inserire

Descrizione

totalCostWG

Prezzo della tipologia senza vetro

totalCost

Prezzo della tipologia

alluminiumColor

Prezzo colore alluminio

woodColor

Prezzo colore legno

otherColor

Prezzo colore pvc o altro

accColor

Prezzo colore accessory

alluminiumKgCost

Prezzo alluminio al kg

woodKgCost

Prezzo legno al kg

otherKgCost

Prezzo pvc o altro al kg

alluminiumMlCost

Prezzo alluminio al ml

woodMlCost

Prezzo legno al ml

otherMlCost

Prezzo pvc o altro al ml

Mq

Mq tipologia

glassesCost

Prezzo del vetro

glassesMq,

Mq vetro

alluminiumKg

Kg alluminio

woodKg

Kg legno

otherKg

Kg pvc o altro

alluminiumMl

Ml alluminio

woodM

Ml legno

otherMl

Ml pvc o altro

freeMlW

Optional libero al ml legno

freeMlA

Optional libero al ml alluminio

freeMlO

Optional libero al ml pvc o altro

freeKgW

Optional libero per Kg legno

freeKgA

Optional libero per Kg alluminio

freeKgO

Optional libero per Kg pvc o altro

freePz

Optional libero al pezzo

freeMq

Optional libero al mq

freeL

Optional libero in larghezza

freeH

Optional libero in altezza


Valore è il valore dell’optional (prezzo, percentuale, metri, ecc, a seconda dell’unità di misura).


Calcolato può assumere uno dei seguenti valori:

(vedi il paragrafo Optional per una spiegazione).



Scontato può essere 0 (l’optional sarà calcolato al netto) o diverso da 0 (sull’optional verrà applicato lo sconto della tipologia).


Default se diverso da 0, l’optional verrà aggiunto automaticamente all’atto dell’inserimento di una tipologia, purché risponda a determinate condizioni (colore, ecc); se 0, potrà essere aggiunto su richiesta

Nascosto se 0, l’optional verrà visualizzato normalmente; se diverso da 0, il suo costo verrà aggiunto al costo della tipologia

Non esportare se 0, l’optional verrà esportato normalmente in caso di esportazione del listino; se diverso da 0, non verrà esportato

Quantità quantità dell’optional

3. Foglio delle associazioni Optional-Serie


A

B

C

D

Optional

Serie

Valore

S


Valore può valere “-“, nel qual caso viene ricopiato quello inserito nella prima tabella.

4. Foglio delle associazioni Optional-Misure


A

B

C

D

Optional

Misura L

Misura H

Valore



5. Foglio delle associazioni Optional-Finiture


A

B

C

D

Optional

Finitura

E/I

Valore


Importante: fino alla versione 1.2.x, la colonna “C” conteneva “Esterna” o “interna”

6. Foglio delle associazioni Colori-Tipo Listino


A

B

C

E/I/A

Finitura

Id del tipo listino

Traduzioni

Selezionare la lingua in cui si vuole tradurre ed esportare il listino. A questo punto, è possibile importare il documento prodotto (“prices.txt”) in excel. Per far questo, aprire il file da excel usando la modalità “Testo delimitato da tabulazioni”. Attenzione inoltre che la codifica per l’importazione sia Unicode (UTF-8).

Il file a questo punto dovrebbe mostrarsi su tre colonne: codice, descrizione in italiano, descrizione in lingua. L’ultima colonna, se la lingua è stata appena aggiunta in WinPrice, potrebbe essere vuota; viceversa, dovrebbe contenere la descrizione degli elementi precedentemente tradotti.

Modificare o inserire ex-novo le traduzioni delle descrizioni nella terza colonna, avendo cura di non modificare le rimanenti due. Nelle descrizioni inserite, fare attenzione a:


Una volta terminata la traduzione, esportare di nuovo il file da excel in formato “Testo delimitato da tabulazioni”