API

Documentazione via Swagger

La documentazione delle API è disponibile ora su Swagger (OpenAPI) e consultabile all’indirizzo: https://webapi.peoplelinkonline.com/Swagger

Questa documentazione diventa il riferimento ufficiale per le integrazioni future dove trovare la rappresentazione completa e aggiornata degli endpoint disponibili, i metodi supportati, i parametri di input, le strutture delle richieste e delle risposte e i codici di stato restituiti.

La versione in PDF non sarà più aggiornata e non deve più essere utilizzata.

L’aggiunta di Swagger non modifica il funzionamento delle API e non crea incompatibilità.

Nuove Web API per import generico (avanzato)

Abbiamo introdotto nelle API standard di PEOPLELINK una serie di endpoint pensati per la scrittura dei dati.

I tracciati supportati da queste nuove API sono gli stessi disponibili anche sul portale e denominati con il suffisso "avanzato".

Ogni tracciato di import che verrà sviluppato in futuro sarà sempre fruibile sia in formato EXCEL (da interfaccia del portale) sia in formato API (con formato JSON).

Con questo rilascio rilasciamo, nelle API, i seguenti tracciati:

·         VISTA Assegnazioni eventi anagrafici

·         VISTA Assegnazioni ai soggetti delle posizioni lavorative

·         VISTA Anagrafica competenze

·         VISTA Assegnazioni ai soggetti delle competenze

·         VISTA Anagrafica posizioni lavorative

·         IDENTITIES Anagrafica badge

·         VISTA Anagrafica gruppi di edizioni ed edizioni per corsi formativi

·         VISTA Anagrafica asset

·         TASK Anagrafica clienti, commesse e attività.

Le API lavorano con una struttura async; è presente un endpoint che riceve i dati da elaborare, li analizza e li valida formalmente, quindi, se tutto viene considerato corretto, l'elaborazione vera e propria viene messa in una coda dedicata ed eseguita con priorità FIFO.

Tramite un secondo endpoint sarà possibile consultare lo stato dell'elaborazione, ricevendo un OK se tutto è andato a buon fine o una lista di eventuali errori.

L'intero processo funziona con la logica ALL-OR-NOTHING, ovvero se si verifica anche solo un problema, l'intero import sarà annullato e nulla verrà scritto su PEOPLELINK.

L'API ha una struttura base comune a tutti i tracciati e una serie di proprietà specifiche per ogni tracciato.

Il JSON è organizzato secondo una struttura simil-tabellare, per permettere l’individuazione dei campi a cui attribuire i valori da importare.

Siccome ogni installazione ha configurazioni differenti, alcune proprietà potrebbero essere differenti per impianto; è quindi disponibile un template JSON di riferimento ottenibile chiamando uno specifico endpoint, o recuperandone un esempio direttamente dal portale PEOPLELINK, modulo DOCKS.

Il JSON template, o di esempio, include tutte le proprietà necessarie a effettuare l'import di uno specifico tracciato, inclusi commenti per sapere se una proprietà è obbligatoria, quale formato necessità o quali sono i valori specifici che supporta.

Tutti gli import effettuati tramite API, sia quelli andati a buon fine sia quelli con errori, saranno disponibili per un determinato periodo di tempo, anche in DOCKS, con la possibilità di consultarne da interfaccia l'esito e i dati imporati.

 Come tutte le API pubbliche di PEOPLELINK, sarà necessario richiedere uno user e una password per ottenere un token di autorizzazione e una seconda chiave, specifica per poter eseguire operazioni di scrittura. Come per tutte le API, è possibile utilizzare lo Swagger come documentazione.

DOCKS

Nuovi import avanzati

Ora potete utilizzare in fase di startup nuovi schemi di import.

Nell'import da file della funzionalità Gestione documenti del modulo DOCKS, abbiamo introdotto nuovi schemi di import avanzati:

·         IDENTITIES: Anagrafica badge (avanzato)

