Formato versione Revisione del 15/02/2005

Transcript

1 Pagina: 1 di 1 Formato versione Revisione del 15/02/2005 Sommario Sommario Introduzione Convenzioni utilizzate nei file di esportazione ISS Descrizione dei tipi di dati utilizzati nei campi File azienda File prodotti File specifiche File formule Campi codificati Denominazione dei files e loro invio Esempi Note...11

2 Pagina: 2 di 2 1. Introduzione Il seguente documento contiene le istruzioni per la creazione di un file di esportazione in formato ASCII COMMA DELIMITED in alternativa all utilizzo del software di compilazione ISS formula fornito dall Istituto superiore di sanità. 1.1 Convenzioni utilizzate nei file di esportazione ISS Ogni linea è un record e deve essere terminata dalla sequenza di caratteri CR-LF (CARRIAGE RETURN ed LINE FEED riga, ASCII 13 e 10). I campi marcati con un asterisco (*) nelle tabelle di descrizione sotto riportate compongono la chiave primaria del record. I campi di tipo String devono utilizzare il set di caratteri MS Windows ANSI (Code Page 1252). Per i campi numerici: o Si deve usare il punto (.) come separatore decimale. Non è ammesso il separatore delle migliaia. o il segno, se presente, deve precedere immediatamente il numero. Il segno positivo è opzionale, quello negativo obbligatorio. o Se un campo numerico inizia con uno o più zeri, questi sono ignorati in fase di lettura del campo. Corretto: Errato: 1,23 1, Ogni campo deve essere separato da una virgola (,) Tutti i campi devono essere racchiusi da doppi apici ( ). Le lunghezza indicate per i campi sono lunghezza massime e includono il punto decimale nel caso di valori numerici non interi e il segno negativo. E inutile e sconsigliato aggiungere spazi alla fine dei campi. I campi non utilizzati devono essere lasciati vuoti. Un campo vuoto è rappresentato dalla sequenza (doppio apice, doppio apice). Se non è né il primo né l ultimo, il campo vuoto può essere rappresentato da nessun carattere, ad esempio, CODICE,, EINECS indica: un campo vuoto, un campo con valore CODICE, un campo vuoto ed uno con valore EINECS.

3 Pagina: 3 di 3 Un record non può contenere caratteri di ritorno a capo. Il doppio apice non è ammesso. E necessario utilizzare invece l apice singolo. I campi di tipo boolean possono assumere il valore 1 per VERO e 0 per FALSO.Devono, inoltre, essere racchiusi tra doppi apici. Informazioni riguardanti la gestione dei vari casi di dichiarazione possibile sono ottenibili tramite il manuale d uso del programma ISS Formula, i files generati dal programma stesso e le note esplicative presenti sul sito web dell ISS 1.2 Descrizione dei tipi di dati utilizzati nei campi Tipo Descrizione Boolean Un stringa contenente 1 per VERO e 0 per FALSO Date Una Stringa di dieci caratteri in formato (GG/MM/AAAA). String Una sequenza di caratteri MS Windows ANSI (Code Page 1252). I doppi apici ( ) devono essere convertiti nella sequenza \ o in un carattere diverso; I codici dei prodotti e dei clienti devono essere esclusivamente alfanumerici. Long Un numero intero lungo, compreso nell intervallo -2,147,483, ,147,483,647 Integer Un numero intero corto, compreso nell intervallo -32, ,767 Single 3.4x x Double Un numero con virgola con 15 cifre di precisione, compreso nell intervallo 1.7 x x ATTENZIONE: I nomi dei campi in grassetto indicano i campi obbligatori; questi campi non possono essere lasciati bianchi. I campi indicati con un * sono quelli facenti parte della chiave primaria della tabella. I possibili contenuti dei campi codificati sono elencati nella tabella alla fine di questo documento. ATTENZIONE: durante la creazione di preparati/sostanze non è permesso l uso del prefisso ISS per i codici. Questo prefisso è riservato solo per le sostanze ufficiali.se create preparati/sostanze usando tale prefisso,i preparati/sostanze verranno rifiutati dal database durante le procedure di caricamento. 2. File azienda Informazioni anagrafiche dell azienda che effettua la dichiarazione. Deve essere trasmesso uno ed un solo record azienda. # Campo Descrizione Tipo Lun

