Import of current users into the new system may be relatively difficult, that is why we import the users individually. The data for the import are needed to be prepared in a well-read format, the most suitable form is saving into CSV text file . This form of export should be possible in most of the database applications, most often from MySQL database, or Excel file. For so dealt data, we are able to create a convenient script for import into the database of the ISP admin system.
Import uživatelů do systému
Import stávajících uživatelů do nového systému je nyní možné provádět zcela samostatně. Pro tento krok jsme připravili importovací skript, pomocí kterého snadno naplníte systémovou databázi informacemi o Vašich routerech, zařízeních, klientech i jejich službách.
Data pro import je potřeba připravit v dobře čitelném formátu. Nejvhodnější formou je uložení do textového CSV souboru . Tato forma exportu by měla být možná z naprosté většiny databázových aplikací, nejčastěji z MySQL databáze nebo Excel sešitu.
Soubory potřebné pro import naleznete ke stažení zde.
Popis obsahu archivu import.rar
- import.php # Vlastní importovací skript
- import_desc.txt # Popis jednotlivých polí v importovaném souboru
- import_template.csv # Vzorová šablona
Soubor import.php je potřeba nahrát na server do adresáře /data/support/ispadmin/import (například pomocí softwaru WinSCP). Pokud adresář neexistuje, vytvořte ho. Poté bude na adrese http://vas_ispadmin/import/import.php dostupná obrazovka importovacího skriptu.
Pro úspěšné provedení importu dat je dále potřeba vytvořit zdrojový soubor s daty ve formátu .csv. Soubor musí být uložen v kódování cp1250. Data připravte dle vzoru přiložené šablony import_template.csv (na prvním řádku jsou názvy sloupců a na dalších řádcích data) a nakonec tento soubor načtěte importovacím skriptem.
Tím by měl být import dat do databáze systému ISPadmin hotový.
Na závěr ještě 2 důležité poznámky.
- script přemaže všechna dříve vložená data!!! Pokud chcete jen některá další data k již existujícím přidat, musíte si script upravit.
- script je nutné po použití(po importu) ze serveru vymazat kvůli bezpečnosti.
Popis jednotlivých polí v importovaném souboru:
Name (EN)
Jméno klienta
hodnota: textový řetězec
Street and number
ulice bydliště klienta
hodnota: textový řetězec
City
město
hodnota: textový řetězec
ZIP code
PSČ
hodnota: textový řetězec
Phone
pevná linka na klienta, možno uvádět několik telefonních čísel oddělených čárkou
hodnota: textový řetězec
Mobile phone
mobil na klienta, možno uvádět několik telefonních čísel oddělených čárkou
hodnota: textový řetězec
Connected to router
router, na který je klient připojen. Toto je poměrně důležitá informace, protože podle toho se dělá shaping na jednotlivých routerech.
hodnota: jméno routeru, ke kterému je klient připojen. Provádí se kontrola, zda tento router existuje v záložce Routery. Pokud neexistuje je zobrazena chybová hláška.
Pokud není tato položka v importu uvedena, snaží se importovací script nalézt router se jménem IMPORT a pokud existuje, tak se klient přiřadí k tomuto routeru. Pokud neexistuje router IMPORT, je zobrazena chyba. V tomto případě je potřeba vytvořit router s názvem IMPORT. Například s IP adresou 127.0.0.1 a k tomuto routeru se klient přiřadí.
MAC
mac adresa klienta
hodnota: MAC klienta ve formátu xx:xx:xx:xx:xx
IP
IP adresa klienta. Zde je potřeba uvádět pouze jednu IP adresu klienta bez masky (např: 192.168.3.4)
Email
email na klienta
hodnota: textový řetězec
ID
IČO. Pokud je IČO uvedeno, je klient označen jako "firemní zákazník", v opačném případě jako "soukromá osoba".
hodnota: textový řetězec
VAT ID
DIČ
hodnota: textový řetězec
Reimbursement method
typ úhrady klienta. Zde je nutné vyplnit správný kód a to dle následujícího klíče.
1001: bankovní převod
1002: SIPO
1003: složenka
1004: inkaso
Pokud není hodnota uvedena, tak se nastaví 1001 ( defaultní hodnota uvedená v proměnné $default_payment_method )
hodnota: 1001-1004
Bank account
bankovní účet klienta
hodnota: textový řetězec
Min. duration of agreement
minimální délka trvání smlouvy v měsících. Tato hodnota se uloží ke službě Internet u klienta.
hodnota: číslo
Client number
klientské číslo klienta
platí zásada
klientské číslo = VS na faktuře = jedinečný identifikátor klienta = uživatelské jméno pro přístup do uživatelského rozhraní
hodnota: číslo
Shortcut of tariff
zkratka tarifu. Podle této zkratky se provede správné nastavení tarifu ke klientovi. Systém hledá podle této zkratky v tarifech. Pokud je tarif nalezen, tak se přiřadí správné hodnoty ke klientovi (cena, download, upload ...). Pokud neexistuje tarif, je potřeba doplnit jej v menu Nastavení / Tarify a do zkratky tarifu uvést správnou zkratku, aby se provedlo správné spárování ke klientovi.
hodnota: textový řetězec
Send invoice by email
zasílání faktur emailem
0 - nezasílat
1 - zasílat
hodnota: 0, 1
Send invoice by post
posilat faktuyy pozemní poštou
0 - nezasílat
1 - zasílat
hodnota: 0, 1
Invoicing interval
interval fakturace
1 - měsíčně
3 - čtvrtletně
6 - pololetně
12 - ročně
Pokud není v importu tato hodnota uvedena, nastaví se defaultní hodnota $default_invoice_period
hodnota: 1,3, 6, 12
Invoicing from
datum od kdy se má klient fakturovat
hodnota: datum ve formátu DD.MM.YY
Connected from
datum od kdy je klient připojen
hodnota: datum ve formátu DD.MM.YY
Day of birth
datum narození klienta
hodnota: datum ve formátu DD.MM.YY
User group
skupina, do které klient patří. Tuto skupinu je potřeba mít vytvořenou v menu Nastavení/Číselníky/Skupiny klientů. Pokud není hodnota uvedena, tak se nastaví defaultní hodnota uvedená na začátku scriptu v proměnné $default_user_group , což je interní id skupiny.
hodnota: textový řetězec
User state
stav klienta. Podobně jako v předchozím případě je možné nastavit v položce Nastavení/Číselníky/Stavy uživatelů. Pokud není hodnota uvedena, tak se bere defaultní z proměnné $default_user_state.
User active
stav zda se jedná o aktivního klienta
0 - aktivní klient
1 - odstraněný klient, který slouží pouze pro historii a archivaci dat. Nijak se s ním dále nepracuje a je zobrazen v menu Statistiky/Odpojení uživatelé.
Invoice group
fakturační skupina, do které klient patří. Hledá se název skupiny uvedený v menu Fakturace/Nastavení/Fakturační skupiny. Pokud není položka v importu uvedena, bere se defaultní hodnota $default_invoice_group.
User Type
typ uživatele (WIFI, Radius ...). Možné nastavit v položce Nastavení/Číselníky/Typ uživatele. Pokud není hodnota uvedena, tak se bere defaultní z proměnné $default_user_type.
Radius username
uživatelské jméno pro ověřování přes Radius (pokud je položka "User type" nastavena na hodnotu Radius)
Radius Password
heslo pro ověřování přes radius