·         TASK: Anagrafica clienti, commesse e attività (avanzato) - versione beta pubblica

·         VISTA: Anagrafica asset (avanzato)

·         VISTA: Gruppi di edizioni ed edizioni per corsi formativi (avanzato)

I file da utilizzare, per i quali è possibile scaricare i relativi template in Excel, tramite il comando Download template per import, dovranno rispettare le seguenti caratteristiche:

·         IDENTITIES: Anagrafica badge (avanzato)
Il file è composto dai seguenti fogli contenente i campi utili per la configurazione dei vari elementi:

o   Badge

o   Assegnazione ai soggetti

o   Badge con assegnazione (legacy)

·         TASK: Anagrafica clienti, commesse e attività (avanzato)
Il file è composto dai seguenti fogli contenente i campi utili per la configurazione dei vari elementi:

o   Clienti

o   Referenti

o   Commesse

o   Attività

o   Classificazioni

·         VISTA: Gruppi di edizioni ed edizioni per corsi formativi (avanzato)
Il file è composto dai seguenti fogli contenente i campi utili per la configurazione dei vari elementi:

o   Gruppi corsi formativi

o   Edizioni corsi formativi

o   Calendario sessioni

·         VISTA: Anagrafica asset (avanzato)
Il file è composto dai seguenti fogli contenente i campi utili per la configurazione dei vari elementi:

o   Asset aziendali

o   Scadenze

o   Documenti e allegati

o   Storico rilevazioni

o   Manutenzioni

o   Commesse associate

Come per gli schemi già esistenti per procedere con l'import dovete:

·         Caricare il file dopo aver selezionato il relativo schema.

·         Cliccare sul pulsante Valida import per visualizzare la struttura e i dati importati

·         Selezionare i fogli da importare, verificare ed eventualmente modificare/correggere il contenuto delle colonne, quindi cliccate su Valida e salva

·         Cliccare sul pulsante Anteprima e gestione dati per visualizzare e risolvere eventuali errori salvandoli

·         Selezionare Importa tutto per completare l'operazione.

TIME

Nuova icona per nota timbratura dipendente

Potete utilizzare l’icona introdotta nel cartellino amministratore relativa alle note inserite dal dipendente in fase di timbratura.

Potete visualizzare la nota direttamente tramite il tooltip, senza aprire il dettaglio della timbratura.

Migliorie nell’export del Report richieste giornaliere

Nel report delle richieste potete visualizzare ulteriori dettagli, tra cui:

·         ID del certificato

·         Codice fiscale del familiare e il codice ente ove è previsto

Totalizzatori Dal – Al (solo annuali) nel Profilo di Operazioni su Totalizzatori

Potete gestire nel Profilo di Operazioni su Totalizzatori, i totali con periodizzazione “Dal – Al”, a condizione che il periodo copra un intero anno.

Esempio - dal 01/09 dell’anno corrente al 31/08 dell’anno successivo.

TASK

Nuova funzionalità Tipi di attività

Potete specificare il tipo di attività da associare alle attività delle commesse per adattare il modulo TASK alle necessità di ESOLVER.

Abbiamo introdotto la nuova funzionalità Tipi di attività, utilizzabile sia nella configurazione delle attività delle commesse sia nei modelli di attività.

La nuova funzionalità prevede i seguenti campi:

·         Codice

·         Descrizione

·         Note.

Il campo Tipo di attività è disponibile anche durante la compilazione di un’attività nel timesheet. In questa fase potete decidere se valorizzarlo per ogni singolo dettaglio oppure lasciarlo vuoto.

Se il campo viene lasciato vuoto, il dettaglio erediterà automaticamente il tipo di attività definito sull’attività stessa (se precedentemente configurato).

Il Tipo di attività è stato inoltre aggiunto agli export Excel sia dei modelli di attività sia del timesheet.

Ottimizzazione dell’export del timesheet