4 Pagina: 4 di 4 0 CODE* Codice dell azienda String 16 1 NAME Ragione sociale String ADDRESS Indirizzo String 50 3 TOWN Città String 30 4 POSTAL_CODE CAP String 10 5 PROVINCE Provincia String 30 6 COUNTRY Nazione String 20 7 PERSON Persona da contattare String 30 8 PHONE Telefono/ fax String Indirizzo di posta elettronica String LANGUAGE Lingua preferita per i messaggi ricevuti via .1 per Inglese, 0 per Italiano. Boolean 1 NB: Se il campo LANGUAGE non è presente nel file l idioma di default è Italiano. 3. File prodotti Informazioni anagrafiche dei preparati dichiarati e delle sostanze contenure nei suddetti preparati. E vietato l utilizzo di codici preparato o sostanza che inizino con il prefisso ISS. Campo Descrizione Tipo Lun 0 CODE* Codice dell azienda String 16 1 PCODE* Codice del preparato/sostanza String 20 2 NAME Nome del preparato/sostanza String TYPE Preparato o sostanza? *** String 2 CAMPO CODIFICATO *** 4 CAS Numero CAS (formato libero). Obbligatorio String 20 nel caso di sostanze; utilizzare ND se non si dispone di numero CAS. 5 EINECS Numero Einecs nel formato String 20 6 INDEX Numero Index nel formato String 20 7 SUPP_COMPANY_CODE Codice azienda del fornitore String 16 (obbligatorio solo in caso di acquisto da fornitore) 8 SUPP_PCODE Codice prodotto attribuito dal fornitore String 20 (obbligatorio solo in caso di acquisto da fornitore) 9 SUPP_NAME Ragione sociale del fornitore String 100 (obbligatorio solo in caso acquisto da fornitore) 10 DANGER Uguale 1 se pericoloso, altrimenti 0 se non pericoloso Boolean 1

5 Pagina: 5 di 5 4. File specifiche Dichiarazioni dei preparati. Per ogni record specifiche deve esistere un corrispondente record prodotti con la medesima chiave (CODE, PCODE) # Campo Descrizione Tipo Lun 0 CODE* Codice dell azienda String 16 1 PCODE * Codice del preparato String 20 2 SYNONYM1 Eventuali altre denominazioni commerciali String SYNONYM2 Eventuali altre denominazioni commerciali String SYNONYM3 Eventuali altre denominazioni commerciali String MFG_TYPE Produttore, importatore o distributore? String 2 *** CAMPO CODIFICATO *** 6 PHISYCAL Stato fisico *** CAMPO CODIFICATO *** String 2 7 ODOR Odore String COLOR Colore String 50 9 PH Ph Single 5 10 CONCENTRATION Concentrazione Single 6 11 PH_USAGE Ph in uso Single 5 12 PACKAGE Imballaggio String DATE Data di compilazione (GG/MM/AAAA) Date COMPANY_LABEL Nome del fabbricante (comunitario, extracomunitario String nome originale del prodotto) 15 ON_SALE Uguale a 1 se preparato e' attualmente immesso sul mercato, altrimenti uguale a 0 Boolean 1 16 TYPE (1) Tipo del preparato *** CAMPO CODIFICATO String 255 *** 17 USAGE (1) Impiego/destinazione *** CAMPO CODIFICATO String 20 *** 18 FATHER (2) Codice di riferimento ad un altro preparato String OTHER_TYPE Tipo del preparato nel caso non sia incluso nella String 50 codifica del campo TYPE 20 OTHER_PHISYCAL Stato fisico nel caso non sia incluso nella codifica del String 20 campo PHISYCAL 21 SOLD_OUT_DATE Ultima data di fabbricazione del prodotto (GG/MM/AAAA) Date RELEASE_TO_MARKET_DATE Data del prodotto per essere rilasciata sul marcato (GG/MM/AAAA) Date 10 (1) I campi TYPE e USAGE della tabella SPECIFICHE possono contenere più di un valore in una stringa. Essi devono essere separati dal carattere ; (punto e vigola). Inoltre, lo stesso carattere di separazione dev essere utilizzato all inizio e alla fine della stringa. Esempi: ;DO; ;DO;IN; ;H03;A01;G04;

