Anveo EDI Connect / Config / Mappings / Lettura e scrittura dei dati della tabella
Questa è una traduzione automatica. Il messaggio originale è disponibile in Inglese.

Lettura e scrittura dei dati della tabella

È importante notare che si può accedere alle colonne di quell’istanza di tabella solo dalle righe di mapping che sono figlie dell’istanza di tabella. L’indentazione delle righe della tabella deve quindi essere fatta in modo che tutte le righe che vogliono accedere ai dati siano figli della tabella. A questo scopo, spesso vengono annidate diverse tabelle per avere accesso a tutti i campi.

Per leggere o scrivere sulle tabelle all’interno di Microsoft Dynamics NAV 2016 è necessario dichiarare prima un’istanza della tabella nella mapping. Scegliere il valore Loop nella proprietà mapping line Type. Questa operazione modificherà le proprietà disponibili e aggiungerà una nuova proprietà chiamata Loop Type. Selezionare il valore Table come Loop Type.

Successivamente è possibile configurare le altre proprietà. Sono disponibili le seguenti proprietà:

Loop Type

Il tipo di ciclo. Selezionare il valore Table per accedere ai dati della tabella.

Mode

Se leggere i dati da una tabella, scrivere i dati in una tabella (creare un nuovo record) o aggiornare i dati esistenti.

Read

Leggere i dati esistenti. I dati possono essere filtrati. È possibile applicare dei filtri, in modo da non trovare alcun record.

Write

Creare un nuovo record nella tabella. A seconda del tipo di formato, possono essere creati uno o più record.

Update

Aggiorna un record esistente o ne crea uno nuovo, se non esiste. Il modulo può aggiornare solo un record alla volta, quindi assicurarsi di applicare i filtri in modo che venga trovato al massimo un record. Per aggiornare più record, è necessario creare un ciclo di tabella che legge i dati e una seconda istanza di tale tabella in modalità di aggiornamento filtrata sulla chiave primaria del record attualmente letto.

Table

Seleziona la tabella di origine/target da Microsoft Dynamics NAV 2016. È possibile inserire il nome della tabella o il suo ID.

Name

Il nome dell’istanza della tabella nella mapping. Il nome viene utilizzato per differenziare le diverse istanze della stessa tabella. Consideratelo come il nome di una variabile.

Data View

Questa proprietà è nuova nella versione 4.00 del modulo.

All Records

Non applicare filtri speciali. È comunque possibile filtrare i dati con le proprietà riportate di seguito.

Post Process Record

Utilizzabile solo se questa mapping viene eseguita come post-elaborazione. Filtrare l’istanza della tabella al record su cui è stata definita la post-elaborazione.

Business Transaction Data

Utilizzabile solo se la mapping viene eseguita all’interno di una transazione commerciale. Filtra i dati ai dati delle transazioni commerciali (ad es. i dati del lavoro).

Named Table View

Filtra i dati in base a una vista tabella denominata. Può trattarsi di uno dei nomi delle viste di tabella predefinite o di una qualsiasi vista di tabella definita dalla programmazione. Sarà disponibile una nuova proprietà per selezionare il nome.

Table View Name

Questa proprietà è disponibile solo se la Data View è impostata su Named Table View. È possibile utilizzare qualsiasi vista tabella definita dal codice o una delle seguenti viste speciali:

TRANSMISSION

Se c’è una trasmissione in arrivo, è possibile accedervi con questa vista tabella.

PROCESSINGQUEUE

Se mapping viene eseguito come gestore di errori, è possibile utilizzare questo filtro per accedere alla voce della coda di elaborazione non riuscita.

POST_PROCESS_REC
DEFAULT

Questi nomi di filtro vengono solitamente utilizzati dal modulo per memorizzare le informazioni sul record post-processo. Si dovrebbe invece impostare il valore della Data View su Post Process Record. Ma se si aggiornano le mappature da versioni precedenti del modulo, si possono trovare ancora questi valori, che funzionano ancora.

I nomi possono anche essere definiti dal codice personalizzato e contenere qualsiasi filtro. Non consigliamo più di utilizzare questi nomi. Utilizzare invece un nome di filtro parlante o CUSTOM.

Limit Count

Questa proprietà è nuova in Anveo EDI Connect 4.00.

Disponibile solo in modalità di lettura. Specifica se si desidera limitare il numero di record che possono essere trovati. Può essere utilizzato per selezionare solo il primo o l’ultimo record in combinazione con la proprietà di ordinamento.

True

Limita i record al conteggio specificato.

False

Non limitare i record restituiti.

Select Top

Disponibile solo se Limit Count è impostato su True. Il numero massimo di record da utilizzare.

Table View

In sola lettura. Gruppi di altre proprietà. Il nome Table View viene utilizzato nella programmazione di Microsoft Dynamics NAV 2016 per descrivere la combinazione di ordinamento e filtri costanti di una tabella. Abbiamo usato questo nome per semplificare l’uso del modulo da parte dei programmatori C/AL; pensatelo come un filtro costante e un valore iniziale.

Key

La chiave da utilizzare per l’ordinamento. Può essere vuoto.

Order

L’ordine di applicazione della chiave. L’impostazione predefinita è Ascending.

Filter

Filtri che sono costanti o, in altre parole, non dipendono dai dati di un’altra tabella. È possibile filtrare tutte le colonne della tabella.

Se la Mode della tabella è Write, i filtri vengono applicati come valori iniziali alla tabella. È quindi possibile utilizzare il filtro per specificare alcuni valori delle colonne per i nuovi record.

Data Item Link

