integrazione documentazione - WebTelemaco

Fedra Plus
Fedra Plus
Prodotto per la
gestione e compilazione della modulistica
relativa
al Registro delle Imprese
Integrazione
Guida Operativa
marzo 2006
allineata alla versione software FedraPlus 1.09.15
aggiornamento software disponibile : version.xml
Pag.1
Fedra Plus
SOMMARIO
1
PREMESSA.........................................................................................4
1.1
NOVITÀ INTRODOTTE ................................................................4
2
AVVIO FEDRAPLUS CON APERTURA DIRETTA PRATICA .................4
3
IMPORTA/ESPORTA PRATICHE ........................................................6
3.1
FUNZIONALITÀ APPLICATIVA ....................................................6
3.1.1 ESPORTA PRATICHE .....................................................................7
3.1.2 IMPORTA PRATICHE ...................................................................10
4
MODALITA’ SILENTE ......................................................................15
4.1.1 FORMATO DELLA RICHIESTA.......................................................17
4.1.1.1
Importazione........................................................................17
4.1.1.2
Esportazione ........................................................................18
4.1.2 FORMATO DELLA RISPOSTA ........................................................19
4.2
5
NOTE D'IMPLEMENTAZIONE ....................................................21
IMPORTA/ESPORTA ANAGRAFICHE ...............................................21
5.1
ESPORTAZIONE ANAGRAFICHE................................................23
5.2
IMPORTAZIONE ANAGRAFICHE ...............................................25
6
APPENDICE A ..................................................................................29
6.1
SCHEMA XML DELLA RICHIESTA ..............................................29
6.2
SCHEMA XML DELLA RISPOSTA ...............................................31
Pag.2
Fedra Plus
Pag.3
Fedra Plus
1
PREMESSA
Il presente documento è un aggiornamento della Guida Operativa di
Fedraplus 1.09.11 di cui ne rappresenta parte integrante
1.1
NOVITÀ INTRODOTTE
In questa versione di FedraPlus sono state inserite le funzionalità di:
importazione/esportazione pratiche
importazione/esportazione anagrafiche
come parti di un pacchetto di servizi di trattamento dati archivio in
modalità XML
e viene essere fornita la possibilità di avviare FedraPlus in modo
parametrico, per richiedere l’apertura immediata della pratica specificata.
Questi servizi potranno essere attivati anche direttamente da riga
comando.
In tale contesto Fedra Plus, può essere utilizzato, oltre che nella modalità
interattiva normale, idonea all’uso di un utente, anche in una modalità
‘silente’.
La modalità silente è funzionale alle applicazioni per richiedere servizi
FedraPlus in ‘background’, senza alcun intervento diretto dell’utente. Il
nome ‘silente’ deriva dalla mancanza di qualunque comunicazione diretta
con l’utente , la comunicazione avviene esclusivamente fra gli applicativi:
quello cliente che richiede un servizio, e FedraPlus, che lo fornisce,
attraverso un protocollo di comunicazione standard.
2
AVVIO FEDRAPLUS CON APERTURA DIRETTA
PRATICA
Dalla versione 1.9.15 del prodotto è possibile attivare Fedraplus in modo
parametrico, indicando nella riga comando il codiceFedra della pratica di
cui si richiede la diretta visualizzazione, con un comando del tipo:
Pag.4
Fedra Plus
“path….\newFedra.exe”/p
“codiceFedra”
dove:
i parametri di chiamata devono essere separati da spazi e devono essere
riportati esattamente nell’ordine sopra indicato, con il seguente significato.
•
•
•
path …..\newFedra.exe indica il nome completo della directory dove
risiede il programma FedraPlus , e se tale nome contiene spazi
deve essere racchiuso tra doppi apici , come per esempio:
"C:\Programmi\InfoCamere\Fedra Plus\newFedra.exe" ;
/p è l’opzione di avvio del programma FedraPlus che indica
l’apertura della pratica specificata nel codice Fedra;
codiceFedra è un codice univoco, di otto caratteri, assegnato alla
pratica, di cui si richiede la diretta apertura. Il codice della pratica,
indicato nel parametro, deve essere racchiuso tra doppi apici. Se tale
codice è presente nell’archivio FedraPlus, il comando attiverà
l’interfaccia grafica direttamente con l’apertura della pratica, in
caso contrario l’attivazione segnalerà l’inesistenza della pratica .
Di seguito l’esempio di un comando di attivazione pratica:
"C:\Programmi\InfoCamere\Fedra Plus\newFedra.exe"/p "411S2716"
che può rappresentare il contenuto di un file .bat
Pag.5
Fedra Plus
3
IMPORTA/ESPORTA PRATICHE
La funzionalità permette di migrare ed importare le pratiche nell’archivio
FedraPlus secondo modalità standard e controllate.
Il formato utilizzato per l'importazione/esportazione pratica nell'archivio
si basa sulla struttura u3t.xml , pubblicata sul sito
web.telemaco.infocamere.it , disponibile nella sezione Servizi Software
House nell'area servizi E-governement . Sempre in tale sezione sono
disponibili agli utenti tools d'utilità per la trasformazione e migrazione
della pratica in tale formato.
La scelta d'utilizzo della struttura u3t per la descrizione dei dati di pratica
è basata sulla considerazione che le specifiche del formato sono pubbliche
e definite ministerialmente .
La rappresentazione in formato xml dell'u3t, ne rende più facile l'usabilità ,
fornendo un'interpretazione adeguata agli standard tecnologici correnti.
La modifica della struttura u3t.xml varierà in linea con gli eventuali
adeguamenti normativi apportati alla struttura di presentazione delle
pratiche al Registro Imprese.
Una pratica completata con Fedra o strumenti compatibili potrà essere
importata nell’archivio FedraPlus, a partire dal file u3t, utilizzando i tools
di trasformazione disponibili online.
Pratiche, non completamente compilate, ma formalmente corrette,
secondo le specifiche definite da u3t.xml, possono essere importate in
FedraPlus quindi esportate.
3.1
FUNZIONALITÀ APPLICATIVA
La funzione realizzata permette l'importazione/esportazione nell'archivio
FedraPlus delle pratiche in qualunque stato di compilazione si trovino,
purchè strutturate e valide secondo le specifiche di formato definite.
Pag.6
Fedra Plus
Le funzionalità saranno richiamabili in due modalità:
• esplicita (dall'interfaccia applicativa) ,
• in modalità silente ( tramite linea comando)
La modalità esplicita, sarà attivabile da interfaccia grafica per singola
pratica.
La modalità silente permetterà di eseguire l’azione su un insieme
definito di pratiche.
3.1.1
ESPORTA PRATICHE
La funzione “Esporta” è disponibile sia da interfaccia applicativa
(modalità grafica) che da linea comando.
Tale funzione premette di scaricare la pratica, in qualunque stato di
compilazione si trovi, in un formato u3t.xml valido secondo le specifiche
Fedar5.9
La richiesta di esportazione di una pratica FedraPlus comporterà la
creazione di una cartella, contenente il file u3t, in formato .xml della
pratica, e tutti i documenti allegati eventualmente referenziati nel modello
riepilogo dell’u3t.
La cartella della pratica verrà creata nel percorso di rete, indicato nel
directory comando, con il nome coincidente con il codiceFedra della
pratica referenziata.
Avvertenza
Non è consigliabile indicare come directory d’esportazione la
PRTELE\DATI, la struttura della pratica esportata con FedraPlus non è
adeguata ad essere direttamente referenziata per la spedizione telematica.
L’eventuale distinta deve essere ricreata dal sistema ospitante a fronte di
una verifica e validazione pratica.
Una pratica, presente in un archivio FedraPlus , potrà essere esportata e
quindi importata nello stesso sistema, nel qual caso FedraPlus assegnerà in
modo automatico un nuovo codice pratica, oppure in un altro sistema od
archivio FedraPlus.
Pag.7
Fedra Plus
In modalità grafica la funzione “Esporta” si attiva, selezionando la
singola pratica dall’Indice, come sottovoce del menu Pratiche , oppure
con il tasto CRTL+E
Da interfaccia grafica, il percorso in cui creare la cartella pratica potrà
essere selezionato dalla finestra attivabile tramite l’opzione “digitazione
del percorso” disponibile, una volta selezionata l’opzione e scelta l’unità di
rete specifica.
La richiesta di eventuale sovrascrittura di una preesistente cartella pratica
dovrà essere chiaramente espressa tramite flag.
Avvertenza
Una pratica potrà essere esportata in qualunque stato di compilazione essa si
trovi. A soli fini informativi, nell’interfaccia grafica, la richiesta di esportazione
Pag.8
Fedra Plus
attiverà la funzione di validazione pratica, offrendo la possibilità di avere una
visione immediata degli eventuali errori o dati mancanti nella pratica esportata.
Una volta esportata la pratica con codiceFedra indicato, nel percorso di
rete convenuto, sarà possibile , nell’interfaccia grafica, attivare il tasto
“Verifica” per controllare, da applicativo, il contenuto di sistema della
directory creata.
CodiceFedra (indice)
pratica pratica
La funzione esporta pratiche sarà attivabile anche in modalità silente, con
un comando del tipo
newFedra.exe /s
richiesta.xml
risposta.xml
le funzionalità fornite per singola pratica saranno analoghe a quelle della
modalità grafica .
Nella modalità silente non essendoci nessuna interazione con l’utente non
verrà attivata la funzione di validazione pratica.
Pag.9
Fedra Plus
Per maggiori dettagli sull’utilizzo di tale modalità e struttura dei file si
veda il paragrafo attinente MODALITA’ SILENTE
3.1.2
IMPORTA PRATICHE
La funzione importa è disponibile sia da interfaccia applicativa (modalità
grafica) che da linea comando.
In modalità grafica la funzione “Importa….” è attivabile direttamente da
voce menù Pratiche o richiamabile come operazione sulla singola
pratica dall’Indice .
Una volta attivata la funzione d’importazione richiede in input un file xml
contenente i dati di compilazione della pratica nel formato u3t , definito in
accordo alle specifiche di formato Fedra5.9.
I dati di compilazione della pratica da importare , saranno referenziati da
dal file “nomepratica”.u3t_xml , dove “nomepratica” può essere un essere
un qualunque identificativo di 8 caratteri .
Pag.10
Fedra Plus
Nel caso il “nomepratica” sia un codiceFedra formalmente valido , non già
esistente nel sistema , la pratica verrà importata nell’archivio
mantenendone il codice, in tutti gli altri casi ne verrà generato uno nuovo
ed assegnato alla pratica importata.
Il codicePratica dovrà rimanere univoco all’interno del sistema di
compilazione e trasmissione pratiche per evitare possibili conflitti ed
incompatibilità con i software.
A tal fine , la richiesta d’importazione di una pratica con codiceFedra già
presente nell’archivio, verrà mutuata assegnando alla pratica importata
un nuovo codice e mantenendo l’informazione del codice di provenienza
nel campo annotazione dell’indice.
Nel caso di voler importare in FedraPlus una pratica, presente nella
PRTELE\DATI , per evitare sovrascritture è necessario preliminarmente,
spostare la cartella pratica Fedra dalla PRTELE\DATI , modificandone
eventualmente il prefisso codicepraticaFedra che si vuole importare. La
cartella di scarico pratica.U3A verrà quindi creata da FedraPlus.
Gli allegati referenziati nel file di riepilogo di una pratica da
importare dovranno essere collocati nella medesima cartella
contenente il file u3t.xml della pratica stessa.
Pag.11
Fedra Plus
Esempio :
Per l’importazione pratica è richiesta obbligatoriamente la natura
giuridica dell’impresa.
La forma giuridica potrà essere scelta a video, se l’importazione è
eseguita in modalità grafica, oppure fornita come attributo del nodo se
eseguita in modalità silente.
In ogni caso l’informazione potrà essere modificata in seguito, da
interfaccia applicativa, in fase di apertura della pratica.
L’importazione permette infatti di poter modificare tutti i dati
d’intestazione di una pratica, se non ancora validata e scaricata , tramite
il tasto anagrafica impresa
La pratica potrà quindi essere direttamente aperta o memorizzata per
essere reperita in seguito nell’indice.
Pag.12
Fedra Plus
Una pratica importata sarà identificata nell’Indice pratiche dalla lettera “ i”
in prima colonna.
Una volta importata la pratica in FedraPlus il sistema le assegnerà un
identificativo numerico univoco all’interno dell’archivio.
Verrà controllata la presenza nell'archivio di una pratica con medesimo
codiceFedra ed in caso affermativo verrà segnalato l’evento e riattribuito
alla pratica importata un nuovo codiceFedra .
Il codice inizialmente assegnato verrà mantenuto a scopo informativo nel
campo "annotazioni" della pratica stessa , visibile anche a livello di indice.
I dati d’intestazione di una pratica importata possono essere modificati e/o
confermati tramite la selezione del tasto Salva modifiche
Pag.13
Fedra Plus
Nel caso d‘importazione pratica, le informazioni necessarie alla
compilazione non disponibili nel file u3t.xml, potranno/dovranno essere
modificate e/o aggiunte manualmente con FedraPlus.
Il programma attribuirà alla pratica importata valori default, ove non
forniti, prendendoli dalla configurazione corrente.
Sarà compito dell’utente verificare e completare gli eventuali dati richiesti
ai fini della corretta validazione ed inoltro della pratica.
In particolare dovranno essere forniti e confermati i dati relativi
all’identificativo e ruolo del soggetto obbligato o legittimato al deposito e
la modalità di firma, al fine della corretta redazione della pratica e
trasmissione
Pag.14
Fedra Plus
La funzione importa pratiche sarà attivabile anche in modalità silente, con
un comando del tipo
newFedra.exe /s
richiesta.xml
risposta.xml
le funzionalità fornite saranno analoghe a quelle della modalità grafica .
Per maggiori dettagli sull’utilizzo di tale modalità e struttura dei file si
veda il paragrafo attinente MODALITA’ SILENTE
Nel caso in cui il codiceFedra della pratica di cui si richiede l’importazione
sia già stato assegnato all’interno dell'archivio FedraPlus verrà assegnato
alla pratica importata uno nuovo codice non esistente. Analogamente se la
struttura codiceFedraRichiesto non è conforme alle specifiche Fedra5.9.
verrà generato un nuovo codice Il valore del nuovo codice Fedra
assegnato alla pratica importata sarà visibile nel campo
CodiceFedraAssegnato
4
MODALITA’ SILENTE
FedraPlus silente non è un’applicazione separata da Fedra Plus, ma una
sua modalità d’esercizio.
Il suo utilizzo è basato sulla riga di comando del sistema operativo ospite,
il cui utilizzo da parte dell’applicazione cliente è libero.
Per avviare Fedra Plus silente è sufficiente avviare dalla riga di comando
il programma con l’opzione /s e fornire come parametri un file
contenente le richieste ed un file su cui registrare gli esiti, entrambi
strutturati secondo un formato prestabilito.
Ad esempio nella forma :
newFedra.exe/s
richiesta.xml
Pag.15
risposta.xml
Fedra Plus
oppure come contenuto di un file .bat, nella forma:
“path….\newFedra.exe”/s “path..\richiesta.xml”
“path…\ risposta.xml”
Dove il primo file-parametro, rappresenta la richiesta, ed è identificato
da un file in formato xml, strutturato secondo uno schema .xsd predefinito
per il formato della richiesta .
Il file potrà contenere l'elenco di una o più richieste di azioni, ciascuna
delle quali univocamente identificata , da compiere su una o più pratiche;
mentre il secondo parametro rappresenta il file di risposta in cui verrà
inserito, per ogni azione richiesta, il corrispondente esito.
Anche il file di risposta verrà generato in formato xml nel rispetto dello
schema .xsd definito per il formato della risposta
I files xml , utilizzati come parametri, dovranno essere individuati dal
percorso completo del file, il percorso può essere anche un percorso di rete;
I parametri di chiamata della modalità silente devono essere separati
da spazi e devono essere riportati esattamente nell’ordine sopra
indicato.
Esempio nella forma:
“C:\Programmi\InfoCamere\Fedra Plus\Fedra.exe”/s
C:\azioni\richiesta.xml "\\mio server\risposta.xml"
Per richiedere un servizio a FedraPlus silente, l’applicazione deve preparare
una richiesta in formato xml, quindi sottoporla a FedraPlus silente con il
comando descritto precedentemente.
Nel file richiesta verranno indicati in ordine sequenziale i servizi richiesti
per singola pratica, tra quelli resi disponibili dal sistema.
Pag.16
Fedra Plus
Fedraplus silente scriverà nel file xml di risposta , il cui percorso è stato
indicato nel comando, il responso per le singole operazioni richieste.
In prima battuta verrà rilasciata la funzionalità di
importazione/esportazione pratiche in FedraPlus, in seguito la struttura del
colloquio tramite file xml potrà essere replicata ed utilizzata anche per
altre funzionalità.
4.1.1
FORMATO DELLA RICHIESTA
Per richiedere un servizio a FedraPlus silente, l’applicazione deve preparare
una richiesta in formato xml, quindi sottoporla a FedraPlus silente con il
comando descritto precedentemente.
Lo schema della richiesta è riportato in appendice A (schema della
richiesta).
Come si evince dallo schema, il nodo radice del file di richiesta,
<richiesta/>, deve essere corredato da due attributi obbligatori:
software = nome dell’applicazione cliente che ha compilato la richiesta;
data = data di compilazione della richiesta, nel formato yyyy-mm-dd.
Il nodo radice presenta una sequenza di nodi figli che rappresentano la
sequenza ordinata di operazioni che FedraPlus silente dovrà eseguire ,
identificate da specifici nodi .
4.1.1.1IMPORTAZIONE
Il nodo <importazione/>, per esempio, descrive la richiesta di
un’operazione d’importazione pratica.
Esso è corredato di un attributo id, che è un identificatore univoco
dell’operazione all’interno del file di richiesta .
Il nodo <importazione/> deve avere i seguenti nodi figli obbligatori:
• formaGiuridica contiene il codice della forma giuridica; nel caso di
‘ditta individuale’ è utilizzato il codice DI;
Pag.17
Fedra Plus
•
•
pathU3t contiene il percorso del file u3t (in formato xml) della pratica
da importare;
gli eventuali file allegati alla pratica, referenziati nel file di pratica,
devono risiedere nella stessa cartella dell’u3t;
codiceFedra contiene il codice pratica col quale si richiede che sia
identificata la pratica nella base di dati di FedraPlus.
4.1.1.2 ESPORTAZIONE
Il nodo <esportazione/>, per esempio, descrive la richiesta di
un’operazione d’esportazione pratica.
Esso è corredato di un attributo id, che è un identificatore univoco
dell’operazione all’interno del file di richiesta .
Il nodo <esportazione/> deve avere i seguenti nodi figli obbligatori:
• CodiceFedra identifica il codice della pratica che si vuole esportare
• pathU3t contiene il percorso dove si richiede venga creata la cartella, il
cui nome coincide con nome della pratica da esportare, contenente il
file u3t.xml e gli allegati referenziati nel modello di riepilogo;
• sovrascrittura è un flag di richiesta sovrascrittura cartella di pratica
nel caso di esistenza. Ha valore = 1 se si richiede la sovrascrittura , =0
altrimenti
Di seguito un esempio di struttura di file
richiesta.xml
xml version="1.0" encoding="utf-8"?>
<richiesta software="nome App" data="2006-01-01"
xmlns:ric="http://www.infocamere.it/2005/AdempimentoRI_Codici"
xmlns:rit="http://www.infocamere.it/2005/AdempimentoRI_Tipi"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="C:\Programmi\InfoCamere\Fedra Plus\Lib\richiesta_silente.xsd">
<importazione id="1">
<formaGiuridica>SP</formaGiuridica>
<pathU3t>D:\PRATICHEDAIMPORTARE\praticaimporta\A25I1035.U3T.XML</pathU3t>
<codiceFedra>A25I1035</codiceFedra>
</importazione>
<importazione id="2">
Pag.18
Fedra Plus
<formaGiuridica>SR</formaGiuridica>
<pathU3t>D:\PRATICHEDAIMPORTARE\pratica1.XML</pathU3t>
<codiceFedra>pratica1</codiceFedra>
</importazione>
<esportazione id="3">
<codiceFedra>303R3752</codiceFedra>
<patU3t>”A:\PRATICHE esportate 2005”</patU3t>
<sovrascrittura>0</ sovrascrittura>
</esportazione>
<esportazione id="4">
<codiceFedra> A25I1035</codiceFedra>
<patU3t>D:\PRATICHEDAIMPORTARE</patU3t>
<sovrascrittura>1</sovrascrittura>
</esportazione>
</richiesta>
Avvertenza
Il file di richiesta è a puro titolo esemplificativo, i contenuti dei nodi sono
puramente casuali.
Il file d’esempio fa riferimento allo schema “richiesta”, contenuto nella directory
SDK della libreria d’installazione. Per maggiori dettagli vedi Schema XML della
richiesta
4.1.2
FORMATO DELLA RISPOSTA
Per informare l’applicazione cliente sull’esito del l’elaborazione della sua
richiesta, FedraPlus silente usa un file xml, il cui schema è riportato in
appendice (schema Risposta) . Tale file viene salvato alla fine
dell’elaborazione di FedraPlus \s , nella locazione specificata dal chiamante
come secondo parametro.
La struttura del file di risposta definisce il nodo radice, <risposta/>
corredato dai seguenti attributi:
richiesta = il percorso completo del file di richiesta a cui si riferisce;
data = la data e l’ora di evasione della richiesta da parte di FedraPlus;
stato = ‘1’ se l’operazione della richiesta è stata processata correttamente
o ‘0’ si sono riscontrate criticità nell’elaborazione di almeno una
singola azione;
Pag.19
Fedra Plus
errore= vuoto se elaborazione corretta , altrimenti spiegazione dell’errore
Il nodo radice presenta una sequenza di nodi <azione/> che rappresentano
la sequenza ordinata di operazioni che FedraPlus silente ha eseguito.
Ogni nodo <azione/> ha i seguenti attributi:
• id identifica la particolare azione richiesta; corrisponde esattamente
all’attributo id dell’operazione indicata nel file di richiesta;
• stato può avere valore ‘1’ (operazione eseguita correttamente) o ‘0’ (si
sono verificati errori durante il processo);
• errore nel caso stato=‘‘0’’, indica una descrizione della causa
dell’errore, altrimenti è vuoto.
Il nodo <azione/> può avere una sequenza di nodi figli <parametro/>,
descritti con un attributo nome, che identifica l’informazione che FedraPlus
intende dare all’applicazione cliente. Tali nodi parametro sono funzionali
all’operazione richiesta.
Per esempio nel caso di una richiesta d’importazione con buon esito, nel
file di risposta dovranno essere presenti due nodi parametro identificanti
rispettivamente: il codiceFedraRichiesto ed il codiceFedraAssegnato.
I valori di tali nodi possono coincidere. Per maggiori dettagli vedi
funzionalità applicativa dell’IMPORTA PRATICHE
Ad esempio :
a fronte di un file richiesta precedente si potrà ottenere il seguente file
di risposta.xml
<?xml version="1.0" encoding="utf-8"?>
<risposta richiesta="C:\FedraPlus silente\richiesta.xml" data="3/3/2006 8:24:44 PM" stato="1"
errore="">
<azione id="1" errore="" stato="1">
<parametro nome="codiceFedraRichiesto">A25I1035</parametro>
<parametro nome="codiceFedraAssegnato">303T2444</parametro>
</azione>
<azione id="2" errore="" stato="1">
Pag.20
Fedra Plus
<parametro nome="codiceFedraRichiesto">pratica1</parametro>
<parametro nome="codiceFedraAssegnato">303T2445</parametro>
</azione>
<azione id="3" stato="0" errore="La cartella designata per l'esportazione esiste già ed è stato
richiesto di non sovrascriverla."/>
<azione id="4" stato="1" errore=""/>
</risposta>
Avvertenza
Il file è a puro titolo esemplificativo ed i contenuti dei nodi sono casuali.
Il file d’esempio fa riferimento agli esiti dell’elaborazione del file richiesta la cui
locazione è completamente individuata dall’attributo richiesta del nodo risposta.
4.2
NOTE D'IMPLEMENTAZIONE
La funzionalità silente d'importazione/esportazione pratiche nell'archivio
FedraPlus verrà implementata come complemento del prodotto tramite un
activeX .
La funzione si appoggia alla struttura del file u3t , per descrizione di una
pratica, redatto in formato xml secondo lo schema disponibile in linea .
5
IMPORTA/ESPORTA ANAGRAFICHE
E’ stata introdotta nell’interfaccia grafica di Fedraplus alla voce
Anagrafiche funzionalità per esportare ed importare dati anagrafici
d’imprese e/o persone nell’archivio FedraPlus , a partire da files in formato
xml.
Pag.21
Fedra Plus
La normale funzione d’imputazione manuale dei dati anagrafici (data entry)
viene quindi referenziata con la voce menu Esplora
Il formato xml d’importazione /esportazione anagrafiche persone ed
imprese è proprietario del prodotto stesso ed è documentato nel relativo
schema disponibile nella sottodirectory \Lib d’installazione prodotto, alle
voci :
• anagrafica_imprese.xsd
• anagrafica_persone_fisiche.xsd
Lo scopo di tale funzionalità è quello di permettere lo scarico e
l’allineamento tra archivi anagrafici diversi del prodotto.
La struttura del file di “imprese.xml” è costituita da un nodo radice
<dataroot/> contenente una sequenza di nodi <ANAGRAFICA_IMPRESE/>
ciascuno dei quali può contenere a sua volta una sequenza di nodi figli atti
ad identificare i dati anagrafici caratteristici dell’impresa
Pag.22
Fedra Plus
Analogamente la struttura del file “anagrafica_persone_fisiche” è costituita
da un nodo radice <dataroot/> contenente una sequenza di nodi
<ANAGRAFICA_ PERSONE_FISICHE/> ciascuno dei quali può contenere a
sua volta una sequenza di nodi figli atti ad identificare i dati anagrafici del
soggetto.
5.1
ESPORTAZIONE ANAGRAFICHE
La funzione d’Esporta anagrafiche è richiamabile come funzione a menu
alla voce Anagrafiche delle Imprese o Persone.
Per entrambe le tipologie di anagrafiche una volta attivata la funzione
d’esportazione, verrà richiamata una funzione di gestione risorse per creare
un file .xml contenente tutti i dati presenti nell’archivio.
Il file verrà creato nel percorso locale o di rete selezionato ed identificato
con il nome file specificato.
Se non altrimenti esplicitato il programma propone, come nomi file :
• “imprese.xml” se è stata richiesta l’esportazione dell’archivio
anagrafiche imprese
• “persone.xml” se è stata richiesta l’esportazione dell’archivio
anagrafiche persone-fisiche
Pag.23
Fedra Plus
Avvertenza
Viene demandato all’utente il controllo sul nome del file su cui esportare i
dati onde evitare l’eventuale ricoprimento di un file preesistente
Di seguito un esempio di dati estratti per l’anagrafica imprese :
<?xml version="1.0" encoding="UTF-8"?>
<dataroot xmlns:od="urn:schemas-microsoft-com:officedata" generated="2006-04-26T13:58:50">
<ANAGRAFICA_IMPRESE>
<idImpresa>1</idImpresa>
<codiceFiscale>88888888885</codiceFiscale>
<partitaIVA>1111111111</partitaIVA>
<numeroREA>12345</numeroREA>
<CCIAAdi>MI</CCIAAdi>
<denominazione1>FERRETTI SPA</denominazione1>
<impresaIndividuale>0</impresaIndividuale>
<codiceFormaGiuridica>SP</codiceFormaGiuridica>
<dataCostituzione>2003-10-23T00:00:00</dataCostituzione>
<codiceStato>I</codiceStato>
<codiceProvincia>MI</codiceProvincia>
<cap>20100</cap>
<comune>MILANO</comune>
<via>VIA PASSO DEL RE</via>
<nrCivico>95</nrCivico>
<prefissoTelefono>02</prefissoTelefono>
<nrTelefono>8515</nrTelefono>
<prefissoTelefax>0285</prefissoTelefax>
<telefax>123456</telefax>
<sito_internet> www.impresa.IT </sito_internet>
<indirizzo_email_nome>[email protected]</indirizzo_email_nome>
<indirizzo_email_sito>www.impresa.IT</indirizzo_email_sito>
<uffici_direttivi>1</uffici_direttivi>
Pag.24
Fedra Plus
</ANAGRAFICA_IMPRESE>
<ANAGRAFICA_IMPRESE>
<idImpresa>2</idImpresa>
<denominazione1>VENEZIA</denominazione1>
<impresaIndividuale>0</impresaIndividuale>
<uffici_direttivi>0</uffici_direttivi>
</ANAGRAFICA_IMPRESE>
</dataroot>
e per l’anagrafica persone:
<?xml version="1.0" encoding="UTF-8"?>
<dataroot xmlns:od="urn:schemas-microsoft-com:officedata" generated="2006-04-26T18:06:06">
<ANAGRAFICA_PERSONE_FISICHE>
<idPersona>1</idPersona>
<codiceFiscale>AAAAAAAA</codiceFiscale>
<sesso>F</sesso>
<cognome>PINCOPALLA</cognome>
<nome>PAOLA</nome>
<dataNascita>2006-01-17T00:00:00</dataNascita>
<codiceCittadinanza>B</codiceCittadinanza>
<codiceStatoNascita>B</codiceStatoNascita>
<comuneNascita>BRUXEL</comuneNascita>
<codiceStatoResidenza>I</codiceStatoResidenza>
<codiceProvinciaResidenza>PD</codiceProvinciaResidenza>
<capResidenza>35100</capResidenza>
<comuneResidenza>PADOVA</comuneResidenza>
<frazioneResidenza>CAMIN</frazioneResidenza>
<viaResidenza>CORSO STATI UNITI 14</viaResidenza>
<nrCivicoResidenza>12/1</nrCivicoResidenza>
</ANAGRAFICA_PERSONE_FISICHE>
<ANAGRAFICA_PERSONE_FISICHE>
<idPersona>7</idPersona>
<codiceFiscale>KKKKKKKKKK</codiceFiscale>
<sesso>M</sesso>
<cognome>GIUSEPPE</cognome>
<nome>MUTTI</nome>
<dataNascita>2006-03-29T00:00:00</dataNascita>
<codiceCittadinanza>YU</codiceCittadinanza>
<codiceStatoNascita>YU</codiceStatoNascita>
<codiceStatoResidenza>I</codiceStatoResidenza>
</ANAGRAFICA_PERSONE_FISICHE>
</dataroot>
I dati anagrafici sopra presentati sono forniti a solo titolo esemplificativo.
5.2
IMPORTAZIONE ANAGRAFICHE
E’ possibile richiedere l’importazione dei dati anagrafici di uno o più
soggetti fisici o giuridici contenuti in file di tipo .xml , redatti secondo le
strutture definite dai rispettivi schemi :
• anagrafica_imprese.xsd
• anagrafica_persone_fisiche.xsd
disponibili nella sottodirectory \Lib d’installazione prodotto.
Pag.25
Fedra Plus
La funzione d’importazione anagrafica importerà nell’archivio tutte le
anagrafiche definite nel file da importare.
I parametri minimi da esplicitare per ogni nodo di
<ANAGRAFICA_IMPRESE/> da importare sono, oltre l’<idimpresa/>, il
<CodiceFiscale/> e , <denominazione1/> ed i flag
<impresaIndividuale/> ,<uffici_direttivi> con i valori boleani : 0 = Falso,
1= Vero
Di seguito un esempio di file (“impreseprova.xml”) utilizzato per
l’importazione delle anagrafiche di due imprese
?xml version="1.0" encoding="UTF-8"?>
<dataroot xmlns:od="urn:schemas-microsoft-com:officedata" generated="2006-04-26T13:36:35">
<ANAGRAFICA_IMPRESE>
<idImpresa>1</idImpresa>
<codiceFiscale>11111111115</codiceFiscale>
<numeroREA>1552256</numeroREA>
<CCIAAdi>MI</CCIAAdi>
<denominazione1>PROVA1</denominazione1>
<impresaIndividuale>0</impresaIndividuale>
<codiceFormaGiuridica>SR</codiceFormaGiuridica>
<codiceStato>I</codiceStato>
<uffici_direttivi>0</uffici_direttivi>
</ANAGRAFICA_IMPRESE>
<ANAGRAFICA_IMPRESE>
<idImpresa>25</idImpresa>
<codiceFiscale>1111111111111115</codiceFiscale>
<denominazione1>PIPPO</denominazione1>
<denominazione2>IMPRESA</denominazione2>
<denominazione3>INDIVIDUALE</denominazione3>
<denominazione4>PROVA</denominazione4>
<impresaIndividuale>1</impresaIndividuale>
<dataCostituzione>2004-01-15T00:00:00</dataCostituzione>
<codiceStato>I</codiceStato>
<codiceProvincia>LO</codiceProvincia>
<cap>26839</cap>
<comune>ZELO BUON PERSICO</comune>
<via>P.ZA KANT</via>
<nrCivico>11</nrCivico>
<uffici_direttivi>0</uffici_direttivi>
</ANAGRAFICA_IMPRESE>
ANAGRAFICA_IMPRESE>
<idImpresa>66</idImpresa>
<codiceFiscale>2222222220</codiceFiscale>
<denominazione1>FRATELLI FERRETTI &amp; C.</denominazione1>
<impresaIndividuale>0</impresaIndividuale>
<uffici_direttivi>0</uffici_direttivi>
</ANAGRAFICA_IMPRESE>
</dataroot>
Pag.26
Fedra Plus
Nel caso le anagrafiche da importare siano già presenti nell’archivio (stesso
codice fiscale e denominazione) FedraPlus fornirà la possibilità di
selezionare, conservare o sovrascrivere, in modo sequenziale, i record
anagrafici delle imprese.
La chiusura della finestra ( tasto “X” in alto a destra) blocca l’importazione
dei dati anagrafici relativi al record in cui viene attivata.
I record importati fino a quel momento non verranno ripristinati.
Comportamento analogo si ha per i dati anagrafici delle persone fisiche.
Avvertenza
Viene demandata all’utente la responsabilità di verificare e fornire dati e
codici corretti ai fini dell’importazione anagrafiche.
Pag.27
Fedra Plus
Nessun controllo verrà eseguito dalla funzione se non quello di validità
formale dei dati da importare.
Pag.28
Fedra Plus
6
APPENDICE A
6.1
SCHEMA XML DELLA RICHIESTA
Struttura dello schema con cui verrà eseguita la validazione della richiesta
è disponibile nella cartella Sdk del file d’installazione del prodotto.
Lo schema fa riferimento al suo interno ad una collezione di formati tipo e
codici standard utilizzati internamente. Di seguito un esempio di tale
schema:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:rit="http://www.infocamere.it/2005/AdempimentoRI_Tipi"
xmlns:ric="http://www.infocamere.it/2005/AdempimentoRI_Codici" version="0.0.1">
<xs:annotation>
<xs:documentation xml:lang="it"> Schema: struttura parametri Richiesta Importa
pratiche In Fedraplus ver. 1.09.xx e successive</xs:documentation>
<xs:documentation> Febbraio 2006 - </xs:documentation>
</xs:annotation>
<!-- importa lo schema con le definizioni dei tipi di dati semplici -->
<xs:import namespace="http://www.infocamere.it/2005/AdempimentoRI_Tipi"
schemaLocation="Collezione_tipi_RI_01.xsd"/>
<!-- importa lo schema con le raccolte delle varie tipologie di codici -->
<xs:import namespace="http://www.infocamere.it/2005/AdempimentoRI_Codici"
schemaLocation="Collezione_codici_RI_01.xsd"/>
<xs:simpleType name="typeData">
<xs:restriction base="xs:date"/>
</xs:simpleType>
<xs:simpleType name="typeNomeApplicazione">
<xs:restriction base="xs:string">
<xs:maxLength value="15"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="parametro">
<xs:complexType mixed="true">
<xs:attribute name="nome" type="rit:typeStringL25" use="required"/>
<xs:attribute name="tipo" type="rit:typeStringL1" use="required"/>
<xs:attribute name="lunghezza" type="rit:typeNumericoL4"/>
</xs:complexType>
</xs:element>
<xs:element name="importazione">
Pag.29
Fedra Plus
<xs:complexType>
<xs:sequence>
<xs:element name="formaGiuridica" type="ric:typeCodFormaGiuridica"/>
<xs:element name="pathU3t" type="rit:typeStringL305"/>
<xs:element name="codiceFedra" type="rit:typeStringL8"/>
</xs:sequence>
<xs:attribute name="id" type="xs:NMTOKEN" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="esportazione">
<xs:complexType>
<xs:sequence>
<xs:element name="codiceFedra" type="rit:typeStringL8"/>
<xs:element name="pathU3t" type="rit:typeStringL305"/>
<xs:element name="sovrascrittura" type="xs:boolean" minOccurs="1"
maxOccurs="1"/>
<xs:element ref="parametro" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="id" type="xs:NMTOKEN" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="validazione">
<xs:complexType>
<xs:sequence>
<xs:element name="codiceFedra" type="rit:typeStringL8"/>
<xs:element name="parametro" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="id" type="xs:NMTOKEN" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="scarico">
<xs:complexType>
<xs:sequence>
<xs:element name="codiceFedra" type="rit:typeStringL8"/>
<xs:element name="parametro" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="id" type="xs:NMTOKEN" use="required"/>
</xs:complexType>
</xs:element>
<xs:group name="azione">
<xs:choice>
<xs:element ref="importazione"/>
<xs:element ref="esportazione"/>
<xs:element ref="validazione"/>
<xs:element ref="scarico"/>
</xs:choice>
</xs:group>
<xs:element name="richiesta">
<xs:complexType>
<xs:sequence>
Pag.30
Fedra Plus
<xs:group ref="azione" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="software" type="typeNomeApplicazione" use="required"/>
<xs:attribute name="data" type="typeData"/>
</xs:complexType>
</xs:element>
</xs:schema>
6.2
SCHEMA XML DELLA RISPOSTA
Struttura dello schema, disponibile nella cartella Sdk del file d’installazione
del prodotto, con cui verrà creato il file .xml delle risposte.
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:element name="azione">
<xs:complexType>
<xs:sequence>
<xs:element ref="parametro" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="id" type="xs:byte" use="required"/>
<xs:attribute name="stato" type="xs:boolean" use="required"/>
<xs:attribute name="errore" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="parametro">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="nome" type="xs:string" use="required"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="risposta">
<xs:complexType>
<xs:sequence>
<xs:element ref="azione" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="richiesta" type="xs:string" use="required"/>
<xs:attribute name="data" type="xs:string" use="required"/>
<xs:attribute name="stato" type="xs:boolean" use="required"/>
<xs:attribute name="errore" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema>
Pag.31