6 Pagina: 6 di 6 (2) E possibile effettuare una dichiarazione di un preparato tramite il riferimento ad un altra dichiarazione mediante l utilizzo del campo FATHER. Nel caso il preparato avesse le stesse caratteristiche di un altro preparato già presente nel database, allora il campo Father potrebbe contenere il codice di questo ultimo, evitando cosi di dover reinserire gli stessi dati. In questo caso gli unici campi da compilare sono: Nella tabella specifiche FATHER CODE ( codice azienda ) PCODE ( codice preparato ) DATE ( data di compilazione ) SOLD_OUT_DATE ( facoltativo ) Nella tabella prodotti CODE ( codice azienda ) PCODE ( codice preparato ) NAME ( nome del prodotto ) Nella tabella formula Nessun record 5. File formule Composizione dei preparati dichiarati. Ogni record rappresenta un componente di una formula. Tutti i componenti di una formula devono essere trasferiti insieme, ordinati per codice preparato PCODE. Per ogni valore di CODE,PCODE nel record formule deve esistere un corrispondente record prodotti e specifiche con la medesima chiave (CODE, PCODE) Per ogni valore di CODE,COMP_CODE nel record formule deve esistere un corrispondente record prodotti con la medesima chiave (CODE, COMP_CODE) # Campo Descrizione Tipo Lun 1 CODE* Codice della azienda String 16 2 PCODE* Codice del preparato String 16 3 COUNTER* Numero sequenziale dei componenti Integer 4 4 COMP_CODE Codice del componente String 16 5 QTY_RANGE (1) Intervallo di percentuale *** CAMPO CODIFICATO *** Integer 1 6 QTY (1) Percentuale esatta Double 6 I campi QTY_RANGE e QTY della tabella formula non devono essere compilati insieme. Se QTY_RANGE contiene un valore allora QTY deve essere lasciato vuoto, o vice versa.

7 Pagina: 7 di 7 6. Campi codificati Campo Codice (dominio) Descrizione Tabella formula QTY_RANGE 0 0%-1% QTY_RANGE 1 1% - 5% QTY_RANGE 2 5% - 10% QTY_RANGE 3 10% - 20% QTY_RANGE 4 20% - 30% QTY_RANGE 5 30% - 50% QTY_RANGE 6 50% - 75% QTY_RANGE 7 75% - 100% Tabella prodotti TYPE PR Preparato TYPE SU Sostanza Tabella specifiche MFG_TYPE DI Distributore MFG_TYPE IM Importatore MFG_TYPE PR Produttore PHYSICAL AE Aerosol PHYSICAL GA Gassoso PHYSICAL LI Liquido PHYSICAL SO Solido TYPE A01 Chimica TYPE A02 Farmaceutica TYPE A03 Conciara TYPE A04 Siderurgica TYPE A05 Elettrotecnica/elettronica TYPE A06 Alimentare TYPE A07 Cosmetica TYPE A08 Cartaria TYPE A09 Tessile TYPE A10 Metalmeccanica TYPE A11 Galvanica TYPE A12 Ceramica TYPE A13 Plastica TYPE A14 Diagnostici in vitro TYPE A15 Lubrificanti TYPE B00 Per pulizie/manutenzione TYPE B01 Prodotti per calzature e pelli TYPE B02 Pulitori per vetri e specchi

8 Pagina: 8 di 8 TYPE B03 Pulitori per WC e sanitari TYPE B04 Pulitori per forno TYPE B05 Smacchiatori per tessuti TYPE B06 Appretti TYPE B07 Prodotti per auto TYPE B08 Pulitori per metallo TYPE B09 Cere per pavimenti TYPE B10 Pulitori per mobili TYPE B11 Deodoranti per ambienti TYPE B12 Disgorganti TYPE B13 Coloranti domestici TYPE B14 Pulitori per moquette/tessuti TYPE B15 Prodotti per piante ornamentali TYPE C00 Fertilizzanti TYPE C01 Concimi minerali TYPE C02 Specialistici TYPE C03 Organo-minerali e organici TYPE D00 Adesivi e sigillanti TYPE D01 Per calzature TYPE D02 Per mobili e legno TYPE D03 Per mezzi di trasporto TYPE D04 Per cartotecnica e imballaggio TYPE D05 Per sigillanti e edilizia TYPE E00 Per pitture e vernici TYPE E01 Per carrozzeria TYPE E02 Per mobili legno TYPE E03 Per marina/nautica TYPE E04 Per segnaletica stradale TYPE E05 Sverniciatori TYPE E06 Per industria/ferro/plastica TYPE E07 Anticorrossione TYPE E08 Per edilizia TYPE E09 Diluenti/solventi TYPE F00 Detergenti TYPE F01 Bucato a mano TYPE F02 Lavaggio stoviglie a mano TYPE F03 Indumenti fini( a mano e lavatrice ) TYPE F04 Abrasivi TYPE F05 Ammorbidenti TYPE F06 Sbiancanti/candeggianti TYPE F07 Bucato in lavatrice TYPE F08 Lavaggio stoviglie a macchina TYPE F09 Superficie dure TYPE F10 Anticalcare/addolcitori

