Jedną z funkcji programu mającą na celu znaczne usprawnienie pracy jest operacja importu skierowań. Pozwala ona zasilić bazy programu z zewnętrznego pliku o określonej strukturze. Struktura pliku importu jest konfigurowalna i można ją dostosować do różnych systemów pracujących w diekanatach uczelni.

Struktura pliku importu skierowań

Program Dom Studencki umożliwia importowanie danych z plików tekstowych o określonym formacie, zdefiniowanym w pliku [katalog instalacyjny]/Config/import.xml. Struktura pliku import.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,

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

· truncate - oraz opcję automatycznego obcinania danych do maksymalnych rozmiarów pól dostępne wartości 0, 1.

 

Przykład definicji, zwierający wszystkie możliwe do użycia pola. Znaczenie pól jest takie samo jak odpowiednich kodów edytora. I tak np. <skie_nazwa> oznacza to samo co #skie_nazwa# czyli nazwisko studenta.

<import table="skierowania" separator="|" endLine="CRLF" truncate="0" >
<skie id/>
<skie_grupa/>
<skie_nazwa/>
<skie_plec/> (liczba 1- mężczyzna, 2-kobieta)
<skie_kraj/>
<skie_adres/>
<skie_im_rodzicow/>
<skie_data_ur />
<skie_dok_tozs/>
<skie_dok_wojs/>
<skie_wydzial/>
<skie_kierunek/>
<skie_rok/>
<skie_kto/>
<skie_nr_karty/>
<skie_zakaterowano />
<skie_wykwaterowano/>
<skie_pobyt_czasowy/>
<skie_badania_okresowe/>
<skie_uwagi/>
<skie_pesel/>
</import>

Słownik pól:

Pole	Typ		Wartości
skie_id	tekst		20 znaków
skie_grupa	tekst		20 znaków
skie_nazwa	tekst		50 znaków
skie_plec	liczba		1-m, 2-k
skie_kraj	tekst		50 znaków
skie_adres	tekst		200 znaków
skie_im_rodzicow	tekst		50 znaków
skie_data_ur	tekst		50 znaków
skie_dok_tozs	tekst		50 znaków
skie_dok_wojsk	tekst		50 znaków
skie_wydzial	tekst		50 znaków
skie_kierunek	tekst		50 znaków
skie_rok	tekst		20 znaków
skie_kto	tekst		20 znaków
skie_nr_karty	tekst		50 znaków
skie_zakwaterowano	data
skie_wykwaterowano	data
skie_pobyt_czasowy	data
skie_badania_okresowe	data
skie_uwagi	tekst		200 znaków
skie_pesel	tekst		20 znaków

Uwagi:

Pola pogrubione są wymagane.
Program przekształca tekst na datę lub kwotę zgodnie z ustawieniami lokalnego systemu. Program ignoruje znaki \r\n (0x0D, 0x0A), które mogą być dowolnie używane do formatowania pliku tekstowego, ważne jest jedynie aby każdą kolumnę wiersza zamykał separator.

Przykładowy wiersz danych:

1|2|Abramowicz Mariusz|1|Polska|22-411 Wysokie Wysokie 148|Zdzisław Maria|11.05.1981|DD 8880836||IL|IL|4|student||2003-10-01||2004-06-30|||81051109832|