Personal tools
waitress.invalid8082

Gestione documenti (amministratore)

Contenuto della scheda
    Vedi anche...

      Nella "Gestione documenti" si possono gestire tre tipologie di archiviazione: Pubblica, Condivisa e Aziendale Privata.

      Infatti, le sezioni riservate si riferiscono all'archiviazione di documenti:

      ·         Pubblici

      ·         Condivisi

      ·         Aziendali privati.

      Pubblici

      Per gestire i documenti che devono essere visibili e scaricabili da tutti gli utenti, strettamente legati alla propria azienda, che accedono al Portale PeoplelinkOnline.com.

      Guida all'archiviazione dei file

      Per procedere all'inserimento di un file è necessario:

      ·         Selezionare la categoria alla quale deve appartenere

      ·         Cliccare sul pulsante <Carica> file posto in alto a destra.

      ·         Configurare, quando previsto, i campi:

      o   Anno: di riferimento da imputare al file

      o   Mese: di riferimento da imputare al file

      o   Azienda: per rendere visibile il documento alle utenze di determinata azienda (in caso di un gruppo di aziende)

      o   Tags: consente di etichettare ulteriormente il documento appartenente a determinate categorie.

      ·         Cliccare sul pulsante <Continua> per salvare.

      Condivisi

      Per condividere documenti tra un utente della propria azienda e gli utenti dell'ufficio amministrativo (es.: cedolini paga, i modelli CU).

      Queste categorie di documenti sono protette da password.

       Per questo tipo di condivisione è necessario avere attivo il modulo "Docks Plus".

      Guida all'archiviazione dei file

      Per inserire un file è necessario:

      ·         Selezionare la categoria alla quale deve appartenere

      ·         Cliccare sul pulsante <Carica file> posto il alto a destra

      ·         Configurare i campi necessari

      ·         Cliccare sul pulsante <Continua> per salvare.

       

      I campi proposti sono:

      ·         Profilo utente

      ·         Anno: di riferimento da imputare al file

      ·         Mese: di riferimento da imputare al file

      ·         Azienda: di riferimento, per rendere visibile il documento agli utenti dell'azienda selezionata

      ·         Tags: consente di etichettare ulteriormente il documento appartenente a determinate categorie

      ·         Data di scadenza: solo con il modulo "Docks Plus" attivo.

       

       È necessaria l'abilitazione del modulo Scheduler, per la configurazione dell'invio di eventuali notifiche, relative ai documenti prossimi alla scadenza, compilando i campi:

      ·         Tipo di notifica (E-mail - Push Mobile)

      ·         Quando e Cosa, per indicare il tempo di preavviso (in giorni ore, minuti) previsto

      ·         Destinatario.

       

      Dalla lista dei file caricati è possibile visualizzare anche i file prossimi alla scadenza e quelli già scaduti (solo con il modulo "Docks Plus" attivo).

       

       È possibile, inoltre, abilitare i seguenti widget sulla dashboard:

      ·         I miei documenti in scadenza

      ·         Documenti scaduti (per gli amministratori)

      ·         Documenti in scadenza (per gli amministratori).

       

      La sezione "Condivisi" viene anche utilizzata da tutti i moduli del Portale PeoplelinkOnline.com come repository per i file di export, come gli export voci payroll.

      Vengono inoltre archiviati, quando attivo il modulo "Docks Plus", gli allegati dei documenti relativi alle note spese del Modulo Expenses e gli allegati relativi all'utilizzo del modulo "Task".

      Aziendali privati

      Per poter archiviare tutti i documenti aziendali che possono essere visualizzati solamente da alcuni utenti selezionati, solitamente gli uffici contabili, amministrativi e HR.

      Guida all'archiviazione dei file

       Le categorie da visualizzare nella Gestione documenti della sezione "Aziendali privati" si abilitano dalla funzionalità "Ruoli" di People&Identities. Per procedere all'inserimento di un documento è necessario:

      ·         Selezionare la categoria alla quale deve appartenere

      ·         Cliccare sul pulsante <Carica> file posto il alto a destra.

      ·         Configurare i campi necessari e cliccare sul pulsante <Continua> per salvare.

       

      I campi proposti sono:

      ·         Associato al soggetto

      ·         Anno: di riferimento

      ·         Mese: di riferimento

      ·         Azienda: di riferimento

      ·         Tags: consente di etichettare ulteriormente il documento appartenente a determinate categorie.

      ·         Data di scadenza: (solo quando attivo Docks Plus).

       

       ATTENZIONE: È necessaria l'abilitazione del modulo Scheduler, per la configurazione dell'invio di eventuali notifiche, relative ai documenti prossimi alla scadenza, compilando i campi:

      ·         Tipo di notifica: (E-mail - Push Mobile)

      ·         Quando e Cosa: per indicare il tempo di preavviso (in giorni ore, minuti) previsto

      ·         Destinatario.

       

      Dalla lista dei file caricati è possibile visualizzare anche l'evidenziazione dei file prossimi alla scadenza e quelli già scaduti, (solo con il modulo "Docks Plus" attivo).

       

       È possibile poter abilitare i seguenti widget sulla dashboard:

      ·         I miei documenti in scadenza

      ·         Documenti scaduti (per gli amministratori)

      ·         Documenti in scadenza (per gli amministratori).

      Guida all'archiviazione dei file appartenenti a categorie protette

      Per procedere all'inserimento di un documento appartenente ad una categoria protetta, nelle sezioni Condivisi o Aziendali privati, è necessario:

      ·         Selezionare la categoria alla quale deve appartenere

      ·         Cliccare sul pulsante <Carica file> posto il alto a destra.

      ·         Inserire il codice di sicurezza per avere accesso alla gestione dei documenti protetti.

      • Configurare, quando previsto:
        • Profilo utente al quale è riservata la condivisione (deve essere registrato al portale PeoplelinkOnline.com)
        • Anno: di riferimento da imputare al file
        • Mese: di riferimento da imputare al file
        • Azienda: per rendere visibile il documento quando si appartiene all'azienda selezionata
        • Tags: consente di etichettare ulteriormente il documento appartenente a determinate categorie
      • Cliccare sul pulsante <Continua> per salvare.

       

      Gestione dei file archiviati

      Selezionando un file dalla lista, con i pulsanti in alto a destra, è possibile:

      ·         Spostare il file in una qualsiasi categoria appartenente alla tipologia dei documenti Condivisi

      ·         Verificare le proprietà del file, cliccando sull'apposito pulsante contrassegnato con il simbolo "i", dove è possibile:

      o    Aggiungere/modificare la descrizione del file

      o    Visualizzare

      §  Chi ha caricato il file

      §  Quando è stato creato il file

      §  La data di ultima modifica del file

      §  Le dimensioni del file.

      o    Aggiungere/modificare l'anno, il mese, l'azienda, e i tag di riferimento

      o    Aggiungere/modificare la data di scadenza (solo per i file appartenenti alla tipologia di documenti Condivisi o Aziendali privati, esclusi quelli appartenenti alle categorie "protette da password" e alla categoria "Import da file").

      ·         Configurare l'invio relativo alle notifiche di avviso dei documenti prossimi alla scadenza (solo con Scheduler abilitato)

      ·         Visualizzare:

      o    Il numero dei download del file effettuati

      o    La data e l'ora dell'ultimo download

      o    Chi ha effettuato l'ultimo download.

      ·         Rinominare il file

      ·         Eliminare il file.

       

      Sempre in testata sulla sinistra si possono utilizzare i pulsanti:

      ·         Ricarica elenco file: per aggiornare l'elenco dei file

      ·         Carica un filtro: per poter procedere alla ricerca dei file mediante l'utilizzo di più filtri, mediante:

      o    Nome o descrizione del file

      o    Testo contenuto nel file

      o    Dal mese - Al mese

      o    Dall'Anno - All'Anno

      o    Azienda

      o    Tag con il metodo AND or OR

      o    Associato a: Profilo utente o Soggetto.

      Guida all'Import da file

      Per poter procedere all'import dei file previsti nel Modulo "Docks" è necessario selezionare la funzione "Import da file" nella sezione "Aziendali privati" della Gestione Documenti e cliccare sul pulsante <Carica file>.

       

      Si apre una nuova maschera dalla quale è possibile selezionare il tipo di schema relativo al file da importare, nel campo Schema di import abilitato per i seguenti schemi:

      ·         Certificati INPS

      ·         Turni settimanale

      ·         Turni Mensile

      ·         Totalizzatori

      ·         Anagrafiche

      Esempio di import file

      ·         Selezionare il tipo di schema (in questo caso Turni settimanale)

      ·         Cliccare sul pulsante <Continua>

      ·         Si apre una maschera dalla quale è possibile caricare il file

      ·         Cliccare all'interno della maschera sulla dicitura "Trascina i file qui o clicca per caricarli"

      ·         Si apre la finestra di Windows dalla quale è possibile scegliere il percorso del file da importare

      ·         Selezionare il file e cliccare sul pulsante <Apri>.

       

      Inoltre, selezionando il file dall'elenco si attivano i pulsanti :

      ·         Ricarica l'elenco dei file

      ·         Applica un filtro

      ·         Sposta file

      ·         Informazioni sul file

      ·         Rinomina file

      ·         Elimina file.

      Guida all'import avanzato e interattivo

      Potete utilizzare i seguenti schemi di import avanzati:

      ·         IDENTITIES: Anagrafica badge (avanzato)

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

      ·         VISTA: Anagrafica asset (avanzato)

      ·         VISTA: Anagrafica competenze (avanzato)

      ·         VISTA: Anagrafica posizioni lavorative (avanzato)

      ·         VISTA: Assegnazioni ai soggetti delle competenze (avanzato)

      ·         VISTA: Assegnazioni ai soggetti delle posizioni lavorative (avanzato)

      ·         VISTA: Assegnazione eventi anagrafici (avanzato).

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

      ·         IDENTITIES: Anagrafica badge (avanzato)

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

      I file da utilizzare, per i quali è possibile scaricare i relativi template Excel utilizzando il bottone <Download template per import>, avranno le seguenti caratteristiche:

      ·         IDENTITIES: Anagrafica badge (avanzato) - utile per l'import dei badge e la relativa assegnazione ai soggetti
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Badge - Foglio contenente la lista di badge da aggiungere in anagrafica. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Associazione a soggetti - Foglio contenente la lista di soggetti da associare ai badge. I badge ai quali vanno associati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria "Badge". Per questa categoria sono previsti i seguenti algoritmi di import: Startup.

      o   Badge con associazione (legacy) - Foglio contenente la lista di badge da aggiungere in anagrafica e da associare ad un determinato soggetto. Per questa categoria è previsto l'algoritmo di import di Startup.
       Questa categoria, derivante dal vecchio tracciato di import dei badge anagrafici, potrebbe venir rimossa in aggiornamenti futuri in quanto obsoleta.

      ·         TASK: Anagrafica clienti, commesse e attività (avanzato) - utile per l' import generico dei clienti, referenti clienti, commesse, classificazioni di commessa e attività di commessa in TASK.
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Clienti - Foglio contenente la lista di clienti da aggiungere e/o modificare in anagrafica. Per questa categoria sono previsti i seguenti algoritmi di import: Startup, Upsert.

      o   Referenti - Foglio contenente la lista di referenti relativi a determinati clienti da aggiungere e/o modificare. I clienti sui quali potranno venir salvati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Clienti. Per questa categoria sono previsti i seguenti algoritmi di import: Startup, Upsert.

      o   Commesse - Foglio contenente la lista di commesse da aggiungere in anagrafica. I clienti alle quali potranno essere associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Clienti. Per questa categoria sono previsti i seguenti algoritmi di import: Startup, Upsert.

      o   Classificazioni - Foglio contenente la lista di associazioni delle classificazioni di commessa in anagrafica. Le commesse alle quali potranno venir associati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Commesse. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Attività - Foglio contenente la lista di attività di commessa da aggiungere in anagrafica. Le commesse alle quali potranno venir associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Commesse. Per questa categoria sono previsti i seguenti algoritmi di import: Startup, Upsert.

      ·         VISTA: Anagrafica asset (avanzato) - utile per l'import generico degli asset e delle scadenze, dei documenti e/o allegati, degli storici rilevazioni, delle manutenzioni e delle commesse associate legate ad essi in VISTA.
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Asset aziendali - Foglio contenente la lista di asset aziendali da aggiungere e/o modificare in anagrafica. Per questa categoria sono previsti i seguenti algoritmi di import: Startup, Upsert.

      o   Scadenze - Foglio contenente la lista di scadenze da aggiungere in anagrafica. Gli asset aziendali ai quali potranno venir associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Asset aziendali. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Documenti e allegati - Foglio contenente la lista di documenti e allegati da aggiungere in anagrafica. Gli asset aziendali ai quali potranno venir associati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Asset aziendali. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Storico rilevazioni - Foglio contenente la lista di storici rilevazioni da aggiungere in anagrafica. Gli asset aziendali ai quali potranno venir associati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Asset aziendali. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Manutenzioni - Foglio contenente la lista di manutenzioni da aggiungere in anagrafica. Gli asset aziendali ai quali potranno venir associati possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Asset aziendali. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Commesse associate - Foglio contenente la lista di commesse associate da aggiungere in anagrafica. Gli asset aziendali ai quali potranno venir associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Asset aziendali. Per questa categoria è previsto l'algoritmo di import di Startup.

      ·         VISTA: Anagrafica competenze - utile per l'import generico delle competenze e/o delle associazioni delle posizioni lavorative ad esse in VISTA.
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Competenze - Foglio contenente la lista di competenze da aggiungere in anagrafica. Per questa categoria è previsto l'algoritmo di import di Startup.

      ·         Posizioni lavorative associate - Foglio contenente la lista di posizioni lavorative da associare alle competenze. Le competenze alle quali vanno associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Competenze. Per questa categoria è previsto l'algoritmo di import di Startup.

      ·         VISTA: Anagrafica posizioni lavorative (avanzato) - utile per l' import generico delle posizioni lavorative e/o delle associazioni delle competenze e/o delle mappe retributive ad esse in VISTA.
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Posizioni lavorative - Foglio contenente la lista di posizioni lavorative da aggiungere in anagrafica. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Competenze associate - Foglio contenente la lista di competenze da associare alle posizioni lavorative. Le posizioni lavorative alle quali vanno associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Posizioni lavorative. Per questa categoria è previsto l'algoritmo di import di Startup.

      ·         Mappe retributive associate - Foglio contenente la lista di mappe retributive da associare alle posizioni lavorative. Le posizioni lavorative alle quali vanno associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria Posizioni lavorative. Per questa categoria è previsto l'algoritmo di import di Startup.

      ·         VISTA: Assegnazioni ai soggetti delle competenze (avanzato) - utile per l'assegnazione delle competenze ai soggetti
      Per questo schema di import specifico, il foglio Competenze sarà strutturato in base alle informazioni obbligatorie necessarie per il salvataggio di una competenza su un soggetto in anagrafica:

      o   Codice fiscale (chiave)

      o   Cognome (solo figurativo)

      o   Nome (solo figurativo)

      o   Competenza (da valorizzare sempre con il codice della competenza)

      o   Data di riferimento

      o   Importanza

      o   Valutazione desiderata.

      ·         VISTA: Assegnazioni ai soggetti delle posizioni lavorative (avanzato) - utile per l'assegnazione delle posizioni lavorative ai soggetti
      Per questo schema di import specifico, il foglio Posizioni lavorative sarà strutturato in base alle informazioni obbligatorie necessarie per il salvataggio di una competenza su un soggetto in anagrafica:

      o   Codice fiscale (chiave)

      o   Cognome (solo figurativo)

      o   Nome (solo figurativo)

      o   Data inizio

      o   Data fine

      o   Posizione lavorativa (da valorizzare sempre con il codice della posizione lavorativa)

      o   Tipologia di assegnazione

      o   Quota o peso

      o   Azienda

      o   Sede

      o   Aggiungi competenze

      o   Valutazione desiderata.

      ·         VISTA: Assegnazione eventi anagrafici (avanzato) - utile per l'import delle categorie di eventi
      Il file è composto da più fogli, tanti quanti le categorie di eventi configurate; ogni foglio ha come descrizione il codice della categoria di evento. Le colonne presenti variano di foglio in foglio in base ai campi previsti per ciascuna tipologia di categoria di evento.

      ·         VISTA: Gruppi di edizioni ed edizioni per corsi formativi (avanzato) - utile per l'import generico dei gruppi di edizioni dei corsi formativi, delle edizioni dei corsi formativi e/o dei calendari sessione da associare ad esse in VISTA.
      Per questo schema di import specifico, ogni foglio rappresenta la categoria a cui appartiene:

      o   Gruppi corsi formativi - Foglio contenente la lista di gruppi di edizioni dei corsi formativi da aggiungere in anagrafica. Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Edizioni corsi formativi - Foglio contenente la lista di edizioni di corsi formativi da aggiungere in anagrafica. I gruppi di edizioni alle quali potranno venir associate possono essere già presenti in anagrafica oppure essere presenti nel foglio con categoria "Gruppi corsi formativi". Per questa categoria è previsto l'algoritmo di import di Startup.

      o   Calendario sessioni - Foglio contenente la lista di calendari sessioni da aggiungere in anagrafica. Le edizioni di corsi formativi alle quali andranno associati potranno essere già presenti in anagrafica oppure essere presenti nel foglio con categoria "Edizioni corsi formativi". Per questa categoria è previsto l'algoritmo di import di Startup.

       È possibile in fase di import poter allegare dei documenti, utilizzando un file in formato .zip contenente oltre al file di Excel anche i file relativi agli allegati, dopo aver indicato, per ciascun allegato, il nome e l'estensione nell'apposita colonna del foglio Excel.

      Se la lettura del file Excel andrà in errore, verrà inviata una notifica di errore e sarà necessario rieffettuare l'import del file Excel, in quanto impossibile da leggere dal sistema per un errore di struttura o generico, che verrà specificato nel log di import.

      Caricare i file da importare

      All'interno della scheda Import da file, nella funzionalità Gestione documenti, potete scaricare il file contenente il template per l'importazione che si necessita, in base allo schema e formato specificati.

      Per l'import manuale, potete scaricare il file template in formato Excel cliccando sul bottone <Dowload template per import>.


       

       

      Una volta compilato il template in Excel, caricate il file cliccando sul bottone <Carica file> e procedete al caricamento del file utilizzando uno degli schemi sottostanti alla categoria IMPORT AVANZATI.

      Cliccate sul bottone <Continua> per confermare. A caricamento completato apparirà il link Valida import.

      {66968B98-C3B9-43E5-B370-A3E91E1A8C13}

       

      Configurare e modificare i fogli da importare

      ·         Cliccate sul link Valida import per visualizzare la struttura e i dati importati.

      ·         Selezionate i fogli da importare
       se un foglio non verrà selezionato prima della fase finale di import, sarà completamente ignorato. Inoltre, non sarà possibile importarne i dati in un secondo momento tramite lo stesso file caricato, in quanto una volta terminato il processo di import, tutti i fogli verranno impostati in modalità di sola-lettura, per verificare la veridicità dei dati importati rispetto a quelli presenti a interfaccia.

      ·         Selezionate l'algoritmo da utilizzare:

      o   primo import (starup): viene utilizzato in fase di startup di un impianto per caricare nuovi elementi a prescindere da quelli già esistenti.
       In caso di rilevazione di elementi aventi un codice univoco già esistente la procedura si blocca in fase di validazione

      o   import di upsert: viene utilizzato per caricare nuovi elementi o aggiornare quelli già esistenti.
       se un elemento viene individuato a sistema, e nel foglio sono presenti delle colonne contenenti celle vuote per esso, i campi relativi alle colonne in questione verranno svuotati (se non obbligatori). Se si desidera evitare questo comportamento, sarà necessario caricare il foglio contenente unicamente le colonne che si desidera modificare. In alternativa, è possibile indicare le colonne da non considerare in fase di mappatura, per esempio il nome e cognome dei soggetti che in fase di import non vanno considerati perché la chiave è il codice fiscale.

      ·         Verificate ed eventualmente modificate/correggete il contenuto della lista delle colonne, quindi cliccate su Valida e salva.

      ·         Cliccate sul pulsante Anteprima e gestione dati per visualizzare i dati, selezionare eventuali dati da non importare e risolvere eventuali errori salvandoli.

      ·         Una volta gestiti i dati da importare, selezionate Importa tutto per completare l'operazione.

      Gestire i dati da importare

      Potete visualizzare i dati letti dal sistema di import dopo aver cliccato sul pulsante Anteprima dati da importare; i campi con errori sono evidenziati e tramite un tooltip potete leggere dettagli dell'errore in questione.

      Inoltre, sempre tramite un tooltip, sugli identificativi dei soggetti, se previsti, sarà possibile visualizzare nome e cognome del soggetto, se individuato in anagrafica.
       Per confermare la modifica di una cella dovete cliccare all'esterno di essa.
      Potete decidere di non importare singole righe spuntando la checkbox presente nella prima colonna Non Importare.

      Cliccate sul pulsante Valida e salva per confermare eventuali modifiche effettuate.

      {46B7DCFD-CCE5-4BF4-BFB0-2A630F90F393}

      {1A3E8412-9705-4092-9F02-7794192B700D}
      {D755CD7C-AC49-4FD5-A94B-0F6530E6ADC8}
      {27E74DF8-E69D-4815-B698-F81398BF4C96}

      Importare i dati salvati

      Se la validazione è andata a buon fine, potete effettuare l'import dei dati cliccando sul pulsante <Importa tutto> confermando l'esecuzione.

      {53E7DAC3-1DC7-4601-8D5F-C8082C81A13C}

      A import completato potete cliccare sul link Dati, nella colonna Stato dell'import, per  visualizzare in sola lettura i fogli importati con i relativi dati importati.

       Il numero verde all'interno della colonna corrisponde al numero di fogli importati, non ai singoli elementi importati.

       

      {486A56E8-725E-42C9-8E1E-096E00E23DF5}

      {7FCFF372-F2EB-48E9-AC35-2E4AAC7EEA5F}

      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 importati.

       

       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.

       

      user info:{'id_operatore': '""', 'id_struttura': '""', 'tipo_documento': "['MANUALI']", 'sisbot_allowed': 'false'}