Fase 6: Impostazione delle entità di SwissSalary

1.Nella pagina «Gestione Cloud Connector» selezionare «Impostazioni» e poi «Impostazioni dell’entità».

2.Nella tabella si deve completare le colonne «ID tabelle», «Fonte» e «Punto finale del servizio web».

•ID -tabelle: qui si inserisce il nome della tabella di SwissSalary/Business Central. Cliccare nella colonna « ID tabelle», selezionare «Selezionare dall’elenco completo» e scegliere la tabella desiderata di SwissSalary/Business Central, in cui si vogliono trasmettere i dati dal sistema collegato o da cui si vogliono scrivere dei dati nel sistema collegato. Nel sistema collegato si può impostare la stessa tabella più volte con diversi punti finali.

•Ordine: indica l’ordine in cui si deve sincronizzare la tabella dell’entità. Bisogna fare attenzione alle dipendenze della tabella; durante la sincronizzazione si convalidano le relazioni delle tabelle.

•Fonte: qui si indica la direzione della sincronizzazione. Se la fonte è Business Central, i dati di SwissSalary/Business Central vengono sincronizzati nel sistema collegato. Se la fonte è esterna, si avrà la sincronizzazione dei dati del sistema collegato in SwissSalary/Business Central. Cloud Connector non permette la sincronizzazione bidirezionale di determinate tabelle. Ogni tabella deve avere una sua fonte: SwissSalary/Business Central o il sistema collegato.

•Sincronizzazione automatica: indica se le modifiche delle tabelle vanno sincronizzate automaticamente da SwissSalary al sistema collegato.

•Sincronizzare le eliminazioni: indica se i processi di eliminazione per questa entità devono essere sincronizzati. L’attivazione di questa impostazione ha un impatto significativo  sulla totale prestazione della sincronizzazione.

•Punto finale del servizio web: qui si inserisce il nome (lo stesso usato nel servizio web nel campo «Nome servizio» della fase 5) della tabella del sistema collegato. Cliccare nella colonna «Punto finale del servizio web» e inserire il nome della tabella.

3.Impostare il mapping dei campi da sincronizzare, cliccando sul nome della tabella in questione.. Si dovranno completare i campi della sezione «Attribuzione dei campi dell’entità» come segue:

•ID campo: qui si inserisce l‘ID del campo della tabella assegnata di SwissSalary/BusinessCentral.

•Nome campo: qui si inserisce il nome del campo della tabella assegnata di SwissSalary/BusinessCentral.

•Nome del campo del servizio: qui si inserisce il nome del campo della tabella assegnata del sistema collegato.

•Attivato: indica se questo campo  deve essere inserito nell’aggiornamento delle registrazioni dell’istanza della fonte o di destinazione.

•La chiave: indica se questo campo è una parte della chiave (Primary Key) di questa entità.

•Convalidare: indica se si deve effettuare il controllo del campo con la tabella in caso si siano stabiliti i dati per questo campo. Ciò vale se in SwissSalary si riprendono i dati del sistema collegato.

4.Nel caso in cui si sia selezionato il valore «Esterno» nella colonna «Fonte», verrà visualizzata la sezione «Costanti del campo dell’entità». Qui si possono completare i campi della sezione «Costanti del campo dell’entità» come segue:

•ID campo: indica il valore costante che deve essere stabilito per il campo della nuova registrazione in Business Central.

•Nome campo: indica il nome del campo della tabella di SwissSalary/BusinessCentral.

•Valore costante: indica il valore costante stabilito per il campo delle nuove registrazioni in Business Central.

•Attivato: indica se si deve inserire questo campo durante l’aggiornamento delle registrazioni nelle licenze di fonte e di destinazione.

5.Se nella sezione «Assegnazione dei campi dell‘entità» e «Costante del campo dell‘entità» si è cliccato su «Campi»/ «Ripristinare i campi allo standard», verranno elencati tutti i campi della tabella selezionata.

6.Importante: alcune entità legate alla contabilità di salario sono già predefinite. In questo caso non si devono reimpostare le entità; si può saltare direttamente alle fasi 9 e 10. Vi è inoltre la possibilità di impostare le entità che non sono state definite in SwissSalary Cloud Connector, come per esempio la scheda personale.

7.Filtro Odata (facoltativo): se «Fonte» ha il valore «Esterna», si può utilizzare il filtro Odata. Si possono utilizzare le definizioni del filtro di questo campo seguendo le istruzioni di questo documento.

8.Sincronizzazione automatica: indica se le modifiche della tabella devono essere sincronizzate automaticamente da SwissSalary al sistema collegato .

9.Sincronizzazione  delle eliminazioni: indica se i processi di eliminazione di questa entità devono essere sincronizzate. Attivando questa impostazione si avranno effetti significativi sull’intera prestazione della sincronizzazione.

10.Saltare il controllo dell’integrità dei dati: indica se, in SwissSalary, si devono ignorare i controlli dell’integrità dei dati che si eseguono prima dell’inizio della sincronizzazione in questa entità.

11.Controllo punto finale del servizio (facoltativo): indica un punto finale che deve essere richiamato nel sistema collegato, dopo che la sincronizzazione dell’entità è andata a buon fine. Si può utilizzare se si deve eseguire un’azione dopo che la sincronizzazione dei dati della tabella è già avvenuta. Vedi Fase X

12.Controllo del testo di richiesta (facoltativo): qui si può inserire un valore costante che deve essere inviato al punto finale del servizio indicato nel campo «Controllo del punto finale del servizio». È necessario inserire il nome campo o i valori relativi sotto forma di JSON.

Registrazione automatica dei diari FiBu e delle registrazioni dei costi in Business Central/Navision on-prem e Business Central SaaS. 

Se dopo la sincronizzazione si devono registrare automaticamente nel sistema collegato i diari trasmessi di FiBu e delle registrazioni dei costi, si devono eseguire le seguenti impostazioni:

1.A. Business Central on-Prem: nel sistema collegato si devono installare due nuovi oggetti (Gen-Journal Line Post e/o Cost-Journal Line Post) da pubblicare come servizi web. Questi oggetti sono messi a disposizione da SwissSalary in modo da poter richiamare la funzione Registrare dal servizio web

B. Business Central SaaS: si deve pubblicare il CodeUnit del servizio web: 231 Gen. Jnl.-Post sotto forma di servizio web in modo da poter richiamare la funzione Registrare dal servizio web.

2.Nella pagina «Impostazioni dell‘entità», nelle entità Gen. Journal Line e Cost Journal Line, si devono selezionare i servizi web necessari per la funzione «Registrare» del campo «Punto finale di Post-Run Service».

3.Nella pagina «Impostazioni dell‘entità», nelle entità Gen. Journal Line e Cost Journal Line, si deve registrare nel campo il testo di richiesta del «Post-Run» per i seguenti json sotto forma di  request Body:  

{        

"JournalTemplateFilter": "IN GENERALE",

"JournalBatchFilter": "$L-*$"

}