Fase 5 Configurazione delle entità in SwissSalary |
|
Configurazione generale
1.Nella pagina «Gestione Cloud Connector», selezionare «Configurazione» e poi «Configurazione dell'entità». 2.Nella tabella devono essere compilate le colonne «ID tabella», «Fonte» e «Punto finale del servizio web». •ID tabella: qui viene indicato il nome della tabella SwissSalary/Business Central. Cliccare sulla colonna «ID tabella», selezionare «Seleziona dall'elenco completo» e scegliere la tabella SwissSalary/Business Central corrispondente nella quale si desidera trasferire i dati dal sistema collegato o dalla quale si desidera scrivere i dati nel sistema collegato. La stessa tabella può essere impostata più volte, con diversi endpoint nel sistema collegato. •Ordine: specifica l'ordine in cui questa tabella entità deve essere sincronizzata. Prestare attenzione alle dipendenze delle tabelle; le relazioni tra le tabelle vengono convalidate durante la sincronizzazione. Dopo questo passaggio, fare clic sul valore nella colonna “Nome tabella” e compilare i seguenti campi nella sezione “Dettagli”. •Endpoint: qui viene specificato l'endpoint API di Personio. Clicca sui tre puntini nel campo «Endpoint» e seleziona uno dei seguenti endpoint Personio. I dati possono essere sincronizzati da Personio a SwissSalary esclusivamente tramite questi endpoint: ov1/company/employees ov2/cost-centers ov2/legal-entities È possibile sincronizzare i documenti da SwissSalary con Personio tramite l'endpoint v1/company/documents. •Fonte: per gli endpoint v1/company/employees, v2/cost-centers e v2/legal-entities è possibile selezionare solo “Sistema esterno” come fonte. Per l'endpoint v1/company/documents è possibile selezionare solo “Business Central”. Qui viene specificata la direzione della sincronizzazione. Se la fonte è Business Central, i dati vengono sincronizzati da SwissSalary/Business Central a Personio. Se la fonte è esterna, la sincronizzazione dei dati avviene dal sistema collegato a SwissSalary/Business Central. •Campo di aggregazione: specifica il campo utilizzato per aggregare i dati durante la sincronizzazione. Ciò è utile quando si sincronizza un'entità che contiene più record associati per un singolo record padre, ad esempio più centri di costo per un singolo dipendente. •Sincronizza eliminazioni: specifica se le operazioni di eliminazione per questa entità devono essere sincronizzate. L'attivazione di questa impostazione può avere un impatto significativo sulle prestazioni complessive della sincronizzazione. •Ignora controlli di integrazione dei dati: specifica se i controlli di integrità dei dati in SwissSalary devono essere ignorati prima dell'inizio della sincronizzazione per questa entità. 3.È possibile impostare la mappatura dei campi da sincronizzare cliccando sul nome della tabella corrispondente. I seguenti campi possono essere compilati nella sezione «Assegnazione campo entità» come segue: •ID campo: qui è necessario selezionare il campo dalla tabella SwissSalary/Business Central selezionata. •Nome campo: qui viene inserito automaticamente il nome del campo nella tabella SwissSalary/BusinessCentral selezionata. •Nome del campo di servizio: qui viene visualizzato il nome del campo sull'endpoint selezionato (ad esempio: v1/company/employees) di Personio. Qui vengono visualizzati tutti i campi condivisi per l'endpoint Personio. In Personio è possibile aggiungere o rimuovere i campi a piacere per l'endpoint. •Attivato: qui si specifica se questo campo deve essere incluso durante l'aggiornamento dei record nell'istanza di origine o di destinazione. •Chiave: indica se questo campo fa parte della chiave primaria (Primary Key) per questa entità. •Convalida: indica se la verifica del campo della tabella deve essere eseguita quando vengono specificati i dati per questo campo. Ciò vale solo se i dati vengono trasferiti dal sistema collegato a SwissSalary. 4.Nella sezione «Assegnazione valori» è possibile definire valori costanti o di mappatura per i campi da sincronizzare. Selezionare il campo desiderato nella sezione «Assegnazione campo entità»: questo verrà quindi visualizzato nel campo «Nome campo servizio» nella sezione «Assegnazione valori». •Di valore: qui è possibile determinare il valore che deve essere sostituito con un altro valore. •Valore: qui è possibile specificare il valore con cui sostituire il valore originale. Esempio: desiderate sincronizzare il campo “Codice salario” nella scheda personale nel sistema collegato e sostituire i valori Enum (salario, salario mensile, salario orario, salario a cottimo, salario mensile LMV) in questo campo con altri valori di testo. Nel campo “Da valore” inserite “Stipendio” e nel campo “A valore” inserite il valore sostitutivo desiderato, ad esempio “GH”. Nella riga successiva potete inserire “Salario mensile” nel campo “Da valore” e, ad esempio, ‘ML’ nel campo “A valore”. Nelle righe successive è possibile specificare i restanti valori di mappatura. È anche possibile impostare un valore costante inserendo un asterisco (*) nel campo “Da valore” e il valore costante nel campo “A valore”. 5. Se sono selezionati i campi SwissSalary Nazionalità e Sesso, i campi nella “Mappatura dei valori” vengono compilati automaticamente.
Istituzione di entità speciali:
I. Dati bancari Per sincronizzare il numero IBAN dei dipendenti, è necessario configurare l'entità come segue: 1. Nel campo “ID tabella” inserisci 3009087, mentre puoi decidere tu stesso l'“Ordine”. 2. “Endpoint” è v1/company/employees e “Origine” è Sistema esterno. 3. Nel campo “Codice modello” è possibile creare una nuova voce cliccando su “+ Nuovo”. oNel campo “Codice” inserisci “Banca” oNella colonna “Nome campo” selezionare “Pos”. oNel campo “Valore predefinito” inserisci il numero 1. oClicca su “Indietro”
Queste impostazioni garantiscono che il numero IBAN memorizzato in Personio venga sempre sincronizzato con SwissSalary come conto bancario principale.
4. È necessario configurare la mappatura dei campi dell'entità come segue:
*Il nome del campo di servizio in Personio può differire da quello visualizzato..
II. Centri di costo (Dimensioni) Se si configura questa entità, è necessario gestire le dimensioni solo in Personio. Per sincronizzare le dimensioni da Personio a SwissSalary, è necessario configurare l'entità come segue 1.Nel campo “ID tabella” inserisci 349, mentre puoi decidere tu stesso l'ordine. 2.“Endpoint” è v2/cost-centers e “Fonte” è Sistema esterno. 3.Nel campo “Codice modello” è possibile creare una nuova voce cliccando su “+ Nuovo”. oNel campo “Codice” inserisci “COSTCENTER”. oNella colonna “Nome campo” selezionare “Codice dimensione”. oNel campo “Valore standard” inserite il nome della dimensione in SwissSalary. Questo può variare a seconda del cliente. oClicca su “Indietro” 4.Con questa mappatura dei campi entità è possibile trasferire il master delle dimensioni da Personio a SwissSalary.
III. Documenti (Conteggio salario, certificati di salario ecc.) da SwissSalary Per sincronizzare i documenti selezionati da SwissSalary a Personio, è necessario effettuare le seguenti impostazioni. 1. Nella pagina “Configurazione documenti SwissSalary” è necessario inserire l'ID della categoria di documenti Personio corrispondente nel campo “Personio Category ID” della categoria di documenti SwissSalary. Tutti i documenti di questa categoria di documenti SwissSalary vengono trasferiti in Personio, nella categoria inserita. 2. Nella pagina “Configurazione entità” della “Configurazione Cloud Connector” è necessario creare una nuova entità. 3. Nel campo “ID tabella” inserisci 3009140, mentre puoi decidere tu stesso l'“Ordine”. 4. “Endpoint” è v1/company/documents e “Origine” è Business Central. 5. Con questa mappatura dei campi entità, i documenti vengono trasferiti a Personio:
IV. Assegnazioni dimensionali da Personio
Per sincronizzare l'assegnazione dei dipendenti alle dimensioni del personale, è necessario effettuare le seguenti impostazioni. 1. Nel campo “ID tabella” inserisci 3009084, mentre puoi decidere tu stesso l'“Ordine”. 2. “Endpoint” è v1/company/employees e “Origine” è Sistema esterno. 3. Nel campo “Codice modello” è possibile creare una nuova voce cliccando su “+ Nuovo”. oNel campo “Codice” inserisci “EMPCOST”. oNella colonna “Nome campo” selezionare “Dimensione”. oNel campo “Valore standard” inserite il nome della dimensione (ad esempio CENTRI DI COSTO) in SwissSalary. Questo può variare a seconda del cliente. oClicca su “Indietro”
4. Con questa mappatura dei campi entità, i documenti vengono trasferiti a Personio:
5. Il campo “Aggregation Field” deve avere il valore “cost_centers”. |