Jedną z funkcji programu mającą na celu znaczne usprawnienie pracy jest operacja importu wpłat (np. z systemów bankowych). Pozwala ona zasilić bazy programu z zewnętrznego pliku o określonej strukturze. Struktura pliku importu jest konfigurowalna i można ją dostosować do potrzeb systemu zewnętrznego.

Struktura pliku importu wpłat

Program Dom Studencki umożliwia importowanie danych wpłat za akademik z plików tekstowych o określonym formacie, zdefiniowanym w pliku [katalog instalacyjny]/Config/iwplaty.xml. Struktura pliku wplaty.xml pozwala określić „mapowanie kolumn”, czyli która kolumna w pliku tekstowym odpowiada adekwatnej kolumnie w bazie danych. Ponadto można zdefiniować:

· separator - dowolny, jednoznakowy separator danych,

· quotationMarks - flaga informująca o tym czy dane umieszczone są w cudzysłowach

· endLine - znak końca linii (CRLF, CR, LF)

· header - flaga informująca o tym czy pierwszy wiersz stanowi nagłówek (pomijany podczas importu danych).

 

Przykład definicji, zwierający wszystkie możliwe do użycia pola.

<import table="wplaty" separator="," quotationMarks="1" endLine="CRLF" header="1">
<lp ignore="1" />
<wpl_ds />
<znacznik ignore="1" />
<data_nadania ignore="1" />
<wpl_data />
<data_efektywna ignore="1" />
<wpl_kwota />
<wpl_pesel ignore="1"/>
<transakcja ignore="1"/>
<z_rachunku ignore="1"/>
<wpl_rachunek identifier="1" token="(P)KLIENT NR:" />
<opis ignore="1"/>
</import>

Słownik pól:

 

Pole	Typ
wpl_ds	tekst
wpl_data	data
wpl_kwota	liczba
wpl_pesel	tekst
wpl_rachunek	tekst

Pola pogrubione są wymagane.

Oprócz pól rozpoznawalnych przez program można zastosować dowolną ilość pól oznaczonych atrybutem ignore ="1". Takie pola mogą mieć dowolną nazwę (różną od tych zdefiniowanych powyżej w tabeli). Będą one pomijane przez program w procesie importu, ale mogą być pomocne podczas ręcznej identyfikacji wpłat.

Identyfikacja wpłacającego może odbywać się poprzez jedno z pól: wpl_pesel lub wpl_rachunek. Pole po którym jest realizowana identyfikacja musi być oznaczone atrybutem identifier="1". Dla takiego pola można również określić atrybut token, który definiuje znacznik pozwalający na zidentyfikowanie właściwego identyfikatora (dotyczy to sytuacji, w których tylko część danych kolumny stanowi identyfikator wpłacającego)

Przykładowy wiersz danych:

"1","DS","E","2009-12-01","2009-12-01","2009-12-01","150,00","1151021821511","WPŁATA NA RACHUNEK","z rachunku:  11602202-001980606","nadawca:  XXXXXXXXXXXXXXXXXXXXXX 87-XXX XXXXXXXXXXXX  (P)KLIENT NR:0000072010404291","opis: XXXXXXXXXXXXXXXXXXXXXXX"