BARCODERECOGNITION
La specifica riconoscere i codici a barre presenti in un PDF o file immagine e permette la creazione dei relativi PDF. In caso di creazione dei PDF e di più codice a barre presenti sulla pagina, la specifica rileverà un solo codice a barre
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| FILE | Stringa | ||||
| STRUTTURA | Stringa | ||||
| CREAPDF | Intero | ||||
| ATTIVAOCR | Intero | ||||
| DIRPDF | Stringa | ||||
| PREFISSO | Stringa | ||||
| FILTROBARCODE | Stringa | ||||
| ACCODA | Intero | 32.2 | |||
| ERRORE | Intero |
FILE
[NomePercorso] Indicare il nome e il percorso del file PDF o immagine che si desidera analizzare Le tipologie di immagini supportate sono:
- JPEG JPG
- TIF
- BMP
- PNG
- GIF NomePercorso: Variabile o costante di tipo stringa
STRUTTURA
[NomeStruttura] Contiene il nome della struttura dinamica definita a cura del programmatore. La specifica si aspetta all'interno le seguenti variabili: <tabella> Valore Tipo Descrizione ZBARCODE_PAG% Intero Numero della pagina nella quale è stato rilevato un codice a barre ZBARCODE_ORD% Intero Ordine di rilevamento del codice a barre all'interno della pagina ZBARCODE_TIP# Long Tipologia del codice a barre (vedere tabella sotto per la codifica dei valori) ZBARCODE_COD? Blob Decodifica del codice a barre rilevato ZBARCODE_PDF? Blob Restituisce il nome compreso di percorso del file PDF eventualmente creato e associato al codice a barre </tabella> La struttura potrà contenere anche altri campi, ma saranno ignorati dalla specifica. La variabile ZBARCODE_TIP# potrà contenere i seguenti valori: <tabella> Valore Descrizione 0 Tipo non riconosciuto 1 Industrial 2 di 5 2 Inverted 2 di 5 4 Interleaved 2 di 5 8 IATA 2 di 5 16 Matrix 2 di 5 32 Code 39 64 Codice a barre (generico) 128 Bcd Matrix 256 Data logic 2 di 5 4096 Code 128 8192 EAN 128 16384 Code 93 32768 EAN 13 65536 UPCA 131072 EAN8 262144 UPCE 524288 ADD5 1048576 ADD2 </tabella> NomeStruttura: Variabile o costante di tipo stringa
CREAPDF
[FlagCreaPDF] Il parametro permette di creare il/i PDF separati per codice a barre. Il nome file dei PDF creati sarà assegnato in automatico e corrisponderà alla decodifica del codice barre. Pertanto se il codice a barre decodificato sarà '0894567' il file si chiamerà '0894567.pdf'. Attivando il flag di creazione dei pdf, verrà rilevato un solo codice a barre per pagina. FlagCreaPDF: Variabile di tipo intero (0-No;1-Si)
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
ATTIVAOCR
[FlagOCR] Esegue il riconoscimento OCR del documento e crea un PDF di tipo ricercabile Questa operazione rallenta il processo di creazione dei PDF perché impiega 5 secondi circa per pagina. FlagOCR: Variabile di tipo intero (0-No;1-Si)
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
DIRPDF
[NomeCartella] Nome della cartella nella quale saranno creati i file PDF. NomeCartella: Variabile o costante di tipo stringa
PREFISSO
[Prefisso] Consente alla specifica di considerare solo i codici a barre che iniziano con una determinata serie di caratteri. Prefisso: Variabile o costante di tipo stringa
FILTROBARCODE
[FiltroBarcode] Consente di specificare la/le tipologie di codice a barre che devono essere presa in considerazione dalla specifica. I valori delle tipologie di codice vanno reperiti dalla tabella della variabile ZBARCODE_TIP. Se non indicato verranno considerate tutte le tipologie di codice a barre. NomeCartella: Variabile o costante di tipo stringa, i valori devono essere separati dal carattere virgola (,)
ACCODA
Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.
Errori
| Codice | Descrizione |
|---|---|
| 27500 | Non è stata definita la struttura dinamica { ex.StructName } destinata a contenere l'elenco dei codici a barre riconosciuti |
| 27501 | Si sono verificati dei problemi durante il riconoscimento OCR. Errore: {ex.Message} |
| 27502 | Si sono verificati dei problemi durante il caricamento dell'immagine: {ex.FileName}. Errore numero: {ex.CodError} |
| 27503 | Si sono verificati dei problemi durante il render dell'immagine da PDF. Errore numero: {ex.CodError} |
| 27504 | Pdf non trovato o in un formato non riconoscibile: {ex.FileName}. Errore: {ex.CodError}. |
| 27505 | Immagine non trovata o in un formato non riconoscibile: {ex.FileName} Errore: {ex.CodError}. |
| 27506 | Il tipo di filtro {ex.Filter} impostato per il codice a barre non è un codice valido |
| 27507 | '@BARCODERECOGNITION - Errore in fase di elaborazione dei file '{ex.FileName}'- {ex.Message} |
Esempi
Riconoscimento codice a barre
DIM structName[STRING] = "STR_BARCODE"
'@DEFDYNSTRUCT STRUTTURA[structName] _
CAMPI[ZBARCODE_PAG[4], _
ZBARCODE_ORD[3], _
ZBARCODE_TIP[6], _
ZBARCODE_COD?, _
ZBARCODE_PDF?] _
ERRORE
DIM fileOrigin[STRING]="\\NTSIST\F\TMP\TUTTI.PDF"
DIM folderPDF[STRING]="\\NTSIST\F\TMP\PDF"
DIM flPDF[INT]=0
DIM flOCR[INT]=0
'@BARCODERECOGNITION FILE[fileOrigin] _
STRUTTURA[structName] _
CREAPDF[flPDF] _
ATTIVAOCR[flOCR] _
DIRPDF[folderPDF]