Questa proprietà viene utilizzata per definire la relazione con un’altra tabella. Si tratta di un elenco di valori. Si seleziona prima la colonna dall’istanza della tabella corrente e poi un’altra tabella e i campi. Questa proprietà viene utilizzata per definire la relazione chiave-esterno.

Supponiamo di avere un’istanza della tabella EDI Document nella mapping e come figlio un’istanza della tabella EDI Document Line. Per specificare che la riga appartiene al documento di intestazione, si definisce il Data Item Link come:

"Document Type"="EDI Document"."Document Type", "Document No."="EDI Document"."No.", "Document Version No."="EDI Document"."Version No."

Filtra le colonne specificate in base al valore del documento di intestazione. In modalità di lettura si ottengono solo le righe appartenenti al documento. In modalità di scrittura, le colonne verranno popolate con i dati del documento, in modo che la riga appartenga all’intestazione.

Se la Mode della tabella è Write, il Data Item Link viene applicato come valore iniziale alle colonne della tabella. Pertanto, è possibile utilizzare il Data Item Link per specificare alcuni valori delle colonne per i nuovi record.

Temporary

Si tratta di una proprietà avanzata e normalmente nascosta.

Specifica che si desidera utilizzare una tabella temporanea. Una tabella temporanea viene scritta di nuovo nel database.

Init Function

Questa proprietà è nuova in Anveo EDI Connect 4.00.

La proprietà init function è disponibile solo se la proprietà Temporary è impostata su True. Questa funzione viene utilizzata per popolare la tabella temporanea, quando viene inizializzata.

Object

Il nome dell’oggetto su cui è definita la funzione.

Property/Function

Il nome della funzione. La funzione deve restituire un oggetto di tipo Codeunit ANVEDI Variant che punta a un RecordRef contenente i dati iniziali.

Company

Si tratta di una proprietà avanzata e normalmente nascosta.

L’azienda da cui il record viene letto/scritto. Questo può essere utilizzato per accedere ai dati di un’altra azienda.

Non modificare la società sulle istanze di tabella in modalità di scrittura, a meno che non si sappia cosa si sta facendo. Tutti i trigger vengono eseguiti in base ai dati dell’azienda corrente, per cui non si deve mai scrivere direttamente su una tabella standard di un’altra azienda.

TotalFields

Questa proprietà è disponibile solo per le tabelle in modalità di lettura. È possibile specificare le colonne per le quali il modulo calcolerà automaticamente un aggregato, ad esempio una somma. È possibile leggere il valore aggregato dalla tabella accedendo alla colonna dopo la riga della tabella, ma non come riga figlia del ciclo della tabella.

Sono disponibili le seguenti funzioni aggregate:

Sum

Solo per i campi numerici. Il risultato è la somma dei singoli valori. Può essere utilizzato per calcolare l’importo del documento in base all’importo della riga, ecc.

Min

Solo per i campi numerici. Il numero più piccolo.

Max

Solo per i campi numerici. Il numero maggiore.

First

Il valore del primo record trovato.

Last

Il valore dell’ultimo record letto.

Suggerimento: è possibile utilizzare questa funzionalità per le tabelle di impostazione. Posizionarli all’inizio della mapping e definire gli aggregati “First” per i campi che si desidera utilizzare nella mapping. Ora è possibile accedere alle proprietà in qualsiasi punto della mapping al di sotto di questa riga, senza dover rientrare in tutto.

Register Errors On Instance

Questa proprietà è nuova in Anveo EDI Connect 4.00.

Si tratta di una proprietà avanzata e normalmente nascosta. Se si desidera registrare automaticamente gli errori dopo questa riga in questa istanza di tabella.

True

Registra gli errori su questa istanza di tabella. Questo ha senso per le tabelle buffer.

False

Non registrare errori su questa istanza di tabella. Questo ha senso se l’istanza accede, ad esempio, a informazioni su tabelle secondarie.

Linked Documents

È una proprietà di sola lettura per raggruppare le proprietà figlio.

Create Linked Documents

Se si desidera creare voci nella tabella dei documenti collegati per questa istanza di tabella. Impostando questa opzione su True, si potrà navigare dalla EDI Processing Queue, dalla EDI Transmission (se presente) e dalla EDI Business Transaction (se presente) a questa tabella.

Linked Tables

Questa proprietà è disponibile solo se Create Linked Documents è impostata su True. È possibile specificare altre istanze di tabella da questa mapping che devono essere collegate all’istanza di tabella corrente. Ciò consente, ad esempio, di navigare nel EDI Document verso altri documenti collegati, come una testata di vendita creata.

Internal No. Display Field

È possibile selezionare la colonna da utilizzare per il numero interno ogni volta che viene creata una voce di documento collegata per questa istanza di tabella.

External No. Display Field

È possibile selezionare la colonna da utilizzare per il numero esterno ogni volta che viene creata una voce di documento collegato per questa istanza di tabella.

Post-Processing

Consente di specificare una o più azioni da eseguire su ciascun record di questa istanza di tabella, dopo che la mapping è stata terminata con successo. Le post-elaborazioni non vengono eseguite, se ci sono stati errori. Per saperne di più, consultare la sezione dedicata alle post-elaborazioni.

Min. Repeat

Se si inserisce un numero, la mapping lancia un errore se non si raggiunge la ripetizione minima specificata.

Min. Repeat Error Message

Il messaggio di errore che deve essere visualizzato se non viene trovato il numero minimo di record.

Max. Repeat

Se si inserisce un numero, mapping lancia un errore se non si raggiunge la ripetizione massima specificata.

Max. Repeat Error Message

Il messaggio di errore che deve essere visualizzato se si supera il numero massimo di record.