Migliorata la funzionalità di export del timesheet per offrirvi una panoramica completa e dettagliata di tutti gli elementi relativi alle attività registrate.

Nella funzionalità Export timesheet, all’interno della sezione Colonne da esportare,  sono ora disponibili nuove colonne selezionabili in fase di configurazione dell’esportazione.

Nuove colonne disponibili nell’export Excel del timesheet di TASK:

·         Tipo attività: Codice

·         Tipo attività: Descrizione

·         Centro di costo dipendente: Codice

·         Centro di costo dipendente: Descrizione

·         Cliente (codice export)

·         Cliente (codice integrazione esterna)

·         Attività (codice export)

·         Cliente di riferimento (codice)

·         Cliente di riferimento (codice export)

·         Cliente di riferimento (codice integrazione esterna)

·         Cliente di riferimento (codice contabilità)

Migliorie nell’export spese su commesse

Potete esportare le spese di tutte le commesse con un’unica operazione.

Nella funzionalità Export spese su commesse abbiamo aggiunto, nel campo Commesse, l’opzione Seleziona tutte, che vi consente di includere tutte le commesse esistenti senza doverle selezionare una per una.

Nuovo formato campo durata attività nelle commesse

Potete inserire per le ore previste un valore superiore a 999 ore (funzionalità Commesse e attività > tab Attività)

Rimozione funzionalità Parametri di import

Abbiamo rimosso la funzionalità Parametri di import (vedi import avanzati di DOCKS).

VISTA

Tipologie di Rischio negli asset aziendali

Potete utilizzare le Tipologie di rischio in alternativa ai rischi (valori della matrice) nella configurazione di un asset aziendale.

Nella funzionalità Asset aziendali abbiamo implementato lo sviluppo per aggiungere il campo Tipologie di rischio.

La logica di funzionamento è analoga a quella degli attuali rischi: anziché selezionare uno o più valori della matrice di rischio, potete indicare una o più tipologie di rischio. Potete valorizzare solo uno dei due campi, alternativamente Tipologie di rischio oppure Rischi.

 Quando selezionate una tipologia, tutti i valori della matrice di rischio associati a tale tipologia vengono presi in considerazione automaticamente come validi per l’asset.

Le tipologie di rischio saranno visualizzate all’interno dei Diagrammi (tutti, in funzione delle relazioni configurate), con la stessa modalità con cui attualmente vengono mostrate le matrici di rischio.

In generale, l’indicazione dei rischi sugli asset — sia tramite matrice sia tramite tipologia — ha finalità puramente informativa.

 La compilazione dei campi (con relativo controllo in fase di salvataggio) è consentita esclusivamente tramite il modulo VISTA: Sicurezza sul lavoro.

Validità delle Aree associate alle Unità organizzative

Potete gestire la validità temporale delle Aree assegnate alle Unità organizzative.

All’interno della funzionalità Unità organizzative, nel tab Aree, sono stati aggiunti i campi Inizio validità e Fine validità, che consentono di configurare il periodo di validità di ciascuna area associata.

La configurazione è disponibile nella tab dedicata di ogni Unità organizzativa, sia in fase di inserimento e modifica, sia in visualizzazione.
Non è consentito salvare la stessa Area su periodi di validità sovrapposti per la medesima Unità organizzativa.

 Nell’export Excel e nella visualizzazione dell’alberatura delle Unità organizzative vengono considerate esclusivamente le Aree valide alla data odierna.

ADVANCED

Nuovi campi nello Stato app

Abbiamo introdotto:

·         i campi Unità organizzativa e Azienda

·         il contatore delle righe a video

 L'azienda è indicata solo se il soggetto ha un rapporto di lavoro valido a oggi.

PORTALE

Miglioria nella visualizzazione degli allegati

Migliorata la gestione degli allegati.

Potete visualizzare l’anteprima delle immagini prima di scaricarle, proprio come già avviene per i file PDF.

I formati immagine supportati sono: .png, .webp, .jpg, .jpeg, .gif