9 Pagina: 9 di 9 TYPE F12 Brillantanti TYPE F13 Saponi da bucato TYPE G00 Disinfettanti TYPE G01 Uso ambientale generale TYPE G02 Detergenti non personali TYPE G03 Uso specifico non personale TYPE G04 Per piccole ferite TYPE H00 Inchiostri TYPE H01 Offset TYPE H02 Rotocalco edizioni TYPE H03 UV TYPE H04 Ausiliari per stampa TYPE H05 Roto-flessografici TYPE H06 Nero giornali TYPE H07 Serigrafici TYPE H08 Diluenti/solventi TYPE I00 Biocidi TYPE I01 Biocidi per l'igiene umana TYPE I02 Disinfettanti per aree private e aree sanitarie pubbliche ed altri biocidi TYPE I03 Biocidi per l'igiene veterinaria TYPE I04 Disinfettanti nel settore dell'alimentazione umana e animale TYPE I05 Disinfettanti per l'acqua potabile TYPE I06 Preservanti per prodotti in scatola TYPE I07 Preservanti per pellicole TYPE I08 Preservanti del legno TYPE I09 Preservanti per fibre, cuoio, gomma e materiali polimerizzati TYPE I10 Preservanti per lavori in muratura TYPE I11 Preservanti per liquidi nei sistemi di raffreddamento e trattamento industriale TYPE I12 Preservanti contro la formazione di sostanze viscide (slimicidi) TYPE I13 Preservanti per fluidi nella lavorazione di metalli TYPE I14 Rodenticidi TYPE I15 Avicidi TYPE I16 Molluschicidi TYPE I17 Pescicidi TYPE I18 Insetticidi, acaricidi e prodotti destinati al controllo degli altri artropodi TYPE I19 Repellenti e attrattivi

10 Pagina: 10 di 10 TYPE I20 Preservanti per alimenti destinati al consumo umano o animale TYPE I21 Prodotti antincrostazione TYPE I22 Fluidi usati nell'imbalsamazione e nella tassidermia TYPE I23 Controllo di altri vertebrati USAGE DO Domestico USAGE IN Professionale 7. Denominazione dei files e loro invio I quattro files da trasmettere devono essere inviati all ISS con una nominazione ben precisa e trasmessi all interno di un unico file.zip. Il nome di ogni file è composto da un lettera che dipende dal tipo di file, un numero sequenziale di 7 cifre e l estensione.csv (X CSV). Ad ogni invio deve essere assegnato un numero sequenziale incrementale, partendo da I tipi di file con il rispettivo nome sono: File Azienda: File Prodotti: File Specifiche: File Formule: C CSV P CSV S CSV F CSV Il file.zip dovrà utilizzare la lettera Z e lo stesso numero sequenziale (Z ZIP). Esempio: Il primo invio verrà fatto con il file Z ZIP contenente i files: C CSV F CSV P CSV S CSV Il secondo invio verrà fatto con il file Z ZIP contenente i files: C CSV F CSV P CSV S CSV Quindi, tutti I successivi invii verranno trasmessi allo stesso modo con un numero sequenziale. Primo record di ogni file

11 Pagina: 11 di 11 Il primo record di ogni file deve contenere una intestazione nel formato TIPO+VERSIONE, dove TIPO e una stringa che specifica quale tabella e presente nel file e VERSIONE una stringa contenente un valore numero intero a 4 cifre specificando la versione del formato del database (attualmente 0100). I possibili valori di TIPO sono: File Azienda: COMPANY File Prodotti: PRODUCT File Specifiche: SPECIFICATION File Formule: FORMULA Esempio di file azienda C CSV: COMPANY, 0100 "IT ","Alfa Beta Gamma","V.Molise 5","Milano","20139","MI","Italia","Andre' Girardi"," ", per indicare che il file contiene la tabella COMPANY con database del formato versione Esempi Esempi di files per la trasmissione possono essere generati tramite il programma ISS Formula. 10. Note Le informazioni fornite in questo documento sono accurate al momento della stesura dello stesso. ISS si riserva il diritto di aggiungere in futuro nuove tabelle, nuovi campi, o di modificare il significato di quelli esistenti per migliorare le caratteristiche e le funzioni del software ISS Formula. Questo documento sostituisce qualunque edizione precedente.