Importazione

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

oindica come parametri il path del file di definizione dei parametri, posto in una cartella accessibile dal server di Check&In

oindica come parametri username e password

oinvia i dati nel corpo della richiesta; i dati possono essere in formato testo oppure xml

•l’applicazione compone una richiesta http get

oscrive i dati su un file di testo in una cartella accessibile al server di Check&In

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