Passa al contenuto

AL Bridge

AL Bridge - Guida utente

Configurazione e uso in Business Central.

1. Concetti in un minuto

  • Business Central SaaS è sandboxed: non stampa su stampanti locali, non legge né scrive cartelle, non lancia processi locali e non converte immagini, PDF o firme digitali. AL Bridge colma questo divario.
  • AL Bridge è una fondazione, non una funzionalità che usi direttamente. Ogni capacità arriva come modulo separato (stampa, etichette, file system, PowerShell, SQL, barcode, corrieri, UPS, DHL e altri) che vi si aggancia.
  • Per il lavoro on-premise i moduli accodano un job cifrato; un agente locale installato presso il cliente lo preleva, lo esegue in locale e riscrive il risultato. Stampa e operazioni sui file sono driverless - su Business Central non si installa nulla.
  • Alcune capacità girano come servizi cloud AppLibra (rendering PDF, GS1 GRF per le etichette Zebra, gestione firma e allegati delle fatture elettroniche). Partono in automatico quando un modulo ne ha bisogno.
  • Tutto è orchestrato sul bus AL Message Passing, così moduli e servizi si combinano senza conoscersi tra loro.

2. Prerequisiti

  • Business Central 25.0 o superiore (Cloud/SaaS).
  • Le dipendenze installate: AL License and Trial Management, AL Message Passing, AL Cryptography (tutte di AppLibra). AL Bridge è infrastruttura di basso livello e non dipende dalla Foundation App.
  • Almeno un modulo connettore (per esempio AL Zebra Print Label, AL File Management, AL Direct Print, AL Shipping Agent): sono i moduli ciò che configuri e usi davvero.
  • Permessi: assegnare il permission set ALPBRPermission. Gran parte degli oggetti di Bridge è infrastruttura interna, quindi l'accesso quotidiano di norma arriva con il modulo che installi.

L'app si raggiunge da Tell Me (cerca "Bridge Job Queue", "Webservice Setup", "File Management", "Bridge Job Queue Logs"), dalla scheda licenza di ciascun modulo (dove vivono lo stato del servizio e la licenza) e dal role center AppLibra (Shift+F12 -> Esplora altri ruoli -> AppLibra) quando la piattaforma AppLibra è installata insieme ai moduli. AL Bridge non ha un gruppo di attività proprio: è infrastruttura.

3. Setup

3.1 Collegare i servizi cloud AppLibra

Apri Webservice Setup (il record si crea alla prima apertura). Compila:

  • Web Service Url - l'endpoint cloud AppLibra, preimpostato a https://services.applibra.com.
  • Port - preimpostata a 443.
  • Username e Password - le credenziali dei servizi cloud. La password è mascherata e custodita in Isolated Storage, mai mostrata in chiaro.

Questa connessione alimenta le capacità lato cloud (PDF da template, PNG in GRF, firma e allegati delle fatture elettroniche). Lascia i valori predefiniti a meno che AppLibra non te ne fornisca altri.

3.2 Licenziare ogni modulo (prima il trial)

Ogni capacità è licenziata per modulo. Quando installi un modulo connettore, questo registra un trial in automatico, così puoi partire subito. Apri la scheda licenza del modulo (da AL License and Trial Management) per vederne lo stato:

  • Service Status indica se l'agente locale di quel modulo è installato. Il messaggio che segnala il servizio installato vuol dire che è pronto; altrimenti la scheda ti chiede di installarlo.
  • Usa Add License sulla scheda per inserire una licenza acquistata alla fine del trial.

3.3 Installare l'agente locale

Le operazioni on-premise (stampa, file system, processi locali, corrieri) richiedono un servizio agente locale in esecuzione presso il cliente. L'agente viene fornito con il modulo che ne ha bisogno e si installa una volta sola; da quel momento raccoglie i job che Business Central accoda, li esegue in locale e riferisce l'esito. Le singole stampanti, le cartelle e gli account corriere si configurano dentro ciascun modulo, non in AL Bridge.

4. Uso quotidiano

Nella maggior parte dei giorni AL Bridge non lo apri nemmeno: lavori nei moduli e Bridge fa passare il traffico dietro le quinte. Le pagine qui sotto servono per setup, monitoraggio e diagnosi.

4.1 Lascia lavorare un modulo

