Import uživatelských dat z xlsx

Kapitola Import uživatelských dat z xlsx obsahuje následující témata:

Obecné informace

V praxi často vzniká požadavek importovat již zpracované podklady z jiných systémů do aplikace dodávané společnosti ELVAC SOLUTOINS s.r.o., aby uživatelé nemuseli tato data zadávat do systému znovu ručně.

Váš systém umožňuje importovat data do evidencí prostřednictvím Konzolové aplikace Admin. K importu se používají soubory formátu Microsoft Excel. Systém tento import podporuje za dodržení určitých pravidel.

V našem příkladě budeme importovat data do evidence Osoby (Person) a Organizační jednotky (OrganizationUnit). Záznamy z evidence Osoby obsahují vazbu na Organizační jednotky. Do evidence Osoby budeme importovat obrázky a do evidence Organizační jednotky budeme importovat dokumenty.

V následujících kapitolách bude na názorném příkladě popsáno jak vyplnit soubor formátu Excel určený pro import dat, jaké pravidla dodržet pro úspěšný import a samotný proces importu dat.

Jak vyplnit Excel

Data, která chcete do systému importovat musí být ve formátu Microsoft Excel s předepsanou strukturou a pravidly. 

Obecná pravidla

Importovaná data můžou být uložené v jediném souboru Excel. Pokud importujete dokumenty a obrázky postupujte dle pravidel uvedených zde.

Pro každou evidenci musí v importovaném Excel existovat jeden list, který je pojmenovaný dle názvu objektu ve vašem systému. Název je bez mezer. V našem případě to jsou tři listy OrganizationUnit, Person, Document.

Názvy vlastností musí být pojmenovány dle unikátního identifikátoru (dále jen ID), který mu přidělil výrobce systému. Jak zjistit ID ve vašem systému viz zde. V našem případě to jsou u listu OrganizationUnit sloupce s vlastnostmi IdOriginal, ParentIdOriginal, Name, OrganizationUnitType, IsCustomer, IsSupplier, Document.

U listu Person jsou to sloupce s vlastnostmi FirstName, LastName, PersonalIdentifier, OrganizationUnitIdOriginal, Gender, Photo.

Vazby mezi jednotlivými evidencemi se řeší uvedením ID vazební vlastnosti. V našem případě vazba osoby na organizační jednotku OrganizationUnitIdOriginal.

Pravidla pro import obrázku

V našem příkladě chceme do evidence Osoby importovat fotky k jednotlivým osobám.

Seznam importovaných fotek uložíme do složky pojmenované Pictures.

Na list Person doplníme sloupec Photo a do něj uvedeme 

Zde je popsane jak najit cestu prave zpracovavaneho Excel. Soubory/obrazky pak staci umisti do nejake slozky a relativne si spocitat cestu

Ideálním řešením je uložit dokumenty k importním sadám a následně se odkázat na umístění pomocí složenin aktuální umístění importního Excel + relativní cesta od Excel k dokumentům.

Základní vzorec vrátí název souboru právě otevřeného Excel.

=cell("filename")

K vložení aktuální cesty právě otevřeného Excel do buňky je nutno najít pouze adresář, k čemuž slouží následující funkce

=LEFT(@CELL("filename",$A$1),FIND("[",@CELL("filename",$A$1))-1)

Pokud tedy chceme vložit přesnou cestu k dokumentu pro potřeby importu, použijeme CONCAT

=CONCAT(LEFT(@CELL("filename",$A$1),FIND("[",@CELL("filename",$A$1))-1),"Photos\novak.jpg")

Kde

• První část je umístění Excel
• Druhá část je umístění a název souboru

Výsledkem je cesta k souboru vzhledem k umístění Excel souboru.

Pravidla pro import dokumentu

V našem příkladě chceme do evidence Organizační jednotky importovat dokumenty ve formátu Pdf.

Seznam importovaných dokumentů uložíme do složky pojmenované Documents.

V importovaném Excel vytvoříme list s názvem Document, který bude obsahovat sloupce IdOriginal, FileData (cesta k souboru).

Na list OrganizationUnit doplníme sloupec Documents a do něj uvedeme IdOriginal z listu Document.

Pokud potřebujeme importovat více dokumentů k jednomu záznamu, je třeba IdOriginal oddělit středníkem.

Jak zjistit názvy sloupců (Identifikátor)

Identifikátor sloupce představuje název sloupce, kterým výrobce systému jednoznačně identifikuje danou vlastnost a také lze díky této informaci dohledat vlastnost ve stromové struktuře daného modelu objektu. Vzhledem k tomu, že systém podporuje přejmenování názvu sloupce, je nezbytně nutné mít možnost jednoznačně vlastnosti identifikovat.

Chcete-li zobrazit identifikátor sloupce, proveďte následující:

Klikněte pravým tlačítkem myši na záhlaví sloupce a z kontextového menu zvolte příkaz Zobrazit ID sloupce.

Zobrazí se ID sloupce z aplikačního modelu vašeho systému.

Jak výsledný Excel naimportovat pomocí konzolové aplikace

Pro úspěšný import dat kontaktů jejich obrázků a dokumentů postupujte podle následujících pokynů.

ELVAC.[nazev_zakaznika].[nazev_systemu].Tools.AdminConsole.exe

• ELVAC.OVAK.PRIS.Tools.AdminConsole.exe ImportDataFromFile -s="Excel.xlsx"
• ELVAC.OVAK.PRIS.Tools.AdminConsole.exe ImportDataFromDirectory -p="ceska ke strukture"

V datech evidence Osoby nebo Organizační jednotky namátkově ověřte, že se data naimportovala. Pokud se importovaná data nezobrazují, zkuste evidenci aktualizovat přes tlačítko  Aktualizovat nebo přes klávesu F5.