Per ulteriori informazioni sui filtri in generale, vedere la sezione I filtri.
Usare questo filtro ogni volta che un trigger riceve dati non strutturati, come documenti e report esportati dal vecchio sistema, comunicazione intercettata tra i dispositivi e flusso di stampa catturato. Il filtro consente di estrarre singoli campi, campi in aree secondarie ripetibili e addirittura coppie name-value
.
Per esempi di dati di testo strutturati, vedere le sezioni Vecchi dati e File CSV composti e File binari.
Definizione della struttura
Gli elementi utilizzabili per configurare il filtro sono i seguenti:
-
Campo: specifica la posizione dei dati dei campi tra le posizioni all'inizio e alla fine del campo. Nella posizione del campo sono disponibili diverse opzioni, dall'hardcoding della posizione per attivare le posizioni relative. È necessario mappare i campi definiti sulle rispettive variabili nell'azione Usa filtro dati. Per ulteriori informazioni, vedere la sezione Definizione di campi.
-
Area secondaria: Specifica la posizione dei dati ripetibili. Ciascuna area secondaria definisce almeno un blocco di dati, il quale a sua volta contiene i dati per le etichette. Possono esserci aree secondarie definite all'interno di aree secondarie, le quali consentono di definire strutture complesse. È possibile definire i campi dall'interno di ciascun blocco di dati. È necessario mappare i campi definiti sulle rispettive variabili nell'azione Usa filtro dati. Per ciascuna area secondaria, Automationdefinisce un nuovo livello di segnaposto all'interno dell’azione Usa filtro dati, in modo tale da poter mappare le variabili sui campi di quel livello. Per ulteriori informazioni, vedere la sezione Definizione di aree secondarie.
-
Area di assegnazione: specifica la posizione dei dati ripetibili contenenti le coppie
name-value
. Automation legge simultaneamente i nomi di campo e i relativi valori. Automation esegue anche automaticamente la mappatura sulle variabili. Usare questa funzionalità per adattare il filtro ai dati di input mutevoli, eliminando il tempo di manutenzione. È possibile definire l'area di assegnazione nel livello principale del documento oppure all'interno dell'area secondaria. Per ulteriori informazioni, vedere la sezione Definizione di aree di assegnazione.
La sezione Anteprima dati semplifica la configurazione. Il risultato di una regola di filtro definita è evidenziato nell'area di anteprima insieme a ciascuna modifica della configurazione. Con ogni regola è possibile vedere quali elementi di dati sarebbero estratti con ciascuna regola.
I campi possono essere definiti nel livello principale come campi documento. I campi possono essere definiti all'interno di un blocco di dati. Le coppie nome-valore
possono essere definite all'interno dell'area di assegnazione.
Generale
Questa sezione definisce le proprietà generali del filtro dati non strutturato.
-
Nome: specifica il nome del filtro. Usare un nome descrittivo che identifichi il ruolo del filtro in una configurazione. È possibile modificarlo in qualsiasi momento.
-
Descrizione: consente di descrivere lo scopo di questo filtro. È possibile usarlo per scrivere una breve spiegazione sulle operazioni che il filtro può eseguire.
-
Codifica: specifica la codifica dei dati con i quali funziona questo filtro.
-
Ignora linee vuote nei blocchi dati: specifica di non generare errori se il filtro estrae valori di campo vuoti dai blocchi di dati.
Dopo aver definito un campo è necessario definirne il nome e le regole per estrarre i valori di campo dai dati. Quando viene eseguito il filtro, le regole di estrazione vengono applicate ai dati di input e il risultato viene assegnato al campo.
Proprietà campo
-
Nome: Specifica il nome univoco del campo.
-
Il campo ha dati binari: specifica che il campo contiene dati binari. Non attivare questa opzione a meno che non si preveda di ricevere dati binari.
Inizio campo
-
Posizione nel documento: la posizione hardcoded nei dati determina il punto iniziale/finale. L'origine della coordinata è l'angolo superiore sinistro. Il carattere nella posizione definita è incluso nei dati estratti.
-
Fine del documento: Il punto iniziale/finale si trova alla fine del documento. È anche possibile definire un offset dalla fine per il numero di righe e/o caratteri specificato.
-
Trova stringa dall'inizio del documento: la posizione della stringa ricercata definisce il punto iniziale/finale. Dopo che Automation trova la stringa desiderata, il carattere successivo determina il punto iniziale/finale. La stringa cercata non è inclusa nei dati estratti. Per la ricerca predefinita non vale la distinzione maiuscole/minuscole.
-
Avvia ricerca dalla posizione assoluta: È possibile definire la ricerca modificando la posizione iniziale dall'inizio dei dati (posizione 1,1) a un offset. Usare questa funzionalità per ignorare la ricerca all'inizio dei dati.
-
Occorrenza: Specifica quale occorrenza della stringa di ricerca dovrebbe venire cercata. Usare questa opzione se non si aspetta per impostare la posizione di avvio/interruzione dopo la prima stringa trovata.
-
Offset dalla stringa: specifica l'offset positivo o negativo dopo la stringa cercata.
Esempio 6. Esempio
È necessario definire l'offset per includere la stringa cercata nei dati estratti.
-
Fine campo
-
Posizione nel documento: la posizione hardcoded nei dati determina il punto iniziale/finale. L'origine della coordinata è l'angolo superiore sinistro. Il carattere nella posizione definita è incluso nei dati estratti.
-
Fine del documento: Il punto iniziale/finale si trova alla fine del documento. È anche possibile definire un offset dalla fine per il numero di righe e/o caratteri specificato.
-
Trova stringa dall'inizio del documento: la posizione della stringa ricercata definisce il punto iniziale/finale. Dopo che Automation trova la stringa desiderata, il carattere successivo determina il punto iniziale/finale. La stringa cercata non è inclusa nei dati estratti. Per la ricerca predefinita non vale la distinzione maiuscole/minuscole.
-
Avvia ricerca dalla posizione assoluta: È possibile definire la ricerca modificando la posizione iniziale dall'inizio dei dati (posizione 1,1) a un offset. Usare questa funzionalità per ignorare la ricerca all'inizio dei dati.
-
Occorrenza: Specifica quale occorrenza della stringa di ricerca dovrebbe venire cercata. Usare questa opzione se non si aspetta per impostare la posizione di avvio/interruzione dopo la prima stringa trovata.
-
Offset dalla stringa: specifica l'offset positivo o negativo dopo la stringa cercata.
Esempio 7. Esempio
È necessario definire l'offset per includere la stringa cercata nei dati estratti.
-
-
Trova stringa dopo l'inizio del campo: il punto finale di avvio/interruzione è definito dalla posizione della stringa cercata, come nell'opzione Trova stringa dall'inizio del documento, ma la ricerca inizia dopo la posizione iniziale del campo/area, non all'inizio dei dati.
-
Lunghezza: specifica la lunghezza dei dati nelle righe e/o nei caratteri. Il numero specificato di righe e/o caratteri sarà estratto dalla posizione iniziale.
-
Fine riga: imposta la configurazione per estrarre i dati dalla posizione iniziale fino alla fine della stessa riga. È possibile definire un offset negativo dalla fine della riga.
Opzioni di formattazione
Questa sezione definisce le funzioni di manipolazione delle stringe che si applicano alle variabili o ai campi selezionati. È possibile selezionare una o più funzioni. Queste funzioni si applicano nello stesso ordine selezionato nell’interfaccia utente: dall'alto verso il basso.
-
Elimina spazi all'inizio: Elimina tutti i caratteri spazio (codice decimale ASCII 32) dall'inizio di una stringa.
-
Elimina spazi alla fine: Elimina tutti i caratteri spazio (valore decimale ASCII 32) dalla fine di una stringa.
-
Elimina carattere di apertura e chiusura: Elimina la prima occorrenza dell'apertura selezionata e i caratteri di chiusura presenti in una stringa.
Esempio 8. Esempio
Se si usa "{" for opening character and "}" per il carattere di chiusura, la stringa di input
{{selection}}
viene convertita in{selection}
.
-
Cerca e sostituisci: Esegue la funzione di ricerca e sostituzione standard in base ai valori specificati per cerca e Sostituisci con. È anche possibile usare le espressioni regolari.
Nota
Esistono diverse implementazioni delle espressioni regolari in uso. usa la sintassi .NET Framework per le espressioni regolari. Per ulteriori informazioni, consultare la knowledge base articolo.
-
Sostituisce caratteri non stampabili con spazi: Sostituisce tutti i caratteri di controllo presenti nella stringa con il carattere spazio (codice decimale ASCII 32). I caratteri non stampabili sono caratteri con valori ASCII decimali compresi tra 0–31 e 127–159.
-
Elimina caratteri non stampabili: Elimina tutti i caratteri di controllo presenti nella stringa. I caratteri non stampabili sono caratteri con valori ASCII decimali compresi tra 0–31 e 127–159.
-
Decodifica caratteri speciali: i caratteri speciali (o codici di controllo) sono caratteri che non sono disponibili sulla tastiera, come Ritorno a capo o Avanzamento riga. usa una notazione per codificare caratteri in forma leggibile, come <CR> per Ritorno a capo e <LF> per Avanzamento riga. Per ulteriori informazioni, vedere la sezione Immissione dei caratteri speciali (codici di controllo).
Questa opzione converte i caratteri speciali dalla sintassi in caratteri binari veri e propri.
Esempio 9. Esempio
Quando si riceve la sequenza di dati "<CR><LF>", li usa come stringa normale da 8 caratteri. Attivare questa opzione per interpretare e usare i dati ricevuti come due caratteri binari
CR
(Ritorno a capo – codice ASCII 13) eLF
(Avanzamento riga – codice ASCII 10).
-
Cerca ed elimina tutto prima: Trova la stringa specificata ed elimina tutti i caratteri dall'inizio dei dati fino alla stringa. La stringa trovata può anche essere eliminata.
-
Cerca ed elimina tutto dopo: Trova la stringa specificata ed elimina tutti i caratteri dalla stringa fino alla fine dei dati. La stringa trovata può anche essere eliminata.
-
Cambia maiuscole/minuscole: Cambia tutti i caratteri nelle stringhe in maiuscolo o minuscolo.
Un'area secondaria è una sezione di dati che comprende diversi blocchi di dati identificati dalla stessa regola di estrazione. Ciascun blocco di dati fornisce i dati per una singola etichetta.
Tutti i blocchi di dati devono essere identificati dalla stessa regola di configurazione. Ciascun blocco di dati può contenere un'altra area secondaria. È possibile definire un numero di aree secondarie nidificate all'interno delle aree secondarie padre.
Se il filtro contiene la definizione di un'area secondaria, l'azione Usa filtro dati visualizza le aree secondarie con segnaposti nidificati. Tutte le azioni nidificate al di sotto del segnaposto vengono eseguite solo per i blocchi di dati a questo livello. È possibile stampare più etichette con i dati da diverse aree secondarie.
Configurazione di un'area secondaria
L'area secondaria è definita con regole simili a quelle dei singoli campi. Ciascuna area secondaria è definita dai seguenti parametri.
-
Nome area secondaria: Specifica il nome dell'area secondaria.
-
Blocchi di dati: specifica come identificare i blocchi di dati all'interno dell'area secondaria. Ciascuna area secondaria contiene almeno un blocco di dati. Ciascun blocco di dati fornisce i dati per una singola etichetta.
-
Ciascun blocco contiene un numero fisso di linee: Specifica che ciascun blocco di dati di un'area secondaria contiene il numero di linee fisso specificato. Usare questa opzione se si sa che ciascun blocco di dati contiene esattamente lo stesso numero di linee.
-
I blocchi iniziano con una stringa: Specifica che i blocchi di dati iniziano con la stringa specificata. Tutto il contenuto tra le due stringhe specificate appartiene a un blocco di dati separato. Il contenuto tra l'ultima stringa e la fine dei dati identifica l'ultimo blocco di dati.
-
I blocchi terminano con una stringa: Specifica che i blocchi di dati terminano con la stringa specificata. Tutto il contenuto tra le due stringhe specificate appartiene a un blocco di dati separato. Il contenuto tra l'inizio dei dati e la prima stringa identifica il primo blocco di dati.
-
I blocchi sono separati da una stringa: specifica che i blocchi di dati sono separati con la stringa di caratteri specificata. Tutto il contenuto tra le due stringhe selezionate appartiene a un blocco di dati separato.
-
-
Inizio del primo blocco di dati: specifica la posizione iniziale del primo blocco di dati. Allo stesso tempo, definisce la posizione iniziale dell'area secondaria. Di solito, la posizione iniziale è anche l'inizio dei dati ricevuti. I parametri di configurazione sono gli stessi usati per la definizione dei campi. Per ulteriori informazioni, vedere la sezione Definizione di campi.
-
Fine dell'ultimo blocco di dati: specifica la posizione finale dell'ultimo blocco di dati. Allo stesso tempo, definisce la posizione finale dell'area secondaria. Di solito, la posizione finale si trova alla fine dei dati ricevuti. I parametri di configurazione sono gli stessi usati per la definizione dei campi. Per ulteriori informazioni, vedere la sezione Definizione di campi.
Configurazione dei campi all'interno dell'area secondaria
I campi all'interno dell'area secondaria sono configurati usando gli stessi parametri dei campi definiti al livello principale. Per ulteriori informazioni, vedere la sezione Definizione di campi.
Nota
I numeri delle linee di campo si riferiscono alla posizione all'interno del blocco di dati, non alla posizione all'interno dei dati di input.
Anteprima dati
Questa sezione fornisce un’anteprima della definizione del campo. Se l'elemento definito è selezionato, l'anteprima ne evidenzia la posizione nei dati di anteprima.
-
Nome file anteprima: specifica il file che contiene i dati di esempio che saranno analizzati dal filtro. Il file di anteprima viene copiato dalla definizione filtro. Se si modifica il nome del file di anteprima, il nuovo nome di file viene salvato.
-
Apri: seleziona un altro file sul quale eseguire le regole del filtro.
-
Aggiorna: Riesegue le regole del filtro in base al contenuto del nome del file di anteprima. Automation aggiorna la sezione Anteprima dati con il risultato.
Il filtro Dati non strutturati identifica automaticamente i campi e i relativi valori nei dati ricevuti. In tal modo, la mappatura manuale variabile sul campo risulta non necessaria.
La funzionalità Struttura dinamica è utile se il trigger riceve i dati con la struttura mutevole. In questi casi, la struttura dei dati principali rimane invariata (ad esempio, i campi sono delimitati da una virgola), o mantiene la stessa struttura, ma cambia l’ordine e/o il numero dei campi. Potrebbero esserci nuovi campi o alcuni dei vecchi campi potrebbero non essere più disponibili. Poiché la Struttura dinamica è attivata, il filtro automatico identifica la struttura del file ricevuto. Allo stesso tempo, il filtro legge i nomi e i valori di campo (coppie name:value
) dai dati. Questo elimina la necessità di mappare manualmente i campi sulle variabili.
L’azione Usa filtro dati non offre possibilità di mappatura, in quanto esegue dinamicamente la mappatura. Non è nemmeno necessario definire le variabili di etichetta nella configurazione del trigger. L'azione assegna i valori di campo sulle variabili di etichetta con lo stesso nome, senza dover importare le variabili dall'etichetta. Tuttavia, questa regola si applica solo all'azione Stampa etichetta. Se si desidera usare i valori di campo in qualsiasi altra azione, è necessario definire le variabili nel trigger, mantenendo al tempo stesso la mappatura automatica variabile - sul - campo.
Nota
Se il campo disponibile nei dati di input non ha una variabile di etichetta corrispondente, non viene generato nessun errore. ignora silenziosamente le variabili mancanti.
Configurazione dell'area di assegnazione
L'area di assegnazione è configurata usando la stessa procedura dell'area secondaria. Per ulteriori informazioni, vedere la sezione Definizione di aree secondarie. L'area di assegnazione può essere definita nel livello di dati principale e appare una sola volta. Oppure, può essere configurata all'interno di un'area secondaria, in modo tale che venga eseguita per ciascun blocco di dati nell'area secondaria.
Configurazione dei campi nell'area di assegnazione
Quando si crea un’area di assegnazione, il filtro definisce automaticamente due segnaposti. Questi due segnaposti definiscono la coppia name:value
.
-
Nome variabile: specifica il campo il cui contenuto viene preso come nome di variabile (componente
name
in una coppia). Configurare il campo usando la stessa procedura dei campi del documento. Per ulteriori informazioni, vedere la sezione Definizione di campi. -
Valore variabile: specifica il campo il cui contenuto viene preso come nome di variabile (componente
value
in una coppia). Configurare il campo usando la stessa procedura dei campi del documento. Per ulteriori informazioni, vedere la sezione Definizione di campi.
Esempio
L'area tra ^XA e ^XZ è l'area di assegnazione. Ciascuna riga nell'area di assegnazione fornisce una coppia name:value
. Name è definito come valore tra il 6° carattere nella riga e nel carattere "uguale". Valore è definito come valore tra il carattere "uguale" e la fine della riga con offset negativo di tre caratteri
^XA ^FD01DonationHR=G095605 3412625^FS ^FD02DonationBC=DG0956053412625^FS ^FD03HospitalNoHR=HN060241^FS ^FD04HospitalNoBC=060241^FS ^FD05Surname=Hawley^FS ^FD07Forename=Annie^FS ^FD09Product=Blood^FS ^FD10PatientBlGp=O Rh +ve^FS ^FD11DoB=27 June 1947^FS ^FD12DateReqd=25 Dec 2012^FS ^XZ