Quando un modulo ha bisogno di qualcosa che il cloud non può fare - stampare un'etichetta, salvare un file, chiamare un corriere - accoda un job sul Bridge e, se la capacità è un servizio cloud, chiama services.applibra.com. L'azione la avvii dal modulo (stampi un'etichetta, registri una spedizione, esporti un documento); il Bridge gestisce consegna e licenza dietro le quinte.

4.2 Monitorare la coda dei job

Apri Bridge Job Queue per seguire i job on-premise che scorrono. Ogni riga mostra il Type (il modulo), una Description, Created At, il Job Status e, per i job su file, il File Action Type e l'IP Address dell'agente. Il Job Status attraversa questi stati:

  • None - accodato, in attesa dell'agente.
  • Work in Progress - l'agente locale lo ha preso in carico e lo sta eseguendo.
  • Completed - concluso.
  • Error - fallito; guarda i log.
  • Process Not Confirmed - l'agente non ha confermato l'esecuzione.

Due factbox permettono di ispezionare il contenuto: il PDF Viewer per i job di stampa e il Text Viewer per i job di etichetta, file, SQL e PowerShell. Con Export Attached File scarichi il contenuto di un job.

4.3 Lavorare con i file

Apri File Management per vedere i job del file system. Oltre alla vista coda, ti permette di spostare contenuti a mano: Import file porta un file locale dentro un job e Export file scarica il contenuto di un job. Ogni riga riporta il File Action Type (salva, crea o verifica una cartella, sposta o copia una cartella o il suo contenuto, leggi un file, leggi una cartella, elimina, estrai XML), se il file esiste (File Exist), il Job Status e una Status description con l'esito.

4.4 Usare i servizi cloud (in automatico)

I servizi documentali girano da soli quando un modulo li richiede: PNG in GRF per le etichette Zebra, PDF da template JSON, conteggio pagine PDF, decodifica della firma P7M delle fatture elettroniche ed estrazione degli allegati. Non c'è nulla da lanciare: basta tenere valida la connessione in Webservice Setup affinché le chiamate vadano a buon fine.

4.5 Leggere i log

Apri Bridge Job Queue Logs per lo storico di ciò che è stato eseguito, con il Job ID, il Module e l'orario. Dalla scheda licenza di un modulo, Show Service Errors apre i log filtrati su quel modulo, così passi subito dalla capacità in errore ai suoi errori.

5. Dove si trova

  • Tell Me: cerca "Bridge Job Queue", "Webservice Setup", "File Management" o "Bridge Job Queue Logs".
  • Scheda licenza (per modulo): Service Status e Show Service Errors, più Add License.
  • Hub AppLibra: Shift+F12 -> Esplora altri ruoli -> AppLibra (presente quando la piattaforma AppLibra è installata con i moduli).
  • AL Bridge non ha un gruppo di attività in un role center: è l'infrastruttura condivisa sotto i moduli connettori.

6. Consigli e risoluzione problemi

  • Un job non esce mai da "None" o resta in "Work in Progress". L'agente locale non è in esecuzione o non raggiunge Business Central. Verifica che il servizio agente di quel modulo sia installato e attivo; il Service Status sulla scheda licenza del modulo deve indicare che il servizio è installato.
  • "Installare il servizio correlato". Il modulo ha la licenza ma non ancora l'agente. Installa l'agente locale fornito con il modulo, poi riapri la scheda licenza.
  • Un servizio cloud fallisce (etichette non convertite, PDF non generato, P7M non decodificato). Controlla Webservice Setup: URL, porta e credenziali, e che l'ambiente raggiunga services.applibra.com.
  • Un job finisce in Error. Apri Bridge Job Queue Logs, oppure usa Show Service Errors sulla scheda licenza del modulo per saltare agli errori di quel modulo. La Status description sulla riga del job spesso ne indica la causa.
  • Una capacità si rifiuta di partire con un messaggio di licenza. Ogni capacità è un modulo licenziato a sé. Controlla il trial o la licenza sulla scheda licenza di quel modulo; il modulo Globe è l'eccezione e non richiede il controllo licenza.
  • In AL Bridge non si configura nulla. Stampanti, cartelle e account corriere vivono nei moduli. AL Bridge porta solo la connessione, la coda e i log.

7. Supporto e risorse