FinWebServiceImport

In Sicr@Web è possibile avviare un'importazione via webservice e controllarne lo stato. Prima di effettuare le chiamate verificare che il webservice CmnWSSGateway sia attivo (dal menù di Sicr@Web Gestione > Configurazione > Sistema > Web Services).

Avvio importazione

Deve essere effettuata una chiamata a 'fin.import.start' con un file .xml così composto:

<?xml version="1.0" encoding="ISO-8859-1"?><request>

 <des>Descrizione importazione</des>
 <app-prefix>Prefisso applicazione dell'importazione</app-prefix>
 <project>Nome importazione</project>
 <directory>Cartella con i files da importare</directory>

</request>

Descrizione importazione (des) = Descrizione dell'importazione che verrà avviata. E' un campo solo descrittivo e serve solo come tale. (Es.: 'Importazione anagrafiche')

Nome importazione (project) = Nome dell'importazione. Deve corrispondere alla codifica del nome dell'importazione che si vuole avviare(*). (Es.: 'ImportAnagrafeUnica')

Prefisso applicazione dell'importazione (app-prefix) = Prefisso dell'applicazione dell'importazione. Deve corrispondere alla codifica del prefisso dell'applicaizone dell'importazione che si vuole avviare(*). (Es.: 'an1')

Cartella con i files da importare (directory) = Nome completo della cartella in cui si trovano i files da importare. (Es.: 'C:\Users\trasco\anagrafiche' o '/home/trasco/anagrafiche')

(*) = I nomi e i prefissi delle applicazioni sono visibili in Sicr@Web. Aprire la maschera dal menù Bonifiche > Importazione > Importazione file. Scegliere l'applicazione e nel pannello successivo selezionare il progetto di importazione. Col pulsante destro del mouse viene visualizzato un menù dal quale è possibile scegliere 'Visualizza il progetto'. Si apre una maschera dalla quale è possiblie copiare sia il prefisso sia il nome.

Questa chiamata avvia l'importazione richiesta.

Es.:

<?xml version="1.0" encoding="ISO-8859-1"?> <request>

 <des>Importazione anagrafiche via web service</des>
 <app-prefix>an1</app-prefix>
 <project>ImportAnagrafeUnica</project>
 <directory>C:\Users\trasco_an1\mig\anagrafiche</directory>

</request>

Il risultato sarà un file .xml composto in due modi diversi:

A - Importazione avviata correttamente

<?xml version="1.0" encoding="ISO-8859-1"?> <response>

 <id-project>Numero dell'importazione</id-project>

</response>

B - Importazione non avviata

<?xml version="1.0" encoding="ISO-8859-1"?> <response>

 <state>Stato dell'importazione</state>
 <des>Descrizione dello stato dell'importazione</des>

</response>

A = In questo caso l'importazione è stata avviata in modo corretto e il risultato contiene l'indentificativo dell'importazione appena avviata.

B = In questo caso l'importazione non è stata avviata, state è uguale a 0 e des contiene una descrizione dell'errore.

Es.:

<?xml version="1.0" encoding="ISO-8859-1"?> <response>

 <state>0</state>
 <des>(riga 2, colonna 16) org.xml.sax.SAXParseException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'de'. One of '{"":des}' is expected.</des>

</response>

Controllo stato dell'importazione

Dopo che è stata avviata un'importazione deve essere effettuata una chiamata a 'fin.import.state' con un file .xml così composto:

<?xml version="1.0" encoding="ISO-8859-1"?> <request>

 <id-project>Numero dell'importazione</id-project>

</request>

Numero dell'importazione = Numero identificativo dell'importazione di cui si vuole conoscere lo stato.

Il risultato sarà un file .xml così composto:

<?xml version="1.0" encoding="ISO-8859-1"?> <response>

 <state>Stato dell'importazione</state>
 <des>Descrizione dello stato dell'importazione</des>

</response>

Stato dell'importazione = Numero che indica lo stato attule dell'importazione(*).

Descrizione dello stato dell'importazione = Breve descrizione dello stato attuale dell'importazione.

(*) =

state	descrizione
0	Importazione bloccata
1	Importazione in corso
2	Importazione terminata