|
Invocazione del servizio di importazione
L’aggiornamento dei dati in Check&In viene invocato mediante una chiamata http alla pagina integrazione.aspx. I dati da importare sono letti da un file esterno, oppure fanno parte del corpo della chiamata, oppure ancora sono caricati da un database.
I parametri forniti alla pagina sono i seguenti:
| • | template: path del file contenente i parametri dell’importazione; questo parametro è obbligatorio. Per indicare i percorsi vale sempre la seguente regola: se il percorso inizia con “/”, allora deve essere un percorso virtuale completo (cioè un percorso che individua il file a partire da una condivisione web), altrimenti è un percorso relativo alla directory principale del sito di Check&In. |
| • | datafile: path del file contenente i dati da caricare; necessario per una chiamata di tipo http get; non va indicato invece quando gli stessi dati sono passati nel corpo della chiamata di tipo post oppure ricavati con una query su un database. |
| • | username e password: credenziali di un utente dell’applicazione Check&In; la pagina integrazione.aspx è progettata per essere chiamata da altre applicazioni e quindi non utilizza la modalità di autenticazione standard basata su form di login. La password è criptata mediante l’utility pwdcrypt |
Le modalità di chiamata del servizio sono quindi:
| • | l’applicazione compone una richiesta http post |
| o | indica come parametri il path del file di definizione dei parametri, posto in una cartella accessibile dal server di Check&In |
| o | indica come parametri username e password |
| o | invia i dati nel corpo della richiesta; i dati possono essere in formato testo oppure xml |
| • | l’applicazione compone una richiesta http get |
| o | scrive i dati su un file di testo in una cartella accessibile al server di Check&In |
| o | indica come parametri della chiamata http il path di questo file insieme agli altri parametri già illustrati |
| • | l’applicazione compone una richiesta http get, i dati sono letti da un database |
Ecco un esempio di URL di invocazione di tipo http get:
http://localhost/CheckAndIn/Integrazione.aspx?template=Temp/impEsterni.xml&datafile=Temp/Esterni.txt&username=super&password=G
In questo esempio il file di template è “Temp\impEsterni.xml”, il file di dati è “Temp\Esterni.txt”, username è “super” e la password è vuota.
|