INSTALLAZIONE E PARAMETRIZZAZIONE
MODULO EXPEL E INVIO CEDOLINI IN QUADRA
(parte applicativa)
Versione 29/07
PROCEDURA DI INSTALLAZIONE E CONFIGURAZIONE
La configurazione completa della procedura richiede i seguenti passaggi:
- Installazione dei pacchetti con i programmi
- Inserimento variabile di ambiente SERVICE-HR S
- Attivazione PPHRCRON per tutte le ditte
- Editing del file di configurazione CEDOL.XML
- Verifica dei percorsi
- Pianificazione del lancio automatico
INSTALLAZIONE DEI PACCHETTI
Il primo passo è lanciare in POLYEDRO l’installazione dei pacchetti:
- PGSTCEDLE6_obj.EXE
- PGSTCEDLE6_wfproc.EXE
Tutti gli oggetti e le procedure verranno installati automaticamente e posizionati nelle corrette cartelle di destinazione.
Il lancio dei due installatori inoltre crea in automatico all’interno della cartella ARCHIVI (CED) le due cartelle LOG e STORE che verranno successivamente utilizzate dalla procedura.
INSERIMENTO VARIABILE DI AMBIENTE “SERVICE-HR S”
L’utilizzo della procedura standard Teamsystem PPHRCRON richiede l’inserimento di una variabile di ambiente che ne abiliti il funzionamento.
Per eseguire questa operazione, bisogna:
- entrare in Procedure gestionali/Amministrazione/Ambienti
- andare in variazione con l’apposita icona (matita) sull’ambiente desiderato
- entrare nel folder VARIABILI AMBIENTE
- inserire la variabile SERVICE-HR impostando il valore S, come da immagine
ATTIVAZIONE PPHRCRON PER TUTTE LE DITTE
Per poter utilizzare la procedura PPHRCRON per tutte le ditte, nel comando AZIE di ognuna di esse dovrebbe venir spuntato l’apposito flag.
Per evitare di dover entrare in ciascuna azienda per eseguire manualmente l’attivazione, è stato fatto un apposito programma, denominato UTSETHR che provvede all’attivazione massiva.
Il lancio di tale programma va fatto nel seguente modo:
- entrare nel contesto PAGHE
- digitare CMDEXE nella normale casella di comando
- inserire UTSETHR nella riga vuota che compare lanciando CMDEXE
EDITING DEL FILE DI CONFIGURAZIONE
Insieme ai pacchetti di installazione viene fornito un file zip contenente due file denominati CEDOL.XML, uno in versione Windows e uno in versione Linux.
Questo file viene fornito esternamente al pacchetto di installazione perché va editato manualmente inserendovi alcuni parametri di base e non deve essere ricoperto da successivi aggiornamenti
Per l’editing del file di configurazione relativo al S.O. del server di installazione si può utilizzare un editor di testo presente su un PC.
Le informazioni da editare manualmente sono:
- USERNAME dello studio per accesso al servizio
- PASSWORD relativa
- PERCORSI delle cartelle di lavoro
Se si utilizza il file in versione Linux i percorsi sono già configurati nel file e vanno modificati solo nel caso in cui l’ambiente non sia stato installato in /dati/Rean/.
Vanno invece inseriti USERNAME e PASSWORD
<?xml version=”1.0″ encoding=”utf-8″?>
<config>
<host>https://services.esselink.it</host>
<username>QSTUDIO\studiouno@esselink.it</username>
<password>P@ssw0rd</password>
<FolderName>/dati/Rean/CED/PDF</FolderName>
<FolderLog>/dati/Rean/LOG</FolderLog>
<FolderStore>/dati/Rean/STORE</FolderStore>
<FolderTemp>/dati/Rean/CED</FolderTemp>
<FolderExpel>/dati/Rean/CED/ALTRI</FolderExpel>
</config>
IMPORTANTE: prima dell’installazione, reperire username e password del cliente.
Il cliente può avere o un pacchetto QSTUDIO o un pacchetto QSPRINT e il nome del servizio va indicato nel nome utente, nell’esempio QSTUDIO. Verificare dunque con ESSELINK anche il tipo di pacchetto gestito dal cliente.
Se si utilizza il file in versione Windows i percorsi sono già configurati ma va in ogni caso indicata la corretta lettera del disco dell’ambiente.
Attenzione all’utilizzo della doppia barra \\ che è obbligatoria per il corretto funzionamento
<?xml version=”1.0″ encoding=”utf-8″?>
<config>
<host>https://services.esselink.it</host>
<username>QSTUDIO\studiouno@esselink.it</username>
<password>P@ssw0rd</password>
<FolderName>C:\\dati\\Rean\\CED\\PDF</FolderName>
<FolderLog> C:\\dati\\Rean\\LOG</FolderLog>
<FolderStore>C:\\dati\\Rean\\STORE</FolderStore>
<FolderTemp> C:\\dati\\Rean\\CED</FolderTemp>
<FolderExpel>C:\\dati\\Rean\\CED\\ALTRI</FolderExpel>
</config>
Dopo aver editato il file CEDOL.XML come indicato, il file va copiato all’interno della cartella /dati/Rean/CED
Sia in ambiente Windows che Linux, utilizzare direttamente POLYEDRO EXPERIENCE con la funzione di caricamento di file esterno nella cartella degli archivi.
Per eseguire questa e tutte le successive fasi che richiedono l’utilizzo di POLYEDRO EXPERIENCE collegarsi con l’utente amministratore.
VERIFICA DEI PERCORSI
Per il corretto funzionamento della procedura è necessario procedere preliminarmente ad una verifica degli indirizzari di default presenti nel comando TB1210 dell’applicativo PAGHE.
In particolare il parametro “Archiviazione PDF” deve essere impostato a /PDF, mentre “Telematici vari” in /ALTRI.
Nel caso di esigenze particolari inderogabili del cliente che dovessero richiedere l’uso di percorsi diversi, è necessario modificare il percorso del rispettivo parametro in CEDOL.XML, come visto in precedenza.
Il cliente deve essere anche informato che i parametri in oggetto non possono successivamente essere modificati perché provocherebbero il non funzionamento della procedura.
In nessun modo è possibile gestire l’archiviazione PDF suddivisa per utente.
PIANIFICAZIONE DEL LANCIO DELLA PROCEDURA
Per l’esecuzione automatica della procedura è necessario procedere alla pianificazione all’interno dello schedulatore di POLYEDRO EXPERIENCE.
Per quanto riguarda i tempi delle pianificazioni, è importante tenere conto delle funzioni dei vari comandi:
- La procedura RUN_EXPCEDOL rimane in attesa dell’arrivo di un cedolino nella cartella PDF per l’invio a QUADRA
- La procedura PPHRCRON è un comando standard Teamsystem che estrae una serie di informazioni necessarie a QUADRA per la gestione
- La procedura EXPEL3 è un comando personalizzato che estrae alcune tabelle necessarie a QUADRA e che non sono presenti tra quelle generate da PPHRCRON. Al termine, raccoglie tutti i file generati da PPHRCRON e da EXPEL3 e li invia al server QUADRA.
In considerazione di ciò, la schedulazione va impostata nel modo seguente:
- Il comando RUN_EXPCEDOL va schedulato in modo continuo con partenza ogni 5 minuti
- Il comando PPHRCRON va schedulato in modo giornaliero due volte al giorno con partenza alle 00.00 e alle 13.00
- Il comando EXPEL3 va schedulato in modo giornaliero due volte al giorno con orario di partenza di 30 minuti successivo a quello di partenza del comando precedente
Per la pianificazione, entrare in Applicativi fiscali/Amministrazione/Pianifica programmi
Selezionare il modulo PAGHE per l’entità gestionale voluta, inserire come nome della procedura da pianificare RUN_EXPCEDOL, ripetizione GIORNALIERA, la data e ora di inizio del lancio della procedura (attenzione che il sistema per default imposta le ore 02:00 prossime, quindi del giorno dopo) e selezionare come utente, un utente abilitato all’esecuzione della procedura (si consiglia di usare sempre l’utente amministratore)
Dopo aver compilato la videata, cliccare PIANIFICA ATTIVITA’ per renderla operativa.
Con la stessa identica procedura, eseguire la pianificazione anche dei comandi
PPHRCRON
EXPEL3
Successivamente, per il solo comando RUN_EXPCEDOL, che deve eseguirsi in modalità continua, andare in Amministrazione/Piattaforma/Attività pianificate/Gestione e modificare la configurazione della pianificazione.
Selezionare la voce precedentemente creata ed entrare in variazione con l’apposito tasto
Nella maschera GESTIONE JOB inserire come parametro CONTINUA ed ogni 5 minuti (minimo possibile), e assicurarsi che il job sia abilitato.
