AL Generic Import - Guida utente

AL Generic Import carica dati da Excel nelle righe dei giornali (e in altri record) di Business Central. Questa guida copre il setup, la preparazione del file e le azioni di import sui giornali.

1. Concetti in un minuto

• L'import legge un file .xlsx la cui prima riga contiene le intestazioni di colonna: una colonna valorizza il campo il cui nome corrisponde all'intestazione, nella lingua della tua sessione. Nessuna tabella di mapping da mantenere.
• Le colonne non riconosciute vengono ignorate: nel foglio possono restare colonne di lavoro.
• L'azione è su quattro giornali: giornale articoli, giornale inventario fisico, giornale generale e giornale generale ricorrente.
• Sul giornale generale c'è anche l'import dedicato delle partite aperte clienti/fornitori, che aggrega le righe per documento: il classico caricamento di avviamento.
• I file grandi si importano in tempo lineare; la dimensione del blocco di lavoro si regola dal setup.

2. Prerequisiti

• Business Central 25.0 o superiore (Cloud/SaaS).
• Dipendenze installate (automatiche da AppSource): AL Message Passing, AL Role Center.
• Permessi: assegna agli utenti il permission set AL Generic Import.

Raggiungi l'app da Tell Me (cerca "Setup (GIM)" o i nomi dei giornali), dal gruppo Import generico (GIM) nel role center Business Manager, e dal role center AppLibra (Shift+F12, Esplora altri ruoli, AppLibra).

3. Setup (GIM)

Apri Setup (GIM) (il record si crea alla prima apertura). Compila quello che serve:

• Nome Modello/Batch Default cliente e fornitore - la destinazione usata dalle esecuzioni pianificate dell'import partite aperte; ogni batch si sceglie all'interno del suo modello.
• Dimensione Blocco Importazione - righe elaborate per finestra durante l'import (default 100, 0 = default). Il default è il valore ottimale misurato: cambialo solo se stai tarando un caricamento particolare.

4. Prepara il file Excel

• Riga 1: i nomi dei campi come intestazioni di colonna, scritti nella lingua con cui accedi (l'import confronta con la lingua della sessione).
• Una riga per riga giornale. Date, importi e valori opzione nel tuo formato regionale.
• Negli import del giornale generale, una colonna intestata col nome di una dimensione valorizza quella dimensione (dimensioni shortcut da 3 a 8).
• Una colonna intestata Nome batch registrazioni indirizza la riga su quel batch invece che su quello corrente.

5. Giornali articoli e inventario fisico

Apri il giornale e lancia Importa da Excel: conferma, scegli il file (e il foglio, se più di uno). Le righe vengono accodate al giornale.

Elimina tutte le righe svuota le righe della vista corrente quando vuoi ripartire pulito. La registrazione resta quella standard di Business Central: controlli le righe e registri.

6. Giornale generale: due import

• Importa da Excel - carica le righe una a una, come sono nel foglio.
• Importa partite aperte da Excel - per i saldi di apertura: le righe dello stesso documento vengono aggregate (importi sommati), il fattore di cambio viene derivato quando serve, i clienti bloccati vengono sbloccati solo per il caricamento, e le righe senza numero documento ricevono una progressione VOID1, VOID2... così nulla si fonde in silenzio.

Entrambe le azioni sono disponibili anche sul giornale generale ricorrente. Con AL Generic Import IT installata, sulle partite importate vengono generate le rate di pagamento italiane.

7. File grandi

Il tempo di import resta lineare: decine di migliaia di righe a ritmo costante, e alla fine un messaggio riporta righe, tempo di lettura Excel e righe al secondo (primo e ultimo blocco, per verificare che il ritmo sia rimasto piatto). Se tari la Dimensione Blocco Importazione, quel messaggio è la tua misura.

8. Localizzazione italiana

In Italia le partite aperte clienti e fornitori portano le rate di pagamento. L'app companion AL Generic Import IT aggiunge esattamente questo: quando lanci l'import delle partite aperte, ogni documento importato riceve le sue rate di pagamento italiane (Payment Lines), con importo e data di scadenza delle righe da cui il documento è stato costruito. Reimportando un documento le rate vengono riscritte, non accodate.

Non c'è nulla da configurare e nessuna azione in più: si installa la companion e le rate compaiono come parte dell'import delle partite aperte. La companion richiede la localizzazione italiana di Business Central, e installandola si installa anche AL Generic Import.

9. Estendere l'import (per i partner)

L'import solleva eventi sul bus AL Message Passing - prima dell'inserimento del record, prima dell'assegnazione di un valore, prima della modifica - così un'estensione partner adatta il caricamento a qualunque tabella o campo particolare senza toccare l'app. Contatta AppLibra per i punti di integrazione.